home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 April / PCWorld_2005-04_cd.bin / akce / web / phpmanual / phpmanual.exe / php_manual_de.html.htm < prev    next >
Encoding:
Extensible Markup Language  |  2005-01-13  |  8.7 MB  |  567,373 lines
Text Truncated. Only the first 1MB is shown below. Download the file for the complete contents.
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <HTML
  3. ><HEAD
  4. ><TITLE
  5. >PHP Handbuch</TITLE
  6. ><META
  7. NAME="GENERATOR"
  8. CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><META
  9. HTTP-EQUIV="Content-type"
  10. CONTENT="text/html; charset=ISO-8859-1"></HEAD
  11. ><BODY
  12. CLASS="book"
  13. BGCOLOR="#FFFFFF"
  14. TEXT="#000000"
  15. LINK="#0000FF"
  16. VLINK="#840084"
  17. ALINK="#0000FF"
  18. ><DIV
  19. CLASS="BOOK"
  20. ><A
  21. NAME="manual"
  22. ></A
  23. ><DIV
  24. CLASS="TITLEPAGE"
  25. ><H1
  26. CLASS="title"
  27. ><A
  28. NAME="manual"
  29. >PHP Handbuch</A
  30. ></H1
  31. ><DIV
  32. CLASS="author"
  33. >Mehdi Achour</DIV
  34. ><DIV
  35. CLASS="author"
  36. >Friedhelm Betz</DIV
  37. ><DIV
  38. CLASS="author"
  39. >Antony Dovgal</DIV
  40. ><DIV
  41. CLASS="author"
  42. >Nuno Lopes</DIV
  43. ><DIV
  44. CLASS="author"
  45. >Philip Olson</DIV
  46. ><DIV
  47. CLASS="author"
  48. >Georg Richter</DIV
  49. ><DIV
  50. CLASS="author"
  51. >Damien Seguy</DIV
  52. ><DIV
  53. CLASS="author"
  54. >Jakub Vrana</DIV
  55. ><SPAN
  56. CLASS="collab"
  57. ><SPAN
  58. CLASS="collabname"
  59. >      <A
  60. HREF="#contributors"
  61. >And several others</A
  62. >
  63.     </SPAN
  64. ><BR></SPAN
  65. ><H2
  66. CLASS="EDITEDBY"
  67. >Herausgegeben von</H2
  68. ><DIV
  69. CLASS="editor"
  70. >Gabor Hojtsy</DIV
  71. ><SPAN
  72. CLASS="collab"
  73. ><SPAN
  74. CLASS="collabname"
  75. >Bei der ▄bersetzung wirkten mit:</SPAN
  76. ><BR></SPAN
  77. ><SPAN
  78. CLASS="collab"
  79. ><SPAN
  80. CLASS="collabname"
  81. >Sebastian Bergmann</SPAN
  82. ><BR></SPAN
  83. ><SPAN
  84. CLASS="collab"
  85. ><SPAN
  86. CLASS="collabname"
  87. >Friedhelm Betz</SPAN
  88. ><BR></SPAN
  89. ><SPAN
  90. CLASS="collab"
  91. ><SPAN
  92. CLASS="collabname"
  93. >Cornelia Boenigk</SPAN
  94. ><BR></SPAN
  95. ><SPAN
  96. CLASS="collab"
  97. ><SPAN
  98. CLASS="collabname"
  99. >Ali Chahvand</SPAN
  100. ><BR></SPAN
  101. ><SPAN
  102. CLASS="collab"
  103. ><SPAN
  104. CLASS="collabname"
  105. >Wolfgang Drews</SPAN
  106. ><BR></SPAN
  107. ><SPAN
  108. CLASS="collab"
  109. ><SPAN
  110. CLASS="collabname"
  111. >Ralf Ebert</SPAN
  112. ><BR></SPAN
  113. ><SPAN
  114. CLASS="collab"
  115. ><SPAN
  116. CLASS="collabname"
  117. >Thomas Fromm</SPAN
  118. ><BR></SPAN
  119. ><SPAN
  120. CLASS="collab"
  121. ><SPAN
  122. CLASS="collabname"
  123. >Stefan Hanauska</SPAN
  124. ><BR></SPAN
  125. ><SPAN
  126. CLASS="collab"
  127. ><SPAN
  128. CLASS="collabname"
  129. >Johann-Peter Hartmann</SPAN
  130. ><BR></SPAN
  131. ><SPAN
  132. CLASS="collab"
  133. ><SPAN
  134. CLASS="collabname"
  135. >Hartmut Holzgraefe</SPAN
  136. ><BR></SPAN
  137. ><SPAN
  138. CLASS="collab"
  139. ><SPAN
  140. CLASS="collabname"
  141. >Martin Jansen</SPAN
  142. ><BR></SPAN
  143. ><SPAN
  144. CLASS="collab"
  145. ><SPAN
  146. CLASS="collabname"
  147. >Michael Kaiser</SPAN
  148. ><BR></SPAN
  149. ><SPAN
  150. CLASS="collab"
  151. ><SPAN
  152. CLASS="collabname"
  153. >Mark Kronsbein</SPAN
  154. ><BR></SPAN
  155. ><SPAN
  156. CLASS="collab"
  157. ><SPAN
  158. CLASS="collabname"
  159. >Hakan Kⁿcⁿkyilmaz</SPAN
  160. ><BR></SPAN
  161. ><SPAN
  162. CLASS="collab"
  163. ><SPAN
  164. CLASS="collabname"
  165. >Sven Lauer</SPAN
  166. ><BR></SPAN
  167. ><SPAN
  168. CLASS="collab"
  169. ><SPAN
  170. CLASS="collabname"
  171. >Jan Lehnardt</SPAN
  172. ><BR></SPAN
  173. ><SPAN
  174. CLASS="collab"
  175. ><SPAN
  176. CLASS="collabname"
  177. >Sebastian Nohn</SPAN
  178. ><BR></SPAN
  179. ><SPAN
  180. CLASS="collab"
  181. ><SPAN
  182. CLASS="collabname"
  183. >Tobias Orterer</SPAN
  184. ><BR></SPAN
  185. ><SPAN
  186. CLASS="collab"
  187. ><SPAN
  188. CLASS="collabname"
  189. >Catharina Paulsen</SPAN
  190. ><BR></SPAN
  191. ><SPAN
  192. CLASS="collab"
  193. ><SPAN
  194. CLASS="collabname"
  195. >Peter Petermann</SPAN
  196. ><BR></SPAN
  197. ><SPAN
  198. CLASS="collab"
  199. ><SPAN
  200. CLASS="collabname"
  201. >Sebastian-H. Picklum</SPAN
  202. ><BR></SPAN
  203. ><SPAN
  204. CLASS="collab"
  205. ><SPAN
  206. CLASS="collabname"
  207. >Franziskus Domig</SPAN
  208. ><BR></SPAN
  209. ><SPAN
  210. CLASS="collab"
  211. ><SPAN
  212. CLASS="collabname"
  213. >Georg Richter</SPAN
  214. ><BR></SPAN
  215. ><SPAN
  216. CLASS="collab"
  217. ><SPAN
  218. CLASS="collabname"
  219. >Stefan Saasen</SPAN
  220. ><BR></SPAN
  221. ><SPAN
  222. CLASS="collab"
  223. ><SPAN
  224. CLASS="collabname"
  225. >Martin Samesch</SPAN
  226. ><BR></SPAN
  227. ><SPAN
  228. CLASS="collab"
  229. ><SPAN
  230. CLASS="collabname"
  231. >Egon Schmid</SPAN
  232. ><BR></SPAN
  233. ><SPAN
  234. CLASS="collab"
  235. ><SPAN
  236. CLASS="collabname"
  237. >Thomas Sch÷fbeck</SPAN
  238. ><BR></SPAN
  239. ><SPAN
  240. CLASS="collab"
  241. ><SPAN
  242. CLASS="collabname"
  243. >Holger Schranz</SPAN
  244. ><BR></SPAN
  245. ><SPAN
  246. CLASS="collab"
  247. ><SPAN
  248. CLASS="collabname"
  249. >Thomas Schⁿrmann</SPAN
  250. ><BR></SPAN
  251. ><SPAN
  252. CLASS="collab"
  253. ><SPAN
  254. CLASS="collabname"
  255. >Uwe Steinmann</SPAN
  256. ><BR></SPAN
  257. ><SPAN
  258. CLASS="collab"
  259. ><SPAN
  260. CLASS="collabname"
  261. >Christian Ullrich</SPAN
  262. ><BR></SPAN
  263. ><SPAN
  264. CLASS="collab"
  265. ><SPAN
  266. CLASS="collabname"
  267. >Mark Wiesemann</SPAN
  268. ><BR></SPAN
  269. ><P
  270. CLASS="pubdate"
  271. >11-08-2004<BR></P
  272. ><P
  273. CLASS="copyright"
  274. >Copyright © 1997-2004 der PHP-Dokumentationsgruppe</P
  275. ><DIV
  276. CLASS="legalnotice"
  277. ><A
  278. NAME="copyright"
  279. ></A
  280. ><P
  281. ><B
  282. >Copyright</B
  283. ></P
  284. ><P
  285. >     Copyright ⌐ 1997 - 2004 by the PHP Documentation Group. Dieses Material
  286.     darf nur gemΣ▀ den Regeln und Bedingungen der Open Publication Licence
  287.     Version v1.0 oder neuer weiter verbreitet werden. Eine Kopie der
  288.     <A
  289. HREF="#opl.license"
  290. >Open Publication License</A
  291. >
  292.     ist in diesem Handbuch enthalten, die aktuellste Version ist gegenwΣrtig
  293.     immer unter <A
  294. HREF="http://www.opencontent.org/openpub/"
  295. TARGET="_top"
  296. >http://www.opencontent.org/openpub/</A
  297. > verfⁿgbar.
  298.    </P
  299. ><P
  300. >     Die Verbreitung von substantiell modifizierten Versionen dieses Dokuments
  301.     ist ohne die ausdrⁿckliche Erlaubnis des Copyright-Inhabers untersagt.
  302.    </P
  303. ><P
  304. >     Die Verbreitung dieser Arbeit oder abgeleiteter Arbeiten in jeglicher
  305.     Standard-(Papier-) Buchform ist ohne vorherige Erlaubnis durch den
  306.     Copyright-Inhaber verboten.
  307.    </P
  308. ><P
  309. >     Fⁿr den Fall, dass Sie daran interessiert sind, dieses Dokument
  310.     weiter zu verbreiten oder in sonstiger Form zu ver÷ffentlichen, in Teilen
  311.     oder als Ganzes, entweder verΣndert oder unverΣndert und Sie Fragen haben,
  312.     k÷nnen Sie Kontakt zu den Copyright-Inhabern ⁿber
  313.     <A
  314. HREF="mailto:doc-license@lists.php.net"
  315. TARGET="_top"
  316. >doc-license@lists.php.net</A
  317. >.
  318.     aufnehmen. Bitte beachten Sie, dass das Archiv dieser Maillingliste
  319.     ÷ffentlich zugΣnglich ist.
  320.    </P
  321. ><P
  322. >     Das Kapitel 'Extending PHP 4.0' ist ⌐ 2000 by
  323.     Zend Technologies, Ltd. Dieses Material darf nur gemΣ▀ den Regeln und
  324.     Bedingungen der Open Publication Licence Version v1.0 oder neuer, (die
  325.     aktuellste Version ist gegenwΣrtig unter
  326.     <A
  327. HREF="http://www.opencontent.org/openpub/"
  328. TARGET="_top"
  329. >http://www.opencontent.org/openpub/</A
  330. > verfⁿgbar), verbreitet werden.
  331.    </P
  332. ></DIV
  333. ><HR></DIV
  334. ><DIV
  335. CLASS="TOC"
  336. ><DL
  337. ><DT
  338. ><B
  339. >Inhaltsverzeichnis</B
  340. ></DT
  341. ><DT
  342. ><A
  343. HREF="#preface"
  344. >Vorwort</A
  345. ></DT
  346. ><DD
  347. ><DL
  348. ><DT
  349. ><A
  350. HREF="#contributors"
  351. >Autoren und Mitwirkende</A
  352. ></DT
  353. ></DL
  354. ></DD
  355. ><DT
  356. >I. <A
  357. HREF="#getting-started"
  358. >Einfⁿhrung</A
  359. ></DT
  360. ><DD
  361. ><DL
  362. ><DT
  363. >1. <A
  364. HREF="#introduction"
  365. >Einleitung</A
  366. ></DT
  367. ><DT
  368. >2. <A
  369. HREF="#tutorial"
  370. >Kleines Tutorial</A
  371. ></DT
  372. ></DL
  373. ></DD
  374. ><DT
  375. >II. <A
  376. HREF="#install"
  377. >Installation und Konfiguration</A
  378. ></DT
  379. ><DD
  380. ><DL
  381. ><DT
  382. >3. <A
  383. HREF="#install.general"
  384. >General Installation Considerations</A
  385. ></DT
  386. ><DT
  387. >4. <A
  388. HREF="#install.macosx"
  389. >Installation on Mac OS X</A
  390. ></DT
  391. ><DT
  392. >5. <A
  393. HREF="#install.unix"
  394. >Installation on Unix systems</A
  395. ></DT
  396. ><DT
  397. >6. <A
  398. HREF="#install.windows"
  399. >Installation on Windows systems</A
  400. ></DT
  401. ><DT
  402. >7. <A
  403. HREF="#install.problems"
  404. >Problems?</A
  405. ></DT
  406. ><DT
  407. >8. <A
  408. HREF="#configuration"
  409. >Runtime Configuration</A
  410. ></DT
  411. ></DL
  412. ></DD
  413. ><DT
  414. >III. <A
  415. HREF="#langref"
  416. >Sprachreferenz</A
  417. ></DT
  418. ><DD
  419. ><DL
  420. ><DT
  421. >9. <A
  422. HREF="#language.basic-syntax"
  423. >Grundlagen der Syntax</A
  424. ></DT
  425. ><DT
  426. >10. <A
  427. HREF="#language.types"
  428. >Typen</A
  429. ></DT
  430. ><DT
  431. >11. <A
  432. HREF="#language.variables"
  433. >Variablen</A
  434. ></DT
  435. ><DT
  436. >12. <A
  437. HREF="#language.constants"
  438. >Konstanten</A
  439. ></DT
  440. ><DT
  441. >13. <A
  442. HREF="#language.expressions"
  443. >Ausdrⁿcke</A
  444. ></DT
  445. ><DT
  446. >14. <A
  447. HREF="#language.operators"
  448. >Operatoren</A
  449. ></DT
  450. ><DT
  451. >15. <A
  452. HREF="#language.control-structures"
  453. >Kontroll-Strukturen</A
  454. ></DT
  455. ><DT
  456. >16. <A
  457. HREF="#functions"
  458. >Funktionen</A
  459. ></DT
  460. ><DT
  461. >17. <A
  462. HREF="#language.oop"
  463. >Klassen und Objekte</A
  464. ></DT
  465. ><DT
  466. >18. <A
  467. HREF="#language.oop5"
  468. >Classes and Objects (PHP 5)</A
  469. ></DT
  470. ><DT
  471. >19. <A
  472. HREF="#language.references"
  473. >Referenzen in PHP</A
  474. ></DT
  475. ></DL
  476. ></DD
  477. ><DT
  478. >IV. <A
  479. HREF="#security"
  480. >Sicherheit</A
  481. ></DT
  482. ><DD
  483. ><DL
  484. ><DT
  485. >20. <A
  486. HREF="#security.intro"
  487. >Einfⁿhrung</A
  488. ></DT
  489. ><DT
  490. >21. <A
  491. HREF="#security.general"
  492. >Allgemeine ▄berlegungen</A
  493. ></DT
  494. ><DT
  495. >22. <A
  496. HREF="#security.cgi-bin"
  497. >CGI-Version</A
  498. ></DT
  499. ><DT
  500. >23. <A
  501. HREF="#security.apache"
  502. >Apache-Modul</A
  503. ></DT
  504. ><DT
  505. >24. <A
  506. HREF="#security.filesystem"
  507. >Dateisystem - Sicherheit</A
  508. ></DT
  509. ><DT
  510. >25. <A
  511. HREF="#security.database"
  512. >Datenbank - Sicherheit</A
  513. ></DT
  514. ><DT
  515. >26. <A
  516. HREF="#security.errors"
  517. >Fehlerbehandlung</A
  518. ></DT
  519. ><DT
  520. >27. <A
  521. HREF="#security.globals"
  522. >Verwendung von Register Globals</A
  523. ></DT
  524. ><DT
  525. >28. <A
  526. HREF="#security.variables"
  527. >Vom Nutzer ⁿbermittelte Daten</A
  528. ></DT
  529. ><DT
  530. >29. <A
  531. HREF="#security.hiding"
  532. >Verstecken von PHP</A
  533. ></DT
  534. ><DT
  535. >30. <A
  536. HREF="#security.current"
  537. >Aktuell bleiben</A
  538. ></DT
  539. ></DL
  540. ></DD
  541. ><DT
  542. >V. <A
  543. HREF="#features"
  544. >Features</A
  545. ></DT
  546. ><DD
  547. ><DL
  548. ><DT
  549. >31. <A
  550. HREF="#features.http-auth"
  551. >HTTP-Authentifizierung mit PHP</A
  552. ></DT
  553. ><DT
  554. >32. <A
  555. HREF="#features.cookies"
  556. >Cookies</A
  557. ></DT
  558. ><DT
  559. >33. <A
  560. HREF="#features.xforms"
  561. >Dealing with XForms</A
  562. ></DT
  563. ><DT
  564. >34. <A
  565. HREF="#features.file-upload"
  566. >Steuerung von Dateiuploads</A
  567. ></DT
  568. ><DT
  569. >35. <A
  570. HREF="#features.remote-files"
  571. >Zugriff auf entfernte Dateien</A
  572. ></DT
  573. ><DT
  574. >36. <A
  575. HREF="#features.connection-handling"
  576. >Verbindungssteuerung</A
  577. ></DT
  578. ><DT
  579. >37. <A
  580. HREF="#features.persistent-connections"
  581. >Persistente Datenbankverbindungen</A
  582. ></DT
  583. ><DT
  584. >38. <A
  585. HREF="#features.safe-mode"
  586. >Safe Mode</A
  587. ></DT
  588. ><DT
  589. >39. <A
  590. HREF="#features.commandline"
  591. >PHP auf der Kommandozeile</A
  592. ></DT
  593. ></DL
  594. ></DD
  595. ><DT
  596. >VI. <A
  597. HREF="#funcref"
  598. >Funktionsreferenz</A
  599. ></DT
  600. ><DD
  601. ><DL
  602. ><DT
  603. >I. <A
  604. HREF="#ref.apache"
  605. >Apache-spezifische Funktionen</A
  606. ></DT
  607. ><DT
  608. >II. <A
  609. HREF="#ref.array"
  610. >Array Funktionen</A
  611. ></DT
  612. ><DT
  613. >III. <A
  614. HREF="#ref.aspell"
  615. >Aspell Funktionen [veraltet]</A
  616. ></DT
  617. ><DT
  618. >IV. <A
  619. HREF="#ref.bc"
  620. >Mathematische Funktionen mit beliebiger Genauigkeit</A
  621. ></DT
  622. ><DT
  623. >V. <A
  624. HREF="#ref.bzip2"
  625. >Bzip2 Komprimierungsfunktionen</A
  626. ></DT
  627. ><DT
  628. >VI. <A
  629. HREF="#ref.calendar"
  630. >Kalender-Funktionen</A
  631. ></DT
  632. ><DT
  633. >VII. <A
  634. HREF="#ref.ccvs"
  635. >CCVS API Funktionen</A
  636. ></DT
  637. ><DT
  638. >VIII. <A
  639. HREF="#ref.com"
  640. >COM Support Funktionen fⁿr Windows</A
  641. ></DT
  642. ><DT
  643. >IX. <A
  644. HREF="#ref.classobj"
  645. >Klassen- und Objekt-Funktionen</A
  646. ></DT
  647. ><DT
  648. >X. <A
  649. HREF="#ref.cpdf"
  650. >ClibPDF Funktionen</A
  651. ></DT
  652. ><DT
  653. >XI. <A
  654. HREF="#ref.crack"
  655. >Crack Funktionen</A
  656. ></DT
  657. ><DT
  658. >XII. <A
  659. HREF="#ref.curl"
  660. >cURL, Client URL Bibiothek-Funktionen</A
  661. ></DT
  662. ><DT
  663. >XIII. <A
  664. HREF="#ref.cybercash"
  665. >Cybercash Bezahl Funktionen</A
  666. ></DT
  667. ><DT
  668. >XIV. <A
  669. HREF="#ref.cyrus"
  670. >Cyrus IMAP administration Functions</A
  671. ></DT
  672. ><DT
  673. >XV. <A
  674. HREF="#ref.ctype"
  675. >Character type functions</A
  676. ></DT
  677. ><DT
  678. >XVI. <A
  679. HREF="#ref.dba"
  680. >dba Datenbank (dbm-style) Abstraktions-Funktionen</A
  681. ></DT
  682. ><DT
  683. >XVII. <A
  684. HREF="#ref.datetime"
  685. >Datums- und Zeit-Funktionen</A
  686. ></DT
  687. ><DT
  688. >XVIII. <A
  689. HREF="#ref.dbase"
  690. >dBase Funktionen</A
  691. ></DT
  692. ><DT
  693. >XIX. <A
  694. HREF="#ref.dbm"
  695. >DBM Datenbankfunktionen</A
  696. ></DT
  697. ><DT
  698. >XX. <A
  699. HREF="#ref.dbx"
  700. >dbx Funktionen</A
  701. ></DT
  702. ><DT
  703. >XXI. <A
  704. HREF="#ref.dbplus"
  705. >DB++ Functions</A
  706. ></DT
  707. ><DT
  708. >XXII. <A
  709. HREF="#ref.dio"
  710. >Direkte Ein-/Ausgabe Funktionen</A
  711. ></DT
  712. ><DT
  713. >XXIII. <A
  714. HREF="#ref.dir"
  715. >Verzeichnis-Funktionen</A
  716. ></DT
  717. ><DT
  718. >XXIV. <A
  719. HREF="#ref.dom"
  720. >DOM Functions</A
  721. ></DT
  722. ><DT
  723. >XXV. <A
  724. HREF="#ref.domxml"
  725. >DOM XML Funktionen</A
  726. ></DT
  727. ><DT
  728. >XXVI. <A
  729. HREF="#ref.dotnet"
  730. >.NET Funktionen</A
  731. ></DT
  732. ><DT
  733. >XXVII. <A
  734. HREF="#ref.errorfunc"
  735. >Error Handling and Logging Functions</A
  736. ></DT
  737. ><DT
  738. >XXVIII. <A
  739. HREF="#ref.exif"
  740. >Exif Functions</A
  741. ></DT
  742. ><DT
  743. >XXIX. <A
  744. HREF="#ref.fam"
  745. >File Alteration Monitor Functions</A
  746. ></DT
  747. ><DT
  748. >XXX. <A
  749. HREF="#ref.fbsql"
  750. >FrontBase Funktionen</A
  751. ></DT
  752. ><DT
  753. >XXXI. <A
  754. HREF="#ref.filepro"
  755. >filePro Funktionen</A
  756. ></DT
  757. ><DT
  758. >XXXII. <A
  759. HREF="#ref.filesystem"
  760. >Funktionen des Dateisystems</A
  761. ></DT
  762. ><DT
  763. >XXXIII. <A
  764. HREF="#ref.fdf"
  765. >Forms Data Format Funktionen</A
  766. ></DT
  767. ><DT
  768. >XXXIV. <A
  769. HREF="#ref.fribidi"
  770. >FriBiDi Funktionen</A
  771. ></DT
  772. ><DT
  773. >XXXV. <A
  774. HREF="#ref.ftp"
  775. >FTP-Funktionen</A
  776. ></DT
  777. ><DT
  778. >XXXVI. <A
  779. HREF="#ref.funchand"
  780. >Function Handling functions</A
  781. ></DT
  782. ><DT
  783. >XXXVII. <A
  784. HREF="#ref.gettext"
  785. >GNU Gettext</A
  786. ></DT
  787. ><DT
  788. >XXXVIII. <A
  789. HREF="#ref.gmp"
  790. >GMP Functions</A
  791. ></DT
  792. ><DT
  793. >XXXIX. <A
  794. HREF="#ref.http"
  795. >HTTP functions</A
  796. ></DT
  797. ><DT
  798. >XL. <A
  799. HREF="#ref.hw"
  800. >Hyperwave Functions</A
  801. ></DT
  802. ><DT
  803. >XLI. <A
  804. HREF="#ref.hwapi"
  805. >Hyperwave API Functions</A
  806. ></DT
  807. ><DT
  808. >XLII. <A
  809. HREF="#ref.iconv"
  810. >iconv Funktionen</A
  811. ></DT
  812. ><DT
  813. >XLIII. <A
  814. HREF="#ref.image"
  815. >Grafik-Funktionen</A
  816. ></DT
  817. ><DT
  818. >XLIV. <A
  819. HREF="#ref.imap"
  820. >IMAP, POP3 und NNTP Funktionen</A
  821. ></DT
  822. ><DT
  823. >XLV. <A
  824. HREF="#ref.ifx"
  825. >Informix Funktionen</A
  826. ></DT
  827. ><DT
  828. >XLVI. <A
  829. HREF="#ref.ibase"
  830. >InterBase-Funktionen</A
  831. ></DT
  832. ><DT
  833. >XLVII. <A
  834. HREF="#ref.id3"
  835. >ID3 Functions</A
  836. ></DT
  837. ><DT
  838. >XLVIII. <A
  839. HREF="#ref.ingres"
  840. >Ingres II Funktionen</A
  841. ></DT
  842. ><DT
  843. >XLIX. <A
  844. HREF="#ref.ircg"
  845. >IRC Gateway Funktionen</A
  846. ></DT
  847. ><DT
  848. >L. <A
  849. HREF="#ref.java"
  850. >Java</A
  851. ></DT
  852. ><DT
  853. >LI. <A
  854. HREF="#ref.ldap"
  855. >LDAP Funktionen</A
  856. ></DT
  857. ><DT
  858. >LII. <A
  859. HREF="#ref.lzf"
  860. >LZF Functions</A
  861. ></DT
  862. ><DT
  863. >LIII. <A
  864. HREF="#ref.mail"
  865. >Mail-Funktionen</A
  866. ></DT
  867. ><DT
  868. >LIV. <A
  869. HREF="#ref.mailparse"
  870. >mailparse Functions</A
  871. ></DT
  872. ><DT
  873. >LV. <A
  874. HREF="#ref.math"
  875. >Mathematische Funktionen</A
  876. ></DT
  877. ><DT
  878. >LVI. <A
  879. HREF="#ref.mbstring"
  880. >Multibyte String Functions</A
  881. ></DT
  882. ><DT
  883. >LVII. <A
  884. HREF="#ref.mcal"
  885. >MCAL Funktionen</A
  886. ></DT
  887. ><DT
  888. >LVIII. <A
  889. HREF="#ref.mcrypt"
  890. >Mcrypt Encryption Functions</A
  891. ></DT
  892. ><DT
  893. >LIX. <A
  894. HREF="#ref.mcve"
  895. >MCVE Payment Functions</A
  896. ></DT
  897. ><DT
  898. >LX. <A
  899. HREF="#ref.memcache"
  900. >Memcache Functions</A
  901. ></DT
  902. ><DT
  903. >LXI. <A
  904. HREF="#ref.mhash"
  905. >Hash Funktionen</A
  906. ></DT
  907. ><DT
  908. >LXII. <A
  909. HREF="#ref.mime-magic"
  910. >Mimetype Functions</A
  911. ></DT
  912. ><DT
  913. >LXIII. <A
  914. HREF="#ref.mssql"
  915. >Microsoft SQL Server Funktionen</A
  916. ></DT
  917. ><DT
  918. >LXIV. <A
  919. HREF="#ref.ming"
  920. >Ming functions for Flash</A
  921. ></DT
  922. ><DT
  923. >LXV. <A
  924. HREF="#ref.misc"
  925. >Sonstige Funktionen</A
  926. ></DT
  927. ><DT
  928. >LXVI. <A
  929. HREF="#ref.mnogo"
  930. >mnoGoSearch Funktionen</A
  931. ></DT
  932. ><DT
  933. >LXVII. <A
  934. HREF="#ref.msql"
  935. >mSQL Funktionen</A
  936. ></DT
  937. ><DT
  938. >LXVIII. <A
  939. HREF="#ref.mysql"
  940. >MySQL Funktionen</A
  941. ></DT
  942. ><DT
  943. >LXIX. <A
  944. HREF="#ref.mysqli"
  945. >Verbesserte MySQL Erweiterung</A
  946. ></DT
  947. ><DT
  948. >LXX. <A
  949. HREF="#ref.msession"
  950. >Mohawk Software Session Handler Funktionen</A
  951. ></DT
  952. ><DT
  953. >LXXI. <A
  954. HREF="#ref.muscat"
  955. >muscat Functions</A
  956. ></DT
  957. ><DT
  958. >LXXII. <A
  959. HREF="#ref.network"
  960. >Netzwerk Funktionen</A
  961. ></DT
  962. ><DT
  963. >LXXIII. <A
  964. HREF="#ref.ncurses"
  965. >Ncurses Terminal Screen Control Functions</A
  966. ></DT
  967. ><DT
  968. >LXXIV. <A
  969. HREF="#ref.notes"
  970. >Lotus Notes Functions</A
  971. ></DT
  972. ><DT
  973. >LXXV. <A
  974. HREF="#ref.nsapi"
  975. >NSAPI-specific Functions</A
  976. ></DT
  977. ><DT
  978. >LXXVI. <A
  979. HREF="#ref.odbc"
  980. >ODBC Funktionen</A
  981. ></DT
  982. ><DT
  983. >LXXVII. <A
  984. HREF="#ref.objaggregation"
  985. >Object Aggregation/Composition Functions</A
  986. ></DT
  987. ><DT
  988. >LXXVIII. <A
  989. HREF="#ref.oci8"
  990. >Oracle 8 Funktionen</A
  991. ></DT
  992. ><DT
  993. >LXXIX. <A
  994. HREF="#ref.openssl"
  995. >OpenSSL Funktionen</A
  996. ></DT
  997. ><DT
  998. >LXXX. <A
  999. HREF="#ref.oracle"
  1000. >Oracle Funktionen</A
  1001. ></DT
  1002. ><DT
  1003. >LXXXI. <A
  1004. HREF="#ref.ovrimos"
  1005. >Ovrimos SQL Functions</A
  1006. ></DT
  1007. ><DT
  1008. >LXXXII. <A
  1009. HREF="#ref.outcontrol"
  1010. >Funktionen zur Ausgabesteuerung</A
  1011. ></DT
  1012. ><DT
  1013. >LXXXIII. <A
  1014. HREF="#ref.overload"
  1015. >Object property and method call overloading</A
  1016. ></DT
  1017. ><DT
  1018. >LXXXIV. <A
  1019. HREF="#ref.pdf"
  1020. >PDF Funktionen</A
  1021. ></DT
  1022. ><DT
  1023. >LXXXV. <A
  1024. HREF="#ref.pfpro"
  1025. >Verisign Payflow Pro Funktionen</A
  1026. ></DT
  1027. ><DT
  1028. >LXXXVI. <A
  1029. HREF="#ref.info"
  1030. >PHP Optionen & Informationen</A
  1031. ></DT
  1032. ><DT
  1033. >LXXXVII. <A
  1034. HREF="#ref.posix"
  1035. >POSIX Funktionen</A
  1036. ></DT
  1037. ><DT
  1038. >LXXXVIII. <A
  1039. HREF="#ref.pgsql"
  1040. >PostgreSQL Funktionen</A
  1041. ></DT
  1042. ><DT
  1043. >LXXXIX. <A
  1044. HREF="#ref.pcntl"
  1045. >Process Control Functions</A
  1046. ></DT
  1047. ><DT
  1048. >XC. <A
  1049. HREF="#ref.exec"
  1050. >Funktionen zur Programmausfⁿhrung</A
  1051. ></DT
  1052. ><DT
  1053. >XCI. <A
  1054. HREF="#ref.printer"
  1055. >Printer Functions</A
  1056. ></DT
  1057. ><DT
  1058. >XCII. <A
  1059. HREF="#ref.pspell"
  1060. >Pspell Funktionen</A
  1061. ></DT
  1062. ><DT
  1063. >XCIII. <A
  1064. HREF="#ref.readline"
  1065. >GNU Readline</A
  1066. ></DT
  1067. ><DT
  1068. >XCIV. <A
  1069. HREF="#ref.recode"
  1070. >GNU Recode Funktionen</A
  1071. ></DT
  1072. ><DT
  1073. >XCV. <A
  1074. HREF="#ref.pcre"
  1075. >RegulΣre Ausdrⁿcke Funktionen (Perl-kompatibel)</A
  1076. ></DT
  1077. ><DT
  1078. >XCVI. <A
  1079. HREF="#ref.qtdom"
  1080. >qtdom Functions</A
  1081. ></DT
  1082. ><DT
  1083. >XCVII. <A
  1084. HREF="#ref.regex"
  1085. >RegulΣre Ausdrⁿcke Funktionen (POSIX erweitert)</A
  1086. ></DT
  1087. ><DT
  1088. >XCVIII. <A
  1089. HREF="#ref.sem"
  1090. >Semaphor und Shared Memory Funktionen</A
  1091. ></DT
  1092. ><DT
  1093. >XCIX. <A
  1094. HREF="#ref.sesam"
  1095. >SESAM Datenbankfunktionen</A
  1096. ></DT
  1097. ><DT
  1098. >C. <A
  1099. HREF="#ref.session"
  1100. >Session Funktionen</A
  1101. ></DT
  1102. ><DT
  1103. >CI. <A
  1104. HREF="#ref.shmop"
  1105. >Shared Memory Funktionen (Gemeinsamer Speicher)</A
  1106. ></DT
  1107. ><DT
  1108. >CII. <A
  1109. HREF="#ref.simplexml"
  1110. >SimpleXML functions</A
  1111. ></DT
  1112. ><DT
  1113. >CIII. <A
  1114. HREF="#ref.soap"
  1115. >SOAP Functions</A
  1116. ></DT
  1117. ><DT
  1118. >CIV. <A
  1119. HREF="#ref.sqlite"
  1120. >SQLite</A
  1121. ></DT
  1122. ><DT
  1123. >CV. <A
  1124. HREF="#ref.swf"
  1125. >Shockwave Flash Funktionen</A
  1126. ></DT
  1127. ><DT
  1128. >CVI. <A
  1129. HREF="#ref.snmp"
  1130. >SNMP Funktionen</A
  1131. ></DT
  1132. ><DT
  1133. >CVII. <A
  1134. HREF="#ref.sockets"
  1135. >Socket Funktionen</A
  1136. ></DT
  1137. ><DT
  1138. >CVIII. <A
  1139. HREF="#ref.spl"
  1140. >Standard PHP Library (SPL) Functions</A
  1141. ></DT
  1142. ><DT
  1143. >CIX. <A
  1144. HREF="#ref.stream"
  1145. >Stream Functions</A
  1146. ></DT
  1147. ><DT
  1148. >CX. <A
  1149. HREF="#ref.strings"
  1150. >String-Funktionen</A
  1151. ></DT
  1152. ><DT
  1153. >CXI. <A
  1154. HREF="#ref.sybase"
  1155. >Sybase Funktionen</A
  1156. ></DT
  1157. ><DT
  1158. >CXII. <A
  1159. HREF="#ref.tcpwrap"
  1160. >TCP Wrappers Functions</A
  1161. ></DT
  1162. ><DT
  1163. >CXIII. <A
  1164. HREF="#ref.tidy"
  1165. >Tidy Functions</A
  1166. ></DT
  1167. ><DT
  1168. >CXIV. <A
  1169. HREF="#ref.tokenizer"
  1170. >Tokenizer Functions</A
  1171. ></DT
  1172. ><DT
  1173. >CXV. <A
  1174. HREF="#ref.url"
  1175. >URL Funktionen</A
  1176. ></DT
  1177. ><DT
  1178. >CXVI. <A
  1179. HREF="#ref.variables"
  1180. >Variablen-Funktionen</A
  1181. ></DT
  1182. ><DT
  1183. >CXVII. <A
  1184. HREF="#ref.vpopmail"
  1185. >vpopmail Functions</A
  1186. ></DT
  1187. ><DT
  1188. >CXVIII. <A
  1189. HREF="#ref.w32api"
  1190. >W32api Functions</A
  1191. ></DT
  1192. ><DT
  1193. >CXIX. <A
  1194. HREF="#ref.wddx"
  1195. >WDDX Funktionen</A
  1196. ></DT
  1197. ><DT
  1198. >CXX. <A
  1199. HREF="#ref.xml"
  1200. >XML Parser Functions</A
  1201. ></DT
  1202. ><DT
  1203. >CXXI. <A
  1204. HREF="#ref.xmlrpc"
  1205. >XML-RPC Functions</A
  1206. ></DT
  1207. ><DT
  1208. >CXXII. <A
  1209. HREF="#ref.xdiff"
  1210. >xdiff Functions</A
  1211. ></DT
  1212. ><DT
  1213. >CXXIII. <A
  1214. HREF="#ref.xsl"
  1215. >XSL functions</A
  1216. ></DT
  1217. ><DT
  1218. >CXXIV. <A
  1219. HREF="#ref.xslt"
  1220. >XSLT Funktionen</A
  1221. ></DT
  1222. ><DT
  1223. >CXXV. <A
  1224. HREF="#ref.yaz"
  1225. >YAZ Functions</A
  1226. ></DT
  1227. ><DT
  1228. >CXXVI. <A
  1229. HREF="#ref.nis"
  1230. >YP/NIS Funktionen</A
  1231. ></DT
  1232. ><DT
  1233. >CXXVII. <A
  1234. HREF="#ref.zip"
  1235. >ZIP Funktionen (Lesezugriff)</A
  1236. ></DT
  1237. ><DT
  1238. >CXXVIII. <A
  1239. HREF="#ref.zlib"
  1240. >Zlib Komprimierungsfunktionen</A
  1241. ></DT
  1242. ></DL
  1243. ></DD
  1244. ><DT
  1245. >VII. <A
  1246. HREF="#zend"
  1247. >Zend API</A
  1248. ></DT
  1249. ><DD
  1250. ><DL
  1251. ><DT
  1252. >40. <A
  1253. HREF="#zend.overview"
  1254. >Overview</A
  1255. ></DT
  1256. ><DT
  1257. >41. <A
  1258. HREF="#zend.possibilities"
  1259. >Extension Possibilities</A
  1260. ></DT
  1261. ><DT
  1262. >42. <A
  1263. HREF="#zend.layout"
  1264. >Source Layout</A
  1265. ></DT
  1266. ><DT
  1267. >43. <A
  1268. HREF="#zend.build"
  1269. >PHP's Automatic Build System</A
  1270. ></DT
  1271. ><DT
  1272. >44. <A
  1273. HREF="#zend.creating"
  1274. >Creating Extensions</A
  1275. ></DT
  1276. ><DT
  1277. >45. <A
  1278. HREF="#zend.using"
  1279. >Using Extensions</A
  1280. ></DT
  1281. ><DT
  1282. >46. <A
  1283. HREF="#zend.troubleshooting"
  1284. >Troubleshooting</A
  1285. ></DT
  1286. ><DT
  1287. >47. <A
  1288. HREF="#zend.structure"
  1289. >Source Discussion</A
  1290. ></DT
  1291. ><DT
  1292. >48. <A
  1293. HREF="#zend.arguments"
  1294. >Accepting Arguments</A
  1295. ></DT
  1296. ><DT
  1297. >49. <A
  1298. HREF="#zend.variables"
  1299. >Creating Variables</A
  1300. ></DT
  1301. ><DT
  1302. >50. <A
  1303. HREF="#zend.copy-constructor"
  1304. >Duplicating Variable Contents: The Copy Constructor</A
  1305. ></DT
  1306. ><DT
  1307. >51. <A
  1308. HREF="#zend.returning"
  1309. >Returning Values</A
  1310. ></DT
  1311. ><DT
  1312. >52. <A
  1313. HREF="#zend.printing"
  1314. >Printing Information</A
  1315. ></DT
  1316. ><DT
  1317. >53. <A
  1318. HREF="#zend.startup-and-shutdown"
  1319. >Startup and Shutdown Functions</A
  1320. ></DT
  1321. ><DT
  1322. >54. <A
  1323. HREF="#zend.calling-user-functions"
  1324. >Calling User Functions</A
  1325. ></DT
  1326. ><DT
  1327. >55. <A
  1328. HREF="#zend.ini-file-support"
  1329. >Initialization File Support</A
  1330. ></DT
  1331. ><DT
  1332. >56. <A
  1333. HREF="#zend.where-to-go"
  1334. >Where to Go from Here</A
  1335. ></DT
  1336. ><DT
  1337. >57. <A
  1338. HREF="#zend.configuration-macros"
  1339. >Reference: Some Configuration Macros</A
  1340. ></DT
  1341. ><DT
  1342. >58. <A
  1343. HREF="#zend.api-macros"
  1344. >API Macros</A
  1345. ></DT
  1346. ></DL
  1347. ></DD
  1348. ><DT
  1349. >VIII. <A
  1350. HREF="#api"
  1351. >PHP API: Schnittstellen fⁿr Programmierer</A
  1352. ></DT
  1353. ><DD
  1354. ><DL
  1355. ><DT
  1356. >59. <A
  1357. HREF="#streams"
  1358. >Streams API for PHP Extension Authors</A
  1359. ></DT
  1360. ></DL
  1361. ></DD
  1362. ><DT
  1363. >IX. <A
  1364. HREF="#faq"
  1365. >FAQ: Frequently Asked Questions</A
  1366. ></DT
  1367. ><DD
  1368. ><DL
  1369. ><DT
  1370. >60. <A
  1371. HREF="#faq.general"
  1372. >Allgemeine Informationen</A
  1373. ></DT
  1374. ><DT
  1375. >61. <A
  1376. HREF="#faq.mailinglist"
  1377. >Mailing-Listen</A
  1378. ></DT
  1379. ><DT
  1380. >62. <A
  1381. HREF="#faq.obtaining"
  1382. >Obtaining PHP</A
  1383. ></DT
  1384. ><DT
  1385. >63. <A
  1386. HREF="#faq.databases"
  1387. >Database issues</A
  1388. ></DT
  1389. ><DT
  1390. >64. <A
  1391. HREF="#faq.installation"
  1392. >Installation</A
  1393. ></DT
  1394. ><DT
  1395. >65. <A
  1396. HREF="#faq.build"
  1397. >Probleme bei der Compilierung</A
  1398. ></DT
  1399. ><DT
  1400. >66. <A
  1401. HREF="#faq.using"
  1402. >PHP benutzen</A
  1403. ></DT
  1404. ><DT
  1405. >67. <A
  1406. HREF="#faq.html"
  1407. >PHP und HTML</A
  1408. ></DT
  1409. ><DT
  1410. >68. <A
  1411. HREF="#faq.com"
  1412. >PHP and COM</A
  1413. ></DT
  1414. ><DT
  1415. >69. <A
  1416. HREF="#faq.languages"
  1417. >PHP und andere Sprachen</A
  1418. ></DT
  1419. ><DT
  1420. >70. <A
  1421. HREF="#faq.migration"
  1422. >Von PHP 2 auf PHP 3 umsteigen</A
  1423. ></DT
  1424. ><DT
  1425. >71. <A
  1426. HREF="#faq.migration4"
  1427. >Von PHP 3 auf PHP 4 umsteigen</A
  1428. ></DT
  1429. ><DT
  1430. >72. <A
  1431. HREF="#faq.migration5"
  1432. >Migrating from PHP 4 to PHP 5</A
  1433. ></DT
  1434. ><DT
  1435. >73. <A
  1436. HREF="#faq.misc"
  1437. >Verschiedene Fragen</A
  1438. ></DT
  1439. ></DL
  1440. ></DD
  1441. ><DT
  1442. >X. <A
  1443. HREF="#appendixes"
  1444. >Anhang</A
  1445. ></DT
  1446. ><DD
  1447. ><DL
  1448. ><DT
  1449. >A. <A
  1450. HREF="#history"
  1451. >Die Geschichte von PHP und verwandten Projekten</A
  1452. ></DT
  1453. ><DT
  1454. >B. <A
  1455. HREF="#migration5"
  1456. >Migrating from PHP 4 to PHP 5</A
  1457. ></DT
  1458. ><DT
  1459. >C. <A
  1460. HREF="#migration4"
  1461. >Migrating from PHP 3 to PHP 4</A
  1462. ></DT
  1463. ><DT
  1464. >D. <A
  1465. HREF="#migration"
  1466. >Migration von PHP/FI 2.0 zu PHP 3.0</A
  1467. ></DT
  1468. ><DT
  1469. >E. <A
  1470. HREF="#debugger"
  1471. >Der PHP-Debugger</A
  1472. ></DT
  1473. ><DT
  1474. >F. <A
  1475. HREF="#phpdevel"
  1476. >Extending PHP 3</A
  1477. ></DT
  1478. ><DT
  1479. >G. <A
  1480. HREF="#configure"
  1481. >Configure options</A
  1482. ></DT
  1483. ><DT
  1484. >H. <A
  1485. HREF="#ini"
  1486. >Liste der core <TT
  1487. CLASS="filename"
  1488. >php.ini</TT
  1489. > Einstellungen</A
  1490. ></DT
  1491. ><DT
  1492. >I. <A
  1493. HREF="#aliases"
  1494. >Liste der Funktion Aliase</A
  1495. ></DT
  1496. ><DT
  1497. >J. <A
  1498. HREF="#reserved"
  1499. >Reservierte W÷rter in PHP</A
  1500. ></DT
  1501. ><DT
  1502. >K. <A
  1503. HREF="#resource"
  1504. >Liste von Ressourcentypen</A
  1505. ></DT
  1506. ><DT
  1507. >L. <A
  1508. HREF="#wrappers"
  1509. >List of Supported Protocols/Wrappers</A
  1510. ></DT
  1511. ><DT
  1512. >M. <A
  1513. HREF="#filters"
  1514. >List of Available Filters</A
  1515. ></DT
  1516. ><DT
  1517. >N. <A
  1518. HREF="#transports"
  1519. >List of Supported Socket Transports</A
  1520. ></DT
  1521. ><DT
  1522. >O. <A
  1523. HREF="#types.comparisons"
  1524. >PHP type comparison tables</A
  1525. ></DT
  1526. ><DT
  1527. >P. <A
  1528. HREF="#tokens"
  1529. >List of Parser Tokens</A
  1530. ></DT
  1531. ><DT
  1532. >Q. <A
  1533. HREF="#about"
  1534. >▄ber das Handbuch</A
  1535. ></DT
  1536. ><DT
  1537. >R. <A
  1538. HREF="#opl.license"
  1539. >Open Publication License</A
  1540. ></DT
  1541. ><DT
  1542. >S. <A
  1543. HREF="#indexes"
  1544. >Funktions-Index</A
  1545. ></DT
  1546. ><DT
  1547. >T. <A
  1548. HREF="#missing-stuff"
  1549. >Fehlendes</A
  1550. ></DT
  1551. ></DL
  1552. ></DD
  1553. ></DL
  1554. ></DIV
  1555. ><DIV
  1556. CLASS="preface"
  1557. ><HR><H1
  1558. ><A
  1559. NAME="preface"
  1560. >Vorwort</A
  1561. ></H1
  1562. ><BLOCKQUOTE
  1563. CLASS="ABSTRACT"
  1564. ><DIV
  1565. CLASS="abstract"
  1566. ><P
  1567. ></P
  1568. ><A
  1569. NAME="AEN120"
  1570. ></A
  1571. ><P
  1572. >     <ACRONYM
  1573. CLASS="acronym"
  1574. >PHP</ACRONYM
  1575. > ist die Abkⁿrzung fⁿr "PHP: Hypertext
  1576.     Preprocessor", eine weitverbreitete Open Source Skriptsprache speziell
  1577.     fⁿr Webentwicklungen. PHP lΣ▀t sich in HTML einbinden. Die Syntax erinnert
  1578.     an C, Java und Perl und ist einfach zu erlernen. Das Hauptziel dieser Sprache
  1579.     ist es, Webentwicklern die M÷glichkeit zu geben, schnell dynamisch
  1580.     generierte Webseiten zu erzeugen. Aber Sie k÷nnen PHP fⁿr weitaus mehr
  1581.     einsetzen.
  1582.    </P
  1583. ><P
  1584. ></P
  1585. ></DIV
  1586. ></BLOCKQUOTE
  1587. ><P
  1588. >    Dieses Handbuch besteht vorranging aus einer <A
  1589. HREF="#funcref"
  1590. >    Funktionsreferenz</A
  1591. >, enthΣlt aber zusΣtzlich auch eine
  1592.    <A
  1593. HREF="#langref"
  1594. >Sprachreferenz</A
  1595. >, ErlΣuterungen zu den
  1596.    wichtigsten <A
  1597. HREF="#features"
  1598. >Features</A
  1599. > und weitere
  1600.    <A
  1601. HREF="#appendixes"
  1602. >ergΣnzende Informationen</A
  1603. >.
  1604.   </P
  1605. ><P
  1606. >    Sie k÷nnen dieses Handbuch in verschiedenen Formaten unter <A
  1607. HREF="http://www.php.net/download-docs.php"
  1608. TARGET="_top"
  1609. >http://www.php.net/download-docs.php</A
  1610. >
  1611.    herunterladen. Informationen dazu, wie dieses Handbuch erstellt wird
  1612.    finden Sie im Anhang unter dem Kapitel <A
  1613. HREF="#about"
  1614. >    '▄ber dieses Handbuch'</A
  1615. >. Wenn Sie sich fⁿr die
  1616.    <A
  1617. HREF="#history"
  1618. >Geschichte von PHP</A
  1619. > interessieren, lesen
  1620.    Sie den entsprechenden Anhang.
  1621.   </P
  1622. ><DIV
  1623. CLASS="sect1"
  1624. ><HR><H2
  1625. CLASS="sect1"
  1626. ><A
  1627. NAME="contributors"
  1628. >Autoren und Mitwirkende</A
  1629. ></H2
  1630. ><P
  1631. >Wir heben die zur Zeit aktivsten Personen
  1632. auf der Titelseite des Handbuchs hervor, aber es gibt viel mehr Mitwirkende,
  1633. die zurzeit mithelfen oder in der Vergangenheit einen gro▀en Beitrag zu diesem
  1634. Projekt geleistet haben. Ebenfalls gibt es eine Menge von Personen, die hier
  1635. nicht namentlich aufgefⁿhrt sind, die durch ihre User Notes auf den
  1636. Handbuchseiten mithelfen. Die User Notes werden kontinuierlich in unser
  1637. Handbuch integriert und wir schΣtzen diese Unterstⁿtzung au▀erordentlich.
  1638. Alle folgenden Listen sind alphabetisch sortiert.</P
  1639. ><DIV
  1640. CLASS="sect2"
  1641. ><HR><H3
  1642. CLASS="sect2"
  1643. ><A
  1644. NAME="AEN135"
  1645. >Authoren und Editoren</A
  1646. ></H3
  1647. ><P
  1648. >    Obwohl im Augenblick nicht aktiv, haben
  1649. folgende Personen in der Vergangenheit wesentlichen Inhalt zum Handbuch
  1650. beigetragen:
  1651.    Jouni Ahto,              
  1652.    Alexander Aulbach,       
  1653.    Daniel Beckham,          
  1654.    Stig Bakken,             
  1655.    Jesus M. Castagnetto,    
  1656.    Ron Chmara,              
  1657.    John Coggeshall,         
  1658.    Simone Cortesi,          
  1659.    Markus Fischer,          
  1660.    Wez Furlong,             
  1661.    Sara Golemon,            
  1662.    Rui Hirokawa,            
  1663.    Brad House,              
  1664.    Moriyoshi Koizumi,       
  1665.    Rasmus Lerdorf,          
  1666.    Andrew Lindeman,         
  1667.    Stanislav Malyshev,      
  1668.    Rafael Martinez,         
  1669.    Yasuo Ohgaki,            
  1670.    Derick Rethans,          
  1671.    Sander Roobol,           
  1672.    Egon Schmid,             
  1673.    Thomas Schoefbeck,       
  1674.    Sascha Schumann,         
  1675.    Lars Torben Wilson,      
  1676.    Jim Winstead,            
  1677.    Jeroen van Wolffelaar und  
  1678.    Andrei Zmievski.         
  1679.   </P
  1680. ><P
  1681. >    Obwohl im Augenblick nicht aktiv, haben
  1682. folgende Personen in der Vergangenheit durch Ihre Editionsarbeit wesentlich zum
  1683. Handbuch beigetragen:
  1684.    Stig Bakken,                    
  1685.    Hartmut Holzgraefe und  
  1686.    Egon Schmid.                    
  1687.   </P
  1688. ></DIV
  1689. ><DIV
  1690. CLASS="sect2"
  1691. ><HR><H3
  1692. CLASS="sect2"
  1693. ><A
  1694. NAME="AEN139"
  1695. >User Note Betreuer</A
  1696. ></H3
  1697. ><P
  1698. >    Zur Zeit aktive Betreuer:
  1699.    Mehdi Achour,                
  1700.    Friedhelm Betz,              
  1701.    Vincent Gevers,              
  1702.    Aidan Lister,                
  1703.    Nuno Lopes und       
  1704.    Tom Sommer.                  
  1705.   </P
  1706. ><P
  1707. >    Folgende Personen haben in der
  1708. Vergangenheit einiges an Mⁿhe und Zeit zur Betreuung der User Notes investiert:
  1709.    Daniel Beckham,         
  1710.    Victor Boivie,          
  1711.    Jesus M. Castagnetto,   
  1712.    Nicolas Chaillan,       
  1713.    Ron Chmara,             
  1714.    James Cox,              
  1715.    Sara Golemon,           
  1716.    Zak Greant,             
  1717.    Szabolcs Heilig,        
  1718.    Oliver Hinckel,         
  1719.    Hartmut Holzgraefe,     
  1720.    Rasmus Lerdorf,         
  1721.    Andrew Lindeman,        
  1722.    Maxim Maletsky,         
  1723.    James Moore,            
  1724.    Sebastian Picklum,      
  1725.    Derick Rethans,         
  1726.    Sander Roobol,          
  1727.    Damien Seguy,           
  1728.    Jason Sheets,           
  1729.    Jani Taskinen,          
  1730.    Yasuo Ohgaki,           
  1731.    Philip Olson,           
  1732.    Lars Torben Wilson,     
  1733.    Jim Winstead,           
  1734.    Jared Wyles und  
  1735.    Jeroen van Wolffelaar.  
  1736.   </P
  1737. ></DIV
  1738. ></DIV
  1739. ></DIV
  1740. ><DIV
  1741. CLASS="PART"
  1742. ><A
  1743. NAME="getting-started"
  1744. ></A
  1745. ><DIV
  1746. CLASS="TITLEPAGE"
  1747. ><H1
  1748. CLASS="title"
  1749. >I. Einfⁿhrung</H1
  1750. ><DIV
  1751. CLASS="TOC"
  1752. ><DL
  1753. ><DT
  1754. ><B
  1755. >Inhaltsverzeichnis</B
  1756. ></DT
  1757. ><DT
  1758. >1. <A
  1759. HREF="#introduction"
  1760. >Einleitung</A
  1761. ></DT
  1762. ><DT
  1763. >2. <A
  1764. HREF="#tutorial"
  1765. >Kleines Tutorial</A
  1766. ></DT
  1767. ></DL
  1768. ></DIV
  1769. ></DIV
  1770. ><DIV
  1771. CLASS="chapter"
  1772. ><HR><H1
  1773. ><A
  1774. NAME="introduction"
  1775. >Kapitel 1. Einleitung</A
  1776. ></H1
  1777. ><DIV
  1778. CLASS="sect1"
  1779. ><H2
  1780. CLASS="sect1"
  1781. ><A
  1782. NAME="intro-whatis"
  1783. >Was ist PHP?</A
  1784. ></H2
  1785. ><P
  1786. >     <ACRONYM
  1787. CLASS="acronym"
  1788. >PHP</ACRONYM
  1789. > 
  1790.     
  1791.     <ACRONYM
  1792. CLASS="acronym"
  1793. >PHP</ACRONYM
  1794. > (Akronym fⁿr "PHP: Hypertext Preprocessor")
  1795.     ist eine weit verbreitete und fⁿr den allgemeinen Gebrauch bestimmte
  1796.     Open Source Skriptsprache, welche speziell fⁿr die Webprogrammierung
  1797.     geeignet ist, und in HTML eingebettet werden kann.
  1798.    </P
  1799. ><P
  1800. >     H÷rt sich einfach an, aber was hei▀t es genau? Ein Beispiel:
  1801.    </P
  1802. ><P
  1803. >     <TABLE
  1804. WIDTH="100%"
  1805. BORDER="0"
  1806. CELLPADDING="0"
  1807. CELLSPACING="0"
  1808. CLASS="EXAMPLE"
  1809. ><TR
  1810. ><TD
  1811. ><DIV
  1812. CLASS="example"
  1813. ><A
  1814. NAME="AEN154"
  1815. ></A
  1816. ><P
  1817. ><B
  1818. >Beispiel 1-1. Ein einleitendes Beispiel</B
  1819. ></P
  1820. ><TABLE
  1821. BORDER="0"
  1822. BGCOLOR="#E0E0E0"
  1823. CELLPADDING="5"
  1824. ><TR
  1825. ><TD
  1826. ><PRE
  1827. CLASS="php"
  1828. ><html>
  1829.     <head>
  1830.         <title>Beispiel</title>
  1831.     </head>
  1832.     <body>
  1833.  
  1834.         <?php 
  1835.         echo "Hallo, ich bin ein PHP-Skript!"; 
  1836.         ?>
  1837.  
  1838.     </body>
  1839. </html></PRE
  1840. ></TD
  1841. ></TR
  1842. ></TABLE
  1843. ></DIV
  1844. ></TD
  1845. ></TR
  1846. ></TABLE
  1847. >
  1848.    </P
  1849. ><P
  1850. >     Beachten Sie den Unterschied zu einem Skript, welches in anderen
  1851.     Sprachen wie Perl oder C geschrieben wurde -- anstatt ein
  1852.     Programm mit vielen Anweisungen zur Ausgabe von HTML zu schreiben,
  1853.     schreibt man einen HTML-Code mit einigen eingebetteten
  1854.     Anweisungen, um etwas auszufⁿhren (z.B. um - wie oben - Text
  1855.     auszugeben). Der PHP-Code steht zwischen speziellen <A
  1856. HREF="#language.basic-syntax.phpmode"
  1857. >Anfangs- und
  1858.     Schlusstags</A
  1859. >, mit denen man in den PHP-Modus und zurⁿck
  1860.     wechseln kann.
  1861.    </P
  1862. ><P
  1863. >     Was PHP von clientseitigen Sprachen wie Javaskript unterscheidet,
  1864.     ist dass der Code auf dem Server ausgefⁿhrt wird. Sollten Sie ein
  1865.     Skript wie das obige auf ihrem Server ausfⁿhren, wⁿrde der Besucher
  1866.     nur das Ergebnis empfangen, ohne die M÷glichkeit herauszufinden,
  1867.     wie der zugrundeliegende Code aussieht. Sie k÷nnen ihren Webserver
  1868.     auch anweisen, alle ihre HTML-Dateien mit PHP zu parsen, denn dann
  1869.     gibt es wirklich nichts, das dem Benutzer sagt, was sie in petto
  1870.     haben.
  1871.    </P
  1872. ><P
  1873. >     Das Beste an der Verwendung von PHP ist, dass es fⁿr Neulinge
  1874.     extrem simpel ist, aber auch einen riesigen Funktionsumfang fⁿr
  1875.     den professionellen Programmierer bietet. Scheuen Sie sich nicht,
  1876.     die lange Liste der PHP-Funktionen zu lesen. Sie k÷nnen einsteigen,
  1877.     und binnen weniger Stunden bereits mit dem Schreiben von einfachen
  1878.     Skripten beginnen.
  1879.    </P
  1880. ><P
  1881. >     Auch wenn die Entwicklung von PHP auf serverseitige Skripte fokussiert
  1882.     ist, k÷nnen Sie mit PHP weitaus mehr anstellen. Lesen Sie mehr im
  1883.     Abschnitt <A
  1884. HREF="#intro-whatcando"
  1885. >Was kann PHP?</A
  1886. > 
  1887.    </P
  1888. ></DIV
  1889. ><DIV
  1890. CLASS="sect1"
  1891. ><HR><H2
  1892. CLASS="sect1"
  1893. ><A
  1894. NAME="intro-whatcando"
  1895. >Was kann PHP?</A
  1896. ></H2
  1897. ><P
  1898. >     Alles. PHP ist hauptsΣchlich auf serverseitige Skripte fokussiert,
  1899.     weshalb Sie alles tun k÷nnen, was auch ein anderes CGI Programm
  1900.     kann, wie z.B. Formulardaten sammeln, dynamische Inhalte fⁿr
  1901.     Websites generieren oder Cookies senden und empfangen. Aber PHP
  1902.     kann noch viel mehr.
  1903.    </P
  1904. ><P
  1905. >     Es gibt drei Hauptgebiete, in denen PHP Skripte genutzt werden.
  1906.     <P
  1907. ></P
  1908. ><UL
  1909. ><LI
  1910. ><P
  1911. >        Serverseitige Skripte. Dies ist das traditionelle und auch Hauptfeld
  1912.        von PHP. Sie ben÷tigen dazu drei Dinge. Den PHP Parser (CGI oder
  1913.        Server-Modul), einen Webserver und einen Webbrowser. Sie mⁿssen
  1914.        den Webserver, verbunden mit einer PHP Installation laufen lassen.
  1915.        Sie k÷nnen Sich Ausgabe der PHP Programme ⁿber den Server mit
  1916.        einem Webbrowser ansehen. Fⁿr weitere Informationen lesen Sie
  1917.        bitte im Abschnitt <A
  1918. HREF="#installation"
  1919. >Installation</A
  1920. >
  1921.        weiter.
  1922.       </P
  1923. ></LI
  1924. ><LI
  1925. ><P
  1926. >        Skripte auf der Kommandozeile. Sie k÷nnen auch PHP Skripte
  1927.        schreiben, um sie ohne einen Server oder einen Browser laufen
  1928.        zu lassen. Hierfⁿr ben÷tigen Sie nur den PHP Parser. Diese Art
  1929.        der Verwendung ist fⁿr die regelmΣ▀ig auszufⁿhrende Skripte mittels
  1930.        cron (unter *nix oder Linux) oder dem Task Scheduler (unter Windows).
  1931.        Diese Skripte k÷nnen auch fⁿr einfache Aufgaben zur Verarbeitung von
  1932.        Text verwendet werden. Weitere Informationen dazu finden Sie im
  1933.        Abschnitt <A
  1934. HREF="#features.commandline"
  1935. >Using PHP from the
  1936.        command line</A
  1937. >.
  1938.       </P
  1939. ></LI
  1940. ><LI
  1941. ><P
  1942. >        Schreiben clientseitiger GUI Applikationen. PHP ist wahrscheinlich
  1943.        nicht die allerbeste Sprache um GUI-Applikationen zu schreiben,
  1944.        aber wenn Sie PHP sehr gut kennen und einige weiterfⁿhrende Funktionen
  1945.        in Ihren clientseitigen Applikationen nutzen m÷chten, k÷nnen Sie
  1946.        PHP-GTK nutzen, um derartige Programme zu schreiben. Auf diese Art
  1947.        haben Sie auch die M÷glichkeit, Plattformⁿbergreifende Applikationen
  1948.        zu schreiben. PHP-GTK ist eine Erweiterung von PHP, welche in der
  1949.        Hauptdistribution nicht enthalten ist. Sollten Sie daran interessiert
  1950.        sein, besuchen Sie die <A
  1951. HREF="http://gtk.php.net/"
  1952. TARGET="_top"
  1953. >PHP-GTK
  1954.        Website</A
  1955. >.
  1956.       </P
  1957. ></LI
  1958. ></UL
  1959. >
  1960.    </P
  1961. ><P
  1962. >     PHP kann auf allen gΣngigen Betriebssystemen verwendet werden, inkl.
  1963.     Linux, vielen Unix-Varianten (inkl. HP-UX, Solaris und OpenBSD), 
  1964.     Microsoft Windows, Mac OS X, RISC OS, und wahrscheinlich anderen.
  1965.     PHP unterstⁿtzt auch die meisten der heute gebrΣuchlichen Webserver.
  1966.     Dies umfasst Apache, Microsoft Internet Information Server,
  1967.     Personal Web Server, Netscape und iPlanet Server, Oreilly
  1968.     Website Pro Server, Caudium, Xitami, OmniHTTPd, und viele andere.
  1969.     Fⁿr den Gro▀teil der Server bietet PHP ein eigenes Modul, fⁿr die
  1970.     anderen, welche den CGI Standard unterstⁿtzen, kann PHP als CGI
  1971.     Prozessor arbeiten.
  1972.    </P
  1973. ><P
  1974. >     So haben Sie Freiheit, PHP auf dem Betriebssystem und dem Webserver
  1975.     Ihrer Wahl laufen zu lassen. Weiters k÷nnen Sie je nach Vorliebe
  1976.     prozedural, objektorientiert, oder gemischt programmieren. Auch
  1977.     wenn in der derzeitigen Version von PHP nicht jedes Standard OOP
  1978.     Feature realisiert ist, sind viele Bibliotheken und gro▀e
  1979.     Applikationen (inklusive der PEAR Bibliothek) exklusiv unter
  1980.     Verwendung von OOP Code geschrieben worden.
  1981.    </P
  1982. ><P
  1983. >     Mit PHP sind Sie nicht auf die Ausgabe von HTML beschrΣnkt. Seine
  1984.     FΣhigkeiten umfassen auch das dynamische Generieren von Bildern,
  1985.     PDF Dateien und Flash Animationen (mittels libswf und Ming). Sie
  1986.     k÷nnen auch leicht jede Art von Text, wie XHTML oder irgendeine
  1987.     andere XML Datei ausgeben. PHP kann diese Dateien automatisch
  1988.     generieren und im Dateisystem speichern, anstatt diese nur
  1989.     auszugeben bzw. auszudrucken, und formt auch serverseitigen
  1990.     Zwischenspeicher Ihrer dynamischen Inhalte.
  1991.    </P
  1992. ><P
  1993. >     Vielleicht die gr÷▀te und bemerkenswerteste StΣrke von PHP ist
  1994.     seine Unterstⁿtzung fⁿr eine breite Masse von Datenbanken. Eine
  1995.     datenbankgestⁿtzte Website zu erstellen ist unglaublich
  1996.     einfach. Die folgenden Datenbanken werden zur Zeit unterstⁿtzt:
  1997.     <A
  1998. NAME="AEN181"
  1999. ></A
  2000. ><BLOCKQUOTE
  2001. CLASS="BLOCKQUOTE"
  2002. ><P
  2003. ></P
  2004. ><TABLE
  2005. BORDER="0"
  2006. ><TBODY
  2007. ><TR
  2008. ><TD
  2009. >Adabas D</TD
  2010. ><TD
  2011. >Ingres</TD
  2012. ><TD
  2013. >Oracle (OCI7 und OCI8)</TD
  2014. ></TR
  2015. ><TR
  2016. ><TD
  2017. >dBase</TD
  2018. ><TD
  2019. >InterBase</TD
  2020. ><TD
  2021. >Ovrimos</TD
  2022. ></TR
  2023. ><TR
  2024. ><TD
  2025. >Empress</TD
  2026. ><TD
  2027. >FrontBase</TD
  2028. ><TD
  2029. >PostgreSQL</TD
  2030. ></TR
  2031. ><TR
  2032. ><TD
  2033. >FilePro (nur Lesezugriff)</TD
  2034. ><TD
  2035. >mSQL</TD
  2036. ><TD
  2037. >Solid</TD
  2038. ></TR
  2039. ><TR
  2040. ><TD
  2041. >Hyperwave</TD
  2042. ><TD
  2043. >Direct MS-SQL</TD
  2044. ><TD
  2045. >Sybase</TD
  2046. ></TR
  2047. ><TR
  2048. ><TD
  2049. >IBM DB2</TD
  2050. ><TD
  2051. >MySQL</TD
  2052. ><TD
  2053. >Velocis</TD
  2054. ></TR
  2055. ><TR
  2056. ><TD
  2057. >Informix</TD
  2058. ><TD
  2059. >ODBC</TD
  2060. ><TD
  2061. >Unix dbm</TD
  2062. ></TR
  2063. ></TBODY
  2064. ></TABLE
  2065. ><P
  2066. ></P
  2067. ></BLOCKQUOTE
  2068. >
  2069.     Wir haben auch die Erweiterung DBX zur Datenbankabstraktion, welche
  2070.     Ihnen die transparente Verwendung irgendeiner von dieser Erweiterung
  2071.     unterstⁿtzten Datenbank erlaubt. Weiters unterstⁿtzt PHP ODBC, den 
  2072.     Open Database Connection Standard, mit welchem Sie sich zu jeder
  2073.     anderen diesen Weltstandard unterstⁿtzenden Datenbank verbinden
  2074.     k÷nnen.
  2075.    </P
  2076. ><P
  2077. >     PHP unterstⁿtzt auch die Kommunikation mit anderen Services, welche
  2078.     Protokolle wie LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (auf Windows)
  2079.     und unzΣhlige andere unterstⁿtzen. Sie k÷nnen auch einfache Netzwerk
  2080.     Sockets ÷ffnen, und unter Verwendung irgendeines Protokolls
  2081.     kommunizieren. PHP unterstⁿtzt auch WDDX (Web Distributed Data
  2082.     Exchange) zum Austausch komplexer Daten zwischen Programmiersprachen.
  2083.     Da wir gerade vom Zusammenwirken sprechen: PHP bietet auch
  2084.     Unterstⁿtzung zur Instantiierung von Java Objekten, und deren
  2085.     transparente Verwendung als PHP Objekte. Sie k÷nnen auch unsere
  2086.     CORBA Erweiterung verwenden, um auf entfernte Objekte zuzugreifen.
  2087.    </P
  2088. ><P
  2089. >     PHP verfⁿgt ⁿber Σu▀erst hilfreiche Textverarbeitungsfunktionen, von
  2090.     den regulΣren Ausdrⁿcken (POSIX erweitert oder Perl) bis zum Parsen
  2091.     von XML Dokumenten. Fⁿr den Zugriff und das Parsen von XML Dokumenten
  2092.     unterstⁿtzen wir die Standards SAX und DOM. Sie k÷nnen unsere XSLT
  2093.     Erweiterung verwenden, um XML Dokumente zu transformieren.
  2094.    </P
  2095. ><P
  2096. >     Wenn Sie PHP im Bereich des E-Commerce nutzen, werden Sie Funktionen
  2097.     fⁿr Cybercash Payment, CyberMUT, VeriSign Payflow Pro und CCVS fⁿr 
  2098.     Ihre Onlineprogramme zur Zahlungsabwicklung zu schΣtzen lernen.
  2099.    </P
  2100. ><P
  2101. >     Wir haben viele andere interessante Erweiterungen, wie mnoGoSearch
  2102.     fⁿr Suchmaschinen, die IRC Gateway Funktionen, viele
  2103.     Komprimierungswerkzeuge (gzip, bz2), Kalenderumrechnung,
  2104.     ▄bersetzung...
  2105.    </P
  2106. ><P
  2107. >     Wie Sie sehen k÷nnen, reicht diese Seite nicht aus, um alle M÷glichkeiten
  2108.     und Vorteile von PHP aufzulisten. Lesen Sie im Abschnitt <A
  2109. HREF="#installation"
  2110. >Installation</A
  2111. > weiter, und konsultieren Sie
  2112.     auch die <A
  2113. HREF="#funcref"
  2114. >Funktionsreferenz</A
  2115. > fⁿr weitere
  2116.     ErlΣuterungen der einzelnen hier erwΣhnten Erweiterungen.
  2117.    </P
  2118. ></DIV
  2119. ></DIV
  2120. ><DIV
  2121. CLASS="chapter"
  2122. ><HR><H1
  2123. ><A
  2124. NAME="tutorial"
  2125. >Kapitel 2. Kleines Tutorial</A
  2126. ></H1
  2127. ><P
  2128. >    Auf diesen Seiten m÷chten wir Ihnen die Grundlagen von PHP in einem
  2129.    kleinen Tutorial vorstellen. Dieser Text behandelt nur das Erstellen
  2130.    von dynamischen Web-Seiten, obwohl PHP natⁿrlich nicht nur dafⁿr
  2131.    geeignet ist. Weitere Informationen finden Sie im Abschnitt
  2132.    <A
  2133. HREF="#intro-whatcando"
  2134. >Was kann PHP?</A
  2135. >.
  2136.   </P
  2137. ><P
  2138. >    Mit PHP erweiterte Web-Seiten werden wie normale HTML-Seiten
  2139.    behandelt. Sie k÷nnen sie genauso wie normale HTML-Seiten erstellen
  2140.    und bearbeiten.
  2141.   </P
  2142. ><DIV
  2143. CLASS="sect1"
  2144. ><HR><H2
  2145. CLASS="sect1"
  2146. ><A
  2147. NAME="tutorial.requirements"
  2148. >Was brauche ich?</A
  2149. ></H2
  2150. ><P
  2151. >     In diesem Tutorial gehen wir davon aus, dass auf Ihrem Server
  2152.     die PHP-Unterstⁿtzung aktiviert ist und dass die Dateiendung
  2153.     <TT
  2154. CLASS="filename"
  2155. >.php</TT
  2156. > PHP zugeordnet ist. Auf den meisten
  2157.     Servern ist dies die Standardeinstellung fⁿr PHP-Dateien, aber
  2158.     fragen Sie bitte Ihren Server-Administrator, um sicherzugehen.
  2159.     Wenn Ihr Server PHP unterstⁿtzt, mⁿssen Sie nichts machen.
  2160.     Erstellen Sie einfach Ihre <TT
  2161. CLASS="filename"
  2162. >.php</TT
  2163. >-Dateien
  2164.     und legen Sie diese in Ihr Web-Verzeichnis - der Server wird
  2165.     sie dann fⁿr Sie parsen. Sie mⁿssen nichts kompilieren und
  2166.     auch keine Zusatz-Tools installieren. Stellen Sie sich diese
  2167.     PHP-erweiterten Dateien wie normale HTML-Seiten mit einer
  2168.     ganzen Familie von "magischen" Tags, die Sie verschiedenste
  2169.     Dinge tun lassen, vor.
  2170.    </P
  2171. ><P
  2172. >     Angenommen, Sie m÷chten Bandbreite sparen und lokal entwickeln.
  2173.     In diesem Fall mⁿssen Sie einen Webserver wie z.B.
  2174.     <A
  2175. HREF="#install.apache"
  2176. >Apache</A
  2177. > und natⁿrlich
  2178.     <A
  2179. HREF="http://www.php.net/downloads.php"
  2180. TARGET="_top"
  2181. >PHP</A
  2182. > installieren.
  2183.     Sehr empfehlenswert ist auch die Installation einer Datenbank
  2184.     wie z.B. <A
  2185. HREF="http://dev.mysql.com/doc/"
  2186. TARGET="_top"
  2187. >MySQL</A
  2188. >. Sie
  2189.     k÷nnen diese Programm entweder eins nach dem anderen selbst
  2190.     installieren oder nach einem <A
  2191. HREF="http://www.hotscripts.com/PHP/Software_and_Servers/Installation_Kits/"
  2192. TARGET="_top"
  2193. >vorkonfigurierten Paket</A
  2194. > suchen,
  2195.     dass automatisch alle ben÷tigen Programme mit einigen wenigen
  2196.     Mausklicks installieren kann.
  2197.     Es ist sehr einfach, einen Webserver mit PHP-Support unter
  2198.     jedem Betriebssystem, wie Linux oder Windows, zu installieren.
  2199.     Unter Linux ist <A
  2200. HREF="http://www.rpmfind.net/"
  2201. TARGET="_top"
  2202. >rpmfind</A
  2203. >
  2204.     nⁿtzlich, um RPMs zu finden.
  2205.    </P
  2206. ></DIV
  2207. ><DIV
  2208. CLASS="sect1"
  2209. ><HR><H2
  2210. CLASS="sect1"
  2211. ><A
  2212. NAME="tutorial.firstpage"
  2213. >Ihre erste PHP-erweiterte Seite</A
  2214. ></H2
  2215. ><P
  2216. >     Erstellen Sie eine Datei mit dem Namen <TT
  2217. CLASS="filename"
  2218. >hallo.php</TT
  2219. >
  2220.     und speichern Sie sie im Root-Verzeichnis Ihres Webservers
  2221.     (<VAR
  2222. CLASS="varname"
  2223. >DOCUMENT_ROOT</VAR
  2224. >) mit dem folgenden Inhalt:
  2225.    </P
  2226. ><P
  2227. >     <TABLE
  2228. WIDTH="100%"
  2229. BORDER="0"
  2230. CELLPADDING="0"
  2231. CELLSPACING="0"
  2232. CLASS="EXAMPLE"
  2233. ><TR
  2234. ><TD
  2235. ><DIV
  2236. CLASS="example"
  2237. ><A
  2238. NAME="AEN233"
  2239. ></A
  2240. ><P
  2241. ><B
  2242. >Beispiel 2-1. Unser erstes PHP-Skript: <TT
  2243. CLASS="filename"
  2244. >hallo.php</TT
  2245. ></B
  2246. ></P
  2247. ><TABLE
  2248. BORDER="0"
  2249. BGCOLOR="#E0E0E0"
  2250. CELLPADDING="5"
  2251. ><TR
  2252. ><TD
  2253. ><PRE
  2254. CLASS="php"
  2255. ><html>
  2256.  <head>
  2257.   <title>PHP-Test</title>
  2258.  </head>
  2259.  <body>
  2260.  <?php echo "<p>Hallo Welt</p>"; ?>
  2261.  </body>
  2262. </html></PRE
  2263. ></TD
  2264. ></TR
  2265. ></TABLE
  2266. ><P
  2267. > 
  2268.       Benutzen Sie Ihren Browser, um die Datei ⁿber den Webserver-URL
  2269.       aufzurufen. Der URL muss mit "/halle.php" enden. Wenn Sie lokal
  2270.       entwickeln, sieht der URL z.B. so aus:
  2271.       <VAR
  2272. CLASS="literal"
  2273. >http://localhost/hallo.php</VAR
  2274. > oder
  2275.       <VAR
  2276. CLASS="literal"
  2277. >http://127.0.0.1/hallo.php</VAR
  2278. > - andere Adressen
  2279.       sind aber, abhΣngig vom Webserver, auch m÷glich.
  2280.       Sie k÷nnen sich auch die Direktiven
  2281.       <VAR
  2282. CLASS="varname"
  2283. >DocumentRoot</VAR
  2284. > und
  2285.       <VAR
  2286. CLASS="varname"
  2287. >ServerName</VAR
  2288. > in der Konfigurationsdatei Ihres
  2289.       Webservers fⁿr weitere Informationen anschauen (bei Apache
  2290.       lautet der Name dieser Datei <TT
  2291. CLASS="filename"
  2292. >httpd.conf</TT
  2293. >).
  2294.       Wenn Sie alles korrekt installiert haben, wird die Datei von
  2295.       PHP geparst und Sie werden die folgende Ausgabe in Ihrem
  2296.       Browser sehen:
  2297.      </P
  2298. ><P
  2299. >       <TABLE
  2300. BORDER="0"
  2301. BGCOLOR="#E0E0E0"
  2302. CELLPADDING="5"
  2303. ><TR
  2304. ><TD
  2305. ><PRE
  2306. CLASS="html"
  2307. ><html>
  2308.  <head>
  2309.   <title>PHP-Test</title>
  2310.  </head>
  2311.  <body>
  2312.  <p>Hallo Welt</p>
  2313.  </body>
  2314. </html></PRE
  2315. ></TD
  2316. ></TR
  2317. ></TABLE
  2318. >
  2319.      </P
  2320. ></DIV
  2321. ></TD
  2322. ></TR
  2323. ></TABLE
  2324. >
  2325.    </P
  2326. ><P
  2327. >     Beachten Sie, dass dies nicht mit einem CGI-Skript vergleichbar ist.
  2328.     Die Datei muss nicht ausfⁿhrbar oder sonst irgendwie speziell sein.
  2329.     Stellen Sie sich die Datei wie eine normale HTML-Datei vor, die eine
  2330.     spezielle Menge von Tags zur Verfⁿgung stellt, mit denen Sie viele
  2331.     interessante Dinge machen k÷nnen.
  2332.    </P
  2333. ><P
  2334. >     Das Beispiel ist extrem einfach und natⁿrlich brauchen Sie PHP nicht,
  2335.     um eine Seite wie diese zu erstellen. Denn es macht nicht mehr, als
  2336.     <VAR
  2337. CLASS="literal"
  2338. >Hallo Welt</VAR
  2339. > mit der <A
  2340. HREF="#function.echo"
  2341. ><B
  2342. CLASS="function"
  2343. >echo()</B
  2344. ></A
  2345. >-Anweisung
  2346.     von PHP auszugeben.
  2347.    </P
  2348. ><P
  2349. >     Wenn Sie dieses Beispiel ausprobiert haben und Sie aber keine Ausgabe
  2350.     erhalten haben oder zum Download aufgefordert worden sind oder die
  2351.     komplette Datei als Text erhalten haben, dann ist es sehr wahrscheinlich,
  2352.     dass auf Ihrem Server PHP nicht aktiviert ist. Fragen Sie in diesem
  2353.     Fall Ihren Administrator und weisen Sie ihn auf das
  2354.     <A
  2355. HREF="#installation"
  2356. >Installations-Kapitel</A
  2357. > hin.
  2358.     Wenn Sie lokal entwickeln, lesen Sie bitte das Installations-Kapitel,
  2359.     um festzustellen, ob alles richtig konfiguriert wurde.
  2360.     Sollten Ihre Probleme nach Lesen dieses Kapitels immer noch bestehen,
  2361.     z÷gern Sie nicht und nutzen Sie eines der vielen <A
  2362. HREF="http://www.php.net/support.php"
  2363. TARGET="_top"
  2364. >Support</A
  2365. >-Angebote.
  2366.    </P
  2367. ><P
  2368. >     Der wichtigste Punkt im Beispiel ist, Ihnen das spezielle PHP Tag-Format
  2369.     zu zeigen. Im Beispiel wurde <VAR
  2370. CLASS="literal"
  2371. ><?php</VAR
  2372. > verwendet,
  2373.     um den Beginn eines PHP-Tags zu kennzeichnen. Anschlie▀end folgte
  2374.     die PHP-Anweisung. Mit dem schlie▀enden Tag, <VAR
  2375. CLASS="literal"
  2376. >?></VAR
  2377. >,
  2378.     wurde der PHP-Modus wieder verlassen. Sie k÷nnen an jeder Stelle und so
  2379.     oft Sie wollen, in den PHP-Modus wechseln und ihn wieder verlassen. Fⁿr
  2380.     weitere Details lesen Sie bitte den Abschnitt zu den <A
  2381. HREF="#language.basic-syntax"
  2382. >Grundlagen der Syntax</A
  2383. > von PHP.
  2384.    </P
  2385. ><DIV
  2386. CLASS="note"
  2387. ><BLOCKQUOTE
  2388. CLASS="note"
  2389. ><P
  2390. ><B
  2391. >Anmerkung zu Text-Editoren: </B
  2392. >
  2393.      Es gibt eine ganze Reihe von Text-Editoren und Integrated Development
  2394.      Environments (IDEs), mit denen Sie Ihre PHP-Dateien erstellen, bearbeiten
  2395.      und managen k÷nnen. Eine Liste solcher Programme finden Sie hier:
  2396.      <A
  2397. HREF="http://phpeditors.linuxbackup.co.uk/"
  2398. TARGET="_top"
  2399. >PHP Editor's List</A
  2400. >.
  2401.      Wenn Sie einen Editor vorschlagen m÷chten, besuchen Sie bitte die genannte
  2402.      Seite und bitten Sie den Betreiber der Seite, dass er den Editor
  2403.      der Liste hinzufⁿgt.
  2404.      Wir empfehlen Ihnen einen Editor zu benutzen, der Syntax-Highlighting
  2405.      bietet.
  2406.     </P
  2407. ></BLOCKQUOTE
  2408. ></DIV
  2409. ><DIV
  2410. CLASS="note"
  2411. ><BLOCKQUOTE
  2412. CLASS="note"
  2413. ><P
  2414. ><B
  2415. >Anmerkung zu Textverarbeitungen: </B
  2416. >
  2417.      Textverarbeitungen wie StarOffice Writer, Microsoft Word und Abiword sind
  2418.      keine gute Wahl, um PHP-Dateien zu bearbeiten.
  2419.      Wenn Sie eines dieser Programme fⁿr dieses Test-Skript nutzen m÷chten,
  2420.      dann mⁿssen Sie sicherstellen, dass die Datei als "Nur Text"-Datei
  2421.      gespeichert wird, da PHP sonst das Skript nicht lesen und nicht
  2422.      ausfⁿhren kann.
  2423.     </P
  2424. ></BLOCKQUOTE
  2425. ></DIV
  2426. ><DIV
  2427. CLASS="note"
  2428. ><BLOCKQUOTE
  2429. CLASS="note"
  2430. ><P
  2431. ><B
  2432. >Anmerkung zu Notepad, dem Windows-Standard-Editor: </B
  2433. >    
  2434.      Wenn Sie Ihre PHP-Skripte mit Notepad schreiben, mⁿssen Sie sicherstellen,
  2435.      dass Ihre Dateien mit der Endung <TT
  2436. CLASS="filename"
  2437. >.php</TT
  2438. > gespeichert
  2439.      werden. (Notepad fⁿgt die Endung <TT
  2440. CLASS="filename"
  2441. >.txt</TT
  2442. > automatisch
  2443.      an den Dateinamen an, wenn Sie das nicht mit einem der folgenden Schritte
  2444.      verhindern.)
  2445.      Wenn Sie die Datei speichern und einen Namen fⁿr die Datei eingeben sollen,
  2446.      dann setzen Sie den Dateinamen in Anfⁿhrungszeichen (z.B.
  2447.      "<TT
  2448. CLASS="filename"
  2449. >hallo.php</TT
  2450. >").
  2451.      Alternativ k÷nnen Sie auch im "Datei speichern"-Fenster in der Drop-Down-Liste
  2452.      "Dateityp" die Einstellung auf "Alle Dateien" Σndern. Sie k÷nnen dann den
  2453.      Dateinamen ohne Anfⁿhrungszeichen eingeben.
  2454.     </P
  2455. ></BLOCKQUOTE
  2456. ></DIV
  2457. ><P
  2458. > 
  2459.     Nachdem Sie jetzt erfolgreich ein einfaches, funktionierendes PHP-Skript
  2460.     geschrieben haben, wird es Zeit, das berⁿhmteste PHP-Skript zu schreiben.
  2461.     Rufen Sie die Funktion <A
  2462. HREF="#function.phpinfo"
  2463. ><B
  2464. CLASS="function"
  2465. >phpinfo()</B
  2466. ></A
  2467. > auf und Sie bekommen
  2468.     viele nⁿtzliche Informationen ⁿber Ihr System und Ihre Installation wie
  2469.     z.B. die verfⁿgbaren <A
  2470. HREF="#language.variables.predefined"
  2471. >vordefinierten Variablen</A
  2472. >,
  2473.     die geladenen PHP-Module und die <A
  2474. HREF="#configuration"
  2475. >Konfigurations</A
  2476. >-Einstellungen. Nehmen Sie
  2477.     sich etwas Zeit und schauen Sie sich diese wichtigen Informationen an.
  2478.    </P
  2479. ></DIV
  2480. ><DIV
  2481. CLASS="sect1"
  2482. ><HR><H2
  2483. CLASS="sect1"
  2484. ><A
  2485. NAME="tutorial.useful"
  2486. >Nⁿtzliches</A
  2487. ></H2
  2488. ><P
  2489. >     Kommen wir nun zu einem etwas nⁿtzlicheren Beispiel. Wir wollen prⁿfen,
  2490.     welchen Browser die Person, die die Seite besucht, benutzt.
  2491.     Um das zu tun, prⁿfen wir den "user agent"-String, den der Browser
  2492.     als Teil seiner HTTP-Anforderung sendet. Diese Information ist in einer
  2493.     <A
  2494. HREF="#language.variables"
  2495. >Variablen</A
  2496. > abgelegt. In PHP
  2497.     beginnen Variablen immer mit einem Dollar-Zeichen. Die Variable, die
  2498.     uns jetzt interessiert, ist <VAR
  2499. CLASS="varname"
  2500. >$_SERVER["HTTP_USER_AGENT"]</VAR
  2501. >.
  2502.    </P
  2503. ><DIV
  2504. CLASS="note"
  2505. ><BLOCKQUOTE
  2506. CLASS="note"
  2507. ><P
  2508. ><B
  2509. >PHP Autoglobals-Anmerkung: </B
  2510. >
  2511.      <A
  2512. HREF="#reserved.variables.server"
  2513. >$_SERVER</A
  2514. > ist eine
  2515.      speziell reservierte PHP-Variable, die alle Informationen ⁿber den
  2516.      Webserver enthΣlt. Diese Variable wird auch als auto- oder superglobal
  2517.      bezeichnet. Mehr Informationen darⁿber Sie auf der Manual-Seite ⁿber
  2518.      <A
  2519. HREF="#language.variables.superglobals"
  2520. >Autoglobals</A
  2521. >.
  2522.      Diese speziellen Variablen wurden in PHP 
  2523.      <A
  2524. HREF="http://www.php.net/release_4_1_0.php"
  2525. TARGET="_top"
  2526. >4.1.0</A
  2527. > eingefⁿhrt.
  2528.      Vorher wurden stattdessen die Σlteren <VAR
  2529. CLASS="varname"
  2530. >$HTTP_*_VARS</VAR
  2531. >-Arrays
  2532.      benutzt, also z.B. <VAR
  2533. CLASS="varname"
  2534. >$HTTP_SERVER_VARS</VAR
  2535. >. Auch wenn diese
  2536.      Variablen nicht mehr genutzt werden sollen - sie existieren weiterhin.
  2537.      (Beachten Sie auch die Seite <A
  2538. HREF="#tutorial.oldcode"
  2539. >Alten Code
  2540.      mit neuen PHP-Versionen benutzen</A
  2541. >.)
  2542.     </P
  2543. ></BLOCKQUOTE
  2544. ></DIV
  2545. ><P
  2546. >     Um die Variable auszugeben, schreiben wir einfach:
  2547.    </P
  2548. ><P
  2549. >     <TABLE
  2550. WIDTH="100%"
  2551. BORDER="0"
  2552. CELLPADDING="0"
  2553. CELLSPACING="0"
  2554. CLASS="EXAMPLE"
  2555. ><TR
  2556. ><TD
  2557. ><DIV
  2558. CLASS="example"
  2559. ><A
  2560. NAME="AEN289"
  2561. ></A
  2562. ><P
  2563. ><B
  2564. >Beispiel 2-2. Variable ausgeben (Array-Element)</B
  2565. ></P
  2566. ><TABLE
  2567. BORDER="0"
  2568. BGCOLOR="#E0E0E0"
  2569. CELLPADDING="5"
  2570. ><TR
  2571. ><TD
  2572. ><PRE
  2573. CLASS="php"
  2574. ><?php echo $_SERVER["HTTP_USER_AGENT"]; ?></PRE
  2575. ></TD
  2576. ></TR
  2577. ></TABLE
  2578. ><P
  2579. >      Die Ausgabe dieses Beispiel k÷nnte so aussehen:
  2580.      <TABLE
  2581. BORDER="0"
  2582. BGCOLOR="#E0E0E0"
  2583. CELLPADDING="5"
  2584. ><TR
  2585. ><TD
  2586. ><PRE
  2587. CLASS="html"
  2588. >Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)</PRE
  2589. ></TD
  2590. ></TR
  2591. ></TABLE
  2592. >
  2593.     </P
  2594. ></DIV
  2595. ></TD
  2596. ></TR
  2597. ></TABLE
  2598. >
  2599.    </P
  2600. ><P
  2601. >     Es gibt viele <A
  2602. HREF="#language.types"
  2603. >Typen</A
  2604. > von
  2605.     Variablen. Im obigen Beispiel haben wir ein <A
  2606. HREF="#language.types.array"
  2607. >Array</A
  2608. >-Element ausgegeben.
  2609.     Arrays k÷nnen sehr nⁿtzlich sein.
  2610.    </P
  2611. ><P
  2612. >     <VAR
  2613. CLASS="varname"
  2614. >$_SERVER</VAR
  2615. > ist nur eine von vielen Variablen, die
  2616.     Ihnen automatisch von PHP zur Verfⁿgung gestellt werden. Eine Liste
  2617.     finden Sie auf der Seite <A
  2618. HREF="#reserved.variables"
  2619. >Reservierte
  2620.     Variablen</A
  2621. > im Manual. Eine vollstΣndige Liste k÷nnen Sie auch
  2622.     bekommen, wenn Sie eine Datei wie die folgende erstellen:
  2623.    </P
  2624. ><P
  2625. >     <TABLE
  2626. WIDTH="100%"
  2627. BORDER="0"
  2628. CELLPADDING="0"
  2629. CELLSPACING="0"
  2630. CLASS="EXAMPLE"
  2631. ><TR
  2632. ><TD
  2633. ><DIV
  2634. CLASS="example"
  2635. ><A
  2636. NAME="AEN301"
  2637. ></A
  2638. ><P
  2639. ><B
  2640. >Beispiel 2-3. Alle vordefinierten Variablen mit <A
  2641. HREF="#function.phpinfo"
  2642. ><B
  2643. CLASS="function"
  2644. >phpinfo()</B
  2645. ></A
  2646. > ausgeben</B
  2647. ></P
  2648. ><TABLE
  2649. BORDER="0"
  2650. BGCOLOR="#E0E0E0"
  2651. CELLPADDING="5"
  2652. ><TR
  2653. ><TD
  2654. ><PRE
  2655. CLASS="php"
  2656. ><?php phpinfo(); ?></PRE
  2657. ></TD
  2658. ></TR
  2659. ></TABLE
  2660. ></DIV
  2661. ></TD
  2662. ></TR
  2663. ></TABLE
  2664. >
  2665.    </P
  2666. ><P
  2667. >     Wenn Sie diese Datei in Ihrem Browser ÷ffnen, sehen Sie eine Seite
  2668.     mit vielen Informationen ⁿber PHP zusammen mit einer Liste aller
  2669.     fⁿr Sie verfⁿgbaren Variablen.
  2670.    </P
  2671. ><P
  2672. >     Sie k÷nnen mehrere PHP-Anweisungen innerhalb eines PHP-Tags
  2673.     platzieren und so kleine Code-Bl÷cke schreiben, die mehr
  2674.     als nur eine Ausgabe mit <A
  2675. HREF="#function.echo"
  2676. ><B
  2677. CLASS="function"
  2678. >echo()</B
  2679. ></A
  2680. > enthalten.
  2681.     Wenn wir zum Beispiel prⁿfen m÷chten, ob es sich beim Browser
  2682.     des Besuchers um den Internet Explorer handelt, k÷nnen wir
  2683.     folgenden Code benutzen:
  2684.    </P
  2685. ><P
  2686. >     <TABLE
  2687. WIDTH="100%"
  2688. BORDER="0"
  2689. CELLPADDING="0"
  2690. CELLSPACING="0"
  2691. CLASS="EXAMPLE"
  2692. ><TR
  2693. ><TD
  2694. ><DIV
  2695. CLASS="example"
  2696. ><A
  2697. NAME="AEN309"
  2698. ></A
  2699. ><P
  2700. ><B
  2701. >Beispiel 2-4. Beispiel, das <A
  2702. HREF="#control-structures"
  2703. >Kontrollstrukturen</A
  2704. > und
  2705.      <A
  2706. HREF="#functions"
  2707. >Funktionen</A
  2708. > benutzt</B
  2709. ></P
  2710. ><TABLE
  2711. BORDER="0"
  2712. BGCOLOR="#E0E0E0"
  2713. CELLPADDING="5"
  2714. ><TR
  2715. ><TD
  2716. ><PRE
  2717. CLASS="php"
  2718. ><?php
  2719. if (strstr($_SERVER["HTTP_USER_AGENT"], "MSIE")) {
  2720.   echo "Sie benutzen Internet Explorer<br />";
  2721. }
  2722. ?></PRE
  2723. ></TD
  2724. ></TR
  2725. ></TABLE
  2726. ><P
  2727. >       Die Ausgabe dieses Skripte k÷nnte so aussehen:
  2728.       <TABLE
  2729. BORDER="0"
  2730. BGCOLOR="#E0E0E0"
  2731. CELLPADDING="5"
  2732. ><TR
  2733. ><TD
  2734. ><PRE
  2735. CLASS="html"
  2736. >Sie benutzen Internet Explorer<br /></PRE
  2737. ></TD
  2738. ></TR
  2739. ></TABLE
  2740. >
  2741.      </P
  2742. ></DIV
  2743. ></TD
  2744. ></TR
  2745. ></TABLE
  2746. >
  2747.    </P
  2748. ><P
  2749. >     Hier haben wir Ihnen eine ganze Reihe von neuen Konzepten vorgestellt.
  2750.     Wir haben hier zuerst eine <A
  2751. HREF="#control-structures.if"
  2752. >if</A
  2753. >-Anweisung.
  2754.     Wenn Sie mit der Grundlagen-Syntax von der Programmiersprache C
  2755.     vertraut sind, sollte Ihnen dies logisch erscheinen. Wenn Sie
  2756.     C oder eine andere Sprache, die die obige Syntax benutzt, nicht
  2757.     gut genug kennen, dann sollten Sie sich ein Buch mit einer
  2758.     PHP-Einfⁿhrung besorgen und die ersten Kapitel lesen. Sie
  2759.     k÷nnen natⁿrlich auch in die <A
  2760. HREF="#langref"
  2761. >Sprachreferenz</A
  2762. > des Manuals schauen.
  2763.     Eine Liste von PHP-Bⁿchern finden Sie unter <A
  2764. HREF="http://www.php.net/books.php"
  2765. TARGET="_top"
  2766. >http://www.php.net/books.php</A
  2767. >.
  2768.    </P
  2769. ><P
  2770. >     Das zweite hier vorgestellte Konzept ist der Aufruf der Funktion
  2771.     <A
  2772. HREF="#function.strstr"
  2773. ><B
  2774. CLASS="function"
  2775. >strstr()</B
  2776. ></A
  2777. >. <VAR
  2778. CLASS="literal"
  2779. >strstr</VAR
  2780. > ist eine
  2781.     in PHP eingebaute Funktion, die nach einem String in einem anderen
  2782.     String sucht. In diesem Fall suchen wir nach <VAR
  2783. CLASS="literal"
  2784. >"MSIE"</VAR
  2785. >
  2786.     in <VAR
  2787. CLASS="varname"
  2788. >$_SERVER["HTTP_USER_AGENT"]</VAR
  2789. >. Wenn der String
  2790.     gefunden wird, gibt die Funktion <TT
  2791. CLASS="constant"
  2792. ><B
  2793. >TRUE</B
  2794. ></TT
  2795. > zurⁿck, wird er nicht gefunden,
  2796.     dann wird <TT
  2797. CLASS="constant"
  2798. ><B
  2799. >FALSE</B
  2800. ></TT
  2801. > zurⁿckgegeben. Wenn <TT
  2802. CLASS="constant"
  2803. ><B
  2804. >TRUE</B
  2805. ></TT
  2806. > zurⁿckgeben wird,
  2807.     wird die <A
  2808. HREF="#control-structures.if"
  2809. >if</A
  2810. >-Anweisung
  2811.     zu <TT
  2812. CLASS="constant"
  2813. ><B
  2814. >TRUE</B
  2815. ></TT
  2816. > ausgewertet und der Code innerhalb der geschweiften Klammern
  2817.     wird ausgefⁿhrt. Wenn aber <TT
  2818. CLASS="constant"
  2819. ><B
  2820. >FALSE</B
  2821. ></TT
  2822. > zurⁿckgegeben wird, wird der
  2823.     Code innerhalb der Klammern nicht ausgefⁿhrt. Probieren Sie weitere
  2824.     Σhnliche Beispiele mit <A
  2825. HREF="#control-structures.if"
  2826. >if</A
  2827. >, 
  2828.     <A
  2829. HREF="#control-structures.else"
  2830. >else</A
  2831. > und anderen
  2832.     Funktionen wie <A
  2833. HREF="#function.strtoupper"
  2834. ><B
  2835. CLASS="function"
  2836. >strtoupper()</B
  2837. ></A
  2838. > oder 
  2839.     <A
  2840. HREF="#function.strlen"
  2841. ><B
  2842. CLASS="function"
  2843. >strlen()</B
  2844. ></A
  2845. >. Jede dieser Manual-Seiten enthΣlt
  2846.     weitere Beispiele.
  2847.    </P
  2848. ><P
  2849. >     Wir k÷nnen jetzt einen Schritt weitergehen und sehen, wie Sie innerhalb
  2850.     eines PHP-Blocks den PHP-Modus verlassen und wieder in ihn hinein
  2851.     gelangen k÷nnen:
  2852.    </P
  2853. ><P
  2854. >     <TABLE
  2855. WIDTH="100%"
  2856. BORDER="0"
  2857. CELLPADDING="0"
  2858. CELLSPACING="0"
  2859. CLASS="EXAMPLE"
  2860. ><TR
  2861. ><TD
  2862. ><DIV
  2863. CLASS="example"
  2864. ><A
  2865. NAME="AEN337"
  2866. ></A
  2867. ><P
  2868. ><B
  2869. >Beispiel 2-5. HTML- und PHP-Modus vermischt</B
  2870. ></P
  2871. ><TABLE
  2872. BORDER="0"
  2873. BGCOLOR="#E0E0E0"
  2874. CELLPADDING="5"
  2875. ><TR
  2876. ><TD
  2877. ><PRE
  2878. CLASS="php"
  2879. ><?php
  2880. if (strstr($_SERVER["HTTP_USER_AGENT"], "MSIE")) {
  2881. ?>
  2882. <h3>strstr muss true zurⁿckgegeben haben</h3>
  2883. <center><b>Sie benutzen Internet Explorer</b></center>
  2884. <?php
  2885. } else {
  2886. ?>
  2887. <h3>strstr muss false zurⁿckgegeben haben</h3>
  2888. <center><b>Sie benutzen nicht Internet Explorer</b></center>
  2889. <?php
  2890. }
  2891. ?></PRE
  2892. ></TD
  2893. ></TR
  2894. ></TABLE
  2895. ><P
  2896. >       Die Ausgabe dieses Skripts k÷nnte so aussehen:
  2897.       <TABLE
  2898. BORDER="0"
  2899. BGCOLOR="#E0E0E0"
  2900. CELLPADDING="5"
  2901. ><TR
  2902. ><TD
  2903. ><PRE
  2904. CLASS="html"
  2905. ><h3>strstr muss true zurⁿckgegeben haben</h3>
  2906. <center><b>Sie benutzen Internet Explorer</b></center></PRE
  2907. ></TD
  2908. ></TR
  2909. ></TABLE
  2910. >
  2911.      </P
  2912. ></DIV
  2913. ></TD
  2914. ></TR
  2915. ></TABLE
  2916. >
  2917.    </P
  2918. ><P
  2919. >     Anstatt die PHP <VAR
  2920. CLASS="literal"
  2921. >echo</VAR
  2922. >-Anweisung fⁿr die Ausgabe zu benutzen,
  2923.     haben wir den PHP-Modus verlassen und normales HTML verwendet. Der wichtige
  2924.     Punkt hierbei ist, dass der logische Ablauf des Skripts dadurch nicht
  2925.     gest÷rt wird. Nur einer der beiden HTML-Bl÷cke wird ausgegeben - abhΣngig
  2926.     davon, ob <A
  2927. HREF="#function.strstr"
  2928. ><B
  2929. CLASS="function"
  2930. >strstr()</B
  2931. ></A
  2932. > <TT
  2933. CLASS="constant"
  2934. ><B
  2935. >TRUE</B
  2936. ></TT
  2937. > oder <TT
  2938. CLASS="constant"
  2939. ><B
  2940. >FALSE</B
  2941. ></TT
  2942. > zurⁿckgibt bzw.
  2943.     ob der String <VAR
  2944. CLASS="literal"
  2945. >MSIE</VAR
  2946. > gefunden wird oder nicht.
  2947.    </P
  2948. ></DIV
  2949. ><DIV
  2950. CLASS="sect1"
  2951. ><HR><H2
  2952. CLASS="sect1"
  2953. ><A
  2954. NAME="tutorial.forms"
  2955. >Formulare verarbeiten</A
  2956. ></H2
  2957. ><P
  2958. >     Eine der mΣchtigsten Funktionen von PHP ist die Art, wie HTML-Formulare
  2959.     verarbeitet werden. Sie sollten wissen, dass jedes Element eines Formulars
  2960.     automatisch in Ihren PHP-Skripts verfⁿgbar ist. Bitte lesen Sie die Seite
  2961.     <A
  2962. HREF="#language.variables.external"
  2963. >Variablen au▀erhalb von PHP</A
  2964. >
  2965.     fⁿr weitere Informationen und Beispiele ⁿber das Benutzen von Formularen
  2966.     mit PHP. Hier ist ein Beispiel-HTML-Formular:
  2967.    </P
  2968. ><P
  2969. >     <TABLE
  2970. WIDTH="100%"
  2971. BORDER="0"
  2972. CELLPADDING="0"
  2973. CELLSPACING="0"
  2974. CLASS="EXAMPLE"
  2975. ><TR
  2976. ><TD
  2977. ><DIV
  2978. CLASS="example"
  2979. ><A
  2980. NAME="AEN353"
  2981. ></A
  2982. ><P
  2983. ><B
  2984. >Beispiel 2-6. Ein einfaches HTML-Formular</B
  2985. ></P
  2986. ><TABLE
  2987. BORDER="0"
  2988. BGCOLOR="#E0E0E0"
  2989. CELLPADDING="5"
  2990. ><TR
  2991. ><TD
  2992. ><PRE
  2993. CLASS="html"
  2994. ><form action="action.php" method="POST">
  2995.  Ihr Name: <input type="text" name="name" />
  2996.  Ihr Alter: <input type="text" name="alter" />
  2997.  <input type="submit">
  2998. </form></PRE
  2999. ></TD
  3000. ></TR
  3001. ></TABLE
  3002. ></DIV
  3003. ></TD
  3004. ></TR
  3005. ></TABLE
  3006. >
  3007.    </P
  3008. ><P
  3009. >     An diesem Formular ist nichts Besonderes. Es ist ein normales
  3010.     HTML-Formular ohne irgendwelche speziellen Tags. Wenn der Benutzer
  3011.     das Formular ausfⁿllt und den Submit-Button anklickt, wird die
  3012.     Seite <TT
  3013. CLASS="filename"
  3014. >action.php</TT
  3015. > aufgerufen. Diese Datei
  3016.     k÷nnte so aussehen:
  3017.    </P
  3018. ><P
  3019. >     <TABLE
  3020. WIDTH="100%"
  3021. BORDER="0"
  3022. CELLPADDING="0"
  3023. CELLSPACING="0"
  3024. CLASS="EXAMPLE"
  3025. ><TR
  3026. ><TD
  3027. ><DIV
  3028. CLASS="example"
  3029. ><A
  3030. NAME="AEN359"
  3031. ></A
  3032. ><P
  3033. ><B
  3034. >Beispiel 2-7. Daten des Formulars ausgeben</B
  3035. ></P
  3036. ><TABLE
  3037. BORDER="0"
  3038. BGCOLOR="#E0E0E0"
  3039. CELLPADDING="5"
  3040. ><TR
  3041. ><TD
  3042. ><PRE
  3043. CLASS="php"
  3044. >Hallo <?php echo $_POST["name"]; ?>.
  3045. Sie sind <?php echo $_POST["alter"]; ?> Jahre alt.</PRE
  3046. ></TD
  3047. ></TR
  3048. ></TABLE
  3049. ><P
  3050. >       Die Ausgabe des Skripts k÷nnte dann so aussehen:
  3051.       <TABLE
  3052. BORDER="0"
  3053. BGCOLOR="#E0E0E0"
  3054. CELLPADDING="5"
  3055. ><TR
  3056. ><TD
  3057. ><PRE
  3058. CLASS="html"
  3059. >Hallo Joe.
  3060. Sie sind 22 Jahre alt.</PRE
  3061. ></TD
  3062. ></TR
  3063. ></TABLE
  3064. >
  3065.      </P
  3066. ></DIV
  3067. ></TD
  3068. ></TR
  3069. ></TABLE
  3070. >
  3071.    </P
  3072. ><P
  3073. >     Es sollte einfach zu verstehen sein, was hier passiert. Die
  3074.     Variablen <VAR
  3075. CLASS="varname"
  3076. >$_POST["name"]</VAR
  3077. > und
  3078.     <VAR
  3079. CLASS="varname"
  3080. >$_POST["alter"]</VAR
  3081. > werden fⁿr Sie automatisch
  3082.     von PHP gesetzt. Weiter oben haben wir das autoglobale Array
  3083.     <VAR
  3084. CLASS="varname"
  3085. >$_SERVER</VAR
  3086. > eingefⁿhrt, jetzt benutzen wir hier
  3087.     das - ebenfalls autoglobale - Array <A
  3088. HREF="#reserved.variables.post"
  3089. >$_POST</A
  3090. >, dass alle
  3091.     POST-Daten enthΣlt. Beachten Sie, dass die im Formular verwendete
  3092.     <SPAN
  3093. CLASS="emphasis"
  3094. ><I
  3095. CLASS="emphasis"
  3096. >Methode</I
  3097. ></SPAN
  3098. > POST ist. HΣtten wir
  3099.     <SPAN
  3100. CLASS="emphasis"
  3101. ><I
  3102. CLASS="emphasis"
  3103. >GET</I
  3104. ></SPAN
  3105. > verwendet, dann wΣren die Daten unseres
  3106.     Formulars stattdessen im autoglobalen Array <A
  3107. HREF="#reserved.variables.get"
  3108. >$_GET</A
  3109. > verfⁿgbar.
  3110.     Sie k÷nnen auch das autoglobale Array <A
  3111. HREF="#reserved.variables.request"
  3112. >$_REQUEST</A
  3113. > benutzen,
  3114.     wenn die Quelle der Daten keine Rolle spielt. Dieses Array enthΣlt
  3115.     die GET-, POST-, COOKIE- und FILE-Daten. Vgl. auch die
  3116.     <A
  3117. HREF="#function.import-request-variables"
  3118. ><B
  3119. CLASS="function"
  3120. >import_request_variables()</B
  3121. ></A
  3122. >-Funktion.
  3123.    </P
  3124. ></DIV
  3125. ><DIV
  3126. CLASS="sect1"
  3127. ><HR><H2
  3128. CLASS="sect1"
  3129. ><A
  3130. NAME="tutorial.oldcode"
  3131. >Alten Code mit neuen PHP-Versionen benutzen</A
  3132. ></H2
  3133. ><P
  3134. >     Dadurch dass PHP eine immer beliebtere Skriptsprache ist, gibt es immer
  3135.     mehr Quellen, die Ihnen Code-Listings zur Verfⁿgung zu stellen.
  3136.     Die PHP-Entwickler haben versucht, den gr÷▀ten Teil der Sprache
  3137.     abwΣrtskompatibel zu halten. Das bedeutet, dass ein Skript, das fⁿr
  3138.     eine Σltere PHP-Version geschrieben wurde, (im Idealfall) ohne
  3139.     ─nderungen auch unter einer neueren PHP-Version lΣuft. In der Praxis
  3140.     sind aber meist einige ─nderungen n÷tig.
  3141.    </P
  3142. ><P
  3143. >     Zwei der wichtigsten aktuellen ─nderungen, die alten Code betreffen, sind:
  3144.     <P
  3145. ></P
  3146. ><UL
  3147. ><LI
  3148. ><P
  3149. >        Die Missbilligung der alten <VAR
  3150. CLASS="varname"
  3151. >$HTTP_*_VARS</VAR
  3152. >-Arrays
  3153.        (die global gemacht werden mussten, wenn man sie innerhalb einer Funktion
  3154.        nutzen wollte). In PHP <A
  3155. HREF="http://www.php.net/release_4_1_0.php"
  3156. TARGET="_top"
  3157. >4.1.0</A
  3158. >
  3159.        wurden die folgenden <A
  3160. HREF="#language.variables.superglobals"
  3161. >autoglobalen
  3162.        Arrays</A
  3163. > eingefⁿhrt: <VAR
  3164. CLASS="varname"
  3165. >$_GET</VAR
  3166. >, <VAR
  3167. CLASS="varname"
  3168. >$_POST</VAR
  3169. >, 
  3170.        <VAR
  3171. CLASS="varname"
  3172. >$_COOKIE</VAR
  3173. >, <VAR
  3174. CLASS="varname"
  3175. >$_SERVER</VAR
  3176. >, 
  3177.        <VAR
  3178. CLASS="varname"
  3179. >$_ENV</VAR
  3180. >, <VAR
  3181. CLASS="varname"
  3182. >$_REQUEST</VAR
  3183. > und 
  3184.        <VAR
  3185. CLASS="varname"
  3186. >$_SESSION</VAR
  3187. >.  Die Σlteren <VAR
  3188. CLASS="varname"
  3189. >$HTTP_*_VARS</VAR
  3190. >-Arrays,
  3191.        wie <VAR
  3192. CLASS="varname"
  3193. >$HTTP_POST_VARS</VAR
  3194. >, existierten bereits seit PHP 3 und sind
  3195.        auch immer noch verfⁿgbar.
  3196.       </P
  3197. ></LI
  3198. ><LI
  3199. ><P
  3200. >        Externe Variablen werden standardmΣ▀ig nicht mehr im globalen Namensraum
  3201.        registriert. Mit anderen Worten, seit PHP
  3202.        <A
  3203. HREF="http://www.php.net/release_4_2_0.php"
  3204. TARGET="_top"
  3205. >4.2.0</A
  3206. > ist <SPAN
  3207. CLASS="emphasis"
  3208. ><I
  3209. CLASS="emphasis"
  3210. >off</I
  3211. ></SPAN
  3212. >
  3213.        die Standard-Einstellung fⁿr die PHP-Direktive 
  3214.        <A
  3215. HREF="#ini.register-globals"
  3216. >register_globals</A
  3217. >.
  3218.        Die empfohlene Methode, auf diese Werte zuzugreifen, ist, die oben genannten
  3219.        autoglobalen Arrays zu verwenden. ─ltere Skripte, Bⁿcher und Tutorials gehen
  3220.        eventuell davon aus, dass diese Einstellung auf <SPAN
  3221. CLASS="emphasis"
  3222. ><I
  3223. CLASS="emphasis"
  3224. >on</I
  3225. ></SPAN
  3226. > steht.
  3227.        WΣre die Einstellung on, wΣre die Variable <VAR
  3228. CLASS="varname"
  3229. >$id</VAR
  3230. > aus der
  3231.        URL <VAR
  3232. CLASS="literal"
  3233. >http://www.example.com/foo.php?id=42</VAR
  3234. > verfⁿgbar.
  3235.        UnabhΣngig davon, ob on oder off, ist immer <VAR
  3236. CLASS="varname"
  3237. >$_GET['id']</VAR
  3238. >
  3239.        verfⁿgbar.
  3240.       </P
  3241. ></LI
  3242. ></UL
  3243. >
  3244.     Fⁿr weitere Details ⁿber diese ─nderungen siehe die Seite ⁿber
  3245.     <A
  3246. HREF="#language.variables.predefined"
  3247. >vordefinierte Variablen</A
  3248. >
  3249.     und die Links dort.
  3250.    </P
  3251. ></DIV
  3252. ><DIV
  3253. CLASS="sect1"
  3254. ><HR><H2
  3255. CLASS="sect1"
  3256. ><A
  3257. NAME="tutorial.whatsnext"
  3258. >Und weiter?</A
  3259. ></H2
  3260. ><P
  3261. >     Mit dem Wissen, das Sie jetzt haben, sollte es Ihnen m÷glich sein,
  3262.     das meiste aus diesem Manual und die vielen Beispiel-Skripte
  3263.     in den Beispiel-Archiven zu verstehen.
  3264.     Sie k÷nnen weitere auf den php.net-Seiten verfⁿgbare Beispiele auf der
  3265.     folgenden Seite finden: <A
  3266. HREF="http://www.php.net/links.php"
  3267. TARGET="_top"
  3268. >http://www.php.net/links.php</A
  3269. >.
  3270.    </P
  3271. ></DIV
  3272. ></DIV
  3273. ></DIV
  3274. ><DIV
  3275. CLASS="PART"
  3276. ><A
  3277. NAME="install"
  3278. ></A
  3279. ><DIV
  3280. CLASS="TITLEPAGE"
  3281. ><H1
  3282. CLASS="title"
  3283. >II. Installation und Konfiguration</H1
  3284. ><DIV
  3285. CLASS="TOC"
  3286. ><DL
  3287. ><DT
  3288. ><B
  3289. >Inhaltsverzeichnis</B
  3290. ></DT
  3291. ><DT
  3292. >3. <A
  3293. HREF="#install.general"
  3294. >General Installation Considerations</A
  3295. ></DT
  3296. ><DT
  3297. >4. <A
  3298. HREF="#install.macosx"
  3299. >Installation on Mac OS X</A
  3300. ></DT
  3301. ><DT
  3302. >5. <A
  3303. HREF="#install.unix"
  3304. >Installation on Unix systems</A
  3305. ></DT
  3306. ><DT
  3307. >6. <A
  3308. HREF="#install.windows"
  3309. >Installation on Windows systems</A
  3310. ></DT
  3311. ><DT
  3312. >7. <A
  3313. HREF="#install.problems"
  3314. >Problems?</A
  3315. ></DT
  3316. ><DT
  3317. >8. <A
  3318. HREF="#configuration"
  3319. >Runtime Configuration</A
  3320. ></DT
  3321. ></DL
  3322. ></DIV
  3323. ></DIV
  3324. ><DIV
  3325. CLASS="chapter"
  3326. ><HR><H1
  3327. ><A
  3328. NAME="install.general"
  3329. >Kapitel 3. General Installation Considerations</A
  3330. ></H1
  3331. ><P
  3332. >     Before starting the installation, first you need to know what do you
  3333.     want to use PHP for. There are three main fields you
  3334.     can use PHP, as described in the
  3335.     <A
  3336. HREF="#intro-whatcando"
  3337. >What can PHP do?</A
  3338. >
  3339.     section:
  3340.     <P
  3341. ></P
  3342. ><UL
  3343. ><LI
  3344. ><P
  3345. >Server-side scripting</P
  3346. ></LI
  3347. ><LI
  3348. ><P
  3349. >Command line scripting</P
  3350. ></LI
  3351. ><LI
  3352. ><P
  3353. >Client-side GUI applications</P
  3354. ></LI
  3355. ></UL
  3356. >
  3357.    </P
  3358. ><P
  3359. >     For the first and most common form, you need three things:
  3360.     PHP itself, a web server and a web browser. You
  3361.     probably already have a web browser, and depending on
  3362.     your operating system setup, you may also have a web
  3363.     server (e.g. Apache on Linux and MacOS X; IIS on Windows).
  3364.     You may also rent webspace at a company. This way, you
  3365.     don't need to set up anything on your own, only write
  3366.     your PHP scripts, upload it to the server you rent, and
  3367.     see the results in your browser. 
  3368.    </P
  3369. ><P
  3370. >     While setting up the server and PHP on your own, you have
  3371.     two choices for the method of connecting PHP to the
  3372.     server. For many servers PHP has a direct module
  3373.     interface (also called SAPI). These servers include
  3374.     Apache, Microsoft Internet Information Server,
  3375.     Netscape and iPlanet servers. Many other servers
  3376.     have support for ISAPI, the Microsoft module
  3377.     interface (OmniHTTPd for example). If PHP has no
  3378.     module support for your web server, you can always
  3379.     use it as a CGI or FastCGI processor. This means you set up
  3380.     your server to use the CGI executable of
  3381.     PHP to process all PHP file requests on the server.
  3382.    </P
  3383. ><P
  3384. >     If you are also interested to use PHP for command line
  3385.     scripting (e.g. write scripts autogenerating some images
  3386.     for you offline, or processing text files depending
  3387.     on some arguments you pass to them), you always need
  3388.     the command line executable. For more information, read
  3389.     the section about <A
  3390. HREF="#features.commandline"
  3391. >writing
  3392.     command line PHP applications</A
  3393. >. In this case,
  3394.     you need no server and no browser.
  3395.    </P
  3396. ><P
  3397. >     With PHP you can also write desktop GUI applications
  3398.     using the PHP-GTK extension. This is a completely
  3399.     different approach than writing web pages, as you
  3400.     do not output any HTML, but manage windows and objects
  3401.     within them. For more information about PHP-GTK, please
  3402.     <A
  3403. HREF="http://gtk.php.net/"
  3404. TARGET="_top"
  3405. >visit the site dedicated to
  3406.     this extension</A
  3407. >. PHP-GTK is not included in the
  3408.     official PHP distribution.
  3409.    </P
  3410. ><P
  3411. >     From now on, this section deals with setting up PHP
  3412.     for web servers on Unix and Windows with server module
  3413.     interfaces and CGI executables. You will also find
  3414.     information on the command line executable in the
  3415.     following sections.
  3416.    </P
  3417. ><P
  3418. >     PHP source code and binary distributions for Windows can be
  3419.     found at
  3420.     <A
  3421. HREF="http://www.php.net/downloads.php"
  3422. TARGET="_top"
  3423. >http://www.php.net/downloads.php</A
  3424. >.
  3425.     We recommend you to choose a
  3426.     <A
  3427. HREF="http://www.php.net/mirrors.php"
  3428. TARGET="_top"
  3429. >mirror</A
  3430. > nearest
  3431.     to you for downloading the distributions.
  3432.    </P
  3433. ></DIV
  3434. ><DIV
  3435. CLASS="chapter"
  3436. ><HR><H1
  3437. ><A
  3438. NAME="install.macosx"
  3439. >Kapitel 4. Installation on Mac OS X</A
  3440. ></H1
  3441. ><P
  3442. >   This section contains notes and hints specific to installing
  3443.   PHP on Mac OS X. There are two slightly different versions of
  3444.   Mac OS X, Client and Server, our manual deals with installing
  3445.   PHP on both systems. Note that PHP is not available for MacOS
  3446.   9 and earlier versions. 
  3447.  </P
  3448. ><DIV
  3449. CLASS="sect1"
  3450. ><HR><H2
  3451. CLASS="sect1"
  3452. ><A
  3453. NAME="install.macosx.packages"
  3454. >Using Packages</A
  3455. ></H2
  3456. ><P
  3457. >    There are a few pre-packaged and pre-compiled versions of PHP for
  3458.    Mac OS X. This can help in setting up a standard
  3459.    configuration, but if you need to have a different set of features
  3460.    (such as a secure server, or a different database driver), you may
  3461.    need to build PHP and/or your web server yourself. If you are unfamiliar
  3462.    with building and compiling your own software, it's worth
  3463.    checking whether somebody has already built a packaged
  3464.    version of PHP with the features you need.
  3465.   </P
  3466. ></DIV
  3467. ><DIV
  3468. CLASS="sect1"
  3469. ><HR><H2
  3470. CLASS="sect1"
  3471. ><A
  3472. NAME="install.macosx.server"
  3473. >Compiling for OS X Server</A
  3474. ></H2
  3475. ><DIV
  3476. CLASS="formalpara"
  3477. ><P
  3478. ><A
  3479. NAME="install.macosx.server.compile"
  3480. ></A
  3481. ><B
  3482. >Mac OS X Server install. </B
  3483. >
  3484.     <P
  3485. ></P
  3486. ><OL
  3487. TYPE="1"
  3488. ><LI
  3489. ><P
  3490. >Get the latest distributions of Apache and PHP.</P
  3491. ></LI
  3492. ><LI
  3493. ><P
  3494. >        Untar them, and run the <B
  3495. CLASS="command"
  3496. >configure</B
  3497. > program on Apache
  3498.        like so.
  3499.        <TABLE
  3500. BORDER="0"
  3501. BGCOLOR="#E0E0E0"
  3502. CELLPADDING="5"
  3503. ><TR
  3504. ><TD
  3505. ><PRE
  3506. CLASS="shell"
  3507. >./configure --exec-prefix=/usr \
  3508. --localstatedir=/var \
  3509. --mandir=/usr/share/man \
  3510. --libexecdir=/System/Library/Apache/Modules \
  3511. --iconsdir=/System/Library/Apache/Icons \
  3512. --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \
  3513. --enable-shared=max \
  3514. --enable-module=most \
  3515. --target=apache</PRE
  3516. ></TD
  3517. ></TR
  3518. ></TABLE
  3519. >
  3520.       </P
  3521. ></LI
  3522. ><LI
  3523. ><P
  3524. >        If you want the compiler to do some optimization, you may also want to
  3525.        add this line:
  3526.        <TABLE
  3527. BORDER="0"
  3528. BGCOLOR="#E0E0E0"
  3529. CELLPADDING="5"
  3530. ><TR
  3531. ><TD
  3532. ><PRE
  3533. CLASS="shell"
  3534. >setenv OPTIM=-O2</PRE
  3535. ></TD
  3536. ></TR
  3537. ></TABLE
  3538. >
  3539.       </P
  3540. ></LI
  3541. ><LI
  3542. ><P
  3543. >        Next, go to the PHP 4 source directory and configure it.
  3544.        <TABLE
  3545. BORDER="0"
  3546. BGCOLOR="#E0E0E0"
  3547. CELLPADDING="5"
  3548. ><TR
  3549. ><TD
  3550. ><PRE
  3551. CLASS="shell"
  3552. >./configure --prefix=/usr \
  3553.     --sysconfdir=/etc \
  3554.     --localstatedir=/var \
  3555.     --mandir=/usr/share/man \
  3556.     --with-xml \
  3557.     --with-apache=/src/apache_1.3.12</PRE
  3558. ></TD
  3559. ></TR
  3560. ></TABLE
  3561. >
  3562.        If you have any other additions (MySQL, GD, etc.), be sure to add them
  3563.        here. For the <VAR
  3564. CLASS="option"
  3565. >--with-apache</VAR
  3566. > string, put
  3567.        in the path to your apache source directory, for example
  3568.        <TT
  3569. CLASS="filename"
  3570. >/src/apache_1.3.12</TT
  3571. >.
  3572.       </P
  3573. ></LI
  3574. ><LI
  3575. ><P
  3576. >        Type <B
  3577. CLASS="command"
  3578. >make</B
  3579. > and <B
  3580. CLASS="command"
  3581. >make install</B
  3582. >. This
  3583.        will add a directory to your Apache source directory under
  3584.        <TT
  3585. CLASS="filename"
  3586. >src/modules/php4</TT
  3587. >.
  3588.       </P
  3589. ></LI
  3590. ><LI
  3591. ><P
  3592. >        Now, reconfigure Apache to build in PHP 4.
  3593.        <TABLE
  3594. BORDER="0"
  3595. BGCOLOR="#E0E0E0"
  3596. CELLPADDING="5"
  3597. ><TR
  3598. ><TD
  3599. ><PRE
  3600. CLASS="shell"
  3601. >./configure --exec-prefix=/usr \
  3602. --localstatedir=/var \
  3603. --mandir=/usr/share/man \
  3604. --libexecdir=/System/Library/Apache/Modules \
  3605. --iconsdir=/System/Library/Apache/Icons \
  3606. --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \
  3607. --enable-shared=max \
  3608. --enable-module=most \
  3609. --target=apache \
  3610. --activate-module=src/modules/php4/libphp4.a</PRE
  3611. ></TD
  3612. ></TR
  3613. ></TABLE
  3614. >
  3615.        You may get a message telling you that <TT
  3616. CLASS="filename"
  3617. >libmodphp4.a</TT
  3618. > is
  3619.        out of date. If so, go to the <TT
  3620. CLASS="filename"
  3621. >src/modules/php4</TT
  3622. >
  3623.        directory inside your Apache source directory and run this command: 
  3624.        <B
  3625. CLASS="command"
  3626. >ranlib libmodphp4.a</B
  3627. >. Then go back to the root of the
  3628.        Apache source directory and run the above <B
  3629. CLASS="command"
  3630. >configure</B
  3631. >
  3632.        command again. That'll bring the link table up to date. Run
  3633.        <B
  3634. CLASS="command"
  3635. >make</B
  3636. > and <B
  3637. CLASS="command"
  3638. >make install</B
  3639. > again.
  3640.       </P
  3641. ></LI
  3642. ><LI
  3643. ><P
  3644. >        Copy and rename the <TT
  3645. CLASS="filename"
  3646. >php.ini-dist</TT
  3647. > file to your
  3648.        <TT
  3649. CLASS="filename"
  3650. >bin</TT
  3651. > directory from your PHP 4
  3652.        source directory: 
  3653.        <KBD
  3654. CLASS="userinput"
  3655. >cp php.ini-dist /usr/local/bin/php.ini</KBD
  3656. >
  3657.        or (if your don't have a local directory)
  3658.        <KBD
  3659. CLASS="userinput"
  3660. >cp php.ini-dist /usr/bin/php.ini</KBD
  3661. >.
  3662.       </P
  3663. ></LI
  3664. ></OL
  3665. >
  3666.    </P
  3667. ></DIV
  3668. ></DIV
  3669. ><DIV
  3670. CLASS="sect1"
  3671. ><HR><H2
  3672. CLASS="sect1"
  3673. ><A
  3674. NAME="install.macosx.client"
  3675. >Compiling for MacOS X Client</A
  3676. ></H2
  3677. ><P
  3678. >    The following instructions will help you install a PHP module for the Apache
  3679.    web server included in MacOS X. This version includes support for the MySQL
  3680.    and PostgreSQL databases. These instructions are graciously provided by
  3681.    <A
  3682. HREF="http://www.entropy.ch/software/macosx/"
  3683. TARGET="_top"
  3684. >Marc Liyanage</A
  3685. >.
  3686.   </P
  3687. ><DIV
  3688. CLASS="warning"
  3689. ><P
  3690. ></P
  3691. ><TABLE
  3692. CLASS="warning"
  3693. BORDER="1"
  3694. WIDTH="100%"
  3695. ><TR
  3696. ><TD
  3697. ALIGN="CENTER"
  3698. ><B
  3699. >Warnung</B
  3700. ></TD
  3701. ></TR
  3702. ><TR
  3703. ><TD
  3704. ALIGN="LEFT"
  3705. ><P
  3706. >     Be careful when you do this, you could screw up your Apache web server!
  3707.    </P
  3708. ></TD
  3709. ></TR
  3710. ></TABLE
  3711. ></DIV
  3712. ><P
  3713. >    Do this to install:
  3714.    <P
  3715. ></P
  3716. ><OL
  3717. TYPE="1"
  3718. ><LI
  3719. ><P
  3720. >       Open a terminal window.
  3721.      </P
  3722. ></LI
  3723. ><LI
  3724. ><P
  3725. >       Type
  3726.       <KBD
  3727. CLASS="userinput"
  3728. >wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz</KBD
  3729. >,
  3730.       wait for the download to finish.
  3731.      </P
  3732. ></LI
  3733. ><LI
  3734. ><P
  3735. >       Type <KBD
  3736. CLASS="userinput"
  3737. >gunzip libphp4.so.gz</KBD
  3738. >.
  3739.      </P
  3740. ></LI
  3741. ><LI
  3742. ><P
  3743. >       Type <KBD
  3744. CLASS="userinput"
  3745. >sudo apxs -i -a -n php4 libphp4.so</KBD
  3746. >
  3747.      </P
  3748. ></LI
  3749. ><LI
  3750. ><P
  3751. >       Now type <KBD
  3752. CLASS="userinput"
  3753. >sudo open -a TextEdit /etc/httpd/httpd.conf</KBD
  3754. >.
  3755.       TextEdit will open with the web server configuration file. Locate these 
  3756.       two lines towards the end of the file: (Use the Find command)
  3757.       <TABLE
  3758. BORDER="0"
  3759. BGCOLOR="#E0E0E0"
  3760. CELLPADDING="5"
  3761. ><TR
  3762. ><TD
  3763. ><PRE
  3764. CLASS="apache"
  3765. >#AddType application/x-httpd-php .php 
  3766. #AddType application/x-httpd-php-source .phps</PRE
  3767. ></TD
  3768. ></TR
  3769. ></TABLE
  3770. >
  3771.        Remove the two hash marks (<VAR
  3772. CLASS="literal"
  3773. >#</VAR
  3774. >), then save the file and
  3775.        quit TextEdit.
  3776.       </P
  3777. ></LI
  3778. ><LI
  3779. ><P
  3780. >       Finally, type <KBD
  3781. CLASS="userinput"
  3782. >sudo apachectl graceful</KBD
  3783. > to restart
  3784.       the web server.
  3785.      </P
  3786. ></LI
  3787. ></OL
  3788. >
  3789.   </P
  3790. ><P
  3791. >    PHP should now be up and running. You can test it by dropping a file into 
  3792.    your <TT
  3793. CLASS="filename"
  3794. >Sites</TT
  3795. > folder which is called
  3796.    <TT
  3797. CLASS="filename"
  3798. >test.php</TT
  3799. >. Into that file, write this line:
  3800.    <VAR
  3801. CLASS="literal"
  3802. ><?php phpinfo() ?></VAR
  3803. >.
  3804.   </P
  3805. ><P
  3806. >    Now open up <VAR
  3807. CLASS="literal"
  3808. >127.0.0.1/~your_username/test.php</VAR
  3809. > in your web
  3810.    browser. You should see a status table with information about the PHP module.
  3811.   </P
  3812. ></DIV
  3813. ></DIV
  3814. ><DIV
  3815. CLASS="chapter"
  3816. ><HR><H1
  3817. ><A
  3818. NAME="install.unix"
  3819. >Kapitel 5. Installation on Unix systems</A
  3820. ></H1
  3821. ><P
  3822. >     This section will guide you through the general configuration and
  3823.     installation of PHP on Unix systems. Be sure to investigate any
  3824.     sections specific to your platform or web server before you begin
  3825.     the process.
  3826.    </P
  3827. ><P
  3828. >     As our manual outlines in the <A
  3829. HREF="#install.general"
  3830. >General
  3831.     Installation Considerations</A
  3832. > section, we are mainly dealing with
  3833.     web centric setups of PHP in this section, although we will cover
  3834.     setting up PHP for command line usage as well.
  3835.    </P
  3836. ><P
  3837. > 
  3838.     There are several ways to install PHP for the Unix platform, either
  3839.     with a compile and configure process, or through various
  3840.     pre-packaged methods. This documentation is mainly focused around
  3841.     the process of compiling and configuring PHP. Many Unix like systems
  3842.     have some sort of package installation system. This can assist in
  3843.     setting up a standard configuration, but if you need to have a
  3844.     different set of features (such as a secure server, or a different
  3845.     database driver), you may need to build PHP and/or your webserver.
  3846.     If you are unfamiliar with building and compiling your own software,
  3847.     it is worth checking to see whether somebody has already built a
  3848.     packaged version of PHP with the features you need.
  3849.    </P
  3850. ><P
  3851. >     Prerequisite knowledge and software for compiling:
  3852.     <P
  3853. ></P
  3854. ><UL
  3855. ><LI
  3856. ><P
  3857. >        Basic Unix skills (being able to operate "make" and a C
  3858.        compiler)
  3859.       </P
  3860. ></LI
  3861. ><LI
  3862. ><P
  3863. >        An ANSI C compiler
  3864.       </P
  3865. ></LI
  3866. ><LI
  3867. ><P
  3868. >        flex
  3869.       </P
  3870. ></LI
  3871. ><LI
  3872. ><P
  3873. >        bison
  3874.       </P
  3875. ></LI
  3876. ><LI
  3877. ><P
  3878. >        A web server
  3879.       </P
  3880. ></LI
  3881. ><LI
  3882. ><P
  3883. >        Any module specific components (such as gd, pdf libs, etc.)
  3884.       </P
  3885. ></LI
  3886. ></UL
  3887. >
  3888.    </P
  3889. ><P
  3890. >     The initial PHP setup and configuration process is controlled by the
  3891.     use of the commandline options of the <TT
  3892. CLASS="filename"
  3893. >configure</TT
  3894. >
  3895.     script. Our manual documents the different options separately. You will
  3896.     find the <A
  3897. HREF="#configure"
  3898. >core options in the appendix</A
  3899. >,
  3900.     while the different extension specific options are descibed on the
  3901.     reference pages.
  3902.    </P
  3903. ><P
  3904. >     When PHP is configured, you are ready to build the module and/or
  3905.     executables. The command <B
  3906. CLASS="command"
  3907. >make</B
  3908. > should
  3909.     take care of this. If it fails and you can't figure out why, see
  3910.     the <A
  3911. HREF="#install.problems"
  3912. >Problems section</A
  3913. >.
  3914.    </P
  3915. ><DIV
  3916. CLASS="sect1"
  3917. ><HR><H2
  3918. CLASS="sect1"
  3919. ><A
  3920. NAME="install.unix.gentoo"
  3921. >Gentoo installation notes</A
  3922. ></H2
  3923. ><P
  3924. >   This section contains notes and hints specific to installing
  3925.   PHP on <A
  3926. HREF="http://www.gentoo.org/"
  3927. TARGET="_top"
  3928. >Gentoo Linux</A
  3929. >.
  3930.  </P
  3931. ><DIV
  3932. CLASS="sect2"
  3933. ><HR><H3
  3934. CLASS="sect2"
  3935. ><A
  3936. NAME="install.unix.gentoo.portage"
  3937. >Using Portage (emerge)</A
  3938. ></H3
  3939. ><P
  3940. >     While you can just download the PHP source and compile it youself,
  3941.     using Gentoo's packaging system is the simplest and cleanest
  3942.     method of installing PHP. If you are not familiar with building
  3943.     software on Linux, this is the way to go.
  3944.    </P
  3945. ><P
  3946. >     If you have built your Gentoo system so far, you are probably used
  3947.     to Portage already. Installing Apache and PHP is no different than 
  3948.     the other system tools.
  3949.    </P
  3950. ><P
  3951. >     The first decision you need to make is whether you want to install
  3952.     Apache 1.3.x or Apache 2.x. While both can be used with PHP, the 
  3953.     steps given bellow will use Apache 1.3.x. Another thing to consider
  3954.     is whether your local Portage tree is up to date. If you have not
  3955.     updated it recently, you need to run <B
  3956. CLASS="command"
  3957. >emerge sync</B
  3958. >
  3959.     before anything else. This way, you will be using the most recent
  3960.     stable version of Apache and PHP.
  3961.    </P
  3962. ><P
  3963. >     Now that everything is in place, you can use the following example
  3964.     to install Apache and PHP:
  3965.    </P
  3966. ><TABLE
  3967. WIDTH="100%"
  3968. BORDER="0"
  3969. CELLPADDING="0"
  3970. CELLSPACING="0"
  3971. CLASS="EXAMPLE"
  3972. ><TR
  3973. ><TD
  3974. ><DIV
  3975. CLASS="example"
  3976. ><A
  3977. NAME="install.unix.gentoo.portage.example"
  3978. ></A
  3979. ><P
  3980. ><B
  3981. >Beispiel 5-1. Gentoo Install Example with Apache 1.3</B
  3982. ></P
  3983. ><TABLE
  3984. BORDER="0"
  3985. BGCOLOR="#E0E0E0"
  3986. CELLPADDING="5"
  3987. ><TR
  3988. ><TD
  3989. ><PRE
  3990. CLASS="shell"
  3991. ># emerge \<apache-2
  3992. # USE="-*" emerge php mod_php
  3993. # ebuild /var/db/pkg/dev-php/mod_php-<your PHP version>/mod_php-<your PHP version>.ebuild config
  3994. # nano /etc/conf.d/apache
  3995.   Add "-D PHP4" to APACHE_OPTS
  3996.   
  3997. # rc-update add apache default
  3998. # /etc/init.d/apache start</PRE
  3999. ></TD
  4000. ></TR
  4001. ></TABLE
  4002. ></DIV
  4003. ></TD
  4004. ></TR
  4005. ></TABLE
  4006. ><P
  4007. >     You can read more about emerge in the excellent 
  4008.     <A
  4009. HREF="http://www.gentoo.org/doc/en/portage-manual.xml"
  4010. TARGET="_top"
  4011. >Portage Manual</A
  4012. > provided
  4013.     on the Gentoo website.
  4014.    </P
  4015. ><P
  4016. >     If you need to use Apache 2, you can simply use <B
  4017. CLASS="command"
  4018. >emerge apache</B
  4019. >
  4020.     in the last example.
  4021.    </P
  4022. ></DIV
  4023. ><DIV
  4024. CLASS="sect2"
  4025. ><HR><H3
  4026. CLASS="sect2"
  4027. ><A
  4028. NAME="install.unix.gentoo.config"
  4029. >Better control on configuration</A
  4030. ></H3
  4031. ><P
  4032. >     In the last section, PHP was emerged without any activated modules.
  4033.     As of this writing, the only module activated by default with Portage 
  4034.     is XML which is needed by <A
  4035. HREF="http://pear.php.net/"
  4036. TARGET="_top"
  4037. >PEAR</A
  4038. >.
  4039.     This may not be what you want and you will soon discover that you need 
  4040.     more activated modules, like MySQL, gettext, GD, etc.
  4041.    </P
  4042. ><P
  4043. >     When you compile PHP from source yourself, you need to activate modules
  4044.     via the <B
  4045. CLASS="command"
  4046. >configure</B
  4047. > command. With Gentoo, you can simply
  4048.     provide USE flags which will be passed to the configure script automatically.
  4049.     To see which USE flags to use with emerge, you can try:
  4050.    </P
  4051. ><TABLE
  4052. WIDTH="100%"
  4053. BORDER="0"
  4054. CELLPADDING="0"
  4055. CELLSPACING="0"
  4056. CLASS="EXAMPLE"
  4057. ><TR
  4058. ><TD
  4059. ><DIV
  4060. CLASS="example"
  4061. ><A
  4062. NAME="install.unix.gentoo.config.example"
  4063. ></A
  4064. ><P
  4065. ><B
  4066. >Beispiel 5-2. Getting the list of valid USE flags</B
  4067. ></P
  4068. ><TABLE
  4069. BORDER="0"
  4070. BGCOLOR="#E0E0E0"
  4071. CELLPADDING="5"
  4072. ><TR
  4073. ><TD
  4074. ><PRE
  4075. CLASS="shell"
  4076. ># USE="-*" emerge -pv php
  4077.  
  4078. [ebuild  N    ] dev-php/php-4.3.6-r1  -X -berkdb -crypt -curl -debug -doc 
  4079. -fdftk -firebird -flash -freetds -gd -gd-external -gdbm -gmp -hardenedphp 
  4080. -imap -informix -ipv6 -java -jpeg -kerberos -ldap -mcal -memlimit -mssql 
  4081. -mysql -ncurses -nls -oci8 -odbc -pam -pdflib -png -postgres -qt -readline 
  4082. -snmp -spell -ssl -tiff -truetype -xml2 -yaz  3,876 kB</PRE
  4083. ></TD
  4084. ></TR
  4085. ></TABLE
  4086. ></DIV
  4087. ></TD
  4088. ></TR
  4089. ></TABLE
  4090. ><P
  4091. >     As you can see from the last output, PHP considers a lot of USE flags.
  4092.     Look at them closely and choose what you need. If you choose a flag and 
  4093.     you do not have the proper librairies, Portage will compile them for you.
  4094.     It is a good idea to use <B
  4095. CLASS="command"
  4096. >emerge -pv</B
  4097. > again to see what
  4098.     Portage will compile in accordance to your USE flags. As an example,
  4099.     if you do not have X installed and you choose to include X in the USE
  4100.     flags, Portage will compile X prior to PHP, which can take a couple
  4101.     of hours.
  4102.    </P
  4103. ><P
  4104. >     If you choose to compile PHP with MySQL, cURL and GD support, the command
  4105.     will look something like this:
  4106.    </P
  4107. ><TABLE
  4108. WIDTH="100%"
  4109. BORDER="0"
  4110. CELLPADDING="0"
  4111. CELLSPACING="0"
  4112. CLASS="EXAMPLE"
  4113. ><TR
  4114. ><TD
  4115. ><DIV
  4116. CLASS="example"
  4117. ><A
  4118. NAME="install.unix.gentoo.config.example2"
  4119. ></A
  4120. ><P
  4121. ><B
  4122. >Beispiel 5-3. Install PHP with USE flags</B
  4123. ></P
  4124. ><TABLE
  4125. BORDER="0"
  4126. BGCOLOR="#E0E0E0"
  4127. CELLPADDING="5"
  4128. ><TR
  4129. ><TD
  4130. ><PRE
  4131. CLASS="shell"
  4132. ># USE="-* curl mysql gd" emerge php mod_php</PRE
  4133. ></TD
  4134. ></TR
  4135. ></TABLE
  4136. ></DIV
  4137. ></TD
  4138. ></TR
  4139. ></TABLE
  4140. ><P
  4141. >     As in the last example, do not forget to emerge php as well as mod_php.
  4142.     php is responsible for the command line version of PHP as mod_php is
  4143.     for the Apache module version of PHP.
  4144.    </P
  4145. ></DIV
  4146. ><DIV
  4147. CLASS="sect2"
  4148. ><HR><H3
  4149. CLASS="sect2"
  4150. ><A
  4151. NAME="install.unix.gentoo.faq"
  4152. >Common Problems</A
  4153. ></H3
  4154. ><P
  4155. ></P
  4156. ><UL
  4157. ><LI
  4158. ><P
  4159. >      If you see the PHP source instead of the result the script should
  4160.      produce, you have probably forgot to edit <TT
  4161. CLASS="filename"
  4162. >/etc/conf.d/apache</TT
  4163. >.
  4164.      Apache needs to be started with the -D PHP4 flag. To see if the flag is
  4165.      present, you should be able to see it when using 
  4166.      <B
  4167. CLASS="command"
  4168. >ps ax | grep apache</B
  4169. > while Apache is running.
  4170.     </P
  4171. ></LI
  4172. ><LI
  4173. ><P
  4174. >      Due to slotting problems, you might end up with more than one version
  4175.      of PHP installed on your system. If this is the case, you need to unmerge
  4176.      the old versions manually by using
  4177.      <B
  4178. CLASS="command"
  4179. >emerge unmerge mod_php-<old version></B
  4180. >.
  4181.     </P
  4182. ></LI
  4183. ><LI
  4184. ><P
  4185. >      If you cannot emerge PHP because of Java, try putting <B
  4186. CLASS="command"
  4187. >-*</B
  4188. >
  4189.      in front of your USE flags like in the above examples.
  4190.     </P
  4191. ></LI
  4192. ><LI
  4193. ><P
  4194. >      If you are having problems configuring Apache and PHP, you can always
  4195.      search the <A
  4196. HREF="http://forums.gentoo.org/"
  4197. TARGET="_top"
  4198. >Gentoo Forums</A
  4199. >.
  4200.      Try searching with the keywords "Apache PHP".
  4201.     </P
  4202. ></LI
  4203. ></UL
  4204. ></DIV
  4205. ></DIV
  4206. ><DIV
  4207. CLASS="sect1"
  4208. ><HR><H2
  4209. CLASS="sect1"
  4210. ><A
  4211. NAME="install.unix.hpux"
  4212. >HP-UX specific installation notes</A
  4213. ></H2
  4214. ><P
  4215. >     This section contains notes and hints specific to installing PHP
  4216.     on HP-UX systems. (Contributed by paul_mckay at clearwater-it dot co dot
  4217.     uk).
  4218.    </P
  4219. ><DIV
  4220. CLASS="note"
  4221. ><BLOCKQUOTE
  4222. CLASS="note"
  4223. ><P
  4224. ><B
  4225. >Anmerkung: </B
  4226. >
  4227.      These tips were written for PHP 4.0.4 and Apache 1.3.9.
  4228.     </P
  4229. ></BLOCKQUOTE
  4230. ></DIV
  4231. ><P
  4232. >     <P
  4233. ></P
  4234. ><OL
  4235. TYPE="1"
  4236. ><LI
  4237. ><P
  4238. >        You need gzip, download a binary distribution from
  4239.        <TT
  4240. CLASS="filename"
  4241. >http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z</TT
  4242. >
  4243.        uncompress the file and install using swinstall.
  4244.       </P
  4245. ></LI
  4246. ><LI
  4247. ><P
  4248. >        You need gcc, download a binary distribution from
  4249.        <TT
  4250. CLASS="filename"
  4251. >http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz</TT
  4252. >.
  4253.        uncompress this file and install gcc using swinstall.
  4254.       </P
  4255. ></LI
  4256. ><LI
  4257. ><P
  4258. >        You need the GNU binutils, you can download a binary distribution from
  4259.        <TT
  4260. CLASS="filename"
  4261. >http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz</TT
  4262. >.
  4263.        uncompress this file and install binutils using swinstall.
  4264.       </P
  4265. ></LI
  4266. ><LI
  4267. ><P
  4268. >        You now need bison, you can download a binary distribution from
  4269.        <TT
  4270. CLASS="filename"
  4271. >http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz</TT
  4272. >,
  4273.        install as above.
  4274.       </P
  4275. ></LI
  4276. ><LI
  4277. ><P
  4278. >        You now need flex, you need to download the source from one of the
  4279.        http://www.gnu.org mirrors. It is in the non-gnu directory of the ftp
  4280.        site.  Download the file, <B
  4281. CLASS="command"
  4282. >gunzip</B
  4283. >, then
  4284.        <B
  4285. CLASS="command"
  4286. >tar -xvf</B
  4287. > it. Go into the newly created flex directory
  4288.        and run <B
  4289. CLASS="command"
  4290. >./configure</B
  4291. >, followed by 
  4292.        <B
  4293. CLASS="command"
  4294. >make</B
  4295. >, and then <B
  4296. CLASS="command"
  4297. >make install</B
  4298. >.
  4299.       </P
  4300. ><P
  4301. >        If you have errors here, it's probably because gcc etc. are not in your
  4302.        PATH so add them to your PATH. 
  4303.       </P
  4304. ></LI
  4305. ><LI
  4306. ><P
  4307. >        Download the PHP and apache sources. 
  4308.       </P
  4309. ></LI
  4310. ><LI
  4311. ><P
  4312. >        <B
  4313. CLASS="command"
  4314. >gunzip</B
  4315. > and <B
  4316. CLASS="command"
  4317. >tar -xvf</B
  4318. > them. We
  4319.        need to hack a couple of files so that they can compile OK.
  4320.       </P
  4321. ></LI
  4322. ><LI
  4323. ><P
  4324. >        Firstly the configure file needs to be hacked because it seems to lose
  4325.        track of the fact that you are a hpux machine, there will be a better
  4326.        way of doing this but a cheap and cheerful hack is to put
  4327.        <VAR
  4328. CLASS="literal"
  4329. >lt_target=hpux10.20</VAR
  4330. > on line 47286 of the configure
  4331.        script.
  4332.       </P
  4333. ></LI
  4334. ><LI
  4335. ><P
  4336. >        Next, the Apache GuessOS file needs to be hacked. Under
  4337.        <TT
  4338. CLASS="filename"
  4339. >apache_1.3.9/src/helpers</TT
  4340. > change line 89 from <VAR
  4341. CLASS="literal"
  4342. >echo
  4343.        "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0</VAR
  4344. > to: <VAR
  4345. CLASS="literal"
  4346. >echo
  4347.        "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0</VAR
  4348. >
  4349.       </P
  4350. ></LI
  4351. ><LI
  4352. ><P
  4353. >        You cannot install PHP as a shared object under HP-UX so you must
  4354.        compile it as a static, just follow the instructions at the Apache
  4355.        page. 
  4356.       </P
  4357. ></LI
  4358. ><LI
  4359. ><P
  4360. >        PHP and Apache should have compiled OK, but Apache won't start. you
  4361.        need to create a new user for Apache, e.g. www, or apache. You then
  4362.        change lines 252 and 253 of the <TT
  4363. CLASS="filename"
  4364. >conf/httpd.conf</TT
  4365. > in
  4366.        Apache so that instead of
  4367.       </P
  4368. ><TABLE
  4369. BORDER="0"
  4370. BGCOLOR="#E0E0E0"
  4371. CELLPADDING="5"
  4372. ><TR
  4373. ><TD
  4374. ><PRE
  4375. CLASS="screen"
  4376. >User nobody 
  4377. Group nogroup</PRE
  4378. ></TD
  4379. ></TR
  4380. ></TABLE
  4381. ><P
  4382. >        you have something like 
  4383.       </P
  4384. ><TABLE
  4385. BORDER="0"
  4386. BGCOLOR="#E0E0E0"
  4387. CELLPADDING="5"
  4388. ><TR
  4389. ><TD
  4390. ><PRE
  4391. CLASS="screen"
  4392. >User www 
  4393. Group sys</PRE
  4394. ></TD
  4395. ></TR
  4396. ></TABLE
  4397. ><P
  4398. >        This is because you can't run Apache as nobody under hp-ux. Apache and
  4399.        PHP should then work. 
  4400.       </P
  4401. ></LI
  4402. ></OL
  4403. >
  4404.  </P
  4405. ></DIV
  4406. ><DIV
  4407. CLASS="sect1"
  4408. ><HR><H2
  4409. CLASS="sect1"
  4410. ><A
  4411. NAME="install.unix.openbsd"
  4412. >OpenBSD installation notes</A
  4413. ></H2
  4414. ><P
  4415. >  This section contains notes and hints specific to installing
  4416.  PHP on <A
  4417. HREF="http://www.openbsd.org/"
  4418. TARGET="_top"
  4419. >OpenBSD 3.4</A
  4420. >.
  4421.  </P
  4422. ><DIV
  4423. CLASS="sect2"
  4424. ><HR><H3
  4425. CLASS="sect2"
  4426. ><A
  4427. NAME="install.unix.openbsd.packages"
  4428. >Using Binary Packages</A
  4429. ></H3
  4430. ><P
  4431. >     Using binary packages to install PHP on OpenBSD is the recommended
  4432.     and simplest method.  The core package has been separated from the various
  4433.     modules, and each can be installed and removed independently from the others.
  4434.     The files you need can be found on your OpenBSD CD or on the FTP site.
  4435.    </P
  4436. ><P
  4437. >     The main package you need to install is <TT
  4438. CLASS="filename"
  4439. >php4-core-4.3.3.tgz</TT
  4440. >,
  4441.     which contains the basic engine (plus gettext and iconv).  Next, take a look
  4442.     at the module packages, such as <TT
  4443. CLASS="filename"
  4444. >php4-mysql-4.3.3.tgz</TT
  4445. >
  4446.     or <TT
  4447. CLASS="filename"
  4448. >php4-imap-4.3.3.tgz</TT
  4449. >.  You need to use the <B
  4450. CLASS="command"
  4451. >phpxs</B
  4452. >
  4453.     command to activate and deactivate these modules in your <TT
  4454. CLASS="filename"
  4455. >php.ini</TT
  4456. >.
  4457.    </P
  4458. ><TABLE
  4459. WIDTH="100%"
  4460. BORDER="0"
  4461. CELLPADDING="0"
  4462. CELLSPACING="0"
  4463. CLASS="EXAMPLE"
  4464. ><TR
  4465. ><TD
  4466. ><DIV
  4467. CLASS="example"
  4468. ><A
  4469. NAME="install.unix.openbsd.ports.example"
  4470. ></A
  4471. ><P
  4472. ><B
  4473. >Beispiel 5-4. OpenBSD Package Install Example</B
  4474. ></P
  4475. ><TABLE
  4476. BORDER="0"
  4477. BGCOLOR="#E0E0E0"
  4478. CELLPADDING="5"
  4479. ><TR
  4480. ><TD
  4481. ><PRE
  4482. CLASS="shell"
  4483. ># pkg_add php4-core-4.3.3.tgz
  4484. # /usr/local/sbin/phpxs -s
  4485. # cp /usr/local/share/doc/php4/php.ini-recommended /var/www/conf/php.ini
  4486.   (add in mysql)
  4487. # pkg_add php4-mysql-4.3.3.tgz
  4488. # /usr/local/sbin/phpxs -a mysql
  4489.   (add in imap)
  4490. # pkg_add php4-imap-4.3.3.tgz
  4491. # /usr/local/sbin/phpxs -a imap
  4492.   (remove mysql as a test)
  4493. # pkg_delete php4-mysql-4.3.3
  4494. # /usr/local/sbin/phpxs -r mysql
  4495.   (install the PEAR libraries)
  4496. # pkg_add php4-pear-4.3.3.tgz</PRE
  4497. ></TD
  4498. ></TR
  4499. ></TABLE
  4500. ></DIV
  4501. ></TD
  4502. ></TR
  4503. ></TABLE
  4504. ><P
  4505. >    Read the <A
  4506. HREF="http://www.openbsd.org/cgi-bin/man.cgi?query=packages"
  4507. TARGET="_top"
  4508. >packages(7)</A
  4509. >
  4510.    manual page for more information about binary packages on OpenBSD.
  4511.    </P
  4512. ></DIV
  4513. ><DIV
  4514. CLASS="sect2"
  4515. ><HR><H3
  4516. CLASS="sect2"
  4517. ><A
  4518. NAME="install.unix.openbsd.ports"
  4519. >Using Ports</A
  4520. ></H3
  4521. ><P
  4522. >    You can also compile up PHP from source using the <A
  4523. HREF="http://www.openbsd.org/ports.html"
  4524. TARGET="_top"
  4525. >ports tree</A
  4526. >.
  4527.    However, this is only recommended for users familiar with OpenBSD.  The PHP 4 port
  4528.    is split into two sub-directories: core and extensions.  The
  4529.    extensions directory generates sub-packages for all of the supported
  4530.    PHP modules.  If you find you do not want to create some of these modules,
  4531.    use the <B
  4532. CLASS="command"
  4533. >no_*</B
  4534. > FLAVOR.  For example, to skip building
  4535.    the imap module, set the FLAVOR to <B
  4536. CLASS="command"
  4537. >no_imap</B
  4538. >.
  4539.   </P
  4540. ></DIV
  4541. ><DIV
  4542. CLASS="sect2"
  4543. ><HR><H3
  4544. CLASS="sect2"
  4545. ><A
  4546. NAME="install.unix.openbsd.faq"
  4547. >Common Problems</A
  4548. ></H3
  4549. ><P
  4550. ></P
  4551. ><UL
  4552. ><LI
  4553. ><P
  4554. >The default install of Apache runs inside a
  4555.     <A
  4556. HREF="http://www.openbsd.org/cgi-bin/man.cgi?query=chroot"
  4557. TARGET="_top"
  4558. >chroot(2) jail</A
  4559. >, which will restrict PHP scripts to
  4560.     accessing files under <TT
  4561. CLASS="filename"
  4562. >/var/www</TT
  4563. >.  You will therefore need to create a
  4564.     <TT
  4565. CLASS="filename"
  4566. >/var/www/tmp</TT
  4567. > directory for PHP session files to be stored, or use an
  4568.     alternative session backend.  In addition, database sockets need to be placed inside the
  4569.     jail or listen on the <TT
  4570. CLASS="filename"
  4571. >localhost</TT
  4572. > interface.  If you use network functions,
  4573.     some files from <TT
  4574. CLASS="filename"
  4575. >/etc</TT
  4576. > such as <TT
  4577. CLASS="filename"
  4578. >/etc/resolv.conf</TT
  4579. > and
  4580.     <TT
  4581. CLASS="filename"
  4582. >/etc/services</TT
  4583. > will need to be moved into <TT
  4584. CLASS="filename"
  4585. >/var/www/etc</TT
  4586. >.
  4587.     The OpenBSD PEAR package automatically installs into the correct chroot directories, so 
  4588.     no special modification is needed there.  More information on the OpenBSD Apache is available
  4589.     in the <A
  4590. HREF="http://www.openbsd.org/faq/faq10.html#httpdchroot"
  4591. TARGET="_top"
  4592. >OpenBSD FAQ</A
  4593. >.
  4594.     </P
  4595. ></LI
  4596. ><LI
  4597. ><P
  4598. >     The OpenBSD 3.4 package for the <A
  4599. HREF="http://www.boutell.com/gd/"
  4600. TARGET="_top"
  4601. >gd</A
  4602. > extension requires
  4603.     XFree86 to be installed.  If you do not wish to use some of the font features that
  4604.     require X11, install the <TT
  4605. CLASS="filename"
  4606. >php4-gd-4.3.3-no_x11.tgz</TT
  4607. > package instead.
  4608.     </P
  4609. ></LI
  4610. ></UL
  4611. ></DIV
  4612. ><DIV
  4613. CLASS="sect2"
  4614. ><HR><H3
  4615. CLASS="sect2"
  4616. ><A
  4617. NAME="install.unix.openbsd.older"
  4618. >Older Releases</A
  4619. ></H3
  4620. ><P
  4621. >    Older releases of OpenBSD used the FLAVORS system to compile up
  4622.    a statically linked PHP.  Since it is hard to generate binary packages using
  4623.    this method, it is now deprecated.  You can still use the old stable
  4624.    ports trees if you wish, but they are unsupported by the OpenBSD team.
  4625.    If you have any comments about this, the current maintainer for the port
  4626.    is Anil Madhavapeddy (avsm at openbsd dot org).
  4627.   </P
  4628. ></DIV
  4629. ></DIV
  4630. ><DIV
  4631. CLASS="sect1"
  4632. ><HR><H2
  4633. CLASS="sect1"
  4634. ><A
  4635. NAME="install.unix.solaris"
  4636. >Solaris specific installation tips</A
  4637. ></H2
  4638. ><P
  4639. >   This section contains notes and hints specific to installing
  4640.   PHP on Solaris systems.
  4641.  </P
  4642. ><DIV
  4643. CLASS="sect2"
  4644. ><HR><H3
  4645. CLASS="sect2"
  4646. ><A
  4647. NAME="install.unix.solaris.required"
  4648. >Required software</A
  4649. ></H3
  4650. ><P
  4651. >    Solaris installs often lack C compilers and their related tools.
  4652.    Read <A
  4653. HREF="#faq.installation.needgnu"
  4654. >this FAQ</A
  4655. > 
  4656.    for information on why using GNU versions for some of these
  4657.    tools is necessary.  The required software is as follows:
  4658.    <P
  4659. ></P
  4660. ><UL
  4661. ><LI
  4662. ><P
  4663. >       gcc (recommended, other C compilers may work)
  4664.      </P
  4665. ></LI
  4666. ><LI
  4667. ><P
  4668. >       make
  4669.      </P
  4670. ></LI
  4671. ><LI
  4672. ><P
  4673. >       flex
  4674.      </P
  4675. ></LI
  4676. ><LI
  4677. ><P
  4678. >       bison
  4679.      </P
  4680. ></LI
  4681. ><LI
  4682. ><P
  4683. >       m4
  4684.      </P
  4685. ></LI
  4686. ><LI
  4687. ><P
  4688. >       autoconf
  4689.      </P
  4690. ></LI
  4691. ><LI
  4692. ><P
  4693. >       automake
  4694.      </P
  4695. ></LI
  4696. ><LI
  4697. ><P
  4698. >       perl
  4699.      </P
  4700. ></LI
  4701. ><LI
  4702. ><P
  4703. >       gzip
  4704.      </P
  4705. ></LI
  4706. ><LI
  4707. ><P
  4708. >       tar
  4709.      </P
  4710. ></LI
  4711. ><LI
  4712. ><P
  4713. >       GNU sed
  4714.      </P
  4715. ></LI
  4716. ></UL
  4717. >
  4718.     In addition, you will need to install (and possibly compile) any
  4719.     additional software specific to your configuration, such as Oracle
  4720.     or MySQL.
  4721.   </P
  4722. ></DIV
  4723. ><DIV
  4724. CLASS="sect2"
  4725. ><HR><H3
  4726. CLASS="sect2"
  4727. ><A
  4728. NAME="install.unix.solaris.packages"
  4729. >Using Packages</A
  4730. ></H3
  4731. ><P
  4732. >    You can simplify the Solaris install process by using pkgadd to
  4733.    install most of your needed components. 
  4734.   </P
  4735. ></DIV
  4736. ></DIV
  4737. ><DIV
  4738. CLASS="sect1"
  4739. ><HR><H2
  4740. CLASS="sect1"
  4741. ><A
  4742. NAME="install.unix.apache"
  4743. >Apache 1.3.x on Unix systems</A
  4744. ></H2
  4745. ><P
  4746. >      This section contains notes and hints specific to Apache installs
  4747.      of PHP on Unix platforms. We also have <A
  4748. HREF="#install.unix.apache2"
  4749. >instructions and notes for Apache 2
  4750.      on a separate page</A
  4751. >.
  4752.     </P
  4753. ><P
  4754. >      You can select arguments to add to the
  4755.      <B
  4756. CLASS="command"
  4757. >configure</B
  4758. > on line 10 below from the <A
  4759. HREF="#configure"
  4760. >list of core configure options</A
  4761. > and
  4762.      from extension specific options described at the respective
  4763.      places in the manual. The version numbers have been omitted here, to
  4764.      ensure the instructions are not incorrect. You will need to replace
  4765.      the 'xxx' here with the correct values from your files.
  4766.     </P
  4767. ><TABLE
  4768. WIDTH="100%"
  4769. BORDER="0"
  4770. CELLPADDING="0"
  4771. CELLSPACING="0"
  4772. CLASS="EXAMPLE"
  4773. ><TR
  4774. ><TD
  4775. ><DIV
  4776. CLASS="example"
  4777. ><A
  4778. NAME="install.unix.apache.example"
  4779. ></A
  4780. ><P
  4781. ><B
  4782. >Beispiel 5-5. 
  4783.       Installation Instructions (Apache Shared Module Version) for PHP
  4784.      </B
  4785. ></P
  4786. ><TABLE
  4787. BORDER="0"
  4788. BGCOLOR="#E0E0E0"
  4789. CELLPADDING="5"
  4790. ><TR
  4791. ><TD
  4792. ><PRE
  4793. CLASS="screen"
  4794. >1.  gunzip apache_xxx.tar.gz
  4795. 2.  tar -xvf apache_xxx.tar
  4796. 3.  gunzip php-xxx.tar.gz
  4797. 4.  tar -xvf php-xxx.tar
  4798. 5.  cd apache_xxx
  4799. 6.  ./configure --prefix=/www --enable-module=so
  4800. 7.  make
  4801. 8.  make install
  4802. 9.  cd ../php-xxx
  4803.  
  4804. 10. Now, configure your PHP.  This is where you customize your PHP
  4805.     with various options, like which extensions will be enabled.  Do a
  4806.     ./configure --help for a list of available options.  In our example
  4807.     we'll do a simple configure with Apache 1 and MySQL support.  Your
  4808.     path to apxs may differ from our example.
  4809.  
  4810.       ./configure --with-mysql --with-apxs=/www/bin/apxs
  4811.  
  4812. 11. make
  4813. 12. make install
  4814.  
  4815.     If you decide to change your configure options after installation,
  4816.     you only need to repeat the last three steps. You only need to 
  4817.     restart apache for the new module to take effect. A recompile of
  4818.     Apache is not needed.
  4819.   
  4820.     Note that unless told otherwise, 'make install' will also install PEAR,
  4821.     various PHP tools such as phpize, install the PHP CLI, and more.
  4822.  
  4823. 13. Setup your php.ini file:
  4824.  
  4825.       cp php.ini-dist /usr/local/lib/php.ini
  4826.  
  4827.     You may edit your .ini file to set PHP options.  If you prefer your
  4828.     php.ini in another location, use --with-config-file-path=/some/path in
  4829.     step 10. 
  4830.     
  4831.     If you instead choose php.ini-recommended, be certain to read the list
  4832.     of changes within, as they affect how PHP behaves.
  4833.  
  4834. 14. Edit your httpd.conf to load the PHP module.  The path on the right hand
  4835.     side of the LoadModule statement must point to the path of the PHP
  4836.     module on your system.  The make install from above may have already
  4837.     added this for you, but be sure to check.
  4838.         
  4839.     For PHP 4:
  4840.             
  4841.       LoadModule php4_module libexec/libphp4.so
  4842.  
  4843.     For PHP 5:
  4844.                       
  4845.       LoadModule php5_module libexec/libphp5.so
  4846.       
  4847. 15. And in the AddModule section of httpd.conf, somewhere under the
  4848.     ClearModuleList, add this:
  4849.     
  4850.     For PHP 4:
  4851.     
  4852.       AddModule mod_php4.c
  4853.       
  4854.     For PHP 5:
  4855.     
  4856.       AddModule mod_php5.c
  4857.  
  4858. 16. Tell Apache to parse certain extensions as PHP.  For example,
  4859.     let's have Apache parse the .php extension as PHP.  You could
  4860.     have any extension(s) parse as PHP by simply adding more, with
  4861.     each separated by a space.  We'll add .phtml to demonstrate.
  4862.  
  4863.       AddType application/x-httpd-php .php .phtml
  4864.  
  4865.     It's also common to setup the .phps extension to show highlighted PHP
  4866.     source, this can be done with:
  4867.     
  4868.       AddType application/x-httpd-php-source .phps
  4869.  
  4870. 17. Use your normal procedure for starting the Apache server. (You must
  4871.     stop and restart the server, not just cause the server to reload by
  4872.     using a HUP or USR1 signal.)</PRE
  4873. ></TD
  4874. ></TR
  4875. ></TABLE
  4876. ></DIV
  4877. ></TD
  4878. ></TR
  4879. ></TABLE
  4880. ><P
  4881. >       Depending on your Apache install and Unix variant, there are many
  4882.       possible ways to stop and restart the server. Below are some typical
  4883.       lines used in restarting the server, for different apache/unix
  4884.       installations. You should replace <VAR
  4885. CLASS="literal"
  4886. >/path/to/</VAR
  4887. > with
  4888.       the path to these applications on your systems.
  4889.      </P
  4890. ><P
  4891. >       <TABLE
  4892. WIDTH="100%"
  4893. BORDER="0"
  4894. CELLPADDING="0"
  4895. CELLSPACING="0"
  4896. CLASS="EXAMPLE"
  4897. ><TR
  4898. ><TD
  4899. ><DIV
  4900. CLASS="example"
  4901. ><A
  4902. NAME="AEN726"
  4903. ></A
  4904. ><P
  4905. ><B
  4906. >Beispiel 5-6. Example commands for restarting Apache</B
  4907. ></P
  4908. ><TABLE
  4909. BORDER="0"
  4910. BGCOLOR="#E0E0E0"
  4911. CELLPADDING="5"
  4912. ><TR
  4913. ><TD
  4914. ><PRE
  4915. CLASS="shell"
  4916. >1. Several Linux and SysV variants:
  4917. /etc/rc.d/init.d/httpd restart
  4918.  
  4919. 2. Using apachectl scripts:
  4920. /path/to/apachectl stop
  4921. /path/to/apachectl start
  4922.  
  4923. 3. httpdctl and httpsdctl (Using OpenSSL), similar to apachectl:
  4924. /path/to/httpsdctl stop
  4925. /path/to/httpsdctl start
  4926.  
  4927. 4. Using mod_ssl, or another SSL server, you may want to manually
  4928. stop and start:
  4929. /path/to/apachectl stop
  4930. /path/to/apachectl startssl</PRE
  4931. ></TD
  4932. ></TR
  4933. ></TABLE
  4934. ></DIV
  4935. ></TD
  4936. ></TR
  4937. ></TABLE
  4938. >
  4939.      </P
  4940. ><P
  4941. >       The locations of the apachectl and http(s)dctl binaries often
  4942.       vary. If your system has <VAR
  4943. CLASS="literal"
  4944. >locate</VAR
  4945. > or
  4946.       <VAR
  4947. CLASS="literal"
  4948. >whereis</VAR
  4949. > or <VAR
  4950. CLASS="literal"
  4951. >which</VAR
  4952. > commands,
  4953.       these can assist you in finding your server control programs.
  4954.      </P
  4955. ><P
  4956. >       Different examples of compiling PHP for apache are as follows:
  4957.       <DIV
  4958. CLASS="informalexample"
  4959. ><P
  4960. ></P
  4961. ><A
  4962. NAME="AEN734"
  4963. ></A
  4964. ><TABLE
  4965. BORDER="0"
  4966. BGCOLOR="#E0E0E0"
  4967. CELLPADDING="5"
  4968. ><TR
  4969. ><TD
  4970. ><PRE
  4971. CLASS="shell"
  4972. >./configure --with-apxs --with-pgsql</PRE
  4973. ></TD
  4974. ></TR
  4975. ></TABLE
  4976. ><P
  4977. ></P
  4978. ></DIV
  4979. >
  4980.      </P
  4981. ><P
  4982. >       This will create a <TT
  4983. CLASS="filename"
  4984. >libphp4.so</TT
  4985. > shared
  4986.       library that is loaded into Apache using a LoadModule line in
  4987.       Apache's <TT
  4988. CLASS="filename"
  4989. >httpd.conf</TT
  4990. > file. The PostgreSQL
  4991.       support is embedded into this <TT
  4992. CLASS="filename"
  4993. >libphp4.so</TT
  4994. >
  4995.       library.
  4996.      </P
  4997. ><P
  4998. >       <DIV
  4999. CLASS="informalexample"
  5000. ><P
  5001. ></P
  5002. ><A
  5003. NAME="AEN741"
  5004. ></A
  5005. ><TABLE
  5006. BORDER="0"
  5007. BGCOLOR="#E0E0E0"
  5008. CELLPADDING="5"
  5009. ><TR
  5010. ><TD
  5011. ><PRE
  5012. CLASS="shell"
  5013. >./configure --with-apxs --with-pgsql=shared</PRE
  5014. ></TD
  5015. ></TR
  5016. ></TABLE
  5017. ><P
  5018. ></P
  5019. ></DIV
  5020. >
  5021.      </P
  5022. ><P
  5023. >       This will create a <TT
  5024. CLASS="filename"
  5025. >libphp4.so</TT
  5026. > shared
  5027.       library for Apache, but it will also create a
  5028.       <TT
  5029. CLASS="filename"
  5030. >pgsql.so</TT
  5031. > shared library that is loaded into
  5032.       PHP either by using the extension directive in
  5033.       <TT
  5034. CLASS="filename"
  5035. >php.ini</TT
  5036. > file or by loading it explicitly in
  5037.       a script using the <A
  5038. HREF="#function.dl"
  5039. ><B
  5040. CLASS="function"
  5041. >dl()</B
  5042. ></A
  5043. > function.
  5044.      </P
  5045. ><P
  5046. >       <DIV
  5047. CLASS="informalexample"
  5048. ><P
  5049. ></P
  5050. ><A
  5051. NAME="AEN749"
  5052. ></A
  5053. ><TABLE
  5054. BORDER="0"
  5055. BGCOLOR="#E0E0E0"
  5056. CELLPADDING="5"
  5057. ><TR
  5058. ><TD
  5059. ><PRE
  5060. CLASS="shell"
  5061. >./configure --with-apache=/path/to/apache_source --with-pgsql</PRE
  5062. ></TD
  5063. ></TR
  5064. ></TABLE
  5065. ><P
  5066. ></P
  5067. ></DIV
  5068. >
  5069.      </P
  5070. ><P
  5071. >       This will create a <TT
  5072. CLASS="filename"
  5073. >libmodphp4.a</TT
  5074. > library, a
  5075.       <TT
  5076. CLASS="filename"
  5077. >mod_php4.c</TT
  5078. > and some accompanying files and
  5079.       copy this into the <VAR
  5080. CLASS="literal"
  5081. >src/modules/php4</VAR
  5082. > directory
  5083.       in the Apache source tree. Then you compile Apache using
  5084.       <VAR
  5085. CLASS="literal"
  5086. >--activate-module=src/modules/php4/libphp4.a</VAR
  5087. >
  5088.       and the Apache build system will create
  5089.       <TT
  5090. CLASS="filename"
  5091. >libphp4.a</TT
  5092. > and link it statically into the
  5093.       <TT
  5094. CLASS="filename"
  5095. >httpd</TT
  5096. > binary. The PostgreSQL support is
  5097.       included directly into this <TT
  5098. CLASS="filename"
  5099. >httpd</TT
  5100. > binary,
  5101.       so the final result here is a single <TT
  5102. CLASS="filename"
  5103. >httpd</TT
  5104. >
  5105.       binary that includes all of Apache and all of PHP.
  5106.      </P
  5107. ><P
  5108. >       <DIV
  5109. CLASS="informalexample"
  5110. ><P
  5111. ></P
  5112. ><A
  5113. NAME="AEN761"
  5114. ></A
  5115. ><TABLE
  5116. BORDER="0"
  5117. BGCOLOR="#E0E0E0"
  5118. CELLPADDING="5"
  5119. ><TR
  5120. ><TD
  5121. ><PRE
  5122. CLASS="shell"
  5123. >./configure --with-apache=/path/to/apache_source --with-pgsql=shared</PRE
  5124. ></TD
  5125. ></TR
  5126. ></TABLE
  5127. ><P
  5128. ></P
  5129. ></DIV
  5130. >
  5131.      </P
  5132. ><P
  5133. >       Same as before, except instead of including PostgreSQL support
  5134.       directly into the final <TT
  5135. CLASS="filename"
  5136. >httpd</TT
  5137. > you will get
  5138.       a <TT
  5139. CLASS="filename"
  5140. >pgsql.so</TT
  5141. > shared library that you can load
  5142.       into PHP from either the <TT
  5143. CLASS="filename"
  5144. >php.ini</TT
  5145. > file or
  5146.       directly using <A
  5147. HREF="#function.dl"
  5148. ><B
  5149. CLASS="function"
  5150. >dl()</B
  5151. ></A
  5152. >.
  5153.      </P
  5154. ><P
  5155. >       When choosing to build PHP in different ways, you should consider
  5156.       the advantages and drawbacks of each method. Building as a shared
  5157.       object will mean that you can compile apache separately, and don't
  5158.       have to recompile everything as you add to, or change, PHP.
  5159.       Building PHP into apache (static method) means that PHP will
  5160.       load and run faster. For more information, see the Apache
  5161.       <A
  5162. HREF="http://httpd.apache.org/docs/dso.html"
  5163. TARGET="_top"
  5164. >webpage on DSO support</A
  5165. >.
  5166.      </P
  5167. ><DIV
  5168. CLASS="note"
  5169. ><BLOCKQUOTE
  5170. CLASS="note"
  5171. ><P
  5172. ><B
  5173. >Anmerkung: </B
  5174. >
  5175.       Apache's default <TT
  5176. CLASS="filename"
  5177. >httpd.conf</TT
  5178. > currently ships with a section that looks
  5179.       like this:
  5180.       <DIV
  5181. CLASS="informalexample"
  5182. ><P
  5183. ></P
  5184. ><A
  5185. NAME="AEN773"
  5186. ></A
  5187. ><TABLE
  5188. BORDER="0"
  5189. BGCOLOR="#E0E0E0"
  5190. CELLPADDING="5"
  5191. ><TR
  5192. ><TD
  5193. ><PRE
  5194. CLASS="apache-conf"
  5195. >User nobody
  5196. Group "#-1"</PRE
  5197. ></TD
  5198. ></TR
  5199. ></TABLE
  5200. ><P
  5201. ></P
  5202. ></DIV
  5203. >
  5204.       Unless you change that to "Group nogroup" or something like that ("Group daemon" is
  5205.       also very common) PHP will not be able to open files.
  5206.      </P
  5207. ></BLOCKQUOTE
  5208. ></DIV
  5209. ><DIV
  5210. CLASS="note"
  5211. ><BLOCKQUOTE
  5212. CLASS="note"
  5213. ><P
  5214. ><B
  5215. >Anmerkung: </B
  5216. >
  5217.       Make sure you specify the installed version of apxs when using
  5218.       <VAR
  5219. CLASS="option"
  5220. >--with-apxs=/path/to/apxs</VAR
  5221. >.
  5222.       You must NOT use the apxs version that is in the apache sources but the one
  5223.       that is actually installed on your system.
  5224.      </P
  5225. ></BLOCKQUOTE
  5226. ></DIV
  5227. ></DIV
  5228. ><DIV
  5229. CLASS="sect1"
  5230. ><HR><H2
  5231. CLASS="sect1"
  5232. ><A
  5233. NAME="install.unix.apache2"
  5234. >Apache 2.0 on Unix systems</A
  5235. ></H2
  5236. ><P
  5237. >      This section contains notes and hints specific to Apache 2.0 installs
  5238.      of PHP on Unix systems.
  5239.     </P
  5240. ><DIV
  5241. CLASS="warning"
  5242. ><P
  5243. ></P
  5244. ><TABLE
  5245. CLASS="warning"
  5246. BORDER="1"
  5247. WIDTH="100%"
  5248. ><TR
  5249. ><TD
  5250. ALIGN="CENTER"
  5251. ><B
  5252. >Warnung</B
  5253. ></TD
  5254. ></TR
  5255. ><TR
  5256. ><TD
  5257. ALIGN="LEFT"
  5258. ><P
  5259. >Verwenden Sie Apache 2.0.x und PHP
  5260. weder unter Unix noch Windows in einer Produktivumgebung. Fⁿr weitere
  5261. Informationen und Grⁿnde lesen Sie bitte diesen
  5262. <A
  5263. HREF="#faq.installation.apache2"
  5264. >FAQ Eintrag.</A
  5265. ></P
  5266. ></TD
  5267. ></TR
  5268. ></TABLE
  5269. ></DIV
  5270. ><P
  5271. >      You are highly encouraged to take a look at the
  5272.      <A
  5273. HREF="http://httpd.apache.org/docs-2.0/"
  5274. TARGET="_top"
  5275. >Apache Documentation</A
  5276. > to get
  5277.      a basic understanding of the Apache 2.0 Server.
  5278.     </P
  5279. ><DIV
  5280. CLASS="note"
  5281. ><BLOCKQUOTE
  5282. CLASS="note"
  5283. ><P
  5284. ><B
  5285. >PHP and Apache 2.0.x compatibility notes: </B
  5286. >
  5287.       The following versions of PHP are known to work with the most recent
  5288.       version of Apache 2.0.x:
  5289.       <P
  5290. ></P
  5291. ><UL
  5292. COMPACT="COMPACT"
  5293. ><LI
  5294. ><SPAN
  5295. >          PHP 4.3.0 or later available at
  5296.          <A
  5297. HREF="http://www.php.net/downloads.php"
  5298. TARGET="_top"
  5299. >http://www.php.net/downloads.php</A
  5300. >.
  5301.         </SPAN
  5302. ></LI
  5303. ><LI
  5304. ><SPAN
  5305. >          the latest stable development version.
  5306.          Get the source code <A
  5307. HREF="http://snaps.php.net/php4-latest.tar.gz"
  5308. TARGET="_top"
  5309. >          http://snaps.php.net/php4-latest.tar.gz</A
  5310. > or download binaries
  5311.          for Windows <A
  5312. HREF="http://snaps.php.net/win32/php4-win32-latest.zip"
  5313. TARGET="_top"
  5314. >          http://snaps.php.net/win32/php4-win32-latest.zip</A
  5315. >.
  5316.         </SPAN
  5317. ></LI
  5318. ><LI
  5319. ><SPAN
  5320. >          a prerelease version downloadable from
  5321.          <A
  5322. HREF="http://qa.php.net/"
  5323. TARGET="_top"
  5324. >http://qa.php.net/</A
  5325. >.
  5326.         </SPAN
  5327. ></LI
  5328. ><LI
  5329. ><SPAN
  5330. >          you have always the option to obtain PHP through
  5331.          <A
  5332. HREF="http://www.php.net/anoncvs.php"
  5333. TARGET="_top"
  5334. >anonymous CVS</A
  5335. >.
  5336.         </SPAN
  5337. ></LI
  5338. ></UL
  5339. >
  5340.       These versions of PHP are compatible to Apache 2.0.40 and later.
  5341.      </P
  5342. ><P
  5343. >       Apache 2.0 <VAR
  5344. CLASS="literal"
  5345. >SAPI</VAR
  5346. >-support started with PHP 4.2.0.
  5347.       PHP 4.2.3 works with Apache 2.0.39, don't use any other version of Apache with
  5348.       PHP 4.2.3. However, the recommended setup is to use PHP 4.3.0 or later with
  5349.       the most recent version of Apache2.
  5350.      </P
  5351. ><P
  5352. >       All mentioned versions of PHP will work still with
  5353.       Apache 1.3.x.
  5354.      </P
  5355. ></BLOCKQUOTE
  5356. ></DIV
  5357. ><P
  5358. >      Download the most recent version of <A
  5359. HREF="http://www.apache.org/"
  5360. TARGET="_top"
  5361. >      Apache 2.0</A
  5362. > and a fitting PHP version from the above mentioned places.
  5363.      This quick guide covers only the basics to get started with Apache 2.0
  5364.      and PHP. For more information read the
  5365.      <A
  5366. HREF="http://httpd.apache.org/docs-2.0/"
  5367. TARGET="_top"
  5368. >Apache Documentation</A
  5369. >.
  5370.      The version numbers have been omitted here, to ensure the
  5371.      instructions are not incorrect. You will need to replace the
  5372.      'NN' here with the correct values from your files.
  5373.     </P
  5374. ><TABLE
  5375. WIDTH="100%"
  5376. BORDER="0"
  5377. CELLPADDING="0"
  5378. CELLSPACING="0"
  5379. CLASS="EXAMPLE"
  5380. ><TR
  5381. ><TD
  5382. ><DIV
  5383. CLASS="example"
  5384. ><A
  5385. NAME="AEN809"
  5386. ></A
  5387. ><P
  5388. ><B
  5389. >Beispiel 5-7. 
  5390.       Installation Instructions (Apache 2 Shared Module Version)
  5391.      </B
  5392. ></P
  5393. ><TABLE
  5394. BORDER="0"
  5395. BGCOLOR="#E0E0E0"
  5396. CELLPADDING="5"
  5397. ><TR
  5398. ><TD
  5399. ><PRE
  5400. CLASS="screen"
  5401. >1.  gzip -d httpd-2_0_NN.tar.gz
  5402. 2.  tar xvf httpd-2_0_NN.tar
  5403. 3.  gunzip php-NN.tar.gz
  5404. 4.  tar -xvf php-NN.tar
  5405. 5.  cd httpd-2_0_NN
  5406. 6.  ./configure --enable-so
  5407. 7.  make
  5408. 8.  make install
  5409.  
  5410.     Now you have Apache 2.0.NN available under /usr/local/apache2,
  5411.     configured with loadable module support and the standard MPM prefork.
  5412.     To test the installation use your normal procedure for starting
  5413.     the Apache server, e.g.:
  5414.     /usr/local/apache2/bin/apachectl start
  5415.     and stop the server to go on with the configuration for PHP:
  5416.     /usr/local/apache2/bin/apachectl stop.
  5417.  
  5418. 9.  cd ../php-NN
  5419.  
  5420. 10. Now, configure your PHP.  This is where you customize your PHP
  5421.     with various options, like which extensions will be enabled.  Do a
  5422.     ./configure --help for a list of available options.  In our example
  5423.     we'll do a simple configure with Apache 2 and MySQL support.  Your
  5424.     path to apxs may differ, in fact, the binary may even be named apxs2 on
  5425.     your system. 
  5426.     
  5427.       ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
  5428.  
  5429. 11. make
  5430. 12. make install
  5431.  
  5432.     If you decide to change your configure options after installation,
  5433.     you only need to repeat the last three steps. You only need to
  5434.     restart apache for the new module to take effect. A recompile of
  5435.     Apache is not needed.
  5436.                 
  5437.     Note that unless told otherwise, 'make install' will also install PEAR,
  5438.     various PHP tools such as phpize, install the PHP CLI, and more.
  5439.     
  5440. 13. Setup your php.ini 
  5441.     
  5442.     cp php.ini-dist /usr/local/lib/php.ini
  5443.           
  5444.     You may edit your .ini file to set PHP options.  If you prefer having
  5445.     php.ini in another location, use --with-config-file-path=/some/path in
  5446.     step 10.
  5447.     
  5448.     If you instead choose php.ini-recommended, be certain to read the list
  5449.     of changes within, as they affect how PHP behaves.
  5450.  
  5451. 14. Edit your httpd.conf to load the PHP module.  The path on the right hand
  5452.     side of the LoadModule statement must point to the path of the PHP
  5453.     module on your system.  The make install from above may have already
  5454.     added this for you, but be sure to check.
  5455.  
  5456.     For PHP 4:
  5457.   
  5458.       LoadModule php4_module libexec/libphp4.so
  5459.       
  5460.     For PHP 5:
  5461.     
  5462.       LoadModule php5_module libexec/libphp5.so
  5463.  
  5464. 15. Tell Apache to parse certain extensions as PHP.  For example,
  5465.     let's have Apache parse the .php extension as PHP.  You could
  5466.     have any extension(s) parse as PHP by simply adding more, with
  5467.     each separated by a space.  We'll add .phtml to demonstrate.
  5468.             
  5469.       AddType application/x-httpd-php .php .phtml
  5470.                   
  5471.     It's also common to setup the .phps extension to show highlighted PHP
  5472.     source, this can be done with:
  5473.     
  5474.       AddType application/x-httpd-php-source .phps
  5475.  
  5476. 16. Use your normal procedure for starting the Apache server, e.g.:
  5477.    
  5478.       /usr/local/apache2/bin/apachectl start</PRE
  5479. ></TD
  5480. ></TR
  5481. ></TABLE
  5482. ></DIV
  5483. ></TD
  5484. ></TR
  5485. ></TABLE
  5486. ><P
  5487. >      Following the steps above you will have a running Apache 2.0 with
  5488.      support for PHP as <VAR
  5489. CLASS="literal"
  5490. >SAPI</VAR
  5491. > module.
  5492.      Of course there are many more configuration options available for both,
  5493.      Apache and PHP. For more information use
  5494.      <B
  5495. CLASS="command"
  5496. >./configure --help</B
  5497. > in the corresponding source
  5498.      tree. In case you wish to build a multithreaded version of Apache 2.0
  5499.      you must overwrite the standard MPM-Module <TT
  5500. CLASS="filename"
  5501. >prefork</TT
  5502. >
  5503.      either with <TT
  5504. CLASS="filename"
  5505. >worker</TT
  5506. > or <TT
  5507. CLASS="filename"
  5508. >perchild</TT
  5509. >.
  5510.      To do so append to your configure line in step 6 above either the option
  5511.      <VAR
  5512. CLASS="option"
  5513. >--with-mpm=worker</VAR
  5514. > or
  5515.      <VAR
  5516. CLASS="option"
  5517. >--with-mpm=perchild</VAR
  5518. >. Take care about
  5519.      the consequences and understand what you are doing. For more information
  5520.      read the Apache documentation about the <A
  5521. HREF="http://httpd.apache.org/docs-2.0/mpm.html"
  5522. TARGET="_top"
  5523. >      MPM-Modules</A
  5524. >.
  5525.     </P
  5526. ><DIV
  5527. CLASS="note"
  5528. ><BLOCKQUOTE
  5529. CLASS="note"
  5530. ><P
  5531. ><B
  5532. >Anmerkung: </B
  5533. >
  5534.       To build a multithreaded version of Apache your system must support threads.
  5535.       This also implies to build PHP with experimental
  5536.       Zend Thread Safety (ZTS). Therefore not all extensions might be available.
  5537.       The recommended setup is to build Apache with the standard
  5538.       <TT
  5539. CLASS="filename"
  5540. >prefork</TT
  5541. > MPM-Module.
  5542.      </P
  5543. ></BLOCKQUOTE
  5544. ></DIV
  5545. ></DIV
  5546. ><DIV
  5547. CLASS="sect1"
  5548. ><HR><H2
  5549. CLASS="sect1"
  5550. ><A
  5551. NAME="install.unix.caudium"
  5552. >Caudium</A
  5553. ></H2
  5554. ><P
  5555. >     PHP 4 can be built as a Pike module for the
  5556.     <A
  5557. HREF="http://caudium.net/"
  5558. TARGET="_top"
  5559. >Caudium webserver</A
  5560. >.
  5561.     Note that this is not supported with PHP 3. Follow the simple
  5562.     instructions below to install PHP 4 for Caudium.
  5563.    </P
  5564. ><TABLE
  5565. WIDTH="100%"
  5566. BORDER="0"
  5567. CELLPADDING="0"
  5568. CELLSPACING="0"
  5569. CLASS="EXAMPLE"
  5570. ><TR
  5571. ><TD
  5572. ><DIV
  5573. CLASS="example"
  5574. ><A
  5575. NAME="install.unix.caudium.instructions"
  5576. ></A
  5577. ><P
  5578. ><B
  5579. >Beispiel 5-8. Caudium Installation Instructions</B
  5580. ></P
  5581. ><TABLE
  5582. BORDER="0"
  5583. BGCOLOR="#E0E0E0"
  5584. CELLPADDING="5"
  5585. ><TR
  5586. ><TD
  5587. ><PRE
  5588. CLASS="screen"
  5589. >1.  Make sure you have Caudium installed prior to attempting to
  5590.     install PHP 4. For PHP 4 to work correctly, you will need Pike
  5591.     7.0.268 or newer. For the sake of this example we assume that
  5592.     Caudium is installed in /opt/caudium/server/.
  5593. 2.  Change directory to php-x.y.z (where x.y.z is the version number).
  5594. 3.  ./configure --with-caudium=/opt/caudium/server
  5595. 4.  make
  5596. 5.  make install
  5597. 6.  Restart Caudium if it's currently running.
  5598. 7.  Log into the graphical configuration interface and go to the
  5599.     virtual server where you want to add PHP 4 support.
  5600. 8.  Click Add Module and locate and then add the PHP 4 Script Support module.
  5601. 9.  If the documentation says that the 'PHP 4 interpreter isn't
  5602.     available', make sure that you restarted the server. If you did
  5603.     check /opt/caudium/logs/debug/default.1 for any errors related to
  5604.     <filename>PHP4.so</filename>. Also make sure that 
  5605.     <filename>caudium/server/lib/[pike-version]/PHP4.so</filename>
  5606.     is present.
  5607. 10. Configure the PHP Script Support module if needed.</PRE
  5608. ></TD
  5609. ></TR
  5610. ></TABLE
  5611. ></DIV
  5612. ></TD
  5613. ></TR
  5614. ></TABLE
  5615. ><P
  5616. >     You can of course compile your Caudium module with support for the
  5617.     various extensions available in PHP 4. See the reference pages
  5618.     for extension specific configure options.
  5619.    </P
  5620. ><DIV
  5621. CLASS="note"
  5622. ><BLOCKQUOTE
  5623. CLASS="note"
  5624. ><P
  5625. ><B
  5626. >Anmerkung: </B
  5627. >
  5628.      When compiling PHP 4 with MySQL support you must make sure that
  5629.      the normal MySQL client code is used. Otherwise there might be
  5630.      conflicts if your Pike already has MySQL support. You do this by
  5631.      specifying a MySQL install directory the 
  5632.      <VAR
  5633. CLASS="option"
  5634. >--with-mysql</VAR
  5635. > option.
  5636.     </P
  5637. ></BLOCKQUOTE
  5638. ></DIV
  5639. ></DIV
  5640. ><DIV
  5641. CLASS="sect1"
  5642. ><HR><H2
  5643. CLASS="sect1"
  5644. ><A
  5645. NAME="install.unix.fhttpd"
  5646. >fhttpd related notes</A
  5647. ></H2
  5648. ><P
  5649. >     To build PHP as an fhttpd module, answer "yes" to "Build as an
  5650.     fhttpd module?" (the <A
  5651. HREF="#configure.with-fhttpd"
  5652. >     --with-fhttpd</A
  5653. >=<VAR
  5654. CLASS="replaceable"
  5655. >DIR</VAR
  5656. >
  5657.     option to configure) and specify the fhttpd source base
  5658.     directory.  The default directory is <TT
  5659. CLASS="filename"
  5660. >/usr/local/src/fhttpd</TT
  5661. >. If you are
  5662.     running fhttpd, building PHP as a module will give better
  5663.     performance, more control and remote execution capability.
  5664.    </P
  5665. ><DIV
  5666. CLASS="note"
  5667. ><BLOCKQUOTE
  5668. CLASS="note"
  5669. ><P
  5670. ><B
  5671. >Anmerkung: </B
  5672. >
  5673.      Support for fhttpd is no longer available as of PHP 4.3.0.
  5674.     </P
  5675. ></BLOCKQUOTE
  5676. ></DIV
  5677. ></DIV
  5678. ><DIV
  5679. CLASS="sect1"
  5680. ><HR><H2
  5681. CLASS="sect1"
  5682. ><A
  5683. NAME="install.unix.sun"
  5684. >Sun, iPlanet and Netscape servers on Sun Solaris</A
  5685. ></H2
  5686. ><P
  5687. >      This section contains notes and hints specific to Sun Java System Web Server,
  5688.      Sun ONE Web Server, iPlanet and Netscape server installs of PHP on Sun Solaris.
  5689.     </P
  5690. ><P
  5691. >      From PHP 4.3.3 on you can use PHP scripts with the
  5692.      <A
  5693. HREF="#ref.nsapi"
  5694. >NSAPI module</A
  5695. > to 
  5696.      <A
  5697. HREF="#install.unix.sun.specialpages"
  5698. >generate custom directory
  5699.      listings and error pages</A
  5700. >. Additional functions for Apache
  5701.      compatibility are also available. For support in current webservers read
  5702.      the <A
  5703. HREF="#install.unix.sun.notes"
  5704. >note about subrequests</A
  5705. >.
  5706.     </P
  5707. ><P
  5708. >      You can find more information about setting up PHP for the Netscape
  5709.      Enterprise Server (NES) here:
  5710.      <A
  5711. HREF="http://benoit.noss.free.fr/php/install-php4.html"
  5712. TARGET="_top"
  5713. >http://benoit.noss.free.fr/php/install-php4.html</A
  5714. >
  5715.     </P
  5716. ><P
  5717. >      To build PHP with Sun JSWS/Sun ONE WS/iPlanet/Netscape webservers,
  5718.      enter the proper install directory for the
  5719.      <A
  5720. HREF="#configure.with-nsapi"
  5721. >--with-nsapi=[DIR]</A
  5722. >
  5723.      option. The default directory is usually
  5724.      <TT
  5725. CLASS="filename"
  5726. >/opt/netscape/suitespot/</TT
  5727. >.
  5728.      Please also read <TT
  5729. CLASS="filename"
  5730. >/php-xxx-version/sapi/nsapi/nsapi-readme.txt</TT
  5731. >.
  5732.     </P
  5733. ><P
  5734. >      <P
  5735. ></P
  5736. ><OL
  5737. TYPE="1"
  5738. ><LI
  5739. ><P
  5740. >         Install the following packages from <A
  5741. HREF="http://www.sunfreeware.com/"
  5742. TARGET="_top"
  5743. >         http://www.sunfreeware.com/</A
  5744. > or another download site:
  5745.         <P
  5746. ></P
  5747. ><TABLE
  5748. BORDER="0"
  5749. ><TBODY
  5750. ><TR
  5751. ><TD
  5752. ><TT
  5753. CLASS="filename"
  5754. >autoconf-2.13</TT
  5755. ></TD
  5756. ></TR
  5757. ><TR
  5758. ><TD
  5759. ><TT
  5760. CLASS="filename"
  5761. >automake-1.4</TT
  5762. ></TD
  5763. ></TR
  5764. ><TR
  5765. ><TD
  5766. ><TT
  5767. CLASS="filename"
  5768. >bison-1_25-sol26-sparc-local</TT
  5769. ></TD
  5770. ></TR
  5771. ><TR
  5772. ><TD
  5773. ><TT
  5774. CLASS="filename"
  5775. >flex-2_5_4a-sol26-sparc-local</TT
  5776. ></TD
  5777. ></TR
  5778. ><TR
  5779. ><TD
  5780. ><TT
  5781. CLASS="filename"
  5782. >gcc-2_95_2-sol26-sparc-local</TT
  5783. ></TD
  5784. ></TR
  5785. ><TR
  5786. ><TD
  5787. ><TT
  5788. CLASS="filename"
  5789. >gzip-1.2.4-sol26-sparc-local</TT
  5790. ></TD
  5791. ></TR
  5792. ><TR
  5793. ><TD
  5794. ><TT
  5795. CLASS="filename"
  5796. >m4-1_4-sol26-sparc-local</TT
  5797. ></TD
  5798. ></TR
  5799. ><TR
  5800. ><TD
  5801. ><TT
  5802. CLASS="filename"
  5803. >make-3_76_1-sol26-sparc-local</TT
  5804. ></TD
  5805. ></TR
  5806. ><TR
  5807. ><TD
  5808. >           <TT
  5809. CLASS="filename"
  5810. >mysql-3.23.24-beta</TT
  5811. > (if you want mysql support)
  5812.          </TD
  5813. ></TR
  5814. ><TR
  5815. ><TD
  5816. ><TT
  5817. CLASS="filename"
  5818. >perl-5_005_03-sol26-sparc-local</TT
  5819. ></TD
  5820. ></TR
  5821. ><TR
  5822. ><TD
  5823. ><TT
  5824. CLASS="filename"
  5825. >tar-1.13</TT
  5826. > (GNU tar)</TD
  5827. ></TR
  5828. ></TBODY
  5829. ></TABLE
  5830. ><P
  5831. ></P
  5832. >
  5833.        </P
  5834. ></LI
  5835. ><LI
  5836. ><P
  5837. >         Make sure your path includes the proper directories
  5838.         <VAR
  5839. CLASS="literal"
  5840. >PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin</VAR
  5841. >
  5842.         and make it available to your system <KBD
  5843. CLASS="userinput"
  5844. >export PATH</KBD
  5845. >.
  5846.        </P
  5847. ></LI
  5848. ><LI
  5849. ><P
  5850. >         <KBD
  5851. CLASS="userinput"
  5852. >gunzip php-x.x.x.tar.gz</KBD
  5853. > (if you have a .gz dist,
  5854.         otherwise go to 4).
  5855.        </P
  5856. ></LI
  5857. ><LI
  5858. ><P
  5859. >         <KBD
  5860. CLASS="userinput"
  5861. >tar xvf php-x.x.x.tar</KBD
  5862. >
  5863.        </P
  5864. ></LI
  5865. ><LI
  5866. ><P
  5867. >         Change to your extracted PHP directory:
  5868.         <KBD
  5869. CLASS="userinput"
  5870. >cd ../php-x.x.x </KBD
  5871. >
  5872.        </P
  5873. ></LI
  5874. ><LI
  5875. ><P
  5876. >         For the following step, make sure
  5877.         <TT
  5878. CLASS="filename"
  5879. >/opt/netscape/suitespot/</TT
  5880. > is
  5881.         where your netscape server is installed. Otherwise, change to the
  5882.         correct path and run:
  5883.         <TABLE
  5884. BORDER="0"
  5885. BGCOLOR="#E0E0E0"
  5886. CELLPADDING="5"
  5887. ><TR
  5888. ><TD
  5889. ><PRE
  5890. CLASS="shell"
  5891. >./configure --with-mysql=/usr/local/mysql \
  5892. --with-nsapi=/opt/netscape/suitespot/ \
  5893. --enable-libgcc</PRE
  5894. ></TD
  5895. ></TR
  5896. ></TABLE
  5897. >
  5898.        </P
  5899. ></LI
  5900. ><LI
  5901. ><P
  5902. >         Run <B
  5903. CLASS="command"
  5904. >make</B
  5905. > followed by <B
  5906. CLASS="command"
  5907. >make install</B
  5908. >.
  5909.        </P
  5910. ></LI
  5911. ></OL
  5912. >
  5913.     </P
  5914. ><P
  5915. >      After performing the base install and reading the appropriate readme file,
  5916.      you may need to perform some additional configuration steps.
  5917.     </P
  5918. ><DIV
  5919. CLASS="formalpara"
  5920. ><P
  5921. ><B
  5922. >Configuration Instructions for Sun/iPlanet/Netscape. </B
  5923. >
  5924.       Firstly you may need to add some paths to the <VAR
  5925. CLASS="varname"
  5926. >LD_LIBRARY_PATH</VAR
  5927. >
  5928.       environment for the server to find all the shared libs. This can best done
  5929.       in the start script for your webserver. The start script is often located
  5930.       in: <TT
  5931. CLASS="filename"
  5932. >/path/to/server/https-servername/start</TT
  5933. >.
  5934.       You may also need to edit the configuration files that are
  5935.       located in: <TT
  5936. CLASS="filename"
  5937. >/path/to/server/https-servername/config/</TT
  5938. >.
  5939.       <P
  5940. ></P
  5941. ><OL
  5942. TYPE="1"
  5943. ><LI
  5944. ><P
  5945. >          Add the following line to <TT
  5946. CLASS="filename"
  5947. >mime.types</TT
  5948. > (you can do
  5949.          that by the administration server):
  5950.          <TABLE
  5951. BORDER="0"
  5952. BGCOLOR="#E0E0E0"
  5953. CELLPADDING="5"
  5954. ><TR
  5955. ><TD
  5956. ><PRE
  5957. CLASS="screen"
  5958. >type=magnus-internal/x-httpd-php exts=php</PRE
  5959. ></TD
  5960. ></TR
  5961. ></TABLE
  5962. >
  5963.         </P
  5964. ></LI
  5965. ><LI
  5966. ><P
  5967. >          Edit <TT
  5968. CLASS="filename"
  5969. >magnus.conf</TT
  5970. > (for servers >= 6) or
  5971.          <TT
  5972. CLASS="filename"
  5973. >obj.conf</TT
  5974. > (for servers < 6) and add the following,
  5975.          shlib will vary depending on your system, it will be something like
  5976.          <TT
  5977. CLASS="filename"
  5978. >/opt/netscape/suitespot/bin/libphp4.so</TT
  5979. >. You should
  5980.          place the following lines after <VAR
  5981. CLASS="literal"
  5982. >mime types init</VAR
  5983. >.
  5984.          <TABLE
  5985. BORDER="0"
  5986. BGCOLOR="#E0E0E0"
  5987. CELLPADDING="5"
  5988. ><TR
  5989. ><TD
  5990. ><PRE
  5991. CLASS="programlisting"
  5992. >Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="/opt/netscape/suitespot/bin/libphp4.so"
  5993. Init fn="php4_init" LateInit="yes" errorString="Failed to initialize PHP!" [php_ini="/path/to/php.ini"]</PRE
  5994. ></TD
  5995. ></TR
  5996. ></TABLE
  5997. >
  5998.          (PHP >= 4.3.3) The <VAR
  5999. CLASS="literal"
  6000. >php_ini</VAR
  6001. > parameter is
  6002.          optional but with it you can place your <TT
  6003. CLASS="filename"
  6004. >php.ini</TT
  6005. > in your
  6006.          webserver config directory.
  6007.         </P
  6008. ></LI
  6009. ><LI
  6010. ><P
  6011. >          Configure the default object in <TT
  6012. CLASS="filename"
  6013. >obj.conf</TT
  6014. >
  6015.          (for virtual server classes [version 6.0+] in
  6016.          their <TT
  6017. CLASS="filename"
  6018. >vserver.obj.conf</TT
  6019. >):
  6020.          <TABLE
  6021. BORDER="0"
  6022. BGCOLOR="#E0E0E0"
  6023. CELLPADDING="5"
  6024. ><TR
  6025. ><TD
  6026. ><PRE
  6027. CLASS="programlisting"
  6028. ><Object name="default">
  6029. .
  6030. .
  6031. .
  6032. .#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines
  6033. Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]
  6034. .
  6035. .
  6036. </Object></PRE
  6037. ></TD
  6038. ></TR
  6039. ></TABLE
  6040. >
  6041.          (PHP >= 4.3.3) As additional parameters you can add some special
  6042.          <TT
  6043. CLASS="filename"
  6044. >php.ini</TT
  6045. >-values, for example you can set a
  6046.          <VAR
  6047. CLASS="literal"
  6048. >docroot="/path/to/docroot"</VAR
  6049. > specific
  6050.          to the context <VAR
  6051. CLASS="literal"
  6052. >php4_execute</VAR
  6053. > is called. For boolean
  6054.          ini-keys please use 0/1 as value, not
  6055.          <VAR
  6056. CLASS="literal"
  6057. >"On","Off",...</VAR
  6058. >
  6059.          (this will not work correctly), e.g.
  6060.          <VAR
  6061. CLASS="literal"
  6062. >zlib.output_compression=1</VAR
  6063. > instead of
  6064.          <VAR
  6065. CLASS="literal"
  6066. >zlib.output_compression="On"</VAR
  6067. >
  6068.         </P
  6069. ></LI
  6070. ><LI
  6071. ><P
  6072. >          This is only needed if you want to configure a directory that only consists of
  6073.          PHP scripts (same like a <TT
  6074. CLASS="filename"
  6075. >cgi-bin</TT
  6076. > directory):
  6077.          <TABLE
  6078. BORDER="0"
  6079. BGCOLOR="#E0E0E0"
  6080. CELLPADDING="5"
  6081. ><TR
  6082. ><TD
  6083. ><PRE
  6084. CLASS="programlisting"
  6085. ><Object name="x-httpd-php">
  6086. ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
  6087. Service fn=php4_execute [inikey=value inikey=value ...]
  6088. </Object></PRE
  6089. ></TD
  6090. ></TR
  6091. ></TABLE
  6092. >
  6093.          After that you can configure a directory in the Administration server and assign it
  6094.          the style <VAR
  6095. CLASS="literal"
  6096. >x-httpd-php</VAR
  6097. >. All files in it will get executed as PHP.
  6098.          This is nice to hide PHP usage by renaming files to <TT
  6099. CLASS="filename"
  6100. >.html</TT
  6101. >.
  6102.         </P
  6103. ></LI
  6104. ><LI
  6105. ><P
  6106. >          Setup of authentication: PHP authentication cannot be used with any
  6107.          other authentication. ALL AUTHENTICATION IS PASSED TO YOUR PHP SCRIPT.
  6108.          To configure PHP Authentication for the entire server, add the
  6109.          following line to your default object:
  6110.          <TABLE
  6111. BORDER="0"
  6112. BGCOLOR="#E0E0E0"
  6113. CELLPADDING="5"
  6114. ><TR
  6115. ><TD
  6116. ><PRE
  6117. CLASS="programlisting"
  6118. ><Object name="default">
  6119. AuthTrans fn=php4_auth_trans
  6120. .
  6121. .
  6122. .
  6123. </Object></PRE
  6124. ></TD
  6125. ></TR
  6126. ></TABLE
  6127. >
  6128.         </P
  6129. ></LI
  6130. ><LI
  6131. ><P
  6132. >          To use PHP Authentication on a single directory, add the following:
  6133.          <TABLE
  6134. BORDER="0"
  6135. BGCOLOR="#E0E0E0"
  6136. CELLPADDING="5"
  6137. ><TR
  6138. ><TD
  6139. ><PRE
  6140. CLASS="programlisting"
  6141. ><Object ppath="d:\path\to\authenticated\dir\*">
  6142. AuthTrans fn=php4_auth_trans
  6143. </Object></PRE
  6144. ></TD
  6145. ></TR
  6146. ></TABLE
  6147. >
  6148.         </P
  6149. ></LI
  6150. ></OL
  6151. >
  6152.      </P
  6153. ></DIV
  6154. ><DIV
  6155. CLASS="note"
  6156. ><BLOCKQUOTE
  6157. CLASS="note"
  6158. ><P
  6159. ><B
  6160. >Anmerkung: </B
  6161. >
  6162.       The stacksize that PHP uses depends on the configuration of the webserver. If you get
  6163.       crashes with very large PHP scripts, it is recommended to raise it with the Admin Server
  6164.       (in the section "MAGNUS EDITOR").
  6165.      </P
  6166. ></BLOCKQUOTE
  6167. ></DIV
  6168. ><DIV
  6169. CLASS="sect2"
  6170. ><HR><H3
  6171. CLASS="sect2"
  6172. ><A
  6173. NAME="install.unix.sun.phpini"
  6174. >CGI environment and recommended modifications in php.ini</A
  6175. ></H3
  6176. ><P
  6177. >      Important when writing PHP scripts is the fact that Sun JSWS/Sun ONE
  6178.      WS/iPlanet/Netscape is a multithreaded web server. Because of that all
  6179.      requests are running in the same process space (the space of the webserver
  6180.      itself) and this space has only one environment. If you want to get CGI
  6181.      variables like <VAR
  6182. CLASS="literal"
  6183. >PATH_INFO</VAR
  6184. >, <VAR
  6185. CLASS="literal"
  6186. >HTTP_HOST</VAR
  6187. >
  6188.      etc. it is not the correct way to try this in the old PHP 3.x way with
  6189.      <A
  6190. HREF="#function.getenv"
  6191. ><B
  6192. CLASS="function"
  6193. >getenv()</B
  6194. ></A
  6195. > or a similar way (register globals to
  6196.      environment, <VAR
  6197. CLASS="literal"
  6198. >$_ENV</VAR
  6199. >). You would only get the environment
  6200.      of the running webserver without any valid CGI variables!
  6201.     </P
  6202. ><DIV
  6203. CLASS="note"
  6204. ><BLOCKQUOTE
  6205. CLASS="note"
  6206. ><P
  6207. ><B
  6208. >Anmerkung: </B
  6209. >
  6210.       Why are there (invalid) CGI variables in the environment?
  6211.      </P
  6212. ><P
  6213. >       Answer: This is because you started the webserver process from the admin server
  6214.       which runs the startup script of the webserver, you wanted to start, as a CGI script
  6215.       (a CGI script inside of the admin server!). This is why the environment of
  6216.       the started webserver has some CGI environment variables in it. You can test
  6217.       this by starting the webserver not from the administration server. Use
  6218.       the command line as root user and start it manually - you will see
  6219.       there are no CGI-like environment variables.
  6220.      </P
  6221. ></BLOCKQUOTE
  6222. ></DIV
  6223. ><P
  6224. >      Simply change your scripts to get CGI variables in the correct way for
  6225.      PHP 4.x by using the superglobal <VAR
  6226. CLASS="literal"
  6227. >$_SERVER</VAR
  6228. >. If you have
  6229.      older scripts which use <VAR
  6230. CLASS="literal"
  6231. >$HTTP_HOST</VAR
  6232. >, etc., you should turn
  6233.      on <VAR
  6234. CLASS="literal"
  6235. >register_globals</VAR
  6236. > in <TT
  6237. CLASS="filename"
  6238. >php.ini</TT
  6239. > and change the variable
  6240.      order too (important: remove <VAR
  6241. CLASS="literal"
  6242. >"E"</VAR
  6243. > from it,
  6244.      because you do not need the environment here):
  6245.      <TABLE
  6246. BORDER="0"
  6247. BGCOLOR="#E0E0E0"
  6248. CELLPADDING="5"
  6249. ><TR
  6250. ><TD
  6251. ><PRE
  6252. CLASS="programlisting"
  6253. >variables_order = "GPCS"
  6254. register_globals = On</PRE
  6255. ></TD
  6256. ></TR
  6257. ></TABLE
  6258. >
  6259.     </P
  6260. ></DIV
  6261. ><DIV
  6262. CLASS="sect2"
  6263. ><HR><H3
  6264. CLASS="sect2"
  6265. ><A
  6266. NAME="install.unix.sun.specialpages"
  6267. >Special use for error pages or self-made directory listings (PHP >= 4.3.3)</A
  6268. ></H3
  6269. ><P
  6270. >      You can use PHP to generate the error pages for <VAR
  6271. CLASS="literal"
  6272. >"404 Not Found"</VAR
  6273. >
  6274.      or similar. Add the following line to the object in <TT
  6275. CLASS="filename"
  6276. >obj.conf</TT
  6277. > for
  6278.      every error page you want to overwrite:
  6279.      <TABLE
  6280. BORDER="0"
  6281. BGCOLOR="#E0E0E0"
  6282. CELLPADDING="5"
  6283. ><TR
  6284. ><TD
  6285. ><PRE
  6286. CLASS="programlisting"
  6287. >Error fn="php4_execute" code=XXX script="/path/to/script.php" [inikey=value inikey=value...]</PRE
  6288. ></TD
  6289. ></TR
  6290. ></TABLE
  6291. >
  6292.      where <VAR
  6293. CLASS="literal"
  6294. >XXX</VAR
  6295. > is the HTTP error code. Please delete
  6296.      any other <VAR
  6297. CLASS="literal"
  6298. >Error</VAR
  6299. > directives which could interfere with yours.
  6300.      If you want to place a page for all errors that could exist, leave
  6301.      the <VAR
  6302. CLASS="literal"
  6303. >code</VAR
  6304. > parameter out. Your script can get the HTTP status code
  6305.      with <VAR
  6306. CLASS="literal"
  6307. >$_SERVER['ERROR_TYPE']</VAR
  6308. >.
  6309.     </P
  6310. ><P
  6311. >      Another possibility is to generate self-made directory listings.
  6312.      Just create a PHP script which displays a directory listing and
  6313.      replace the corresponding default Service line for
  6314.      <VAR
  6315. CLASS="literal"
  6316. >type="magnus-internal/directory"</VAR
  6317. >
  6318.      in <TT
  6319. CLASS="filename"
  6320. >obj.conf</TT
  6321. > with the following:
  6322.      <TABLE
  6323. BORDER="0"
  6324. BGCOLOR="#E0E0E0"
  6325. CELLPADDING="5"
  6326. ><TR
  6327. ><TD
  6328. ><PRE
  6329. CLASS="programlisting"
  6330. >Service fn="php4_execute" type="magnus-internal/directory" script="/path/to/script.php" [inikey=value inikey=value...]</PRE
  6331. ></TD
  6332. ></TR
  6333. ></TABLE
  6334. >
  6335.      For both error and directory listing pages the original URI and
  6336.      translated URI are in the variables <VAR
  6337. CLASS="literal"
  6338. >$_SERVER['PATH_INFO']</VAR
  6339. > and
  6340.      <VAR
  6341. CLASS="literal"
  6342. >$_SERVER['PATH_TRANSLATED']</VAR
  6343. >.
  6344.     </P
  6345. ></DIV
  6346. ><DIV
  6347. CLASS="sect2"
  6348. ><HR><H3
  6349. CLASS="sect2"
  6350. ><A
  6351. NAME="install.unix.sun.notes"
  6352. >Note about <A
  6353. HREF="#function.nsapi-virtual"
  6354. ><B
  6355. CLASS="function"
  6356. >nsapi_virtual()</B
  6357. ></A
  6358. > and subrequests (PHP >= 4.3.3)</A
  6359. ></H3
  6360. ><P
  6361. >      The NSAPI module now supports the <A
  6362. HREF="#function.nsapi-virtual"
  6363. ><B
  6364. CLASS="function"
  6365. >nsapi_virtual()</B
  6366. ></A
  6367. > function
  6368.      (alias: <A
  6369. HREF="#function.virtual"
  6370. ><B
  6371. CLASS="function"
  6372. >virtual()</B
  6373. ></A
  6374. >)
  6375.      to make subrequests on the webserver and insert the result in the webpage.
  6376.      This function uses some undocumented features from the NSAPI library.
  6377.      On Unix the module automatically looks for the needed functions and uses
  6378.      them if available. If not, <A
  6379. HREF="#function.nsapi-virtual"
  6380. ><B
  6381. CLASS="function"
  6382. >nsapi_virtual()</B
  6383. ></A
  6384. > is disabled.
  6385.     </P
  6386. ><DIV
  6387. CLASS="note"
  6388. ><BLOCKQUOTE
  6389. CLASS="note"
  6390. ><P
  6391. ><B
  6392. >Anmerkung: </B
  6393. >
  6394.       But be warned: Support for <A
  6395. HREF="#function.nsapi-virtual"
  6396. ><B
  6397. CLASS="function"
  6398. >nsapi_virtual()</B
  6399. ></A
  6400. > is EXPERIMENTAL!!!
  6401.      </P
  6402. ></BLOCKQUOTE
  6403. ></DIV
  6404. ></DIV
  6405. ></DIV
  6406. ><DIV
  6407. CLASS="sect1"
  6408. ><HR><H2
  6409. CLASS="sect1"
  6410. ><A
  6411. NAME="install.unix.commandline"
  6412. >CGI and commandline setups</A
  6413. ></H2
  6414. ><P
  6415. >     The default is to build PHP as a CGI program.  This creates a
  6416.     commandline interpreter, which can be used for CGI processing, or
  6417.     for non-web-related PHP scripting.  If you are running a web
  6418.     server PHP has module support for, you should generally go for
  6419.     that solution for performance reasons.  However, the CGI version
  6420.     enables users to run different PHP-enabled pages under
  6421.     different user-ids.
  6422.    </P
  6423. ><DIV
  6424. CLASS="warning"
  6425. ><P
  6426. ></P
  6427. ><TABLE
  6428. CLASS="warning"
  6429. BORDER="1"
  6430. WIDTH="100%"
  6431. ><TR
  6432. ><TD
  6433. ALIGN="CENTER"
  6434. ><B
  6435. >Warnung</B
  6436. ></TD
  6437. ></TR
  6438. ><TR
  6439. ><TD
  6440. ALIGN="LEFT"
  6441. ><P
  6442. >By using the CGI setup, your server
  6443. is open to several possible attacks. Please read our
  6444. <A
  6445. HREF="#security.cgi-bin"
  6446. >CGI security section</A
  6447. > to learn how to
  6448. defend yourself from those attacks.</P
  6449. ></TD
  6450. ></TR
  6451. ></TABLE
  6452. ></DIV
  6453. ><P
  6454. >     As of PHP 4.3.0, some important additions have happened to PHP.  A new
  6455.     SAPI named CLI also exists and it has the same name as the CGI binary.
  6456.     What is installed at <VAR
  6457. CLASS="literal"
  6458. >{PREFIX}/bin/php</VAR
  6459. > depends on your
  6460.     configure line and this is described in detail in the manual section
  6461.     named <A
  6462. HREF="#features.commandline"
  6463. >Using PHP from the command
  6464.     line</A
  6465. >. For further details please read that section of the manual.
  6466.    </P
  6467. ><DIV
  6468. CLASS="sect2"
  6469. ><HR><H3
  6470. CLASS="sect2"
  6471. ><A
  6472. NAME="install.unix.commandline.testing"
  6473. >Testing</A
  6474. ></H3
  6475. ><P
  6476. >      If you have built PHP as a CGI program, you may test your build
  6477.      by typing <B
  6478. CLASS="command"
  6479. >make test</B
  6480. >.  It is always a good idea
  6481.      to test your build.  This way you may catch a problem with PHP on
  6482.      your platform early instead of having to struggle with it later.
  6483.     </P
  6484. ></DIV
  6485. ><DIV
  6486. CLASS="sect2"
  6487. ><HR><H3
  6488. CLASS="sect2"
  6489. ><A
  6490. NAME="install.unix.commandline.benchmarking"
  6491. >Benchmarking</A
  6492. ></H3
  6493. ><P
  6494. >      If you have built PHP 3 as a CGI program, you may benchmark your
  6495.      build by typing <B
  6496. CLASS="command"
  6497. >make bench</B
  6498. >. Note that if 
  6499.      <A
  6500. HREF="#ini.safe-mode"
  6501. >Safe Mode</A
  6502. > is on by default, the benchmark may not be able to finish if
  6503.      it takes longer then the 30 seconds allowed. This is because the
  6504.      <A
  6505. HREF="#function.set-time-limit"
  6506. ><B
  6507. CLASS="function"
  6508. >set_time_limit()</B
  6509. ></A
  6510. > can not be used in 
  6511.      <A
  6512. HREF="#ini.safe-mode"
  6513. >Safe Mode</A
  6514. >. Use the <A
  6515. HREF="#ini.max-execution-time"
  6516. >max_execution_time</A
  6517. >
  6518.      configuration setting to control this time for your own
  6519.      scripts. <B
  6520. CLASS="command"
  6521. >make bench</B
  6522. > ignores the <A
  6523. HREF="#configuration.file"
  6524. >configuration file</A
  6525. >.
  6526.     </P
  6527. ><DIV
  6528. CLASS="note"
  6529. ><BLOCKQUOTE
  6530. CLASS="note"
  6531. ><P
  6532. ><B
  6533. >Anmerkung: </B
  6534. >
  6535.         <B
  6536. CLASS="command"
  6537. >make bench</B
  6538. > is only available for PHP 3.
  6539.      </P
  6540. ></BLOCKQUOTE
  6541. ></DIV
  6542. ></DIV
  6543. ><DIV
  6544. CLASS="sect2"
  6545. ><HR><H3
  6546. CLASS="sect2"
  6547. ><A
  6548. NAME="install.unix.commandline.using-variables"
  6549. >Using Variables</A
  6550. ></H3
  6551. ><P
  6552. >       Some <A
  6553. HREF="#reserved.variables.server"
  6554. >server supplied
  6555.       environment variables</A
  6556. > are not defined in the 
  6557.       current <A
  6558. HREF="http://hoohoo.ncsa.uiuc.edu/cgi/env.html"
  6559. TARGET="_top"
  6560. >CGI/1.1 specification</A
  6561. >.
  6562.       Only the following variables are defined there: <VAR
  6563. CLASS="varname"
  6564. >AUTH_TYPE</VAR
  6565. >, 
  6566.       <VAR
  6567. CLASS="varname"
  6568. >CONTENT_LENGTH</VAR
  6569. >, <VAR
  6570. CLASS="varname"
  6571. >CONTENT_TYPE</VAR
  6572. >,
  6573.       <VAR
  6574. CLASS="varname"
  6575. >GATEWAY_INTERFACE</VAR
  6576. >, <VAR
  6577. CLASS="varname"
  6578. >PATH_INFO</VAR
  6579. >, 
  6580.       <VAR
  6581. CLASS="varname"
  6582. >PATH_TRANSLATED</VAR
  6583. >, <VAR
  6584. CLASS="varname"
  6585. >QUERY_STRING</VAR
  6586. >,
  6587.       <VAR
  6588. CLASS="varname"
  6589. >REMOTE_ADDR</VAR
  6590. >, <VAR
  6591. CLASS="varname"
  6592. >REMOTE_HOST</VAR
  6593. >, 
  6594.       <VAR
  6595. CLASS="varname"
  6596. >REMOTE_IDENT</VAR
  6597. >, <VAR
  6598. CLASS="varname"
  6599. >REMOTE_USER</VAR
  6600. >,
  6601.       <VAR
  6602. CLASS="varname"
  6603. >REQUEST_METHOD</VAR
  6604. >, <VAR
  6605. CLASS="varname"
  6606. >SCRIPT_NAME</VAR
  6607. >, 
  6608.       <VAR
  6609. CLASS="varname"
  6610. >SERVER_NAME</VAR
  6611. >, <VAR
  6612. CLASS="varname"
  6613. >SERVER_PORT</VAR
  6614. >,
  6615.       <VAR
  6616. CLASS="varname"
  6617. >SERVER_PROTOCOL</VAR
  6618. >, and <VAR
  6619. CLASS="varname"
  6620. >SERVER_SOFTWARE</VAR
  6621. >.
  6622.       Everything else should be treated as 'vendor extensions'.
  6623.     </P
  6624. ></DIV
  6625. ></DIV
  6626. ></DIV
  6627. ><DIV
  6628. CLASS="chapter"
  6629. ><HR><H1
  6630. ><A
  6631. NAME="install.windows"
  6632. >Kapitel 6. Installation on Windows systems</A
  6633. ></H1
  6634. ><P
  6635. >     This section applies to Windows 98/Me and Windows NT/2000/XP/2003. PHP 
  6636.     will not work on 16 bit platforms such as Windows 3.1 and sometimes 
  6637.     we refer to the supported Windows platforms as Win32. Windows 95
  6638.     is no longer supported as of PHP 4.3.0.
  6639.    </P
  6640. ><P
  6641. >     There are two main ways to install PHP for Windows: either
  6642.     <A
  6643. HREF="#install.windows.manual"
  6644. >manually</A
  6645. >
  6646.     or by using the <A
  6647. HREF="#install.windows.installer"
  6648. >installer</A
  6649. >.
  6650.    </P
  6651. ><P
  6652. >     If you have Microsoft Visual Studio, you can also 
  6653.     <A
  6654. HREF="#install.windows.build"
  6655. >build</A
  6656. >
  6657.     PHP from the original source code.
  6658.    </P
  6659. ><P
  6660. >     Once you have PHP installed on your Windows system, you may also
  6661.     want to <A
  6662. HREF="#install.windows.extensions"
  6663. >load various extensions</A
  6664. >
  6665.     for added functionality.
  6666.    </P
  6667. ><DIV
  6668. CLASS="warning"
  6669. ><P
  6670. ></P
  6671. ><TABLE
  6672. CLASS="warning"
  6673. BORDER="1"
  6674. WIDTH="100%"
  6675. ><TR
  6676. ><TD
  6677. ALIGN="CENTER"
  6678. ><B
  6679. >Warnung</B
  6680. ></TD
  6681. ></TR
  6682. ><TR
  6683. ><TD
  6684. ALIGN="LEFT"
  6685. ><P
  6686. >      There are several all-in-one installers over the Internet, but none of
  6687.      those are endorsed by PHP.net, as we believe that the manual installation
  6688.      is the best choice to have your system secure and optimised.
  6689.     </P
  6690. ></TD
  6691. ></TR
  6692. ></TABLE
  6693. ></DIV
  6694. ><DIV
  6695. CLASS="sect1"
  6696. ><HR><H2
  6697. CLASS="sect1"
  6698. ><A
  6699. NAME="install.windows.installer"
  6700. >Windows Installer</A
  6701. ></H2
  6702. ><P
  6703. >      The Windows PHP installer is available from the downloads page at
  6704.      <A
  6705. HREF="http://www.php.net/downloads.php"
  6706. TARGET="_top"
  6707. >http://www.php.net/downloads.php</A
  6708. >. This
  6709.      installs the <SPAN
  6710. CLASS="emphasis"
  6711. ><I
  6712. CLASS="emphasis"
  6713. >CGI version</I
  6714. ></SPAN
  6715. > of PHP and for IIS, PWS,
  6716.      and Xitami, it configures the web server as well.  The installer does not 
  6717.      include any extra external PHP extensions (php_*.dll) as you'll only find 
  6718.      those in the Windows Zip Package and <ACRONYM
  6719. CLASS="acronym"
  6720. >PECL</ACRONYM
  6721. > downloads.
  6722.     </P
  6723. ><DIV
  6724. CLASS="note"
  6725. ><BLOCKQUOTE
  6726. CLASS="note"
  6727. ><P
  6728. ><B
  6729. >Anmerkung: </B
  6730. >
  6731.       While the Windows installer is an easy way to make PHP work, it is 
  6732.       restricted in many aspects as, for example, the automatic setup of 
  6733.       extensions is not supported.  Use of the installer isn't the preferred 
  6734.       method for installing PHP.
  6735.      </P
  6736. ></BLOCKQUOTE
  6737. ></DIV
  6738. ><P
  6739. >      First, install your selected <ACRONYM
  6740. CLASS="acronym"
  6741. >HTTP</ACRONYM
  6742. > (web) server on your 
  6743.      system, and make sure that it works.
  6744.     </P
  6745. ><P
  6746. >      Run the executable installer and follow the instructions provided by the
  6747.      installation wizard. Two types of installation are supported - standard,
  6748.      which provides sensible defaults for all the settings it can, and advanced,
  6749.      which asks questions as it goes along.
  6750.     </P
  6751. ><P
  6752. >      The installation wizard gathers enough information to set up the <TT
  6753. CLASS="filename"
  6754. >php.ini</TT
  6755. >
  6756.      file, and configure certain web servers to use PHP.  With IIS or PWS on 
  6757.      a NT Workstation, a list of all the nodes on the server with script map 
  6758.      settings is displayed, and you can choose those nodes to which you wish 
  6759.      to add the PHP script mappings.  One of the web servers the PHP installer 
  6760.      does not configure for is Apache, so you'll need to configure it
  6761.      manually.
  6762.     </P
  6763. ><P
  6764. >      Once the installation has completed, the installer will inform you if you
  6765.      need to restart your system, restart the server, or just start using PHP.
  6766.     </P
  6767. ><DIV
  6768. CLASS="warning"
  6769. ><P
  6770. ></P
  6771. ><TABLE
  6772. CLASS="warning"
  6773. BORDER="1"
  6774. WIDTH="100%"
  6775. ><TR
  6776. ><TD
  6777. ALIGN="CENTER"
  6778. ><B
  6779. >Warnung</B
  6780. ></TD
  6781. ></TR
  6782. ><TR
  6783. ><TD
  6784. ALIGN="LEFT"
  6785. ><P
  6786. >       Be aware, that this setup of PHP is not secure. If you would like to have
  6787.       a secure PHP setup, you'd better go on the manual way, and set every
  6788.       option carefully. This automatically working setup gives you an instantly
  6789.       working PHP installation, but it is not meant to be used on online servers.
  6790.      </P
  6791. ></TD
  6792. ></TR
  6793. ></TABLE
  6794. ></DIV
  6795. ></DIV
  6796. ><DIV
  6797. CLASS="sect1"
  6798. ><HR><H2
  6799. CLASS="sect1"
  6800. ><A
  6801. NAME="install.windows.manual"
  6802. >Manual Installation Steps</A
  6803. ></H2
  6804. ><P
  6805. >      This install guide will help you manually install and configure PHP with
  6806.      a web server on Microsoft Windows.  To get started you'll need to download 
  6807.      the zip binary distribution from the downloads page at
  6808.      <A
  6809. HREF="http://www.php.net/downloads.php"
  6810. TARGET="_top"
  6811. >http://www.php.net/downloads.php</A
  6812. >.
  6813.     </P
  6814. ><P
  6815. >      Although there are many all-in-one installation kits, and we also 
  6816.      distribute a PHP installer for Microsoft Windows, we recommend you take 
  6817.      the time to setup PHP yourself as this will provide you with a better 
  6818.      understanding of the system, and enables you to install PHP extensions 
  6819.      easily when needed.
  6820.     </P
  6821. ><DIV
  6822. CLASS="note"
  6823. ><BLOCKQUOTE
  6824. CLASS="note"
  6825. ><A
  6826. NAME="install.windows.manual.upgrade"
  6827. ></A
  6828. ><P
  6829. ><B
  6830. >Upgrading from a previous PHP version: </B
  6831. >
  6832.       Previous editions of the manual suggest moving various ini and 
  6833.       <ACRONYM
  6834. CLASS="acronym"
  6835. >DLL</ACRONYM
  6836. > files into your SYSTEM (i.e. 
  6837.       <TT
  6838. CLASS="filename"
  6839. >C:\WINDOWS</TT
  6840. >) folder and while this 
  6841.       simplifies the installation procedure it makes upgrading difficult.  We 
  6842.       advise you remove all of these files (like <TT
  6843. CLASS="filename"
  6844. >php.ini</TT
  6845. > and PHP related
  6846.       DLLs from the Windows SYSTEM folder) before moving on with a new 
  6847.       PHP installation.  Be sure to backup these files as you might break the
  6848.       entire system.  The old <TT
  6849. CLASS="filename"
  6850. >php.ini</TT
  6851. > might be useful in setting up the new
  6852.       PHP as well.  And as you'll soon learn, the preferred method for 
  6853.       installing PHP is to keep all PHP related files in one directory and
  6854.       have this directory available to your systems PATH.
  6855.      </P
  6856. ></BLOCKQUOTE
  6857. ></DIV
  6858. ><DIV
  6859. CLASS="note"
  6860. ><BLOCKQUOTE
  6861. CLASS="note"
  6862. ><P
  6863. ><B
  6864. >MDAC requirements: </B
  6865. >
  6866.       If you use Microsoft <SPAN
  6867. CLASS="emphasis"
  6868. ><I
  6869. CLASS="emphasis"
  6870. >Windows 98/NT4</I
  6871. ></SPAN
  6872. > download the
  6873.       latest version of the Microsoft Data Access Components (MDAC) for your
  6874.       platform. MDAC is available at <A
  6875. HREF="http://msdn.microsoft.com/data/"
  6876. TARGET="_top"
  6877. >http://msdn.microsoft.com/data/</A
  6878. >.
  6879.       This requirement exists because <A
  6880. HREF="#ref.uodbc"
  6881. >ODBC</A
  6882. > is
  6883.       built into the distributed Windows binaries.
  6884.      </P
  6885. ></BLOCKQUOTE
  6886. ></DIV
  6887. ><P
  6888. >      The following steps should be completed on all installations before any
  6889.      server specific instructions are performed:
  6890.     </P
  6891. ><P
  6892. >      Extract the distribution file into a directory of your choice. If you
  6893.      are installing PHP 4, extract to <TT
  6894. CLASS="filename"
  6895. >C:\</TT
  6896. >, as the zip file expands to a
  6897.      foldername like <TT
  6898. CLASS="filename"
  6899. >php-4.3.7-Win32</TT
  6900. >. If you are
  6901.      installing PHP 5, extract to <TT
  6902. CLASS="filename"
  6903. >C:\php</TT
  6904. > as the zip file doesn't expand as in
  6905.      PHP 4. You may choose a different location but do not have spaces in the
  6906.      path (like <TT
  6907. CLASS="filename"
  6908. >C:\Program Files\PHP</TT
  6909. >)
  6910.      as some web servers will crash if you do.
  6911.     </P
  6912. ><P
  6913. >      The directory structure extracted from the zip is different for PHP 
  6914.      versions 4 and 5 and look like as follows:
  6915.     </P
  6916. ><TABLE
  6917. WIDTH="100%"
  6918. BORDER="0"
  6919. CELLPADDING="0"
  6920. CELLSPACING="0"
  6921. CLASS="EXAMPLE"
  6922. ><TR
  6923. ><TD
  6924. ><DIV
  6925. CLASS="example"
  6926. ><A
  6927. NAME="AEN1095"
  6928. ></A
  6929. ><P
  6930. ><B
  6931. >Beispiel 6-1. PHP 4 package structure</B
  6932. ></P
  6933. ><TABLE
  6934. BORDER="0"
  6935. BGCOLOR="#E0E0E0"
  6936. CELLPADDING="5"
  6937. ><TR
  6938. ><TD
  6939. ><PRE
  6940. CLASS="programlisting"
  6941. >c:\php
  6942.    |
  6943.    +--cli
  6944.    |  |
  6945.    |  |-php.exe           -- CLI executable - ONLY for commandline scripting
  6946.    |
  6947.    +--dlls                -- support DLLs required by some extensions
  6948.    |  |
  6949.    |  |-expat.dll
  6950.    |  |
  6951.    |  |-fdftk.dll
  6952.    |  |
  6953.    |  |-...
  6954.    |
  6955.    +--extensions          -- extension DLLs for PHP
  6956.    |  |
  6957.    |  |-php_bz2.dll
  6958.    |  |
  6959.    |  |-php_cpdf.dll
  6960.    |  |
  6961.    |  |-..
  6962.    |
  6963.    +--mibs                -- support files for SNMP
  6964.    |
  6965.    +--openssl             -- support files for Openssl
  6966.    |
  6967.    +--pdf-related         -- support files for PDF
  6968.    |
  6969.    +--sapi                -- SAPI (server module support) DLLs
  6970.    |  |
  6971.    |  |-php4activescript.dll
  6972.    |  |
  6973.    |  |-php4apache.dll
  6974.    |  |
  6975.    |  |-php4apache2.dll
  6976.    |  |
  6977.    |  |-..
  6978.    |
  6979.    +--PEAR                -- initial copy of PEAR
  6980.    |
  6981.    |
  6982.    |-go-pear.bat          -- PEAR setup script
  6983.    |
  6984.    |-..
  6985.    |
  6986.    |-php.exe              -- CGI executable
  6987.    |
  6988.    |-..
  6989.    |
  6990.    |-php.ini-dist         -- default php.ini settings
  6991.    |
  6992.    |-php.ini-recommended  -- recommended php.ini settings
  6993.    | 
  6994.    |-php4ts.dll           -- core PHP DLL
  6995.    | 
  6996.    |-...</PRE
  6997. ></TD
  6998. ></TR
  6999. ></TABLE
  7000. ></DIV
  7001. ></TD
  7002. ></TR
  7003. ></TABLE
  7004. ><P
  7005. >     Or:
  7006.     </P
  7007. ><TABLE
  7008. WIDTH="100%"
  7009. BORDER="0"
  7010. CELLPADDING="0"
  7011. CELLSPACING="0"
  7012. CLASS="EXAMPLE"
  7013. ><TR
  7014. ><TD
  7015. ><DIV
  7016. CLASS="example"
  7017. ><A
  7018. NAME="AEN1099"
  7019. ></A
  7020. ><P
  7021. ><B
  7022. >Beispiel 6-2. PHP 5 package structure</B
  7023. ></P
  7024. ><TABLE
  7025. BORDER="0"
  7026. BGCOLOR="#E0E0E0"
  7027. CELLPADDING="5"
  7028. ><TR
  7029. ><TD
  7030. ><PRE
  7031. CLASS="programlisting"
  7032. >c:\php
  7033.    |
  7034.    +--dev
  7035.    |  |
  7036.    |  |-php5ts.lib
  7037.    |
  7038.    +--ext                 -- extension DLLs for PHP
  7039.    |  |
  7040.    |  |-php_bz2.dll
  7041.    |  |
  7042.    |  |-php_cpdf.dll
  7043.    |  |
  7044.    |  |-..
  7045.    |
  7046.    +--extras
  7047.    |  |
  7048.    |  +--mibs             -- support files for SNMP
  7049.    |  |
  7050.    |  +--openssl          -- support files for Openssl
  7051.    |  |
  7052.    |  +--pdf-related      -- support files for PDF
  7053.    |  |
  7054.    |  |-mime.magic
  7055.    |
  7056.    +--pear                -- initial copy of PEAR
  7057.    |
  7058.    |
  7059.    |-go-pear.bat          -- PEAR setup script
  7060.    |
  7061.    |-fdftk.dll
  7062.    |
  7063.    |-..
  7064.    |
  7065.    |-php-cgi.exe          -- CGI executable
  7066.    |
  7067.    |-php-win.exe          -- executes scripts without an opened command prompt
  7068.    |
  7069.    |-php.exe              -- CLI executable - ONLY for command line scripting
  7070.    |
  7071.    |-..
  7072.    |
  7073.    |-php.ini-dist         -- default php.ini settings
  7074.    |
  7075.    |-php.ini-recommended  -- recommended php.ini settings
  7076.    | 
  7077.    |-php5activescript.dll
  7078.    |
  7079.    |-php5apache.dll
  7080.    |
  7081.    |-php5apache2.dll
  7082.    |
  7083.    |-..
  7084.    |
  7085.    |-php5ts.dll           -- core PHP DLL
  7086.    | 
  7087.    |-...</PRE
  7088. ></TD
  7089. ></TR
  7090. ></TABLE
  7091. ></DIV
  7092. ></TD
  7093. ></TR
  7094. ></TABLE
  7095. ><P
  7096. >      Notice the differences and similarities.  Both PHP 4 and PHP 5 have a 
  7097.      <ACRONYM
  7098. CLASS="acronym"
  7099. >CGI</ACRONYM
  7100. > executable, a <ACRONYM
  7101. CLASS="acronym"
  7102. >CLI</ACRONYM
  7103. > executable,
  7104.      and server modules, but they are located in different folders and/or have
  7105.      different names.  While PHP 4 packages have the server modules in the 
  7106.      <TT
  7107. CLASS="filename"
  7108. >sapi</TT
  7109. > folder, PHP 5 
  7110.      distributions have no such directory and instead they're in the PHP
  7111.      folder root. The supporting DLLs for the PHP 5 extensions are also not
  7112.      in a seperate directory.
  7113.     </P
  7114. ><DIV
  7115. CLASS="note"
  7116. ><BLOCKQUOTE
  7117. CLASS="note"
  7118. ><P
  7119. ><B
  7120. >Anmerkung: </B
  7121. >
  7122.       In PHP 4, you should move all files located in the <TT
  7123. CLASS="filename"
  7124. >dll</TT
  7125. > and <TT
  7126. CLASS="filename"
  7127. >sapi</TT
  7128. > folders to the main folder (e.g.
  7129.       <TT
  7130. CLASS="filename"
  7131. >C:\php</TT
  7132. >).
  7133.      </P
  7134. ></BLOCKQUOTE
  7135. ></DIV
  7136. ><P
  7137. >      Here is a list of server modules shipped with PHP 4 and PHP 5:
  7138.      <P
  7139. ></P
  7140. ><UL
  7141. ><LI
  7142. ><P
  7143. >        <TT
  7144. CLASS="filename"
  7145. >sapi/php4activescript.dll (php5activescript.dll)</TT
  7146. >
  7147.        - <A
  7148. HREF="#install.windows.activescript"
  7149. >ActiveScript
  7150.         engine</A
  7151. >, allowing you to embed PHP in your Windows
  7152.        applications.
  7153.       </P
  7154. ></LI
  7155. ><LI
  7156. ><P
  7157. >        <TT
  7158. CLASS="filename"
  7159. >sapi/php4apache.dll (php5apache.dll)</TT
  7160. > - Apache 1.3.x module.
  7161.       </P
  7162. ></LI
  7163. ><LI
  7164. ><P
  7165. >        <TT
  7166. CLASS="filename"
  7167. >sapi/php4apache2.dll (php5apache2.dll)</TT
  7168. > - Apache 2.0.x module.
  7169.       </P
  7170. ></LI
  7171. ><LI
  7172. ><P
  7173. >        <TT
  7174. CLASS="filename"
  7175. >sapi/php4isapi.dll (php5isapi.dll)</TT
  7176. > - ISAPI Module
  7177.        for ISAPI compliant web servers like IIS 4.0/PWS 4.0 or newer.
  7178.       </P
  7179. ></LI
  7180. ><LI
  7181. ><P
  7182. >        <TT
  7183. CLASS="filename"
  7184. >sapi/php4nsapi.dll (php5nsapi.dll)</TT
  7185. > - Sun/iPlanet/Netscape
  7186.        server module.
  7187.       </P
  7188. ></LI
  7189. ><LI
  7190. ><P
  7191. >        <TT
  7192. CLASS="filename"
  7193. >sapi/php4pi3web.dll (no equivalent in PHP 5)</TT
  7194. > - Pi3Web server module.
  7195.       </P
  7196. ></LI
  7197. ></UL
  7198. >
  7199.     </P
  7200. ><P
  7201. >      Server modules provide significantly better performance and additional 
  7202.      functionality compared to the CGI binary. The CLI version is designed to
  7203.      let you use PHP for command line scripting. More information about CLI is
  7204.      available in the chapter about <A
  7205. HREF="#features.commandline"
  7206. >using
  7207.      PHP from the command line</A
  7208. >.
  7209.     </P
  7210. ><DIV
  7211. CLASS="warning"
  7212. ><P
  7213. ></P
  7214. ><TABLE
  7215. CLASS="warning"
  7216. BORDER="1"
  7217. WIDTH="100%"
  7218. ><TR
  7219. ><TD
  7220. ALIGN="CENTER"
  7221. ><B
  7222. >Warnung</B
  7223. ></TD
  7224. ></TR
  7225. ><TR
  7226. ><TD
  7227. ALIGN="LEFT"
  7228. ><P
  7229. >       The SAPI modules have been significantly improved as of the 4.1 release,
  7230.       however, in older systems you may encounter server errors or other
  7231.       server modules failing, such as ASP.
  7232.      </P
  7233. ></TD
  7234. ></TR
  7235. ></TABLE
  7236. ></DIV
  7237. ><P
  7238. >      The CGI and CLI binaries, and the web server modules all require the
  7239.      <TT
  7240. CLASS="filename"
  7241. >php4ts.dll</TT
  7242. > (<TT
  7243. CLASS="filename"
  7244. >php5ts.dll</TT
  7245. >) file to
  7246.      be available to them. You have to make sure that this file can be found
  7247.      by your PHP installation. The search order for this DLL is as follows:
  7248.      <P
  7249. ></P
  7250. ><UL
  7251. ><LI
  7252. ><P
  7253. >         The same directory from where <TT
  7254. CLASS="filename"
  7255. >php.exe</TT
  7256. > is called,
  7257.         or in case you use a SAPI module, the web server's directory (e.g.
  7258.         <TT
  7259. CLASS="filename"
  7260. >C:\Program Files\Apache Group\Apache2\bin</TT
  7261. >).
  7262.        </P
  7263. ></LI
  7264. ><LI
  7265. ><P
  7266. >         Any directory in your Windows <VAR
  7267. CLASS="varname"
  7268. >PATH</VAR
  7269. > environment
  7270.         variable.
  7271.        </P
  7272. ></LI
  7273. ></UL
  7274. >
  7275.     </P
  7276. ><P
  7277. >      To make <TT
  7278. CLASS="filename"
  7279. >php4ts.dll</TT
  7280. > / <TT
  7281. CLASS="filename"
  7282. >php5ts.dll</TT
  7283. >
  7284.      available you have three options: copy the file to the Windows system
  7285.      directory, copy the file to the web server's directory, or add your PHP
  7286.      directory, <TT
  7287. CLASS="filename"
  7288. >C:\php</TT
  7289. > to the
  7290.      <VAR
  7291. CLASS="varname"
  7292. >PATH</VAR
  7293. >. For better maintenance, we advise you to follow
  7294.      the last option, add <TT
  7295. CLASS="filename"
  7296. >C:\php</TT
  7297. > to the
  7298.      <VAR
  7299. CLASS="varname"
  7300. >PATH</VAR
  7301. >, because it will be simpler to upgrade PHP in the
  7302.      future. Read more about how to add your PHP directory to
  7303.      <VAR
  7304. CLASS="varname"
  7305. >PATH</VAR
  7306. > in the <A
  7307. HREF="#faq.installation.addtopath"
  7308. >corresponding FAQ entry</A
  7309. >.
  7310.     </P
  7311. ><P
  7312. >      The next step is to set up a valid configuration file for PHP, <TT
  7313. CLASS="filename"
  7314. >php.ini</TT
  7315. >.
  7316.      There are two ini files distributed in the zip file,
  7317.      <TT
  7318. CLASS="filename"
  7319. >php.ini-dist</TT
  7320. > and
  7321.      <TT
  7322. CLASS="filename"
  7323. >php.ini-recommended</TT
  7324. >. We advise you to use
  7325.      <TT
  7326. CLASS="filename"
  7327. >php.ini-recommended</TT
  7328. >, because we optimized the
  7329.      default settings in this file for performance, and security. Read this
  7330.      well documented file carefully because it has changes from
  7331.      <TT
  7332. CLASS="filename"
  7333. >php.ini-dist</TT
  7334. > that will drastically affect your 
  7335.      setup.  Some examples are <A
  7336. HREF="#ini.display-errors"
  7337. >      display_errors</A
  7338. > being <VAR
  7339. CLASS="literal"
  7340. >off</VAR
  7341. > and 
  7342.      <A
  7343. HREF="#ini.magic-quotes-gpc"
  7344. >magic_quotes_gpc</A
  7345. > being
  7346.      <VAR
  7347. CLASS="literal"
  7348. >off</VAR
  7349. >.  In addition to reading these, study the <A
  7350. HREF="#configuration.file"
  7351. >ini settings</A
  7352. > and set every element
  7353.      manually yourself. If you would like to achieve the best security, then
  7354.      this is the way for you, although PHP works fine with these default ini
  7355.      files. Copy your chosen ini-file to a directory that PHP is able to find
  7356.      and rename it to <TT
  7357. CLASS="filename"
  7358. >php.ini</TT
  7359. >. PHP searches for <TT
  7360. CLASS="filename"
  7361. >php.ini</TT
  7362. > in the following
  7363.      locations (in order):
  7364.      <P
  7365. ></P
  7366. ><UL
  7367. ><LI
  7368. ><P
  7369. >         PHPIniDir directive (Apache 2 module only)
  7370.        </P
  7371. ></LI
  7372. ><LI
  7373. ><P
  7374. >         <VAR
  7375. CLASS="literal"
  7376. >HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath</VAR
  7377. >
  7378.        </P
  7379. ></LI
  7380. ><LI
  7381. ><P
  7382. >         The <VAR
  7383. CLASS="varname"
  7384. >PHPRC</VAR
  7385. > environment variable
  7386.        </P
  7387. ></LI
  7388. ><LI
  7389. ><P
  7390. >         Directory of PHP (for CLI), or the web server's directory (for 
  7391.         SAPI modules)
  7392.        </P
  7393. ></LI
  7394. ><LI
  7395. ><P
  7396. >         Windows directory (<TT
  7397. CLASS="filename"
  7398. >C:\windows</TT
  7399. >
  7400.         or <TT
  7401. CLASS="filename"
  7402. >C:\winnt</TT
  7403. >)
  7404.        </P
  7405. ></LI
  7406. ></UL
  7407. > 
  7408.     </P
  7409. ><P
  7410. >      If you are running Apache 2, the simpler option is to use the PHPIniDir
  7411.      directive (read the <A
  7412. HREF="#install.windows.apache2"
  7413. >installation
  7414.      on Apache 2</A
  7415. > page), otherwise your best option is to set the
  7416.      <VAR
  7417. CLASS="varname"
  7418. >PHPRC</VAR
  7419. > environment variable. This process is explained
  7420.      in the following <A
  7421. HREF="#faq.installation.phprc"
  7422. >FAQ entry</A
  7423. >.
  7424.     </P
  7425. ><DIV
  7426. CLASS="note"
  7427. ><BLOCKQUOTE
  7428. CLASS="note"
  7429. ><P
  7430. ><B
  7431. >Anmerkung: </B
  7432. >
  7433.       If you're using NTFS on Windows NT, 2000, XP or 2003, make sure that the
  7434.       user running the web server has read permissions to your <TT
  7435. CLASS="filename"
  7436. >php.ini</TT
  7437. > (e.g.
  7438.       make it readable by Everyone).
  7439.      </P
  7440. ></BLOCKQUOTE
  7441. ></DIV
  7442. ><P
  7443. >      The following steps are optional:
  7444.      <P
  7445. ></P
  7446. ><UL
  7447. ><LI
  7448. ><P
  7449. >         Edit your new <TT
  7450. CLASS="filename"
  7451. >php.ini</TT
  7452. > file.       
  7453.         If you plan to use <A
  7454. HREF="#install.windows.omnihttpd"
  7455. >OmniHTTPd</A
  7456. >,
  7457.         do not follow the next step. Set the
  7458.         <A
  7459. HREF="#ini.doc-root"
  7460. >doc_root</A
  7461. > to point to your 
  7462.         web servers document_root. For example:
  7463.         <DIV
  7464. CLASS="informalexample"
  7465. ><P
  7466. ></P
  7467. ><A
  7468. NAME="AEN1198"
  7469. ></A
  7470. ><TABLE
  7471. BORDER="0"
  7472. BGCOLOR="#E0E0E0"
  7473. CELLPADDING="5"
  7474. ><TR
  7475. ><TD
  7476. ><PRE
  7477. CLASS="ini"
  7478. >doc_root = c:\inetpub       // for IIS/PWS
  7479.  
  7480. doc_root = c:\apache\htdocs // for Apache</PRE
  7481. ></TD
  7482. ></TR
  7483. ></TABLE
  7484. ><P
  7485. ></P
  7486. ></DIV
  7487. >
  7488.        </P
  7489. ></LI
  7490. ><LI
  7491. ><P
  7492. >         Choose the extensions you would like to load when PHP starts. See
  7493.         the section about
  7494.         <A
  7495. HREF="#install.windows.extensions"
  7496. >Windows extensions</A
  7497. >,
  7498.         about how to set up one, and what is already built in. Note that on
  7499.         a new installation it is advisable to first get PHP working and tested
  7500.         without any extensions before enabling them in <TT
  7501. CLASS="filename"
  7502. >php.ini</TT
  7503. >.
  7504.        </P
  7505. ></LI
  7506. ><LI
  7507. ><P
  7508. >         On PWS and IIS, you can set the
  7509.         <A
  7510. HREF="#ini.browscap"
  7511. >browscap</A
  7512. > configuration setting
  7513.         to point to:
  7514.         <TT
  7515. CLASS="filename"
  7516. >c:\windows\system\inetsrv\browscap.ini</TT
  7517. > on
  7518.         Windows 9x/Me,
  7519.         <TT
  7520. CLASS="filename"
  7521. >c:\winnt\system32\inetsrv\browscap.ini</TT
  7522. > on
  7523.         NT/2000, and
  7524.         <TT
  7525. CLASS="filename"
  7526. >c:\windows\system32\inetsrv\browscap.ini</TT
  7527. >
  7528.         on XP.  For an up-to-date <TT
  7529. CLASS="filename"
  7530. >browscap.ini</TT
  7531. >, read the
  7532.         following <A
  7533. HREF="#faq.obtaining.browscap"
  7534. >FAQ</A
  7535. >.
  7536.        </P
  7537. ></LI
  7538. ></UL
  7539. >
  7540.     </P
  7541. ><P
  7542. >      PHP is now setup on your system.  The next step is to choose a web
  7543.      server, and enable it to run PHP.  Choose a webserver from the table of 
  7544.      contents.
  7545.     </P
  7546. ></DIV
  7547. ><DIV
  7548. CLASS="sect1"
  7549. ><HR><H2
  7550. CLASS="sect1"
  7551. ><A
  7552. NAME="install.windows.activescript"
  7553. >ActiveScript</A
  7554. ></H2
  7555. ><P
  7556. >      This section contains notes specific to the ActiveScript installation.
  7557.     </P
  7558. ><P
  7559. >      ActiveScript is a windows only SAPI that enables you to use PHP script in
  7560.      any ActiveScript compliant host, like Windows Script Host, ASP/ASP.NET,
  7561.      Windows Script Components or Microsoft Scriptlet control.
  7562.     </P
  7563. ><P
  7564. >      As of PHP 5.0.1, ActiveScript has been moved to the <A
  7565. HREF="http://pecl.php.net"
  7566. TARGET="_top"
  7567. >PECL</A
  7568. > repository. You may download this <ACRONYM
  7569. CLASS="acronym"
  7570. >PECL</ACRONYM
  7571. >
  7572. extensions <ACRONYM
  7573. CLASS="acronym"
  7574. >DLL</ACRONYM
  7575. > from the <A
  7576. HREF="http://www.php.net/downloads.php"
  7577. TARGET="_top"
  7578. > PHP Downloads</A
  7579. > page or at <A
  7580. HREF="http://snaps.php.net/"
  7581. TARGET="_top"
  7582. > http://snaps.php.net/</A
  7583. >.
  7584.     </P
  7585. ><DIV
  7586. CLASS="note"
  7587. ><BLOCKQUOTE
  7588. CLASS="note"
  7589. ><P
  7590. ><B
  7591. >Anmerkung: </B
  7592. >
  7593.       You should read the <A
  7594. HREF="#install.windows.manual"
  7595. >manual
  7596.        installation steps</A
  7597. > first!
  7598.      </P
  7599. ></BLOCKQUOTE
  7600. ></DIV
  7601. ><P
  7602. >      After installing PHP, you should download the ActiveScript DLL
  7603.      (<TT
  7604. CLASS="filename"
  7605. >php5activescript.dll</TT
  7606. >) and place it in the main PHP
  7607.      folder (e.g. <TT
  7608. CLASS="filename"
  7609. >C:\php</TT
  7610. >).
  7611.     </P
  7612. ><P
  7613. >      After having all the files needed, you must register the DLL on your
  7614.      system. To achieve this, open a Command Prompt window (located in the
  7615.      Start Menu). Then go to your PHP directory by typing something like
  7616.      <VAR
  7617. CLASS="literal"
  7618. >cd C:\php</VAR
  7619. >. To register the DLL just type
  7620.      <VAR
  7621. CLASS="literal"
  7622. >regsvr32 php5activescript.dll</VAR
  7623. >.
  7624.     </P
  7625. ><P
  7626. >      To test if ActiveScript is working, create a new file, named
  7627.      <VAR
  7628. CLASS="literal"
  7629. >test.wsf</VAR
  7630. > (the extension is very important) and type:
  7631.      <TABLE
  7632. BORDER="0"
  7633. BGCOLOR="#E0E0E0"
  7634. CELLPADDING="5"
  7635. ><TR
  7636. ><TD
  7637. ><PRE
  7638. CLASS="programlisting"
  7639. ><job id="test">
  7640.  
  7641.  <script language="PHPScript">
  7642.   $WScript->Echo("Hello World!");
  7643.  </script>
  7644.  
  7645. </job></PRE
  7646. ></TD
  7647. ></TR
  7648. ></TABLE
  7649. >
  7650.      Save and double-click on the file. If you receive a little window saying
  7651.      "Hello World!" you're done.
  7652.     </P
  7653. ><DIV
  7654. CLASS="note"
  7655. ><BLOCKQUOTE
  7656. CLASS="note"
  7657. ><P
  7658. ><B
  7659. >Anmerkung: </B
  7660. >
  7661.       ActiveScript doesn't use the default <TT
  7662. CLASS="filename"
  7663. >php.ini</TT
  7664. > file. Instead, it will
  7665.       look only in the same directory as the .exe that caused it to load. You
  7666.       should create <TT
  7667. CLASS="filename"
  7668. >php-activescript.ini</TT
  7669. > and place it in
  7670.       that folder, if you wish to load extensions, etc.
  7671.      </P
  7672. ></BLOCKQUOTE
  7673. ></DIV
  7674. ></DIV
  7675. ><DIV
  7676. CLASS="sect1"
  7677. ><HR><H2
  7678. CLASS="sect1"
  7679. ><A
  7680. NAME="install.windows.iis"
  7681. >Microsoft IIS / PWS</A
  7682. ></H2
  7683. ><P
  7684. >     This section contains notes and hints specific to IIS (Microsoft
  7685.     Internet Information Server). We have included installation
  7686.     instructions for <A
  7687. HREF="#install.windows.iis.iis3"
  7688. >PWS/IIS 3</A
  7689. >,
  7690.     <A
  7691. HREF="#install.windows.iis.pws4"
  7692. >PWS 4 or newer</A
  7693. > and
  7694.     <A
  7695. HREF="#install.windows.iis.iis4"
  7696. >IIS 4 or newer</A
  7697. > versions.
  7698.    </P
  7699. ><DIV
  7700. CLASS="note"
  7701. ><BLOCKQUOTE
  7702. CLASS="note"
  7703. ><P
  7704. ><B
  7705. >Important for CGI users: </B
  7706. >
  7707.      Read the <A
  7708. HREF="#faq.installation.forceredirect"
  7709. >faq
  7710.      on cgi.force_redirect</A
  7711. > for important details.  This
  7712.      directive needs to be set to <VAR
  7713. CLASS="literal"
  7714. >0</VAR
  7715. >.
  7716.     </P
  7717. ></BLOCKQUOTE
  7718. ></DIV
  7719. ><DIV
  7720. CLASS="warning"
  7721. ><P
  7722. ></P
  7723. ><TABLE
  7724. CLASS="warning"
  7725. BORDER="1"
  7726. WIDTH="100%"
  7727. ><TR
  7728. ><TD
  7729. ALIGN="CENTER"
  7730. ><B
  7731. >Warnung</B
  7732. ></TD
  7733. ></TR
  7734. ><TR
  7735. ><TD
  7736. ALIGN="LEFT"
  7737. ><P
  7738. >By using the CGI setup, your server
  7739. is open to several possible attacks. Please read our
  7740. <A
  7741. HREF="#security.cgi-bin"
  7742. >CGI security section</A
  7743. > to learn how to
  7744. defend yourself from those attacks.</P
  7745. ></TD
  7746. ></TR
  7747. ></TABLE
  7748. ></DIV
  7749. ><DIV
  7750. CLASS="sect2"
  7751. ><HR><H3
  7752. CLASS="sect2"
  7753. ><A
  7754. NAME="install.windows.iis.iis3"
  7755. >Windows and PWS/IIS 3</A
  7756. ></H3
  7757. ><P
  7758. >      The recommended method for configuring these servers is to use
  7759.      the REG file included with the distribution
  7760.      (<TT
  7761. CLASS="filename"
  7762. >pws-php4cgi.reg</TT
  7763. > in the SAPI folder for PHP 4, or
  7764.      <TT
  7765. CLASS="filename"
  7766. >pws-php5cgi.reg</TT
  7767. > in the main folder for PHP 5).
  7768.      You may want to edit this file and make sure
  7769.      the extensions and PHP install directories match your
  7770.      configuration. Or you can follow the steps below to do it
  7771.      manually.
  7772.     </P
  7773. ><DIV
  7774. CLASS="warning"
  7775. ><P
  7776. ></P
  7777. ><TABLE
  7778. CLASS="warning"
  7779. BORDER="1"
  7780. WIDTH="100%"
  7781. ><TR
  7782. ><TD
  7783. ALIGN="CENTER"
  7784. ><B
  7785. >Warnung</B
  7786. ></TD
  7787. ></TR
  7788. ><TR
  7789. ><TD
  7790. ALIGN="LEFT"
  7791. ><P
  7792. >       These steps involve working directly with the Windows
  7793.       registry. One error here can leave your system in an unstable
  7794.       state. We highly recommend that you back up your registry
  7795.       first. The PHP Development team will not be held responsible if
  7796.       you damage your registry.
  7797.      </P
  7798. ></TD
  7799. ></TR
  7800. ></TABLE
  7801. ></DIV
  7802. ><P
  7803. >      <P
  7804. ></P
  7805. ><UL
  7806. ><LI
  7807. ><P
  7808. >         Run Regedit.
  7809.        </P
  7810. ></LI
  7811. ><LI
  7812. ><P
  7813. >         Navigate to: <VAR
  7814. CLASS="literal"
  7815. >HKEY_LOCAL_MACHINE /System
  7816.          /CurrentControlSet /Services /W3Svc /Parameters
  7817.          /ScriptMap</VAR
  7818. >.
  7819.        </P
  7820. ></LI
  7821. ><LI
  7822. ><P
  7823. >         On the edit menu select: <VAR
  7824. CLASS="literal"
  7825. >New->String Value</VAR
  7826. >.
  7827.        </P
  7828. ></LI
  7829. ><LI
  7830. ><P
  7831. >         Type in the extension you wish to use for your php
  7832.         scripts. For example <VAR
  7833. CLASS="literal"
  7834. >.php</VAR
  7835. >
  7836.        </P
  7837. ></LI
  7838. ><LI
  7839. ><P
  7840. >         Double click on the new string value and enter the path to
  7841.         <TT
  7842. CLASS="filename"
  7843. >php.exe</TT
  7844. > in the value data field. ex:
  7845.         <TT
  7846. CLASS="filename"
  7847. >C:\php\php.exe</TT
  7848. > for PHP 4, or
  7849.         <TT
  7850. CLASS="filename"
  7851. >C:\php\php-cgi.exe</TT
  7852. > for PHP 5.
  7853.        </P
  7854. ></LI
  7855. ><LI
  7856. ><P
  7857. >         Repeat these steps for each extension you wish to associate
  7858.         with PHP scripts.
  7859.        </P
  7860. ></LI
  7861. ></UL
  7862. >
  7863.     </P
  7864. ><P
  7865. >      The following steps do not affect the web server installation
  7866.      and only apply if you want your PHP scripts to be executed when
  7867.      they are run from the command line (ex. run
  7868.      <TT
  7869. CLASS="filename"
  7870. >C:\myscripts\test.php</TT
  7871. >) or by double clicking
  7872.      on them in a directory viewer window. You may wish to skip these
  7873.      steps as you might prefer the PHP files to load into a text
  7874.      editor when you double click on them.
  7875.     </P
  7876. ><P
  7877. >      <P
  7878. ></P
  7879. ><UL
  7880. ><LI
  7881. ><P
  7882. >         Navigate to: <VAR
  7883. CLASS="literal"
  7884. >HKEY_CLASSES_ROOT</VAR
  7885. >
  7886.        </P
  7887. ></LI
  7888. ><LI
  7889. ><P
  7890. >         On the edit menu select: <VAR
  7891. CLASS="literal"
  7892. >New->Key</VAR
  7893. >.
  7894.        </P
  7895. ></LI
  7896. ><LI
  7897. ><P
  7898. >         Name the key to the extension you setup in the previous
  7899.         section. ex: <VAR
  7900. CLASS="literal"
  7901. >.php</VAR
  7902. >
  7903.        </P
  7904. ></LI
  7905. ><LI
  7906. ><P
  7907. >         Highlight the new key and in the right side pane, double click 
  7908.         the "default value" and enter <VAR
  7909. CLASS="literal"
  7910. >phpfile</VAR
  7911. >.
  7912.        </P
  7913. ></LI
  7914. ><LI
  7915. ><P
  7916. >         Repeat the last step for each extension you set up in the
  7917.         previous section.
  7918.        </P
  7919. ></LI
  7920. ><LI
  7921. ><P
  7922. >         Now create another <VAR
  7923. CLASS="literal"
  7924. >New->Key</VAR
  7925. > under
  7926.         <VAR
  7927. CLASS="literal"
  7928. >HKEY_CLASSES_ROOT</VAR
  7929. > and name it
  7930.         <VAR
  7931. CLASS="literal"
  7932. >phpfile</VAR
  7933. >.
  7934.        </P
  7935. ></LI
  7936. ><LI
  7937. ><P
  7938. >         Highlight the new key <VAR
  7939. CLASS="literal"
  7940. >phpfile</VAR
  7941. > and in the
  7942.         right side pane, double click the "default value" and enter
  7943.         <VAR
  7944. CLASS="literal"
  7945. >PHP Script</VAR
  7946. >.
  7947.        </P
  7948. ></LI
  7949. ><LI
  7950. ><P
  7951. >         Right click on the <VAR
  7952. CLASS="literal"
  7953. >phpfile</VAR
  7954. > key and select
  7955.         <VAR
  7956. CLASS="literal"
  7957. >New->Key</VAR
  7958. >, name it <VAR
  7959. CLASS="literal"
  7960. >Shell</VAR
  7961. >.
  7962.        </P
  7963. ></LI
  7964. ><LI
  7965. ><P
  7966. >         Right click on the <VAR
  7967. CLASS="literal"
  7968. >Shell</VAR
  7969. > key and select
  7970.         <VAR
  7971. CLASS="literal"
  7972. >New->Key</VAR
  7973. >, name it <VAR
  7974. CLASS="literal"
  7975. >open</VAR
  7976. >.
  7977.        </P
  7978. ></LI
  7979. ><LI
  7980. ><P
  7981. >         Right click on the <VAR
  7982. CLASS="literal"
  7983. >open</VAR
  7984. > key and select
  7985.         <VAR
  7986. CLASS="literal"
  7987. >New->Key</VAR
  7988. >, name it
  7989.         <VAR
  7990. CLASS="literal"
  7991. >command</VAR
  7992. >. 
  7993.        </P
  7994. ></LI
  7995. ><LI
  7996. ><P
  7997. >         Highlight the new key <VAR
  7998. CLASS="literal"
  7999. >command</VAR
  8000. > and in the
  8001.         right side pane, double click the "default value" and enter
  8002.         the path to <TT
  8003. CLASS="filename"
  8004. >php.exe</TT
  8005. >. ex:
  8006.         <VAR
  8007. CLASS="literal"
  8008. >c:\php\php.exe -q %1</VAR
  8009. >. (don't forget the
  8010.         <VAR
  8011. CLASS="literal"
  8012. >%1</VAR
  8013. >). 
  8014.        </P
  8015. ></LI
  8016. ><LI
  8017. ><P
  8018. >         Exit Regedit.
  8019.        </P
  8020. ></LI
  8021. ><LI
  8022. ><P
  8023. >         If using PWS on Windows, reboot to reload the registry.
  8024.        </P
  8025. ></LI
  8026. ></UL
  8027. >
  8028.     </P
  8029. ><P
  8030. >      PWS and IIS 3 users now have a fully operational system. IIS 3
  8031.      users can use a nifty <A
  8032. HREF="http://www.genusa.com/iis/iiscfg.html"
  8033. TARGET="_top"
  8034. >tool</A
  8035. >
  8036.      from Steven Genusa to configure their script maps.
  8037.     </P
  8038. ></DIV
  8039. ><DIV
  8040. CLASS="sect2"
  8041. ><HR><H3
  8042. CLASS="sect2"
  8043. ><A
  8044. NAME="install.windows.iis.pws4"
  8045. >Windows and PWS 4 or newer</A
  8046. ></H3
  8047. ><P
  8048. >      When installing PHP on Windows with PWS 4 or newer version,
  8049.      you have two options. One to set up the PHP CGI binary,
  8050.      the other is to use the ISAPI module DLL.
  8051.     </P
  8052. ><P
  8053. >      If you choose the CGI binary, do the following:
  8054.      <P
  8055. ></P
  8056. ><UL
  8057. ><LI
  8058. ><P
  8059. >         Edit the enclosed <TT
  8060. CLASS="filename"
  8061. >pws-php4cgi.reg</TT
  8062. > /
  8063.         <TT
  8064. CLASS="filename"
  8065. >pws-php5cgi.reg</TT
  8066. > file (look into the SAPI folder
  8067.         for PHP 4, or in the main folder for PHP 5) to reflect the location of
  8068.         your <TT
  8069. CLASS="filename"
  8070. >php.exe</TT
  8071. > / <TT
  8072. CLASS="filename"
  8073. >php-cgi.exe</TT
  8074. >.
  8075.         Backslashes should be escaped, for example:
  8076.         <VAR
  8077. CLASS="literal"
  8078. >[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script
  8079.          Map] ".php"="C:\\php\\php.exe"</VAR
  8080. > (change to
  8081.         <VAR
  8082. CLASS="literal"
  8083. >C:\\php\\php-cgi.exe</VAR
  8084. > if you are using PHP 5)
  8085.         Now merge this registery file into your system; you may do 
  8086.         this by double-clicking it.
  8087.        </P
  8088. ></LI
  8089. ><LI
  8090. ><P
  8091. >         In the PWS Manager, right click on a given directory you want
  8092.         to add PHP support to, and select Properties. Check the 'Execute'
  8093.         checkbox, and confirm.
  8094.        </P
  8095. ></LI
  8096. ></UL
  8097. >
  8098.     </P
  8099. ><P
  8100. >      If you choose the ISAPI module, do the following:
  8101.      <P
  8102. ></P
  8103. ><UL
  8104. ><LI
  8105. ><P
  8106. >         Edit the enclosed <TT
  8107. CLASS="filename"
  8108. >pws-php4isapi.reg</TT
  8109. > /
  8110.         <TT
  8111. CLASS="filename"
  8112. >pws-php5isapi.reg</TT
  8113. > file (look into the SAPI folder
  8114.         for PHP 4, or in the main folder for PHP 5) to reflect the location of
  8115.         your <TT
  8116. CLASS="filename"
  8117. >php4isapi.dll</TT
  8118. > /
  8119.         <TT
  8120. CLASS="filename"
  8121. >php5isapi.dll</TT
  8122. >. Backslashes should be escaped, for example:
  8123.         <VAR
  8124. CLASS="literal"
  8125. >[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script
  8126.          Map] ".php"="C:\\php\\sapi\\php4isapi.dll"</VAR
  8127. > (or
  8128.         <VAR
  8129. CLASS="literal"
  8130. >C:\\php\\php5isapi.dll</VAR
  8131. > for PHP 5)
  8132.         Now merge this registery file into your system; you may do 
  8133.         this by double-clicking it.
  8134.        </P
  8135. ></LI
  8136. ><LI
  8137. ><P
  8138. >         In the PWS Manager, right click on a given directory you want to
  8139.         add PHP support to, and select Properties. Check the 'Execute'
  8140.         checkbox, and confirm. 
  8141.        </P
  8142. ></LI
  8143. ></UL
  8144. >
  8145.     </P
  8146. ></DIV
  8147. ><DIV
  8148. CLASS="sect2"
  8149. ><HR><H3
  8150. CLASS="sect2"
  8151. ><A
  8152. NAME="install.windows.iis.iis4"
  8153. >Windows NT/2000/XP and IIS 4 or newer</A
  8154. ></H3
  8155. ><P
  8156. >      To install PHP on an NT/2000/XP Server running IIS 4 or newer,
  8157.      follow these instructions. You have two options to set up
  8158.      PHP, using the CGI binary (<TT
  8159. CLASS="filename"
  8160. >php.exe</TT
  8161. > in PHP 4, or
  8162.      <TT
  8163. CLASS="filename"
  8164. >php-cgi.exe</TT
  8165. > in PHP 5) or with the ISAPI module.
  8166.     </P
  8167. ><P
  8168. >      In either case, you need to start the Microsoft Management
  8169.      Console (may appear as 'Internet Services Manager', either
  8170.      in your Windows NT 4.0 Option Pack branch or the Control
  8171.      Panel=>Administrative Tools under Windows 2000/XP). Then 
  8172.      right click on your Web server node (this will most probably
  8173.      appear as 'Default Web Server'), and select 'Properties'.
  8174.     </P
  8175. ><P
  8176. >      If you want to use the CGI binary, do the following:
  8177.      <P
  8178. ></P
  8179. ><UL
  8180. ><LI
  8181. ><P
  8182. >         Under 'Home Directory', 'Virtual Directory', or
  8183.         'Directory', click on the 'Configuration' button,
  8184.         and then enter the App Mappings tab.
  8185.        </P
  8186. ></LI
  8187. ><LI
  8188. ><P
  8189. >         Click Add, and in the Executable box, type:
  8190.         <VAR
  8191. CLASS="literal"
  8192. >C:\php\php.exe</VAR
  8193. > for PHP 4 or
  8194.         <VAR
  8195. CLASS="literal"
  8196. >C:\php\php-cgi.exe</VAR
  8197. > for PHP 5 (assuming
  8198.         that you have unziped PHP in <TT
  8199. CLASS="filename"
  8200. >c:\php\</TT
  8201. >).
  8202.         </P
  8203. ></LI
  8204. ><LI
  8205. ><P
  8206. >         In the Extension box, type the file name extension you want
  8207.         associated with PHP scripts. Leave 'Method exclusions'
  8208.         blank, and check the 'Script engine' checkbox. You may also
  8209.         like to check the 'check that file exists' box - for a small
  8210.         performance penalty, IIS (or PWS) will check that the script
  8211.         file exists and sort out authentication before firing up PHP.
  8212.         This means that you will get sensible 404 style error messages
  8213.         instead of CGI errors complaining that PHP did not output any data.
  8214.        </P
  8215. ><P
  8216. >         You must start over from the previous step for each
  8217.         extension you want associated with PHP scripts.
  8218.         <VAR
  8219. CLASS="literal"
  8220. >.php</VAR
  8221. > and <VAR
  8222. CLASS="literal"
  8223. >.phtml</VAR
  8224. >
  8225.         are common, although <VAR
  8226. CLASS="literal"
  8227. >.php3</VAR
  8228. > may be
  8229.         required for legacy applications.
  8230.        </P
  8231. ></LI
  8232. ><LI
  8233. ><P
  8234. >         Set up the appropriate security. (This is done in Internet
  8235.         Service Manager), and if your NT Server uses NTFS file system,
  8236.         add execute rights for I_USR_ to the directory that contains
  8237.         <TT
  8238. CLASS="filename"
  8239. >php.exe</TT
  8240. > / <TT
  8241. CLASS="filename"
  8242. >php-cgi.exe</TT
  8243. >.
  8244.        </P
  8245. ></LI
  8246. ></UL
  8247. >
  8248.     </P
  8249. ><P
  8250. >      To use the ISAPI module, do the following:
  8251.      <P
  8252. ></P
  8253. ><UL
  8254. ><LI
  8255. ><P
  8256. >         If you don't want to perform HTTP Authentication using PHP,
  8257.         you can (and should) skip this step. Under ISAPI Filters,
  8258.         add a new ISAPI filter. Use PHP as the filter name, and
  8259.         supply a path to the <TT
  8260. CLASS="filename"
  8261. >php4isapi.dll</TT
  8262. > /
  8263.         <TT
  8264. CLASS="filename"
  8265. >php5isapi.dll</TT
  8266. >.
  8267.        </P
  8268. ></LI
  8269. ><LI
  8270. ><P
  8271. >         Under 'Home Directory', click on the 'Configuration' button.
  8272.         Add a new entry to the Application Mappings. Use the path
  8273.         to the <TT
  8274. CLASS="filename"
  8275. >php4isapi.dll</TT
  8276. > /
  8277.         <TT
  8278. CLASS="filename"
  8279. >php5isapi.dll</TT
  8280. > as the Executable, supply
  8281.         <VAR
  8282. CLASS="literal"
  8283. >.php</VAR
  8284. > as the extension, leave 'Method exclusions'
  8285.         blank, and check the 'Script engine' checkbox.
  8286.        </P
  8287. ></LI
  8288. ><LI
  8289. ><P
  8290. >         Stop IIS completely (NET STOP iisadmin)
  8291.        </P
  8292. ></LI
  8293. ><LI
  8294. ><P
  8295. >         Start IIS again (NET START w3svc)
  8296.        </P
  8297. ></LI
  8298. ></UL
  8299. >
  8300.     </P
  8301. ></DIV
  8302. ></DIV
  8303. ><DIV
  8304. CLASS="sect1"
  8305. ><HR><H2
  8306. CLASS="sect1"
  8307. ><A
  8308. NAME="install.windows.apache1"
  8309. >Apache 1.3.x on Microsft Windows</A
  8310. ></H2
  8311. ><P
  8312. >      This section contains notes and hints specific to Apache 1.3.x installs
  8313.      of PHP on Microsoft Windows systems. We also
  8314.      have <A
  8315. HREF="#install.windows.apache2"
  8316. >instructions and notes
  8317.      for Apache 2 on a separate page</A
  8318. >.
  8319.     </P
  8320. ><DIV
  8321. CLASS="note"
  8322. ><BLOCKQUOTE
  8323. CLASS="note"
  8324. ><P
  8325. ><B
  8326. >Anmerkung: </B
  8327. >
  8328.       You should read the <A
  8329. HREF="#install.windows.manual"
  8330. >manual
  8331.        installation steps</A
  8332. > first!
  8333.      </P
  8334. ></BLOCKQUOTE
  8335. ></DIV
  8336. ><P
  8337. >      There are two ways to set up PHP to work with Apache 1.3.x
  8338.      on Windows. One is to use the CGI binary (<TT
  8339. CLASS="filename"
  8340. >php.exe</TT
  8341. >
  8342.      for PHP 4 and <TT
  8343. CLASS="filename"
  8344. >php-cgi.exe</TT
  8345. > for PHP 5),
  8346.      the other is to use the Apache module DLL. In either case
  8347.      you need to edit your <TT
  8348. CLASS="filename"
  8349. >httpd.conf</TT
  8350. > to configure Apache to
  8351.      work with PHP, and then restart the server.
  8352.     </P
  8353. ><P
  8354. >      It is worth noting here that now the SAPI module has been 
  8355.      made more stable under Windows, we recommend it's use above
  8356.      the CGI binary, since it is more transparent and secure.
  8357.     </P
  8358. ><P
  8359. >      Although there can be a few variations of configuring PHP
  8360.      under Apache, these are simple enough to be used by the
  8361.      newcomer. Please consult the Apache Documentation for further
  8362.      configuration directives.
  8363.     </P
  8364. ><P
  8365. >      After changing the configuration file, remember to restart the server, for
  8366.      example, <B
  8367. CLASS="command"
  8368. >NET STOP APACHE</B
  8369. > followed by
  8370.      <B
  8371. CLASS="command"
  8372. >NET START APACHE</B
  8373. >, if you run Apache as a Windows
  8374.      Service, or use your regular shortcuts.
  8375.     </P
  8376. ><DIV
  8377. CLASS="note"
  8378. ><BLOCKQUOTE
  8379. CLASS="note"
  8380. ><P
  8381. ><B
  8382. >Anmerkung: </B
  8383. >Beachten Sie bitte, dass Sie bei
  8384. Pfadangaben in der Apachekonfigurationsdatei unter Windows alle Backslashes,
  8385. wie z.B. <TT
  8386. CLASS="filename"
  8387. >c:\directory\file.ext</TT
  8388. >, in SchrΣgstriche umwandeln
  8389. mⁿssen: <TT
  8390. CLASS="filename"
  8391. >c:/directory/file.ext</TT
  8392. >.</P
  8393. ></BLOCKQUOTE
  8394. ></DIV
  8395. ><DIV
  8396. CLASS="sect2"
  8397. ><HR><H3
  8398. CLASS="sect2"
  8399. ><A
  8400. NAME="install.windows.apache1.cgi"
  8401. >Installing as a CGI binary</A
  8402. ></H3
  8403. ><P
  8404. >       If you unziped the PHP package to <TT
  8405. CLASS="filename"
  8406. >C:\php\</TT
  8407. > as described
  8408.       in the <A
  8409. HREF="#install.windows.manual"
  8410. >Manual
  8411.       Installation Steps</A
  8412. > section, you need to insert
  8413.       these lines to your Apache configuration file to set
  8414.       up the CGI binary:
  8415.       <TABLE
  8416. WIDTH="100%"
  8417. BORDER="0"
  8418. CELLPADDING="0"
  8419. CELLSPACING="0"
  8420. CLASS="EXAMPLE"
  8421. ><TR
  8422. ><TD
  8423. ><DIV
  8424. CLASS="example"
  8425. ><A
  8426. NAME="AEN1426"
  8427. ></A
  8428. ><P
  8429. ><B
  8430. >Beispiel 6-3. PHP and Apache 1.3.x as CGI</B
  8431. ></P
  8432. ><TABLE
  8433. BORDER="0"
  8434. BGCOLOR="#E0E0E0"
  8435. CELLPADDING="5"
  8436. ><TR
  8437. ><TD
  8438. ><PRE
  8439. CLASS="apache-conf"
  8440. >ScriptAlias /php/ "c:/php/"
  8441. AddType application/x-httpd-php .php
  8442.  
  8443. # For PHP 4
  8444. Action application/x-httpd-php "/php/php.exe"
  8445.  
  8446. # For PHP 5
  8447. Action application/x-httpd-php "/php/php-cgi.exe"
  8448.  
  8449. # specify the directory where php.ini is
  8450. SetEnv PHPRC C:/php</PRE
  8451. ></TD
  8452. ></TR
  8453. ></TABLE
  8454. ></DIV
  8455. ></TD
  8456. ></TR
  8457. ></TABLE
  8458. >
  8459.       Note that the second line in the list above can be found
  8460.       in the actual versions of <TT
  8461. CLASS="filename"
  8462. >httpd.conf</TT
  8463. >, but it is commented out. Remember
  8464.       also to substitute the <TT
  8465. CLASS="filename"
  8466. >c:/php/</TT
  8467. > for your actual path to
  8468.       PHP.
  8469.      </P
  8470. ><DIV
  8471. CLASS="warning"
  8472. ><P
  8473. ></P
  8474. ><TABLE
  8475. CLASS="warning"
  8476. BORDER="1"
  8477. WIDTH="100%"
  8478. ><TR
  8479. ><TD
  8480. ALIGN="CENTER"
  8481. ><B
  8482. >Warnung</B
  8483. ></TD
  8484. ></TR
  8485. ><TR
  8486. ><TD
  8487. ALIGN="LEFT"
  8488. ><P
  8489. >By using the CGI setup, your server
  8490. is open to several possible attacks. Please read our
  8491. <A
  8492. HREF="#security.cgi-bin"
  8493. >CGI security section</A
  8494. > to learn how to
  8495. defend yourself from those attacks.</P
  8496. ></TD
  8497. ></TR
  8498. ></TABLE
  8499. ></DIV
  8500. ><P
  8501. >       If you would like to present PHP source files syntax highlighted, there
  8502.       is no such convinient option as with the module version of PHP.
  8503.       If you chose to configure Apache to use PHP as a CGI binary, you
  8504.       will need to use the <A
  8505. HREF="#function.show-source"
  8506. ><B
  8507. CLASS="function"
  8508. >show_source()</B
  8509. ></A
  8510. > function. To
  8511.       do this simply create a PHP script file and add this code: 
  8512.       <VAR
  8513. CLASS="literal"
  8514. ><?php show_source("original_php_script.php"); ?></VAR
  8515. >. 
  8516.       Substitute <TT
  8517. CLASS="filename"
  8518. >original_php_script.php</TT
  8519. > with 
  8520.       the name of the file you wish to show the source of. 
  8521.      </P
  8522. ></DIV
  8523. ><DIV
  8524. CLASS="sect2"
  8525. ><HR><H3
  8526. CLASS="sect2"
  8527. ><A
  8528. NAME="install.windows.apache1.module"
  8529. >Installing as an Apache module</A
  8530. ></H3
  8531. ><P
  8532. >       You should add the following lines to your Apache <TT
  8533. CLASS="filename"
  8534. >httpd.conf</TT
  8535. > file:
  8536.      </P
  8537. ><P
  8538. >       <TABLE
  8539. WIDTH="100%"
  8540. BORDER="0"
  8541. CELLPADDING="0"
  8542. CELLSPACING="0"
  8543. CLASS="EXAMPLE"
  8544. ><TR
  8545. ><TD
  8546. ><DIV
  8547. CLASS="example"
  8548. ><A
  8549. NAME="AEN1443"
  8550. ></A
  8551. ><P
  8552. ><B
  8553. >Beispiel 6-4. PHP as an Apache 1.3.x module</B
  8554. ></P
  8555. ><TABLE
  8556. BORDER="0"
  8557. BGCOLOR="#E0E0E0"
  8558. CELLPADDING="5"
  8559. ><TR
  8560. ><TD
  8561. ><PRE
  8562. CLASS="apache-conf"
  8563. >AddType application/x-httpd-php .php
  8564.  
  8565. # For PHP 4
  8566. LoadModule php4_module "c:/php/sapi/php4apache.dll"
  8567.  
  8568. # For PHP 5
  8569. LoadModule php5_module "c:/php/php5apache.dll"
  8570.  
  8571. # specify the directory where php.ini is
  8572. SetEnv PHPRC C:/php</PRE
  8573. ></TD
  8574. ></TR
  8575. ></TABLE
  8576. ></DIV
  8577. ></TD
  8578. ></TR
  8579. ></TABLE
  8580. >
  8581.      </P
  8582. ><P
  8583. >       You may find after using the Windows installer for Apache that you need
  8584.       to define the <VAR
  8585. CLASS="literal"
  8586. >AddModule</VAR
  8587. > directive for
  8588.       <TT
  8589. CLASS="filename"
  8590. >mod_php4.c</TT
  8591. >. This is especially important if the
  8592.       <VAR
  8593. CLASS="literal"
  8594. >ClearModuleList</VAR
  8595. > directive is defined, which you will
  8596.       find by scrolling down a few lines. You will see a list of
  8597.       <VAR
  8598. CLASS="literal"
  8599. >AddModule</VAR
  8600. > entries, add the following line
  8601.       <SPAN
  8602. CLASS="emphasis"
  8603. ><I
  8604. CLASS="emphasis"
  8605. >at the end</I
  8606. ></SPAN
  8607. > of the list: <VAR
  8608. CLASS="literal"
  8609. >AddModule
  8610.        mod_php4.c</VAR
  8611. >.  For PHP 5, instead use <VAR
  8612. CLASS="literal"
  8613. >AddModule
  8614.        mod_php5.c</VAR
  8615. >
  8616.       </P
  8617. ><P
  8618. >       If you would like to use the source code highlighting feature, you need
  8619.       to add the following line to your <TT
  8620. CLASS="filename"
  8621. >httpd.conf</TT
  8622. >:
  8623.       <VAR
  8624. CLASS="literal"
  8625. >AddType application/x-httpd-php-source .phps</VAR
  8626. >.
  8627.       This should be inserted at the same place where you inserted
  8628.       <VAR
  8629. CLASS="literal"
  8630. >AddType application/x-httpd-php .php</VAR
  8631. > above). With
  8632.       this setup, all files served with the <VAR
  8633. CLASS="literal"
  8634. >.phps</VAR
  8635. > extension
  8636.       will be syntax highlighted for the browser.
  8637.      </P
  8638. ></DIV
  8639. ></DIV
  8640. ><DIV
  8641. CLASS="sect1"
  8642. ><HR><H2
  8643. CLASS="sect1"
  8644. ><A
  8645. NAME="install.windows.apache2"
  8646. >Apache 2.0.x on Microsoft Windows</A
  8647. ></H2
  8648. ><P
  8649. >      This section contains notes and hints specific to Apache 2.0.x installs
  8650.      of PHP on Microsoft Windows systems. We also
  8651.      have <A
  8652. HREF="#install.windows.apache1"
  8653. >instructions and notes
  8654.      for Apache 1.3.x users on a separate page</A
  8655. >.
  8656.     </P
  8657. ><DIV
  8658. CLASS="note"
  8659. ><BLOCKQUOTE
  8660. CLASS="note"
  8661. ><P
  8662. ><B
  8663. >Anmerkung: </B
  8664. >
  8665.       You should read the <A
  8666. HREF="#install.windows.manual"
  8667. >manual
  8668.        installation steps</A
  8669. > first!
  8670.      </P
  8671. ></BLOCKQUOTE
  8672. ></DIV
  8673. ><DIV
  8674. CLASS="warning"
  8675. ><P
  8676. ></P
  8677. ><TABLE
  8678. CLASS="warning"
  8679. BORDER="1"
  8680. WIDTH="100%"
  8681. ><TR
  8682. ><TD
  8683. ALIGN="CENTER"
  8684. ><B
  8685. >Warnung</B
  8686. ></TD
  8687. ></TR
  8688. ><TR
  8689. ><TD
  8690. ALIGN="LEFT"
  8691. ><P
  8692. >Verwenden Sie Apache 2.0.x und PHP
  8693. weder unter Unix noch Windows in einer Produktivumgebung. Fⁿr weitere
  8694. Informationen und Grⁿnde lesen Sie bitte diesen
  8695. <A
  8696. HREF="#faq.installation.apache2"
  8697. >FAQ Eintrag.</A
  8698. ></P
  8699. ></TD
  8700. ></TR
  8701. ></TABLE
  8702. ></DIV
  8703. ><P
  8704. >      You are highly encouraged to take a look at the
  8705.      <A
  8706. HREF="http://httpd.apache.org/docs-2.0/"
  8707. TARGET="_top"
  8708. >Apache Documentation</A
  8709. > to get
  8710.      a basic understanding of the Apache 2.0.x Server. Also consider to
  8711.      read the <A
  8712. HREF="http://httpd.apache.org/docs-2.0/platform/windows.html"
  8713. TARGET="_top"
  8714. >Windows specific
  8715.      notes</A
  8716. > for Apache 2.0.x before reading on here.
  8717.     </P
  8718. ><DIV
  8719. CLASS="note"
  8720. ><BLOCKQUOTE
  8721. CLASS="note"
  8722. ><P
  8723. ><B
  8724. >PHP and Apache 2.0.x compatibility notes: </B
  8725. >
  8726.       The following versions of PHP are known to work with the most recent
  8727.       version of Apache 2.0.x:
  8728.       <P
  8729. ></P
  8730. ><UL
  8731. COMPACT="COMPACT"
  8732. ><LI
  8733. ><SPAN
  8734. >          PHP 4.3.0 or later available at
  8735.          <A
  8736. HREF="http://www.php.net/downloads.php"
  8737. TARGET="_top"
  8738. >http://www.php.net/downloads.php</A
  8739. >.
  8740.         </SPAN
  8741. ></LI
  8742. ><LI
  8743. ><SPAN
  8744. >          the latest stable development version.
  8745.          Get the source code <A
  8746. HREF="http://snaps.php.net/php4-latest.tar.gz"
  8747. TARGET="_top"
  8748. >          http://snaps.php.net/php4-latest.tar.gz</A
  8749. > or download binaries
  8750.          for Windows <A
  8751. HREF="http://snaps.php.net/win32/php4-win32-latest.zip"
  8752. TARGET="_top"
  8753. >          http://snaps.php.net/win32/php4-win32-latest.zip</A
  8754. >.
  8755.         </SPAN
  8756. ></LI
  8757. ><LI
  8758. ><SPAN
  8759. >          a prerelease version downloadable from
  8760.          <A
  8761. HREF="http://qa.php.net/"
  8762. TARGET="_top"
  8763. >http://qa.php.net/</A
  8764. >.
  8765.         </SPAN
  8766. ></LI
  8767. ><LI
  8768. ><SPAN
  8769. >          you have always the option to obtain PHP through
  8770.          <A
  8771. HREF="http://www.php.net/anoncvs.php"
  8772. TARGET="_top"
  8773. >anonymous CVS</A
  8774. >.
  8775.         </SPAN
  8776. ></LI
  8777. ></UL
  8778. >
  8779.       These versions of PHP are compatible to Apache 2.0.40 and later.
  8780.      </P
  8781. ><P
  8782. >       Apache 2.0 <VAR
  8783. CLASS="literal"
  8784. >SAPI</VAR
  8785. >-support started with PHP 4.2.0.
  8786.       PHP 4.2.3 works with Apache 2.0.39, don't use any other version of Apache with
  8787.       PHP 4.2.3. However, the recommended setup is to use PHP 4.3.0 or later with
  8788.       the most recent version of Apache2.
  8789.      </P
  8790. ><P
  8791. >       All mentioned versions of PHP will work still with
  8792.       Apache 1.3.x.
  8793.      </P
  8794. ></BLOCKQUOTE
  8795. ></DIV
  8796. ><DIV
  8797. CLASS="warning"
  8798. ><P
  8799. ></P
  8800. ><TABLE
  8801. CLASS="warning"
  8802. BORDER="1"
  8803. WIDTH="100%"
  8804. ><TR
  8805. ><TD
  8806. ALIGN="CENTER"
  8807. ><B
  8808. >Warnung</B
  8809. ></TD
  8810. ></TR
  8811. ><TR
  8812. ><TD
  8813. ALIGN="LEFT"
  8814. ><P
  8815. >       Apache 2.0.x is designed to run on Windows NT 4.0, Windows 2000 or
  8816.       Windows XP. At this time, support for Windows 9x is incomplete.
  8817.       Apache 2.0.x is not expected to work on those platforms at this time.
  8818.      </P
  8819. ></TD
  8820. ></TR
  8821. ></TABLE
  8822. ></DIV
  8823. ><P
  8824. >      Download the most recent version of <A
  8825. HREF="http://www.apache.org/"
  8826. TARGET="_top"
  8827. >      Apache 2.0.x</A
  8828. > and a fitting PHP version.
  8829.      Follow the <A
  8830. HREF="#install.windows.manual"
  8831. >Manual Installation
  8832.      Steps</A
  8833. > and come back to go on with the integration of PHP and Apache.
  8834.     </P
  8835. ><P
  8836. >      There are two ways to set up PHP to work with Apache 2.0.x on Windows.
  8837.      One is to use the CGI binary the other is to use the Apache module DLL.
  8838.      In either case you need to edit your <TT
  8839. CLASS="filename"
  8840. >httpd.conf</TT
  8841. > to configure Apache
  8842.      to work with PHP and then restart the server.
  8843.     </P
  8844. ><DIV
  8845. CLASS="note"
  8846. ><BLOCKQUOTE
  8847. CLASS="note"
  8848. ><P
  8849. ><B
  8850. >Anmerkung: </B
  8851. >Beachten Sie bitte, dass Sie bei
  8852. Pfadangaben in der Apachekonfigurationsdatei unter Windows alle Backslashes,
  8853. wie z.B. <TT
  8854. CLASS="filename"
  8855. >c:\directory\file.ext</TT
  8856. >, in SchrΣgstriche umwandeln
  8857. mⁿssen: <TT
  8858. CLASS="filename"
  8859. >c:/directory/file.ext</TT
  8860. >.</P
  8861. ></BLOCKQUOTE
  8862. ></DIV
  8863. ><DIV
  8864. CLASS="sect2"
  8865. ><HR><H3
  8866. CLASS="sect2"
  8867. ><A
  8868. NAME="install.windows.apache2.cgi"
  8869. >Installing as a CGI binary</A
  8870. ></H3
  8871. ><P
  8872. >       You need to insert these three lines to your Apache <TT
  8873. CLASS="filename"
  8874. >httpd.conf</TT
  8875. >
  8876.       configuration file to set up the CGI binary:
  8877.       <TABLE
  8878. WIDTH="100%"
  8879. BORDER="0"
  8880. CELLPADDING="0"
  8881. CELLSPACING="0"
  8882. CLASS="EXAMPLE"
  8883. ><TR
  8884. ><TD
  8885. ><DIV
  8886. CLASS="example"
  8887. ><A
  8888. NAME="AEN1507"
  8889. ></A
  8890. ><P
  8891. ><B
  8892. >Beispiel 6-5. PHP and Apache 2.0 as CGI</B
  8893. ></P
  8894. ><TABLE
  8895. BORDER="0"
  8896. BGCOLOR="#E0E0E0"
  8897. CELLPADDING="5"
  8898. ><TR
  8899. ><TD
  8900. ><PRE
  8901. CLASS="apache-conf"
  8902. >ScriptAlias /php/ "c:/php/"
  8903. AddType application/x-httpd-php .php
  8904.  
  8905. # For PHP 4
  8906. Action application/x-httpd-php "/php/php.exe"
  8907.  
  8908. # For PHP 5
  8909. Action application/x-httpd-php "/php/php-cgi.exe"</PRE
  8910. ></TD
  8911. ></TR
  8912. ></TABLE
  8913. ></DIV
  8914. ></TD
  8915. ></TR
  8916. ></TABLE
  8917. >
  8918.      </P
  8919. ><DIV
  8920. CLASS="warning"
  8921. ><P
  8922. ></P
  8923. ><TABLE
  8924. CLASS="warning"
  8925. BORDER="1"
  8926. WIDTH="100%"
  8927. ><TR
  8928. ><TD
  8929. ALIGN="CENTER"
  8930. ><B
  8931. >Warnung</B
  8932. ></TD
  8933. ></TR
  8934. ><TR
  8935. ><TD
  8936. ALIGN="LEFT"
  8937. ><P
  8938. >By using the CGI setup, your server
  8939. is open to several possible attacks. Please read our
  8940. <A
  8941. HREF="#security.cgi-bin"
  8942. >CGI security section</A
  8943. > to learn how to
  8944. defend yourself from those attacks.</P
  8945. ></TD
  8946. ></TR
  8947. ></TABLE
  8948. ></DIV
  8949. ></DIV
  8950. ><DIV
  8951. CLASS="sect2"
  8952. ><HR><H3
  8953. CLASS="sect2"
  8954. ><A
  8955. NAME="install.windows.apache2.module"
  8956. >Installing as an Apache module</A
  8957. ></H3
  8958. ><P
  8959. >       You need to insert these two lines to your
  8960.       Apache <TT
  8961. CLASS="filename"
  8962. >httpd.conf</TT
  8963. > configuration file to set up the
  8964.       PHP module for Apache 2.0:
  8965.       <TABLE
  8966. WIDTH="100%"
  8967. BORDER="0"
  8968. CELLPADDING="0"
  8969. CELLSPACING="0"
  8970. CLASS="EXAMPLE"
  8971. ><TR
  8972. ><TD
  8973. ><DIV
  8974. CLASS="example"
  8975. ><A
  8976. NAME="AEN1517"
  8977. ></A
  8978. ><P
  8979. ><B
  8980. >Beispiel 6-6. PHP and Apache 2.0 as Module</B
  8981. ></P
  8982. ><TABLE
  8983. BORDER="0"
  8984. BGCOLOR="#E0E0E0"
  8985. CELLPADDING="5"
  8986. ><TR
  8987. ><TD
  8988. ><PRE
  8989. CLASS="apache-conf"
  8990. ># For PHP 4 do something like this:
  8991. LoadModule php4_module "c:/php/sapi/php4apache2.dll"
  8992. AddType application/x-httpd-php .php
  8993.  
  8994. # For PHP 5 do something like this:
  8995. LoadModule php5_module "c:/php/php5apache2.dll"
  8996. AddType application/x-httpd-php .php
  8997.  
  8998. # configure the path to php.ini
  8999. PHPIniDir "C:/php"</PRE
  9000. ></TD
  9001. ></TR
  9002. ></TABLE
  9003. ></DIV
  9004. ></TD
  9005. ></TR
  9006. ></TABLE
  9007. >
  9008.      </P
  9009. ><DIV
  9010. CLASS="note"
  9011. ><BLOCKQUOTE
  9012. CLASS="note"
  9013. ><P
  9014. ><B
  9015. >Anmerkung: </B
  9016. >
  9017.        Remember to substitute the <TT
  9018. CLASS="filename"
  9019. >c:/php/</TT
  9020. > for your actual
  9021.        path to PHP in the above examples. Take care to use
  9022.        either <TT
  9023. CLASS="filename"
  9024. >php4apache2.dll</TT
  9025. > or 
  9026.        <TT
  9027. CLASS="filename"
  9028. >php5apache2.dll</TT
  9029. > in your LoadModule directive and
  9030.        <SPAN
  9031. CLASS="emphasis"
  9032. ><I
  9033. CLASS="emphasis"
  9034. >not</I
  9035. ></SPAN
  9036. > <TT
  9037. CLASS="filename"
  9038. >php4apache.dll</TT
  9039. > or 
  9040.        <TT
  9041. CLASS="filename"
  9042. >php5apache.dll</TT
  9043. > as the latter ones are designed to
  9044.        run with <A
  9045. HREF="#install.windows.apache1"
  9046. >Apache 1.3.x</A
  9047. >.
  9048.       </P
  9049. ></BLOCKQUOTE
  9050. ></DIV
  9051. ><DIV
  9052. CLASS="warning"
  9053. ><P
  9054. ></P
  9055. ><TABLE
  9056. CLASS="warning"
  9057. BORDER="1"
  9058. WIDTH="100%"
  9059. ><TR
  9060. ><TD
  9061. ALIGN="CENTER"
  9062. ><B
  9063. >Warnung</B
  9064. ></TD
  9065. ></TR
  9066. ><TR
  9067. ><TD
  9068. ALIGN="LEFT"
  9069. ><P
  9070. >        Don't mix up your installation with DLL files from
  9071.        <SPAN
  9072. CLASS="emphasis"
  9073. ><I
  9074. CLASS="emphasis"
  9075. >different PHP versions</I
  9076. ></SPAN
  9077. >. You have the only choice
  9078.        to use the DLL's and extensions that ship with your downloaded PHP version.
  9079.       </P
  9080. ></TD
  9081. ></TR
  9082. ></TABLE
  9083. ></DIV
  9084. ></DIV
  9085. ></DIV
  9086. ><DIV
  9087. CLASS="sect1"
  9088. ><HR><H2
  9089. CLASS="sect1"
  9090. ><A
  9091. NAME="install.windows.sun"
  9092. >Sun, iPlanet and Netscape servers on Microsoft Windows</A
  9093. ></H2
  9094. ><P
  9095. >     This section contains notes and hints specific to Sun Java System Web Server,
  9096.     Sun ONE Web Server, iPlanet and Netscape server installs of PHP on Windows.
  9097.    </P
  9098. ><P
  9099. >     From PHP 4.3.3 on you can use PHP scripts with the
  9100.     <A
  9101. HREF="#ref.nsapi"
  9102. >NSAPI module</A
  9103. > to 
  9104.     <A
  9105. HREF="#install.windows.sun.specialpages"
  9106. >generate custom
  9107.     directory listings and error pages</A
  9108. >. Additional functions for
  9109.     Apache compatibility are also available. For support in current webservers
  9110.     read the <A
  9111. HREF="#install.windows.sun.notes"
  9112. >note about
  9113.     subrequests</A
  9114. >.
  9115.    </P
  9116. ><DIV
  9117. CLASS="sect2"
  9118. ><HR><H3
  9119. CLASS="sect2"
  9120. ><A
  9121. NAME="install.windows.sun.cgi"
  9122. >CGI setup on Sun, iPlanet and Netscape servers</A
  9123. ></H3
  9124. ><P
  9125. >      To install PHP as a CGI handler, do the following:
  9126.     </P
  9127. ><P
  9128. ></P
  9129. ><UL
  9130. ><LI
  9131. ><P
  9132. >        Copy <TT
  9133. CLASS="filename"
  9134. >php4ts.dll</TT
  9135. > to your systemroot
  9136.        (the directory where you installed Windows)
  9137.       </P
  9138. ></LI
  9139. ><LI
  9140. ><P
  9141. >        Make a file association from the command line.
  9142.        Type the following two lines:
  9143.        <TABLE
  9144. BORDER="0"
  9145. BGCOLOR="#E0E0E0"
  9146. CELLPADDING="5"
  9147. ><TR
  9148. ><TD
  9149. ><PRE
  9150. CLASS="shell"
  9151. >assoc .php=PHPScript
  9152. ftype PHPScript=c:\php\php.exe %1 %*</PRE
  9153. ></TD
  9154. ></TR
  9155. ></TABLE
  9156. >
  9157.       </P
  9158. ></LI
  9159. ><LI
  9160. ><P
  9161. >        In the Netscape Enterprise Administration Server create
  9162.        a dummy shellcgi directory and remove it just after (this
  9163.        step creates 5 important lines in obj.conf and allow the
  9164.        web server to handle shellcgi scripts).
  9165.       </P
  9166. ></LI
  9167. ><LI
  9168. ><P
  9169. >        In the Netscape Enterprise Administration Server create
  9170.        a new mime type (Category: type,
  9171.        Content-Type: magnus-internal/shellcgi, File Suffix:php).
  9172.       </P
  9173. ></LI
  9174. ><LI
  9175. ><P
  9176. >        Do it for each web server instance you want PHP to run
  9177.       </P
  9178. ></LI
  9179. ></UL
  9180. ><P
  9181. >      More details about setting up
  9182.      PHP as a CGI executable can be found here:
  9183.      <A
  9184. HREF="http://benoit.noss.free.fr/php/install-php.html"
  9185. TARGET="_top"
  9186. >http://benoit.noss.free.fr/php/install-php.html</A
  9187. >
  9188.     </P
  9189. ></DIV
  9190. ><DIV
  9191. CLASS="sect2"
  9192. ><HR><H3
  9193. CLASS="sect2"
  9194. ><A
  9195. NAME="install.windows.sun.nsapi"
  9196. >NSAPI setup on Sun, iPlanet and Netscape servers</A
  9197. ></H3
  9198. ><P
  9199. >      To install PHP with NSAPI, do the following:
  9200.     </P
  9201. ><P
  9202. ></P
  9203. ><UL
  9204. ><LI
  9205. ><P
  9206. >        Copy <TT
  9207. CLASS="filename"
  9208. >php4ts.dll</TT
  9209. > to your systemroot
  9210.        (the directory where you installed Windows)
  9211.       </P
  9212. ></LI
  9213. ><LI
  9214. ><P
  9215. >        Make a file association from the command line.
  9216.        Type the following two lines:
  9217.        <TABLE
  9218. BORDER="0"
  9219. BGCOLOR="#E0E0E0"
  9220. CELLPADDING="5"
  9221. ><TR
  9222. ><TD
  9223. ><PRE
  9224. CLASS="shell"
  9225. >assoc .php=PHPScript
  9226. ftype PHPScript=c:\php\php.exe %1 %*</PRE
  9227. ></TD
  9228. ></TR
  9229. ></TABLE
  9230. >
  9231.       </P
  9232. ></LI
  9233. ><LI
  9234. ><P
  9235. >        In the Netscape Enterprise Administration Server create
  9236.        a new mime type (Category: type,
  9237.        Content-Type: magnus-internal/x-httpd-php, File Suffix: php).
  9238.       </P
  9239. ></LI
  9240. ><LI
  9241. ><P
  9242. >         Edit <TT
  9243. CLASS="filename"
  9244. >magnus.conf</TT
  9245. > (for servers >= 6) or
  9246.         <TT
  9247. CLASS="filename"
  9248. >obj.conf</TT
  9249. > (for servers < 6) and add the following:
  9250.         You should
  9251.         place the lines after <VAR
  9252. CLASS="literal"
  9253. >mime types init</VAR
  9254. >.
  9255.        <TABLE
  9256. BORDER="0"
  9257. BGCOLOR="#E0E0E0"
  9258. CELLPADDING="5"
  9259. ><TR
  9260. ><TD
  9261. ><PRE
  9262. CLASS="programlisting"
  9263. >Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="c:/php/sapi/php4nsapi.dll"
  9264. Init fn="php4_init" LateInit="yes" errorString="Failed to initialise PHP!" [php_ini="c:/path/to/php.ini"]</PRE
  9265. ></TD
  9266. ></TR
  9267. ></TABLE
  9268. >
  9269.        (PHP >= 4.3.3) The <VAR
  9270. CLASS="literal"
  9271. >php_ini</VAR
  9272. > parameter is
  9273.        optional but with it you can place your
  9274.        <TT
  9275. CLASS="filename"
  9276. >php.ini</TT
  9277. > in your webserver config directory.
  9278.       </P
  9279. ></LI
  9280. ><LI
  9281. ><P
  9282. >        Configure the default object in <TT
  9283. CLASS="filename"
  9284. >obj.conf</TT
  9285. >
  9286.        (for virtual server classes [Sun Web Server 6.0+] in
  9287.        their <TT
  9288. CLASS="filename"
  9289. >vserver.obj.conf</TT
  9290. >):
  9291.        In the <VAR
  9292. CLASS="literal"
  9293. ><Object name="default"></VAR
  9294. >
  9295.        section, place this line necessarily after all 'ObjectType'
  9296.        and before all 'AddLog' lines:
  9297.        <TABLE
  9298. BORDER="0"
  9299. BGCOLOR="#E0E0E0"
  9300. CELLPADDING="5"
  9301. ><TR
  9302. ><TD
  9303. ><PRE
  9304. CLASS="programlisting"
  9305. >Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]</PRE
  9306. ></TD
  9307. ></TR
  9308. ></TABLE
  9309. >
  9310.        (PHP >= 4.3.3) As additional parameters you can add some special
  9311.        <TT
  9312. CLASS="filename"
  9313. >php.ini</TT
  9314. >-values, for example you
  9315.        can set a <VAR
  9316. CLASS="literal"
  9317. >docroot="/path/to/docroot"</VAR
  9318. >
  9319.        specific to the context <VAR
  9320. CLASS="literal"
  9321. >php4_execute</VAR
  9322. >
  9323.        is called. For boolean ini-keys please use 0/1 as value,
  9324.        not <VAR
  9325. CLASS="literal"
  9326. >"On","Off",...</VAR
  9327. >
  9328.        (this will not work correctly), e.g.
  9329.        <VAR
  9330. CLASS="literal"
  9331. >zlib.output_compression=1</VAR
  9332. > instead of
  9333.        <VAR
  9334. CLASS="literal"
  9335. >zlib.output_compression="On"</VAR
  9336. >
  9337.       </P
  9338. ></LI
  9339. ><LI
  9340. ><P
  9341. >        This is only needed if you want to configure a directory that only consists of
  9342.        PHP scripts (same like a cgi-bin directory):
  9343.        <TABLE
  9344. BORDER="0"
  9345. BGCOLOR="#E0E0E0"
  9346. CELLPADDING="5"
  9347. ><TR
  9348. ><TD
  9349. ><PRE
  9350. CLASS="programlisting"
  9351. ><Object name="x-httpd-php">
  9352. ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
  9353. Service fn=php4_execute [inikey=value inikey=value ...]
  9354. </Object></PRE
  9355. ></TD
  9356. ></TR
  9357. ></TABLE
  9358. >
  9359.        After that you can configure a directory in the Administration server and assign it
  9360.        the style <VAR
  9361. CLASS="literal"
  9362. >x-httpd-php</VAR
  9363. >. All files in it will get executed as PHP.
  9364.        This is nice to hide PHP usage by renaming files to <TT
  9365. CLASS="filename"
  9366. >.html</TT
  9367. >.
  9368.       </P
  9369. ></LI
  9370. ><LI
  9371. ><P
  9372. >        Restart your web service and apply changes
  9373.       </P
  9374. ></LI
  9375. ><LI
  9376. ><P
  9377. >        Do it for each web server instance you want PHP to run
  9378.       </P
  9379. ></LI
  9380. ></UL
  9381. ><DIV
  9382. CLASS="note"
  9383. ><BLOCKQUOTE
  9384. CLASS="note"
  9385. ><P
  9386. ><B
  9387. >Anmerkung: </B
  9388. >
  9389.       More details about setting up
  9390.       PHP as an NSAPI filter can be found here:
  9391.       <A
  9392. HREF="http://benoit.noss.free.fr/php/install-php4.html"
  9393. TARGET="_top"
  9394. >http://benoit.noss.free.fr/php/install-php4.html</A
  9395. >
  9396.      </P
  9397. ></BLOCKQUOTE
  9398. ></DIV
  9399. ><DIV
  9400. CLASS="note"
  9401. ><BLOCKQUOTE
  9402. CLASS="note"
  9403. ><P
  9404. ><B
  9405. >Anmerkung: </B
  9406. >
  9407.       The stacksize that PHP uses depends on the configuration of the webserver. If you get
  9408.       crashes with very large PHP scripts, it is recommended to raise it with the Admin Server
  9409.       (in the section "MAGNUS EDITOR").
  9410.      </P
  9411. ></BLOCKQUOTE
  9412. ></DIV
  9413. ></DIV
  9414. ><DIV
  9415. CLASS="sect2"
  9416. ><HR><H3
  9417. CLASS="sect2"
  9418. ><A
  9419. NAME="install.windows.sun.phpini"
  9420. >CGI environment and recommended modifications in php.ini</A
  9421. ></H3
  9422. ><P
  9423. >      Important when writing PHP scripts is the fact that Sun JSWS/Sun ONE
  9424.      WS/iPlanet/Netscape is a multithreaded web server. Because of that all
  9425.      requests are running in the same process space (the space of the webserver
  9426.      itself) and this space has only one environment. If you want to get CGI
  9427.      variables like <VAR
  9428. CLASS="literal"
  9429. >PATH_INFO</VAR
  9430. >, <VAR
  9431. CLASS="literal"
  9432. >HTTP_HOST</VAR
  9433. >
  9434.      etc. it is not the correct way to try this in the old PHP 3.x way with
  9435.      <A
  9436. HREF="#function.getenv"
  9437. ><B
  9438. CLASS="function"
  9439. >getenv()</B
  9440. ></A
  9441. > or a similar way (register globals to
  9442.      environment, <VAR
  9443. CLASS="literal"
  9444. >$_ENV</VAR
  9445. >). You would only get the environment
  9446.      of the running webserver without any valid CGI variables!
  9447.     </P
  9448. ><DIV
  9449. CLASS="note"
  9450. ><BLOCKQUOTE
  9451. CLASS="note"
  9452. ><P
  9453. ><B
  9454. >Anmerkung: </B
  9455. >
  9456.       Why are there (invalid) CGI variables in the environment?
  9457.      </P
  9458. ><P
  9459. >       Answer: This is because you started the webserver process from the admin server
  9460.       which runs the startup script of the webserver, you wanted to start, as a CGI script
  9461.       (a CGI script inside of the admin server!). This is why the environment of
  9462.       the started webserver has some CGI environment variables in it. You can test
  9463.       this by starting the webserver not from the administration server. Use
  9464.       the command line as root user and start it manually - you will see
  9465.       there are no CGI-like environment variables.
  9466.      </P
  9467. ></BLOCKQUOTE
  9468. ></DIV
  9469. ><P
  9470. >      Simply change your scripts to get CGI variables in the correct way for
  9471.      PHP 4.x by using the superglobal <VAR
  9472. CLASS="literal"
  9473. >$_SERVER</VAR
  9474. >. If you have
  9475.      older scripts which use <VAR
  9476. CLASS="literal"
  9477. >$HTTP_HOST</VAR
  9478. >, etc., you should turn
  9479.      on <VAR
  9480. CLASS="literal"
  9481. >register_globals</VAR
  9482. > in <TT
  9483. CLASS="filename"
  9484. >php.ini</TT
  9485. > and change the variable
  9486.      order too (important: remove <VAR
  9487. CLASS="literal"
  9488. >"E"</VAR
  9489. > from it,
  9490.      because you do not need the environment here):
  9491.      <TABLE
  9492. BORDER="0"
  9493. BGCOLOR="#E0E0E0"
  9494. CELLPADDING="5"
  9495. ><TR
  9496. ><TD
  9497. ><PRE
  9498. CLASS="programlisting"
  9499. >variables_order = "GPCS"
  9500. register_globals = On</PRE
  9501. ></TD
  9502. ></TR
  9503. ></TABLE
  9504. >
  9505.     </P
  9506. ></DIV
  9507. ><DIV
  9508. CLASS="sect2"
  9509. ><HR><H3
  9510. CLASS="sect2"
  9511. ><A
  9512. NAME="install.windows.sun.specialpages"
  9513. >Special use for error pages or self-made directory listings (PHP >= 4.3.3)</A
  9514. ></H3
  9515. ><P
  9516. >      You can use PHP to generate the error pages for <VAR
  9517. CLASS="literal"
  9518. >"404 Not Found"</VAR
  9519. >
  9520.      or similar. Add the following line to the object in <TT
  9521. CLASS="filename"
  9522. >obj.conf</TT
  9523. > for
  9524.      every error page you want to overwrite:
  9525.      <TABLE
  9526. BORDER="0"
  9527. BGCOLOR="#E0E0E0"
  9528. CELLPADDING="5"
  9529. ><TR
  9530. ><TD
  9531. ><PRE
  9532. CLASS="programlisting"
  9533. >Error fn="php4_execute" code=XXX script="/path/to/script.php" [inikey=value inikey=value...]</PRE
  9534. ></TD
  9535. ></TR
  9536. ></TABLE
  9537. >
  9538.      where <VAR
  9539. CLASS="literal"
  9540. >XXX</VAR
  9541. > is the HTTP error code. Please delete
  9542.      any other <VAR
  9543. CLASS="literal"
  9544. >Error</VAR
  9545. > directives which could interfere with yours.
  9546.      If you want to place a page for all errors that could exist, leave
  9547.      the <VAR
  9548. CLASS="literal"
  9549. >code</VAR
  9550. > parameter out. Your script can get the HTTP status code
  9551.      with <VAR
  9552. CLASS="literal"
  9553. >$_SERVER['ERROR_TYPE']</VAR
  9554. >.
  9555.     </P
  9556. ><P
  9557. >      Another possibility is to generate self-made directory listings.
  9558.      Just create a PHP script which displays a directory listing and
  9559.      replace the corresponding default Service line for
  9560.      <VAR
  9561. CLASS="literal"
  9562. >type="magnus-internal/directory"</VAR
  9563. >
  9564.      in <TT
  9565. CLASS="filename"
  9566. >obj.conf</TT
  9567. > with the following:
  9568.      <TABLE
  9569. BORDER="0"
  9570. BGCOLOR="#E0E0E0"
  9571. CELLPADDING="5"
  9572. ><TR
  9573. ><TD
  9574. ><PRE
  9575. CLASS="programlisting"
  9576. >Service fn="php4_execute" type="magnus-internal/directory" script="/path/to/script.php" [inikey=value inikey=value...]</PRE
  9577. ></TD
  9578. ></TR
  9579. ></TABLE
  9580. >
  9581.      For both error and directory listing pages the original URI and
  9582.      translated URI are in the variables <VAR
  9583. CLASS="literal"
  9584. >$_SERVER['PATH_INFO']</VAR
  9585. > and
  9586.      <VAR
  9587. CLASS="literal"
  9588. >$_SERVER['PATH_TRANSLATED']</VAR
  9589. >.
  9590.     </P
  9591. ></DIV
  9592. ><DIV
  9593. CLASS="sect2"
  9594. ><HR><H3
  9595. CLASS="sect2"
  9596. ><A
  9597. NAME="install.windows.sun.notes"
  9598. >Note about <A
  9599. HREF="#function.nsapi-virtual"
  9600. ><B
  9601. CLASS="function"
  9602. >nsapi_virtual()</B
  9603. ></A
  9604. > and subrequests (PHP >= 4.3.3)</A
  9605. ></H3
  9606. ><P
  9607. >      The NSAPI module now supports the <A
  9608. HREF="#function.nsapi-virtual"
  9609. ><B
  9610. CLASS="function"
  9611. >nsapi_virtual()</B
  9612. ></A
  9613. > function
  9614.      (alias: <A
  9615. HREF="#function.virtual"
  9616. ><B
  9617. CLASS="function"
  9618. >virtual()</B
  9619. ></A
  9620. >)
  9621.      to make subrequests on the webserver and insert the result in the webpage.
  9622.      The problem is, that this function uses some undocumented features from
  9623.      the NSAPI library.
  9624.     </P
  9625. ><P
  9626. >      Under Unix this is not a problem, because the module automatically looks
  9627.      for the needed functions and uses them if available.
  9628.      If not, <A
  9629. HREF="#function.nsapi-virtual"
  9630. ><B
  9631. CLASS="function"
  9632. >nsapi_virtual()</B
  9633. ></A
  9634. > is disabled.
  9635.     </P
  9636. ><P
  9637. >      Under Windows limitations in the DLL handling need the use of a automatic
  9638.      detection of the most recent <TT
  9639. CLASS="filename"
  9640. >ns-httpdXX.dll</TT
  9641. > file.
  9642.      This is tested for servers till version 6.1. If a newer version of the
  9643.      Sun server is used, the detection fails and <A
  9644. HREF="#function.nsapi-virtual"
  9645. ><B
  9646. CLASS="function"
  9647. >nsapi_virtual()</B
  9648. ></A
  9649. >
  9650.      is disabled.
  9651.     </P
  9652. ><P
  9653. >      If this is the case, try the following:
  9654.      Add the following parameter to <VAR
  9655. CLASS="literal"
  9656. >php4_init</VAR
  9657. > in
  9658.      <TT
  9659. CLASS="filename"
  9660. >magnus.conf</TT
  9661. >/<TT
  9662. CLASS="filename"
  9663. >obj.conf</TT
  9664. >:
  9665.      <TABLE
  9666. BORDER="0"
  9667. BGCOLOR="#E0E0E0"
  9668. CELLPADDING="5"
  9669. ><TR
  9670. ><TD
  9671. ><PRE
  9672. CLASS="programlisting"
  9673. >Init fn=php4_init ... server_lib="ns-httpdXX.dll"</PRE
  9674. ></TD
  9675. ></TR
  9676. ></TABLE
  9677. >
  9678.      where <VAR
  9679. CLASS="literal"
  9680. >XX</VAR
  9681. > is the correct DLL version number.
  9682.      To get it, look in the server-root for the correct DLL name. The
  9683.      DLL with the biggest filesize is the right one.
  9684.     </P
  9685. ><P
  9686. >      You can check the status by using the <A
  9687. HREF="#function.phpinfo"
  9688. ><B
  9689. CLASS="function"
  9690. >phpinfo()</B
  9691. ></A
  9692. > function.
  9693.     </P
  9694. ><DIV
  9695. CLASS="note"
  9696. ><BLOCKQUOTE
  9697. CLASS="note"
  9698. ><P
  9699. ><B
  9700. >Anmerkung: </B
  9701. >
  9702.       But be warned: Support for <A
  9703. HREF="#function.nsapi-virtual"
  9704. ><B
  9705. CLASS="function"
  9706. >nsapi_virtual()</B
  9707. ></A
  9708. > is EXPERIMENTAL!!!
  9709.      </P
  9710. ></BLOCKQUOTE
  9711. ></DIV
  9712. ></DIV
  9713. ></DIV
  9714. ><DIV
  9715. CLASS="sect1"
  9716. ><HR><H2
  9717. CLASS="sect1"
  9718. ><A
  9719. NAME="install.windows.omnihttpd"
  9720. >OmniHTTPd Server</A
  9721. ></H2
  9722. ><P
  9723. >     This section contains notes and hints specific to
  9724.     <A
  9725. HREF="http://www.omnicron.ca/"
  9726. TARGET="_top"
  9727. >OmniHTTPd</A
  9728. > on Windows.
  9729.    </P
  9730. ><DIV
  9731. CLASS="note"
  9732. ><BLOCKQUOTE
  9733. CLASS="note"
  9734. ><P
  9735. ><B
  9736. >Anmerkung: </B
  9737. >
  9738.      You should read the <A
  9739. HREF="#install.windows.manual"
  9740. >manual
  9741.      installation steps</A
  9742. > first!
  9743.     </P
  9744. ></BLOCKQUOTE
  9745. ></DIV
  9746. ><DIV
  9747. CLASS="warning"
  9748. ><P
  9749. ></P
  9750. ><TABLE
  9751. CLASS="warning"
  9752. BORDER="1"
  9753. WIDTH="100%"
  9754. ><TR
  9755. ><TD
  9756. ALIGN="CENTER"
  9757. ><B
  9758. >Warnung</B
  9759. ></TD
  9760. ></TR
  9761. ><TR
  9762. ><TD
  9763. ALIGN="LEFT"
  9764. ><P
  9765. >By using the CGI setup, your server
  9766. is open to several possible attacks. Please read our
  9767. <A
  9768. HREF="#security.cgi-bin"
  9769. >CGI security section</A
  9770. > to learn how to
  9771. defend yourself from those attacks.</P
  9772. ></TD
  9773. ></TR
  9774. ></TABLE
  9775. ></DIV
  9776. ><P
  9777. >     You need to complete the following steps to make PHP
  9778.     work with OmniHTTPd. This is a CGI executable setup.
  9779.     SAPI is supported by OmniHTTPd, but some tests have shown
  9780.     that it is not so stable to use PHP as an ISAPI module.
  9781.    </P
  9782. ><DIV
  9783. CLASS="note"
  9784. ><BLOCKQUOTE
  9785. CLASS="note"
  9786. ><P
  9787. ><B
  9788. >Important for CGI users: </B
  9789. >
  9790.      Read the <A
  9791. HREF="#faq.installation.forceredirect"
  9792. >faq
  9793.      on cgi.force_redirect</A
  9794. > for important details.  This
  9795.      directive needs to be set to <VAR
  9796. CLASS="literal"
  9797. >0</VAR
  9798. >.
  9799.     </P
  9800. ></BLOCKQUOTE
  9801. ></DIV
  9802. ><P
  9803. >     <P
  9804. ></P
  9805. ><OL
  9806. TYPE="1"
  9807. ><LI
  9808. ><P
  9809. >        Install OmniHTTPd server.
  9810.       </P
  9811. ></LI
  9812. ><LI
  9813. ><P
  9814. >        Right click on the blue OmniHTTPd icon in the system
  9815.        tray and select <VAR
  9816. CLASS="literal"
  9817. >Properties</VAR
  9818. >
  9819.       </P
  9820. ></LI
  9821. ><LI
  9822. ><P
  9823. >        Click on <VAR
  9824. CLASS="literal"
  9825. >Web Server Global Settings</VAR
  9826. >
  9827.       </P
  9828. ></LI
  9829. ><LI
  9830. ><P
  9831. >        On the 'External' tab, enter: <VAR
  9832. CLASS="literal"
  9833. >virtual = .php
  9834.         | actual = c:\php\php.exe</VAR
  9835. > (use
  9836.        <TT
  9837. CLASS="filename"
  9838. >php-cgi.exe</TT
  9839. > if installing PHP 5), and use the Add
  9840.        button.
  9841.       </P
  9842. ></LI
  9843. ><LI
  9844. ><P
  9845. >        On the <VAR
  9846. CLASS="literal"
  9847. >Mime</VAR
  9848. > tab, enter:
  9849.        <VAR
  9850. CLASS="literal"
  9851. >virtual = wwwserver/stdcgi | actual = .php</VAR
  9852. >,
  9853.        and use the Add button.
  9854.       </P
  9855. ></LI
  9856. ><LI
  9857. ><P
  9858. >        Click <VAR
  9859. CLASS="literal"
  9860. >OK</VAR
  9861. >
  9862.       </P
  9863. ></LI
  9864. ></OL
  9865. >
  9866.    </P
  9867. ><P
  9868. >     Repeat steps 2 - 6 for each extension you want to associate with PHP.
  9869.    </P
  9870. ><DIV
  9871. CLASS="note"
  9872. ><BLOCKQUOTE
  9873. CLASS="note"
  9874. ><P
  9875. ><B
  9876. >Anmerkung: </B
  9877. >
  9878.      Some OmniHTTPd packages come with built in PHP support.
  9879.      You can choose at setup time to do a custom setup, and
  9880.      uncheck the PHP component. We recommend you to use the latest
  9881.      PHP binaries. Some OmniHTTPd servers come with PHP 4 beta
  9882.      distributions, so you should choose not to set up
  9883.      the built in support, but install your own. If the server
  9884.      is already on your machine, use the Replace button in Step
  9885.      4 and 5 to set the new, correct information.
  9886.     </P
  9887. ></BLOCKQUOTE
  9888. ></DIV
  9889. ></DIV
  9890. ><DIV
  9891. CLASS="sect1"
  9892. ><HR><H2
  9893. CLASS="sect1"
  9894. ><A
  9895. NAME="install.windows.sambar"
  9896. >Sambar Server on Microsoft Windows</A
  9897. ></H2
  9898. ><P
  9899. >      This section contains notes and hints specific to the
  9900.      <A
  9901. HREF="http://www.sambar.com/"
  9902. TARGET="_top"
  9903. >Sambar Server</A
  9904. > for Windows.
  9905.     </P
  9906. ><DIV
  9907. CLASS="note"
  9908. ><BLOCKQUOTE
  9909. CLASS="note"
  9910. ><P
  9911. ><B
  9912. >Anmerkung: </B
  9913. >
  9914.       You should read the <A
  9915. HREF="#install.windows.manual"
  9916. >manual
  9917.        installation steps</A
  9918. > first!
  9919.      </P
  9920. ></BLOCKQUOTE
  9921. ></DIV
  9922. ><P
  9923. >      This list describes how to set up the ISAPI module to
  9924.      work with the Sambar server on Windows.
  9925.     </P
  9926. ><P
  9927. >      <P
  9928. ></P
  9929. ><UL
  9930. ><LI
  9931. ><P
  9932. >         Find the file called <TT
  9933. CLASS="filename"
  9934. >mappings.ini</TT
  9935. > (in the config
  9936.         directory) in the Sambar install directory.
  9937.        </P
  9938. ></LI
  9939. ><LI
  9940. ><P
  9941. >         Open <TT
  9942. CLASS="filename"
  9943. >mappings.ini</TT
  9944. > and add the following line
  9945.         under <VAR
  9946. CLASS="literal"
  9947. >[ISAPI]</VAR
  9948. >:
  9949.       <TABLE
  9950. WIDTH="100%"
  9951. BORDER="0"
  9952. CELLPADDING="0"
  9953. CELLSPACING="0"
  9954. CLASS="EXAMPLE"
  9955. ><TR
  9956. ><TD
  9957. ><DIV
  9958. CLASS="example"
  9959. ><A
  9960. NAME="AEN1715"
  9961. ></A
  9962. ><P
  9963. ><B
  9964. >Beispiel 6-7. ISAPI configuration of Sambar</B
  9965. ></P
  9966. ><TABLE
  9967. BORDER="0"
  9968. BGCOLOR="#E0E0E0"
  9969. CELLPADDING="5"
  9970. ><TR
  9971. ><TD
  9972. ><PRE
  9973. CLASS="programlisting"
  9974. >#for PHP 4
  9975. *.php = c:\php\php4isapi.dll
  9976.  
  9977. #for PHP 5
  9978. *.php = c:\php\php5isapi.dll</PRE
  9979. ></TD
  9980. ></TR
  9981. ></TABLE
  9982. ></DIV
  9983. ></TD
  9984. ></TR
  9985. ></TABLE
  9986. >
  9987.         (This line assumes that PHP was installed in
  9988.         <TT
  9989. CLASS="filename"
  9990. >c:\php</TT
  9991. >.)
  9992.        </P
  9993. ></LI
  9994. ><LI
  9995. ><P
  9996. >         Now restart the Sambar server for the changes to take effect.
  9997.        </P
  9998. ></LI
  9999. ></UL
  10000. >
  10001.     </P
  10002. ></DIV
  10003. ><DIV
  10004. CLASS="sect1"
  10005. ><HR><H2
  10006. CLASS="sect1"
  10007. ><A
  10008. NAME="install.windows.xitami"
  10009. >Xitami on Microsoft Windows</A
  10010. ></H2
  10011. ><P
  10012. >      This section contains notes and hints specific to
  10013.      <A
  10014. HREF="http://www.xitami.com/"
  10015. TARGET="_top"
  10016. >Xitami</A
  10017. > on Windows.
  10018.     </P
  10019. ><DIV
  10020. CLASS="note"
  10021. ><BLOCKQUOTE
  10022. CLASS="note"
  10023. ><P
  10024. ><B
  10025. >Anmerkung: </B
  10026. >
  10027.       You should read the <A
  10028. HREF="#install.windows.manual"
  10029. >manual
  10030.        installation steps</A
  10031. > first!
  10032.      </P
  10033. ></BLOCKQUOTE
  10034. ></DIV
  10035. ><P
  10036. >      This list describes how to set up the PHP CGI binary
  10037.      to work with Xitami on Windows.
  10038.     </P
  10039. ><DIV
  10040. CLASS="note"
  10041. ><BLOCKQUOTE
  10042. CLASS="note"
  10043. ><P
  10044. ><B
  10045. >Important for CGI users: </B
  10046. >
  10047.       Read the <A
  10048. HREF="#faq.installation.forceredirect"
  10049. >faq
  10050.       on cgi.force_redirect</A
  10051. > for important details.  This
  10052.       directive needs to be set to <VAR
  10053. CLASS="literal"
  10054. >0</VAR
  10055. >.
  10056.       If you want to use <VAR
  10057. CLASS="literal"
  10058. >$_SERVER['PHP_SELF']</VAR
  10059. > you have to
  10060.       enable the <A
  10061. HREF="#ini.cgi.fix-pathinfo"
  10062. >cgi.fix_pathinfo</A
  10063. >
  10064.       directive.
  10065.      </P
  10066. ></BLOCKQUOTE
  10067. ></DIV
  10068. ><DIV
  10069. CLASS="warning"
  10070. ><P
  10071. ></P
  10072. ><TABLE
  10073. CLASS="warning"
  10074. BORDER="1"
  10075. WIDTH="100%"
  10076. ><TR
  10077. ><TD
  10078. ALIGN="CENTER"
  10079. ><B
  10080. >Warnung</B
  10081. ></TD
  10082. ></TR
  10083. ><TR
  10084. ><TD
  10085. ALIGN="LEFT"
  10086. ><P
  10087. >By using the CGI setup, your server
  10088. is open to several possible attacks. Please read our
  10089. <A
  10090. HREF="#security.cgi-bin"
  10091. >CGI security section</A
  10092. > to learn how to
  10093. defend yourself from those attacks.</P
  10094. ></TD
  10095. ></TR
  10096. ></TABLE
  10097. ></DIV
  10098. ><P
  10099. >      <P
  10100. ></P
  10101. ><UL
  10102. ><LI
  10103. ><P
  10104. >         Make sure the webserver is running, and point
  10105.         your browser to xitamis admin console
  10106.         (usually <VAR
  10107. CLASS="literal"
  10108. >http://127.0.0.1/admin</VAR
  10109. >),
  10110.         and click on Configuration.
  10111.        </P
  10112. ></LI
  10113. ><LI
  10114. ><P
  10115. >         Navigate to the Filters, and put the
  10116.         extension which PHP should parse (i.e. .php)
  10117.         into the field File extensions (.xxx).
  10118.        </P
  10119. ></LI
  10120. ><LI
  10121. ><P
  10122. >         In Filter command or script put the path and name
  10123.         of your PHP CGI executable i.e. <TT
  10124. CLASS="filename"
  10125. >C:\php\php.exe</TT
  10126. >
  10127.         for PHP 4, or <TT
  10128. CLASS="filename"
  10129. >C:\php\php-cgi.exe</TT
  10130. > for PHP 5.
  10131.        </P
  10132. ></LI
  10133. ><LI
  10134. ><P
  10135. >         Press the 'Save' icon.
  10136.        </P
  10137. ></LI
  10138. ><LI
  10139. ><P
  10140. >         Restart the server to reflect changes.
  10141.        </P
  10142. ></LI
  10143. ></UL
  10144. >
  10145.     </P
  10146. ></DIV
  10147. ><DIV
  10148. CLASS="sect1"
  10149. ><HR><H2
  10150. CLASS="sect1"
  10151. ><A
  10152. NAME="install.windows.build"
  10153. >Building from source</A
  10154. ></H2
  10155. ><P
  10156. >      Before getting started, it is worthwhile answering the question:
  10157.      "Why is building on Windows so hard?" Two reasons come to mind:
  10158.     </P
  10159. ><P
  10160. ></P
  10161. ><OL
  10162. TYPE="1"
  10163. ><LI
  10164. ><P
  10165. >        Windows does not (yet) enjoy a large community of developers
  10166.        who are willing to freely share their source. As a direct
  10167.        result, the necessary investment in infrastructure required
  10168.        to support such development hasn't been made. By and large,
  10169.        what is available has been made possible by the porting of
  10170.        necessary utilities from Unix. Don't be surprised if some of
  10171.        this heritage shows through from time to time.
  10172.       </P
  10173. ></LI
  10174. ><LI
  10175. ><P
  10176. >        Pretty much all of the instructions that follow are of the
  10177.        "set and forget" variety. So sit back and try follow the
  10178.        instructions below as faithfully as you can.
  10179.       </P
  10180. ></LI
  10181. ></OL
  10182. ><DIV
  10183. CLASS="sect2"
  10184. ><HR><H3
  10185. CLASS="sect2"
  10186. ><A
  10187. NAME="install.windows.build.requirement"
  10188. >Anforderungen</A
  10189. ></H3
  10190. ><P
  10191. >       To compile and build PHP you need a Microsoft
  10192.       Development Environment. Microsoft Visual C++ 6.0 is recommended.
  10193.       To extract the downloaded files you need a extraction utility
  10194.       (e.g.: Winzip). If you don't already have an unzip utility, you
  10195.       can get a free version from <A
  10196. HREF="http://www.info-zip.org/pub/infozip/"
  10197. TARGET="_top"
  10198. >InfoZip</A
  10199. >.
  10200.      </P
  10201. ><P
  10202. >       Before you get started, you have to download...
  10203.      </P
  10204. ><P
  10205. ></P
  10206. ><UL
  10207. ><LI
  10208. ><P
  10209. >         ..the win32 buildtools from the PHP site
  10210.         at <A
  10211. HREF="http://www.php.net/extra/win32build.zip"
  10212. TARGET="_top"
  10213. >http://www.php.net/extra/win32build.zip</A
  10214. >.
  10215.        </P
  10216. ></LI
  10217. ><LI
  10218. ><P
  10219. >         ..the source code for the DNS name resolver used by PHP from
  10220.         <A
  10221. HREF="http://www.php.net/extra/bindlib_w32.zip"
  10222. TARGET="_top"
  10223. >         http://www.php.net/extra/bindlib_w32.zip</A
  10224. >. This is a replacement for the 
  10225.         <TT
  10226. CLASS="filename"
  10227. >resolv.lib</TT
  10228. > library included in <TT
  10229. CLASS="filename"
  10230. >         win32build.zip</TT
  10231. >.
  10232.        </P
  10233. ></LI
  10234. ><LI
  10235. ><P
  10236. >         If you plan to compile PHP as a Apache
  10237.         module you will also need the <A
  10238. HREF="http://www.apache.org/dist/httpd/"
  10239. TARGET="_top"
  10240. >Apache
  10241.         sources</A
  10242. >.
  10243.        </P
  10244. ></LI
  10245. ></UL
  10246. ><P
  10247. >       Finally, you are going to need the source to PHP itself. You can get
  10248.       the latest development version using <A
  10249. HREF="http://www.php.net/anoncvs.php"
  10250. TARGET="_top"
  10251. >       anonymous CVS</A
  10252. >, a <A
  10253. HREF="http://snaps.php.net/"
  10254. TARGET="_top"
  10255. >       snapshot</A
  10256. > or the most recent released <A
  10257. HREF="http://www.php.net/downloads.php"
  10258. TARGET="_top"
  10259. >       source</A
  10260. > tarball.
  10261.      </P
  10262. ></DIV
  10263. ><DIV
  10264. CLASS="sect2"
  10265. ><HR><H3
  10266. CLASS="sect2"
  10267. ><A
  10268. NAME="install.windows.build.install"
  10269. >Putting it all together</A
  10270. ></H3
  10271. ><P
  10272. >       After downloading the required packages you have to extract them in a
  10273.       proper place.
  10274.       <P
  10275. ></P
  10276. ><UL
  10277. ><LI
  10278. ><P
  10279. >          Create a working directory where all files end up after extracting, e.g:
  10280.          <TT
  10281. CLASS="filename"
  10282. >C:\work</TT
  10283. >.
  10284.         </P
  10285. ></LI
  10286. ><LI
  10287. ><P
  10288. >          Create the directory <TT
  10289. CLASS="filename"
  10290. >win32build</TT
  10291. > under your
  10292.          working directory (<TT
  10293. CLASS="filename"
  10294. >C:\work</TT
  10295. >) and unzip <TT
  10296. CLASS="filename"
  10297. >          win32build.zip</TT
  10298. > into it.
  10299.         </P
  10300. ></LI
  10301. ><LI
  10302. ><P
  10303. >          Create the directory <TT
  10304. CLASS="filename"
  10305. >bindlib_w32</TT
  10306. > under your
  10307.          working directory (<TT
  10308. CLASS="filename"
  10309. >C:\work</TT
  10310. >) and unzip <TT
  10311. CLASS="filename"
  10312. >          bindlib_w32.zip</TT
  10313. > into it.
  10314.         </P
  10315. ></LI
  10316. ><LI
  10317. ><P
  10318. >          Extract the downloaded PHP source code into your working directory
  10319.          (<TT
  10320. CLASS="filename"
  10321. >C:\work</TT
  10322. >).
  10323.         </P
  10324. ></LI
  10325. ></UL
  10326. >
  10327.       Following this steps your directory structure looks like this:
  10328.       <DIV
  10329. CLASS="informalexample"
  10330. ><P
  10331. ></P
  10332. ><A
  10333. NAME="AEN1803"
  10334. ></A
  10335. ><TABLE
  10336. BORDER="0"
  10337. BGCOLOR="#E0E0E0"
  10338. CELLPADDING="5"
  10339. ><TR
  10340. ><TD
  10341. ><PRE
  10342. CLASS="programlisting"
  10343. >+--c:\work
  10344. |  |
  10345. |  +--bindlib_w32
  10346. |  |  |
  10347. |  |  +--arpa
  10348. |  |  |
  10349. |  |  +--conf
  10350. |  |  |
  10351. |  |  +--...
  10352. |  |
  10353. |  +--php-4.x.x
  10354. |  |  |
  10355. |  |  +--build
  10356. |  |  |
  10357. |  |  +--...
  10358. |  |  |
  10359. |  |  +--win32
  10360. |  |  |
  10361. |  |  +--...
  10362. |  |
  10363. |  +--win32build
  10364. |  |  |
  10365. |  |  +--bin
  10366. |  |  |
  10367. |  |  +--include
  10368. |  |  |
  10369. |  |  +--lib</PRE
  10370. ></TD
  10371. ></TR
  10372. ></TABLE
  10373. ><P
  10374. ></P
  10375. ></DIV
  10376. >
  10377.       Create the directories <TT
  10378. CLASS="filename"
  10379. >c:\usr\local\lib</TT
  10380. >. Copy
  10381.       <TT
  10382. CLASS="filename"
  10383. >bison.simple</TT
  10384. > from <TT
  10385. CLASS="filename"
  10386. >c:\work\win32build\bin
  10387.       </TT
  10388. > to <TT
  10389. CLASS="filename"
  10390. >c:\usr\local\lib</TT
  10391. >.
  10392.      </P
  10393. ><DIV
  10394. CLASS="note"
  10395. ><BLOCKQUOTE
  10396. CLASS="note"
  10397. ><P
  10398. ><B
  10399. >Anmerkung: </B
  10400. >
  10401.        <A
  10402. HREF="http://www.cygwin.com/"
  10403. TARGET="_top"
  10404. >Cygwin</A
  10405. > users may omit the last
  10406.        step. A properly installed Cygwin environment provides the mandatory
  10407.        files <TT
  10408. CLASS="filename"
  10409. >bison.simple</TT
  10410. > and
  10411.        <TT
  10412. CLASS="filename"
  10413. >bison.exe</TT
  10414. >.
  10415.       </P
  10416. ></BLOCKQUOTE
  10417. ></DIV
  10418. ></DIV
  10419. ><DIV
  10420. CLASS="sect2"
  10421. ><HR><H3
  10422. CLASS="sect2"
  10423. ><A
  10424. NAME="install.windows.build.configure"
  10425. >Configure MVC ++</A
  10426. ></H3
  10427. ><P
  10428. >        The next step is to configure MVC ++ to prepare for compiling.
  10429.        Launch Microsoft Visual C++, and from the menu select
  10430.        Tools => Options. In the dialog, select the
  10431.        directories tab. Sequentially change the dropdown
  10432.        to Executables, Includes, and Library files. Your entries should look
  10433.        like this:
  10434.        <P
  10435. ></P
  10436. ><UL
  10437. ><LI
  10438. ><P
  10439. >           Executable files: <TT
  10440. CLASS="filename"
  10441. >c:\work\win32build\bin</TT
  10442. >,
  10443.           Cygwin users: <TT
  10444. CLASS="filename"
  10445. >cygwin\bin</TT
  10446. >
  10447.          </P
  10448. ></LI
  10449. ><LI
  10450. ><P
  10451. >           Include files: <TT
  10452. CLASS="filename"
  10453. >c:\work\win32build\include</TT
  10454. >
  10455.          </P
  10456. ></LI
  10457. ><LI
  10458. ><P
  10459. >           Library files: <TT
  10460. CLASS="filename"
  10461. >c:\work\win32build\lib</TT
  10462. >
  10463.          </P
  10464. ></LI
  10465. ></UL
  10466. >
  10467.       </P
  10468. ></DIV
  10469. ><DIV
  10470. CLASS="sect2"
  10471. ><HR><H3
  10472. CLASS="sect2"
  10473. ><A
  10474. NAME="install.windows.build.resolvlib"
  10475. >Build resolv.lib</A
  10476. ></H3
  10477. ><P
  10478. >        You must build the <TT
  10479. CLASS="filename"
  10480. >resolv.lib</TT
  10481. > library.
  10482.        Decide whether you want to have debug symbols available
  10483.        (bindlib - Win32 Debug) or not (bindlib - Win32 Release).
  10484.        Build the appropriate configuration: 
  10485.        <P
  10486. ></P
  10487. ><UL
  10488. ><LI
  10489. ><P
  10490. >           For GUI users, launch VC++, and then select File => Open
  10491.           Workspace, navigate to <TT
  10492. CLASS="filename"
  10493. >c:\work\bindlib_w32</TT
  10494. > and
  10495.           select <TT
  10496. CLASS="filename"
  10497. >bindlib.dsw</TT
  10498. >. Then select Build=>Set
  10499.           Active Configuration and select the desired configuration.
  10500.           Finally select Build=>Rebuild All.
  10501.          </P
  10502. ></LI
  10503. ><LI
  10504. ><P
  10505. >           For command line users, make sure that you either have the C++
  10506.           environment variables registered, or have run
  10507.           <B
  10508. CLASS="command"
  10509. >vcvars.bat</B
  10510. >, and then execute one of the following
  10511.           commands:
  10512.          </P
  10513. ><P
  10514. ></P
  10515. ><UL
  10516. ><LI
  10517. ><P
  10518. >             <KBD
  10519. CLASS="userinput"
  10520. >msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"</KBD
  10521. >
  10522.            </P
  10523. ></LI
  10524. ><LI
  10525. ><P
  10526. >             <KBD
  10527. CLASS="userinput"
  10528. >msdev bindlib.dsp /MAKE "bindlib - Win32 Release"</KBD
  10529. >
  10530.            </P
  10531. ></LI
  10532. ></UL
  10533. ></LI
  10534. ></UL
  10535. >
  10536.        At this point, you should have a usable <TT
  10537. CLASS="filename"
  10538. >resolv.lib</TT
  10539. >
  10540.        in either your <TT
  10541. CLASS="filename"
  10542. >c:\work\bindlib_w32\Debug</TT
  10543. > or
  10544.        <TT
  10545. CLASS="filename"
  10546. >Release</TT
  10547. > subdirectories. Copy this file into your
  10548.        <TT
  10549. CLASS="filename"
  10550. >c:\work\win32build\lib</TT
  10551. > directory over the file
  10552.        by the same name found in there.
  10553.       </P
  10554. ></DIV
  10555. ><DIV
  10556. CLASS="sect2"
  10557. ><HR><H3
  10558. CLASS="sect2"
  10559. ><A
  10560. NAME="install.windows.build.compile"
  10561. >Compiling</A
  10562. ></H3
  10563. ><P
  10564. >       The best way to get started is to build the CGI version.
  10565.      </P
  10566. ><P
  10567. ></P
  10568. ><UL
  10569. ><LI
  10570. ><P
  10571. >         For GUI users, launch VC++, and then select File => Open
  10572.         Workspace and select <TT
  10573. CLASS="filename"
  10574. >c:\work\php-4.x.x\win32\php4ts.dsw
  10575.         </TT
  10576. >. Then select Build=>Set Active
  10577.         Configuration and select the desired configuration, either
  10578.         <VAR
  10579. CLASS="literal"
  10580. >php4ts - Win32 Debug_TS</VAR
  10581. > or
  10582.         <VAR
  10583. CLASS="literal"
  10584. >php4ts - Win32 Release_TS</VAR
  10585. >. Finally select
  10586.         Build=>Rebuild All.
  10587.        </P
  10588. ></LI
  10589. ><LI
  10590. ><P
  10591. >         For command line users, make sure that you either have
  10592.         the C++ environment variables registered, or have run
  10593.         <B
  10594. CLASS="command"
  10595. >vcvars.bat</B
  10596. >, and then execute one of the
  10597.         following commands from the <TT
  10598. CLASS="filename"
  10599. >c:\work\php-4.x.x\win32
  10600.         </TT
  10601. > directory:
  10602.        </P
  10603. ><P
  10604. ></P
  10605. ><UL
  10606. ><LI
  10607. ><P
  10608. >           <KBD
  10609. CLASS="userinput"
  10610. >msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"</KBD
  10611. >
  10612.          </P
  10613. ></LI
  10614. ><LI
  10615. ><P
  10616. >           <KBD
  10617. CLASS="userinput"
  10618. >msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"</KBD
  10619. >
  10620.          </P
  10621. ></LI
  10622. ><LI
  10623. ><P
  10624. >           At this point, you should have a usable <TT
  10625. CLASS="filename"
  10626. >php.exe</TT
  10627. >
  10628.           in either your <TT
  10629. CLASS="filename"
  10630. >c:\work\php-4.x.x.\Debug_TS</TT
  10631. > or
  10632.           <TT
  10633. CLASS="filename"
  10634. >Release_TS</TT
  10635. > subdirectories.
  10636.          </P
  10637. ></LI
  10638. ></UL
  10639. ></LI
  10640. ></UL
  10641. ><P
  10642. >       It is possible to do minor customization to the build process by editing
  10643.       the <TT
  10644. CLASS="filename"
  10645. >main/config.win32.h</TT
  10646. > file. For example you can
  10647.       change the default location of <TT
  10648. CLASS="filename"
  10649. >php.ini</TT
  10650. >, the built-in extensions, and the
  10651.       default location for your extensions.
  10652.      </P
  10653. ><P
  10654. >       Next you may want to build the CLI version which is designed to use
  10655.       <A
  10656. HREF="#features.commandline"
  10657. >PHP from the command line</A
  10658. >.
  10659.       The steps are the same as for building the CGI version, except you have
  10660.       to select the <VAR
  10661. CLASS="literal"
  10662. >php4ts_cli - Win32 Debug_TS</VAR
  10663. > or
  10664.       <VAR
  10665. CLASS="literal"
  10666. >php4ts_cli - Win32 Release_TS</VAR
  10667. > project file. After a
  10668.       successful compiling run you will find the <TT
  10669. CLASS="filename"
  10670. >php.exe</TT
  10671. >
  10672.       in either the directory <TT
  10673. CLASS="filename"
  10674. >Release_TS\cli\</TT
  10675. > or
  10676.       <TT
  10677. CLASS="filename"
  10678. >Debug_TS\cli\</TT
  10679. >.
  10680.      </P
  10681. ><DIV
  10682. CLASS="note"
  10683. ><BLOCKQUOTE
  10684. CLASS="note"
  10685. ><P
  10686. ><B
  10687. >Anmerkung: </B
  10688. >
  10689.        If you want to use PEAR and the comfortable command line installer,
  10690.        the CLI-SAPI is mandatory. For more information about PEAR and the
  10691.        installer read the documentation at the <A
  10692. HREF="http://pear.php.net/manual/"
  10693. TARGET="_top"
  10694. >        PEAR</A
  10695. > website.
  10696.       </P
  10697. ></BLOCKQUOTE
  10698. ></DIV
  10699. ><P
  10700. >       In order to build the SAPI module (<TT
  10701. CLASS="filename"
  10702. >php4isapi.dll</TT
  10703. >)
  10704.       for integrating PHP with Microsoft IIS, set your active configuration to
  10705.       <TT
  10706. CLASS="filename"
  10707. >php4isapi-whatever-config</TT
  10708. > and build the desired dll.
  10709.      </P
  10710. ></DIV
  10711. ></DIV
  10712. ><DIV
  10713. CLASS="sect1"
  10714. ><HR><H2
  10715. CLASS="sect1"
  10716. ><A
  10717. NAME="install.windows.extensions"
  10718. >Installation of extensions on Windows</A
  10719. ></H2
  10720. ><P
  10721. >      After installing PHP and a webserver on Windows, you will probably want to
  10722.      install some extensions for added functionality. You can choose which
  10723.      extensions you would like to load when PHP starts by modifying your
  10724.      <TT
  10725. CLASS="filename"
  10726. >php.ini</TT
  10727. >. You can also load a module dynamically in your script using
  10728.      <A
  10729. HREF="#function.dl"
  10730. ><B
  10731. CLASS="function"
  10732. >dl()</B
  10733. ></A
  10734. >.
  10735.     </P
  10736. ><P
  10737. >      The DLLs for PHP extensions are prefixed with <VAR
  10738. CLASS="literal"
  10739. >php_</VAR
  10740. >.
  10741.     </P
  10742. ><DIV
  10743. CLASS="note"
  10744. ><BLOCKQUOTE
  10745. CLASS="note"
  10746. ><P
  10747. ><B
  10748. >Anmerkung: </B
  10749. >
  10750.       In PHP 4.3.1 BCMath, Calendar, COM, Ctype, FTP, MySQL, ODBC, Overload,
  10751.       PCRE, Session, Tokenizer, WDDX, XML and Zlib support is
  10752.       <SPAN
  10753. CLASS="emphasis"
  10754. ><I
  10755. CLASS="emphasis"
  10756. >built in</I
  10757. ></SPAN
  10758. >. You don't need to load any additional
  10759.       extensions in order to use these functions. See your distributions
  10760.       <TT
  10761. CLASS="filename"
  10762. >README.txt</TT
  10763. > or <TT
  10764. CLASS="filename"
  10765. >install.txt</TT
  10766. >
  10767.       or <A
  10768. HREF="#install.windows.extensions.overview"
  10769. >this table</A
  10770. >
  10771.       for a list of built in modules.
  10772.      </P
  10773. ></BLOCKQUOTE
  10774. ></DIV
  10775. ><P
  10776. >      The default location PHP searches for extensions is
  10777.      <TT
  10778. CLASS="filename"
  10779. >c:\php4\extensions</TT
  10780. > in PHP 4 and
  10781.      <TT
  10782. CLASS="filename"
  10783. >c:\php5</TT
  10784. > in PHP 5. To change this
  10785.      setting to reflect your setup of PHP edit your <TT
  10786. CLASS="filename"
  10787. >php.ini</TT
  10788. > file:
  10789.      <P
  10790. ></P
  10791. ><UL
  10792. ><LI
  10793. ><P
  10794. >         You will need to change the
  10795.         <A
  10796. HREF="#ini.extension-dir"
  10797. >extension_dir</A
  10798. > setting to
  10799.         point to the directory where your extensions lives, or where you have
  10800.         placed your <TT
  10801. CLASS="filename"
  10802. >php_*.dll</TT
  10803. > files. Please do not
  10804.         forget the last backslash. For example:
  10805.         <DIV
  10806. CLASS="informalexample"
  10807. ><P
  10808. ></P
  10809. ><A
  10810. NAME="AEN1914"
  10811. ></A
  10812. ><TABLE
  10813. BORDER="0"
  10814. BGCOLOR="#E0E0E0"
  10815. CELLPADDING="5"
  10816. ><TR
  10817. ><TD
  10818. ><PRE
  10819. CLASS="ini"
  10820. >extension_dir = c:/php/extensions/</PRE
  10821. ></TD
  10822. ></TR
  10823. ></TABLE
  10824. ><P
  10825. ></P
  10826. ></DIV
  10827. >
  10828.        </P
  10829. ></LI
  10830. ><LI
  10831. ><P
  10832. >        Enable the extension(s) in <TT
  10833. CLASS="filename"
  10834. >php.ini</TT
  10835. > you want to use by uncommenting the
  10836.        <VAR
  10837. CLASS="literal"
  10838. >extension=php_*.dll</VAR
  10839. > lines in <TT
  10840. CLASS="filename"
  10841. >php.ini</TT
  10842. >. This is done
  10843.        by deleting the leading ; form the extension you want to load. 
  10844.        <TABLE
  10845. WIDTH="100%"
  10846. BORDER="0"
  10847. CELLPADDING="0"
  10848. CELLSPACING="0"
  10849. CLASS="EXAMPLE"
  10850. ><TR
  10851. ><TD
  10852. ><DIV
  10853. CLASS="example"
  10854. ><A
  10855. NAME="AEN1921"
  10856. ></A
  10857. ><P
  10858. ><B
  10859. >Beispiel 6-8. Enable <A
  10860. HREF="#ref.bzip2"
  10861. >Bzip2</A
  10862. > extension for PHP-Windows</B
  10863. ></P
  10864. ><TABLE
  10865. BORDER="0"
  10866. BGCOLOR="#E0E0E0"
  10867. CELLPADDING="5"
  10868. ><TR
  10869. ><TD
  10870. ><PRE
  10871. CLASS="ini"
  10872. >// change the following line from ...
  10873. ;extension=php_bz2.dll
  10874.  
  10875. // ... to
  10876. extension=php_bz2.dll</PRE
  10877. ></TD
  10878. ></TR
  10879. ></TABLE
  10880. ></DIV
  10881. ></TD
  10882. ></TR
  10883. ></TABLE
  10884. >      
  10885.        </P
  10886. ></LI
  10887. ><LI
  10888. ><P
  10889. >         Some of the extensions need extra DLLs to work. Couple of them can be
  10890.         found in the distribution package, in the
  10891.         <TT
  10892. CLASS="filename"
  10893. >C:\php\dlls\</TT
  10894. > folder in PHP 4 or
  10895.         in the main folder in PHP 5, but some, for example Oracle
  10896.         (<TT
  10897. CLASS="filename"
  10898. >php_oci8.dll</TT
  10899. >) require DLLs which are not bundled
  10900.         with the distribution package. If you are installing PHP 4, copy the
  10901.         bundled DLLs from <TT
  10902. CLASS="filename"
  10903. >C:\php\dlls</TT
  10904. >
  10905.         folder to the main <TT
  10906. CLASS="filename"
  10907. >C:\php</TT
  10908. >
  10909.         folder. Don't forget to include <TT
  10910. CLASS="filename"
  10911. >C:\php</TT
  10912. > in the system
  10913.         <VAR
  10914. CLASS="varname"
  10915. >PATH</VAR
  10916. > (this process is explained in a separate <A
  10917. HREF="#faq.installation.addtopath"
  10918. >FAQ entry</A
  10919. >).
  10920.        </P
  10921. ></LI
  10922. ></UL
  10923. >
  10924.    <DIV
  10925. CLASS="note"
  10926. ><BLOCKQUOTE
  10927. CLASS="note"
  10928. ><P
  10929. ><B
  10930. >Anmerkung: </B
  10931. >
  10932.      If you are running a server module version of PHP
  10933.      remember to restart your webserver to reflect your changes to <TT
  10934. CLASS="filename"
  10935. >php.ini</TT
  10936. >.
  10937.     </P
  10938. ></BLOCKQUOTE
  10939. ></DIV
  10940. >
  10941.    </P
  10942. ><P
  10943. >     The following table describes some of the extensions available and required
  10944.     additional dlls.   
  10945.     <DIV
  10946. CLASS="table"
  10947. ><A
  10948. NAME="install.windows.extensions.overview"
  10949. ></A
  10950. ><P
  10951. ><B
  10952. >Tabelle 6-1. PHP Extensions</B
  10953. ></P
  10954. ><TABLE
  10955. BORDER="1"
  10956. CLASS="CALSTABLE"
  10957. ><COL><COL><COL><THEAD
  10958. ><TR
  10959. ><TH
  10960. >Extension</TH
  10961. ><TH
  10962. >Description</TH
  10963. ><TH
  10964. >Notes</TH
  10965. ></TR
  10966. ></THEAD
  10967. ><TBODY
  10968. ><TR
  10969. ><TD
  10970. >php_bz2.dll</TD
  10971. ><TD
  10972. ><A
  10973. HREF="#ref.bzip2"
  10974. >bzip2</A
  10975. > compression functions</TD
  10976. ><TD
  10977. >None</TD
  10978. ></TR
  10979. ><TR
  10980. ><TD
  10981. >php_calendar.dll</TD
  10982. ><TD
  10983. ><A
  10984. HREF="#ref.calendar"
  10985. >Calendar</A
  10986. > conversion functions</TD
  10987. ><TD
  10988. >Built in since PHP 4.0.3</TD
  10989. ></TR
  10990. ><TR
  10991. ><TD
  10992. >php_cpdf.dll</TD
  10993. ><TD
  10994. ><A
  10995. HREF="#ref.cpdf"
  10996. >ClibPDF</A
  10997. > functions</TD
  10998. ><TD
  10999. >None</TD
  11000. ></TR
  11001. ><TR
  11002. ><TD
  11003. >php_crack.dll</TD
  11004. ><TD
  11005. ><A
  11006. HREF="#ref.crack"
  11007. >Crack</A
  11008. > functions</TD
  11009. ><TD
  11010. >None</TD
  11011. ></TR
  11012. ><TR
  11013. ><TD
  11014. >php_ctype.dll</TD
  11015. ><TD
  11016. ><A
  11017. HREF="#ref.ctype"
  11018. >ctype</A
  11019. > family functions</TD
  11020. ><TD
  11021. >Built in since PHP 4.3.0</TD
  11022. ></TR
  11023. ><TR
  11024. ><TD
  11025. >php_curl.dll</TD
  11026. ><TD
  11027. ><A
  11028. HREF="#ref.curl"
  11029. >CURL</A
  11030. >, Client URL library functions</TD
  11031. ><TD
  11032. >Requires: <TT
  11033. CLASS="filename"
  11034. >libeay32.dll</TT
  11035. >, 
  11036.    <TT
  11037. CLASS="filename"
  11038. >ssleay32.dll</TT
  11039. > (bundled)</TD
  11040. ></TR
  11041. ><TR
  11042. ><TD
  11043. >php_cybercash.dll</TD
  11044. ><TD
  11045. ><A
  11046. HREF="#ref.cybercash"
  11047. >Cybercash</A
  11048. > payment functions</TD
  11049. ><TD
  11050. >PHP <= 4.2.0</TD
  11051. ></TR
  11052. ><TR
  11053. ><TD
  11054. >php_db.dll</TD
  11055. ><TD
  11056. ><A
  11057. HREF="#ref.dbm"
  11058. >DBM</A
  11059. > functions</TD
  11060. ><TD
  11061. >Deprecated. Use DBA instead (<TT
  11062. CLASS="filename"
  11063. >php_dba.dll</TT
  11064. >)</TD
  11065. ></TR
  11066. ><TR
  11067. ><TD
  11068. >php_dba.dll</TD
  11069. ><TD
  11070. ><A
  11071. HREF="#ref.dba"
  11072. >DBA</A
  11073. >: DataBase (dbm-style) 
  11074.    Abstraction layer functions</TD
  11075. ><TD
  11076. >None</TD
  11077. ></TR
  11078. ><TR
  11079. ><TD
  11080. >php_dbase.dll</TD
  11081. ><TD
  11082. ><A
  11083. HREF="#ref.dbase"
  11084. >dBase</A
  11085. > functions</TD
  11086. ><TD
  11087. >None</TD
  11088. ></TR
  11089. ><TR
  11090. ><TD
  11091. >php_dbx.dll</TD
  11092. ><TD
  11093. ><A
  11094. HREF="#ref.dbx"
  11095. >dbx</A
  11096. > functions</TD
  11097. ><TD
  11098. > </TD
  11099. ></TR
  11100. ><TR
  11101. ><TD
  11102. >php_domxml.dll</TD
  11103. ><TD
  11104. ><A
  11105. HREF="#ref.domxml"
  11106. >DOM XML</A
  11107. > functions</TD
  11108. ><TD
  11109. >     PHP <= 4.2.0 requires: <TT
  11110. CLASS="filename"
  11111. >libxml2.dll</TT
  11112. > (bundled)
  11113.     PHP >= 4.3.0 requires: <TT
  11114. CLASS="filename"
  11115. >iconv.dll</TT
  11116. > (bundled)
  11117.    </TD
  11118. ></TR
  11119. ><TR
  11120. ><TD
  11121. >php_dotnet.dll</TD
  11122. ><TD
  11123. ><A
  11124. HREF="#ref.dotnet"
  11125. >.NET</A
  11126. > functions</TD
  11127. ><TD
  11128. >PHP <= 4.1.1</TD
  11129. ></TR
  11130. ><TR
  11131. ><TD
  11132. >php_exif.dll</TD
  11133. ><TD
  11134. ><A
  11135. HREF="#function.read-exif-data"
  11136. >Read EXIF</A
  11137. > headers from JPEG</TD
  11138. ><TD
  11139. >None</TD
  11140. ></TR
  11141. ><TR
  11142. ><TD
  11143. >php_fbsql.dll</TD
  11144. ><TD
  11145. ><A
  11146. HREF="#ref.fbsql"
  11147. >FrontBase</A
  11148. > functions</TD
  11149. ><TD
  11150. >PHP <= 4.2.0</TD
  11151. ></TR
  11152. ><TR
  11153. ><TD
  11154. >php_fdf.dll</TD
  11155. ><TD
  11156. ><A
  11157. HREF="#ref.fdf"
  11158. >FDF</A
  11159. >: Forms Data Format functions.</TD
  11160. ><TD
  11161. >Requires: <TT
  11162. CLASS="filename"
  11163. >fdftk.dll</TT
  11164. > (bundled)</TD
  11165. ></TR
  11166. ><TR
  11167. ><TD
  11168. >php_filepro.dll</TD
  11169. ><TD
  11170. ><A
  11171. HREF="#ref.filepro"
  11172. >filePro</A
  11173. > functions</TD
  11174. ><TD
  11175. >Read-only access</TD
  11176. ></TR
  11177. ><TR
  11178. ><TD
  11179. >php_ftp.dll</TD
  11180. ><TD
  11181. ><A
  11182. HREF="#ref.ftp"
  11183. >FTP</A
  11184. > functions</TD
  11185. ><TD
  11186. >Built-in since PHP 4.0.3</TD
  11187. ></TR
  11188. ><TR
  11189. ><TD
  11190. >php_gd.dll</TD
  11191. ><TD
  11192. ><A
  11193. HREF="#ref.image"
  11194. >GD</A
  11195. > library image functions</TD
  11196. ><TD
  11197. >     Removed in PHP 4.3.2.  Also note that truecolor functions are not
  11198.     available in GD1, instead, use <TT
  11199. CLASS="filename"
  11200. >php_gd2.dll</TT
  11201. >.
  11202.    </TD
  11203. ></TR
  11204. ><TR
  11205. ><TD
  11206. >php_gd2.dll</TD
  11207. ><TD
  11208. ><A
  11209. HREF="#ref.image"
  11210. >GD</A
  11211. > library image functions</TD
  11212. ><TD
  11213. >GD2</TD
  11214. ></TR
  11215. ><TR
  11216. ><TD
  11217. >php_gettext.dll</TD
  11218. ><TD
  11219. ><A
  11220. HREF="#ref.gettext"
  11221. >Gettext</A
  11222. > functions</TD
  11223. ><TD
  11224. >     PHP <= 4.2.0 requires <TT
  11225. CLASS="filename"
  11226. >gnu_gettext.dll</TT
  11227. > (bundled), 
  11228.     PHP >= 4.2.3 requires <TT
  11229. CLASS="filename"
  11230. >libintl-1.dll</TT
  11231. >,
  11232.     <TT
  11233. CLASS="filename"
  11234. >iconv.dll</TT
  11235. > (bundled).
  11236.    </TD
  11237. ></TR
  11238. ><TR
  11239. ><TD
  11240. >php_hyperwave.dll</TD
  11241. ><TD
  11242. ><A
  11243. HREF="#ref.hw"
  11244. >HyperWave</A
  11245. > functions</TD
  11246. ><TD
  11247. >None</TD
  11248. ></TR
  11249. ><TR
  11250. ><TD
  11251. >php_iconv.dll</TD
  11252. ><TD
  11253. ><A
  11254. HREF="#ref.iconv"
  11255. >ICONV</A
  11256. > characterset conversion</TD
  11257. ><TD
  11258. >Requires: <TT
  11259. CLASS="filename"
  11260. >iconv-1.3.dll</TT
  11261. > (bundled), 
  11262.    PHP >=4.2.1 <TT
  11263. CLASS="filename"
  11264. >iconv.dll</TT
  11265. ></TD
  11266. ></TR
  11267. ><TR
  11268. ><TD
  11269. >php_ifx.dll</TD
  11270. ><TD
  11271. ><A
  11272. HREF="#ref.ifx"
  11273. >Informix</A
  11274. > functions</TD
  11275. ><TD
  11276. >Requires: Informix libraries</TD
  11277. ></TR
  11278. ><TR
  11279. ><TD
  11280. >php_iisfunc.dll</TD
  11281. ><TD
  11282. >IIS management functions</TD
  11283. ><TD
  11284. >None</TD
  11285. ></TR
  11286. ><TR
  11287. ><TD
  11288. >php_imap.dll</TD
  11289. ><TD
  11290. ><A
  11291. HREF="#ref.imap"
  11292. >IMAP</A
  11293. > POP3 and NNTP functions</TD
  11294. ><TD
  11295. >None</TD
  11296. ></TR
  11297. ><TR
  11298. ><TD
  11299. >php_ingres.dll</TD
  11300. ><TD
  11301. ><A
  11302. HREF="#ref.ingres"
  11303. >Ingres II</A
  11304. > functions</TD
  11305. ><TD
  11306. >Requires: Ingres II libraries</TD
  11307. ></TR
  11308. ><TR
  11309. ><TD
  11310. >php_interbase.dll</TD
  11311. ><TD
  11312. ><A
  11313. HREF="#ref.ibase"
  11314. >InterBase</A
  11315. > functions</TD
  11316. ><TD
  11317. >Requires: <TT
  11318. CLASS="filename"
  11319. >gds32.dll</TT
  11320. > (bundled)</TD
  11321. ></TR
  11322. ><TR
  11323. ><TD
  11324. >php_java.dll</TD
  11325. ><TD
  11326. ><A
  11327. HREF="#ref.java"
  11328. >Java</A
  11329. > functions</TD
  11330. ><TD
  11331. >PHP <= 4.0.6 requires: <TT
  11332. CLASS="filename"
  11333. >jvm.dll</TT
  11334. > (bundled)</TD
  11335. ></TR
  11336. ><TR
  11337. ><TD
  11338. >php_ldap.dll</TD
  11339. ><TD
  11340. ><A
  11341. HREF="#ref.ldap"
  11342. >LDAP</A
  11343. > functions</TD
  11344. ><TD
  11345. >     PHP <= 4.2.0 requires <TT
  11346. CLASS="filename"
  11347. >libsasl.dll</TT
  11348. > (bundled), 
  11349.     PHP >= 4.3.0 requires <TT
  11350. CLASS="filename"
  11351. >libeay32.dll</TT
  11352. >, 
  11353.     <TT
  11354. CLASS="filename"
  11355. >ssleay32.dll</TT
  11356. > (bundled)
  11357.    </TD
  11358. ></TR
  11359. ><TR
  11360. ><TD
  11361. >php_mbstring.dll</TD
  11362. ><TD
  11363. ><A
  11364. HREF="#ref.mbstring"
  11365. >Multi-Byte String</A
  11366. > functions</TD
  11367. ><TD
  11368. >None</TD
  11369. ></TR
  11370. ><TR
  11371. ><TD
  11372. >php_mcrypt.dll</TD
  11373. ><TD
  11374. ><A
  11375. HREF="#ref.mcrypt"
  11376. >Mcrypt Encryption</A
  11377. > functions</TD
  11378. ><TD
  11379. >Requires: <TT
  11380. CLASS="filename"
  11381. >libmcrypt.dll</TT
  11382. ></TD
  11383. ></TR
  11384. ><TR
  11385. ><TD
  11386. >php_mhash.dll</TD
  11387. ><TD
  11388. ><A
  11389. HREF="#ref.mhash"
  11390. >Mhash</A
  11391. > functions</TD
  11392. ><TD
  11393. >PHP >= 4.3.0 requires: <TT
  11394. CLASS="filename"
  11395. >libmhash.dll</TT
  11396. > (bundled)</TD
  11397. ></TR
  11398. ><TR
  11399. ><TD
  11400. >php_mime_magic.dll</TD
  11401. ><TD
  11402. ><A
  11403. HREF="#ref.mime-magic"
  11404. >Mimetype</A
  11405. > functions</TD
  11406. ><TD
  11407. >Requires: <TT
  11408. CLASS="filename"
  11409. >magic.mime</TT
  11410. > (bundled)</TD
  11411. ></TR
  11412. ><TR
  11413. ><TD
  11414. >php_ming.dll</TD
  11415. ><TD
  11416. ><A
  11417. HREF="#ref.ming"
  11418. >Ming</A
  11419. > functions for Flash</TD
  11420. ><TD
  11421. >None</TD
  11422. ></TR
  11423. ><TR
  11424. ><TD
  11425. >php_msql.dll</TD
  11426. ><TD
  11427. ><A
  11428. HREF="#ref.msql"
  11429. >mSQL</A
  11430. > functions</TD
  11431. ><TD
  11432. >Requires: <TT
  11433. CLASS="filename"
  11434. >msql.dll</TT
  11435. > (bundled)</TD
  11436. ></TR
  11437. ><TR
  11438. ><TD
  11439. >php_mssql.dll</TD
  11440. ><TD
  11441. ><A
  11442. HREF="#ref.mssql"
  11443. >MSSQL</A
  11444. > functions</TD
  11445. ><TD
  11446. >Requires: <TT
  11447. CLASS="filename"
  11448. >ntwdblib.dll</TT
  11449. > (bundled)</TD
  11450. ></TR
  11451. ><TR
  11452. ><TD
  11453. >php_mysql.dll</TD
  11454. ><TD
  11455. ><A
  11456. HREF="#ref.mysql"
  11457. >MySQL</A
  11458. > functions</TD
  11459. ><TD
  11460. >PHP >= 5.0.0, requires <TT
  11461. CLASS="filename"
  11462. >libmysql.dll</TT
  11463. >
  11464.     (bundled)</TD
  11465. ></TR
  11466. ><TR
  11467. ><TD
  11468. >php_mysqli.dll</TD
  11469. ><TD
  11470. ><A
  11471. HREF="#ref.mysqli"
  11472. >MySQLi</A
  11473. > functions</TD
  11474. ><TD
  11475. >PHP >= 5.0.0, requires <TT
  11476. CLASS="filename"
  11477. >libmysqli.dll</TT
  11478. >
  11479.     (bundled)</TD
  11480. ></TR
  11481. ><TR
  11482. ><TD
  11483. >php_oci8.dll</TD
  11484. ><TD
  11485. ><A
  11486. HREF="#ref.oci8"
  11487. >Oracle 8</A
  11488. > functions</TD
  11489. ><TD
  11490. >Requires: Oracle 8.1+ client libraries</TD
  11491. ></TR
  11492. ><TR
  11493. ><TD
  11494. >php_openssl.dll</TD
  11495. ><TD
  11496. ><A
  11497. HREF="#ref.openssl"
  11498. >OpenSSL</A
  11499. > functions</TD
  11500. ><TD
  11501. >Requires: <TT
  11502. CLASS="filename"
  11503. >libeay32.dll</TT
  11504. > (bundled)</TD
  11505. ></TR
  11506. ><TR
  11507. ><TD
  11508. >php_oracle.dll</TD
  11509. ><TD
  11510. ><A
  11511. HREF="#ref.oracle"
  11512. >Oracle</A
  11513. > functions</TD
  11514. ><TD
  11515. >Requires: Oracle 7 client libraries</TD
  11516. ></TR
  11517. ><TR
  11518. ><TD
  11519. >php_overload.dll</TD
  11520. ><TD
  11521. ><A
  11522. HREF="#ref.overload"
  11523. >Object overloading</A
  11524. > functions</TD
  11525. ><TD
  11526. >Built in since PHP 4.3.0</TD
  11527. ></TR
  11528. ><TR
  11529. ><TD
  11530. >php_pdf.dll</TD
  11531. ><TD
  11532. ><A
  11533. HREF="#ref.pdf"
  11534. >PDF</A
  11535. > functions</TD
  11536. ><TD
  11537. >None</TD
  11538. ></TR
  11539. ><TR
  11540. ><TD
  11541. >php_pgsql.dll</TD
  11542. ><TD
  11543. ><A
  11544. HREF="#ref.pgsql"
  11545. >PostgreSQL</A
  11546. > functions</TD
  11547. ><TD
  11548. >None</TD
  11549. ></TR
  11550. ><TR
  11551. ><TD
  11552. >php_printer.dll</TD
  11553. ><TD
  11554. ><A
  11555. HREF="#ref.printer"
  11556. >Printer</A
  11557. > functions</TD
  11558. ><TD
  11559. >None</TD
  11560. ></TR
  11561. ><TR
  11562. ><TD
  11563. >php_shmop.dll</TD
  11564. ><TD
  11565. ><A
  11566. HREF="#ref.shmop"
  11567. >Shared Memory</A
  11568. > functions</TD
  11569. ><TD
  11570. >None</TD
  11571. ></TR
  11572. ><TR
  11573. ><TD
  11574. >php_snmp.dll</TD
  11575. ><TD
  11576. ><A
  11577. HREF="#ref.snmp"
  11578. >SNMP</A
  11579. > get and walk functions</TD
  11580. ><TD
  11581. >NT only!</TD
  11582. ></TR
  11583. ><TR
  11584. ><TD
  11585. >php_soap.dll</TD
  11586. ><TD
  11587. ><A
  11588. HREF="#ref.soap"
  11589. >SOAP</A
  11590. > functions</TD
  11591. ><TD
  11592. >PHP >= 5.0.0</TD
  11593. ></TR
  11594. ><TR
  11595. ><TD
  11596. >php_sockets.dll</TD
  11597. ><TD
  11598. ><A
  11599. HREF="#ref.sockets"
  11600. >Socket</A
  11601. > functions</TD
  11602. ><TD
  11603. >None</TD
  11604. ></TR
  11605. ><TR
  11606. ><TD
  11607. >php_sybase_ct.dll</TD
  11608. ><TD
  11609. ><A
  11610. HREF="#ref.sybase"
  11611. >Sybase</A
  11612. > functions</TD
  11613. ><TD
  11614. >Requires: Sybase client libraries</TD
  11615. ></TR
  11616. ><TR
  11617. ><TD
  11618. >php_tidy.dll</TD
  11619. ><TD
  11620. ><A
  11621. HREF="#ref.tidy"
  11622. >Tidy</A
  11623. > functions</TD
  11624. ><TD
  11625. >PHP >= 5.0.0</TD
  11626. ></TR
  11627. ><TR
  11628. ><TD
  11629. >php_tokenizer.dll</TD
  11630. ><TD
  11631. ><A
  11632. HREF="#ref.tokenizer"
  11633. >Tokenizer</A
  11634. > functions</TD
  11635. ><TD
  11636. >Built in since PHP 4.3.0</TD
  11637. ></TR
  11638. ><TR
  11639. ><TD
  11640. >php_w32api.dll</TD
  11641. ><TD
  11642. ><A
  11643. HREF="#ref.w32api"
  11644. >W32api</A
  11645. > functions</TD
  11646. ><TD
  11647. >None</TD
  11648. ></TR
  11649. ><TR
  11650. ><TD
  11651. >php_xmlrpc.dll</TD
  11652. ><TD
  11653. ><A
  11654. HREF="#ref.xmlrpc"
  11655. >XML-RPC</A
  11656. > functions</TD
  11657. ><TD
  11658. >PHP >= 4.2.1 requires: <TT
  11659. CLASS="filename"
  11660. >iconv.dll</TT
  11661. > (bundled)</TD
  11662. ></TR
  11663. ><TR
  11664. ><TD
  11665. >php_xslt.dll</TD
  11666. ><TD
  11667. ><A
  11668. HREF="#ref.xslt"
  11669. >XSLT</A
  11670. > functions</TD
  11671. ><TD
  11672. >     PHP <= 4.2.0 requires <TT
  11673. CLASS="filename"
  11674. >sablot.dll</TT
  11675. >,
  11676.     <TT
  11677. CLASS="filename"
  11678. >expat.dll</TT
  11679. > (bundled). PHP >= 4.2.1 requires
  11680.     <TT
  11681. CLASS="filename"
  11682. >sablot.dll</TT
  11683. >, <TT
  11684. CLASS="filename"
  11685. >expat.dll</TT
  11686. >,
  11687.     <TT
  11688. CLASS="filename"
  11689. >iconv.dll</TT
  11690. > (bundled).
  11691.    </TD
  11692. ></TR
  11693. ><TR
  11694. ><TD
  11695. >php_yaz.dll</TD
  11696. ><TD
  11697. ><A
  11698. HREF="#ref.yaz"
  11699. >YAZ</A
  11700. > functions</TD
  11701. ><TD
  11702. >Requires: <TT
  11703. CLASS="filename"
  11704. >yaz.dll</TT
  11705. > (bundled)</TD
  11706. ></TR
  11707. ><TR
  11708. ><TD
  11709. >php_zip.dll</TD
  11710. ><TD
  11711. ><A
  11712. HREF="#ref.zip"
  11713. >Zip File</A
  11714. > functions</TD
  11715. ><TD
  11716. >Read only access</TD
  11717. ></TR
  11718. ><TR
  11719. ><TD
  11720. >php_zlib.dll</TD
  11721. ><TD
  11722. ><A
  11723. HREF="#ref.zlib"
  11724. >ZLib</A
  11725. > compression functions</TD
  11726. ><TD
  11727. >Built in since PHP 4.3.0</TD
  11728. ></TR
  11729. ></TBODY
  11730. ></TABLE
  11731. ></DIV
  11732. >
  11733.     </P
  11734. ></DIV
  11735. ></DIV
  11736. ><DIV
  11737. CLASS="chapter"
  11738. ><HR><H1
  11739. ><A
  11740. NAME="install.problems"
  11741. >Kapitel 7. Problems?</A
  11742. ></H1
  11743. ><DIV
  11744. CLASS="sect1"
  11745. ><H2
  11746. CLASS="sect1"
  11747. ><A
  11748. NAME="install.problems.faq"
  11749. >Read the FAQ</A
  11750. ></H2
  11751. ><P
  11752. >      Some problems are more common than others. The most
  11753.      common ones are listed in the <A
  11754. HREF="#faq"
  11755. >PHP
  11756.      FAQ</A
  11757. >, part of this manual.
  11758.     </P
  11759. ></DIV
  11760. ><DIV
  11761. CLASS="sect1"
  11762. ><HR><H2
  11763. CLASS="sect1"
  11764. ><A
  11765. NAME="install.problems.support"
  11766. >Other problems</A
  11767. ></H2
  11768. ><P
  11769. >      If you are still stuck, someone on the PHP installation mailing list may be
  11770.      able to help you. You should check out the archive first, in case
  11771.      someone already answered someone else who had the same problem as
  11772.      you. The archives are available from the support page on <A
  11773. HREF="http://www.php.net/support.php"
  11774. TARGET="_top"
  11775. >http://www.php.net/support.php</A
  11776. >. To subscribe to the PHP installation
  11777.      mailing list, send an empty mail to <A
  11778. HREF="mailto:php-install-subscribe@lists.php.net"
  11779. TARGET="_top"
  11780. >php-install-subscribe@lists.php.net</A
  11781. >.
  11782.      The mailing list address is <A
  11783. HREF="mailto:php-install@lists.php.net"
  11784. TARGET="_top"
  11785. >php-install@lists.php.net</A
  11786. >.
  11787.     </P
  11788. ><P
  11789. >      If you want to get help on the mailing list, please try to be
  11790.      precise and give the necessary details about your environment
  11791.      (which operating system, what PHP version, what web server, if
  11792.      you are running PHP as CGI or a server module, <A
  11793. HREF="#ini.safe-mode"
  11794. >Safe Mode</A
  11795. >, etc...), and
  11796.      preferably enough code to make others able to reproduce and test
  11797.      your problem.
  11798.     </P
  11799. ></DIV
  11800. ><DIV
  11801. CLASS="sect1"
  11802. ><HR><H2
  11803. CLASS="sect1"
  11804. ><A
  11805. NAME="install.problems.bugs"
  11806. >Bug reports</A
  11807. ></H2
  11808. ><P
  11809. >      If you think you have found a bug in PHP, please report it.  The
  11810.      PHP developers probably don't know about it, and unless you
  11811.      report it, chances are it won't be fixed. You can report bugs
  11812.      using the bug-tracking system at <A
  11813. HREF="http://bugs.php.net/"
  11814. TARGET="_top"
  11815. >http://bugs.php.net/</A
  11816. >. Please do not
  11817.      send bug reports in mailing list or personal letters. The
  11818.      bug system is also suitable to submit feature requests.
  11819.     </P
  11820. ><P
  11821. >      Read the <A
  11822. HREF="http://bugs.php.net/how-to-report.php"
  11823. TARGET="_top"
  11824. >How to report a bug</A
  11825. > 
  11826.      document before submitting any bug reports!
  11827.     </P
  11828. ></DIV
  11829. ></DIV
  11830. ><DIV
  11831. CLASS="chapter"
  11832. ><HR><H1
  11833. ><A
  11834. NAME="configuration"
  11835. >Kapitel 8. Runtime Configuration</A
  11836. ></H1
  11837. ><DIV
  11838. CLASS="sect1"
  11839. ><H2
  11840. CLASS="sect1"
  11841. ><A
  11842. NAME="configuration.file"
  11843. >The configuration file</A
  11844. ></H2
  11845. ><P
  11846. >     The configuration file (called <TT
  11847. CLASS="filename"
  11848. >php3.ini</TT
  11849. > in
  11850.     PHP 3, and simply <TT
  11851. CLASS="filename"
  11852. >php.ini</TT
  11853. > as of PHP 4)
  11854.     is read when PHP starts up. For the server module versions of PHP,
  11855.     this happens only once when the web server is started. For the
  11856.     <ACRONYM
  11857. CLASS="acronym"
  11858. >CGI</ACRONYM
  11859. > and <ACRONYM
  11860. CLASS="acronym"
  11861. >CLI</ACRONYM
  11862. > version, it happens on
  11863.     every invocation.
  11864.    </P
  11865. ><P
  11866. >     The default location of <TT
  11867. CLASS="filename"
  11868. >php.ini</TT
  11869. > is a compile time option (see the <A
  11870. HREF="#faq.installation.phpini"
  11871. >FAQ</A
  11872. > entry), but can be changed
  11873.     for the <ACRONYM
  11874. CLASS="acronym"
  11875. >CGI</ACRONYM
  11876. > and <ACRONYM
  11877. CLASS="acronym"
  11878. >CLI</ACRONYM
  11879. > version with the
  11880.     <VAR
  11881. CLASS="literal"
  11882. >-c</VAR
  11883. > command line switch, see the chapter about using
  11884.     PHP from the <A
  11885. HREF="#features.commandline"
  11886. >command line</A
  11887. >. You can also use the
  11888.     environment variable <VAR
  11889. CLASS="varname"
  11890. >PHPRC</VAR
  11891. > for an additional path to
  11892.     search for a <TT
  11893. CLASS="filename"
  11894. >php.ini</TT
  11895. > file.
  11896.    </P
  11897. ><P
  11898. >     If <TT
  11899. CLASS="filename"
  11900. >php-SAPI.ini</TT
  11901. > exists (where SAPI is used SAPI, so the
  11902.     filename is e.g. <TT
  11903. CLASS="filename"
  11904. >php-cli.ini</TT
  11905. > or
  11906.     <TT
  11907. CLASS="filename"
  11908. >php-apache.ini</TT
  11909. >), it's used instead of <TT
  11910. CLASS="filename"
  11911. >php.ini</TT
  11912. >.
  11913.    </P
  11914. ><DIV
  11915. CLASS="note"
  11916. ><BLOCKQUOTE
  11917. CLASS="note"
  11918. ><P
  11919. ><B
  11920. >Anmerkung: </B
  11921. >
  11922.      The Apache web server changes the directory to root at startup causing
  11923.      PHP to attempt to read <TT
  11924. CLASS="filename"
  11925. >php.ini</TT
  11926. > from the root filesystem if it exists.
  11927.     </P
  11928. ></BLOCKQUOTE
  11929. ></DIV
  11930. ><P
  11931. >     The <TT
  11932. CLASS="filename"
  11933. >php.ini</TT
  11934. > directives handled by extensions are documented respectively
  11935.     on the pages of the extensions themselfs. The <A
  11936. HREF="#ini"
  11937. >list of
  11938.     the core directives</A
  11939. > is available in the appendix. Probably not all
  11940.     the PHP directives are documented in the manual though. For a completel list
  11941.     of directives available in your PHP version, please read your well commented
  11942.     <TT
  11943. CLASS="filename"
  11944. >php.ini</TT
  11945. > file. Alternatively, you may find the
  11946.     <A
  11947. HREF="http://cvs.php.net/co.php/php-src/php.ini-dist"
  11948. TARGET="_top"
  11949. >the latest <TT
  11950. CLASS="filename"
  11951. >php.ini</TT
  11952. ></A
  11953. > from CVS
  11954.     helpful too.
  11955.    </P
  11956. ><P
  11957. >     <TABLE
  11958. WIDTH="100%"
  11959. BORDER="0"
  11960. CELLPADDING="0"
  11961. CELLSPACING="0"
  11962. CLASS="EXAMPLE"
  11963. ><TR
  11964. ><TD
  11965. ><DIV
  11966. CLASS="example"
  11967. ><A
  11968. NAME="AEN2326"
  11969. ></A
  11970. ><P
  11971. ><B
  11972. >Beispiel 8-1. <TT
  11973. CLASS="filename"
  11974. >php.ini</TT
  11975. > example</B
  11976. ></P
  11977. ><TABLE
  11978. BORDER="0"
  11979. BGCOLOR="#E0E0E0"
  11980. CELLPADDING="5"
  11981. ><TR
  11982. ><TD
  11983. ><PRE
  11984. CLASS="ini"
  11985. >; any text on a line after an unquoted semicolon (;) is ignored
  11986. [php] ; section markers (text within square brackets) are also ignored
  11987. ; Boolean values can be set to either:
  11988. ;    true, on, yes
  11989. ; or false, off, no, none
  11990. register_globals = off
  11991. track_errors = yes
  11992.  
  11993. ; you can enclose strings in double-quotes
  11994. include_path = ".:/usr/local/lib/php"
  11995.  
  11996. ; backslashes are treated the same as any other character
  11997. include_path = ".;c:\php\lib"</PRE
  11998. ></TD
  11999. ></TR
  12000. ></TABLE
  12001. ></DIV
  12002. ></TD
  12003. ></TR
  12004. ></TABLE
  12005. >
  12006.    </P
  12007. ></DIV
  12008. ><DIV
  12009. CLASS="sect1"
  12010. ><HR><H2
  12011. CLASS="sect1"
  12012. ><A
  12013. NAME="configuration.changes"
  12014. >How to change configuration settings</A
  12015. ></H2
  12016. ><DIV
  12017. CLASS="sect2"
  12018. ><H3
  12019. CLASS="sect2"
  12020. ><A
  12021. NAME="configuration.changes.apache"
  12022. >Running PHP as an Apache module</A
  12023. ></H3
  12024. ><P
  12025. >      When using PHP as an Apache module, you can also change the
  12026.      configuration settings using directives in Apache configuration
  12027.      files (e.g. <TT
  12028. CLASS="filename"
  12029. >httpd.conf</TT
  12030. >) and <TT
  12031. CLASS="filename"
  12032. >.htaccess</TT
  12033. > files. You will need
  12034.      "AllowOverride Options" or "AllowOverride All" privileges to do so.
  12035.     </P
  12036. ><P
  12037. >      With PHP 4 and PHP 5, there are several Apache directives that allow you
  12038.      to change the PHP configuration from within the Apache configuration
  12039.      files.  For a listing of which directives are 
  12040.      <TT
  12041. CLASS="constant"
  12042. ><B
  12043. >PHP_INI_ALL</B
  12044. ></TT
  12045. >, <TT
  12046. CLASS="constant"
  12047. ><B
  12048. >PHP_INI_PERDIR</B
  12049. ></TT
  12050. >, 
  12051.      or <TT
  12052. CLASS="constant"
  12053. ><B
  12054. >PHP_INI_SYSTEM</B
  12055. ></TT
  12056. >, have a look at the table
  12057.      found within the <A
  12058. HREF="#function.ini-set"
  12059. ><B
  12060. CLASS="function"
  12061. >ini_set()</B
  12062. ></A
  12063. > documentation.
  12064.     </P
  12065. ><DIV
  12066. CLASS="note"
  12067. ><BLOCKQUOTE
  12068. CLASS="note"
  12069. ><P
  12070. ><B
  12071. >Anmerkung: </B
  12072. >
  12073.       With PHP 3, there are Apache directives that correspond to each
  12074.       configuration setting in the <TT
  12075. CLASS="filename"
  12076. >php3.ini</TT
  12077. > name,
  12078.       except the name is prefixed by "php3_".
  12079.      </P
  12080. ></BLOCKQUOTE
  12081. ></DIV
  12082. ><P
  12083. >      <P
  12084. ></P
  12085. ><DIV
  12086. CLASS="variablelist"
  12087. ><DL
  12088. ><DT
  12089. ><SPAN
  12090. CLASS="systemitem"
  12091. >php_value</SPAN
  12092. >
  12093.         <VAR
  12094. CLASS="parameter"
  12095. >name</VAR
  12096. >
  12097.         <VAR
  12098. CLASS="parameter"
  12099. >value</VAR
  12100. ></DT
  12101. ><DD
  12102. ><P
  12103. >          Sets the value of the specified directive.
  12104.          Can be used only with <TT
  12105. CLASS="constant"
  12106. ><B
  12107. >PHP_INI_ALL</B
  12108. ></TT
  12109. > and <TT
  12110. CLASS="constant"
  12111. ><B
  12112. >PHP_INI_PERDIR</B
  12113. ></TT
  12114. > type directives.
  12115.          To clear a previously set value use <VAR
  12116. CLASS="literal"
  12117. >none</VAR
  12118. > as the value.
  12119.         </P
  12120. ><DIV
  12121. CLASS="note"
  12122. ><BLOCKQUOTE
  12123. CLASS="note"
  12124. ><P
  12125. ><B
  12126. >Anmerkung: </B
  12127. >
  12128.           Don't use <SPAN
  12129. CLASS="systemitem"
  12130. >php_value</SPAN
  12131. > to set boolean values.
  12132.           <SPAN
  12133. CLASS="systemitem"
  12134. >php_flag</SPAN
  12135. > (see below) should be used instead.
  12136.          </P
  12137. ></BLOCKQUOTE
  12138. ></DIV
  12139. ></DD
  12140. ><DT
  12141. ><SPAN
  12142. CLASS="systemitem"
  12143. >php_flag</SPAN
  12144. >
  12145.         <VAR
  12146. CLASS="parameter"
  12147. >name</VAR
  12148. >
  12149.         <VAR
  12150. CLASS="parameter"
  12151. >on|off</VAR
  12152. ></DT
  12153. ><DD
  12154. ><P
  12155. >          Used to set a boolean configuration directive.
  12156.          Can be used only with <TT
  12157. CLASS="constant"
  12158. ><B
  12159. >PHP_INI_ALL</B
  12160. ></TT
  12161. > and
  12162.          <TT
  12163. CLASS="constant"
  12164. ><B
  12165. >PHP_INI_PERDIR</B
  12166. ></TT
  12167. > type directives.
  12168.         </P
  12169. ></DD
  12170. ><DT
  12171. ><SPAN
  12172. CLASS="systemitem"
  12173. >php_admin_value</SPAN
  12174. >
  12175.         <VAR
  12176. CLASS="parameter"
  12177. >name</VAR
  12178. >
  12179.         <VAR
  12180. CLASS="parameter"
  12181. >value</VAR
  12182. ></DT
  12183. ><DD
  12184. ><P
  12185. >          Sets the value of the specified directive.
  12186.          This <SPAN
  12187. CLASS="emphasis"
  12188. ><I
  12189. CLASS="emphasis"
  12190. >can not be used</I
  12191. ></SPAN
  12192. > in <TT
  12193. CLASS="filename"
  12194. >.htaccess</TT
  12195. > files.
  12196.          Any directive type set with <SPAN
  12197. CLASS="systemitem"
  12198. >php_admin_value</SPAN
  12199. >
  12200.          can not be overridden by <TT
  12201. CLASS="filename"
  12202. >.htaccess</TT
  12203. > or virtualhost directives.
  12204.          To clear a previously set value use <VAR
  12205. CLASS="literal"
  12206. >none</VAR
  12207. > as the value.
  12208.         </P
  12209. ></DD
  12210. ><DT
  12211. ><SPAN
  12212. CLASS="systemitem"
  12213. >php_admin_flag</SPAN
  12214. >
  12215.         <VAR
  12216. CLASS="parameter"
  12217. >name</VAR
  12218. >
  12219.         <VAR
  12220. CLASS="parameter"
  12221. >on|off</VAR
  12222. ></DT
  12223. ><DD
  12224. ><P
  12225. >          Used to set a boolean configuration directive.
  12226.          This <SPAN
  12227. CLASS="emphasis"
  12228. ><I
  12229. CLASS="emphasis"
  12230. >can not be used</I
  12231. ></SPAN
  12232. > in <TT
  12233. CLASS="filename"
  12234. >.htaccess</TT
  12235. > files.
  12236.          Any directive type set with <SPAN
  12237. CLASS="systemitem"
  12238. >php_admin_flag</SPAN
  12239. >
  12240.          can not be overridden by <TT
  12241. CLASS="filename"
  12242. >.htaccess</TT
  12243. > or virtualhost directives.
  12244.         </P
  12245. ></DD
  12246. ></DL
  12247. ></DIV
  12248. >
  12249.     </P
  12250. ><P
  12251. >      <TABLE
  12252. WIDTH="100%"
  12253. BORDER="0"
  12254. CELLPADDING="0"
  12255. CELLSPACING="0"
  12256. CLASS="EXAMPLE"
  12257. ><TR
  12258. ><TD
  12259. ><DIV
  12260. CLASS="example"
  12261. ><A
  12262. NAME="AEN2394"
  12263. ></A
  12264. ><P
  12265. ><B
  12266. >Beispiel 8-2. Apache configuration example</B
  12267. ></P
  12268. ><TABLE
  12269. BORDER="0"
  12270. BGCOLOR="#E0E0E0"
  12271. CELLPADDING="5"
  12272. ><TR
  12273. ><TD
  12274. ><PRE
  12275. CLASS="ini"
  12276. ><IfModule mod_php5.c>
  12277.   php_value include_path ".:/usr/local/lib/php"
  12278.   php_admin_flag safe_mode on
  12279. </IfModule>
  12280. <IfModule mod_php4.c>
  12281.   php_value include_path ".:/usr/local/lib/php"
  12282.   php_admin_flag safe_mode on
  12283. </IfModule>
  12284. <IfModule mod_php3.c>
  12285.   php3_include_path ".:/usr/local/lib/php"
  12286.   php3_safe_mode on
  12287. </IfModule></PRE
  12288. ></TD
  12289. ></TR
  12290. ></TABLE
  12291. ></DIV
  12292. ></TD
  12293. ></TR
  12294. ></TABLE
  12295. >
  12296.     </P
  12297. ><DIV
  12298. CLASS="caution"
  12299. ><P
  12300. ></P
  12301. ><TABLE
  12302. CLASS="caution"
  12303. BORDER="1"
  12304. WIDTH="100%"
  12305. ><TR
  12306. ><TD
  12307. ALIGN="CENTER"
  12308. ><B
  12309. >Achtung</B
  12310. ></TD
  12311. ></TR
  12312. ><TR
  12313. ><TD
  12314. ALIGN="LEFT"
  12315. ><P
  12316. >       PHP constants do not exist outside of PHP. For example, in 
  12317.       <TT
  12318. CLASS="filename"
  12319. >httpd.conf</TT
  12320. > you can not use PHP constants 
  12321.       such as <TT
  12322. CLASS="constant"
  12323. ><B
  12324. >E_ALL</B
  12325. ></TT
  12326. > or <TT
  12327. CLASS="constant"
  12328. ><B
  12329. >E_NOTICE</B
  12330. ></TT
  12331. > 
  12332.       to set the <A
  12333. HREF="#ini.error-reporting"
  12334. >error_reporting</A
  12335. > 
  12336.       directive as they will have no meaning and will evaluate to
  12337.       <SPAN
  12338. CLASS="emphasis"
  12339. ><I
  12340. CLASS="emphasis"
  12341. >0</I
  12342. ></SPAN
  12343. >. Use the associated bitmask values instead.
  12344.       These constants can be used in <TT
  12345. CLASS="filename"
  12346. >php.ini</TT
  12347. >
  12348.      </P
  12349. ></TD
  12350. ></TR
  12351. ></TABLE
  12352. ></DIV
  12353. ></DIV
  12354. ><DIV
  12355. CLASS="sect2"
  12356. ><HR><H3
  12357. CLASS="sect2"
  12358. ><A
  12359. NAME="configuration.changes.windows"
  12360. >Changing PHP configuration via the Windows registry</A
  12361. ></H3
  12362. ><P
  12363. >       When running PHP on Windows, the configuration values can be
  12364.       modified on a per-directory basis using the Windows registry. The
  12365.       configuration values are stored in the registry key 
  12366.       <VAR
  12367. CLASS="literal"
  12368. >HKLM\SOFTWARE\PHP\Per Directory Values</VAR
  12369. >, 
  12370.       in the sub-keys corresponding to the path names. For example, configuration 
  12371.       values for the directory <VAR
  12372. CLASS="literal"
  12373. >c:\inetpub\wwwroot</VAR
  12374. > would
  12375.       be stored in the key <VAR
  12376. CLASS="literal"
  12377. >HKLM\SOFTWARE\PHP\Per Directory
  12378.       Values\c\inetpub\wwwroot</VAR
  12379. >. The settings for the
  12380.       directory would be active for any script running from this
  12381.       directory or any subdirectory of it. The values under the key
  12382.       should have the name of the PHP configuration directive and the
  12383.       string value. PHP constants in the values are not parsed. 
  12384.      </P
  12385. ></DIV
  12386. ><DIV
  12387. CLASS="sect2"
  12388. ><HR><H3
  12389. CLASS="sect2"
  12390. ><A
  12391. NAME="configuration.changes.other"
  12392. >Other interfaces to PHP</A
  12393. ></H3
  12394. ><P
  12395. >      Regardless of how you run PHP, you can change certain values at runtime
  12396.      of your scripts through <A
  12397. HREF="#function.ini-set"
  12398. ><B
  12399. CLASS="function"
  12400. >ini_set()</B
  12401. ></A
  12402. >. See the documentation
  12403.      on the <A
  12404. HREF="#function.ini-set"
  12405. ><B
  12406. CLASS="function"
  12407. >ini_set()</B
  12408. ></A
  12409. > page for more information.
  12410.     </P
  12411. ><P
  12412. >      If you are interested in a complete list of configuration settings
  12413.      on your system with their current values, you can execute the
  12414.      <A
  12415. HREF="#function.phpinfo"
  12416. ><B
  12417. CLASS="function"
  12418. >phpinfo()</B
  12419. ></A
  12420. > function, and review the resulting
  12421.      page. You can also access the values of individual configuration
  12422.      directives at runtime using <A
  12423. HREF="#function.ini-get"
  12424. ><B
  12425. CLASS="function"
  12426. >ini_get()</B
  12427. ></A
  12428. > or
  12429.      <A
  12430. HREF="#function.get-cfg-var"
  12431. ><B
  12432. CLASS="function"
  12433. >get_cfg_var()</B
  12434. ></A
  12435. >.
  12436.     </P
  12437. ></DIV
  12438. ></DIV
  12439. ></DIV
  12440. ></DIV
  12441. ><DIV
  12442. CLASS="PART"
  12443. ><A
  12444. NAME="langref"
  12445. ></A
  12446. ><DIV
  12447. CLASS="TITLEPAGE"
  12448. ><H1
  12449. CLASS="title"
  12450. >III. Sprachreferenz</H1
  12451. ><DIV
  12452. CLASS="TOC"
  12453. ><DL
  12454. ><DT
  12455. ><B
  12456. >Inhaltsverzeichnis</B
  12457. ></DT
  12458. ><DT
  12459. >9. <A
  12460. HREF="#language.basic-syntax"
  12461. >Grundlagen der Syntax</A
  12462. ></DT
  12463. ><DT
  12464. >10. <A
  12465. HREF="#language.types"
  12466. >Typen</A
  12467. ></DT
  12468. ><DT
  12469. >11. <A
  12470. HREF="#language.variables"
  12471. >Variablen</A
  12472. ></DT
  12473. ><DT
  12474. >12. <A
  12475. HREF="#language.constants"
  12476. >Konstanten</A
  12477. ></DT
  12478. ><DT
  12479. >13. <A
  12480. HREF="#language.expressions"
  12481. >Ausdrⁿcke</A
  12482. ></DT
  12483. ><DT
  12484. >14. <A
  12485. HREF="#language.operators"
  12486. >Operatoren</A
  12487. ></DT
  12488. ><DT
  12489. >15. <A
  12490. HREF="#language.control-structures"
  12491. >Kontroll-Strukturen</A
  12492. ></DT
  12493. ><DT
  12494. >16. <A
  12495. HREF="#functions"
  12496. >Funktionen</A
  12497. ></DT
  12498. ><DT
  12499. >17. <A
  12500. HREF="#language.oop"
  12501. >Klassen und Objekte</A
  12502. ></DT
  12503. ><DT
  12504. >18. <A
  12505. HREF="#language.oop5"
  12506. >Classes and Objects (PHP 5)</A
  12507. ></DT
  12508. ><DT
  12509. >19. <A
  12510. HREF="#language.references"
  12511. >Referenzen in PHP</A
  12512. ></DT
  12513. ></DL
  12514. ></DIV
  12515. ></DIV
  12516. ><DIV
  12517. CLASS="chapter"
  12518. ><HR><H1
  12519. ><A
  12520. NAME="language.basic-syntax"
  12521. >Kapitel 9. Grundlagen der Syntax</A
  12522. ></H1
  12523. ><DIV
  12524. CLASS="sect1"
  12525. ><H2
  12526. CLASS="sect1"
  12527. ><A
  12528. NAME="language.basic-syntax.phpmode"
  12529. >Den HTML-Bereich der Datei verlassen</A
  12530. ></H2
  12531. ><P
  12532. >     WΣhrend des Parsens einer Datei geht PHP den Text solange einfach
  12533.     durch, bis einer der speziellen Tags gefunden wird, der PHP mitteilt,
  12534.     dass ab nun mit der Interpretation des Textes als PHP Code zu beginnen
  12535.     ist. Der Parser fⁿhrt nun den Code solange aus, bis er auf einen
  12536.     schlie▀enden PHP Tag st÷▀t, welcher dem Parser mitteilt, den Text ab
  12537.     hier wieder nur einfach durchzugehen. Das ist der Mechanismus der es
  12538.     erlaubt, PHP Code in HTML einzubinden: alles au▀erhalb der PHP Tags
  12539.     wird einfach alleine gelassen, wΣhrend alles innerhalb dieser Tags
  12540.     als Code geparsed wird.
  12541.    </P
  12542. ><P
  12543. >     Es gibt vier Arten von Tags, welche die Bl÷cke mit PHP Code kennzeichnen.
  12544.     Davon sind nur zwei immer verfⁿgbar (<?php. . .?> und <script
  12545.     language="php">. . .</script>), die anderen k÷nnen in der
  12546.     Konfigurationsdatei <TT
  12547. CLASS="filename"
  12548. >php.ini</TT
  12549. > aktiviert bzw. deaktiviert werden. Die
  12550.     Tags in der Kurzform bzw. im ASP-Stil m÷gen zwar praktisch erscheinen,
  12551.     sind jedoch nicht so portabel wie die lΣngeren Versionen. Wenn Sie
  12552.     des Weiteren beabsichtigen, PHP Code in XML oder XHTML einzubinden, werden
  12553.     Sie die XML-konformen <?php. . .?> verwenden mⁿssen.
  12554.    </P
  12555. ><P
  12556. >     Die von PHP unterstⁿtzten Tags sind:
  12557.    </P
  12558. ><P
  12559. >      <TABLE
  12560. WIDTH="100%"
  12561. BORDER="0"
  12562. CELLPADDING="0"
  12563. CELLSPACING="0"
  12564. CLASS="EXAMPLE"
  12565. ><TR
  12566. ><TD
  12567. ><DIV
  12568. CLASS="example"
  12569. ><A
  12570. NAME="AEN2431"
  12571. ></A
  12572. ><P
  12573. ><B
  12574. >Beispiel 9-1. M÷glichkeiten, den HTML-Bereich zu verlassen</B
  12575. ></P
  12576. ><TABLE
  12577. BORDER="0"
  12578. BGCOLOR="#E0E0E0"
  12579. CELLPADDING="5"
  12580. ><TR
  12581. ><TD
  12582. ><PRE
  12583. CLASS="php"
  12584. >1.  <?php echo("In XHTML- oder XML-konformen Dokumenten benutzen Sie diese Syntax\n"); ?>
  12585.  
  12586. 2.  <? echo ("Die einfachste M÷glichkeit: eine SGML-┤processing instruction┤\n"); ?>
  12587.     <?= expression ?> Dies ist eine Abkⁿrzung fⁿr "<? echo expression ?>"
  12588.  
  12589. 3.  <script language="php">
  12590.         echo ("manche Editoren(wie FrontPage) m÷gen
  12591.               keine ┤processing instructions┤");
  12592.     </script>
  12593.  
  12594. 4.  <% echo ("Optional k÷nnen Sie auch Tags im ASP-Stil verwenden"); %>
  12595.     <%= $variable; # Das ist ein Abkⁿrzung fuer "<% echo . . ." %></PRE
  12596. ></TD
  12597. ></TR
  12598. ></TABLE
  12599. ></DIV
  12600. ></TD
  12601. ></TR
  12602. ></TABLE
  12603. >
  12604.     </P
  12605. ><P
  12606. >     Die erste Methode (<?php. . .?>) wird bevorzugt, da sie auch
  12607.     die Verwendung von PHP in XML-konformen Code, wie XHTML, erlaubt.
  12608.    </P
  12609. ><P
  12610. >     Die zweite Methode ist nicht immer verfⁿgbar. Die Kurzform der Tags
  12611.     ist nur m÷glich, wenn diese zuvor aktiviert wurde. Dies kann mittels
  12612.     der Funktion <B
  12613. CLASS="function"
  12614. >short_tags()</B
  12615. > (nur PHP 3), dem Setzen
  12616.     der Konfigurationsoption <A
  12617. HREF="#ini.short-open-tag"
  12618. >short_open_tag</A
  12619. > in der PHP
  12620.     Konfigurationsdatei, oder durch das Kompilieren von PHP mit der
  12621.     Option  --enable-short-tags. Auch wenn diese Methode standardmΣ▀ig
  12622.     in der php.ini.dist aktiviert ist, wird die Verwendung dieser
  12623.     Kurzform nicht empfohlen.
  12624.    </P
  12625. ><P
  12626. >     Die vierte Methode ist nur verfⁿgbar, wenn die Konfigurationsoption
  12627.     <A
  12628. HREF="#ini.asp-tags"
  12629. >asp_tags</A
  12630. > aktiviert ist.
  12631.  
  12632.     <DIV
  12633. CLASS="note"
  12634. ><BLOCKQUOTE
  12635. CLASS="note"
  12636. ><P
  12637. ><B
  12638. >Anmerkung: </B
  12639. >Die Unterstⁿtzung der Tags im ASP-Stil wurde in Version 3.0.4.
  12640.       hinzugefⁿgt.
  12641.      </P
  12642. ></BLOCKQUOTE
  12643. ></DIV
  12644. >
  12645.    </P
  12646. ><DIV
  12647. CLASS="note"
  12648. ><BLOCKQUOTE
  12649. CLASS="note"
  12650. ><P
  12651. ><B
  12652. >Anmerkung: </B
  12653. >
  12654.      Die Verwendung der ┤short tags┤ sollten Sie vermeiden, wenn Sie
  12655.      Applikationen oder Bibliotheken entwickeln, die verteilt oder auf
  12656.      PHP-Servern eingesetzt werden soll, die nicht unter Ihrer Kontrolle
  12657.      stehen, da die ┤short tags┤ auf dem einzusetzenden Server nicht
  12658.      unterstⁿtzt werden k÷nnten. Stellen Sie also sicher, dass fⁿr
  12659.      portablen, weiterverteilbaren Code keine ┤short tags┤ verwendet
  12660.      werden.
  12661.     </P
  12662. ></BLOCKQUOTE
  12663. ></DIV
  12664. ><P
  12665. >      Der schlie▀ende Tag fⁿr den PHP-Block schlie▀t eine sofort
  12666.      folgende Zeilenschaltung mit ein, falls diese vorhanden
  12667.      ist. Au▀erdem beinhaltet der schlie▀ende Tag ein implizites Semikolon;
  12668.      Sie mⁿssen also die letzte Zeile eines PHP-Blocks nicht mit einem
  12669.      Semikolon beenden.
  12670.     </P
  12671. ><P
  12672. >     PHP erm÷glicht auch die Verwendung folgender Strukturen:
  12673.     <TABLE
  12674. WIDTH="100%"
  12675. BORDER="0"
  12676. CELLPADDING="0"
  12677. CELLSPACING="0"
  12678. CLASS="EXAMPLE"
  12679. ><TR
  12680. ><TD
  12681. ><DIV
  12682. CLASS="example"
  12683. ><A
  12684. NAME="AEN2446"
  12685. ></A
  12686. ><P
  12687. ><B
  12688. >Beispiel 9-2. Erweitertes Verlassen</B
  12689. ></P
  12690. ><TABLE
  12691. BORDER="0"
  12692. BGCOLOR="#E0E0E0"
  12693. CELLPADDING="5"
  12694. ><TR
  12695. ><TD
  12696. ><PRE
  12697. CLASS="php"
  12698. ><?php
  12699. if ($expression) {
  12700.     ?>
  12701.     <strong>Das ist richtig.</strong>
  12702.     <?php
  12703. } else {
  12704.     ?>
  12705.     <strong>Das ist falsch.</strong>
  12706.     <?php
  12707. }
  12708. ?></PRE
  12709. ></TD
  12710. ></TR
  12711. ></TABLE
  12712. ></DIV
  12713. ></TD
  12714. ></TR
  12715. ></TABLE
  12716. >
  12717.     Dies funktioniert wie erwartet, da PHP nach dem Auffinden eines ?>
  12718.     schlie▀enden Tags einfach alles ausgibt, bis es wieder auf einen
  12719.     ÷ffnenden Tag st÷▀t. Das obige Beispiel ist natⁿrlich gekⁿnstelt,
  12720.     aber fⁿr die Ausgabe von gro▀en Textbl÷cken ist der Ausstieg aus
  12721.     dem Parse-Modus generell effizienter, als den gesamten Text durch
  12722.     <A
  12723. HREF="#function.echo"
  12724. ><B
  12725. CLASS="function"
  12726. >echo()</B
  12727. ></A
  12728. >, <A
  12729. HREF="#function.print"
  12730. ><B
  12731. CLASS="function"
  12732. >print()</B
  12733. ></A
  12734. >, etc. zu
  12735.     jagen.
  12736.    </P
  12737. ></DIV
  12738. ><DIV
  12739. CLASS="sect1"
  12740. ><HR><H2
  12741. CLASS="sect1"
  12742. ><A
  12743. NAME="language.basic-syntax.instruction-separation"
  12744. >Abgrenzung von Anweisungen</A
  12745. ></H2
  12746. ><P
  12747. >      Einzelne Anweisungen werden genauso voneinander abgetrennt wie
  12748.      in C oder Perl - jedes Statement wird mit einem Semikolon beendet.
  12749.     </P
  12750. ><P
  12751. >      Auch der schlie▀ende Tag (?>) bedeutet das Ende eines Statements,
  12752.      deshalb sind die folgenden Beispiele gleichwertig:
  12753.  
  12754.      <DIV
  12755. CLASS="informalexample"
  12756. ><P
  12757. ></P
  12758. ><A
  12759. NAME="AEN2455"
  12760. ></A
  12761. ><TABLE
  12762. BORDER="0"
  12763. BGCOLOR="#E0E0E0"
  12764. CELLPADDING="5"
  12765. ><TR
  12766. ><TD
  12767. ><PRE
  12768. CLASS="php"
  12769. ><?php
  12770.     echo "Dies ist ein Test";
  12771. ?>
  12772.  
  12773. <?php echo "Dies ist ein Test" ?></PRE
  12774. ></TD
  12775. ></TR
  12776. ></TABLE
  12777. ><P
  12778. ></P
  12779. ></DIV
  12780. >
  12781.     </P
  12782. ></DIV
  12783. ><DIV
  12784. CLASS="sect1"
  12785. ><HR><H2
  12786. CLASS="sect1"
  12787. ><A
  12788. NAME="language.basic-syntax.comments"
  12789. >Kommentare</A
  12790. ></H2
  12791. ><P
  12792. >      PHP unterstⁿtzt 'C', 'C++' und Unix-Shell-artige Kommentare. Beispiele:
  12793.  
  12794.     <DIV
  12795. CLASS="informalexample"
  12796. ><P
  12797. ></P
  12798. ><A
  12799. NAME="AEN2460"
  12800. ></A
  12801. ><TABLE
  12802. BORDER="0"
  12803. BGCOLOR="#E0E0E0"
  12804. CELLPADDING="5"
  12805. ><TR
  12806. ><TD
  12807. ><PRE
  12808. CLASS="php"
  12809. ><?php
  12810.     echo "Dies ist ein Test"; // Dies ist ein einzeiliger Kommentar im C++-Stil.
  12811.     /* Dies ist ein mehrzeiliger Kommentar
  12812.        und noch eine Kommentar-Zeile */
  12813.     echo "Dies ist noch ein Test";
  12814.     echo "... und ein letzter Test"; # Dies ist ein Shell-artiger Kommentar.
  12815. ?></PRE
  12816. ></TD
  12817. ></TR
  12818. ></TABLE
  12819. ><P
  12820. ></P
  12821. ></DIV
  12822. >
  12823.    </P
  12824. ><P
  12825. >      Die einzeiligen Kommentar-Arten kommentieren sΣmtlichen Text bis
  12826.      zum Zeilenende oder bis zum Ende des aktuellen PHP-Blocks aus, je
  12827.      nachdem, was zuerst eintritt.
  12828.     </P
  12829. ><DIV
  12830. CLASS="informalexample"
  12831. ><P
  12832. ></P
  12833. ><A
  12834. NAME="AEN2463"
  12835. ></A
  12836. ><TABLE
  12837. BORDER="0"
  12838. BGCOLOR="#E0E0E0"
  12839. CELLPADDING="5"
  12840. ><TR
  12841. ><TD
  12842. ><PRE
  12843. CLASS="php"
  12844. ><h1>Dies ist ein  <?php # echo "einfaches";?> Beispiel.</h1>
  12845. <p>Obige ▄berschrift wird lauten: 'Dies ist ein Beispiel.'.</PRE
  12846. ></TD
  12847. ></TR
  12848. ></TABLE
  12849. ><P
  12850. ></P
  12851. ></DIV
  12852. ><P
  12853. >      Man sollte darauf achten, nicht mehrere ┤C┤-artigen Kommentare ineinander
  12854.      zu setzen, was vorkommen kann, wenn man gro▀e Bl÷cke auskommentiert.
  12855.      </P
  12856. ><DIV
  12857. CLASS="informalexample"
  12858. ><P
  12859. ></P
  12860. ><A
  12861. NAME="AEN2466"
  12862. ></A
  12863. ><TABLE
  12864. BORDER="0"
  12865. BGCOLOR="#E0E0E0"
  12866. CELLPADDING="5"
  12867. ><TR
  12868. ><TD
  12869. ><PRE
  12870. CLASS="php"
  12871. ><?php
  12872. /*
  12873.    echo "Dies ist ein Test"; /* Dieser Kommentar wird ein Problem verursachen. */
  12874. */
  12875. ?></PRE
  12876. ></TD
  12877. ></TR
  12878. ></TABLE
  12879. ><P
  12880. ></P
  12881. ></DIV
  12882. ><P
  12883. >     Die einzeiligen Kommentar-Arten kommentieren den Text tatsΣchlich
  12884.     nur bis zum Zeilenende oder bis zum Ende des aktuellen PHP-Blocks aus,
  12885.     je nachdem, was zuerst eintritt. Das hei▀t, dass HTML Code nach // ?>
  12886.     ausgegeben wird: ?> steigt aus dem PHP-Modus aus und kehrt in den HTML
  12887.     Modus zurⁿck, ohne dass // dies beeinflussen k÷nnte.
  12888.    </P
  12889. ></DIV
  12890. ></DIV
  12891. ><DIV
  12892. CLASS="chapter"
  12893. ><HR><H1
  12894. ><A
  12895. NAME="language.types"
  12896. >Kapitel 10. Typen</A
  12897. ></H1
  12898. ><DIV
  12899. CLASS="sect1"
  12900. ><H2
  12901. CLASS="sect1"
  12902. ><A
  12903. NAME="language.types.intro"
  12904. >Einfⁿhrung</A
  12905. ></H2
  12906. ><P
  12907. >     PHP unterstⁿtzt acht primitive Typen.
  12908.    </P
  12909. ><P
  12910. >     Vier skalare Typen:
  12911.     <P
  12912. ></P
  12913. ><UL
  12914. ><LI
  12915. ><P
  12916. >        Boolean
  12917.       </P
  12918. ></LI
  12919. ><LI
  12920. ><P
  12921. >        Integer
  12922.       </P
  12923. ></LI
  12924. ><LI
  12925. ><P
  12926. >        Flie▀komma-Zahl (float)
  12927.       </P
  12928. ></LI
  12929. ><LI
  12930. ><P
  12931. >        String / Zeichenkette
  12932.       </P
  12933. ></LI
  12934. ></UL
  12935. >
  12936.  
  12937.     Zwei zusammengesetzte Typen:
  12938.  
  12939.     <P
  12940. ></P
  12941. ><UL
  12942. ><LI
  12943. ><P
  12944. >        Array
  12945.       </P
  12946. ></LI
  12947. ><LI
  12948. ><P
  12949. >        Object
  12950.       </P
  12951. ></LI
  12952. ></UL
  12953. >
  12954.  
  12955.     Und zuletzt zwei spezielle Typen:
  12956.  
  12957.     <P
  12958. ></P
  12959. ><UL
  12960. ><LI
  12961. ><P
  12962. >        Resource
  12963.       </P
  12964. ></LI
  12965. ><LI
  12966. ><P
  12967. >        <A
  12968. HREF="#language.types.null"
  12969. ><B
  12970. CLASS="type"
  12971. >NULL</B
  12972. ></A
  12973. >
  12974.       </P
  12975. ></LI
  12976. ></UL
  12977. >
  12978.  
  12979.     Fⁿr die bessere Lesbarkeit fⁿhrt dieses Handbuch ein paar <A
  12980. HREF="#language.pseudo-types"
  12981. >Pseudo-Typen</A
  12982. > ein:
  12983.  
  12984.     <P
  12985. ></P
  12986. ><UL
  12987. ><LI
  12988. ><P
  12989. >        <A
  12990. HREF="#language.types.mixed"
  12991. >Mixed</A
  12992. >
  12993.       </P
  12994. ></LI
  12995. ><LI
  12996. ><P
  12997. >        <A
  12998. HREF="#language.types.number"
  12999. >Number</A
  13000. >
  13001.       </P
  13002. ></LI
  13003. ><LI
  13004. ><P
  13005. >        <A
  13006. HREF="#language.types.mixed"
  13007. >Callback</A
  13008. >
  13009.       </P
  13010. ></LI
  13011. ></UL
  13012. >
  13013.     Sie werden auch ein paar Hinweise auf den Typ "Double" finden.
  13014.     Betrachten Sie Double als dasselbe wie Float. Die beiden
  13015.     Bezeichnungen existieren nur aus historischen Grⁿnden.
  13016.    </P
  13017. ><P
  13018. >     Der Typ einer Variablen wird normalerweise nicht vom
  13019.     Programmierer bestimmt. Zur Laufzeit von PHP wird entschieden,
  13020.     welchen Typs eine Variable ist, abhΣngig vom Zusammenhang in dem
  13021.     die Variable benutzt wird.
  13022.    </P
  13023. ><DIV
  13024. CLASS="note"
  13025. ><BLOCKQUOTE
  13026. CLASS="note"
  13027. ><P
  13028. ><B
  13029. >Anmerkung: </B
  13030. >
  13031.      Um den Typ und den Wert eines bestimmten <A
  13032. HREF="#language.expressions"
  13033. >Ausdrucks (Expression)</A
  13034. > zu
  13035.      ⁿberprⁿfen, k÷nnen Sie <A
  13036. HREF="#function.var-dump"
  13037. ><B
  13038. CLASS="function"
  13039. >var_dump()</B
  13040. ></A
  13041. > benutzen.
  13042.     </P
  13043. ><P
  13044. ><B
  13045. >Anmerkung: </B
  13046. >
  13047.      Wenn Sie zur Fehlersuche einfach nur eine lesbare Darstellung
  13048.      eines Typs ben÷tigen, benutzen Sie <A
  13049. HREF="#function.gettype"
  13050. ><B
  13051. CLASS="function"
  13052. >gettype()</B
  13053. ></A
  13054. >.
  13055.      Um auf einen bestimmten Typ zu prⁿfen, sollten Sie
  13056.      <SPAN
  13057. CLASS="emphasis"
  13058. ><I
  13059. CLASS="emphasis"
  13060. >nicht</I
  13061. ></SPAN
  13062. > <A
  13063. HREF="#function.gettype"
  13064. ><B
  13065. CLASS="function"
  13066. >gettype()</B
  13067. ></A
  13068. > benutzen.
  13069.      Stattdessen sollten Sie die
  13070.      <VAR
  13071. CLASS="literal"
  13072. >is_<VAR
  13073. CLASS="replaceable"
  13074. >type</VAR
  13075. ></VAR
  13076. > Funktionen
  13077.      verwenden.  Ein paar Beispiele:
  13078.      <DIV
  13079. CLASS="informalexample"
  13080. ><P
  13081. ></P
  13082. ><A
  13083. NAME="AEN2524"
  13084. ></A
  13085. ><TABLE
  13086. BORDER="0"
  13087. BGCOLOR="#E0E0E0"
  13088. CELLPADDING="5"
  13089. ><TR
  13090. ><TD
  13091. ><PRE
  13092. CLASS="php"
  13093. ><?php
  13094. $bool = TRUE;   // ein Boolean (Wahrheitswert)
  13095. $str  = "foo";  // ein String (Zeichenkette)
  13096. $int  = 12;     // ein Integer (Ganzzahl)
  13097.  
  13098. echo gettype($bool); // gibt "boolean" aus
  13099. echo gettype($str);  // gibt "string" aus
  13100.  
  13101. // Falls es ein Integer ist, erh÷he ihn um vier
  13102. if (is_int($int)) {
  13103.     $int += 4;
  13104. }
  13105.  
  13106. // Falls $bool ein String ist, gebe ihn aus
  13107. // (gibt ⁿberhaupt nichts aus)
  13108. if (is_string($bool)) {
  13109.     echo "String: $bool";
  13110. }
  13111. ?></PRE
  13112. ></TD
  13113. ></TR
  13114. ></TABLE
  13115. ><P
  13116. ></P
  13117. ></DIV
  13118. >
  13119.     </P
  13120. ></BLOCKQUOTE
  13121. ></DIV
  13122. ><P
  13123. >     Wenn sie die Umwandlung in einen bestimmten Variablen-Typ
  13124.     erzwingen wollen, erreichen Sie dies entweder durch <A
  13125. HREF="#language.types.typecasting"
  13126. >Typ-Umwandlung</A
  13127. > oder
  13128.     durch Gebrauch der Funktion <A
  13129. HREF="#function.settype"
  13130. ><B
  13131. CLASS="function"
  13132. >settype()</B
  13133. ></A
  13134. >.
  13135.    </P
  13136. ><P
  13137. >     Beachten Sie, dass eine Variable abhΣngig vom Typ, dem die
  13138.     Variable zu dem Zeitpunkt entspricht, in bestimmten Situationen
  13139.     unterschiedlich ausgewertet werden kann. Weitere Informationen
  13140.     entnehmen Sie dem Abschnitt zur <A
  13141. HREF="#language.types.type-juggling"
  13142. >Typ-VerΣnderung</A
  13143. >.
  13144.     Schauen Sie sich au▀erdem <A
  13145. HREF="#types.comparisons"
  13146. >PHP
  13147.     type comparison tables</A
  13148. > an, wenn Sie an Beispielen
  13149.     verschiedener typenbezogener Vergleiche interessiert sind.
  13150.    </P
  13151. ></DIV
  13152. ><DIV
  13153. CLASS="sect1"
  13154. ><HR><H2
  13155. CLASS="sect1"
  13156. ><A
  13157. NAME="language.types.boolean"
  13158. >Boolscher Typ</A
  13159. ></H2
  13160. ><P
  13161. >     Das ist der einfachste Typ. Ein <A
  13162. HREF="#language.types.boolean"
  13163. ><B
  13164. CLASS="type"
  13165. >boolean</B
  13166. ></A
  13167. > drⁿckt einen
  13168.     Wahrheitswert aus. Dieser kann entweder <TT
  13169. CLASS="constant"
  13170. ><B
  13171. >TRUE</B
  13172. ></TT
  13173. > oder <TT
  13174. CLASS="constant"
  13175. ><B
  13176. >FALSE</B
  13177. ></TT
  13178. > sein.
  13179.    </P
  13180. ><DIV
  13181. CLASS="note"
  13182. ><BLOCKQUOTE
  13183. CLASS="note"
  13184. ><P
  13185. ><B
  13186. >Anmerkung: </B
  13187. >
  13188.      Der boolsche Typ wurde in PHP 4 eingefⁿhrt.
  13189.     </P
  13190. ></BLOCKQUOTE
  13191. ></DIV
  13192. ><DIV
  13193. CLASS="sect2"
  13194. ><HR><H3
  13195. CLASS="sect2"
  13196. ><A
  13197. NAME="language.types.boolean.syntax"
  13198. >Syntax</A
  13199. ></H3
  13200. ><P
  13201. >      Um einen boolschen Typ w÷rtlich anzugeben, benutzen Sie entweder
  13202.      das Schlⁿsselwort <TT
  13203. CLASS="constant"
  13204. ><B
  13205. >TRUE</B
  13206. ></TT
  13207. > oder <TT
  13208. CLASS="constant"
  13209. ><B
  13210. >FALSE</B
  13211. ></TT
  13212. >.  Beide unterscheiden sich
  13213.      nicht bezⁿglich Gro▀- und Kleinschreibung.
  13214.      <DIV
  13215. CLASS="informalexample"
  13216. ><P
  13217. ></P
  13218. ><A
  13219. NAME="AEN2545"
  13220. ></A
  13221. ><TABLE
  13222. BORDER="0"
  13223. BGCOLOR="#E0E0E0"
  13224. CELLPADDING="5"
  13225. ><TR
  13226. ><TD
  13227. ><PRE
  13228. CLASS="php"
  13229. ><?php
  13230. $foo = True; // $foo wird der Wert TRUE zugewiesen
  13231. ?></PRE
  13232. ></TD
  13233. ></TR
  13234. ></TABLE
  13235. ><P
  13236. ></P
  13237. ></DIV
  13238. >
  13239.     </P
  13240. ><P
  13241. >      ▄blicherweise verwenden Sie einen der <A
  13242. HREF="#language.operators"
  13243. >Operatoren</A
  13244. >, der Ihnen einen
  13245.      <A
  13246. HREF="#language.types.boolean"
  13247. ><B
  13248. CLASS="type"
  13249. >boolean</B
  13250. ></A
  13251. > Wert liefert, den Sie dann an eine der <A
  13252. HREF="#language.control-structures"
  13253. >Kontroll-Strukturen</A
  13254. >
  13255.      weiterreichen.
  13256.      <DIV
  13257. CLASS="informalexample"
  13258. ><P
  13259. ></P
  13260. ><A
  13261. NAME="AEN2551"
  13262. ></A
  13263. ><TABLE
  13264. BORDER="0"
  13265. BGCOLOR="#E0E0E0"
  13266. CELLPADDING="5"
  13267. ><TR
  13268. ><TD
  13269. ><PRE
  13270. CLASS="php"
  13271. ><?php
  13272. // == ist ein Vergleichs-Operator der auf Gleichheit ⁿberprⁿft und
  13273. // einen boolschen Wert liefert
  13274. if ($action == "show_version") {
  13275.     echo "Die Version ist 1.23";
  13276. }
  13277.  
  13278. // Das ist nicht notwendig...
  13279. if ($show_separators == TRUE) {
  13280.     echo "<hr>\n";
  13281. }
  13282.  
  13283. // ...weil Sie einfach schreiben k÷nnen:
  13284. if ($show_separators) {
  13285.     echo "<hr>\n";
  13286. }
  13287. ?></PRE
  13288. ></TD
  13289. ></TR
  13290. ></TABLE
  13291. ><P
  13292. ></P
  13293. ></DIV
  13294. >
  13295.     </P
  13296. ></DIV
  13297. ><DIV
  13298. CLASS="sect2"
  13299. ><HR><H3
  13300. CLASS="sect2"
  13301. ><A
  13302. NAME="language.types.boolean.casting"
  13303. >Umwandlung nach boolean</A
  13304. ></H3
  13305. ><P
  13306. >      Um einen Wert ausdrⁿcklich nach <A
  13307. HREF="#language.types.boolean"
  13308. ><B
  13309. CLASS="type"
  13310. >boolean</B
  13311. ></A
  13312. > zu
  13313.      konvertieren benutzen Sie entweder die Umwandlung mittels
  13314.      <VAR
  13315. CLASS="literal"
  13316. >(bool)</VAR
  13317. > oder <VAR
  13318. CLASS="literal"
  13319. >(boolean)</VAR
  13320. >. In
  13321.      den allermeisten FΣllen ist es jedoch nicht notwendig die
  13322.      Umwandlung selbst vorzunehmen. Ein Wert wird automatisch
  13323.      konvertiert, falls ein Operator, eine Funktion oder eine
  13324.      Kontrollstruktur ein <A
  13325. HREF="#language.types.boolean"
  13326. ><B
  13327. CLASS="type"
  13328. >boolean</B
  13329. ></A
  13330. > Argument erfordern.
  13331.     </P
  13332. ><P
  13333. >      Siehe auch <A
  13334. HREF="#language.types.type-juggling"
  13335. >Typ-VerΣnderung</A
  13336. >.
  13337.     </P
  13338. ><P
  13339. >      Bei der Umwandlung nach <A
  13340. HREF="#language.types.boolean"
  13341. ><B
  13342. CLASS="type"
  13343. >boolean</B
  13344. ></A
  13345. > werden folgende
  13346.      Werte als <TT
  13347. CLASS="constant"
  13348. ><B
  13349. >FALSE</B
  13350. ></TT
  13351. > angesehen:
  13352.      <P
  13353. ></P
  13354. ><UL
  13355. ><LI
  13356. ><P
  13357. >         das <A
  13358. HREF="#language.types.boolean"
  13359. >boolean</A
  13360. >
  13361.         <TT
  13362. CLASS="constant"
  13363. ><B
  13364. >FALSE</B
  13365. ></TT
  13366. > selbst
  13367.        </P
  13368. ></LI
  13369. ><LI
  13370. ><P
  13371. >         die <A
  13372. HREF="#language.types.integer"
  13373. >Integer</A
  13374. > 0
  13375.         (Null)
  13376.        </P
  13377. ></LI
  13378. ><LI
  13379. ><P
  13380. >         die <A
  13381. HREF="#language.types.float"
  13382. >Flie▀komma-Zahl</A
  13383. > 0.0 (Null)
  13384.        </P
  13385. ></LI
  13386. ><LI
  13387. ><P
  13388. >die leere <A
  13389. HREF="#language.types.string"
  13390. >Zeichenkette</A
  13391. > und die
  13392.         <A
  13393. HREF="#language.types.string"
  13394. >Zeichenkette</A
  13395. > "0"
  13396.        </P
  13397. ></LI
  13398. ><LI
  13399. ><P
  13400. >         ein <A
  13401. HREF="#language.types.array"
  13402. >Array</A
  13403. > ohne
  13404.         Elemente
  13405.        </P
  13406. ></LI
  13407. ><LI
  13408. ><P
  13409. >         ein <A
  13410. HREF="#language.types.object"
  13411. >Objekt</A
  13412. > ohne
  13413.         Mitgliedsvariablen
  13414.        </P
  13415. ></LI
  13416. ><LI
  13417. ><P
  13418. >         der spezielle Typ <A
  13419. HREF="#language.types.null"
  13420. >NULL</A
  13421. > (einschlie▀lich
  13422.         nicht definierter Variablen)
  13423.        </P
  13424. ></LI
  13425. ></UL
  13426. >
  13427.  
  13428.      Jeder andere Wert wird als <TT
  13429. CLASS="constant"
  13430. ><B
  13431. >TRUE</B
  13432. ></TT
  13433. > angesehen (einschlie▀lich jeder
  13434.      <A
  13435. HREF="#language.types.resource"
  13436. >Resource</A
  13437. >).
  13438.      <DIV
  13439. CLASS="warning"
  13440. ><P
  13441. ></P
  13442. ><TABLE
  13443. CLASS="warning"
  13444. BORDER="1"
  13445. WIDTH="100%"
  13446. ><TR
  13447. ><TD
  13448. ALIGN="CENTER"
  13449. ><B
  13450. >Warnung</B
  13451. ></TD
  13452. ></TR
  13453. ><TR
  13454. ><TD
  13455. ALIGN="LEFT"
  13456. ><P
  13457. >        <VAR
  13458. CLASS="literal"
  13459. >-1</VAR
  13460. > wird als <TT
  13461. CLASS="constant"
  13462. ><B
  13463. >TRUE</B
  13464. ></TT
  13465. > angesehen, wie jede
  13466.        andere Zahl ungleich Null (egal ob negativ oder positiv)!
  13467.       </P
  13468. ></TD
  13469. ></TR
  13470. ></TABLE
  13471. ></DIV
  13472. >
  13473.      <DIV
  13474. CLASS="informalexample"
  13475. ><P
  13476. ></P
  13477. ><A
  13478. NAME="AEN2595"
  13479. ></A
  13480. ><TABLE
  13481. BORDER="0"
  13482. BGCOLOR="#E0E0E0"
  13483. CELLPADDING="5"
  13484. ><TR
  13485. ><TD
  13486. ><PRE
  13487. CLASS="php"
  13488. ><?php
  13489. echo gettype((bool) "");        // bool(falsch)
  13490. echo gettype((bool) 1);         // bool(wahr)
  13491. echo gettype((bool) -2);        // bool(wahr)
  13492. echo gettype((bool) "foo");     // bool(wahr)
  13493. echo gettype((bool) 2.3e5);     // bool(wahr)
  13494. echo gettype((bool) array(12)); // bool(wahr)
  13495. echo gettype((bool) array());   // bool(falsch)
  13496. ?></PRE
  13497. ></TD
  13498. ></TR
  13499. ></TABLE
  13500. ><P
  13501. ></P
  13502. ></DIV
  13503. >
  13504.     </P
  13505. ></DIV
  13506. ></DIV
  13507. ><DIV
  13508. CLASS="sect1"
  13509. ><HR><H2
  13510. CLASS="sect1"
  13511. ><A
  13512. NAME="language.types.integer"
  13513. >Integer Typen</A
  13514. ></H2
  13515. ><P
  13516. >     Ein Integer ist eine Zahl aus der Menge Z = {..., -2,
  13517.     -1, 0, 1, 2, ...}.
  13518.    </P
  13519. ><P
  13520. >     Siehe auch: <A
  13521. HREF="#ref.gmp"
  13522. >Ganzzahlen beliebiger LΣnge /
  13523.     GMP</A
  13524. >, <A
  13525. HREF="#language.types.float"
  13526. >Flie▀komma-Zahlen</A
  13527. > und <A
  13528. HREF="#ref.bc"
  13529. >Mathematische Funktionen mit beliebiger
  13530.     Genauigkeit</A
  13531. >
  13532.    </P
  13533. ><DIV
  13534. CLASS="sect2"
  13535. ><HR><H3
  13536. CLASS="sect2"
  13537. ><A
  13538. NAME="language.types.integer.syntax"
  13539. >Syntax</A
  13540. ></H3
  13541. ><P
  13542. >      Ganzzahlen k÷nnen in dezimaler (10-basierter), hexadezimaler
  13543.      (16-basierter) oder oktaler (8-basierter) Schreibweise angegeben
  13544.      werden, wahlweise mit einem vorangestellten Zeichen (- oder +).
  13545.     </P
  13546. ><P
  13547. >      Wenn Sie die oktale Schreibweise verwenden, mⁿssen Sie die Zahl
  13548.      mit einer vorangestellten Null <VAR
  13549. CLASS="literal"
  13550. >0</VAR
  13551. > schreiben; in
  13552.      hexadezimaler Schreibweise mⁿssen Sie vor die Zahl ein
  13553.      <VAR
  13554. CLASS="literal"
  13555. >0x</VAR
  13556. > schreiben.
  13557.      <TABLE
  13558. WIDTH="100%"
  13559. BORDER="0"
  13560. CELLPADDING="0"
  13561. CELLSPACING="0"
  13562. CLASS="EXAMPLE"
  13563. ><TR
  13564. ><TD
  13565. ><DIV
  13566. CLASS="example"
  13567. ><A
  13568. NAME="AEN2611"
  13569. ></A
  13570. ><P
  13571. ><B
  13572. >Beispiel 10-1. Integer Literale</B
  13573. ></P
  13574. ><TABLE
  13575. BORDER="0"
  13576. BGCOLOR="#E0E0E0"
  13577. CELLPADDING="5"
  13578. ><TR
  13579. ><TD
  13580. ><PRE
  13581. CLASS="php"
  13582. ><?php
  13583. $a = 1234; // Dezimalzahl
  13584. $a = -123; // eine negative Zahl
  13585. $a = 0123; // Oktalzahl (entspricht 83 dezimal)
  13586. $a = 0x1A; // Hexadezimalzahl (entspricht 26 dezimal)
  13587. ?></PRE
  13588. ></TD
  13589. ></TR
  13590. ></TABLE
  13591. ></DIV
  13592. ></TD
  13593. ></TR
  13594. ></TABLE
  13595. >
  13596.      Formell ist die m÷gliche Struktur fⁿr Integer Literale:
  13597.      <DIV
  13598. CLASS="informalexample"
  13599. ><P
  13600. ></P
  13601. ><A
  13602. NAME="AEN2614"
  13603. ></A
  13604. ><TABLE
  13605. BORDER="0"
  13606. BGCOLOR="#E0E0E0"
  13607. CELLPADDING="5"
  13608. ><TR
  13609. ><TD
  13610. ><PRE
  13611. CLASS="programlisting"
  13612. >dezimal     : [1-9][0-9]*
  13613.             | 0
  13614.  
  13615. hexadezimal : 0[xX][0-9a-fA-F]+
  13616.  
  13617. oktal       : 0[0-7]+
  13618.  
  13619. integer     : [+-]?dezimal
  13620.             | [+-]?hexadezimal
  13621.             | [+-]?oktal</PRE
  13622. ></TD
  13623. ></TR
  13624. ></TABLE
  13625. ><P
  13626. ></P
  13627. ></DIV
  13628. >
  13629.      Die Gr÷▀e eines Integer-Wertes ist plattformabhΣngig, ein
  13630.      Maximalwert von ungefΣhr zwei Milliarden ist jedoch ⁿblich
  13631.      (vorzeichenbehafteter 32-Bit-Wert). PHP unterstⁿtzt keine
  13632.      vorzeichenlosen Integer-Werte.
  13633.     </P
  13634. ></DIV
  13635. ><DIV
  13636. CLASS="sect2"
  13637. ><HR><H3
  13638. CLASS="sect2"
  13639. ><A
  13640. NAME="language.types.integer.overflow"
  13641. >Integer ▄berlauf</A
  13642. ></H3
  13643. ><P
  13644. >      Wenn Sie eine Zahl jenseits der Grenzen des Typs
  13645.      Integer angeben, wird diese stattdessen als Typ
  13646.      <A
  13647. HREF="#language.types.float"
  13648. ><B
  13649. CLASS="type"
  13650. >float</B
  13651. ></A
  13652. > interpretiert.  Wenn Sie eine Operation
  13653.      ausfⁿhren, deren Ergebnis eine Zahl jenseits der Grenzen des Typs
  13654.      Integer ist, wird ebenso eine Zahl vom Typ
  13655.      <A
  13656. HREF="#language.types.float"
  13657. ><B
  13658. CLASS="type"
  13659. >float</B
  13660. ></A
  13661. > zurⁿckgegeben.
  13662.  
  13663.      <DIV
  13664. CLASS="informalexample"
  13665. ><P
  13666. ></P
  13667. ><A
  13668. NAME="AEN2623"
  13669. ></A
  13670. ><TABLE
  13671. BORDER="0"
  13672. BGCOLOR="#E0E0E0"
  13673. CELLPADDING="5"
  13674. ><TR
  13675. ><TD
  13676. ><PRE
  13677. CLASS="php"
  13678. ><?php
  13679. $grosse_zahl =  2147483647;
  13680. var_dump($grosse_zahl);
  13681. // Ausgabe: int(2147483647)
  13682.  
  13683. $grosse_zahl =  2147483648;
  13684. var_dump($grosse_zahl);
  13685. // Ausgabe: float(2147483648)
  13686.  
  13687. // das gilt auch fⁿr Integers in hexadezimaler Schreibweise:
  13688. var_dump( 0x80000000 );
  13689. // Ausgabe: float(2147483648)
  13690.  
  13691. $million = 1000000;
  13692. $grosse_zahl =  50000 * $million;
  13693. var_dump($grosse_zahl);
  13694. // Ausgabe: float(50000000000)
  13695. ?></PRE
  13696. ></TD
  13697. ></TR
  13698. ></TABLE
  13699. ><P
  13700. ></P
  13701. ></DIV
  13702. >
  13703.      <DIV
  13704. CLASS="warning"
  13705. ><P
  13706. ></P
  13707. ><TABLE
  13708. CLASS="warning"
  13709. BORDER="1"
  13710. WIDTH="100%"
  13711. ><TR
  13712. ><TD
  13713. ALIGN="CENTER"
  13714. ><B
  13715. >Warnung</B
  13716. ></TD
  13717. ></TR
  13718. ><TR
  13719. ><TD
  13720. ALIGN="LEFT"
  13721. ><P
  13722. >        Bedauerlicherweise gab es einen Bug in PHP, der die korrekte
  13723.        Funktionsweise verhinderte, wenn negative Zahlen verwendet
  13724.        wurden.  Ein Beispiel: Bei der Ausfⁿhrung von <VAR
  13725. CLASS="literal"
  13726. >-50000
  13727.        * $million</VAR
  13728. > war das Ergebnis
  13729.        <VAR
  13730. CLASS="literal"
  13731. >-429496728</VAR
  13732. >. Sind beide Operanden positiv
  13733.        gibt es keine Probleme.
  13734.       </P
  13735. ><P
  13736. >        Dieses Problem ist in PHP 4.1.0 behoben worden.
  13737.       </P
  13738. ></TD
  13739. ></TR
  13740. ></TABLE
  13741. ></DIV
  13742. >
  13743.     </P
  13744. ><P
  13745. >      In PHP gibt es keinen Operator fⁿr Integer-Divisonen.
  13746.      <VAR
  13747. CLASS="literal"
  13748. >1/2</VAR
  13749. > ergibt <A
  13750. HREF="#language.types.float"
  13751. ><B
  13752. CLASS="type"
  13753. >float</B
  13754. ></A
  13755. >
  13756.      <VAR
  13757. CLASS="literal"
  13758. >0.5</VAR
  13759. >.  Sie k÷nnen den Wert in einen Integer
  13760.      umwandeln, um ihn immer abzurunden oder die Funktion
  13761.      <A
  13762. HREF="#function.round"
  13763. ><B
  13764. CLASS="function"
  13765. >round()</B
  13766. ></A
  13767. > benutzen.
  13768.      <DIV
  13769. CLASS="informalexample"
  13770. ><P
  13771. ></P
  13772. ><A
  13773. NAME="AEN2635"
  13774. ></A
  13775. ><TABLE
  13776. BORDER="0"
  13777. BGCOLOR="#E0E0E0"
  13778. CELLPADDING="5"
  13779. ><TR
  13780. ><TD
  13781. ><PRE
  13782. CLASS="php"
  13783. ><?php
  13784. var_dump(25/7);         // float(3.5714285714286)
  13785. var_dump((int) (25/7)); // int(3)
  13786. var_dump(round(25/7));  // float(4)
  13787. ?></PRE
  13788. ></TD
  13789. ></TR
  13790. ></TABLE
  13791. ><P
  13792. ></P
  13793. ></DIV
  13794. >
  13795.     </P
  13796. ></DIV
  13797. ><DIV
  13798. CLASS="sect2"
  13799. ><HR><H3
  13800. CLASS="sect2"
  13801. ><A
  13802. NAME="language.types.integer.casting"
  13803. >Umwandlung nach integer</A
  13804. ></H3
  13805. ><P
  13806. >      Um einen Wert ausdrⁿcklich nach <A
  13807. HREF="#language.types.integer"
  13808. ><B
  13809. CLASS="type"
  13810. >integer</B
  13811. ></A
  13812. > zu
  13813.      konvertieren, benutzen Sie entweder die Umwandlung mittels
  13814.      <VAR
  13815. CLASS="literal"
  13816. >(int)</VAR
  13817. > oder <VAR
  13818. CLASS="literal"
  13819. >(integer)</VAR
  13820. >. In
  13821.      den allermeisten FΣllen ist es jedoch nicht notwendig die
  13822.      Umwandlung selbst vorzunehmen. Ein Wert wird automatisch
  13823.      konvertiert, falls ein Operator, eine Funktion oder eine
  13824.      Kontrollstruktur ein <A
  13825. HREF="#language.types.integer"
  13826. ><B
  13827. CLASS="type"
  13828. >integer</B
  13829. ></A
  13830. > Argument erfordern.
  13831.      Sie k÷nnen einen Wert auch mit der Funktion
  13832.      <A
  13833. HREF="#function.intval"
  13834. ><B
  13835. CLASS="function"
  13836. >intval()</B
  13837. ></A
  13838. > in einen Integer umwandeln.
  13839.     </P
  13840. ><P
  13841. >      Siehe auch <A
  13842. HREF="#language.types.type-juggling"
  13843. >Typ-VerΣnderung</A
  13844. >.
  13845.     </P
  13846. ><DIV
  13847. CLASS="sect3"
  13848. ><HR><H4
  13849. CLASS="sect3"
  13850. ><A
  13851. NAME="language.types.integer.casting.from-boolean"
  13852. >Von <A
  13853. HREF="#language.types.boolean"
  13854. >Booleans</A
  13855. ></A
  13856. ></H4
  13857. ><P
  13858. >       <TT
  13859. CLASS="constant"
  13860. ><B
  13861. >FALSE</B
  13862. ></TT
  13863. > ergibt <VAR
  13864. CLASS="literal"
  13865. >0</VAR
  13866. > (Null), und <TT
  13867. CLASS="constant"
  13868. ><B
  13869. >TRUE</B
  13870. ></TT
  13871. > ergibt
  13872.       <VAR
  13873. CLASS="literal"
  13874. >1</VAR
  13875. > (Eins).
  13876.      </P
  13877. ></DIV
  13878. ><DIV
  13879. CLASS="sect3"
  13880. ><HR><H4
  13881. CLASS="sect3"
  13882. ><A
  13883. NAME="language.types.integer.casting.from-float"
  13884. >Von <A
  13885. HREF="#language.types.float"
  13886. >Flie▀komma-Zahlen</A
  13887. ></A
  13888. ></H4
  13889. ><P
  13890. >       Bei der Umwandlung von <A
  13891. HREF="#language.types.float"
  13892. ><B
  13893. CLASS="type"
  13894. >float</B
  13895. ></A
  13896. > nach integer wird die
  13897.       Zahl <SPAN
  13898. CLASS="emphasis"
  13899. ><I
  13900. CLASS="emphasis"
  13901. >in Richtung Null</I
  13902. ></SPAN
  13903. > gerundet.
  13904.      </P
  13905. ><P
  13906. >       Wenn der float jenseits der Grenzen von integer liegt
  13907.       (ⁿblicherweise <VAR
  13908. CLASS="literal"
  13909. >+/- 2.15e+9 = 2^31</VAR
  13910. >), ist das
  13911.       Ergebnis nicht definiert, weil float nicht genug PrΣzision
  13912.       besitzt um ein genaues integer Ergebnis zu liefern. Keine
  13913.       Warnung, nicht einmal eine Notiz wird in diesem Fall ausgegeben.
  13914.      </P
  13915. ><DIV
  13916. CLASS="warning"
  13917. ><P
  13918. ></P
  13919. ><TABLE
  13920. CLASS="warning"
  13921. BORDER="1"
  13922. WIDTH="100%"
  13923. ><TR
  13924. ><TD
  13925. ALIGN="CENTER"
  13926. ><B
  13927. >Warnung</B
  13928. ></TD
  13929. ></TR
  13930. ><TR
  13931. ><TD
  13932. ALIGN="LEFT"
  13933. ><P
  13934. >        Wandeln Sie nie einen Teil eines Ausdrucks nach
  13935.        <A
  13936. HREF="#language.types.integer"
  13937. ><B
  13938. CLASS="type"
  13939. >integer</B
  13940. ></A
  13941. > um, da dies manchmal zu unerwarteten
  13942.        Ergebnissen fⁿhren kann.
  13943.        <DIV
  13944. CLASS="informalexample"
  13945. ><P
  13946. ></P
  13947. ><A
  13948. NAME="AEN2666"
  13949. ></A
  13950. ><TABLE
  13951. BORDER="0"
  13952. BGCOLOR="#E0E0E0"
  13953. CELLPADDING="5"
  13954. ><TR
  13955. ><TD
  13956. ><PRE
  13957. CLASS="php"
  13958. ><?php
  13959. echo (int) ( (0.1+0.7) * 10 ); // Ausgabe: 7!
  13960. ?></PRE
  13961. ></TD
  13962. ></TR
  13963. ></TABLE
  13964. ><P
  13965. ></P
  13966. ></DIV
  13967. >
  13968.        Fⁿr mehr Informationen schauen Sie unter <A
  13969. HREF="#warn.float-precision"
  13970. >Warnung ⁿber
  13971.        float-PrΣzision</A
  13972. > nach.
  13973.       </P
  13974. ></TD
  13975. ></TR
  13976. ></TABLE
  13977. ></DIV
  13978. ></DIV
  13979. ><DIV
  13980. CLASS="sect3"
  13981. ><HR><H4
  13982. CLASS="sect3"
  13983. ><A
  13984. NAME="language.types.integer.casting.from-string"
  13985. >Von Zeichenketten / Strings</A
  13986. ></H4
  13987. ><P
  13988. >       Siehe <A
  13989. HREF="#language.types.string.conversion"
  13990. >Umwandlung von
  13991.       Strings in Zahlen</A
  13992. >
  13993.      </P
  13994. ></DIV
  13995. ><DIV
  13996. CLASS="sect3"
  13997. ><HR><H4
  13998. CLASS="sect3"
  13999. ><A
  14000. NAME="language.types.integer.casting.from-other"
  14001. >Von anderen Typen</A
  14002. ></H4
  14003. ><P
  14004. >       <DIV
  14005. CLASS="caution"
  14006. ><P
  14007. ></P
  14008. ><TABLE
  14009. CLASS="caution"
  14010. BORDER="1"
  14011. WIDTH="100%"
  14012. ><TR
  14013. ><TD
  14014. ALIGN="CENTER"
  14015. ><B
  14016. >Achtung</B
  14017. ></TD
  14018. ></TR
  14019. ><TR
  14020. ><TD
  14021. ALIGN="LEFT"
  14022. ><P
  14023. >         Das Verhalten bei der Umwandlung nach integer ist fⁿr andere
  14024.         Typen nicht definiert. Zum gegenwΣrtigen Zeitpunkt ist das
  14025.         Verhalten so, als ob der Wert zuerst nach <A
  14026. HREF="#language.types.boolean.casting"
  14027. >boolean</A
  14028. >
  14029.         konvertiert wird. Auf jeden Fall sollten Sie sich auf dieses
  14030.         Verhalten <SPAN
  14031. CLASS="emphasis"
  14032. ><I
  14033. CLASS="emphasis"
  14034. >nicht</I
  14035. ></SPAN
  14036. > verlassen. Es kann sich
  14037.         ohne Ankⁿndigung Σndern.
  14038.        </P
  14039. ></TD
  14040. ></TR
  14041. ></TABLE
  14042. ></DIV
  14043. >
  14044.      </P
  14045. ></DIV
  14046. ></DIV
  14047. ></DIV
  14048. ><DIV
  14049. CLASS="sect1"
  14050. ><HR><H2
  14051. CLASS="sect1"
  14052. ><A
  14053. NAME="language.types.float"
  14054. >Flie▀komma-Zahlenwerte</A
  14055. ></H2
  14056. ><P
  14057. >     Flie▀komma-Zahlenwerte ("floats", "doubles" oder "reelle Zahlen")
  14058.     k÷nnen durch eine der folgenden Anweisungen zugewiesen werden:
  14059.     <DIV
  14060. CLASS="informalexample"
  14061. ><P
  14062. ></P
  14063. ><A
  14064. NAME="AEN2683"
  14065. ></A
  14066. ><TABLE
  14067. BORDER="0"
  14068. BGCOLOR="#E0E0E0"
  14069. CELLPADDING="5"
  14070. ><TR
  14071. ><TD
  14072. ><PRE
  14073. CLASS="php"
  14074. ><?php
  14075. $a = 1.234;
  14076. $a = 1.2e3;
  14077. $a = 7E-10;
  14078. ?></PRE
  14079. ></TD
  14080. ></TR
  14081. ></TABLE
  14082. ><P
  14083. ></P
  14084. ></DIV
  14085. >
  14086.     Formell:
  14087.     <DIV
  14088. CLASS="informalexample"
  14089. ><P
  14090. ></P
  14091. ><A
  14092. NAME="AEN2685"
  14093. ></A
  14094. ><TABLE
  14095. BORDER="0"
  14096. BGCOLOR="#E0E0E0"
  14097. CELLPADDING="5"
  14098. ><TR
  14099. ><TD
  14100. ><PRE
  14101. CLASS="php"
  14102. >LNUM          [0-9]+
  14103. DNUM          ([0-9]*[\.]{LNUM}) | ({LNUM}[\.][0-9]*)
  14104. EXPONENT_DNUM ( ({LNUM} | {DNUM}) [eE][+-]? {LNUM})</PRE
  14105. ></TD
  14106. ></TR
  14107. ></TABLE
  14108. ><P
  14109. ></P
  14110. ></DIV
  14111. >
  14112.     Die Gr÷▀e einer Flie▀komma-Zahl ist plattformabhΣngig, dennoch
  14113.     stellt ein Maximum von ~1.8e308 mit einer Genauigkeit von 14
  14114.     Nachkomma-Stellen einen ⁿblichen Wert dar (das entspricht 64-Bit
  14115.     im IEEE-Format).
  14116.    </P
  14117. ><DIV
  14118. CLASS="warning"
  14119. ><P
  14120. ></P
  14121. ><TABLE
  14122. CLASS="warning"
  14123. BORDER="1"
  14124. WIDTH="100%"
  14125. ><TR
  14126. ><TD
  14127. ALIGN="CENTER"
  14128. ><B
  14129. ><A
  14130. NAME="warn.float-precision"
  14131. ></A
  14132. >Flie▀komma PrΣzision</B
  14133. ></TD
  14134. ></TR
  14135. ><TR
  14136. ><TD
  14137. ALIGN="LEFT"
  14138. ><P
  14139. >      Es ist ziemlich normal, dass einfache Dezimalzahlen wie
  14140.      <VAR
  14141. CLASS="literal"
  14142. >0.1</VAR
  14143. > oder <VAR
  14144. CLASS="literal"
  14145. >0.7</VAR
  14146. > nicht in ihre
  14147.      internen binΣren Entsprechungen konvertiert werden k÷nnen, ohne
  14148.      einen kleinen Teil ihrer Genauigkeit zu verlieren. Das kann zu
  14149.      verwirrenden Ergebnissen fⁿhren. So wird <VAR
  14150. CLASS="literal"
  14151. >floor((0.1 +
  14152.      0.7) * 10)</VAR
  14153. > normalerweise <VAR
  14154. CLASS="literal"
  14155. >7</VAR
  14156. > statt des
  14157.      erwarteten Wertes <VAR
  14158. CLASS="literal"
  14159. >8</VAR
  14160. > zurⁿck geben (als Ergebnis
  14161.      der internen Entsprechung von <VAR
  14162. CLASS="literal"
  14163. >7.9999999999...</VAR
  14164. >.
  14165.     </P
  14166. ><P
  14167. >      Das grⁿndet sich auf die Tatsache, dass es unm÷glich ist, manche
  14168.      Dezimal-Zahlen durch eine endliche Anzahl an Nachkomma-Stellen
  14169.      darzustellen. Dem Wert <VAR
  14170. CLASS="literal"
  14171. >1/3</VAR
  14172. > entspricht z.B.
  14173.      der interne Wert von <VAR
  14174. CLASS="literal"
  14175. >0.3333333. . .</VAR
  14176. >.
  14177.     </P
  14178. ><P
  14179. >      Deshalb sollten Sie nie den Ergebnissen von
  14180.      Flie▀komma-Operationen bis auf die letzte Nachkomma-Stelle trauen
  14181.      und nie solche auf Gleichheit prⁿfen. Ben÷tigen Sie wirklich eine
  14182.      gr÷▀ere Genauigkeit, sollten sie die <A
  14183. HREF="#ref.bc"
  14184. >mathematischen Funktionen beliebiger
  14185.      Genauigkeit</A
  14186. > oder die <A
  14187. HREF="#ref.gmp"
  14188. >Gmp</A
  14189. >
  14190.      Funktionen benutzen.
  14191.     </P
  14192. ></TD
  14193. ></TR
  14194. ></TABLE
  14195. ></DIV
  14196. ><DIV
  14197. CLASS="sect2"
  14198. ><HR><H3
  14199. CLASS="sect2"
  14200. ><A
  14201. NAME="language.types.float.casting"
  14202. >Umwandlung nach float</A
  14203. ></H3
  14204. ><P
  14205. >      Fⁿr Informationen darⁿber, wann und wie Strings in Float
  14206.      umgewandelt werden, lesen Sie bitte den Abschnitt <A
  14207. HREF="#language.types.string.conversion"
  14208. >Umwandlung von Strings
  14209.      in Zahlen</A
  14210. >. Fⁿr die Werte anderer Typen ist die Umwandlung
  14211.      diesselbe, wie wenn der Wert in eine Ganzzahl und dann in einen
  14212.      Float umgewandelt worden wΣre. Fⁿr weitere Informationen siehe
  14213.      Abschnitt <A
  14214. HREF="#language.types.integer.casting"
  14215. >Umwandlung nach
  14216.      integer</A
  14217. >.
  14218.     </P
  14219. ></DIV
  14220. ></DIV
  14221. ><DIV
  14222. CLASS="sect1"
  14223. ><HR><H2
  14224. CLASS="sect1"
  14225. ><A
  14226. NAME="language.types.string"
  14227. >Strings / Zeichenketten</A
  14228. ></H2
  14229. ><P
  14230. >     Ein String ist eine Folge von Zeichen. In PHP
  14231.     entspricht ein Zeichen einem Byte, das hei▀t, dass exakt 256
  14232.     unterschiedliche Zeichen m÷glich sind. Das impliziert auch, dass
  14233.     PHP keine native Unterstⁿtzung fⁿr Unicode bietet. Siehe
  14234.     <A
  14235. HREF="#function.utf8-encode"
  14236. ><B
  14237. CLASS="function"
  14238. >utf8_encode()</B
  14239. ></A
  14240. > und
  14241.     <A
  14242. HREF="#function.utf8-decode"
  14243. ><B
  14244. CLASS="function"
  14245. >utf8_decode()</B
  14246. ></A
  14247. > fⁿr etwas Unicode-Unterstⁿtzung.
  14248.    </P
  14249. ><DIV
  14250. CLASS="note"
  14251. ><BLOCKQUOTE
  14252. CLASS="note"
  14253. ><P
  14254. ><B
  14255. >Anmerkung: </B
  14256. >
  14257.      Fⁿr einen String stellt die LΣnge kein Problem dar. Von PHP-Seite
  14258.      aus gibt es keine praktische Grenze fⁿr die Gr÷▀e eines Strings.
  14259.      Daher gibt es keinen Grund sich Sorgen ⁿber lange Strings zu
  14260.      machen.
  14261.     </P
  14262. ></BLOCKQUOTE
  14263. ></DIV
  14264. ><DIV
  14265. CLASS="sect2"
  14266. ><HR><H3
  14267. CLASS="sect2"
  14268. ><A
  14269. NAME="language.types.string.syntax"
  14270. >Syntax</A
  14271. ></H3
  14272. ><P
  14273. >      Ein String kann auf drei verschiedene Weisen geschrieben werden.
  14274.  
  14275.      <P
  14276. ></P
  14277. ><UL
  14278. ><LI
  14279. ><P
  14280. >         <A
  14281. HREF="#language.types.string.syntax.single"
  14282. >Einfache
  14283.         Anfⁿhrungszeichen (single quoted)</A
  14284. >
  14285.        </P
  14286. ></LI
  14287. ><LI
  14288. ><P
  14289. >         <A
  14290. HREF="#language.types.string.syntax.double"
  14291. >Doppelte
  14292.         Anfⁿhrungszeichen (double quoted)</A
  14293. >
  14294.        </P
  14295. ></LI
  14296. ><LI
  14297. ><P
  14298. >         <A
  14299. HREF="#language.types.string.syntax.heredoc"
  14300. >Heredoc
  14301.         Syntax</A
  14302. >
  14303.        </P
  14304. ></LI
  14305. ></UL
  14306. >
  14307.     </P
  14308. ><DIV
  14309. CLASS="sect3"
  14310. ><HR><H4
  14311. CLASS="sect3"
  14312. ><A
  14313. NAME="language.types.string.syntax.single"
  14314. >Einfache Anfⁿhrungszeichen (Single quoted)</A
  14315. ></H4
  14316. ><P
  14317. >       Der leichteste Weg einen einfachen String zu schreiben, ist der
  14318.       Einschluss in einfache Anfⁿhrungszeichen (das Zeichen
  14319.       <VAR
  14320. CLASS="literal"
  14321. >'</VAR
  14322. >).
  14323.      </P
  14324. ><P
  14325. >       Um ein einfaches Anfⁿhrungszeichen w÷rtlich auszugeben, muss
  14326.       dieses, wie in vielen anderen Programmiersprachen auch mit einem
  14327.       Backslash (<VAR
  14328. CLASS="literal"
  14329. >\</VAR
  14330. >) escaped werden. Wenn Sie
  14331.       innerhalb eines Strings einen Backslash vor einem einfachen
  14332.       Anfⁿhrungszeichen oder am Ende eines Strings ausgeben wollen,
  14333.       mⁿssen Sie diesen verdoppeln.  Beachten Sie: wenn Sie versuchen
  14334.       irgendwelche anderen Zeichen zu escapen, wird der Backslash
  14335.       ebenfalls ausgegeben! Daher besteht fⁿr gew÷hnlich keine
  14336.       Notwendigkeit den Backslash selbst zu escapen.
  14337.       <DIV
  14338. CLASS="note"
  14339. ><BLOCKQUOTE
  14340. CLASS="note"
  14341. ><P
  14342. ><B
  14343. >Anmerkung: </B
  14344. >
  14345.         In PHP 3 wird eine Warnung der Stufe
  14346.         <VAR
  14347. CLASS="literal"
  14348. >E_NOTICE</VAR
  14349. > ausgegeben, wenn das passiert.
  14350.        </P
  14351. ></BLOCKQUOTE
  14352. ></DIV
  14353. >
  14354.       <DIV
  14355. CLASS="note"
  14356. ><BLOCKQUOTE
  14357. CLASS="note"
  14358. ><P
  14359. ><B
  14360. >Anmerkung: </B
  14361. >
  14362.         Anders als bei den zwei anderen Schreibweisen werden <A
  14363. HREF="#language.variables"
  14364. >Variablen</A
  14365. > und
  14366.         escape-Sequenzen fⁿr spezielle Zeichen innerhalb von
  14367.         single-quoted Strings <SPAN
  14368. CLASS="emphasis"
  14369. ><I
  14370. CLASS="emphasis"
  14371. >nicht</I
  14372. ></SPAN
  14373. > ausgewertet.
  14374.        </P
  14375. ></BLOCKQUOTE
  14376. ></DIV
  14377. >
  14378.       <DIV
  14379. CLASS="informalexample"
  14380. ><P
  14381. ></P
  14382. ><A
  14383. NAME="AEN2741"
  14384. ></A
  14385. ><TABLE
  14386. BORDER="0"
  14387. BGCOLOR="#E0E0E0"
  14388. CELLPADDING="5"
  14389. ><TR
  14390. ><TD
  14391. ><PRE
  14392. CLASS="php"
  14393. ><?php
  14394. echo 'Das ist ein einfacher String';
  14395.  
  14396. echo 'Sie k÷nnen auf diese Weise auch Zeilenumbrⁿche
  14397. innerhalb von Strings verwenden, wenn
  14398. Ihnen danach ist';
  14399.  
  14400. // Ausgabe: Arnold sagte einmal: "I'll be back"
  14401. echo 'Arnold sagte einmal: "I\'ll be back"';
  14402.  
  14403. // Ausgabe: Sie haben C:\*.* gel÷scht?
  14404. echo 'Sie haben C:\\*.* gel÷scht?';
  14405.  
  14406. // Ausgabe: Sie haben C:\*.* gel÷scht?
  14407. echo 'Sie haben C:\*.* gel÷scht?';
  14408.  
  14409. // Ausgabe: Das wird nicht ausgewertet: \n ein Zeilenumbruch
  14410. echo 'Das wird nicht ausgewertet: \n ein Zeilenumbruch';
  14411.  
  14412. // Ausgabe: Variablen werden auch $nicht $ausgewertet
  14413. echo 'Variablen werden auch $nicht $ausgewertet';
  14414. ?></PRE
  14415. ></TD
  14416. ></TR
  14417. ></TABLE
  14418. ><P
  14419. ></P
  14420. ></DIV
  14421. >
  14422.      </P
  14423. ></DIV
  14424. ><DIV
  14425. CLASS="sect3"
  14426. ><HR><H4
  14427. CLASS="sect3"
  14428. ><A
  14429. NAME="language.types.string.syntax.double"
  14430. >Doppelte Anfⁿhrungszeichen (Double quoted)</A
  14431. ></H4
  14432. ><P
  14433. >       Wenn ein String in doppelten Anfⁿhrungszeichen (")
  14434.       eingeschlossen ist, versteht PHP mehr Escape-Folgen fⁿr
  14435.       spezielle Zeichen:
  14436.      </P
  14437. ><DIV
  14438. CLASS="table"
  14439. ><A
  14440. NAME="AEN2746"
  14441. ></A
  14442. ><P
  14443. ><B
  14444. >Tabelle 10-1. Nicht ausgewertete / ⁿbergangene Zeichen:</B
  14445. ></P
  14446. ><TABLE
  14447. BORDER="1"
  14448. CLASS="CALSTABLE"
  14449. ><COL><COL><THEAD
  14450. ><TR
  14451. ><TH
  14452. >Zeichenfolge</TH
  14453. ><TH
  14454. >Bedeutung</TH
  14455. ></TR
  14456. ></THEAD
  14457. ><TBODY
  14458. ><TR
  14459. ><TD
  14460. ><VAR
  14461. CLASS="literal"
  14462. >\n</VAR
  14463. ></TD
  14464. ><TD
  14465. >Zeilenvorschub (LF oder 0x0A als ASCII-Code)</TD
  14466. ></TR
  14467. ><TR
  14468. ><TD
  14469. ><VAR
  14470. CLASS="literal"
  14471. >\r</VAR
  14472. ></TD
  14473. ><TD
  14474. >Wagenrⁿcklauf (CR oder 0x0D als ASCII-Code)</TD
  14475. ></TR
  14476. ><TR
  14477. ><TD
  14478. ><VAR
  14479. CLASS="literal"
  14480. >\t</VAR
  14481. ></TD
  14482. ><TD
  14483. >           horizontaler Tabulator (HT oder 0x09 als ASCII-Code)
  14484.          </TD
  14485. ></TR
  14486. ><TR
  14487. ><TD
  14488. ><VAR
  14489. CLASS="literal"
  14490. >\\</VAR
  14491. ></TD
  14492. ><TD
  14493. >Backslash / Rⁿckstrich</TD
  14494. ></TR
  14495. ><TR
  14496. ><TD
  14497. ><VAR
  14498. CLASS="literal"
  14499. >\$</VAR
  14500. ></TD
  14501. ><TD
  14502. >Dollar-Symbol</TD
  14503. ></TR
  14504. ><TR
  14505. ><TD
  14506. ><VAR
  14507. CLASS="literal"
  14508. >\"</VAR
  14509. ></TD
  14510. ><TD
  14511. >doppelte Anfⁿhrungszeichen</TD
  14512. ></TR
  14513. ><TR
  14514. ><TD
  14515. ><VAR
  14516. CLASS="literal"
  14517. >\[0-7]{1,3}</VAR
  14518. ></TD
  14519. ><TD
  14520. >           die Zeichenfolge, die dem regulΣren Ausdruck entspricht ist
  14521.           ein Zeichen in Oktal-Schreibweise
  14522.          </TD
  14523. ></TR
  14524. ><TR
  14525. ><TD
  14526. ><VAR
  14527. CLASS="literal"
  14528. >\x[0-9A-Fa-f]{1,2}</VAR
  14529. ></TD
  14530. ><TD
  14531. >           die Zeichenfolge, die dem regulΣren Ausdruck entspricht ist
  14532.           ein Zeichen in Hexadezimal-Schreibweise
  14533.          </TD
  14534. ></TR
  14535. ></TBODY
  14536. ></TABLE
  14537. ></DIV
  14538. ><P
  14539. >       Noch einmal: wenn Sie versuchen, irgend ein anderes Zeichen zu
  14540.       escapen wird der Backslash ebenfalls ausgegeben!
  14541.      </P
  14542. ><P
  14543. >       Das wichtigste Merkmal von double-quoted Strings ist die
  14544.       Tatsache, dass Variablennamen ausgewertet werden. Fⁿr Details
  14545.       siehe <A
  14546. HREF="#language.types.string.parsing"
  14547. >String
  14548.       Analyse (parsing)</A
  14549. >
  14550.      </P
  14551. ></DIV
  14552. ><DIV
  14553. CLASS="sect3"
  14554. ><HR><H4
  14555. CLASS="sect3"
  14556. ><A
  14557. NAME="language.types.string.syntax.heredoc"
  14558. >Heredoc</A
  14559. ></H4
  14560. ><P
  14561. >       Eine andere M÷glichkeit Strings einzufassen, besteht im Gebrauch
  14562.       der heredoc-Syntax ("<<<"). Hierfⁿr ist nach
  14563.       <VAR
  14564. CLASS="literal"
  14565. ><<<</VAR
  14566. > ein Bezeichner zu setzen. Nun
  14567.       folgt der eigentliche String und dann derselbe Bezeichner um den
  14568.       String abzuschlie▀en.
  14569.      </P
  14570. ><P
  14571. >       Der schlie▀ende Bezeichner <SPAN
  14572. CLASS="emphasis"
  14573. ><I
  14574. CLASS="emphasis"
  14575. >muss</I
  14576. ></SPAN
  14577. > in der
  14578.       ersten Spalte der Zeile stehen. Die verwendeten Bezeichner
  14579.       mⁿssen den gleichen Regeln entsprechen wie alle anderen
  14580.       PHP-Labels auch: Sie dⁿrfen lediglich alphanumerische Zeichen
  14581.       und den Unterstrich enthalten und mⁿssen mit einem Unterstrich
  14582.       oder einem Buchstaben beginnen.
  14583.      </P
  14584. ><DIV
  14585. CLASS="warning"
  14586. ><P
  14587. ></P
  14588. ><TABLE
  14589. CLASS="warning"
  14590. BORDER="1"
  14591. WIDTH="100%"
  14592. ><TR
  14593. ><TD
  14594. ALIGN="CENTER"
  14595. ><B
  14596. >Warnung</B
  14597. ></TD
  14598. ></TR
  14599. ><TR
  14600. ><TD
  14601. ALIGN="LEFT"
  14602. ><P
  14603. >        Es ist sehr wichtig zu beachten, dass die Zeile mit dem
  14604.        schlie▀enden Bezeichner keine anderen Zeichen enthΣlt,
  14605.        ausgenommen <SPAN
  14606. CLASS="emphasis"
  14607. ><I
  14608. CLASS="emphasis"
  14609. >m÷glicherweise</I
  14610. ></SPAN
  14611. > ein Semikolon
  14612.        (<VAR
  14613. CLASS="literal"
  14614. >;</VAR
  14615. >). Das bedeuted im Besonderen, dass der
  14616.        Bezeichner <SPAN
  14617. CLASS="emphasis"
  14618. ><I
  14619. CLASS="emphasis"
  14620. >nicht eingerⁿckt werden darf</I
  14621. ></SPAN
  14622. >
  14623.        und es dⁿrfen keine Leerzeichen oder Tabulatoren vor oder nach
  14624.        dem Semikolon stehen. Au▀erdem ist es wichtig, zu beachten,
  14625.        dass das erste Zeichen vor dem schlie▀enden Bezeichner ein der
  14626.        Definition Ihres Betriebssystems entsprechender Zeilenvorschub,
  14627.        sein muss. Das ist zum Beispiel auf einem Macintosh ein
  14628.        <VAR
  14629. CLASS="literal"
  14630. >\r</VAR
  14631. >.
  14632.       </P
  14633. ><P
  14634. >        Falls diese Regel gebrochen wird und der schlie▀ende Bezeichner
  14635.        nicht "sauber" ist, wird er nicht als schlie▀ender Bezeichner
  14636.        betrachtet und PHP wird weiter danach suchen. Wird in diesem
  14637.        Fall kein korrekter schlie▀ender Bezeichner gefunden, gibt es
  14638.        einen Parser-Fehler mit der Zeilennummer vom Ende des Skripts.
  14639.       </P
  14640. ></TD
  14641. ></TR
  14642. ></TABLE
  14643. ></DIV
  14644. ><P
  14645. >       Heredoc-Text funktioniert wie ein String innnerhalb doppelter
  14646.       Anfⁿhrungszeichen, nur ohne doppelte Anfⁿhrungszeichen.
  14647.       Anfⁿhrungszeichen innerhalb von heredoc-Texten mⁿssen also
  14648.       keiner Sonderbehandlung (escapen) unterzogen werden, aber Sie
  14649.       k÷nnen dennoch die oben aufgefⁿhrten Escape-Anweisungen
  14650.       verwenden. Variablen werden ausgewertet, aber besondere
  14651.       Aufmerksamkeit muss komplexen Variablen gewidmet werden, genau
  14652.       wie bei Strings.
  14653.       <TABLE
  14654. WIDTH="100%"
  14655. BORDER="0"
  14656. CELLPADDING="0"
  14657. CELLSPACING="0"
  14658. CLASS="EXAMPLE"
  14659. ><TR
  14660. ><TD
  14661. ><DIV
  14662. CLASS="example"
  14663. ><A
  14664. NAME="AEN2803"
  14665. ></A
  14666. ><P
  14667. ><B
  14668. >Beispiel 10-2. 
  14669.         Beispiel zur String-Festlegung per "heredoc"-Methode:
  14670.        </B
  14671. ></P
  14672. ><TABLE
  14673. BORDER="0"
  14674. BGCOLOR="#E0E0E0"
  14675. CELLPADDING="5"
  14676. ><TR
  14677. ><TD
  14678. ><PRE
  14679. CLASS="php"
  14680. ><?php
  14681. $str = <<<EOD
  14682. Beispiel eines Strings
  14683. ⁿber mehrere Script-Zeilen
  14684. durch Gebrauch der heredoc-Syntax.
  14685. EOD;
  14686.  
  14687. /* komplexeres Beispiel, mit Variablen */
  14688. class foo {
  14689.     var $foo;
  14690.     var $bar;
  14691.  
  14692.     function foo() {
  14693.         $this->foo = 'Foo';
  14694.         $this->bar = array('Bar1', 'Bar2', 'Bar3');
  14695.     }
  14696. }
  14697.  
  14698. $foo = new foo();
  14699. $name = 'Mein Name';
  14700.  
  14701. echo <<<EOT
  14702. Mein Name ist "$name". Ich schreibe einige $foo->foo.
  14703. Nun schreibe ich gerade einige {$foo->bar[1]}.
  14704. Dies sollte ein gro▀es 'A' schreiben: \x41
  14705. EOT;
  14706. ?></PRE
  14707. ></TD
  14708. ></TR
  14709. ></TABLE
  14710. ></DIV
  14711. ></TD
  14712. ></TR
  14713. ></TABLE
  14714. >
  14715.      </P
  14716. ><DIV
  14717. CLASS="note"
  14718. ><BLOCKQUOTE
  14719. CLASS="note"
  14720. ><P
  14721. ><B
  14722. >Anmerkung: </B
  14723. >
  14724.        Die heredoc Unterstⁿtzung wurde in PHP 4 eingefⁿhrt.
  14725.       </P
  14726. ></BLOCKQUOTE
  14727. ></DIV
  14728. ></DIV
  14729. ><DIV
  14730. CLASS="sect3"
  14731. ><HR><H4
  14732. CLASS="sect3"
  14733. ><A
  14734. NAME="language.types.string.parsing"
  14735. >Variablen-Analyse (parsing)</A
  14736. ></H4
  14737. ><P
  14738. >       Wird ein String in doppelten Anfⁿhrungszeichen oder mit heredoc
  14739.       angegeben, werden enthaltene <A
  14740. HREF="#language.variables"
  14741. >Variablen</A
  14742. > ausgewertet
  14743.       (geparst).
  14744.      </P
  14745. ><P
  14746. >       Es gibt zwei Syntax-Typen: eine <A
  14747. HREF="#language.types.string.parsing.simple"
  14748. >einfache</A
  14749. >
  14750.       und eine <A
  14751. HREF="#language.types.string.parsing.complex"
  14752. >komplexe</A
  14753. >.
  14754.       Die einfache Syntax ist die gelΣufigste und bequemste. Sie
  14755.       bietet die M÷glichkeit eine Variable, einen
  14756.       Array-Wert oder eine
  14757.       Objekt-Eigenschaft auszuwerten (parsen).
  14758.      </P
  14759. ><P
  14760. >       Die komplexe Syntax wurde in PHP 4 eingefⁿhrt und ist an den
  14761.       geschweiften Klammern <VAR
  14762. CLASS="literal"
  14763. >{}</VAR
  14764. >erkennbar, die den
  14765.       Ausdruck umschlie▀en.
  14766.      </P
  14767. ><DIV
  14768. CLASS="sect4"
  14769. ><HR><H5
  14770. CLASS="sect4"
  14771. ><A
  14772. NAME="language.types.string.parsing.simple"
  14773. >Einfache Syntax</A
  14774. ></H5
  14775. ><P
  14776. >        Sobald ein Dollarzeichen (<VAR
  14777. CLASS="literal"
  14778. >$</VAR
  14779. >) auftaucht, wird
  14780.        der Parser versuchen, gierig so viele Zeichen wie m÷glich zu
  14781.        bekommen, um einen gⁿltigen Variablennamen zu bilden.
  14782.        Schlie▀en Sie Ihren Varaiblennamen in geschweifte Klammern ein,
  14783.        wenn Sie ausdrⁿcklich das Ende des Namens angeben wollen.
  14784.       </P
  14785. ><DIV
  14786. CLASS="informalexample"
  14787. ><P
  14788. ></P
  14789. ><A
  14790. NAME="AEN2823"
  14791. ></A
  14792. ><TABLE
  14793. BORDER="0"
  14794. BGCOLOR="#E0E0E0"
  14795. CELLPADDING="5"
  14796. ><TR
  14797. ><TD
  14798. ><PRE
  14799. CLASS="php"
  14800. ><?php
  14801. $beer = 'Heineken';
  14802. echo "$beer's Geschmack ist gro▀artig";  // funktioniert, "'" ist kein gⁿltiges
  14803.                                          // Zeichen fⁿr einen Variablennamen
  14804. echo "Er hat einige $beers getrunken";   // funktioniert nicht, 's' ist ein gⁿltiges
  14805.                                          // Zeichen fⁿr einen Variablennamen
  14806. echo "Er hat einige ${beer}s getrunken"; // funktioniert
  14807. echo "Er hat einige {$beer}s getrunken"; // funktioniert
  14808. ?></PRE
  14809. ></TD
  14810. ></TR
  14811. ></TABLE
  14812. ><P
  14813. ></P
  14814. ></DIV
  14815. ><P
  14816. >        Auf Σhnliche Weise k÷nnen Sie erreichen, dass ein
  14817.        Array-Index oder eine
  14818.        Objekt-Eigenschaft ausgewertet wird. Bei
  14819.        Array-Indizes markiert die schlie▀ende eckige Klammer
  14820.        (<VAR
  14821. CLASS="literal"
  14822. >]</VAR
  14823. >) das Ende des Index. Fⁿr
  14824.        Objekt-Eigenschaften gelten die gleichen Regeln wie bei
  14825.        einfachen Variablen, obwohl es bei Objekt-Eigenschaften keinen
  14826.        Trick gibt, wie dies bei Variablen der Fall ist.
  14827.       </P
  14828. ><DIV
  14829. CLASS="informalexample"
  14830. ><P
  14831. ></P
  14832. ><A
  14833. NAME="AEN2829"
  14834. ></A
  14835. ><TABLE
  14836. BORDER="0"
  14837. BGCOLOR="#E0E0E0"
  14838. CELLPADDING="5"
  14839. ><TR
  14840. ><TD
  14841. ><PRE
  14842. CLASS="php"
  14843. ><?php
  14844. // Diese Beispiele sind spezifisch fⁿr die Verwendung von Arrays
  14845. // innerhalb von Strings. Setzen sie die String-Schlⁿssel Ihrer Arrays
  14846. // au▀erhalb von Strings immer in Anfⁿhrungszeichen und verwenden Sie
  14847. // au▀erhalb von Strings auch keine {geschweiften Klammern}.
  14848.  
  14849. // Wir lassen uns alle Fehlermeldungen anzeigen
  14850. error_reporting(E_ALL);
  14851.  
  14852. $frⁿchte = array('Erdbeere' => 'rot' , 'Banane' => 'gelb');
  14853.  
  14854. // Funktioniert aber beachten Sie: au▀erhalb von
  14855. // String-Anfⁿhrungszeichen funktioniert das anders
  14856. echo "Eine Banane ist $frⁿchte[Banane].";
  14857.  
  14858. // Funktioniert
  14859. echo "Eine Banane ist {$frⁿchte['Banane']}.";
  14860.  
  14861. // Funktioniert, aber PHP sucht, wie unten beschrieben, zuerst nach
  14862. // einer Konstanten namens Banane.
  14863. echo "Eine Banane ist {$frⁿchte[Banane]}.";
  14864.  
  14865. // Funktioniert nicht; verwenden Sie geschweifte Klammern. Das
  14866. // erzeugt einen Parser-Fehler.
  14867. echo "Eine Banane ist $frⁿchte['Banane'].";
  14868.  
  14869. // Funktioniert
  14870. echo "Eine Banane ist " . $frⁿchte['Banane'] . ".";
  14871.  
  14872. // Funktioniert
  14873. echo "Dieses Quadrat ist $quadrat->breite Meter breit.";
  14874.  
  14875. // Funktioniert nicht. Fⁿr eine L÷sung siehe die komplexe Syntax.
  14876. echo "Dieses Quadrat ist $quadrat->breite00 Zentimeter breit.";
  14877. ?></PRE
  14878. ></TD
  14879. ></TR
  14880. ></TABLE
  14881. ><P
  14882. ></P
  14883. ></DIV
  14884. ><P
  14885. >        Fⁿr irgendetwas Komplexeres sollten Sie die komplexe Syntax
  14886.        nutzen.
  14887.       </P
  14888. ></DIV
  14889. ><DIV
  14890. CLASS="sect4"
  14891. ><HR><H5
  14892. CLASS="sect4"
  14893. ><A
  14894. NAME="language.types.string.parsing.complex"
  14895. >Komplexe (geschweifte) Syntax</A
  14896. ></H5
  14897. ><P
  14898. >        Diese wird nicht komplex genannt, weil etwa die Syntax komplex
  14899.        ist, sondern weil Sie auf diesem Weg komplexe Ausdrⁿcke
  14900.        einbeziehen k÷nnen.
  14901.       </P
  14902. ><P
  14903. >        TatsΣchlich k÷nnen Sie jeden beliebigen Wert einbeziehen, der
  14904.        im Namensbereich in Strings gⁿltig ist. Schreiben Sie den
  14905.        Ausdruck einfach auf die gleiche Art und Weise, wie au▀erhalb
  14906.        des Strings, und umschlie▀en diesen mit { und }. Da Sie '{'
  14907.        nicht escapen k÷nnen, wird diese Syntax nur erkannt, wenn auf {
  14908.        unmittelbar $ folgt.  (Benutzen Sie "{\$" oder "\{$" um ein
  14909.        w÷rtliches "{$" zu erhalten.) Einige Beispiele, um dies zu
  14910.        verdeutlichen:
  14911.       </P
  14912. ><DIV
  14913. CLASS="informalexample"
  14914. ><P
  14915. ></P
  14916. ><A
  14917. NAME="AEN2836"
  14918. ></A
  14919. ><TABLE
  14920. BORDER="0"
  14921. BGCOLOR="#E0E0E0"
  14922. CELLPADDING="5"
  14923. ><TR
  14924. ><TD
  14925. ><PRE
  14926. CLASS="php"
  14927. ><?php
  14928. // Wir lassen uns alle Fehlermeldungen anzeigen
  14929. error_reporting(E_ALL);
  14930.  
  14931. $great = 'fantastisch';
  14932.  
  14933. // Funktioniert nicht, Ausgabe: Das ist { fantastisch}
  14934. echo "Das ist { $great}";
  14935.  
  14936. // Funktioniert, Ausgabe: Das ist fantastisch
  14937. echo "Das ist {$great}";
  14938. echo "Das ist ${great}";
  14939.  
  14940. // Funktioniert
  14941. echo "Dieses Quadrat ist {$square->width}00 Zentimeter breit.";
  14942.  
  14943. // Funktioniert
  14944. echo "Das funktioniert: {$arr[4][3]}";
  14945.  
  14946. // Das ist aus dem gleichen Grund falsch
  14947. // wie $foo[bar] au▀erhalb eines Strings falsch ist. Mit
  14948. // anderen Worten, es funktioniert zwar, aber weil PHP
  14949. // zunΣchst nach einer Konstanten namens foo sucht, gibt
  14950. // es einen Fehler der Stufe E_NOTICE (undefined constant)
  14951. // aus.
  14952. echo "Das ist falsch: {$arr[foo][3]}";
  14953.  
  14954. // Funktioniert. Benutzen Sie bei der Verwendung
  14955. // mehrdimensionaler Arrays innerhalb von Strings immer
  14956. // Klammern um die Arrays.
  14957. echo "Das funktioniert: {$arr['foo'][3]}";
  14958.  
  14959. // Funktioniert
  14960. echo "Das funktioniert: " . $arr['foo'][3];
  14961.  
  14962. echo "Sie k÷nnen sogar schreiben {$obj->values[3]->name}";
  14963.  
  14964. echo "Das ist der Wert der Variable mit Namen $name: {${$name}}";
  14965. ?></PRE
  14966. ></TD
  14967. ></TR
  14968. ></TABLE
  14969. ><P
  14970. ></P
  14971. ></DIV
  14972. ></DIV
  14973. ></DIV
  14974. ><DIV
  14975. CLASS="sect3"
  14976. ><HR><H4
  14977. CLASS="sect3"
  14978. ><A
  14979. NAME="language.types.string.substr"
  14980. >Zugriff und Modifikation von Zeichen in Strings</A
  14981. ></H4
  14982. ><P
  14983. >       Innerhalb von Zeichenketten (strings) kann durch die Angabe des
  14984.       nullbasierten Offsets in geschweiften Klammern nach dem String auf das
  14985.       gewⁿnschte Zeichen zugegriffen oder dieses modifiziert werden.
  14986.      </P
  14987. ><DIV
  14988. CLASS="note"
  14989. ><BLOCKQUOTE
  14990. CLASS="note"
  14991. ><P
  14992. ><B
  14993. >Anmerkung: </B
  14994. >
  14995.        Fⁿr AbwΣrtskompatibilitΣt k÷nnen Sie fⁿr den selben Zweck immer
  14996.        noch die Array-Klammern verwenden. Diese Syntax wird jedoch
  14997.        seit PHP 4 missbilligt.
  14998.       </P
  14999. ></BLOCKQUOTE
  15000. ></DIV
  15001. ><P
  15002. >       <TABLE
  15003. WIDTH="100%"
  15004. BORDER="0"
  15005. CELLPADDING="0"
  15006. CELLSPACING="0"
  15007. CLASS="EXAMPLE"
  15008. ><TR
  15009. ><TD
  15010. ><DIV
  15011. CLASS="example"
  15012. ><A
  15013. NAME="AEN2844"
  15014. ></A
  15015. ><P
  15016. ><B
  15017. >Beispiel 10-3. Einige String-Beispiele</B
  15018. ></P
  15019. ><TABLE
  15020. BORDER="0"
  15021. BGCOLOR="#E0E0E0"
  15022. CELLPADDING="5"
  15023. ><TR
  15024. ><TD
  15025. ><PRE
  15026. CLASS="php"
  15027. ><?php
  15028. // Das erste Zeichen eines Strings.
  15029. $str = 'Das ist ein Test.'
  15030. $erstes = $str{0};                // $erstes enthΣlt "D"
  15031.  
  15032. // Das dritte Zeichen eines Strings.
  15033. $drittes = $str{2};
  15034.  
  15035. // Das letzte Zeichen eines Strings.
  15036. $str = 'Das ist immer noch ein Test.'
  15037. $letztes = $str{strlen($str)-1};    // $letztes enthΣlt "."
  15038.  
  15039. // Das letzte Zeichen eines Strings verΣndern
  15040.       $str = 'Schau auf die Stra▀i';
  15041.       $str{strlen($str)-1} = 'e';
  15042.  
  15043. ?></PRE
  15044. ></TD
  15045. ></TR
  15046. ></TABLE
  15047. ></DIV
  15048. ></TD
  15049. ></TR
  15050. ></TABLE
  15051. >
  15052.      </P
  15053. ></DIV
  15054. ></DIV
  15055. ><DIV
  15056. CLASS="sect2"
  15057. ><HR><H3
  15058. CLASS="sect2"
  15059. ><A
  15060. NAME="language.types.string.useful-funcs"
  15061. >Nⁿtzliche Funktionen und Operatoren</A
  15062. ></H3
  15063. ><P
  15064. >      Strings k÷nnen mittels des '.'(dot)-Operators miteinander
  15065.      verbunden werden. Beachten Sie, dass dafⁿr nicht der '+'
  15066.      (Additions)-Operator verwendet werden kann. Fⁿr mehr
  15067.      Informationen schauen Sie bitte unter den <A
  15068. HREF="#language.operators.string"
  15069. >Zeichenketten-Operatoren</A
  15070. >
  15071.      nach.
  15072.     </P
  15073. ><P
  15074. >      Es gibt eine Menge nⁿtzlicher Funktionen zur String-Manipulation.
  15075.     </P
  15076. ><P
  15077. >      Fⁿr allgemeine Funktionen schauen Sie sich den Abschnitt ⁿber
  15078.      <A
  15079. HREF="#ref.strings"
  15080. >String Funktionen</A
  15081. > an, und fⁿr
  15082.      fortgeschrittenes Suchen & Ersetzen die Funktionen zu
  15083.      RegulΣren Ausdrⁿcken (in zwei Ausfⁿhrungen: <A
  15084. HREF="#ref.pcre"
  15085. >Perl Kompatibel</A
  15086. > und <A
  15087. HREF="#ref.regex"
  15088. >POSIX erweitert</A
  15089. >).
  15090.     </P
  15091. ><P
  15092. >      Weiterhin gibt es auch noch <A
  15093. HREF="#ref.url"
  15094. >Funktionen
  15095.      fⁿr URL-Strings</A
  15096. >, und Funktionen zum
  15097.      Verschlⁿsseln/Entschlⁿsseln von Strings (<A
  15098. HREF="#ref.mcrypt"
  15099. >mcrypt</A
  15100. > und <A
  15101. HREF="#ref.mhash"
  15102. >mhash</A
  15103. >).
  15104.     </P
  15105. ><P
  15106. >      Schlie▀lich, falls Sie immer noch nicht das gefunden haben wonach
  15107.      Sie suchen, schauen Sie unter den <A
  15108. HREF="#ref.ctype"
  15109. >Zeichen-Typen Funktionen</A
  15110. > nach.
  15111.     </P
  15112. ></DIV
  15113. ><DIV
  15114. CLASS="sect2"
  15115. ><HR><H3
  15116. CLASS="sect2"
  15117. ><A
  15118. NAME="language.types.string.casting"
  15119. >Umwandlung nach string</A
  15120. ></H3
  15121. ><P
  15122. >      Sie k÷nnen einen Wert mit der
  15123.      <VAR
  15124. CLASS="literal"
  15125. >(string)</VAR
  15126. >-Umwandlung oder mit der Funktion
  15127.      <A
  15128. HREF="#function.strval"
  15129. ><B
  15130. CLASS="function"
  15131. >strval()</B
  15132. ></A
  15133. > in einen String umwandeln. Die
  15134.      Umwandlung in einen String wird im dem Bereich eines Ausdrucks,
  15135.      in dem ein String ben÷tigt wird, automatisch fⁿr Sie vorgenommen.
  15136.      Dies geschieht, wenn Sie die Funktionen <A
  15137. HREF="#function.echo"
  15138. ><B
  15139. CLASS="function"
  15140. >echo()</B
  15141. ></A
  15142. >
  15143.      oder <A
  15144. HREF="#function.print"
  15145. ><B
  15146. CLASS="function"
  15147. >print()</B
  15148. ></A
  15149. > benutzen oder wenn Sie den Wert
  15150.      einer Variablen mit einem String vergleichen. Die Abschnitte ⁿber
  15151.      <A
  15152. HREF="#language.types"
  15153. >Typen</A
  15154. > und <A
  15155. HREF="#language.types.type-juggling"
  15156. >Typen-Tricks</A
  15157. >
  15158.      verdeutlichen das folgende. Siehe auch
  15159.      <A
  15160. HREF="#function.settype"
  15161. ><B
  15162. CLASS="function"
  15163. >settype()</B
  15164. ></A
  15165. >.
  15166.     </P
  15167. ><P
  15168. >      Ein Boolean <TT
  15169. CLASS="constant"
  15170. ><B
  15171. >TRUE</B
  15172. ></TT
  15173. >-Wert wird in den String
  15174.      <VAR
  15175. CLASS="literal"
  15176. >"1"</VAR
  15177. > umgewandelt, der <TT
  15178. CLASS="constant"
  15179. ><B
  15180. >FALSE</B
  15181. ></TT
  15182. >-Wert wird als
  15183.      <VAR
  15184. CLASS="literal"
  15185. >""</VAR
  15186. > (leerer String) dargestellt. Dadurch k÷nnen
  15187.      Sie Boolean- und String-Werte ineinander umwandeln.
  15188.     </P
  15189. ><P
  15190. >      Ein Integer oder eine Flie▀kommazahl
  15191.      (Float) wird in einen String umgewandelt, der die
  15192.      Zahl durch seine Ziffern darstellt (bei Flie▀kommazahlen
  15193.      inklusive Exponententeil).
  15194.     </P
  15195. ><P
  15196. >      Arrays werden immer in den String <VAR
  15197. CLASS="literal"
  15198. >"Array"</VAR
  15199. >
  15200.      umgewandelt. Sie k÷nnen also den Inhalt eines Arrays
  15201.      nicht mit <A
  15202. HREF="#function.echo"
  15203. ><B
  15204. CLASS="function"
  15205. >echo()</B
  15206. ></A
  15207. > oder
  15208.      <A
  15209. HREF="#function.print"
  15210. ><B
  15211. CLASS="function"
  15212. >print()</B
  15213. ></A
  15214. > ausgeben, um zu sehen, was es enthΣlt.
  15215.      Um ein Element anzuschauen, ben÷tigen Sie etwas in der Art
  15216.      <VAR
  15217. CLASS="literal"
  15218. >echo $arr['foo']</VAR
  15219. >. Siehe weiter unten fⁿr
  15220.      Hinweise zur Ausgabe/Ansicht des kompletten Inhalts.
  15221.     </P
  15222. ><P
  15223. >      Objekte werden immer in den String <VAR
  15224. CLASS="literal"
  15225. >"Object"</VAR
  15226. >
  15227.      umgewandelt. Wenn Sie fⁿr die Fehlersuche die Werte der
  15228.      Mitgliedsvariablen eines Objekts ausgeben m÷chten,
  15229.      lesen Sie bitte die Abschnitte weiter unten. Benutzen Sie
  15230.      <A
  15231. HREF="#function.get-class"
  15232. ><B
  15233. CLASS="function"
  15234. >get_class()</B
  15235. ></A
  15236. >, wenn Sie den Namen der Klasse
  15237.      erfahren m÷chten, von der ein Objekt eine Instanz ist.
  15238.     </P
  15239. ><P
  15240. >      Ressourcen werden immer in Strings mit der Struktur
  15241.      <VAR
  15242. CLASS="literal"
  15243. >"Resource id #1"</VAR
  15244. > umgewandelt, wobei
  15245.      <VAR
  15246. CLASS="literal"
  15247. >1</VAR
  15248. > die eindeutige Nummer ist, die der
  15249.      Resource von PHP zur Laufzeit zugeordnet wurde.
  15250.      Benutzen Sie <A
  15251. HREF="#function.get-resource-type"
  15252. ><B
  15253. CLASS="function"
  15254. >get_resource_type()</B
  15255. ></A
  15256. >, wenn Sie
  15257.      wissen m÷chten, welchen Typs die Ressource ist.
  15258.     </P
  15259. ><P
  15260. >      <TT
  15261. CLASS="constant"
  15262. ><B
  15263. >NULL</B
  15264. ></TT
  15265. > wird immer in einen leeren String umgewandelt.
  15266.     </P
  15267. ><P
  15268. >      Wie Sie oben erfahren haben, liefert Ihnen die Ausgabe von
  15269.      Arrays, Objekten oder Ressourcen keine brauchbaren Informationen
  15270.      ⁿber die Werte selbst. Schauen Sie sich fⁿr eine bessere
  15271.      M÷glichkeit, sich Werte fⁿr die Fehlersuche ausgeben zu lassen,
  15272.      die Funktionen <A
  15273. HREF="#function.print-r"
  15274. ><B
  15275. CLASS="function"
  15276. >print_r()</B
  15277. ></A
  15278. > und
  15279.      <A
  15280. HREF="#function.var-dump"
  15281. ><B
  15282. CLASS="function"
  15283. >var_dump()</B
  15284. ></A
  15285. > an.
  15286.     </P
  15287. ><P
  15288. >      Sie k÷nnen PHP-Werte auch in Strings umwandeln, um sie dauerhaft
  15289.      zu speichern. Diese Methode wird als Serialisierung bezeichnet
  15290.      und kann mit der Funktion <A
  15291. HREF="#function.serialize"
  15292. ><B
  15293. CLASS="function"
  15294. >serialize()</B
  15295. ></A
  15296. >
  15297.      vorgenommen werden. Falls Ihr PHP ⁿber <A
  15298. HREF="#ref.wddx"
  15299. >WDDX</A
  15300. >-Unterstⁿtzung verfⁿgt, k÷nnen Sie
  15301.      PHP-Werte auch in XML-Strukturen serialisieren.
  15302.     </P
  15303. ></DIV
  15304. ><DIV
  15305. CLASS="sect2"
  15306. ><HR><H3
  15307. CLASS="sect2"
  15308. ><A
  15309. NAME="language.types.string.conversion"
  15310. >Umwandlung von Strings in Zahlen</A
  15311. ></H3
  15312. ><P
  15313. >      Sobald ein String als numerischer Wert ausgewertet wird, werden
  15314.      der resultierende Wert und der Typ wie folgt festgelegt.
  15315.     </P
  15316. ><P
  15317. >      Der String wird als <A
  15318. HREF="#language.types.float"
  15319. ><B
  15320. CLASS="type"
  15321. >float</B
  15322. ></A
  15323. > ausgewertet, wenn er eines
  15324.      der Zeichen '.', 'e' oder 'E' enthΣlt. Ansonsten wird er als
  15325.      Integer-Wert interpretiert.
  15326.     </P
  15327. ><P
  15328. >      Der Wert wird durch den Anfangsteil des Strings bestimmt.  Sofern
  15329.      der String mit gⁿltigen numerischen Daten beginnt, werden diese
  15330.      als Wert benutzt. Andernfalls wird der Wert 0 (Null) sein.
  15331.      Gⁿltige numerische Daten sind ein optionales Vorzeichen, gefolgt
  15332.      von einer oder mehreren Zahlen (optional mit einem Dezimalpunkt).
  15333.      Wahlweise kann auch ein Exponent angegeben werden. Der Exponent
  15334.      besteht aus einem 'e' oder 'E', gefolgt von einer oder mehreren
  15335.      Zahlen.
  15336.     </P
  15337. ><DIV
  15338. CLASS="informalexample"
  15339. ><P
  15340. ></P
  15341. ><A
  15342. NAME="AEN2910"
  15343. ></A
  15344. ><TABLE
  15345. BORDER="0"
  15346. BGCOLOR="#E0E0E0"
  15347. CELLPADDING="5"
  15348. ><TR
  15349. ><TD
  15350. ><PRE
  15351. CLASS="php"
  15352. ><?php
  15353. $foo = 1 + "10.5";               // $foo ist float   (11.5)
  15354. $foo = 1 + "-1.3e3";             // $foo ist float   (-1299)
  15355. $foo = 1 + "bob-1.3e3";          // $foo ist integer (1)
  15356. $foo = 1 + "bob3";               // $foo ist integer (1)
  15357. $foo = 1 + "10 Kleine Schweine"; // $foo ist integer (11)
  15358. $foo = 4 + "10.2 Ferkel";        // $foo ist float   (14.2)
  15359. $foo = "10 Schweine " + 1;       // $foo ist integer (11)
  15360. $foo = "10.0 Schweine " + 1;     // $foo ist float   (11)
  15361. $foo = "10.0 Schweine " + 1.0;   // $foo ist float (11)
  15362. ?></PRE
  15363. ></TD
  15364. ></TR
  15365. ></TABLE
  15366. ><P
  15367. ></P
  15368. ></DIV
  15369. ><P
  15370. >      Weitere Informationen ⁿber solche Umwandlungen finden Sie in den
  15371.      UNIX Manualseiten unter strtod(3).
  15372.     </P
  15373. ><P
  15374. >      Wenn Sie irgendein Beispiel dieses Abschnitts testen wollen,
  15375.      k÷nnen Sie dieses per "Copy und Paste" ⁿbernehmen. Fⁿgen Sie die
  15376.      folgende Zeile Ihrem Skript hinzu und Sie sehen selbst was
  15377.      passiert:
  15378.      <DIV
  15379. CLASS="informalexample"
  15380. ><P
  15381. ></P
  15382. ><A
  15383. NAME="AEN2914"
  15384. ></A
  15385. ><TABLE
  15386. BORDER="0"
  15387. BGCOLOR="#E0E0E0"
  15388. CELLPADDING="5"
  15389. ><TR
  15390. ><TD
  15391. ><PRE
  15392. CLASS="php"
  15393. ><?php
  15394. echo "\$foo==$foo; Typ ist " . gettype ($foo) . "<br />\n";
  15395. ?></PRE
  15396. ></TD
  15397. ></TR
  15398. ></TABLE
  15399. ><P
  15400. ></P
  15401. ></DIV
  15402. >
  15403.     </P
  15404. ><P
  15405. >      Erwarten Sie nicht, den Code eines Zeichens zu bekommen, indem
  15406.      Sie es in einen Integer umwandeln (wie das z.B. in C der Fall
  15407.      wΣre). Benutzen Sie die Funktionen <A
  15408. HREF="#function.ord"
  15409. ><B
  15410. CLASS="function"
  15411. >ord()</B
  15412. ></A
  15413. > und
  15414.      <A
  15415. HREF="#function.chr"
  15416. ><B
  15417. CLASS="function"
  15418. >chr()</B
  15419. ></A
  15420. >, um Zeichencodes und Zeichen ineinander
  15421.      umzuwandeln.
  15422.     </P
  15423. ></DIV
  15424. ></DIV
  15425. ><DIV
  15426. CLASS="sect1"
  15427. ><HR><H2
  15428. CLASS="sect1"
  15429. ><A
  15430. NAME="language.types.array"
  15431. >Arrays</A
  15432. ></H2
  15433. ><P
  15434. >     Ein Array in PHP ist eigentlich eine geordnete Abbildung. Eine
  15435.     Abbildung ist ein Typ der <SPAN
  15436. CLASS="emphasis"
  15437. ><I
  15438. CLASS="emphasis"
  15439. >Werte</I
  15440. ></SPAN
  15441. > auf
  15442.     <SPAN
  15443. CLASS="emphasis"
  15444. ><I
  15445. CLASS="emphasis"
  15446. >Schlⁿssel</I
  15447. ></SPAN
  15448. > abbildet. Dieser Typ ist auf
  15449.     mehrere Arten optimiert, so dass Sie ihn auf verschiedene Weise
  15450.     benutzen k÷nnen: als reales Array, als Liste (Vektor), als
  15451.     Hash-Tabelle (das ist eine praktische Anwendung einer Abbildung),
  15452.     als Verzeichnis, als Sammlung, als Stapel (Stack), als
  15453.     Warteschlange (Queue) und m÷glicherweise mehr. Da Sie ein weiteres
  15454.     PHP-Array als Wert benutzen k÷nnen, ist es ziemlich einfach
  15455.     m÷glich Baumstrukturen zu simulieren.
  15456.    </P
  15457. ><P
  15458. >     Die ErklΣrung dieser Datenstrukturen sprengt den Rahmen dieses
  15459.     Handbuchs, aber Sie finden zumindest ein Beispiel fⁿr jede dieser
  15460.     Strukturen. Fⁿr weitergehende Informationen verweisen wir auf
  15461.     externe Literatur zu diesem breit gefΣcherten Thema.
  15462.    </P
  15463. ><DIV
  15464. CLASS="sect2"
  15465. ><HR><H3
  15466. CLASS="sect2"
  15467. ><A
  15468. NAME="language.types.array.syntax"
  15469. >Syntax</A
  15470. ></H3
  15471. ><DIV
  15472. CLASS="sect3"
  15473. ><H4
  15474. CLASS="sect3"
  15475. ><A
  15476. NAME="language.types.array.syntax.array-func"
  15477. >Angabe mit <A
  15478. HREF="#function.array"
  15479. ><B
  15480. CLASS="function"
  15481. >array()</B
  15482. ></A
  15483. ></A
  15484. ></H4
  15485. ><P
  15486. >       Ein <A
  15487. HREF="#language.types.array"
  15488. ><B
  15489. CLASS="type"
  15490. >array</B
  15491. ></A
  15492. > kann mit Hilfe des Sparchkonstrukts
  15493.       <A
  15494. HREF="#function.array"
  15495. ><B
  15496. CLASS="function"
  15497. >array()</B
  15498. ></A
  15499. > erzeugt werden. Es ben÷tigt eine
  15500.       bestimmte Anzahl von Komma-getrennten
  15501.       <VAR
  15502. CLASS="literal"
  15503. ><VAR
  15504. CLASS="replaceable"
  15505. >Schlⁿssel</VAR
  15506. > =>
  15507.       <VAR
  15508. CLASS="replaceable"
  15509. >Wert</VAR
  15510. ></VAR
  15511. > Paaren.
  15512.      </P
  15513. ><P
  15514. >       <TABLE
  15515. BORDER="0"
  15516. BGCOLOR="#E0E0E0"
  15517. CELLPADDING="5"
  15518. ><TR
  15519. ><TD
  15520. ><PRE
  15521. CLASS="synopsis"
  15522. >array( [<VAR
  15523. CLASS="replaceable"
  15524. >Schlⁿssel</VAR
  15525. > =>] <VAR
  15526. CLASS="replaceable"
  15527. >Wert</VAR
  15528. >
  15529.      , ...
  15530.      )
  15531. // <VAR
  15532. CLASS="replaceable"
  15533. >Schlⁿssel</VAR
  15534. > kann ein Integer oder String sein
  15535. // <VAR
  15536. CLASS="replaceable"
  15537. >Wert</VAR
  15538. > kann irgendetwas sein</PRE
  15539. ></TD
  15540. ></TR
  15541. ></TABLE
  15542. >
  15543.      </P
  15544. ><P
  15545. >       <DIV
  15546. CLASS="informalexample"
  15547. ><P
  15548. ></P
  15549. ><A
  15550. NAME="AEN2946"
  15551. ></A
  15552. ><TABLE
  15553. BORDER="0"
  15554. BGCOLOR="#E0E0E0"
  15555. CELLPADDING="5"
  15556. ><TR
  15557. ><TD
  15558. ><PRE
  15559. CLASS="php"
  15560. ><?php
  15561. $arr = array("foo" => "bar", 12 => true);
  15562.  
  15563. echo $arr["foo"]; // bar
  15564. echo $arr[12];    // 1
  15565. ?></PRE
  15566. ></TD
  15567. ></TR
  15568. ></TABLE
  15569. ><P
  15570. ></P
  15571. ></DIV
  15572. >
  15573.      </P
  15574. ><P
  15575. >       Ein <VAR
  15576. CLASS="varname"
  15577. >Schlⁿssel</VAR
  15578. > kann entweder ein
  15579.       <VAR
  15580. CLASS="literal"
  15581. >integer</VAR
  15582. > oder ein <A
  15583. HREF="#language.types.string"
  15584. ><B
  15585. CLASS="type"
  15586. >string</B
  15587. ></A
  15588. > sein.
  15589.       Wenn ein Schlⁿssel die Standard-Darstellung einer
  15590.       <A
  15591. HREF="#language.types.integer"
  15592. ><B
  15593. CLASS="type"
  15594. >integer</B
  15595. ></A
  15596. > Zahl ist, wird es als solche interpretiert
  15597.       werden, (z.B. <VAR
  15598. CLASS="literal"
  15599. >"8"</VAR
  15600. > wird als
  15601.       <VAR
  15602. CLASS="literal"
  15603. >8</VAR
  15604. > interpretiert, wΣhrend
  15605.       <VAR
  15606. CLASS="literal"
  15607. >"08"</VAR
  15608. > als <VAR
  15609. CLASS="literal"
  15610. >"08"</VAR
  15611. >
  15612.       interpretiert werden wird). Es gibt in PHP keine
  15613.       unterschiedlichen Typen indizierter oder assoziativer Arrays.
  15614.       Es gibt nur einen Array-Typ, der sowohl Integer- als auch
  15615.       String-Indizes enthalten kann.
  15616.      </P
  15617. ><P
  15618. >       Ein Wert kann jeder PHP-Typ sein.
  15619.       <DIV
  15620. CLASS="informalexample"
  15621. ><P
  15622. ></P
  15623. ><A
  15624. NAME="AEN2958"
  15625. ></A
  15626. ><TABLE
  15627. BORDER="0"
  15628. BGCOLOR="#E0E0E0"
  15629. CELLPADDING="5"
  15630. ><TR
  15631. ><TD
  15632. ><PRE
  15633. CLASS="php"
  15634. ><?php
  15635. $arr = array("einarray" => array(6 => 5, 13 => 9, "a" => 42));
  15636.  
  15637. echo $arr["einarray"][6];    // 5
  15638. echo $arr["einarray"][13];   // 9
  15639. echo $arr["einarray"]["a"];  // 42
  15640. ?></PRE
  15641. ></TD
  15642. ></TR
  15643. ></TABLE
  15644. ><P
  15645. ></P
  15646. ></DIV
  15647. >
  15648.      </P
  15649. ><P
  15650. >       Falls Sie fⁿr einen Wert keinen Schlⁿssel angeben, wird der
  15651.       gr÷▀te der Ganzzahl-Indizes genommen und der neue Schlⁿssel wird
  15652.       dieses Maximum + 1 sein. Falls Sie einen Schlⁿssel angeben dem
  15653.       schon ein Wert zugeordnet wurde, wird dieser Wert ⁿberschrieben.
  15654.       <DIV
  15655. CLASS="informalexample"
  15656. ><P
  15657. ></P
  15658. ><A
  15659. NAME="AEN2961"
  15660. ></A
  15661. ><TABLE
  15662. BORDER="0"
  15663. BGCOLOR="#E0E0E0"
  15664. CELLPADDING="5"
  15665. ><TR
  15666. ><TD
  15667. ><PRE
  15668. CLASS="php"
  15669. ><?php
  15670. // Dieses Array ist dasselbe wie ...
  15671. array(5 => 43, 32, 56, "b" => 12);
  15672.  
  15673. // ... dieses Array
  15674. array(5 => 43, 6 => 32, 7 => 56, "b" => 12);
  15675. ?></PRE
  15676. ></TD
  15677. ></TR
  15678. ></TABLE
  15679. ><P
  15680. ></P
  15681. ></DIV
  15682. >
  15683.      </P
  15684. ><DIV
  15685. CLASS="warning"
  15686. ><P
  15687. ></P
  15688. ><TABLE
  15689. CLASS="warning"
  15690. BORDER="1"
  15691. WIDTH="100%"
  15692. ><TR
  15693. ><TD
  15694. ALIGN="CENTER"
  15695. ><B
  15696. >Warnung</B
  15697. ></TD
  15698. ></TR
  15699. ><TR
  15700. ><TD
  15701. ALIGN="LEFT"
  15702. ><P
  15703. >        Ab PHP 4.3.0 hat sich die oben beschriebene Generierung von
  15704.        Indizes geΣndert. Wenn Sie etwas an ein Array anhΣngen, in dem
  15705.        der gr÷▀te Schlⁿssel negativ ist, wird der nΣchste Schlⁿssel
  15706.        jetzt Null (<VAR
  15707. CLASS="literal"
  15708. >0</VAR
  15709. >) sein. Davor wΣre der neue
  15710.        Index, genauso wie bei positiven Indizes, der gr÷▀te vorhandene
  15711.        Schlⁿssel + 1 gewesen.
  15712.       </P
  15713. ></TD
  15714. ></TR
  15715. ></TABLE
  15716. ></DIV
  15717. ><P
  15718. >       Wenn Sie <TT
  15719. CLASS="constant"
  15720. ><B
  15721. >TRUE</B
  15722. ></TT
  15723. > als Schlⁿssel benutzen, wird dies als Schlⁿssel
  15724.       vom Typ <A
  15725. HREF="#language.types.integer"
  15726. ><B
  15727. CLASS="type"
  15728. >integer</B
  15729. ></A
  15730. > <VAR
  15731. CLASS="literal"
  15732. >1</VAR
  15733. > ausgewertet.
  15734.       Benutzen Sie <TT
  15735. CLASS="constant"
  15736. ><B
  15737. >FALSE</B
  15738. ></TT
  15739. > als Schlⁿssel, wird dies als Schlⁿssel vom
  15740.       Typ <A
  15741. HREF="#language.types.integer"
  15742. ><B
  15743. CLASS="type"
  15744. >integer</B
  15745. ></A
  15746. > <VAR
  15747. CLASS="literal"
  15748. >0</VAR
  15749. > ausgewertet. Die
  15750.       Benutzung von <VAR
  15751. CLASS="literal"
  15752. >NULL</VAR
  15753. > als Schlⁿssel fⁿhrt dazu,
  15754.       dass der Schlⁿssel als leerer String gewertet wird.  Verwenden
  15755.       Sie einen leeren String als Schlⁿssel, wird ein Schlⁿssel mit
  15756.       einem leeren String und seinem Wert erzeugt (oder
  15757.       ⁿberschrieben).  Das entspricht nicht der Verwendung von leeren
  15758.       Klammern.
  15759.      </P
  15760. ><P
  15761. >       Sie k÷nnen keine Arrays oder Objekte als Schlⁿssel benutzen.
  15762.       Der Versuch wird mit einer Warnung enden: <VAR
  15763. CLASS="literal"
  15764. >Illegal
  15765.       offset type</VAR
  15766. >.
  15767.      </P
  15768. ></DIV
  15769. ><DIV
  15770. CLASS="sect3"
  15771. ><HR><H4
  15772. CLASS="sect3"
  15773. ><A
  15774. NAME="language.types.array.syntax.modifying"
  15775. >Erzeugen / VerΣndern mit der eckigen Klammer-Syntax</A
  15776. ></H4
  15777. ><P
  15778. >       Sie k÷nnen ein bestehendes Array durch explizites Zuweisen von
  15779.       Werten verΣndern.
  15780.      </P
  15781. ><P
  15782. >       Weisen Sie dem Array Werte zu indem Sie den Schlⁿssel in eckigen
  15783.       Klammern angeben. Sie k÷nnen den Schlⁿssel auch weglassen. In
  15784.       diesem Fall schreiben Sie einfach ein leeres Klammerpaar
  15785.       ("<VAR
  15786. CLASS="literal"
  15787. >[]</VAR
  15788. >") hinter den Variablennamen.
  15789.       <TABLE
  15790. BORDER="0"
  15791. BGCOLOR="#E0E0E0"
  15792. CELLPADDING="5"
  15793. ><TR
  15794. ><TD
  15795. ><PRE
  15796. CLASS="synopsis"
  15797. >$arr[<VAR
  15798. CLASS="replaceable"
  15799. >Schlⁿssel</VAR
  15800. >] = <VAR
  15801. CLASS="replaceable"
  15802. >Wert</VAR
  15803. >;
  15804. $arr[] = <VAR
  15805. CLASS="replaceable"
  15806. >Wert</VAR
  15807. >;
  15808. // <VAR
  15809. CLASS="replaceable"
  15810. >Schlⁿssel</VAR
  15811. > kann ein <A
  15812. HREF="#language.types.integer"
  15813. ><B
  15814. CLASS="type"
  15815. >integer</B
  15816. ></A
  15817. > oder ein <A
  15818. HREF="#language.types.string"
  15819. ><B
  15820. CLASS="type"
  15821. >string</B
  15822. ></A
  15823. > sein
  15824. // <VAR
  15825. CLASS="replaceable"
  15826. >Wert</VAR
  15827. > kann irgendetwas sein.</PRE
  15828. ></TD
  15829. ></TR
  15830. ></TABLE
  15831. >
  15832.       Falls <VAR
  15833. CLASS="varname"
  15834. >$arr</VAR
  15835. > bis dahin nicht existiert, wird es
  15836.       erzeugt. Das ist also eine alternative Syntax um ein Array zu
  15837.       erzeugen.  Um einen bestimmten Wert zu Σndern, weisen Sie
  15838.       einfach einem Element, das Sie mit seinem Schlⁿssel
  15839.       spezifizieren, einen neuen Wert zu. Wenn Sie ein Schlⁿssel/Wert
  15840.       Paar entfernen m÷chten, benutzen Sie <A
  15841. HREF="#function.unset"
  15842. ><B
  15843. CLASS="function"
  15844. >unset()</B
  15845. ></A
  15846. >.
  15847.       <DIV
  15848. CLASS="informalexample"
  15849. ><P
  15850. ></P
  15851. ><A
  15852. NAME="AEN2991"
  15853. ></A
  15854. ><TABLE
  15855. BORDER="0"
  15856. BGCOLOR="#E0E0E0"
  15857. CELLPADDING="5"
  15858. ><TR
  15859. ><TD
  15860. ><PRE
  15861. CLASS="php"
  15862. ><?php
  15863. $arr = array(5 => 1, 12 => 2);
  15864.  
  15865. $arr[] = 56;    // An dieser Stelle des Skrips ist das
  15866.                 // dasselbe wie $arr[13] = 56;
  15867.  
  15868. $arr["x"] = 42; // Fⁿgt dem Array ein neues Element mit
  15869.                 // dem Schlⁿssel "x" hinzu
  15870.  
  15871. unset($arr[5]); // Entfernt das Element aus dem Array
  15872.  
  15873. unset($arr);    // L÷scht das komplette Array
  15874. ?></PRE
  15875. ></TD
  15876. ></TR
  15877. ></TABLE
  15878. ><P
  15879. ></P
  15880. ></DIV
  15881. >
  15882.      </P
  15883. ><DIV
  15884. CLASS="note"
  15885. ><BLOCKQUOTE
  15886. CLASS="note"
  15887. ><P
  15888. ><B
  15889. >Anmerkung: </B
  15890. >
  15891.        Wie weiter oben schon erwΣhnt, wird, falls Sie die Klammern
  15892.        setzen ohne einen Schlⁿssel anzugeben, der gr÷▀te der
  15893.        Integer-Indizes genommen und der neue Schlⁿssel wird dieses
  15894.        Maximum + 1 sein. Falls es noch keine Integer-Indizes gibt,
  15895.        wird der Schlⁿssel zu <VAR
  15896. CLASS="literal"
  15897. >0</VAR
  15898. > (Null).  Falls Sie
  15899.        einen Schlⁿssel angeben dem schon ein Wert zugeordnet wurde,
  15900.        wird dieser Wert ⁿberschrieben.
  15901.       </P
  15902. ><P
  15903. >        <DIV
  15904. CLASS="warning"
  15905. ><P
  15906. ></P
  15907. ><TABLE
  15908. CLASS="warning"
  15909. BORDER="1"
  15910. WIDTH="100%"
  15911. ><TR
  15912. ><TD
  15913. ALIGN="CENTER"
  15914. ><B
  15915. >Warnung</B
  15916. ></TD
  15917. ></TR
  15918. ><TR
  15919. ><TD
  15920. ALIGN="LEFT"
  15921. ><P
  15922. >          Ab PHP 4.3.0 hat sich die oben beschriebene Generierung von
  15923.          Indizes geΣndert. Wenn Sie etwas an ein Array anhΣngen, in
  15924.          dem der gr÷▀te Schlⁿssel negativ ist, wird der nΣchste
  15925.          Schlⁿssel jetzt Null (<VAR
  15926. CLASS="literal"
  15927. >0</VAR
  15928. >) sein. Davor wΣre
  15929.          der neue Index, genauso wie bei positiven Indizes, der gr÷▀te
  15930.          vorhandene Schlⁿssel + 1 gewesen.
  15931.         </P
  15932. ></TD
  15933. ></TR
  15934. ></TABLE
  15935. ></DIV
  15936. >
  15937.       </P
  15938. ><P
  15939. >        Beachten Sie, dass der hierbei verwendete gr÷▀te
  15940.        Integer-Schlⁿssel <SPAN
  15941. CLASS="emphasis"
  15942. ><I
  15943. CLASS="emphasis"
  15944. >im Array zu diesem Zeitpunkt nicht
  15945.        vorhanden sein muss</I
  15946. ></SPAN
  15947. >. Er muss nur irgendwann im Array
  15948.        existiert haben, seitdem es zum letzten Mal neu indiziert
  15949.        wurde. Folgendes Beispiel zur Veranschaulichung:
  15950.       </P
  15951. ><DIV
  15952. CLASS="informalexample"
  15953. ><P
  15954. ></P
  15955. ><A
  15956. NAME="AEN3002"
  15957. ></A
  15958. ><TABLE
  15959. BORDER="0"
  15960. BGCOLOR="#E0E0E0"
  15961. CELLPADDING="5"
  15962. ><TR
  15963. ><TD
  15964. ><PRE
  15965. CLASS="php"
  15966. ><?php
  15967. // Wir erzeugen ein einfaches Array
  15968. $array = array(1, 2, 3, 4, 5);
  15969. print_r($array);
  15970.  
  15971. // Nun l÷schen wir alle Elemente, lassen das Array selbst
  15972. // aber intakt:
  15973. foreach ($array as $i => $wert) {
  15974.     unset($array[$i]);
  15975. }
  15976. print_r($array);
  15977.  
  15978. // Wir hΣngen ein Element an (beachten Sie, dass der neue Schlⁿssel 5
  15979. // ist, statt 0, wie sie vielleicht erwarten wⁿrden).
  15980. $array[] = 6;
  15981. print_r($array);
  15982.  
  15983. // Neu indizieren:
  15984. $array = array_values($array);
  15985. $array[] = 7;
  15986. print_r($array);
  15987. ?></PRE
  15988. ></TD
  15989. ></TR
  15990. ></TABLE
  15991. ><P
  15992. >         Obiges Beispiel wⁿrde folgende Ausgabe erzeugen:
  15993.         <TABLE
  15994. BORDER="0"
  15995. BGCOLOR="#E0E0E0"
  15996. CELLPADDING="5"
  15997. ><TR
  15998. ><TD
  15999. ><PRE
  16000. CLASS="screen"
  16001. >Array
  16002. (
  16003.     [0] => 1
  16004.     [1] => 2
  16005.     [2] => 3
  16006.     [3] => 4
  16007.     [4] => 5
  16008. )
  16009. Array
  16010. (
  16011. )
  16012. Array
  16013. (
  16014.     [5] => 6
  16015. )
  16016. Array
  16017. (
  16018.     [0] => 6
  16019.     [1] => 7
  16020. )</PRE
  16021. ></TD
  16022. ></TR
  16023. ></TABLE
  16024. >
  16025.        </P
  16026. ><P
  16027. ></P
  16028. ></DIV
  16029. ></BLOCKQUOTE
  16030. ></DIV
  16031. ></DIV
  16032. ></DIV
  16033. ><DIV
  16034. CLASS="sect2"
  16035. ><HR><H3
  16036. CLASS="sect2"
  16037. ><A
  16038. NAME="language.types.array.useful-funcs"
  16039. >Nⁿtzliche Funktionen</A
  16040. ></H3
  16041. ><P
  16042. >      Es gibt viele nⁿtzliche Funktionen um mit Arrays zu arbeiten.
  16043.      Schauen Sie unter dem Abschnitt <A
  16044. HREF="#ref.array"
  16045. >Array
  16046.      Funktionen</A
  16047. > nach.
  16048.     </P
  16049. ><DIV
  16050. CLASS="note"
  16051. ><BLOCKQUOTE
  16052. CLASS="note"
  16053. ><P
  16054. ><B
  16055. >Anmerkung: </B
  16056. >
  16057.       Mit <A
  16058. HREF="#function.unset"
  16059. ><B
  16060. CLASS="function"
  16061. >unset()</B
  16062. ></A
  16063. > k÷nnen Sie Schlⁿssel eines Arrays
  16064.       l÷schen. Halten Sie sich vor Augen, dass das Array NICHT neu
  16065.       indiziert wird. Wenn Sie nur "gew÷hnliche Integer-Indizes" (bei
  16066.       Null beginnend, jeweils um eins steigend) verwenden, erreichen
  16067.       Sie die Neuindizierung durch Verwendung von
  16068.       <A
  16069. HREF="#function.array-values"
  16070. ><B
  16071. CLASS="function"
  16072. >array_values()</B
  16073. ></A
  16074. >.
  16075.       <DIV
  16076. CLASS="informalexample"
  16077. ><P
  16078. ></P
  16079. ><A
  16080. NAME="AEN3014"
  16081. ></A
  16082. ><TABLE
  16083. BORDER="0"
  16084. BGCOLOR="#E0E0E0"
  16085. CELLPADDING="5"
  16086. ><TR
  16087. ><TD
  16088. ><PRE
  16089. CLASS="php"
  16090. ><?php
  16091. $a = array(1 => 'eins', 2 => 'zwei', 3 => 'drei');
  16092. unset($a[2]);
  16093.  
  16094. /* erzeugt ein Array das wie folgt definiert worden wΣre:
  16095.    $a = array(1 => 'eins', 3 => 'drei');
  16096.    und NICHT
  16097.    $a = array(1 => 'eins', 2 => 'drei');
  16098. */
  16099.  
  16100. $b = array_values($a);
  16101. // Jetzt ist $b array(1 => 'eins', 2 =>'drei')
  16102. ?></PRE
  16103. ></TD
  16104. ></TR
  16105. ></TABLE
  16106. ><P
  16107. ></P
  16108. ></DIV
  16109. >
  16110.  
  16111.      </P
  16112. ></BLOCKQUOTE
  16113. ></DIV
  16114. ><P
  16115. >      Die <A
  16116. HREF="#control-structures.foreach"
  16117. >foreach</A
  16118. >
  16119.      Kontrollstruktur gibt es speziell fⁿr Arrays. Damit ist es leicht
  16120.      ein Array zu durchlaufen.
  16121.     </P
  16122. ></DIV
  16123. ><DIV
  16124. CLASS="sect2"
  16125. ><HR><H3
  16126. CLASS="sect2"
  16127. ><A
  16128. NAME="language.types.array.donts"
  16129. >Array do's und don'ts</A
  16130. ></H3
  16131. ><DIV
  16132. CLASS="sect3"
  16133. ><H4
  16134. CLASS="sect3"
  16135. ><A
  16136. NAME="language.types.array.foo-bar"
  16137. >Warum ist <VAR
  16138. CLASS="literal"
  16139. >$foo[bar]</VAR
  16140. > falsch?</A
  16141. ></H4
  16142. ><P
  16143. >       Sie sollten immer Anfⁿhrungszeichen fⁿr einen
  16144.       String-Literal-Index eines Arrays benutzen. Zum Beispiel
  16145.       sollten Sie $foo['bar'] und nicht
  16146.       $foo[bar] benutzen. Aber warum ist $foo[bar] falsch? Vieleicht
  16147.       kennen Sie folgende Syntax aus alten Skripts:
  16148.       <DIV
  16149. CLASS="informalexample"
  16150. ><P
  16151. ></P
  16152. ><A
  16153. NAME="AEN3024"
  16154. ></A
  16155. ><TABLE
  16156. BORDER="0"
  16157. BGCOLOR="#E0E0E0"
  16158. CELLPADDING="5"
  16159. ><TR
  16160. ><TD
  16161. ><PRE
  16162. CLASS="php"
  16163. ><?php
  16164. $foo[bar] = 'Feind';
  16165. echo $foo[bar];
  16166. // usw
  16167. ?></PRE
  16168. ></TD
  16169. ></TR
  16170. ></TABLE
  16171. ><P
  16172. ></P
  16173. ></DIV
  16174. >
  16175.       Es ist falsch, funktioniert aber. Warum ist es dann falsch?  Der
  16176.       Grund ist, dass dieser Code statt eines Strings ('bar'- beachten
  16177.       Sie die Anfⁿhrungszeichen) eine undefinierte Konstante (bar)
  16178.       enthΣlt und PHP in Zukunft Konstanten definieren k÷nnte, die,
  16179.       unglⁿcklicherweise fⁿr Ihren Code, den gleichen Namen verwenden.
  16180.       Es funktioniert, weil PHP einen <SPAN
  16181. CLASS="emphasis"
  16182. ><I
  16183. CLASS="emphasis"
  16184. >blo▀en
  16185.       String</I
  16186. ></SPAN
  16187. > (ein String ohne Anfⁿhrungszeichen, der keinem
  16188.       bekannten Symbol entpricht) automatisch in einen String
  16189.       umwandelt, der den blo▀en String enthΣlt. Wenn beispielsweise
  16190.       keine Konstante namens <TT
  16191. CLASS="constant"
  16192. ><B
  16193. >bar</B
  16194. ></TT
  16195. > definiert ist,
  16196.       ersetzt es PHP durch den String <VAR
  16197. CLASS="literal"
  16198. >'bar'</VAR
  16199. > und
  16200.       verwendet diesen.
  16201.      </P
  16202. ><DIV
  16203. CLASS="note"
  16204. ><BLOCKQUOTE
  16205. CLASS="note"
  16206. ><P
  16207. ><B
  16208. >Anmerkung: </B
  16209. >
  16210.        Das bedeutet nicht, dass Schlⁿssel <SPAN
  16211. CLASS="emphasis"
  16212. ><I
  16213. CLASS="emphasis"
  16214. >immer</I
  16215. ></SPAN
  16216. >
  16217.        in Anfⁿhrungszeichen gesetzt werden mⁿssen. Wenn Sie nΣmlich
  16218.        Schlⁿssel, die <A
  16219. HREF="#language.constants"
  16220. >Konstanten</A
  16221. > oder <A
  16222. HREF="#language.variables"
  16223. >Variablen</A
  16224. > sind, in
  16225.        Anfⁿhrungszeichen setzen, werden diese von PHP nicht
  16226.        ausgewertet.
  16227.       </P
  16228. ><DIV
  16229. CLASS="informalexample"
  16230. ><P
  16231. ></P
  16232. ><A
  16233. NAME="AEN3034"
  16234. ></A
  16235. ><TABLE
  16236. BORDER="0"
  16237. BGCOLOR="#E0E0E0"
  16238. CELLPADDING="5"
  16239. ><TR
  16240. ><TD
  16241. ><PRE
  16242. CLASS="php"
  16243. ><?php
  16244. error_reporting(E_ALL);
  16245. ini_set('display_errors', true);
  16246. ini_set('html_errors', false);
  16247.  
  16248. // Ein einfaches Array:
  16249. $array = array(1, 2);
  16250. $anzahl = count($array);
  16251. for ($i = 0; $i < $anzahl; $i++) {
  16252.     echo "\n▄berprⁿfe $i: \n";
  16253.     echo "Schlecht: " . $array['$i'] . "\n";
  16254.     echo "Gut: " . $array[$i] . "\n";
  16255.     echo "Schlecht: {$array['$i']}\n";
  16256.     echo "Gut: {$array[$i]}\n";
  16257. }
  16258. ?></PRE
  16259. ></TD
  16260. ></TR
  16261. ></TABLE
  16262. ><P
  16263. ></P
  16264. ></DIV
  16265. ><P
  16266. ><B
  16267. >Anmerkung: </B
  16268. >
  16269.        Obiges Beispiel wⁿrde folgende Ausgabe erzeugen:
  16270.        <TABLE
  16271. BORDER="0"
  16272. BGCOLOR="#E0E0E0"
  16273. CELLPADDING="5"
  16274. ><TR
  16275. ><TD
  16276. ><PRE
  16277. CLASS="screen"
  16278. >▄berprⁿfe 0:
  16279. Notice: Undefined index:  $i in /path/to/script.html on line 9
  16280. Schlecht:
  16281. Gut: 1
  16282. Notice: Undefined index:  $i in /path/to/script.html on line 11
  16283. Schlecht:
  16284. Gut: 1
  16285.  
  16286. ▄berprⁿfe 1:
  16287. Notice: Undefined index:  $i in /path/to/script.html on line 9
  16288. Schlecht:
  16289. Gut: 2
  16290. Notice: Undefined index:  $i in /path/to/script.html on line 11
  16291. Schlecht:
  16292. Gut: 2</PRE
  16293. ></TD
  16294. ></TR
  16295. ></TABLE
  16296. >
  16297.       </P
  16298. ></BLOCKQUOTE
  16299. ></DIV
  16300. ><P
  16301. >       Weitere Beispiele zur Veranschaulichung dieses Sachverhalts:
  16302.       <DIV
  16303. CLASS="informalexample"
  16304. ><P
  16305. ></P
  16306. ><A
  16307. NAME="AEN3039"
  16308. ></A
  16309. ><TABLE
  16310. BORDER="0"
  16311. BGCOLOR="#E0E0E0"
  16312. CELLPADDING="5"
  16313. ><TR
  16314. ><TD
  16315. ><PRE
  16316. CLASS="php"
  16317. ><?php
  16318. // Wir lassen uns alle Fehlermeldungen anzeigen
  16319. error_reporting(E_ALL);
  16320.  
  16321. $arr = array('obst' => 'Apfel', 'gemuese' => 'Karotte');
  16322.  
  16323. // Richtig
  16324. print $arr['obst'];  // Apfel
  16325. print $arr['gemuese']; // Karotte
  16326.  
  16327. // Falsch. Es funktioniert, gibt aber wegen der undefinierten
  16328. // Konstante namens obst auch einen PHP-Fehler der Stufe E_NOTICE
  16329. // aus:
  16330. //
  16331. // Notice: Use of undefined constant obst - assumed 'obst' in...
  16332. print $arr[obst];    // Apfel
  16333.  
  16334. // Definieren wir nun eine Konstante um zu veranschaulichen was
  16335. // passiert. Wir weisen einer Konstanten namens obst den Wert
  16336. // 'gemuese' zu.
  16337. define('obst', 'gemuese');
  16338.  
  16339. // Beachten Sie jetzt den Unterschied
  16340. print $arr['obst'];  // Apfel
  16341. print $arr[obst];    // Karotte
  16342.  
  16343. // Folgendes ist in Ordnung, weil es innerhalb eines Strings ist.
  16344. // Innerhalb eines Strings wird nicht nach Konstanten gesucht und
  16345. // deshalb gibt es hier auch keinen E_NOTICE-Fehler.
  16346. print "Hallo $arr[obst]";      // Hallo Apfel
  16347.  
  16348. // Eine Ausnahme: innerhalb von Strings erm÷glichen {Klammern}
  16349. // um Arrays, dass nach Konstanten gesucht wird
  16350. print "Hallo {$arr[obst]}";    // Hallo Karotte
  16351. print "Hallo {$arr['obst']}";  // Hallo Apfel
  16352.  
  16353. // Das funktioniert nicht und ergibt in etwa folgenden Parser-Fehler:
  16354. // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING'
  16355. // Das gilt natⁿrlich auch fⁿr die Verwendung von Autoglobalen in
  16356. // Strings
  16357. print "Hallo $arr['obst']";
  16358. print "Hallo $_GET['foo']";
  16359.  
  16360. // Eine andere M÷glichkeit ist die Verkettung
  16361. print "Hallo " . $arr['obst']; // Hallo Apfel
  16362. ?></PRE
  16363. ></TD
  16364. ></TR
  16365. ></TABLE
  16366. ><P
  16367. ></P
  16368. ></DIV
  16369. >
  16370.      </P
  16371. ><P
  16372. >       Wenn Sie <A
  16373. HREF="#function.error-reporting"
  16374. ><B
  16375. CLASS="function"
  16376. >error_reporting()</B
  16377. ></A
  16378. > auf Fehler der
  16379.       Stufe <TT
  16380. CLASS="constant"
  16381. ><B
  16382. >E_NOTICE</B
  16383. ></TT
  16384. > einstellen (beispielsweise
  16385.       durch setzen auf <TT
  16386. CLASS="constant"
  16387. ><B
  16388. >E_ALL</B
  16389. ></TT
  16390. >), werden Sie diese
  16391.       Fehlermeldungen zu sehen bekommen. StandardmΣ▀ig ist <A
  16392. HREF="#ini.error-reporting"
  16393. >error_reporting</A
  16394. > so
  16395.       eingestellt, dass sie nicht angezeigt werden.
  16396.      </P
  16397. ><P
  16398. >       Wie im Abschnitt <A
  16399. HREF="#language.types.array.syntax"
  16400. >Syntax</A
  16401. > ausgefⁿhrt,
  16402.       muss zwischen den eckigen Klammern ('<VAR
  16403. CLASS="literal"
  16404. >[</VAR
  16405. >' und
  16406.       '<VAR
  16407. CLASS="literal"
  16408. >]</VAR
  16409. >') ein Ausdruck stehen.  Das hei▀t, dass
  16410.       Sie Dinge Σhnlich diesen schreiben k÷nnen:
  16411.       <DIV
  16412. CLASS="informalexample"
  16413. ><P
  16414. ></P
  16415. ><A
  16416. NAME="AEN3050"
  16417. ></A
  16418. ><TABLE
  16419. BORDER="0"
  16420. BGCOLOR="#E0E0E0"
  16421. CELLPADDING="5"
  16422. ><TR
  16423. ><TD
  16424. ><PRE
  16425. CLASS="php"
  16426. ><?php
  16427. echo $arr[somefunc($bar)];
  16428. ?></PRE
  16429. ></TD
  16430. ></TR
  16431. ></TABLE
  16432. ><P
  16433. ></P
  16434. ></DIV
  16435. >
  16436.       Das ist ein Beispiel dafⁿr, wie Sie den Rⁿckgabewert einer
  16437.       Funktion als Array-Index verwenden k÷nnen. Ebenso kennt PHP
  16438.       Konstanten. Vielleicht haben Sie die <VAR
  16439. CLASS="literal"
  16440. >E_*</VAR
  16441. >
  16442.       Konstanten schon einmal gesehen.
  16443.       <DIV
  16444. CLASS="informalexample"
  16445. ><P
  16446. ></P
  16447. ><A
  16448. NAME="AEN3053"
  16449. ></A
  16450. ><TABLE
  16451. BORDER="0"
  16452. BGCOLOR="#E0E0E0"
  16453. CELLPADDING="5"
  16454. ><TR
  16455. ><TD
  16456. ><PRE
  16457. CLASS="php"
  16458. ><?php
  16459. $error_descriptions[E_ERROR]   = "Ein schwerwiegender Fehler ist aufgetreten";
  16460. $error_descriptions[E_WARNING] = "PHP hat eine Warnung ausgegeben";
  16461. $error_descriptions[E_NOTICE]  = "Das ist nur eine informelle Notiz";
  16462. ?></PRE
  16463. ></TD
  16464. ></TR
  16465. ></TABLE
  16466. ><P
  16467. ></P
  16468. ></DIV
  16469. >
  16470.       Beachten Sie, dass <VAR
  16471. CLASS="literal"
  16472. >E_ERROR</VAR
  16473. > ebenso ein
  16474.       gⁿltiger Bezeichner ist, genau wie <VAR
  16475. CLASS="literal"
  16476. >bar</VAR
  16477. > im
  16478.       ersten Beispiel.  Das letzte Beispiel entspricht aber
  16479.       tatsΣchlich dem folgendem Code:
  16480.       <DIV
  16481. CLASS="informalexample"
  16482. ><P
  16483. ></P
  16484. ><A
  16485. NAME="AEN3057"
  16486. ></A
  16487. ><TABLE
  16488. BORDER="0"
  16489. BGCOLOR="#E0E0E0"
  16490. CELLPADDING="5"
  16491. ><TR
  16492. ><TD
  16493. ><PRE
  16494. CLASS="php"
  16495. ><?php
  16496. $error_descriptions[1] = "Ein schwerwiegender Fehler ist aufgetreten";
  16497. $error_descriptions[2] = "PHP hat eine Warnung ausgegeben";
  16498. $error_descriptions[8] = "Das ist nur eine informelle Notiz";
  16499. ?></PRE
  16500. ></TD
  16501. ></TR
  16502. ></TABLE
  16503. ><P
  16504. ></P
  16505. ></DIV
  16506. >
  16507.       weil <VAR
  16508. CLASS="literal"
  16509. >E_ERROR</VAR
  16510. > gleich <VAR
  16511. CLASS="literal"
  16512. >1</VAR
  16513. > ist,
  16514.       usw.
  16515.      </P
  16516. ><P
  16517. >       Wie schon in den obigen Beispielen erklΣrt wurde, funktioniert
  16518.       <VAR
  16519. CLASS="literal"
  16520. >$foo[bar]</VAR
  16521. > zwar, ist aber falsch. Es
  16522.       funktioniert, weil <VAR
  16523. CLASS="literal"
  16524. >bar</VAR
  16525. > aufgrund seiner Syntax
  16526.       als Konstante ausgewertet wird. In diesem Fall jedoch existiert
  16527.       keine Konstane mit dem Namen <VAR
  16528. CLASS="literal"
  16529. >bar</VAR
  16530. >. PHP nimmt
  16531.       an, dass Sie <VAR
  16532. CLASS="literal"
  16533. >bar</VAR
  16534. > w÷rtlich gemeint haben, wie
  16535.       den String <VAR
  16536. CLASS="literal"
  16537. >'bar'</VAR
  16538. >, aber vergessen haben, die
  16539.       Anfⁿhrungszeichen zu setzen.
  16540.      </P
  16541. ><DIV
  16542. CLASS="sect4"
  16543. ><HR><H5
  16544. CLASS="sect4"
  16545. ><A
  16546. NAME="AEN3067"
  16547. >Aber warum ist es schlecht?</A
  16548. ></H5
  16549. ><P
  16550. >        Eines Tages k÷nnte sich das PHP-Team entscheiden eine weitere
  16551.        Konstante oder ein Schlⁿsselwort hinzuzufⁿgen oder Sie k÷nnten
  16552.        eine weitere Konstante in Ihre Anwendung einfⁿgen. Und dann
  16553.        geraten Sie in Schwierigkeiten. Zum Beispiel k÷nnen Sie bereits
  16554.        die W÷rter <VAR
  16555. CLASS="literal"
  16556. >empty</VAR
  16557. > und
  16558.        <VAR
  16559. CLASS="literal"
  16560. >default</VAR
  16561. > auf diese Art nicht benutzen, weil
  16562.        es speziele Schlⁿsselw÷rter sind.
  16563.       </P
  16564. ><DIV
  16565. CLASS="note"
  16566. ><BLOCKQUOTE
  16567. CLASS="note"
  16568. ><P
  16569. ><B
  16570. >Anmerkung: </B
  16571. >
  16572.         Um es nochmals zu wiederholen, innerhalb eines Strings in
  16573.         doppelten Anfⁿhrungszeichen ist es zulΣssig, Array-Indizes
  16574.         ohne Anfⁿhrungszeichen zu schreiben, weshalb
  16575.         <VAR
  16576. CLASS="literal"
  16577. >"$foo[bar]"</VAR
  16578. > gⁿltig ist. Schauen Sie sich
  16579.         fⁿr Einzelheiten darⁿber, warum das so ist, obige Beispiele
  16580.         und den Abschnitt ⁿber <A
  16581. HREF="#language.types.string.parsing"
  16582. >Variablen-Analyse in
  16583.         Strings</A
  16584. > an.
  16585.        </P
  16586. ></BLOCKQUOTE
  16587. ></DIV
  16588. ></DIV
  16589. ></DIV
  16590. ></DIV
  16591. ><DIV
  16592. CLASS="sect2"
  16593. ><HR><H3
  16594. CLASS="sect2"
  16595. ><A
  16596. NAME="language.types.array.casting"
  16597. >Umwandlung nach array</A
  16598. ></H3
  16599. ><P
  16600. >      Fⁿr die Typen Integer, Float,
  16601.      String, Boolean und
  16602.      Resource gilt: wenn Sie einen Wert in ein Array
  16603.      umwandeln, bekommen Sie ein Array mit einem Element (mit Index
  16604.      0), das der skalare Wert ist, den Sie anfangs hatten.
  16605.     </P
  16606. ><P
  16607. >      Wenn Sie ein Objekt in ein Array umwandeln, bekommen
  16608.      Sie die Eigenschaften (Mitgliedsvariablen) des Objekts als
  16609.      Elemente des Arrays. Die Schlⁿssel sind die Namen der
  16610.      Mitgliedsvariablen.
  16611.     </P
  16612. ><P
  16613. >      Wenn Sie einen <TT
  16614. CLASS="constant"
  16615. ><B
  16616. >NULL</B
  16617. ></TT
  16618. >-Wert in ein Array umwandeln, bekommen Sie
  16619.      ein leeres Array.
  16620.     </P
  16621. ></DIV
  16622. ><DIV
  16623. CLASS="sect2"
  16624. ><HR><H3
  16625. CLASS="sect2"
  16626. ><A
  16627. NAME="language.types.array.comparing"
  16628. >Vergleiche</A
  16629. ></H3
  16630. ><P
  16631. >      Arrays k÷nnen Sie mit der Funktion <A
  16632. HREF="#function.array-diff"
  16633. ><B
  16634. CLASS="function"
  16635. >array_diff()</B
  16636. ></A
  16637. > und
  16638.      mit den <A
  16639. HREF="#language.operators.array"
  16640. >Array Operatoren
  16641.      </A
  16642. > vergleichen.
  16643.     </P
  16644. ></DIV
  16645. ><DIV
  16646. CLASS="sect2"
  16647. ><HR><H3
  16648. CLASS="sect2"
  16649. ><A
  16650. NAME="language.types.array.examples"
  16651. >Beispiele</A
  16652. ></H3
  16653. ><P
  16654. >      Der Array-Typ in PHP ist sehr vielseitig. Hier folgen einige
  16655.      Beispiele um Ihnen die MΣchtigkeit von Arrays zu
  16656.      veranschaulichen.
  16657.     </P
  16658. ><P
  16659. >      <DIV
  16660. CLASS="informalexample"
  16661. ><P
  16662. ></P
  16663. ><A
  16664. NAME="AEN3097"
  16665. ></A
  16666. ><TABLE
  16667. BORDER="0"
  16668. BGCOLOR="#E0E0E0"
  16669. CELLPADDING="5"
  16670. ><TR
  16671. ><TD
  16672. ><PRE
  16673. CLASS="php"
  16674. ><?php
  16675. // Das hier
  16676. $a = array('Farbe'     => 'rot',
  16677.            'Geschmack' => 'sⁿ▀',
  16678.            'Form'      => 'rund',
  16679.            'Name'      => 'Apfel',
  16680.                           4          // Schlⁿssel ist 0
  16681.           );
  16682.  
  16683. // ist komplett gleichwertig mit
  16684. $a['Farbe']     = 'rot';
  16685. $a['Geschmack'] = 'sⁿ▀';
  16686. $a['Form']      = 'rund';
  16687. $a['Name']      = 'Apfel';
  16688. $a[]            = 4;          // Schlⁿssel ist 0
  16689.  
  16690. $b[] = 'a';
  16691. $b[] = 'b';
  16692. $b[] = 'c';
  16693. /* ergibt das Array: array(0 => 'a', 1 => 'b', 2 => 'c'),
  16694.    oder einfacher: array('a', 'b', 'c')
  16695. */
  16696. ?></PRE
  16697. ></TD
  16698. ></TR
  16699. ></TABLE
  16700. ><P
  16701. ></P
  16702. ></DIV
  16703. >
  16704.     </P
  16705. ><TABLE
  16706. WIDTH="100%"
  16707. BORDER="0"
  16708. CELLPADDING="0"
  16709. CELLSPACING="0"
  16710. CLASS="EXAMPLE"
  16711. ><TR
  16712. ><TD
  16713. ><DIV
  16714. CLASS="example"
  16715. ><A
  16716. NAME="AEN3099"
  16717. ></A
  16718. ><P
  16719. ><B
  16720. >Beispiel 10-4. Verwenden von <A
  16721. HREF="#function.array"
  16722. ><B
  16723. CLASS="function"
  16724. >array()</B
  16725. ></A
  16726. ></B
  16727. ></P
  16728. ><TABLE
  16729. BORDER="0"
  16730. BGCOLOR="#E0E0E0"
  16731. CELLPADDING="5"
  16732. ><TR
  16733. ><TD
  16734. ><PRE
  16735. CLASS="php"
  16736. ><?php
  16737. // Array als (Eigenschafts-)Abbildung
  16738. $map = array('version'    => 4,
  16739.              'OS'         => 'Linux',
  16740.              'Sprache'    => 'englisch',
  16741.              'short_tags' => true
  16742.             );
  16743.  
  16744. // strikt numerische Schlⁿssel
  16745. $array = array(7,
  16746.                8,
  16747.                0,
  16748.                156,
  16749.                -10,
  16750.               );
  16751. // Dies entspricht: array(0 => 7, 1 => 8, ...)
  16752.  
  16753. // wechselnde Schlⁿssel
  16754. $wechselnd = array(        10,  // Schlⁿssel: 0
  16755.                    5    =>  6,
  16756.                    3    =>  7,
  16757.                    'a'  =>  4,
  16758.                            11,  // Schlⁿssel: 6 (Maximum der Integer-Indices war 5)
  16759.                    '8'  =>  2,  // Schlⁿssel: 8 (integer!)
  16760.                    '02' => 77,  // Schlⁿssel: '02'
  16761.                    0    => 12   // 10 wird mit dem neuen Wert 12 ⁿberschrieben
  16762.                   );
  16763.  
  16764. // leeres Array
  16765. $leer = array();
  16766. ?></PRE
  16767. ></TD
  16768. ></TR
  16769. ></TABLE
  16770. ></DIV
  16771. ></TD
  16772. ></TR
  16773. ></TABLE
  16774. ><TABLE
  16775. WIDTH="100%"
  16776. BORDER="0"
  16777. CELLPADDING="0"
  16778. CELLSPACING="0"
  16779. CLASS="EXAMPLE"
  16780. ><TR
  16781. ><TD
  16782. ><DIV
  16783. CLASS="example"
  16784. ><A
  16785. NAME="language.types.array.examples.loop"
  16786. ></A
  16787. ><P
  16788. ><B
  16789. >Beispiel 10-5. Sammlung</B
  16790. ></P
  16791. ><TABLE
  16792. BORDER="0"
  16793. BGCOLOR="#E0E0E0"
  16794. CELLPADDING="5"
  16795. ><TR
  16796. ><TD
  16797. ><PRE
  16798. CLASS="php"
  16799. ><?php
  16800. $farben = array('rot', 'blau', 'grⁿn', 'gelb');
  16801.  
  16802. foreach ($farben as $farbe) {
  16803.     echo "GefΣllt Ihnen $farbe?\n";
  16804. }
  16805. ?></PRE
  16806. ></TD
  16807. ></TR
  16808. ></TABLE
  16809. ><P
  16810. >       Ausgabe:
  16811.      </P
  16812. ><TABLE
  16813. BORDER="0"
  16814. BGCOLOR="#E0E0E0"
  16815. CELLPADDING="5"
  16816. ><TR
  16817. ><TD
  16818. ><PRE
  16819. CLASS="screen"
  16820. >GefΣllt Ihnen rot?
  16821. GefΣllt Ihnen blau?
  16822. GefΣllt Ihnen grⁿn?
  16823. GefΣllt Ihnen gelb?</PRE
  16824. ></TD
  16825. ></TR
  16826. ></TABLE
  16827. ></DIV
  16828. ></TD
  16829. ></TR
  16830. ></TABLE
  16831. ><P
  16832. >      Beachten Sie, dass es gegenwΣrtig nicht m÷glich ist die Werte
  16833.      eines Arrays direkt in einer solchen Schleife zu Σndern. Eine
  16834.      L÷sung ist folgendes:
  16835.      <TABLE
  16836. WIDTH="100%"
  16837. BORDER="0"
  16838. CELLPADDING="0"
  16839. CELLSPACING="0"
  16840. CLASS="EXAMPLE"
  16841. ><TR
  16842. ><TD
  16843. ><DIV
  16844. CLASS="example"
  16845. ><A
  16846. NAME="language.types.array.examples.changeloop"
  16847. ></A
  16848. ><P
  16849. ><B
  16850. >Beispiel 10-6. Sammlung</B
  16851. ></P
  16852. ><TABLE
  16853. BORDER="0"
  16854. BGCOLOR="#E0E0E0"
  16855. CELLPADDING="5"
  16856. ><TR
  16857. ><TD
  16858. ><PRE
  16859. CLASS="php"
  16860. ><?php
  16861. foreach ($farben as $schluessel => $farbe) {
  16862.     // funktioniert nicht:
  16863.     //$farbe = strtoupper($farbe);
  16864.  
  16865.     // funktioniert:
  16866.     $farben[$schluessel] = strtoupper($farbe);
  16867. }
  16868. print_r($farben);
  16869. ?></PRE
  16870. ></TD
  16871. ></TR
  16872. ></TABLE
  16873. ><P
  16874. >        Ausgabe:
  16875.       </P
  16876. ><TABLE
  16877. BORDER="0"
  16878. BGCOLOR="#E0E0E0"
  16879. CELLPADDING="5"
  16880. ><TR
  16881. ><TD
  16882. ><PRE
  16883. CLASS="screen"
  16884. >Array
  16885. (
  16886.     [0] => ROT
  16887.     [1] => BLAU
  16888.     [2] => GR▄N
  16889.     [3] => GELB
  16890. )</PRE
  16891. ></TD
  16892. ></TR
  16893. ></TABLE
  16894. ></DIV
  16895. ></TD
  16896. ></TR
  16897. ></TABLE
  16898. >
  16899.     </P
  16900. ><P
  16901. >      Dieses Beispiel erzeugt ein Array, dessen Schlⁿssel bei eins
  16902.      beginnt.
  16903.      <TABLE
  16904. WIDTH="100%"
  16905. BORDER="0"
  16906. CELLPADDING="0"
  16907. CELLSPACING="0"
  16908. CLASS="EXAMPLE"
  16909. ><TR
  16910. ><TD
  16911. ><DIV
  16912. CLASS="example"
  16913. ><A
  16914. NAME="AEN3115"
  16915. ></A
  16916. ><P
  16917. ><B
  16918. >Beispiel 10-7. 1-basierter Index</B
  16919. ></P
  16920. ><TABLE
  16921. BORDER="0"
  16922. BGCOLOR="#E0E0E0"
  16923. CELLPADDING="5"
  16924. ><TR
  16925. ><TD
  16926. ><PRE
  16927. CLASS="php"
  16928. ><?php
  16929. $erstes_viertel  = array(1 => 'Januar', 'Februar', 'MΣrz');
  16930. print_r($erstes_viertel);
  16931. ?></PRE
  16932. ></TD
  16933. ></TR
  16934. ></TABLE
  16935. ><P
  16936. >        Ausgabe:
  16937.       </P
  16938. ><TABLE
  16939. BORDER="0"
  16940. BGCOLOR="#E0E0E0"
  16941. CELLPADDING="5"
  16942. ><TR
  16943. ><TD
  16944. ><PRE
  16945. CLASS="screen"
  16946. >Array 
  16947. (
  16948.     [1] => 'Januar'
  16949.     [2] => 'Februar'
  16950.     [3] => 'MΣrz'
  16951. )</PRE
  16952. ></TD
  16953. ></TR
  16954. ></TABLE
  16955. ></DIV
  16956. ></TD
  16957. ></TR
  16958. ></TABLE
  16959. >
  16960.     </P
  16961. ><TABLE
  16962. WIDTH="100%"
  16963. BORDER="0"
  16964. CELLPADDING="0"
  16965. CELLSPACING="0"
  16966. CLASS="EXAMPLE"
  16967. ><TR
  16968. ><TD
  16969. ><DIV
  16970. CLASS="example"
  16971. ><A
  16972. NAME="AEN3120"
  16973. ></A
  16974. ><P
  16975. ><B
  16976. >Beispiel 10-8. Fⁿllen eines Arrays</B
  16977. ></P
  16978. ><TABLE
  16979. BORDER="0"
  16980. BGCOLOR="#E0E0E0"
  16981. CELLPADDING="5"
  16982. ><TR
  16983. ><TD
  16984. ><PRE
  16985. CLASS="php"
  16986. ><?php
  16987. // Fⁿllen eines Arrays mit allen Inhalten eines Verzeichnisses
  16988. $handle = opendir('.');
  16989. while (false !== ($datei = readdir($handle))) {
  16990.     $dateien[] = $datei;
  16991. }
  16992. closedir($handle);
  16993. ?></PRE
  16994. ></TD
  16995. ></TR
  16996. ></TABLE
  16997. ></DIV
  16998. ></TD
  16999. ></TR
  17000. ></TABLE
  17001. ><P
  17002. >      Arrays sind geordnet. Diese Ordnung k÷nnen Sie mit Hilfe
  17003.      verschiedener Sortierfunktionen verΣndern. Fⁿr mehr Informationen
  17004.      schauen Sie unter dem Abschnitt zu den <A
  17005. HREF="#ref.array"
  17006. >Array Funktionen</A
  17007. > nach. Die Anzahl der
  17008.      Elemente in einem Array k÷nnen Sie mit der Funktion
  17009.      <A
  17010. HREF="#function.count"
  17011. ><B
  17012. CLASS="function"
  17013. >count()</B
  17014. ></A
  17015. > zΣhlen.
  17016.     </P
  17017. ><TABLE
  17018. WIDTH="100%"
  17019. BORDER="0"
  17020. CELLPADDING="0"
  17021. CELLSPACING="0"
  17022. CLASS="EXAMPLE"
  17023. ><TR
  17024. ><TD
  17025. ><DIV
  17026. CLASS="example"
  17027. ><A
  17028. NAME="AEN3126"
  17029. ></A
  17030. ><P
  17031. ><B
  17032. >Beispiel 10-9. Sortieren eines Arrays</B
  17033. ></P
  17034. ><TABLE
  17035. BORDER="0"
  17036. BGCOLOR="#E0E0E0"
  17037. CELLPADDING="5"
  17038. ><TR
  17039. ><TD
  17040. ><PRE
  17041. CLASS="php"
  17042. ><?php
  17043. sort($dateien);
  17044. print_r($dateien);
  17045. ?></PRE
  17046. ></TD
  17047. ></TR
  17048. ></TABLE
  17049. ></DIV
  17050. ></TD
  17051. ></TR
  17052. ></TABLE
  17053. ><P
  17054. >      Weil der Wert eines Arrays alles sein kann, kann dieser Wert
  17055.      wiederum ein Array sein. Somit k÷nnen Sie rekursive und
  17056.      multidimensionale Arrays erzeugen.
  17057.     </P
  17058. ><TABLE
  17059. WIDTH="100%"
  17060. BORDER="0"
  17061. CELLPADDING="0"
  17062. CELLSPACING="0"
  17063. CLASS="EXAMPLE"
  17064. ><TR
  17065. ><TD
  17066. ><DIV
  17067. CLASS="example"
  17068. ><A
  17069. NAME="AEN3130"
  17070. ></A
  17071. ><P
  17072. ><B
  17073. >Beispiel 10-10. Rekursive and multidimensionale Arrays</B
  17074. ></P
  17075. ><TABLE
  17076. BORDER="0"
  17077. BGCOLOR="#E0E0E0"
  17078. CELLPADDING="5"
  17079. ><TR
  17080. ><TD
  17081. ><PRE
  17082. CLASS="php"
  17083. ><?php
  17084. $fruits = array ("frⁿchte" => array("a" => "Orange",
  17085.                                     "b" => "Banane",
  17086.                                     "c" => "Apfel"
  17087.                                    ),
  17088.                  "nummern" => array(1,
  17089.                                     2,
  17090.                                     3,
  17091.                                     4,
  17092.                                     5,
  17093.                                     6
  17094.                                    ),
  17095.                  "l÷cher"  => array(     "erstens",
  17096.                                     5 => "zweitens",
  17097.                                          "drittens"
  17098.                                    )
  17099.                 );
  17100.  
  17101. // Ein paar Beispiele zum Ansprechen der Werte aus obigem Array
  17102. echo $fruits["l÷cher"][5];    // gibt "zweitens" aus
  17103. echo $fruits["frⁿchte"]["a"]; // gibt "Orange" aus
  17104. unset($fruits["l÷cher"][0]);  // entfernt "erstens"
  17105.  
  17106. // Erzeugen eines neuen mehrdimensionalen Arrays
  17107. $saefte["Apfel"]["gruen"] = "gut";
  17108. ?></PRE
  17109. ></TD
  17110. ></TR
  17111. ></TABLE
  17112. ></DIV
  17113. ></TD
  17114. ></TR
  17115. ></TABLE
  17116. ><P
  17117. >      Sie sollten wissen, dass beim Zuweisen eines Arrays die Werte
  17118.      immer kopiert werden. Um ein Array als Referenz zu kopieren,
  17119.      mⁿssen Sie den Referenz-Operator verwenden.
  17120.      <DIV
  17121. CLASS="informalexample"
  17122. ><P
  17123. ></P
  17124. ><A
  17125. NAME="AEN3134"
  17126. ></A
  17127. ><TABLE
  17128. BORDER="0"
  17129. BGCOLOR="#E0E0E0"
  17130. CELLPADDING="5"
  17131. ><TR
  17132. ><TD
  17133. ><PRE
  17134. CLASS="php"
  17135. ><?php
  17136. $arr1 = array(2, 3);
  17137. $arr2 = $arr1;
  17138. $arr2[] = 4; // $arr2 wird verΣndert,
  17139.              // $arr1 ist immer noch array(2, 3)
  17140.  
  17141. $arr3 = &$arr1;
  17142. $arr3[] = 4; // nun sind $arr1 und $arr3 gleich
  17143. ?></PRE
  17144. ></TD
  17145. ></TR
  17146. ></TABLE
  17147. ><P
  17148. ></P
  17149. ></DIV
  17150. >
  17151.     </P
  17152. ></DIV
  17153. ></DIV
  17154. ><DIV
  17155. CLASS="sect1"
  17156. ><HR><H2
  17157. CLASS="sect1"
  17158. ><A
  17159. NAME="language.types.object"
  17160. >Objekte</A
  17161. ></H2
  17162. ><DIV
  17163. CLASS="sect2"
  17164. ><H3
  17165. CLASS="sect2"
  17166. ><A
  17167. NAME="language.types.object.init"
  17168. >Objekt-Initialisierung</A
  17169. ></H3
  17170. ><P
  17171. >      Um ein Objekt zu initialisieren benutzen sie die Angabe
  17172.      <VAR
  17173. CLASS="literal"
  17174. >new</VAR
  17175. >, dadurch wird das Objekt einer
  17176.      Variablen-Instanz zugewiesen.
  17177.      <DIV
  17178. CLASS="informalexample"
  17179. ><P
  17180. ></P
  17181. ><A
  17182. NAME="AEN3142"
  17183. ></A
  17184. ><TABLE
  17185. BORDER="0"
  17186. BGCOLOR="#E0E0E0"
  17187. CELLPADDING="5"
  17188. ><TR
  17189. ><TD
  17190. ><PRE
  17191. CLASS="php"
  17192. ><?php
  17193. class foo {
  17194.     function tue_foo() {
  17195.         echo "Tue gerade foo.";
  17196.     }
  17197. }
  17198.  
  17199. $bar = new foo;
  17200. $bar->tue_foo();
  17201. ?></PRE
  17202. ></TD
  17203. ></TR
  17204. ></TABLE
  17205. ><P
  17206. ></P
  17207. ></DIV
  17208. >
  17209.     </P
  17210. ><P
  17211. >      Fⁿr eine ausfⁿhrliche Darstellung lesen Sie das Kapitel <A
  17212. HREF="#language.oop"
  17213. >Klassen und Objekte</A
  17214. >
  17215.     </P
  17216. ></DIV
  17217. ><DIV
  17218. CLASS="sect2"
  17219. ><HR><H3
  17220. CLASS="sect2"
  17221. ><A
  17222. NAME="language.types.object.casting"
  17223. >Umwandlung nach object</A
  17224. ></H3
  17225. ><P
  17226. >      Wenn ein Objekt in ein Objekt umgewandelt wird, wird es nicht
  17227.      verΣndert. Wenn ein Wert eines anderen Typs in ein Objekt
  17228.      umgewandelt wird, wird eine neue Instanz der eingebauten Klasse
  17229.      <VAR
  17230. CLASS="literal"
  17231. >stdClass</VAR
  17232. > erzeugt. War der Wert Null, dann ist
  17233.      die neue Instanz leer. Bei jedem anderen Wert enthΣlt eine
  17234.      Mitgliedsvariable namens <VAR
  17235. CLASS="literal"
  17236. >scalar</VAR
  17237. > den Wert.
  17238.      <DIV
  17239. CLASS="informalexample"
  17240. ><P
  17241. ></P
  17242. ><A
  17243. NAME="AEN3151"
  17244. ></A
  17245. ><TABLE
  17246. BORDER="0"
  17247. BGCOLOR="#E0E0E0"
  17248. CELLPADDING="5"
  17249. ><TR
  17250. ><TD
  17251. ><PRE
  17252. CLASS="php"
  17253. ><?php
  17254. $obj = (object) 'ciao';
  17255. echo $obj->scalar;  // gibt 'ciao' aus
  17256. ?></PRE
  17257. ></TD
  17258. ></TR
  17259. ></TABLE
  17260. ><P
  17261. ></P
  17262. ></DIV
  17263. >
  17264.     </P
  17265. ></DIV
  17266. ></DIV
  17267. ><DIV
  17268. CLASS="sect1"
  17269. ><HR><H2
  17270. CLASS="sect1"
  17271. ><A
  17272. NAME="language.types.resource"
  17273. >Resource</A
  17274. ></H2
  17275. ><P
  17276. >     Eine Resource ist eine spezielle Variable, die eine Referenz auf
  17277.     eine externe Ressource enthΣlt. Ressourcen werden von bestimmten
  17278.     Funktionen erzeugt und benutzt. Eine Liste dieser Funktionen und
  17279.     der entsprechenden Resource-Typen finden Sie im <A
  17280. HREF="#resource"
  17281. >Anhang</A
  17282. >.
  17283.    </P
  17284. ><DIV
  17285. CLASS="note"
  17286. ><BLOCKQUOTE
  17287. CLASS="note"
  17288. ><P
  17289. ><B
  17290. >Anmerkung: </B
  17291. >
  17292.      Der Resource-Typ wurde in PHP 4 eingefⁿhrt.
  17293.     </P
  17294. ></BLOCKQUOTE
  17295. ></DIV
  17296. ><DIV
  17297. CLASS="sect2"
  17298. ><HR><H3
  17299. CLASS="sect2"
  17300. ><A
  17301. NAME="language.types.resource.casting"
  17302. >Umwandlung nach resource</A
  17303. ></H3
  17304. ><P
  17305. >      Da Resource-Typen spezielle Routinen zu ge÷ffneten Dateien,
  17306.      Datenbankverbindungen, Bildinformationen und ─hnlichem
  17307.      enthalten, k÷nnen Sie keinen Wert in eine Resource umwandeln.
  17308.     </P
  17309. ></DIV
  17310. ><DIV
  17311. CLASS="sect2"
  17312. ><HR><H3
  17313. CLASS="sect2"
  17314. ><A
  17315. NAME="language.types.resource.self-destruct"
  17316. >Freigabe von Ressourcen</A
  17317. ></H3
  17318. ><P
  17319. >      Aufgrund des Reference-Counting Systems, das mit PHP 4's
  17320.      Zend Egine eingefⁿhrt wurde, wird automatisch entdeckt, wenn auf
  17321.      eine Ressource nicht mehr zugegriffen wird (wie in Java). Wenn
  17322.      dies der Fall ist werden alle Ressourcen, die fⁿr diese Ressource
  17323.      in Gebrauch waren, durch den "Mⁿllsammler" (garbage collector)
  17324.      freigegeben. Aus diesem Grund ist es selten jemals notwendig,
  17325.      Speicher manuell durch Aufruf von free_result-Funktionen
  17326.      freizugeben.
  17327.      <DIV
  17328. CLASS="note"
  17329. ><BLOCKQUOTE
  17330. CLASS="note"
  17331. ><P
  17332. ><B
  17333. >Anmerkung: </B
  17334. >
  17335.        Persistente Datenbank-Links stellen einen Sonderfall dar, sie
  17336.        werden durch den garbage collector <SPAN
  17337. CLASS="emphasis"
  17338. ><I
  17339. CLASS="emphasis"
  17340. >nicht</I
  17341. ></SPAN
  17342. >
  17343.        zerst÷rt.  Siehe auch den Abschnitt ⁿber <A
  17344. HREF="#features.persistent-connections"
  17345. >Persistente
  17346.        Datenbankverbindungen</A
  17347. >.
  17348.       </P
  17349. ></BLOCKQUOTE
  17350. ></DIV
  17351. >
  17352.     </P
  17353. ></DIV
  17354. ></DIV
  17355. ><DIV
  17356. CLASS="sect1"
  17357. ><HR><H2
  17358. CLASS="sect1"
  17359. ><A
  17360. NAME="language.types.null"
  17361. >NULL</A
  17362. ></H2
  17363. ><P
  17364. >     Der spezielle Wert <TT
  17365. CLASS="constant"
  17366. ><B
  17367. >NULL</B
  17368. ></TT
  17369. > steht dafⁿr, dass eine Varaiable keinen
  17370.     Wert hat. <TT
  17371. CLASS="constant"
  17372. ><B
  17373. >NULL</B
  17374. ></TT
  17375. > ist der einzig m÷gliche Wert des Typs
  17376.     <A
  17377. HREF="#language.types.null"
  17378. ><B
  17379. CLASS="type"
  17380. >NULL</B
  17381. ></A
  17382. >.
  17383.    </P
  17384. ><DIV
  17385. CLASS="note"
  17386. ><BLOCKQUOTE
  17387. CLASS="note"
  17388. ><P
  17389. ><B
  17390. >Anmerkung: </B
  17391. >
  17392.      Der Null-Typ wurde in PHP 4 eingefⁿhrt.
  17393.     </P
  17394. ></BLOCKQUOTE
  17395. ></DIV
  17396. ><P
  17397. >     Eine Variable wird als <TT
  17398. CLASS="constant"
  17399. ><B
  17400. >NULL</B
  17401. ></TT
  17402. > interpretiert, wenn
  17403.     <P
  17404. ></P
  17405. ><UL
  17406. ><LI
  17407. ><P
  17408. >        ihr die Konstannte <TT
  17409. CLASS="constant"
  17410. ><B
  17411. >NULL</B
  17412. ></TT
  17413. > als Wert zugewiesen wurde,
  17414.       </P
  17415. ></LI
  17416. ><LI
  17417. ><P
  17418. >        ihr bis jetzt kein Wert zugewiesen wurde,
  17419.       </P
  17420. ></LI
  17421. ><LI
  17422. ><P
  17423. >        sie mit <A
  17424. HREF="#function.unset"
  17425. ><B
  17426. CLASS="function"
  17427. >unset()</B
  17428. ></A
  17429. > gel÷scht wurde.
  17430.       </P
  17431. ></LI
  17432. ></UL
  17433. >
  17434.    </P
  17435. ><DIV
  17436. CLASS="sect2"
  17437. ><HR><H3
  17438. CLASS="sect2"
  17439. ><A
  17440. NAME="language.types.null.syntax"
  17441. >Syntax</A
  17442. ></H3
  17443. ><P
  17444. >      Es gibt nur einen Wert des Typs <TT
  17445. CLASS="constant"
  17446. ><B
  17447. >NULL</B
  17448. ></TT
  17449. >: das Schlⁿsselwort <TT
  17450. CLASS="constant"
  17451. ><B
  17452. >NULL</B
  17453. ></TT
  17454. >.
  17455.      Gro▀-/Kleinschreibung spielt keine Rolle.
  17456.      <DIV
  17457. CLASS="informalexample"
  17458. ><P
  17459. ></P
  17460. ><A
  17461. NAME="AEN3193"
  17462. ></A
  17463. ><TABLE
  17464. BORDER="0"
  17465. BGCOLOR="#E0E0E0"
  17466. CELLPADDING="5"
  17467. ><TR
  17468. ><TD
  17469. ><PRE
  17470. CLASS="php"
  17471. ><?php
  17472. $var = NULL;
  17473. ?></PRE
  17474. ></TD
  17475. ></TR
  17476. ></TABLE
  17477. ><P
  17478. ></P
  17479. ></DIV
  17480. >
  17481.     </P
  17482. ><P
  17483. >      Siehe auch <A
  17484. HREF="#function.is-null"
  17485. ><B
  17486. CLASS="function"
  17487. >is_null()</B
  17488. ></A
  17489. > und
  17490.      <A
  17491. HREF="#function.unset"
  17492. ><B
  17493. CLASS="function"
  17494. >unset()</B
  17495. ></A
  17496. >.
  17497.     </P
  17498. ></DIV
  17499. ></DIV
  17500. ><DIV
  17501. CLASS="sect1"
  17502. ><HR><H2
  17503. CLASS="sect1"
  17504. ><A
  17505. NAME="language.pseudo-types"
  17506. >In dieser Dokumentation verwendete Pseudo-Typen</A
  17507. ></H2
  17508. ><DIV
  17509. CLASS="sect2"
  17510. ><H3
  17511. CLASS="sect2"
  17512. ><A
  17513. NAME="language.types.mixed"
  17514. >Mixed</A
  17515. ></H3
  17516. ><P
  17517. >      <VAR
  17518. CLASS="literal"
  17519. >Mixed</VAR
  17520. > deutet darauf hin, dass ein Parameter
  17521.      mehrere (aber nicht notwendigerweise alle) Typen akzeptiert.
  17522.     </P
  17523. ><P
  17524. >      <A
  17525. HREF="#function.gettype"
  17526. ><B
  17527. CLASS="function"
  17528. >gettype()</B
  17529. ></A
  17530. > akzeptiert beispielsweise alle
  17531.      PHP-Typen, wΣhrend <A
  17532. HREF="#function.str-replace"
  17533. ><B
  17534. CLASS="function"
  17535. >str_replace()</B
  17536. ></A
  17537. > Strings und
  17538.      Arrays akzeptiert.
  17539.     </P
  17540. ></DIV
  17541. ><DIV
  17542. CLASS="sect2"
  17543. ><HR><H3
  17544. CLASS="sect2"
  17545. ><A
  17546. NAME="language.types.number"
  17547. >Number</A
  17548. ></H3
  17549. ><P
  17550. >      <VAR
  17551. CLASS="literal"
  17552. >Number</VAR
  17553. > deutet darauf hin, dass ein Parameter
  17554.      entweder ein Integer oder ein Float
  17555.      sein kann.
  17556.     </P
  17557. ></DIV
  17558. ><DIV
  17559. CLASS="sect2"
  17560. ><HR><H3
  17561. CLASS="sect2"
  17562. ><A
  17563. NAME="language.types.callback"
  17564. >Callback</A
  17565. ></H3
  17566. ><P
  17567. >      Einige Funktionen wie <A
  17568. HREF="#function.call-user-func"
  17569. ><B
  17570. CLASS="function"
  17571. >call_user_func()</B
  17572. ></A
  17573. > oder
  17574.      <A
  17575. HREF="#function.usort"
  17576. ><B
  17577. CLASS="function"
  17578. >usort()</B
  17579. ></A
  17580. > akzeptieren benutzerdefinierte
  17581.      Callback-Funktionen als Parameter. Callback-Funktionen k÷nnen
  17582.      nicht nur einfache Funktionen sein, sondern auch Objektmethoden
  17583.      einschlie▀lich statischer Klassenmethoden.
  17584.     </P
  17585. ><P
  17586. >      Eine PHP-Funktion wird einfach durch Ihren Namen als String
  17587.      ⁿbergeben. Sie k÷nnen jede eingebaute oder benutzerdefinierte
  17588.      Funktion ⁿbergeben mit Ausnahme von <A
  17589. HREF="#function.array"
  17590. ><B
  17591. CLASS="function"
  17592. >array()</B
  17593. ></A
  17594. >,
  17595.      <A
  17596. HREF="#function.echo"
  17597. ><B
  17598. CLASS="function"
  17599. >echo()</B
  17600. ></A
  17601. >, <A
  17602. HREF="#function.empty"
  17603. ><B
  17604. CLASS="function"
  17605. >empty()</B
  17606. ></A
  17607. >,
  17608.      <A
  17609. HREF="#function.eval"
  17610. ><B
  17611. CLASS="function"
  17612. >eval()</B
  17613. ></A
  17614. >, <A
  17615. HREF="#function.exit"
  17616. ><B
  17617. CLASS="function"
  17618. >exit()</B
  17619. ></A
  17620. >,
  17621.      <A
  17622. HREF="#function.isset"
  17623. ><B
  17624. CLASS="function"
  17625. >isset()</B
  17626. ></A
  17627. >, <A
  17628. HREF="#function.list"
  17629. ><B
  17630. CLASS="function"
  17631. >list()</B
  17632. ></A
  17633. >,
  17634.      <A
  17635. HREF="#function.print"
  17636. ><B
  17637. CLASS="function"
  17638. >print()</B
  17639. ></A
  17640. > und <A
  17641. HREF="#function.unset"
  17642. ><B
  17643. CLASS="function"
  17644. >unset()</B
  17645. ></A
  17646. >.
  17647.     </P
  17648. ><P
  17649. >      Eine Methode eines instanzierten Objekts wird als Array
  17650.      ⁿbergeben, das ein Objekt als Element mit Index 0 und einen
  17651.      Methodennamen als Element mit Index 1 enthΣlt.
  17652.     </P
  17653. ><P
  17654. >      Statische Klassenmethoden k÷nnen auch ⁿbergeben werden, ohne ein
  17655.      Objekt dieser Klasse zu instanzieren, indem statt des Objekts der
  17656.      Name der Klasse als Element mit Index 0 ⁿbergeben wird.
  17657.     </P
  17658. ><P
  17659. >      <TABLE
  17660. WIDTH="100%"
  17661. BORDER="0"
  17662. CELLPADDING="0"
  17663. CELLSPACING="0"
  17664. CLASS="EXAMPLE"
  17665. ><TR
  17666. ><TD
  17667. ><DIV
  17668. CLASS="example"
  17669. ><A
  17670. NAME="AEN3231"
  17671. ></A
  17672. ><P
  17673. ><B
  17674. >Beispiel 10-11. Beispiele zur Callback-Funktion</B
  17675. ></P
  17676. ><TABLE
  17677. BORDER="0"
  17678. BGCOLOR="#E0E0E0"
  17679. CELLPADDING="5"
  17680. ><TR
  17681. ><TD
  17682. ><PRE
  17683. CLASS="php"
  17684. ><?php
  17685.  
  17686. // einfaches callback Beispiel
  17687. function meine_callback_funktion() {
  17688.     echo 'hallo welt!';
  17689. }
  17690. call_user_func('meine_callback_funktion');
  17691.  
  17692. // Beispiele fⁿr Callbackmethoden
  17693. class MeineKlasse {
  17694.     function meineCallbackMethode() {
  17695.         echo 'Hallo Welt!';
  17696.     }
  17697. }
  17698.  
  17699. // Aufruf einer statischen Klassenmethode ohne Instanzierung
  17700. // eines Objekts
  17701. call_user_func(array('MeineKlasse', 'meineCallbackMethode'));
  17702.  
  17703. // Aufruf einer Objektmethode
  17704. $obj = new MeineKlasse();
  17705. call_user_func(array(&$obj, 'meineCallbackMethode'));
  17706. ?></PRE
  17707. ></TD
  17708. ></TR
  17709. ></TABLE
  17710. ></DIV
  17711. ></TD
  17712. ></TR
  17713. ></TABLE
  17714. >
  17715.     </P
  17716. ></DIV
  17717. ></DIV
  17718. ><DIV
  17719. CLASS="sect1"
  17720. ><HR><H2
  17721. CLASS="sect1"
  17722. ><A
  17723. NAME="language.types.type-juggling"
  17724. >Typen-Tricks</A
  17725. ></H2
  17726. ><P
  17727. >     PHP erfordert (bzw. unterstⁿtzt) keine expliziten Typ-Definitionen
  17728.     bei der Deklaration von Variablen; der Typ einer Variablen wird
  17729.     durch den Zusammenhang bestimmt in dem die Variable benutzt wird.
  17730.     Das bedeutet, dass bei der Zuweisung eines Strings zu einer
  17731.     Variablen <VAR
  17732. CLASS="parameter"
  17733. >$var</VAR
  17734. > diese Variable
  17735.     <VAR
  17736. CLASS="parameter"
  17737. >$var</VAR
  17738. > zum Typ String wird.  Sollten Sie
  17739.     dananch der Variablen <VAR
  17740. CLASS="parameter"
  17741. >$var</VAR
  17742. > einen
  17743.     Integer-Wert zuweisen, wird sie zu einem Integer-Typ.
  17744.    </P
  17745. ><P
  17746. >     Ein Beispiel fⁿr die automatische Typ-Konvertierung von PHP ist
  17747.     der Plus-Operator '+'. Ist einer der zu addierenden Werte vom Typ
  17748.     <A
  17749. HREF="#language.types.float"
  17750. ><B
  17751. CLASS="type"
  17752. >float</B
  17753. ></A
  17754. >, werden alle Werte als float-Typ behandelt.
  17755.     Auch das Ergebnis der Addition wird vom Typ float sein.
  17756.     Andernfalls werden die Werte als <A
  17757. HREF="#language.types.integer"
  17758. ><B
  17759. CLASS="type"
  17760. >integer</B
  17761. ></A
  17762. >-Typen
  17763.     angesehen und das Ergebnis wird ebenfalls vom Typ Integer sein.
  17764.     Beachten Sie, dass hierdurch NICHT der Typ der Operanden selbst
  17765.     beeinflusst wird; der Unterschied liegt einzig und allein in der
  17766.     Auswertung dieser Operanden.
  17767.     <DIV
  17768. CLASS="informalexample"
  17769. ><P
  17770. ></P
  17771. ><A
  17772. NAME="AEN3243"
  17773. ></A
  17774. ><TABLE
  17775. BORDER="0"
  17776. BGCOLOR="#E0E0E0"
  17777. CELLPADDING="5"
  17778. ><TR
  17779. ><TD
  17780. ><PRE
  17781. CLASS="php"
  17782. ><?php
  17783. $foo = "0";                         // $foo ist vom Typ String (ASCII 48)
  17784. $foo += 2;                          // $foo ist jetzt vom Typ Integer (2)
  17785. $foo = $foo + 1.3;                  // $foo ist nun vom Typ float (3.3)
  17786. $foo = 5 + "10 Sehr kleine Ferkel"; // $foo ist vom Typ Integer (15)
  17787. $foo = 5 + "10 Kleine Schweine";    // $foo ist vom Typ Integer (15)
  17788. ?></PRE
  17789. ></TD
  17790. ></TR
  17791. ></TABLE
  17792. ><P
  17793. ></P
  17794. ></DIV
  17795. >
  17796.    </P
  17797. ><P
  17798. >     Wenn Ihnen die beiden letzten Beispiele merkwⁿrdig erscheinen,
  17799.     beachten Sie die <A
  17800. HREF="#language.types.string.conversion"
  17801. >Umwandlung von Strings
  17802.     in Zahlen</A
  17803. >.
  17804.    </P
  17805. ><P
  17806. >     Wenn Sie die Auswertung einer Variablen als einen speziellen Typ
  17807.     erzwingen wollen, beachten sie den Abschnitt in <A
  17808. HREF="#language.types.typecasting"
  17809. >Typ-Umwandlung</A
  17810. >. Wollen
  17811.     Sie den Typ einer Variable Σndern, schauen Sie bei
  17812.     <A
  17813. HREF="#function.settype"
  17814. ><B
  17815. CLASS="function"
  17816. >settype()</B
  17817. ></A
  17818. > nach.
  17819.    </P
  17820. ><P
  17821. >     Um die Beispiele dieses Kapitels auszuprobieren, k÷nnen Sie die
  17822.     Funktion <A
  17823. HREF="#function.var-dump"
  17824. ><B
  17825. CLASS="function"
  17826. >var_dump()</B
  17827. ></A
  17828. > verwenden.
  17829.    </P
  17830. ><DIV
  17831. CLASS="note"
  17832. ><BLOCKQUOTE
  17833. CLASS="note"
  17834. ><P
  17835. ><B
  17836. >Anmerkung: </B
  17837. >
  17838.      Das Verhalten einer automatischen Umwandlung zum Typ Array ist
  17839.      zur Zeit nicht definiert.
  17840.      <DIV
  17841. CLASS="informalexample"
  17842. ><P
  17843. ></P
  17844. ><A
  17845. NAME="AEN3254"
  17846. ></A
  17847. ><TABLE
  17848. BORDER="0"
  17849. BGCOLOR="#E0E0E0"
  17850. CELLPADDING="5"
  17851. ><TR
  17852. ><TD
  17853. ><PRE
  17854. CLASS="php"
  17855. ><?php
  17856. $a = "1";     // $a ist ein String
  17857. $a[0] = "f";  // Was ist mit den String offsets? Was passiert?
  17858. ?></PRE
  17859. ></TD
  17860. ></TR
  17861. ></TABLE
  17862. ><P
  17863. ></P
  17864. ></DIV
  17865. >
  17866.     </P
  17867. ><P
  17868. >      Weil PHP (aus historischen Grⁿnden) die Indizierung innerhalb von
  17869.      Strings mittels der gleichen Syntax wie bei der Array-Indizierung
  17870.      unterstⁿtzt, fⁿhrt das o.a. Beispiel zu einem Problem: Soll $a zu
  17871.      einem Array werden, dessen erstes Element ein "f" ist oder soll
  17872.      "f" das erste Zeichen des Strings $a werden?
  17873.     </P
  17874. ><P
  17875. >      Die aktuellen Versionen von PHP interpretieren die zweite
  17876.      Anweisung als Stringversatz-Kennung, weshalb $a zu "f" wird. Das
  17877.      Ergebnis dieser automatischen Umwandlung sollte jedoch als
  17878.      undefiniert betrachtet werden. Mit PHP 4 wurde die neue Syntax
  17879.      mit geschweiften Klammern eingefⁿhrt um auf Zeichen in einem
  17880.      String zuzugreifen. Verwenden Sie statt der oben vorgestellten
  17881.      Syntax folgende:
  17882.      <DIV
  17883. CLASS="informalexample"
  17884. ><P
  17885. ></P
  17886. ><A
  17887. NAME="AEN3258"
  17888. ></A
  17889. ><TABLE
  17890. BORDER="0"
  17891. BGCOLOR="#E0E0E0"
  17892. CELLPADDING="5"
  17893. ><TR
  17894. ><TD
  17895. ><PRE
  17896. CLASS="php"
  17897. ><?php
  17898. $a    = "abc"; // $a ist ein String
  17899. $a{1} = "f";   // $a ist jetzt "afc"
  17900. ?></PRE
  17901. ></TD
  17902. ></TR
  17903. ></TABLE
  17904. ><P
  17905. ></P
  17906. ></DIV
  17907. >
  17908.      Fⁿr weitere Informationen siehe Abschnitt <A
  17909. HREF="#language.types.string.substr"
  17910. >Zugriff auf Zeichen in
  17911.      Strings</A
  17912. >.
  17913.     </P
  17914. ></BLOCKQUOTE
  17915. ></DIV
  17916. ><DIV
  17917. CLASS="sect2"
  17918. ><HR><H3
  17919. CLASS="sect2"
  17920. ><A
  17921. NAME="language.types.typecasting"
  17922. >Typ-Umwandlung</A
  17923. ></H3
  17924. ><P
  17925. >      Typ-Umwandlung in PHP funktioniert vielfach wie in C: Der Name
  17926.      des gewⁿnschten Typs wird vor der umzuwandelnden Variablen in
  17927.      Klammern gesetzt.
  17928.      <DIV
  17929. CLASS="informalexample"
  17930. ><P
  17931. ></P
  17932. ><A
  17933. NAME="AEN3264"
  17934. ></A
  17935. ><TABLE
  17936. BORDER="0"
  17937. BGCOLOR="#E0E0E0"
  17938. CELLPADDING="5"
  17939. ><TR
  17940. ><TD
  17941. ><PRE
  17942. CLASS="programlisting"
  17943. ><?php
  17944. $foo = 10;             // $foo ist ein Integer-Wert
  17945. $bar = (boolean) $foo; // $bar ist vom Typ boolean
  17946. ?></PRE
  17947. ></TD
  17948. ></TR
  17949. ></TABLE
  17950. ><P
  17951. ></P
  17952. ></DIV
  17953. >
  17954.     </P
  17955. ><P
  17956. >      Folgende Umwandlungen sind m÷glich:
  17957.      <P
  17958. ></P
  17959. ><UL
  17960. ><LI
  17961. ><P
  17962. >(int), (integer) - nach integer</P
  17963. ></LI
  17964. ><LI
  17965. ><P
  17966. >(bool), (boolean) - nach boolean</P
  17967. ></LI
  17968. ><LI
  17969. ><P
  17970. >(float), (double), (real) - nach float</P
  17971. ></LI
  17972. ><LI
  17973. ><P
  17974. >(string) - nach string</P
  17975. ></LI
  17976. ><LI
  17977. ><P
  17978. >(array) - nach array</P
  17979. ></LI
  17980. ><LI
  17981. ><P
  17982. >(object) - Wandlung zum Objekt</P
  17983. ></LI
  17984. ></UL
  17985. >
  17986.     </P
  17987. ><P
  17988. >      Beachten sie, dass Tabulatoren und Leerzeichen innerhalb der
  17989.      Klammern erlaubt sind. Deshalb sind die folgenden Beispiele
  17990.      identisch:
  17991.      <DIV
  17992. CLASS="informalexample"
  17993. ><P
  17994. ></P
  17995. ><A
  17996. NAME="AEN3281"
  17997. ></A
  17998. ><TABLE
  17999. BORDER="0"
  18000. BGCOLOR="#E0E0E0"
  18001. CELLPADDING="5"
  18002. ><TR
  18003. ><TD
  18004. ><PRE
  18005. CLASS="php"
  18006. ><?php
  18007. $foo = (int) $bar;
  18008. $foo = ( int ) $bar;
  18009. ?></PRE
  18010. ></TD
  18011. ></TR
  18012. ></TABLE
  18013. ><P
  18014. ></P
  18015. ></DIV
  18016. >
  18017.     </P
  18018. ><DIV
  18019. CLASS="note"
  18020. ><BLOCKQUOTE
  18021. CLASS="note"
  18022. ><P
  18023. ><B
  18024. >Anmerkung: </B
  18025. >
  18026.       Anstatt eine Variable in einen String umzuwandeln, k÷nnen Sie
  18027.       die Variable auch in doppelte Anfⁿhrungszeichen einschlie▀en.
  18028.       <DIV
  18029. CLASS="informalexample"
  18030. ><P
  18031. ></P
  18032. ><A
  18033. NAME="AEN3285"
  18034. ></A
  18035. ><TABLE
  18036. BORDER="0"
  18037. BGCOLOR="#E0E0E0"
  18038. CELLPADDING="5"
  18039. ><TR
  18040. ><TD
  18041. ><PRE
  18042. CLASS="php"
  18043. ><?php
  18044. $foo = 10;            // $foo ist ein Integer
  18045. $str = "$foo";        // $str ist ein String
  18046. $fst = (string) $foo; // $fst ist auch ein String
  18047.  
  18048. // Das gibt aus "sie sind gleich"
  18049. if ($fst === $str) {
  18050.     echo "sie sind gleich";
  18051. }
  18052. ?></PRE
  18053. ></TD
  18054. ></TR
  18055. ></TABLE
  18056. ><P
  18057. ></P
  18058. ></DIV
  18059. >
  18060.      </P
  18061. ></BLOCKQUOTE
  18062. ></DIV
  18063. ><P
  18064. >      Es ist nicht immer offenkundig, was bei der Typ-Umwandlung
  18065.      geschieht. Fⁿr weitere Informationen schauen Sie unter folgenden
  18066.      Abschnitten nach:
  18067.      <P
  18068. ></P
  18069. ><UL
  18070. ><LI
  18071. ><P
  18072. >         <A
  18073. HREF="#language.types.boolean.casting"
  18074. >Umwandlung nach
  18075.         boolean</A
  18076. >
  18077.        </P
  18078. ></LI
  18079. ><LI
  18080. ><P
  18081. >         <A
  18082. HREF="#language.types.integer.casting"
  18083. >Umwandlung nach
  18084.         integer</A
  18085. >
  18086.        </P
  18087. ></LI
  18088. ><LI
  18089. ><P
  18090. >         <A
  18091. HREF="#language.types.float.casting"
  18092. >Umwandlung nach
  18093.         float</A
  18094. >
  18095.        </P
  18096. ></LI
  18097. ><LI
  18098. ><P
  18099. >         <A
  18100. HREF="#language.types.string.casting"
  18101. >Umwandlung nach
  18102.         string</A
  18103. >
  18104.        </P
  18105. ></LI
  18106. ><LI
  18107. ><P
  18108. >         <A
  18109. HREF="#language.types.array.casting"
  18110. >Umwandlung nach
  18111.         array</A
  18112. >
  18113.        </P
  18114. ></LI
  18115. ><LI
  18116. ><P
  18117. >         <A
  18118. HREF="#language.types.object.casting"
  18119. >Umwandlung nach
  18120.         object</A
  18121. >
  18122.        </P
  18123. ></LI
  18124. ><LI
  18125. ><P
  18126. >         <A
  18127. HREF="#language.types.resource.casting"
  18128. >Umwandlung
  18129.         nach resource</A
  18130. >
  18131.        </P
  18132. ></LI
  18133. ><LI
  18134. ><P
  18135. >         <A
  18136. HREF="#types.comparisons"
  18137. >PHP type comparison
  18138.         tables</A
  18139. >
  18140.        </P
  18141. ></LI
  18142. ></UL
  18143. >
  18144.     </P
  18145. ></DIV
  18146. ></DIV
  18147. ></DIV
  18148. ><DIV
  18149. CLASS="chapter"
  18150. ><HR><H1
  18151. ><A
  18152. NAME="language.variables"
  18153. >Kapitel 11. Variablen</A
  18154. ></H1
  18155. ><DIV
  18156. CLASS="sect1"
  18157. ><H2
  18158. CLASS="sect1"
  18159. ><A
  18160. NAME="language.variables.basics"
  18161. >Grundlegendes</A
  18162. ></H2
  18163. ><P
  18164. >     Variablen werden in PHP dargestellt durch ein Dollar-Zeichen ($)
  18165.     gefolgt vom Namen der Variablen. Bei Variablen-Namen wird
  18166.     zwischen Gro▀- und Kleinschreibung unterschieden (case-sensitive).
  18167.    </P
  18168. ><P
  18169. >     Variablen-Namen werden in PHP nach den gleichen Regeln wie
  18170.     andere Bezeichner erstellt. Ein gⁿltiger Variablen-Name beginnt
  18171.     mit einem Buchstaben oder einem Unterstrich ("_"), gefolgt von
  18172.     einer beliebigen Anzahl von Buchstaben, Zahlen oder Unterstrichen.
  18173.     Als regulΣrer Ausdruck (regular expression) wⁿrde das wie folgt
  18174.     ausgedrⁿckt: '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*'.
  18175.    </P
  18176. ><DIV
  18177. CLASS="note"
  18178. ><BLOCKQUOTE
  18179. CLASS="note"
  18180. ><P
  18181. ><B
  18182. >Anmerkung: </B
  18183. >
  18184.      Unserem Zweck entspricht also ein Buchstabe von a bis z bzw.
  18185.      A bis Z oder einem ASCII-Zeichen von 127 bis 255 (0x7f bis 0xff).
  18186.     </P
  18187. ></BLOCKQUOTE
  18188. ></DIV
  18189. ><P
  18190. >     <DIV
  18191. CLASS="informalexample"
  18192. ><P
  18193. ></P
  18194. ><A
  18195. NAME="AEN3322"
  18196. ></A
  18197. ><TABLE
  18198. BORDER="0"
  18199. BGCOLOR="#E0E0E0"
  18200. CELLPADDING="5"
  18201. ><TR
  18202. ><TD
  18203. ><PRE
  18204. CLASS="php"
  18205. ><?php
  18206. $var = "Du";
  18207. $vaR = "und";
  18208. $Var = "ich";
  18209. $vAr = "wir lernen PHP"
  18210. echo "$var $vaR $Var, $vAr"; // gibt "Du und ich, wir lernen PHP" aus
  18211.  
  18212. $4site  = 'nicht jetzt';     // ungⁿltig, da Anfang eine Zahl
  18213. $_4site = 'nicht jetzt';     // gⁿltig, da Unterstrich am Anfang
  18214. $tΣbyte = 'irgendwas';       // gⁿltig, da 'Σ' dem (Erweiterten) ASCII-Wert 228 entspricht
  18215. ?></PRE
  18216. ></TD
  18217. ></TR
  18218. ></TABLE
  18219. ><P
  18220. ></P
  18221. ></DIV
  18222. >
  18223.    </P
  18224. ><P
  18225. >     Variablen werden in PHP 3 durch ihren Wert bestimmt. Das heisst,
  18226.     wenn Sie einer Variablen einen Ausdruck zuweisen, wird der gesamte
  18227.     Inhalt des Originalausdrucks in die Zielvariable kopiert. Die
  18228.     Folge ist, dass eine Variable, die ihren Inhalt von einer anderen
  18229.     Variablen erhalten hat, ihren Inhalt behΣlt, auch wenn Sie danach
  18230.     den Inhalt der anderen (Quell- / Ursprungs-)Variablen Σndern. Die
  18231.     Inhalte der Ziel- und Quellvariablen sind also insoweit unabhΣngig
  18232.     voneinander. Fⁿr weitere Informationen lesen Sie bitte das Kapitel
  18233.     unter <A
  18234. HREF="#language.expressions"
  18235. >Expressions / Ausdrⁿcke</A
  18236. >.
  18237.    </P
  18238. ><P
  18239. >     PHP 4 bietet eine andere M÷glichkeit der Wertzuweisung bei
  18240.     Variablen: <A
  18241. HREF="#language.references"
  18242. >Zuweisung durch
  18243.     Referenzierung</A
  18244. >. Das bedeutet, dass der Wert der neuen
  18245.     Variablen eine Referenz zur Ursprungs-Variablen darstellt (mit
  18246.     anderen Worten: Der Wert ist ein Alias bzw. Zeiger auf den Inhalt
  18247.     der Ursprungsvariablen). Beide Variablen zeigen also auf die
  18248.     selbe(n) Speicherstelle(n). ─nderungen der neuen Variablen Σndern
  18249.     auch deren Ursprungs-Variable und umgekehrt. Der Wert / Inhalt
  18250.     wird also nicht kopiert. Die ▄bertragung geschieht dadurch auch
  18251.     schneller als in PHP 3. Dies wird sich aber nur bei umfangreichen
  18252.     Schleifen oder bei der ▄bertragung von grossen <A
  18253. HREF="#language.types.array"
  18254. >Arrays</A
  18255. > oder <A
  18256. HREF="#language.types.object"
  18257. >Objekten</A
  18258. > bemerkbar machen.
  18259.    </P
  18260. ><P
  18261. >     Fⁿr die Zuweisung per Referenz mⁿssen Sie lediglich ein &
  18262.     der (Ausgangs-, Quell-) Variablen voranstellen, die
  18263.     sie einer anderen Variablen zuweisen wollen. Der folgende Skript-
  18264.     Ausschnitt wird zweimal 'Mein Name ist Bob' ausgeben:
  18265.     <DIV
  18266. CLASS="informalexample"
  18267. ><P
  18268. ></P
  18269. ><A
  18270. NAME="AEN3331"
  18271. ></A
  18272. ><TABLE
  18273. BORDER="0"
  18274. BGCOLOR="#E0E0E0"
  18275. CELLPADDING="5"
  18276. ><TR
  18277. ><TD
  18278. ><PRE
  18279. CLASS="php"
  18280. ><?php
  18281. $foo = 'Bob';             // 'Bob' der Variablen $foo zuweisen.
  18282. $bar = &$foo;             // Zeiger auf $foo in $bar erzeugen.
  18283. $bar = "Ich hei&szlig;e $bar";  // $bar verΣndern...
  18284. echo $bar;
  18285. echo $foo;                // $foo wurde dadurch ebenfalls verΣndert.
  18286. ?></PRE
  18287. ></TD
  18288. ></TR
  18289. ></TABLE
  18290. ><P
  18291. ></P
  18292. ></DIV
  18293. >
  18294.    </P
  18295. ><P
  18296. >     Zu beachten ist, dass nur Variablenbezeichner referenziert
  18297.     werden k÷nnen.
  18298.     <DIV
  18299. CLASS="informalexample"
  18300. ><P
  18301. ></P
  18302. ><A
  18303. NAME="AEN3334"
  18304. ></A
  18305. ><TABLE
  18306. BORDER="0"
  18307. BGCOLOR="#E0E0E0"
  18308. CELLPADDING="5"
  18309. ><TR
  18310. ><TD
  18311. ><PRE
  18312. CLASS="php"
  18313. ><?php
  18314. $foo = 25;
  18315. $bar = &$foo;     // Gⁿltige Zuweisung.
  18316. $bar = &(24 * 7); // Ungⁿltig, da kein Variablenbezeichner
  18317.                   // zugewiesen wird.
  18318. function test() {
  18319.     return 25;
  18320. }
  18321.  
  18322. $bar = &test();   // Ungⁿltig.
  18323. ?></PRE
  18324. ></TD
  18325. ></TR
  18326. ></TABLE
  18327. ><P
  18328. ></P
  18329. ></DIV
  18330. >
  18331.    </P
  18332. ></DIV
  18333. ><DIV
  18334. CLASS="sect1"
  18335. ><HR><H2
  18336. CLASS="sect1"
  18337. ><A
  18338. NAME="language.variables.predefined"
  18339. >Vordefinierte Variablen</A
  18340. ></H2
  18341. ><P
  18342. >     PHP bietet jedem ausgefⁿhrtem Skript eine Vielzahl von
  18343.     vordefinierten Variablen an. Viele dieser Variablen k÷nnen
  18344.     jedoch nicht vollstΣndig erlΣutert werden, da sie abhΣngig
  18345.     sind vom Web-Server, der Version und dem Setup des Web-
  18346.     Servers sowie weiteren Faktoren. Einige dieser Variablen
  18347.     stehen nicht zur Verfⁿgung, wenn PHP-Skripte per <A
  18348. HREF="#features.commandline"
  18349. >Kommando-Zeilen-Aufruf</A
  18350. >
  18351.     ausgefⁿhrt werden. Fⁿr eine Liste dieser Variablen lesen Sie bitte
  18352.     den Abschnitt <A
  18353. HREF="#reserved.variables"
  18354. >Vordefinierte
  18355.     Variablen</A
  18356. >.
  18357.    </P
  18358. ><DIV
  18359. CLASS="warning"
  18360. ><P
  18361. ></P
  18362. ><TABLE
  18363. CLASS="warning"
  18364. BORDER="1"
  18365. WIDTH="100%"
  18366. ><TR
  18367. ><TD
  18368. ALIGN="CENTER"
  18369. ><B
  18370. >Warnung</B
  18371. ></TD
  18372. ></TR
  18373. ><TR
  18374. ><TD
  18375. ALIGN="LEFT"
  18376. ><P
  18377. >      Ab PHP 4.2.0 ist der standardmΣ▀ige Wert fⁿr die PHP-Anweisung
  18378.      <A
  18379. HREF="#ini.register-globals"
  18380. >register_globals</A
  18381. >
  18382.      <SPAN
  18383. CLASS="emphasis"
  18384. ><I
  18385. CLASS="emphasis"
  18386. >off</I
  18387. ></SPAN
  18388. >. Dies ist eine wesentliche ─nderung in
  18389.      PHP. Die Anweisung register_globals <SPAN
  18390. CLASS="emphasis"
  18391. ><I
  18392. CLASS="emphasis"
  18393. >off</I
  18394. ></SPAN
  18395. >
  18396.      beeinflusst den Satz von vordefinierten Variablen, die im
  18397.      globalen Bereich verfⁿgbar sind. Um zum Beispiel
  18398.      <VAR
  18399. CLASS="varname"
  18400. >DOCUMENT_ROOT</VAR
  18401. > zu bekommen, mⁿssen Sie
  18402.      <VAR
  18403. CLASS="varname"
  18404. >$_SERVER['DOCUMENT_ROOT']</VAR
  18405. > statt
  18406.      <VAR
  18407. CLASS="varname"
  18408. >$DOCUMENT_ROOT</VAR
  18409. > verwenden oder um
  18410.      <VAR
  18411. CLASS="varname"
  18412. >$id</VAR
  18413. > von der URL
  18414.      <VAR
  18415. CLASS="literal"
  18416. >http://www.example.com/test.php?id=3</VAR
  18417. > zu
  18418.      bekommen <VAR
  18419. CLASS="varname"
  18420. >$_GET['id']</VAR
  18421. > statt
  18422.      <VAR
  18423. CLASS="varname"
  18424. >$id</VAR
  18425. > oder <VAR
  18426. CLASS="varname"
  18427. >$_ENV['HOME']</VAR
  18428. >
  18429.      statt <VAR
  18430. CLASS="varname"
  18431. >$HOME</VAR
  18432. >.
  18433.     </P
  18434. ><P
  18435. >      Fⁿr diese ─nderung betreffende Informationen lesen Sie bitte den
  18436.      Konfigurations-Eintrag fⁿr <A
  18437. HREF="#ini.register-globals"
  18438. >register_globals</A
  18439. >, das
  18440.      Sicherheitskapitel ⁿber die <A
  18441. HREF="#security.registerglobals"
  18442. >Verwendung von Register
  18443.      Globals</A
  18444. > und au▀erdem die PHP
  18445.      <A
  18446. HREF="http://www.php.net/release_4_1_0.php"
  18447. TARGET="_top"
  18448. >4.1.0</A
  18449. > und
  18450.      <A
  18451. HREF="http://www.php.net/release_4_2_0.php"
  18452. TARGET="_top"
  18453. >4.2.0</A
  18454. > Release
  18455.      Announcements.
  18456.     </P
  18457. ><P
  18458. >      Die reservierten vordefinierten Variablen, wie die
  18459.      <A
  18460. HREF="#language.variables.superglobals"
  18461. >Superglobalen
  18462.      Arrays</A
  18463. >, sollten bevorzugt verwendet werden.
  18464.     </P
  18465. ></TD
  18466. ></TR
  18467. ></TABLE
  18468. ></DIV
  18469. ><P
  18470. >     Ab Version 4.1.0 stehen in PHP eine zusΣtzliche Reihe
  18471.     vordefinierter Arrays zur Verfⁿgung, die Variablen vom Webserver
  18472.     (gegebenenfalls), von der Umgebung und von Benutzereingaben
  18473.     enthalten. Diese neuen Arrays sind insofern etwas sehr Spezielles,
  18474.     als sie automatisch global sind -- d.h., sie stehen automatisch in
  18475.     jedem Bereich zur Verfⁿgung. Deshalb sind sie auch bekannt als
  18476.     'Autoglobale' oder 'Superglobale'. (Es gibt in PHP keinen
  18477.     Mechanismus fⁿr benutzerdefinierte Superglobale.) Die Superglobale
  18478.     werden nachfolgend aufgelistet, aber fⁿr eine Liste ihres Inhalts
  18479.     und die weitere Diskussion vordefinierter Variablen und ihres
  18480.     Wesens lesen Sie bitte den Abschnitt <A
  18481. HREF="#reserved.variables"
  18482. >Reservierte vordefinierte
  18483.     Variablen</A
  18484. >. Au▀erdem werden Sie feststellen, dass die alten
  18485.     vordefinierten Variablen (<VAR
  18486. CLASS="varname"
  18487. >$HTTP_*_VARS</VAR
  18488. >) noch
  18489.     existieren.
  18490.  
  18491.     Seit PHP 5.0.0 k÷nnen Sie die
  18492. Registrierung der langen von PHP <A
  18493. HREF="#language.variables.predefined"
  18494. > vordefinierten Arrays</A
  18495. > mit der Konfigurationsoption 
  18496. <A
  18497. HREF="#ini.register-long-arrays"
  18498. >register_long_arrays</A
  18499. >
  18500. abschalten.
  18501.    </P
  18502. ><DIV
  18503. CLASS="note"
  18504. ><BLOCKQUOTE
  18505. CLASS="note"
  18506. ><P
  18507. ><B
  18508. >Variable Variablen: </B
  18509. >
  18510.      Superglobale k÷nnen nicht als <A
  18511. HREF="#language.variables.variable"
  18512. >Variable Variablen</A
  18513. >
  18514.      verwendet werden.
  18515.     </P
  18516. ></BLOCKQUOTE
  18517. ></DIV
  18518. ><P
  18519. >     Falls bestimmte Variablen nicht unter <A
  18520. HREF="#ini.variables-order"
  18521. >variables_order</A
  18522. > angegeben
  18523.     sind, dann bleiben auch ihre entsprechenden vordefinierten Arrays
  18524.     leer.
  18525.    </P
  18526. ><P
  18527. ></P
  18528. ><DIV
  18529. CLASS="variablelist"
  18530. ><P
  18531. ><B
  18532. >PHP Superglobale</B
  18533. ></P
  18534. ><DL
  18535. ><DT
  18536. ><A
  18537. HREF="#reserved.variables.globals"
  18538. >$GLOBALS</A
  18539. ></DT
  18540. ><DD
  18541. ><P
  18542. >        Diese Variable enthΣlt eine Referenz zu jeder Variable, die
  18543.        im globalen Bereich des laufenden Skripts zur Verfⁿgung
  18544.        steht. Die Schlⁿssel dieses Arrays sind die Namen der globalen
  18545.        Variablen. <VAR
  18546. CLASS="varname"
  18547. >$GLOBALS</VAR
  18548. > gibt es seit PHP 3.
  18549.       </P
  18550. ></DD
  18551. ><DT
  18552. ><A
  18553. HREF="#reserved.variables.server"
  18554. >$_SERVER</A
  18555. ></DT
  18556. ><DD
  18557. ><P
  18558. >        Variablen, die vom Webserver gesetzt werden oder anderweitig
  18559.        direkt mit der ausfⁿhrenden Umgebung des aktuellen Skripts
  18560.        zusammenhΣngen. Entspricht dem alten
  18561.        <VAR
  18562. CLASS="varname"
  18563. >$HTTP_SERVER_VARS</VAR
  18564. >-Array, das zwar noch zur
  18565.        Verfⁿgung steht, aber abzulehnen ist.
  18566.       </P
  18567. ></DD
  18568. ><DT
  18569. ><A
  18570. HREF="#reserved.variables.get"
  18571. >$_GET</A
  18572. ></DT
  18573. ><DD
  18574. ><P
  18575. >        Variablen, die dem Skript ⁿber HTTP GET geliefert werden.
  18576.        Entspricht dem alten <VAR
  18577. CLASS="varname"
  18578. >$HTTP_GET_VARS</VAR
  18579. >-Array,
  18580.        das zwar noch zur Verfⁿgung steht, aber abzulehnen ist.
  18581.       </P
  18582. ></DD
  18583. ><DT
  18584. ><A
  18585. HREF="#reserved.variables.post"
  18586. >$_POST</A
  18587. ></DT
  18588. ><DD
  18589. ><P
  18590. >        Variablen, die dem Skript ⁿber HTTP POST geliefert werden.
  18591.        Entspricht dem alten <VAR
  18592. CLASS="varname"
  18593. >$HTTP_POST_VARS</VAR
  18594. >-Array,
  18595.        das zwar noch zur Verfⁿgung steht, aber abzulehnen ist.
  18596.       </P
  18597. ></DD
  18598. ><DT
  18599. ><A
  18600. HREF="#reserved.variables.cookies"
  18601. >$_COOKIE</A
  18602. ></DT
  18603. ><DD
  18604. ><P
  18605. >        Variablen, die dem Skript ⁿber HTTP Cookies geliefert werden.
  18606.        Entspricht dem alten
  18607.        <VAR
  18608. CLASS="varname"
  18609. >$HTTP_COOKIE_VARS</VAR
  18610. >-Array, das zwar noch zur
  18611.        Verfⁿgung steht, aber abzulehnen ist.
  18612.       </P
  18613. ></DD
  18614. ><DT
  18615. ><A
  18616. HREF="#reserved.variables.files"
  18617. >$_FILES</A
  18618. ></DT
  18619. ><DD
  18620. ><P
  18621. >        Variablen, die dem Skript ⁿber HTTP Post Datei-Uploads
  18622.        geliefert werden. Entspricht dem alten
  18623.        <VAR
  18624. CLASS="varname"
  18625. >$HTTP_POST_FILES</VAR
  18626. >-Array, das zwar noch zur
  18627.        Verfⁿgung steht, aber abzulehnen ist. Fⁿr mehr Informationen
  18628.        lesen Sie bitte <A
  18629. HREF="#features.file-upload.post-method"
  18630. >Dateiuploads mit
  18631.        POST</A
  18632. >.
  18633.       </P
  18634. ></DD
  18635. ><DT
  18636. ><A
  18637. HREF="#reserved.variables.environment"
  18638. >$_ENV</A
  18639. ></DT
  18640. ><DD
  18641. ><P
  18642. >        Variablen, die dem Skript ⁿber die Umgebung geliefert werden.
  18643.        Entspricht dem alten <VAR
  18644. CLASS="varname"
  18645. >$HTTP_ENV_VARS</VAR
  18646. >-Array,
  18647.        das zwar noch zur Verfⁿgung steht, aber abzulehnen ist.
  18648.       </P
  18649. ></DD
  18650. ><DT
  18651. ><A
  18652. HREF="#reserved.variables.request"
  18653. >$_REQUEST</A
  18654. ></DT
  18655. ><DD
  18656. ><P
  18657. >        Variablen, die dem Skript ⁿber die GET-, POST- und
  18658.        COOKIE-Eingabemechanismen geliefert werden und von daher nicht
  18659.        vertrauenswⁿrdig sind. Die PrΣsenz und die Reihenfolge der
  18660.        Aufnahme der Variablen in dieses Array ist entsprechend der
  18661.        Konfigurationsanweisung <A
  18662. HREF="#ini.variables-order"
  18663. >variables_order</A
  18664. > definiert.
  18665.        Dieses Array hat in PHP vor Version 4.1.0 keine direkte
  18666.        Entsprechung. Siehe auch
  18667.        <A
  18668. HREF="#function.import-request-variables"
  18669. ><B
  18670. CLASS="function"
  18671. >import_request_variables()</B
  18672. ></A
  18673. >.
  18674.       </P
  18675. ><DIV
  18676. CLASS="caution"
  18677. ><P
  18678. ></P
  18679. ><TABLE
  18680. CLASS="caution"
  18681. BORDER="1"
  18682. WIDTH="100%"
  18683. ><TR
  18684. ><TD
  18685. ALIGN="CENTER"
  18686. ><B
  18687. >Achtung</B
  18688. ></TD
  18689. ></TR
  18690. ><TR
  18691. ><TD
  18692. ALIGN="LEFT"
  18693. ><P
  18694. >         Seit PHP 4.3.0 gibt es in <VAR
  18695. CLASS="varname"
  18696. >$_REQUEST</VAR
  18697. > keine
  18698.         FILE-Informationen von <VAR
  18699. CLASS="varname"
  18700. >$_FILES</VAR
  18701. > mehr.
  18702.        </P
  18703. ></TD
  18704. ></TR
  18705. ></TABLE
  18706. ></DIV
  18707. ><DIV
  18708. CLASS="note"
  18709. ><BLOCKQUOTE
  18710. CLASS="note"
  18711. ><P
  18712. ><B
  18713. >Anmerkung: </B
  18714. >
  18715.         Wenn PHP-Skripte auf der <A
  18716. HREF="#features.commandline"
  18717. >Kommandozeile</A
  18718. > ausgefⁿhrt
  18719.         werden, sind die EintrΣge <VAR
  18720. CLASS="varname"
  18721. >argv</VAR
  18722. > und
  18723.         <VAR
  18724. CLASS="varname"
  18725. >argc</VAR
  18726. > <SPAN
  18727. CLASS="emphasis"
  18728. ><I
  18729. CLASS="emphasis"
  18730. >nicht</I
  18731. ></SPAN
  18732. > in diesem
  18733.         Array enthalten; diese befinden sich im
  18734.         <VAR
  18735. CLASS="varname"
  18736. >$_SERVER</VAR
  18737. >-Array.
  18738.        </P
  18739. ></BLOCKQUOTE
  18740. ></DIV
  18741. ></DD
  18742. ><DT
  18743. ><A
  18744. HREF="#reserved.variables.session"
  18745. >$_SESSION</A
  18746. ></DT
  18747. ><DD
  18748. ><P
  18749. >        Variablen, die aktuell in der Session eines Skripts registriert
  18750.        sind. Entspricht dem alten
  18751.        <VAR
  18752. CLASS="varname"
  18753. >$HTTP_SESSION_VARS</VAR
  18754. >-Array, das zwar noch zur
  18755.        Verfⁿgung steht, aber abzulehnen ist. Fⁿr mehr Informationen
  18756.        lesen Sie bitte den Abschnitt <A
  18757. HREF="#ref.session"
  18758. >Session Funktionen</A
  18759. >.
  18760.       </P
  18761. ></DD
  18762. ></DL
  18763. ></DIV
  18764. ></DIV
  18765. ><DIV
  18766. CLASS="sect1"
  18767. ><HR><H2
  18768. CLASS="sect1"
  18769. ><A
  18770. NAME="language.variables.scope"
  18771. >Geltungsbereich von Variablen</A
  18772. ></H2
  18773. ><P
  18774. >     Der Geltungsbereich einer Variablen ergibt sich aus dem
  18775.     Zusammenhang, in dem sie definiert wurde. Meistens besteht
  18776.     dieser aus einem einzigen Bereich. Dieser beinhaltet auch den
  18777.     Bereich fⁿr Dateien, die per "include"- oder "require"-Anweisung
  18778.     eingebunden wurden, z.B.:
  18779.    </P
  18780. ><DIV
  18781. CLASS="informalexample"
  18782. ><P
  18783. ></P
  18784. ><A
  18785. NAME="AEN3446"
  18786. ></A
  18787. ><TABLE
  18788. BORDER="0"
  18789. BGCOLOR="#E0E0E0"
  18790. CELLPADDING="5"
  18791. ><TR
  18792. ><TD
  18793. ><PRE
  18794. CLASS="php"
  18795. ><?php
  18796. $a = 1;
  18797. include "b.inc";
  18798. ?></PRE
  18799. ></TD
  18800. ></TR
  18801. ></TABLE
  18802. ><P
  18803. ></P
  18804. ></DIV
  18805. ><P
  18806. >     Die Variable $a ist auch in der eingebundenen Datei
  18807.     <TT
  18808. CLASS="filename"
  18809. >b.inc</TT
  18810. > verfⁿgbar. In benutzerdefinierten Funktionen
  18811.     wird ein auf die Funktion beschrΣnkter Geltungsbereich eingefⁿhrt. Jede in
  18812.     einer Funktion benutzte Variable ist zunΣchst auf den lokalen Bereich
  18813.     der Funktion beschrΣnkt, z.B.:
  18814.    </P
  18815. ><DIV
  18816. CLASS="informalexample"
  18817. ><P
  18818. ></P
  18819. ><A
  18820. NAME="AEN3450"
  18821. ></A
  18822. ><TABLE
  18823. BORDER="0"
  18824. BGCOLOR="#E0E0E0"
  18825. CELLPADDING="5"
  18826. ><TR
  18827. ><TD
  18828. ><PRE
  18829. CLASS="php"
  18830. ><?php
  18831. $a = 1; // globaler Bereich
  18832.  
  18833. function test () { 
  18834.     echo $a; // Referenz auf einen lokalen Variablen-Bereich
  18835. } 
  18836.  
  18837. test ();
  18838. ?></PRE
  18839. ></TD
  18840. ></TR
  18841. ></TABLE
  18842. ><P
  18843. ></P
  18844. ></DIV
  18845. ><P
  18846. >     Dieses Skript erzeugt keine Bildschirm-Ausgabe, da sich die Echo-
  18847.     Anweisung auf eine lokale Variable namens <VAR
  18848. CLASS="varname"
  18849. >$a</VAR
  18850. >
  18851.     bezieht und dieser kein Wert im lokalen Bezug zugewiesen worden ist.
  18852.     Dies ist ein kleiner Unterschied zu C, wo globale Variablen auch in
  18853.     Funktionen vorhanden sind, es sei denn, sie werden durch eine
  18854.     funktionsinterne Definition ⁿberschrieben. Das kann zu Problemen fⁿhren,
  18855.     denn in PHP mⁿssen global geltende Variablen innerhalb von Funktionen als
  18856.     solche definiert werden.
  18857.    </P
  18858. ><DIV
  18859. CLASS="sect2"
  18860. ><HR><H3
  18861. CLASS="sect2"
  18862. ><A
  18863. NAME="language.variables.scope.global"
  18864. >Das global Schlⁿsselwort</A
  18865. ></H3
  18866. ><P
  18867. >      ZunΣchst ein Beispiel fⁿr die Verwendung von
  18868.      <VAR
  18869. CLASS="literal"
  18870. >global</VAR
  18871. >:
  18872.     </P
  18873. ><P
  18874. >      <TABLE
  18875. WIDTH="100%"
  18876. BORDER="0"
  18877. CELLPADDING="0"
  18878. CELLSPACING="0"
  18879. CLASS="EXAMPLE"
  18880. ><TR
  18881. ><TD
  18882. ><DIV
  18883. CLASS="example"
  18884. ><A
  18885. NAME="AEN3459"
  18886. ></A
  18887. ><P
  18888. ><B
  18889. >Beispiel 11-1. Die Verwendung von global</B
  18890. ></P
  18891. ><TABLE
  18892. BORDER="0"
  18893. BGCOLOR="#E0E0E0"
  18894. CELLPADDING="5"
  18895. ><TR
  18896. ><TD
  18897. ><PRE
  18898. CLASS="php"
  18899. ><?php
  18900. $a = 1;
  18901. $b = 2;
  18902.  
  18903. function Summe()
  18904. {
  18905.     global $a, $b;
  18906.  
  18907.     $b = $a + $b;
  18908. } 
  18909.  
  18910. Summe();
  18911. echo $b;
  18912. ?></PRE
  18913. ></TD
  18914. ></TR
  18915. ></TABLE
  18916. ></DIV
  18917. ></TD
  18918. ></TR
  18919. ></TABLE
  18920. >
  18921.     </P
  18922. ><P
  18923. >     Das obige Skript gibt "3" aus. Durch das Deklararieren
  18924.     der Variablen <VAR
  18925. CLASS="varname"
  18926. >$a</VAR
  18927. > und <VAR
  18928. CLASS="varname"
  18929. >$b</VAR
  18930. >innerhalb
  18931.     der Funktion als global, weisen alle Referenzen zu beiden Variablen auf
  18932.     die nun globalen Werte. Es gibt keine BeschrΣnkungen bei der Anzahl an
  18933.     globalen Variablen, die durch eine Funktion verΣndert werden k÷nnen.
  18934.    </P
  18935. ><P
  18936. >     Eine weitere M÷glichkeit besteht in der Verwendung des speziellen
  18937.     <VAR
  18938. CLASS="varname"
  18939. >$GLOBALS</VAR
  18940. > PHP-Array. Das obige Beispiel kann damit
  18941.     auch so  geschrieben werden:
  18942.    </P
  18943. ><P
  18944. >     <TABLE
  18945. WIDTH="100%"
  18946. BORDER="0"
  18947. CELLPADDING="0"
  18948. CELLSPACING="0"
  18949. CLASS="EXAMPLE"
  18950. ><TR
  18951. ><TD
  18952. ><DIV
  18953. CLASS="example"
  18954. ><A
  18955. NAME="AEN3468"
  18956. ></A
  18957. ><P
  18958. ><B
  18959. >Beispiel 11-2. 
  18960.       Die Verwendung von <VAR
  18961. CLASS="varname"
  18962. >$GLOBALS</VAR
  18963. > statt global
  18964.      </B
  18965. ></P
  18966. ><TABLE
  18967. BORDER="0"
  18968. BGCOLOR="#E0E0E0"
  18969. CELLPADDING="5"
  18970. ><TR
  18971. ><TD
  18972. ><PRE
  18973. CLASS="php"
  18974. ><?php
  18975. $a = 1;
  18976. $b = 2;
  18977.  
  18978. function Summe()
  18979. {
  18980.     $GLOBALS["b"] = $GLOBALS["a"] + $GLOBALS["b"];
  18981. } 
  18982.  
  18983. Summe();
  18984. echo $b;
  18985. ?></PRE
  18986. ></TD
  18987. ></TR
  18988. ></TABLE
  18989. ></DIV
  18990. ></TD
  18991. ></TR
  18992. ></TABLE
  18993. >
  18994.    </P
  18995. ><P
  18996. >     Das <VAR
  18997. CLASS="varname"
  18998. >$GLOBALS</VAR
  18999. >-Array ist ein assoziatives Array
  19000.     mit dem Bezeichner der globalen Variablen als Schlⁿssel und dem
  19001.     Inhalt dieser Variablen als Wert des Array-Elements. Beachten Sie,
  19002.     dass <VAR
  19003. CLASS="varname"
  19004. >$GLOBALS</VAR
  19005. > in jedem Bereich existiert, weil
  19006.     $GLOBALS eine <A
  19007. HREF="#language.variables.superglobals"
  19008. >Superglobale</A
  19009. > ist.
  19010.     Hier ist ein Beispiel, das die StΣrke von Superglobalen
  19011.     demonstriert:
  19012.    </P
  19013. ><P
  19014. >     <TABLE
  19015. WIDTH="100%"
  19016. BORDER="0"
  19017. CELLPADDING="0"
  19018. CELLSPACING="0"
  19019. CLASS="EXAMPLE"
  19020. ><TR
  19021. ><TD
  19022. ><DIV
  19023. CLASS="example"
  19024. ><A
  19025. NAME="AEN3477"
  19026. ></A
  19027. ><P
  19028. ><B
  19029. >Beispiel 11-3. 
  19030.       Beispiel zur Demonstration von Superglobalen und Bereich
  19031.      </B
  19032. ></P
  19033. ><TABLE
  19034. BORDER="0"
  19035. BGCOLOR="#E0E0E0"
  19036. CELLPADDING="5"
  19037. ><TR
  19038. ><TD
  19039. ><PRE
  19040. CLASS="php"
  19041. ><?php
  19042. function test_global()
  19043. {
  19044.     // Die meisten vordefinierten Variablen sind nicht "super" und
  19045.     // ben÷tigen 'global', um im lokalen Bereich von Funktionen zur
  19046.     // Verfⁿgung zu stehen.
  19047.     global $HTTP_POST_VARS;
  19048.  
  19049.     echo $HTTP_POST_VARS['name'];
  19050.  
  19051.     // Superglobale stehen in jedem Bereich zur Verfⁿgung und
  19052.     // ben÷tigen kein 'global'. Superglobale stehen seit PHP 4.1.0
  19053.     // zur Verfⁿgung.
  19054.     echo $_POST['name'];
  19055. }
  19056. ?></PRE
  19057. ></TD
  19058. ></TR
  19059. ></TABLE
  19060. ></DIV
  19061. ></TD
  19062. ></TR
  19063. ></TABLE
  19064. >
  19065.    </P
  19066. ></DIV
  19067. ><DIV
  19068. CLASS="sect2"
  19069. ><HR><H3
  19070. CLASS="sect2"
  19071. ><A
  19072. NAME="language.variables.scope.static"
  19073. >Die Verwendung von statischen Variablen</A
  19074. ></H3
  19075. ><P
  19076. >     Ein weiterer wichtiger Anwendungszweck von Variablen-Bereichen
  19077.     ist die <SPAN
  19078. CLASS="emphasis"
  19079. ><I
  19080. CLASS="emphasis"
  19081. >static</I
  19082. ></SPAN
  19083. >-Variable. Eine statische
  19084.     Variable existiert nur in einem lokalen Funktions-Bereich, der
  19085.     Wert geht beim Verlassen dieses Bereichs aber nicht verloren.
  19086.     Schauen Sie das folgende Beispiel an:
  19087.    </P
  19088. ><P
  19089. >     <TABLE
  19090. WIDTH="100%"
  19091. BORDER="0"
  19092. CELLPADDING="0"
  19093. CELLSPACING="0"
  19094. CLASS="EXAMPLE"
  19095. ><TR
  19096. ><TD
  19097. ><DIV
  19098. CLASS="example"
  19099. ><A
  19100. NAME="AEN3485"
  19101. ></A
  19102. ><P
  19103. ><B
  19104. >Beispiel 11-4. 
  19105.       Beispiel, das die Notwendigkeit von statischen Variablen
  19106.       demonstriert
  19107.      </B
  19108. ></P
  19109. ><TABLE
  19110. BORDER="0"
  19111. BGCOLOR="#E0E0E0"
  19112. CELLPADDING="5"
  19113. ><TR
  19114. ><TD
  19115. ><PRE
  19116. CLASS="php"
  19117. ><?php
  19118. function test ()
  19119. {
  19120.     $a = 0;
  19121.     echo $a;
  19122.     $a++;
  19123. }
  19124. ?></PRE
  19125. ></TD
  19126. ></TR
  19127. ></TABLE
  19128. ></DIV
  19129. ></TD
  19130. ></TR
  19131. ></TABLE
  19132. >
  19133.    </P
  19134. ><P
  19135. >     Diese Funktion ist sinnlos, da sie bei jedem Aufruf <VAR
  19136. CLASS="varname"
  19137. >$a</VAR
  19138. >
  19139.     auf <VAR
  19140. CLASS="literal"
  19141. >0</VAR
  19142. > setzt und "0" ausgibt. Die Anweisung
  19143.     $a++, welche den Wert erh÷ht, macht keinen Sinn, da der Wert von
  19144.     <VAR
  19145. CLASS="varname"
  19146. >$a</VAR
  19147. > beim Verlassen der Funktion verloren geht. Um eine
  19148.     sinnvolle ZΣhlfunktion zu implementieren, die ihren aktuell gesetzten Wert
  19149.     nicht vergisst, mⁿssen Sie die Variable <VAR
  19150. CLASS="varname"
  19151. >$a</VAR
  19152. >als "static"
  19153.     deklarieren:
  19154.    </P
  19155. ><P
  19156. >     <TABLE
  19157. WIDTH="100%"
  19158. BORDER="0"
  19159. CELLPADDING="0"
  19160. CELLSPACING="0"
  19161. CLASS="EXAMPLE"
  19162. ><TR
  19163. ><TD
  19164. ><DIV
  19165. CLASS="example"
  19166. ><A
  19167. NAME="AEN3494"
  19168. ></A
  19169. ><P
  19170. ><B
  19171. >Beispiel 11-5. Beispiel zur Verwendung statischer Variablen</B
  19172. ></P
  19173. ><TABLE
  19174. BORDER="0"
  19175. BGCOLOR="#E0E0E0"
  19176. CELLPADDING="5"
  19177. ><TR
  19178. ><TD
  19179. ><PRE
  19180. CLASS="php"
  19181. ><?php
  19182. function Test()
  19183. {
  19184.     static $a = 0;
  19185.     echo $a;
  19186.     $a++;
  19187. }
  19188. ?></PRE
  19189. ></TD
  19190. ></TR
  19191. ></TABLE
  19192. ></DIV
  19193. ></TD
  19194. ></TR
  19195. ></TABLE
  19196. >
  19197.    </P
  19198. ><P
  19199. >     Jetzt wird bei jedem Aufruf der Test()-Funktion der aktuelle
  19200.     Wert von <VAR
  19201. CLASS="varname"
  19202. >$a</VAR
  19203. > ausgegeben und dann um 1 erh÷ht.
  19204.    </P
  19205. ><P
  19206. >     Static-Variablen erm÷glichen auch einen Weg zum Umgang mit
  19207.     rekursiven Funktionen. Das sind Funktionen, die sich selbst
  19208.     aufrufen. Hierbei besteht die Gefahr, so genannte Endlos-
  19209.     Schleifen zu programmieren. Sie mⁿssen also einen Weg vorsehen,
  19210.     diese Rekursion zu beenden. Die folgende einfache Funktion zΣhlt
  19211.     rekursiv bis 10. Die statische Variable
  19212.     <VAR
  19213. CLASS="varname"
  19214. >$zaehler</VAR
  19215. > wird benutzt, um die Rekursion zu
  19216.     beenden:
  19217.    </P
  19218. ><P
  19219. >     <TABLE
  19220. WIDTH="100%"
  19221. BORDER="0"
  19222. CELLPADDING="0"
  19223. CELLSPACING="0"
  19224. CLASS="EXAMPLE"
  19225. ><TR
  19226. ><TD
  19227. ><DIV
  19228. CLASS="example"
  19229. ><A
  19230. NAME="AEN3502"
  19231. ></A
  19232. ><P
  19233. ><B
  19234. >Beispiel 11-6. Statische Variablen in rekursiven Funktionen</B
  19235. ></P
  19236. ><TABLE
  19237. BORDER="0"
  19238. BGCOLOR="#E0E0E0"
  19239. CELLPADDING="5"
  19240. ><TR
  19241. ><TD
  19242. ><PRE
  19243. CLASS="php"
  19244. ><?php
  19245. function Test()
  19246. {
  19247.     static $zaehler = 0;
  19248.  
  19249.     $zaehler++;
  19250.     echo $zaehler;
  19251.     if ($zaehler < 10) {
  19252.         Test ();
  19253.     }
  19254.     $zaehler--;
  19255. }
  19256. ?></PRE
  19257. ></TD
  19258. ></TR
  19259. ></TABLE
  19260. ></DIV
  19261. ></TD
  19262. ></TR
  19263. ></TABLE
  19264. >
  19265.    </P
  19266. ><DIV
  19267. CLASS="note"
  19268. ><BLOCKQUOTE
  19269. CLASS="note"
  19270. ><P
  19271. ><B
  19272. >Anmerkung: </B
  19273. >  
  19274.       Statische Variablen werden wie in oben stehenden Beispielen deklariert. 
  19275.       Das Zuweisen eines Wertes, welcher das Ergebnis eines Ausdrucks ist,
  19276.       wird mit einem parse error quittiert.
  19277.     </P
  19278. ><P
  19279. >  
  19280.      <TABLE
  19281. WIDTH="100%"
  19282. BORDER="0"
  19283. CELLPADDING="0"
  19284. CELLSPACING="0"
  19285. CLASS="EXAMPLE"
  19286. ><TR
  19287. ><TD
  19288. ><DIV
  19289. CLASS="example"
  19290. ><A
  19291. NAME="AEN3508"
  19292. ></A
  19293. ><P
  19294. ><B
  19295. >Beispiel 11-7. Statische Variablen deklarieren</B
  19296. ></P
  19297. ><TABLE
  19298. BORDER="0"
  19299. BGCOLOR="#E0E0E0"
  19300. CELLPADDING="5"
  19301. ><TR
  19302. ><TD
  19303. ><PRE
  19304. CLASS="php"
  19305. ><?php
  19306. function foo(){
  19307.     static $int = 0;          // korrekt
  19308.     static $int = 1+2;        // falsch  (da ein Ausdruck vorliegt)
  19309.     static $int = sqrt(121);  // falsch  (ebenfalls ein Ausdruck)
  19310.  
  19311.     $int++;
  19312.     echo $int;
  19313. }
  19314. ?></PRE
  19315. ></TD
  19316. ></TR
  19317. ></TABLE
  19318. ></DIV
  19319. ></TD
  19320. ></TR
  19321. ></TABLE
  19322. >
  19323.    </P
  19324. ></BLOCKQUOTE
  19325. ></DIV
  19326. ></DIV
  19327. ><DIV
  19328. CLASS="sect2"
  19329. ><HR><H3
  19330. CLASS="sect2"
  19331. ><A
  19332. NAME="language.variables.scope.references"
  19333. >Referenzen bei globalen und statischen Variablen</A
  19334. ></H3
  19335. ><P
  19336. >     Die Zend Engine 1, die <VAR
  19337. CLASS="literal"
  19338. >PHP 4</VAR
  19339. > zugrunde liegt,
  19340.     fⁿhrt die <A
  19341. HREF="#language.variables.scope.static"
  19342. >static</A
  19343. >- und
  19344.     <A
  19345. HREF="#language.variables.scope.global"
  19346. >global</A
  19347. >-Wandler
  19348.     fⁿr Variablen in Bezug auf <A
  19349. HREF="#language.references"
  19350. >Referenzen</A
  19351. > aus. Zum Beispiel
  19352.     erzeugt eine echte globale Variable, die mit der Anweisung
  19353.     <VAR
  19354. CLASS="literal"
  19355. >global</VAR
  19356. > in den Funktionsbereich importiert
  19357.     wurde, tatsΣchlich eine Referenz zur globalen Variable. Das kann
  19358.     zu einem unerwarteten Verhalten fⁿhren, auf das im folgenden
  19359.     Beispiel eingegangen wird:
  19360.    </P
  19361. ><DIV
  19362. CLASS="informalexample"
  19363. ><P
  19364. ></P
  19365. ><A
  19366. NAME="AEN3519"
  19367. ></A
  19368. ><TABLE
  19369. BORDER="0"
  19370. BGCOLOR="#E0E0E0"
  19371. CELLPADDING="5"
  19372. ><TR
  19373. ><TD
  19374. ><PRE
  19375. CLASS="php"
  19376. ><?php
  19377. function test_global_ref() {
  19378.     global $obj;
  19379.     $obj = &new stdclass;
  19380. }
  19381.  
  19382. function test_global_noref() {
  19383.     global $obj;
  19384.     $obj = new stdclass;
  19385. }
  19386.  
  19387. test_global_ref();
  19388. var_dump($obj);
  19389. test_global_noref();
  19390. var_dump($obj);
  19391. ?></PRE
  19392. ></TD
  19393. ></TR
  19394. ></TABLE
  19395. ><P
  19396. ></P
  19397. ></DIV
  19398. ><P
  19399. >     Die Ausfⁿhrung dieses Beispiels erzeugt die folgende Ausgabe:
  19400.    </P
  19401. ><TABLE
  19402. BORDER="0"
  19403. BGCOLOR="#E0E0E0"
  19404. CELLPADDING="5"
  19405. ><TR
  19406. ><TD
  19407. ><PRE
  19408. CLASS="screen"
  19409. >NULL
  19410. object(stdClass)(0) {
  19411. }</PRE
  19412. ></TD
  19413. ></TR
  19414. ></TABLE
  19415. ><P
  19416. >     Ein Σhnliches Verhalten gilt auch fⁿr die Anweisung
  19417.     <VAR
  19418. CLASS="literal"
  19419. >static</VAR
  19420. >. Referenzen werden nicht statisch
  19421.     gespeichert:
  19422.    </P
  19423. ><DIV
  19424. CLASS="informalexample"
  19425. ><P
  19426. ></P
  19427. ><A
  19428. NAME="AEN3525"
  19429. ></A
  19430. ><TABLE
  19431. BORDER="0"
  19432. BGCOLOR="#E0E0E0"
  19433. CELLPADDING="5"
  19434. ><TR
  19435. ><TD
  19436. ><PRE
  19437. CLASS="php"
  19438. ><?php
  19439. function &get_instance_ref() {
  19440.     static $obj;
  19441.  
  19442.     echo "Statisches Objekt: ";
  19443.     var_dump($obj);
  19444.    if (!isset($obj)) {
  19445.         // Der statischen Variablen eine Referenz zuweisen
  19446.         $obj = &new stdclass;
  19447.     }
  19448.     $obj->eigenschaft++;
  19449.     return $obj;
  19450. }
  19451.  
  19452. function &get_instance_noref() {
  19453.     static $obj;
  19454.  
  19455.     echo "Statisches Objekt: ";
  19456.     var_dump($obj);
  19457.     if (!isset($obj)) {
  19458.         // Der statischen Variablen ein Objekt zuweisen
  19459.         $obj = new stdclass;
  19460.     }
  19461.     $obj->eigenschaft++;
  19462.     return $obj;
  19463. }
  19464.  
  19465. $obj1 = get_instance_ref();
  19466. $immer_noch_obj1 = get_instance_ref();
  19467. echo "\n";
  19468. $obj2 = get_instance_noref();
  19469. $immer_noch_obj2 = get_instance_noref();
  19470. ?></PRE
  19471. ></TD
  19472. ></TR
  19473. ></TABLE
  19474. ><P
  19475. ></P
  19476. ></DIV
  19477. ><P
  19478. >     Die Ausfⁿhrung dieses Beispiels erzeugt die folgende Ausgabe:
  19479.    </P
  19480. ><TABLE
  19481. BORDER="0"
  19482. BGCOLOR="#E0E0E0"
  19483. CELLPADDING="5"
  19484. ><TR
  19485. ><TD
  19486. ><PRE
  19487. CLASS="screen"
  19488. >Statisches Objekt: NULL
  19489. Statisches Objekt: NULL
  19490.  
  19491. Statisches Objekt: NULL
  19492. Statisches Objekt: object(stdClass)(1) {
  19493.   ["eigenschaft"]=>
  19494.   int(1)
  19495. }</PRE
  19496. ></TD
  19497. ></TR
  19498. ></TABLE
  19499. ><P
  19500. >     Dieses Beispiel demonstriert, dass die Referenz, die einer
  19501.     statischen Variablen zugewiesen wird, beim zweiten Aufruf der
  19502.     Funktion <VAR
  19503. CLASS="literal"
  19504. >&get_instance_ref()</VAR
  19505. > vergessen ist.
  19506.    </P
  19507. ></DIV
  19508. ></DIV
  19509. ><DIV
  19510. CLASS="sect1"
  19511. ><HR><H2
  19512. CLASS="sect1"
  19513. ><A
  19514. NAME="language.variables.variable"
  19515. >Variable Variablen</A
  19516. ></H2
  19517. ><P
  19518. >     Manchmal ist es komfortabel, variable Variablen-Bezeichner zu
  19519.     benutzen. Das bedeutet, einen Variablen-Namen zu setzen und
  19520.     dynamisch zu gebrauchen. Eine normale Variable wird wie folgt
  19521.     gebildet:
  19522.    </P
  19523. ><DIV
  19524. CLASS="informalexample"
  19525. ><P
  19526. ></P
  19527. ><A
  19528. NAME="AEN3534"
  19529. ></A
  19530. ><TABLE
  19531. BORDER="0"
  19532. BGCOLOR="#E0E0E0"
  19533. CELLPADDING="5"
  19534. ><TR
  19535. ><TD
  19536. ><PRE
  19537. CLASS="php"
  19538. ><?php
  19539. $a = "Hallo";
  19540. ?></PRE
  19541. ></TD
  19542. ></TR
  19543. ></TABLE
  19544. ><P
  19545. ></P
  19546. ></DIV
  19547. ><P
  19548. >     Eine variable Variable nimmt den Wert einer Variablen und
  19549.     behandelt ihn als Bezeichner der Variablen. Im obigen Beispiel
  19550.     kann <SPAN
  19551. CLASS="emphasis"
  19552. ><I
  19553. CLASS="emphasis"
  19554. >Hallo</I
  19555. ></SPAN
  19556. > als Variablen-Name gebraucht
  19557.     werden, indem man zwei $-Zeichen benutzt, also schreibt:
  19558.    </P
  19559. ><DIV
  19560. CLASS="informalexample"
  19561. ><P
  19562. ></P
  19563. ><A
  19564. NAME="AEN3538"
  19565. ></A
  19566. ><TABLE
  19567. BORDER="0"
  19568. BGCOLOR="#E0E0E0"
  19569. CELLPADDING="5"
  19570. ><TR
  19571. ><TD
  19572. ><PRE
  19573. CLASS="php"
  19574. ><?php
  19575. $$a = "Welt";
  19576. ?></PRE
  19577. ></TD
  19578. ></TR
  19579. ></TABLE
  19580. ><P
  19581. ></P
  19582. ></DIV
  19583. ><P
  19584. >     Nun existieren in der PHP-Symbol-Struktur zwei definierte und
  19585.     gespeicherte Variablen: <VAR
  19586. CLASS="varname"
  19587. >$a</VAR
  19588. > mit dem Inhalt "Hallo"
  19589.     und <VAR
  19590. CLASS="varname"
  19591. >$Hallo</VAR
  19592. > mit dem Inhalt "Welt". Deshalb wird die
  19593.     Anweisung
  19594.    </P
  19595. ><DIV
  19596. CLASS="informalexample"
  19597. ><P
  19598. ></P
  19599. ><A
  19600. NAME="AEN3543"
  19601. ></A
  19602. ><TABLE
  19603. BORDER="0"
  19604. BGCOLOR="#E0E0E0"
  19605. CELLPADDING="5"
  19606. ><TR
  19607. ><TD
  19608. ><PRE
  19609. CLASS="php"
  19610. ><?php
  19611. echo "$a ${$a}";
  19612. ?></PRE
  19613. ></TD
  19614. ></TR
  19615. ></TABLE
  19616. ><P
  19617. ></P
  19618. ></DIV
  19619. ><P
  19620. >     zur genau gleichen Ausgabe fⁿhren wie:
  19621.    </P
  19622. ><DIV
  19623. CLASS="informalexample"
  19624. ><P
  19625. ></P
  19626. ><A
  19627. NAME="AEN3546"
  19628. ></A
  19629. ><TABLE
  19630. BORDER="0"
  19631. BGCOLOR="#E0E0E0"
  19632. CELLPADDING="5"
  19633. ><TR
  19634. ><TD
  19635. ><PRE
  19636. CLASS="programlisting"
  19637. ><?php
  19638. echo "$a $Hallo";
  19639. ?></PRE
  19640. ></TD
  19641. ></TR
  19642. ></TABLE
  19643. ><P
  19644. ></P
  19645. ></DIV
  19646. ><P
  19647. >     also zu: <SAMP
  19648. CLASS="computeroutput"
  19649. >Hallo Welt</SAMP
  19650. >.
  19651.    </P
  19652. ><P
  19653. >     Wenn Sie variable Variablen mit Arrays verwenden, mⁿssen Sie eine
  19654.     Doppeldeutigkeit beachten. Wenn Sie nΣmlich
  19655.     <VAR
  19656. CLASS="varname"
  19657. >$$a[1]</VAR
  19658. > schreiben, dann muss der Parser wissen,
  19659.     ob Sie <VAR
  19660. CLASS="varname"
  19661. >$a[1]</VAR
  19662. > als Variable oder
  19663.     <VAR
  19664. CLASS="varname"
  19665. >$$a</VAR
  19666. > als Variable und dann [1] als Index dieser
  19667.     Variablen verwenden wollen bzw. gemeint haben. Die Syntax zur
  19668.     L÷sung dieser Doppeldeutigkeit: Verwenden Sie im ersten Fall
  19669.     <VAR
  19670. CLASS="varname"
  19671. >${$a[1]}</VAR
  19672. > und im zweiten Fall
  19673.     <VAR
  19674. CLASS="varname"
  19675. >${$a}[1]</VAR
  19676. >.
  19677.    </P
  19678. ><DIV
  19679. CLASS="warning"
  19680. ><P
  19681. ></P
  19682. ><TABLE
  19683. CLASS="warning"
  19684. BORDER="1"
  19685. WIDTH="100%"
  19686. ><TR
  19687. ><TD
  19688. ALIGN="CENTER"
  19689. ><B
  19690. >Warnung</B
  19691. ></TD
  19692. ></TR
  19693. ><TR
  19694. ><TD
  19695. ALIGN="LEFT"
  19696. ><P
  19697. >      Bitte beachten Sie, dass variable Variablen nicht bei <A
  19698. HREF="#language.variables.superglobals"
  19699. >Superglobalen
  19700.      Arrays</A
  19701. > verwendet werden k÷nnen. Das bedeutet, etwas wie
  19702.      <VAR
  19703. CLASS="varname"
  19704. >${$_GET}</VAR
  19705. > ist nicht m÷glich. Wenn Sie nach
  19706.      einer M÷glichkeit suchen, die Verfⁿgbarkeit von Superglobalen und
  19707.      den alten <VAR
  19708. CLASS="varname"
  19709. >HTTP_*_VARS</VAR
  19710. > zu handhaben, k÷nnen Sie
  19711.      das mit <A
  19712. HREF="#language.references"
  19713. >referenzieren</A
  19714. >
  19715.      versuchen.
  19716.     </P
  19717. ></TD
  19718. ></TR
  19719. ></TABLE
  19720. ></DIV
  19721. ></DIV
  19722. ><DIV
  19723. CLASS="sect1"
  19724. ><HR><H2
  19725. CLASS="sect1"
  19726. ><A
  19727. NAME="language.variables.external"
  19728. >Variablen ausserhalb von PHP</A
  19729. ></H2
  19730. ><DIV
  19731. CLASS="sect2"
  19732. ><H3
  19733. CLASS="sect2"
  19734. ><A
  19735. NAME="language.variables.external.form"
  19736. >HTML-Formulare (GET and POST)</A
  19737. ></H3
  19738. ><P
  19739. >      Sobald ein Formular an ein PHP-Skript ⁿbergeben wird, werden die
  19740.      Informationen dieses Formulars dem Skript automatisch verfⁿgbar
  19741.      gemacht. Es gibt viele M÷glichkeiten, auf diese Informationen
  19742.      zuzugreifen, zum Beispiel:
  19743.     </P
  19744. ><P
  19745. >      <TABLE
  19746. WIDTH="100%"
  19747. BORDER="0"
  19748. CELLPADDING="0"
  19749. CELLSPACING="0"
  19750. CLASS="EXAMPLE"
  19751. ><TR
  19752. ><TD
  19753. ><DIV
  19754. CLASS="example"
  19755. ><A
  19756. NAME="AEN3568"
  19757. ></A
  19758. ><P
  19759. ><B
  19760. >Beispiel 11-8. Ein einfaches HTML-Formular</B
  19761. ></P
  19762. ><TABLE
  19763. BORDER="0"
  19764. BGCOLOR="#E0E0E0"
  19765. CELLPADDING="5"
  19766. ><TR
  19767. ><TD
  19768. ><PRE
  19769. CLASS="html"
  19770. ><form action="foo.php" method="post">
  19771.     Name:  <input type="text" name="username" /><br />
  19772.     Email: <input type="text" name="email" /><br />
  19773.     <input type="submit" name="submit" value="Und ab!" />
  19774. </form></PRE
  19775. ></TD
  19776. ></TR
  19777. ></TABLE
  19778. ></DIV
  19779. ></TD
  19780. ></TR
  19781. ></TABLE
  19782. >
  19783.     </P
  19784. ><P
  19785. >      AbhΣngig von Ihrem speziellen Setup und Ihren pers÷nlichen
  19786.      Vorlieben gibt es viele M÷glichkeiten, auf die Daten von Ihren
  19787.      HTML-Formularen zuzugreifen. Hier einige Beispiele:
  19788.     </P
  19789. ><P
  19790. >      <TABLE
  19791. WIDTH="100%"
  19792. BORDER="0"
  19793. CELLPADDING="0"
  19794. CELLSPACING="0"
  19795. CLASS="EXAMPLE"
  19796. ><TR
  19797. ><TD
  19798. ><DIV
  19799. CLASS="example"
  19800. ><A
  19801. NAME="AEN3573"
  19802. ></A
  19803. ><P
  19804. ><B
  19805. >Beispiel 11-9. 
  19806.        Zugriff auf die Daten von einem einfachen POST HTML-Formular
  19807.       </B
  19808. ></P
  19809. ><TABLE
  19810. BORDER="0"
  19811. BGCOLOR="#E0E0E0"
  19812. CELLPADDING="5"
  19813. ><TR
  19814. ><TD
  19815. ><PRE
  19816. CLASS="html"
  19817. ><?php
  19818. // Seit PHP 4.1.0 verfⁿgbar
  19819.  
  19820.    echo $_POST['benutzername'];
  19821.    echo $_REQUEST['benutzername'];
  19822.  
  19823.    import_request_variables('p', 'p_');
  19824.    echo $p_benutzername;
  19825.  
  19826. // Seit PHP 3 verfⁿgbar. Ab PHP 5.0.0 k÷nnen diese langen
  19827. // vordefinierten Variablen mit der Anweisung register_long_arrays
  19828. // deaktiviert werden.
  19829.  
  19830.    echo $HTTP_POST_VARS['benutzername'];
  19831.  
  19832. // Verfⁿgbar, falls die PHP-Anweisung register_globals = on. Ab
  19833. // PHP 4.2.0 ist der standardmΣ▀ige Wert von register_globals = off.
  19834. // Es ist nicht empfehlenswert, diese Methode zu verwenden, bzw. sich
  19835. // darauf zu verlassen.
  19836.  
  19837.    echo $benutzername;
  19838. ?></PRE
  19839. ></TD
  19840. ></TR
  19841. ></TABLE
  19842. ></DIV
  19843. ></TD
  19844. ></TR
  19845. ></TABLE
  19846. >
  19847.    </P
  19848. ><P
  19849. >     Die Verwendung eines GET Formulars ist, davon abgesehen, dass Sie
  19850.     stattdessen die entsprechende vordefinierte GET-Variable erhalten,
  19851.     Σhnlich. Au▀erdem wird GET auch fⁿr den QUERY_STRING (die
  19852.     Information nach dem '?' in einer URL) verwendet. So enthΣlt zum
  19853.     Beispiel <VAR
  19854. CLASS="literal"
  19855. >http://www.example.com/test.php?id=3</VAR
  19856. >
  19857.     GET-Daten, auf die mit <VAR
  19858. CLASS="varname"
  19859. >$_GET['id']</VAR
  19860. > zugegriffen
  19861.     werden kann. Siehe auch <A
  19862. HREF="#reserved.variables.request"
  19863. >$_REQUEST</A
  19864. > und
  19865.     <A
  19866. HREF="#function.import-request-variables"
  19867. ><B
  19868. CLASS="function"
  19869. >import_request_variables()</B
  19870. ></A
  19871. >.
  19872.    </P
  19873. ><DIV
  19874. CLASS="note"
  19875. ><BLOCKQUOTE
  19876. CLASS="note"
  19877. ><P
  19878. ><B
  19879. >Anmerkung: </B
  19880. >
  19881.      <A
  19882. HREF="#language.variables.superglobals"
  19883. >Superglobale
  19884.      Arrays</A
  19885. > wie <VAR
  19886. CLASS="varname"
  19887. >$_POST</VAR
  19888. > und
  19889.      <VAR
  19890. CLASS="varname"
  19891. >$_GET</VAR
  19892. > stehen seit PHP 4.1.0 zur Verfⁿgung.
  19893.     </P
  19894. ></BLOCKQUOTE
  19895. ></DIV
  19896. ><P
  19897. >     Wie gezeigt, war <A
  19898. HREF="#ini.register-globals"
  19899. >register_globals</A
  19900. > vor PHP
  19901.     4.2.0 standardmΣ▀ig <SPAN
  19902. CLASS="emphasis"
  19903. ><I
  19904. CLASS="emphasis"
  19905. >on</I
  19906. ></SPAN
  19907. >. In PHP 3 war es immer
  19908.     aktiviert. Die PHP-Gemeinschaft ermuntert alle, sich nicht auf
  19909.     diese Anweisung zu stⁿtzen, weil es vorzuziehen ist, davon
  19910.     auszugehen, dass sie <SPAN
  19911. CLASS="emphasis"
  19912. ><I
  19913. CLASS="emphasis"
  19914. >off</I
  19915. ></SPAN
  19916. > ist und entsprechend
  19917.     zu programmieren.
  19918.    </P
  19919. ><DIV
  19920. CLASS="note"
  19921. ><BLOCKQUOTE
  19922. CLASS="note"
  19923. ><P
  19924. ><B
  19925. >Anmerkung: </B
  19926. >
  19927.      Die Konfigurationseinstellung zu <A
  19928. HREF="#ini.magic-quotes-gpc"
  19929. >magic_quotes_gpc</A
  19930. > betrifft
  19931.      Get-, Post- und Cookie-Werte. Ist diese Einstellung aktiv, wird
  19932.      der Wert (It's "PHP!") automatisch zu (It\'s \"PHP!\"). Escaping
  19933.      ist notwendig, wenn Sie ihre Daten in eine Datenbank einfⁿgen
  19934.      wollen. Siehe auch <A
  19935. HREF="#function.addslashes"
  19936. ><B
  19937. CLASS="function"
  19938. >addslashes()</B
  19939. ></A
  19940. >,
  19941.      <A
  19942. HREF="#function.stripslashes"
  19943. ><B
  19944. CLASS="function"
  19945. >stripslashes()</B
  19946. ></A
  19947. > und <A
  19948. HREF="#ini.magic-quotes-sybase"
  19949. >magic_quotes_sybase</A
  19950. >.
  19951.     </P
  19952. ></BLOCKQUOTE
  19953. ></DIV
  19954. ><P
  19955. >     Im Zusammenhang mit Formular-Variablen versteht PHP auch
  19956.     Arrays (siehe auch die <A
  19957. HREF="#faq.html"
  19958. >verwandte Faq</A
  19959. >).
  19960.     Sie k÷nnen z.B. die betreffenden Variablen gruppieren oder dieses
  19961.     Leistungsmerkmal nutzen, um Werte aus Mehrfach-Auswahl-Bereichen
  19962.     zu erhalten. Schicken wir zum Beispiel ein Formular an sich selbst
  19963.     und lassen nach dem Abschicken die Daten anzeigen:
  19964.    </P
  19965. ><P
  19966. >     <TABLE
  19967. WIDTH="100%"
  19968. BORDER="0"
  19969. CELLPADDING="0"
  19970. CELLSPACING="0"
  19971. CLASS="EXAMPLE"
  19972. ><TR
  19973. ><TD
  19974. ><DIV
  19975. CLASS="example"
  19976. ><A
  19977. NAME="AEN3599"
  19978. ></A
  19979. ><P
  19980. ><B
  19981. >Beispiel 11-10. Komplexere Formular-Variablen</B
  19982. ></P
  19983. ><TABLE
  19984. BORDER="0"
  19985. BGCOLOR="#E0E0E0"
  19986. CELLPADDING="5"
  19987. ><TR
  19988. ><TD
  19989. ><PRE
  19990. CLASS="php"
  19991. ><?php
  19992. if (isset($_POST['action']) && $_POST['action'] == 'abgeschickt') {
  19993.     echo '<pre>';
  19994.     print_r($_POST);
  19995.     echo '<a href="'. $_SERVER['PHP_SELF'] .'">Bitte versuchen Sie es nochmal</a>';
  19996.  
  19997.     echo '</pre>';
  19998. } else {
  19999. ?>
  20000. <form action="<?php echo $_SERVER['PHP_SELF']; ?>" method="post">
  20001.     Name:  <input type="text" name="personal[name]" /><br />
  20002.     Email: <input type="text" name="personal[email]" /><br />
  20003.     Bier: <br />
  20004.     <select multiple name="bier[]">
  20005.         <option value="warthog">Warthog</option>
  20006.         <option value="guinness">Guinness</option>
  20007.         <option value="stuttgarter">Stuttgarter SchwabenbrΣu</option>
  20008.     </select><br />
  20009.     <input type="hidden" name="action" value="abgeschickt" />
  20010.     <input type="submit" name="submit" value="Und ab!" />
  20011. </form>
  20012. <?php
  20013. }
  20014. ?></PRE
  20015. ></TD
  20016. ></TR
  20017. ></TABLE
  20018. ></DIV
  20019. ></TD
  20020. ></TR
  20021. ></TABLE
  20022. >
  20023.     </P
  20024. ><P
  20025. >      In PHP 3 ist die Verwendung von Arrays in Formularvariablen auf
  20026.      eindimensionale Arrays beschrΣnkt. In PHP 4 besteht diese EinschrΣnkung
  20027.      nicht mehr.
  20028.     </P
  20029. ><DIV
  20030. CLASS="sect3"
  20031. ><HR><H4
  20032. CLASS="sect3"
  20033. ><A
  20034. NAME="language.variables.external.form.submit"
  20035. >IMAGE SUBMIT Variablen-Bezeichner</A
  20036. ></H4
  20037. ><P
  20038. >       Zur ▄bertragung eines Formulars kann auch ein Bild (Image)
  20039.       statt eines ▄bertragungs-Schalters (Submit-Button) benutzt
  20040.       werden, dessen Tag wie folgt aussieht:
  20041.      </P
  20042. ><DIV
  20043. CLASS="informalexample"
  20044. ><P
  20045. ></P
  20046. ><A
  20047. NAME="AEN3606"
  20048. ></A
  20049. ><TABLE
  20050. BORDER="0"
  20051. BGCOLOR="#E0E0E0"
  20052. CELLPADDING="5"
  20053. ><TR
  20054. ><TD
  20055. ><PRE
  20056. CLASS="html"
  20057. ><input type="image" src="image.gif" name="sub" /></PRE
  20058. ></TD
  20059. ></TR
  20060. ></TABLE
  20061. ><P
  20062. ></P
  20063. ></DIV
  20064. ><P
  20065. >       Klickt der Benutzer irgendwo auf das Bild, wird das
  20066.       entsprechende Formular an den Web-Server ⁿbertragen. Hierbei
  20067.       sind zwei zusΣtzliche Variablen vorhanden, sub_x und sub_y.
  20068.       Diese enthalten die Koordinaten des Klick-Punktes innerhalb des
  20069.       Bildes. Die Erfahreneren werden sagen, dass die Variablen, die
  20070.       vom Browser gesendet werden einen Punkt enthalten statt eines
  20071.       Unterstrichs. Dieser Punkt wird von PHP automatisch in einen
  20072.       Unterstrich verwandelt.
  20073.      </P
  20074. ></DIV
  20075. ></DIV
  20076. ><DIV
  20077. CLASS="sect2"
  20078. ><HR><H3
  20079. CLASS="sect2"
  20080. ><A
  20081. NAME="language.variables.external.cookies"
  20082. >HTTP-Cookies</A
  20083. ></H3
  20084. ><P
  20085. >      PHP unterstⁿtzt HTTP-Cookies, wie sie in <A
  20086. HREF="http://www.netscape.com/newsref/std/cookie_spec.html"
  20087. TARGET="_top"
  20088. >Netscape's Spec</A
  20089. > definiert sind.
  20090.      Cookies erm÷glichen die Daten-Speicherung innerhalb der
  20091.      jeweiligen Browser-Umgebung zur Weiterleitung oder wiederholten
  20092.      Identifikation von Benutzern. Sie k÷nnen Cookies erzeugen, indem
  20093.      Sie die Funktion <A
  20094. HREF="#function.setcookie"
  20095. ><B
  20096. CLASS="function"
  20097. >setcookie()</B
  20098. ></A
  20099. > benutzen. Cookies
  20100.      sind Teil des HTTP-Headers, deshalb muss die setcookie-Funktion
  20101.      aufgerufen werden, bevor irgendeine Ausgabe an den Browser
  20102.      gesendet wird. Dabei handelt es sich um die gleiche
  20103.      EinschrΣnkung, die auch fⁿr die
  20104.      <A
  20105. HREF="#function.header"
  20106. ><B
  20107. CLASS="function"
  20108. >header()</B
  20109. ></A
  20110. >-Funktion gilt. Cookie-Daten stehen
  20111.      dann sowohl in den entsprechenden Cookie-Daten-Arrays, wie zum
  20112.      Beispiel <VAR
  20113. CLASS="varname"
  20114. >$_COOKIE</VAR
  20115. >,
  20116.      <VAR
  20117. CLASS="varname"
  20118. >$HTTP_COOKIE_VARS</VAR
  20119. > als auch in
  20120.      <VAR
  20121. CLASS="varname"
  20122. >$_REQUEST</VAR
  20123. > zur Verfⁿgung. Fⁿr weitere Details
  20124.      und Beispiele lesen Sie bitte die
  20125.      <A
  20126. HREF="#function.setcookie"
  20127. ><B
  20128. CLASS="function"
  20129. >setcookie()</B
  20130. ></A
  20131. >-Seite des Handbuchs.
  20132.     </P
  20133. ><P
  20134. >      Wenn Sie einer einzelnen Cookie-Variable mehrere Werte zuweisen
  20135.      wollen, mⁿssen Sie diese als Array ⁿbertragen. Zum Beispiel:
  20136.     </P
  20137. ><DIV
  20138. CLASS="informalexample"
  20139. ><P
  20140. ></P
  20141. ><A
  20142. NAME="AEN3620"
  20143. ></A
  20144. ><TABLE
  20145. BORDER="0"
  20146. BGCOLOR="#E0E0E0"
  20147. CELLPADDING="5"
  20148. ><TR
  20149. ><TD
  20150. ><PRE
  20151. CLASS="php"
  20152. ><?php
  20153. setcookie("MeinCookie[foo]", "Ich teste 1", time()+3600);
  20154. setcookie("MeinCookie[bar]", "Ich teste 2", time()+3600);
  20155. ?></PRE
  20156. ></TD
  20157. ></TR
  20158. ></TABLE
  20159. ><P
  20160. ></P
  20161. ></DIV
  20162. ><P
  20163. >      Das erzeugt zwei einzelne Cookies obwohl MeinCookie in Ihrem
  20164.      Skript nun ein einziges Array ist. Wenn Sie nur ein Cookie mit
  20165.      mehreren Werten setzen wollen, sollten Sie zuerst
  20166.      <A
  20167. HREF="#function.serialize"
  20168. ><B
  20169. CLASS="function"
  20170. >serialize()</B
  20171. ></A
  20172. > oder <A
  20173. HREF="#function.explode"
  20174. ><B
  20175. CLASS="function"
  20176. >explode()</B
  20177. ></A
  20178. >
  20179.      auf das Array anwenden.
  20180.     </P
  20181. ><P
  20182. >      Bedenken Sie, dass ein Cookie ein vorhergehendes Cookie
  20183.      gleichen Namens ⁿberschreibt, es sei denn, der Pfad oder
  20184.      die Domain ist anders. Fⁿr eine Warenkorb-Anwendung k÷nnen
  20185.      Sie deshalb z.B. einen ZΣhler bilden und diesen weiterleiten:
  20186.     </P
  20187. ><TABLE
  20188. WIDTH="100%"
  20189. BORDER="0"
  20190. CELLPADDING="0"
  20191. CELLSPACING="0"
  20192. CLASS="EXAMPLE"
  20193. ><TR
  20194. ><TD
  20195. ><DIV
  20196. CLASS="example"
  20197. ><A
  20198. NAME="AEN3626"
  20199. ></A
  20200. ><P
  20201. ><B
  20202. >Beispiel 11-11. Ein <A
  20203. HREF="#function.setcookie"
  20204. ><B
  20205. CLASS="function"
  20206. >setcookie()</B
  20207. ></A
  20208. >-Beispiel</B
  20209. ></P
  20210. ><TABLE
  20211. BORDER="0"
  20212. BGCOLOR="#E0E0E0"
  20213. CELLPADDING="5"
  20214. ><TR
  20215. ><TD
  20216. ><PRE
  20217. CLASS="php"
  20218. ><?php
  20219. if (isset($_COOKIE['zaehler'])) {
  20220.     $zaehler = $_COOKIE['zaehler'] + 1;
  20221. } else {
  20222.     $zaehler = 1;
  20223. }
  20224. setcookie("zaehler", $zaehler, time()+3600);
  20225. setcookie("Cart[$zaehler]", $item, time()+3600);
  20226. ?></PRE
  20227. ></TD
  20228. ></TR
  20229. ></TABLE
  20230. ></DIV
  20231. ></TD
  20232. ></TR
  20233. ></TABLE
  20234. ></DIV
  20235. ><DIV
  20236. CLASS="sect2"
  20237. ><HR><H3
  20238. CLASS="sect2"
  20239. ><A
  20240. NAME="language.variables.external.dot-in-names"
  20241. >Punkte in eingelesenen Variablen-Bezeichnern</A
  20242. ></H3
  20243. ><P
  20244. >      Normalerweise verΣndert PHP die Variablen-Bezeichner nicht,
  20245.      wenn sie einem Skript ⁿbergeben werden. Es sollte aber beachtet
  20246.      werden, dass der Punkt (".") kein gⁿltiger Bestandteil eines
  20247.      Variablen-Bezeichners ist. Deshalb achten Sie auf folgendes:
  20248.      <TABLE
  20249. BORDER="0"
  20250. BGCOLOR="#E0E0E0"
  20251. CELLPADDING="5"
  20252. ><TR
  20253. ><TD
  20254. ><PRE
  20255. CLASS="php"
  20256. ><?php
  20257. $varname.ext;  /* ungⁿltiger Variablen-Bezeichner */
  20258. ?></PRE
  20259. ></TD
  20260. ></TR
  20261. ></TABLE
  20262. >
  20263.      Der PHP-Parser sieht eine Variable namens <VAR
  20264. CLASS="varname"
  20265. >$varname</VAR
  20266. >,
  20267.      gefolgt von einem Zeichenketten-Verbindungs-Operator, dieser wiederrum
  20268.      gefolgt von der offenen Zeichenkette 'ext' (also nicht eingegrenzt
  20269.      durch '"' und auch keinem Schlⁿssel oder reserviertem Bezeichner
  20270.      entsprechend). Das kann natⁿrlich nicht zum gewⁿnschten Ergebnis
  20271.      fⁿhren.
  20272.     </P
  20273. ><P
  20274. >      Deshalb ist es wichtig zu wissen, dass PHP in den ihm ⁿbergebenen
  20275.      Variablen alle Punkte (.) automatisch durch einen 
  20276.      Unterstrich (_) ersetzt.
  20277.     </P
  20278. ></DIV
  20279. ><DIV
  20280. CLASS="sect2"
  20281. ><HR><H3
  20282. CLASS="sect2"
  20283. ><A
  20284. NAME="language.variables.determining-type-of"
  20285. >Bestimmung des Variablen-Typs</A
  20286. ></H3
  20287. ><P
  20288. >      Da PHP den Typ der Variablen bestimmt und (im Allgemeinen) selbst
  20289.      eine entsprechende Umformung vornimmt, ist es nicht immer klar,
  20290.      welchen Typ eine Variable gerade hat. PHP beinhaltet einige
  20291.      Funktionen, die dies herausfinden, wie zum Beispiel:
  20292.      <A
  20293. HREF="#function.gettype"
  20294. ><B
  20295. CLASS="function"
  20296. >gettype()</B
  20297. ></A
  20298. >, <A
  20299. HREF="#function.is-array"
  20300. ><B
  20301. CLASS="function"
  20302. >is_array()</B
  20303. ></A
  20304. >,
  20305.      <A
  20306. HREF="#function.is-float"
  20307. ><B
  20308. CLASS="function"
  20309. >is_float()</B
  20310. ></A
  20311. >, <A
  20312. HREF="#function.is-int"
  20313. ><B
  20314. CLASS="function"
  20315. >is_int()</B
  20316. ></A
  20317. >,
  20318.      <A
  20319. HREF="#function.is-object"
  20320. ><B
  20321. CLASS="function"
  20322. >is_object()</B
  20323. ></A
  20324. > und
  20325.      <A
  20326. HREF="#function.is-string"
  20327. ><B
  20328. CLASS="function"
  20329. >is_string()</B
  20330. ></A
  20331. >. Lesen Sie bitte auch das Kapitel
  20332.      ⁿber <A
  20333. HREF="#language.types"
  20334. >Typen</A
  20335. >.
  20336.     </P
  20337. ></DIV
  20338. ></DIV
  20339. ></DIV
  20340. ><DIV
  20341. CLASS="chapter"
  20342. ><HR><H1
  20343. ><A
  20344. NAME="language.constants"
  20345. >Kapitel 12. Konstanten</A
  20346. ></H1
  20347. ><P
  20348. >    Eine Konstante ist ein Bezeichner (Name) fⁿr eine simple Variable.
  20349.    Wie der Name schon ausdrⁿckt, kann sich der Wert einer Konstanten
  20350.    zur Laufzeit eines Skripts nicht Σndern (eine Ausnahme bilden die
  20351.    <A
  20352. HREF="#language.constants.predefined"
  20353. >Magischen Konstanten</A
  20354. >,
  20355.    die aber tatsΣchlich keine Konstanten sind.) Eine Konstante unterscheidet
  20356.    zwischen Gro▀- und KLeinschreinbung (case-sensitive). Nach gΣngiger
  20357.    Konvention werden Konstanten immer in Gro▀buchstaben geschrieben.
  20358.   </P
  20359. ><P
  20360. >    Der Name einer Konstanten folgt den gleichen Regeln wie alle anderen
  20361.    Bezeichner in PHP. Ein gⁿltiger Name beginnt mit einem Buchstaben
  20362.    oder einem Unterstrich, gefolgt von beliebig vielen Buchstaben, Nummern
  20363.    oder Understrichen. Als regulΣrer Ausdruck geschrieben:
  20364.    <VAR
  20365. CLASS="literal"
  20366. >[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</VAR
  20367. >
  20368.   </P
  20369. ><P
  20370. >    <TABLE
  20371. WIDTH="100%"
  20372. BORDER="0"
  20373. CELLPADDING="0"
  20374. CELLSPACING="0"
  20375. CLASS="EXAMPLE"
  20376. ><TR
  20377. ><TD
  20378. ><DIV
  20379. CLASS="example"
  20380. ><A
  20381. NAME="AEN3653"
  20382. ></A
  20383. ><P
  20384. ><B
  20385. >Beispiel 12-1. Gⁿltige und ungⁿltige Namen fⁿr Konstanten</B
  20386. ></P
  20387. ><TABLE
  20388. BORDER="0"
  20389. BGCOLOR="#E0E0E0"
  20390. CELLPADDING="5"
  20391. ><TR
  20392. ><TD
  20393. ><PRE
  20394. CLASS="php"
  20395. ><?php
  20396.  
  20397. // Gⁿltige Namen fⁿr Konstanten
  20398. define("FOO",     "irgendwas");
  20399. define("FOO2",    "etwas anderes");
  20400. define("FOO_BAR", "irgendwas ganz anderes")
  20401.  
  20402. // Invalid constant names
  20403. define("2FOO",    "irgendwas");
  20404.  
  20405. // Folgendes ist korrekt, sollte aber vermieden werden:
  20406. // Eines Tages k÷nnte es in PHP eine Magische Konstante
  20407. // __FOO__ geben und Ihr Skript wird dadurch nicht mehr
  20408. // wie gewⁿnscht funktionieren.
  20409.  
  20410. define("__FOO__", "irgendwas"); 
  20411.  
  20412. ?></PRE
  20413. ></TD
  20414. ></TR
  20415. ></TABLE
  20416. ></DIV
  20417. ></TD
  20418. ></TR
  20419. ></TABLE
  20420. >
  20421.   </P
  20422. ><DIV
  20423. CLASS="note"
  20424. ><BLOCKQUOTE
  20425. CLASS="note"
  20426. ><P
  20427. ><B
  20428. >Anmerkung: </B
  20429. >
  20430.     Fⁿr unsere Zwecke ist ein Buchstabe a-z, A-Z und die ASCII-Zeichen
  20431.     von 127 bis 255 (0x7f-0xff).
  20432.    </P
  20433. ></BLOCKQUOTE
  20434. ></DIV
  20435. ><P
  20436. >    Wie bei <A
  20437. HREF="#language.variables.predefined"
  20438. >superglobals</A
  20439. > ist der Gⁿltigkeitsbereich einer Konstanten
  20440.    global. UnabhΣngig vom Gⁿltigkeitsbereich k÷nnen Sie in Ihrem Skript
  20441.    ⁿberall auf eine Konstante zugreifen. Fⁿr mehr Information zum
  20442.    Gⁿltigkeitsbereich lesen Sie bitte den Abschnitt ⁿber den
  20443.    <A
  20444. HREF="#language.variables.scope"
  20445. >Geltungsbereich von Variablen</A
  20446. >.
  20447.    
  20448.       For more information on scope, read the manual section on
  20449.    <A
  20450. HREF="#language.variables.scope"
  20451. >variable scope</A
  20452. >.
  20453.   </P
  20454. ><DIV
  20455. CLASS="sect1"
  20456. ><HR><H2
  20457. CLASS="sect1"
  20458. ><A
  20459. NAME="language.constants.syntax"
  20460. >Syntax</A
  20461. ></H2
  20462. ><P
  20463. >     Eine Konstante k÷nnen Sie ⁿber die Funktion <A
  20464. HREF="#function.define"
  20465. ><B
  20466. CLASS="function"
  20467. >define()</B
  20468. ></A
  20469. >
  20470.     definieren. Einmal definiert, kann eine Konstane weder verΣndert
  20471.     noch gel÷scht werden.
  20472.    </P
  20473. ><P
  20474. >     Konstanten k÷nnen nur scalare Daten (<A
  20475. HREF="#language.types.boolean"
  20476. ><B
  20477. CLASS="type"
  20478. >boolean</B
  20479. ></A
  20480. >,
  20481.     <A
  20482. HREF="#language.types.integer"
  20483. ><B
  20484. CLASS="type"
  20485. >integer</B
  20486. ></A
  20487. >, <A
  20488. HREF="#language.types.float"
  20489. ><B
  20490. CLASS="type"
  20491. >float</B
  20492. ></A
  20493. > und <A
  20494. HREF="#language.types.string"
  20495. ><B
  20496. CLASS="type"
  20497. >string</B
  20498. ></A
  20499. >)
  20500.     enthalten.
  20501.    </P
  20502. ><P
  20503. >     Den Wert einer Konstanten erhalten Sie ganz einfach durch die Angabe ihres
  20504.     Namens. Einer Konstanten sollten Sie <SPAN
  20505. CLASS="emphasis"
  20506. ><I
  20507. CLASS="emphasis"
  20508. >nicht</I
  20509. ></SPAN
  20510. >, wie bei
  20511.     Variablen, ein <VAR
  20512. CLASS="literal"
  20513. >$</VAR
  20514. > voranstellen. Ebenso k÷nnen Sie die
  20515.     Funktion <A
  20516. HREF="#function.constant"
  20517. ><B
  20518. CLASS="function"
  20519. >constant()</B
  20520. ></A
  20521. > benutzen um den Wert einer Konstanten
  20522.     auszulesen, wenn Sie den Namen der Konstanten dynamisch erhalten wollen.
  20523.     Benutzen Sie <A
  20524. HREF="#function.get-defined-constants"
  20525. ><B
  20526. CLASS="function"
  20527. >get_defined_constants()</B
  20528. ></A
  20529. > um eine Liste
  20530.     aller definierten Konstanten zu erhalten.
  20531.    </P
  20532. ><DIV
  20533. CLASS="note"
  20534. ><BLOCKQUOTE
  20535. CLASS="note"
  20536. ><P
  20537. ><B
  20538. >Anmerkung: </B
  20539. >
  20540.      Konstanten und (globale) Variablen befinden sich in unterschiedlichen
  20541.      NamensrΣumen. Das hat zum Beispiel zur Folge, dass <TT
  20542. CLASS="constant"
  20543. ><B
  20544. >TRUE</B
  20545. ></TT
  20546. > und 
  20547.      <VAR
  20548. CLASS="varname"
  20549. >$TRUE</VAR
  20550. > grundsΣtzlich unterschiedlich sind.
  20551.     </P
  20552. ></BLOCKQUOTE
  20553. ></DIV
  20554. ><P
  20555. >     Falls Sie eine undefinierte Konstante verwenden nimmt PHP an, dass
  20556.     Sie den Namen der Konstanten selber meinen, genauso als ob Sie einen
  20557.     <A
  20558. HREF="#language.types.string"
  20559. ><B
  20560. CLASS="type"
  20561. >string</B
  20562. ></A
  20563. > (CONSTANT vs "CONSTANT") angegeben hΣtten. Falls das
  20564.     passiert, wird Ihnen ein Fehler vom Typ
  20565.     <A
  20566. HREF="#ref.errorfunc"
  20567. >E_NOTICE</A
  20568. > ausgegeben. Lesen Sie hier
  20569.     nach, warum die Angabe
  20570.     <A
  20571. HREF="#language.types.array.foo-bar"
  20572. >$foo[bar]</A
  20573. > falsch ist
  20574.     (zumindest solange Sie nicht zuerst <VAR
  20575. CLASS="literal"
  20576. >bar</VAR
  20577. > mittels
  20578.     <A
  20579. HREF="#function.define"
  20580. ><B
  20581. CLASS="function"
  20582. >define()</B
  20583. ></A
  20584. > als Konstante definiert haben). M÷chten Sie
  20585.     einfach nur nachprⁿfen, ob eine Konstante definiert ist, benutzen Sie die
  20586.     Funktion <A
  20587. HREF="#function.defined"
  20588. ><B
  20589. CLASS="function"
  20590. >defined()</B
  20591. ></A
  20592. > fⁿr diesen Zweck.
  20593.    </P
  20594. ><P
  20595. >     Das hier sind die Unterschiede zwischen Konstanten und Variablen:
  20596.     <P
  20597. ></P
  20598. ><UL
  20599. ><LI
  20600. ><P
  20601. >        Konstanten haben kein Dollarzeichen (<VAR
  20602. CLASS="literal"
  20603. >$</VAR
  20604. >)
  20605.        vorangestellt;
  20606.       </P
  20607. ></LI
  20608. ><LI
  20609. ><P
  20610. >        Konstanten k÷nnen nur ⁿber die Funktion <A
  20611. HREF="#function.define"
  20612. ><B
  20613. CLASS="function"
  20614. >define()</B
  20615. ></A
  20616. >
  20617.        definiert werden, nicht durch einfache Zuweisung;
  20618.       </P
  20619. ></LI
  20620. ><LI
  20621. ><P
  20622. >        Konstanten k÷nnen ⁿberall definiert werden und auf Ihren Wert
  20623.        k÷nnen Sie ohne Rⁿcksicht auf Namensraumregeln von Variablen zugreifen;
  20624.       </P
  20625. ></LI
  20626. ><LI
  20627. ><P
  20628. >        Sobald Konstanten definiert sind, k÷nnen sie nicht neu definiert
  20629.        oder gel÷scht werden; und
  20630.       </P
  20631. ></LI
  20632. ><LI
  20633. ><P
  20634. >        Konstanten k÷nnen nur skalare Werte haben.
  20635.        </P
  20636. ></LI
  20637. ></UL
  20638. >
  20639.    </P
  20640. ><P
  20641. >     <TABLE
  20642. WIDTH="100%"
  20643. BORDER="0"
  20644. CELLPADDING="0"
  20645. CELLSPACING="0"
  20646. CLASS="EXAMPLE"
  20647. ><TR
  20648. ><TD
  20649. ><DIV
  20650. CLASS="example"
  20651. ><A
  20652. NAME="AEN3702"
  20653. ></A
  20654. ><P
  20655. ><B
  20656. >Beispiel 12-2. Definiton von Konstanten</B
  20657. ></P
  20658. ><TABLE
  20659. BORDER="0"
  20660. BGCOLOR="#E0E0E0"
  20661. CELLPADDING="5"
  20662. ><TR
  20663. ><TD
  20664. ><PRE
  20665. CLASS="php"
  20666. ><?php
  20667. define("CONSTANT", "Hallo Welt.");
  20668. echo CONSTANT; // Ausgabe: "Hallo Welt."
  20669. echo Constant; // Ausgabe: "Constant" und eine Notice.
  20670. ?></PRE
  20671. ></TD
  20672. ></TR
  20673. ></TABLE
  20674. ></DIV
  20675. ></TD
  20676. ></TR
  20677. ></TABLE
  20678. >
  20679.  
  20680.    </P
  20681. ></DIV
  20682. ><DIV
  20683. CLASS="sect1"
  20684. ><HR><H2
  20685. CLASS="sect1"
  20686. ><A
  20687. NAME="language.constants.predefined"
  20688. >Magische Konstanten</A
  20689. ></H2
  20690. ><P
  20691. >     PHP stellt jedem Skript eine Vielzahl von <A
  20692. HREF="#reserved.constants"
  20693. >vordefinierten Konstanten</A
  20694. >
  20695.     zur Verfⁿgung. Viele dieser Konstanten werden jedoch von verschiedenen
  20696.     Erweiterungen definiert, die nur zur Verfⁿgung stehen, wenn diese
  20697.     Erweiterungen selbst zur Verfⁿgung stehen, d.h. entweder ⁿber dynamisches
  20698.     Laden zur Laufzeit oder sie sind einkompiliert.
  20699.    </P
  20700. ><P
  20701. >     Es gibt fⁿnf magische Konstanten, die abhΣngig davon, wo sie eingesetzt
  20702.     werden, einen unterschiedlichen Wert haben. Zum Beispiel hΣngt
  20703.     der Wert der Konstanten <TT
  20704. CLASS="constant"
  20705. ><B
  20706. >__LINE__</B
  20707. ></TT
  20708. > davon ab, in welcher
  20709.     Zeile ihres Skripts Sie diese Konstante verwenden. Diese besonderen
  20710.     Konstanten sind unabhΣngig von Gro▀-/Kleinschreibung und sind folgende:
  20711.    </P
  20712. ><P
  20713. >     <DIV
  20714. CLASS="table"
  20715. ><A
  20716. NAME="AEN3712"
  20717. ></A
  20718. ><P
  20719. ><B
  20720. >Tabelle 12-1. Einige "magische" PHP "Konstanten"</B
  20721. ></P
  20722. ><TABLE
  20723. BORDER="1"
  20724. CLASS="CALSTABLE"
  20725. ><COL><COL><THEAD
  20726. ><TR
  20727. ><TH
  20728. >Name</TH
  20729. ><TH
  20730. >Beschreibung</TH
  20731. ></TR
  20732. ></THEAD
  20733. ><TBODY
  20734. ><TR
  20735. ><TD
  20736. ><TT
  20737. CLASS="constant"
  20738. ><B
  20739. >__LINE__</B
  20740. ></TT
  20741. ></TD
  20742. ><TD
  20743. >          Die aktuelle Zeilennummer einer Datei.
  20744.         </TD
  20745. ></TR
  20746. ><TR
  20747. ><TD
  20748. ><TT
  20749. CLASS="constant"
  20750. ><B
  20751. >__FILE__</B
  20752. ></TT
  20753. ></TD
  20754. ><TD
  20755. >          Der vollstΣndige Pfad- und Dateiname einer Datei.
  20756.         </TD
  20757. ></TR
  20758. ><TR
  20759. ><TD
  20760. ><TT
  20761. CLASS="constant"
  20762. ><B
  20763. >__FUNCTION__</B
  20764. ></TT
  20765. ></TD
  20766. ><TD
  20767. >          Der Name einer Funktion. Steht seit PHP 4.3.0 zur Verfⁿgung.
  20768.         </TD
  20769. ></TR
  20770. ><TR
  20771. ><TD
  20772. ><TT
  20773. CLASS="constant"
  20774. ><B
  20775. >__CLASS__</B
  20776. ></TT
  20777. ></TD
  20778. ><TD
  20779. >          Der Name einer Klasse. Steht seit PHP 4.3.0 zur Verfⁿgung.
  20780.         </TD
  20781. ></TR
  20782. ><TR
  20783. ><TD
  20784. ><TT
  20785. CLASS="constant"
  20786. ><B
  20787. >__METHOD__</B
  20788. ></TT
  20789. ></TD
  20790. ><TD
  20791. >          Der Name einer Klassenmethode. Steht seit PHP 5.0.0 zur Verfⁿgung.
  20792.         </TD
  20793. ></TR
  20794. ></TBODY
  20795. ></TABLE
  20796. ></DIV
  20797. >
  20798.    </P
  20799. ></DIV
  20800. ></DIV
  20801. ><DIV
  20802. CLASS="chapter"
  20803. ><HR><H1
  20804. ><A
  20805. NAME="language.expressions"
  20806. >Kapitel 13. Ausdrⁿcke</A
  20807. ></H1
  20808. ><P
  20809. >     Ausdrⁿcke (Expressions) sind die wichtigsten Bausteine von PHP. In
  20810.     PHP ist fast alles, was geschrieben wird, ein Ausdruck. Die einfachste,
  20811.     aber auch zutreffenste Definition fⁿr einen Ausdruck ist "alles, was
  20812.     einen Wert hat".</P
  20813. ><P
  20814. >     Die grundlegendste Formen von Ausdrⁿcken sind Konstanten und Variablen.
  20815.     Wenn man "$a = 5" schreibt, weist man $a den Ausdruck ┤5┤ zu. ┤5┤ hat 
  20816.     offensichtlich den Wert 5. Anders ausgedrⁿckt: ┤5┤ ist ein Ausdruck 
  20817.     mit dem Wert 5 (in diesem Fall ist ┤5┤ eine Integer-Konstante).</P
  20818. ><P
  20819. >     Nach dieser Zuweisung wⁿrde man erwarten, dass der Wert von $a nun 
  20820.     ebenfalls 5 ist, wenn man also $b = $a schreibt, sollte  
  20821.     dasselbe dabei herauskommen, als hΣtte man $b = 5 geschrieben.
  20822.     Anders ausgedrⁿckt: $a wΣre ebenfalls ein  Ausdruck mit dem Wert 5.
  20823.     Wenn alles richtig funktioniert, wird genau das passieren.</P
  20824. ><P
  20825. >     Etwas kompliziertere Beispiele fⁿr Ausdrⁿcke sind Funktionen:
  20826.  
  20827.     <DIV
  20828. CLASS="informalexample"
  20829. ><P
  20830. ></P
  20831. ><A
  20832. NAME="AEN3746"
  20833. ></A
  20834. ><TABLE
  20835. BORDER="0"
  20836. BGCOLOR="#E0E0E0"
  20837. CELLPADDING="5"
  20838. ><TR
  20839. ><TD
  20840. ><PRE
  20841. CLASS="programlisting"
  20842. >function foo () {
  20843.     return 5;
  20844. }</PRE
  20845. ></TD
  20846. ></TR
  20847. ></TABLE
  20848. ><P
  20849. ></P
  20850. ></DIV
  20851. ></P
  20852. ><P
  20853. >     Angenommen, Sie sind mit dem Konzept von Funktionen vertraut (wenn
  20854.     Sie es nicht sind, lesen Sie das Kapitel ⁿber Funktionen), dann
  20855.     wⁿrden Sie annehmen, dass die Eingabe von <VAR
  20856. CLASS="literal"
  20857. >$c = foo()</VAR
  20858. >
  20859.     grundsΣtzlich daselbe bedeutet, als wⁿrde man schreiben 
  20860.     <VAR
  20861. CLASS="literal"
  20862. >$c = 5</VAR
  20863. >,und genau das trifft zu. Funktionen sind
  20864.     Ausdrⁿcke mit dem Wert ihres Rⁿckgabewertes. Da foo() den Wert 5
  20865.     zurⁿckgibt, ist der Wert des Ausdruckes ┤foo()┤ 5. Normalerweise
  20866.     geben Funktionen nicht einfach einen statischen Wert zurⁿck, sondern
  20867.     berechnen irgendetwas.</P
  20868. ><P
  20869. >     Natⁿrlich mⁿssen Werte in PHP keine Integer-Zahlen sein, und oft sind
  20870.     sie es auch nicht. PHP unterstⁿtzt drei skalare Datentypen: integer values 
  20871.     (Integer-Zahlen),floating point values (Flie▀kommazahlen) und string values
  20872.     (Zeichenketten).
  20873.     (Skalare sind Datentypen, die man nicht in kleinere Stⁿcke ┤brechen┤ kann, 
  20874.     im Gegensatz zu Arrays).
  20875.     PHP unsterstⁿtzt auch zwei zusammengesetzte (nicht-skalare) Datentypen:
  20876.     Arrays und Objekte. Jeder dieser Datentypen kann Variablen zugewiesen
  20877.     und von Funktionen zurⁿckgegeben werden.</P
  20878. ><P
  20879. >     Bis hierhin sollten Benutzer von PHP/FI 2 keine VerΣnderung bemerkt haben.
  20880.     PHP fasst den Begriff ┤Ausdruck┤ aber noch viel weiter, wie es auch andere 
  20881.     Programmiersprachen tun. PHP ist in dem Sinne eine ausdrucksoriente Sprache,
  20882.     dass fast alles ein Ausdruck ist. Zurⁿck zu dem Beispiel, mit dem wir 
  20883.     uns schon beschΣftigt haben: ┤$a = 5┤. Es ist einfach zu erkennen, dass
  20884.     hier zwei Werte enthalten sind: Der Wert der Integer-Konstanten ┤5┤ und
  20885.     der Wert von $a, der auf 5 geΣndert wird. In Wirklichkeit ist aber noch
  20886.     ein zusΣtzlicher Wert enthalten, nΣmlich der Wert der Zuweisung selbst.
  20887.     Die Zuweisung selbst enthΣlt den zugewiesenen Wert, in diesem Fall 5.
  20888.     In der Praxis bedeutet dies, dass ┤$a = 5┤, egal was es tut, immer
  20889.     einen Ausdruck mit dem Wert 5 darstellt. Folglich ist 
  20890.     ┤$b = ($a = 5)┤ gleichbedeutend mit ┤$a = 5; $b = 5;┤ (ein Semikolon
  20891.     markiert das Ende einer Anweisung). Da Wertzuweisungen von rechts
  20892.     nach links geparst werden, kann man auch ┤$b = $a = 5┤ schreiben.
  20893.     </P
  20894. ><P
  20895. >     Ein anderes gutes Beispiel fⁿr die Ausdrucksorientierung von PHP
  20896.     sind PrΣ- und Post-Inkrement sowie die entsprechenden Dekremente.
  20897.     Benutzer von PHP/FI 2 und vielen anderen Sprachen sind vermutlich 
  20898.     mit den Notationen ┤variable++┤ und ┤variable--┤ vertraut. Dies 
  20899.     sind Inkrement- und Dekrement-Operatoren. IN PHP/FI 2 hat das 
  20900.     Statement ┤$a++┤ keinen Wert (es ist kein Ausdruck) und daher
  20901.     kann man es nicht als Wert zuweisen oder in irgendeiner Weise
  20902.     benutzen. PHP erweitert die Eigenschaften von Dekrement und 
  20903.     Inkrement, indem es die beiden ebenfalls zu Ausdrⁿcken macht.
  20904.     In PHP gibt es, wie in C, zwei Arten von Inkrementen - 
  20905.     PrΣ-Inkrement und Post-Inkrement. GrundsΣtzlich erh÷hen sowohl
  20906.     PrΣ- als auch Post-Inkrement den Wert der Variable, und der
  20907.     Effekt auf die Variable ist derselbe. Der Unterschied ist der 
  20908.     Wert des Inkrement-Ausdruckes.
  20909.     Das PrΣ-Inkrement, das ┤++$variable┤ geschrieben wird, enthΣlt
  20910.     als Wert den Wert der erh÷hten Variabe (PHP erh÷ht den Wert
  20911.     der Variable, bevor es ihren Wert ausliest, daher der Name
  20912.     ┤PR─-Inkrement┤). Das Post-Inkrement, das ┤$variable++┤ 
  20913.     geschrieben wird, enthΣlt dagegen den ursprⁿnglichen Wert der
  20914.     Variablen vor der Erh÷hung (PHP erh÷ht den Wert der Variablen,
  20915.     nachdem es ihren Wert ausgelesen hat, daher der Name 
  20916.     ┤POST-Inkrement┤).</P
  20917. ><P
  20918. >     Ein sehr gebrΣuchlicher Typ von Ausdrⁿcken sind Vergleichsausdrⁿcke.
  20919.     Diese Ausdrⁿcke geben entweder 0 (=FALSCH) oder 1 (=WAHR) zurⁿck.
  20920.     PHP unterstⁿtzt > (gr÷▀er), >= (gr÷▀er oder gleich), == (gleich),
  20921.     != (ungleich), < (kleiner), und <= (kleiner oder gleich). Diese
  20922.     Ausdrⁿcke werden meistens in bedingten Anweisungen, wie z. B. in
  20923.     <VAR
  20924. CLASS="literal"
  20925. >if</VAR
  20926. >-Anweisungen,  verwendet.</P
  20927. ><P
  20928. >     Im letzten Beispiel fⁿr Ausdrⁿcke befassen wir uns mit kombinierten
  20929.     Zuweisungs- und Operator-Ausdrⁿcken. Wir haben schon gezeigt, wie
  20930.     man den Wert von $a um 1 erh÷ht, nΣmlich indem man einfach ┤$a++┤
  20931.     oder ┤++$a┤ schreibt. Aber was tut man, wenn man den Wert um 
  20932.     mehr als eins erh÷hen will, z. B. um 3? Man k÷nnte mehrer Male
  20933.     ┤$a++┤ schreiben, aber das ist offensichtlich weder effizient 
  20934.     noch sehr komfortabel. Viel ⁿblicher ist es, einfach 
  20935.     ┤$a = $a + 3┤ zu schreiben. ┤$a + 3┤ gibt den Wert von $a plus
  20936.     3 zurⁿck, dieser wird wieder $a zugewiesen, was dazu fⁿhrt, dass
  20937.     $a nun um 3 erh÷ht wurde. In PHP - wie in einigen anderen 
  20938.     Programmiersprachen, z. B. in C - kann man dies aber noch 
  20939.     kⁿrzer schreiben, was mit der Zeit klarer wird und auch einfacher
  20940.     zu verstehen ist. Um 3 zu dem aktuellen Wert hinzuzufⁿgen, schreibt
  20941.     man ┤$a += 3┤. Das bedeutet exakt: "Nimm┤ den Wert von $a, addiere
  20942.     3 hinzu und weise $a den entstandenen Wert zu". ZusΣtzlich dazu,
  20943.     dass diese Schreibweise kⁿrzer und klarer ist, resultiert sie auch
  20944.     in einer schnelleren Ausfⁿhrung. Der Wert von ┤$a += 3┤ ist, wie
  20945.     der Wert einer regulΣren Zuweisung, der zugewiesene Wert. Es ist
  20946.     zu beachten, dass dieser Wert NICHT 3, sondern dem kombinierten
  20947.     Wert von $a plus 3 entspricht (Das ist der Wert, der $a zugewiesen
  20948.     wird). Jeder Operator, der zwei Elemente verbindet, kann in dieser
  20949.     Schreibweise verwendet werden, z. B. ┤$a -= 5┤ (vermindert den 
  20950.     Wert von $a um 5) oder ┤$a *= 7┤ (multipliziert den Wert von
  20951.     $a mit 7 und weist das Ergebnis $a zu), usw.</P
  20952. ><P
  20953. >     Es gibt einen weiteren Ausdruck, der Ihnen vielleicht seltsam vorkommt,
  20954.     wenn Sie ihn bisher noch in keiner Programmiersprache kennengelernt 
  20955.     haben, den dreifach konditionalen Operator:
  20956.  
  20957.     <DIV
  20958. CLASS="informalexample"
  20959. ><P
  20960. ></P
  20961. ><A
  20962. NAME="AEN3758"
  20963. ></A
  20964. ><TABLE
  20965. BORDER="0"
  20966. BGCOLOR="#E0E0E0"
  20967. CELLPADDING="5"
  20968. ><TR
  20969. ><TD
  20970. ><PRE
  20971. CLASS="programlisting"
  20972. >$eins ? $zwei : $drei</PRE
  20973. ></TD
  20974. ></TR
  20975. ></TABLE
  20976. ><P
  20977. ></P
  20978. ></DIV
  20979. >
  20980.  
  20981.     Wenn der Wert des ersten Sub-Ausdruckes (hier: $eins) wahr ist 
  20982.     (d. h. nicht <TT
  20983. CLASS="constant"
  20984. ><B
  20985. >NULL</B
  20986. ></TT
  20987. >), dann wird der Wert des zweiten Subausdrucks 
  20988.     (hier: $zwei) zurⁿckgeben und ist das Ergebnis des konditionalen 
  20989.     Ausdrucks. 
  20990.     Andernfalls (d. h. wenn der erste Ausdruck falsch ist), wird 
  20991.     der Wert des dritten Subausdruckes (hier: $drei) zurⁿckgeben.
  20992.     </P
  20993. ><P
  20994. >     Das folgende Beispiel sollte das VerstΣndnis von PrΣ- und
  20995.     Post-Inkrement und von Ausdrⁿcken im allgemeinen erleichtern:    
  20996.  
  20997.     <DIV
  20998. CLASS="informalexample"
  20999. ><P
  21000. ></P
  21001. ><A
  21002. NAME="AEN3762"
  21003. ></A
  21004. ><TABLE
  21005. BORDER="0"
  21006. BGCOLOR="#E0E0E0"
  21007. CELLPADDING="5"
  21008. ><TR
  21009. ><TD
  21010. ><PRE
  21011. CLASS="programlisting"
  21012. >function verdoppeln($i) {
  21013.     return $i*2;
  21014. }
  21015. $b = $a = 5;        /* Weise den Variablen $a und $b beiden den Wert 5 zu */
  21016. $c = $a++;          /* Post-Inkrement, der urspruengliche Wert von $a (also 5)
  21017.                        wird $c zugewiesen. */
  21018. $e = $d = ++$b;     /* Prae-Inkrement, der erh÷hte Wert von $b (= 6) wird $d und
  21019.                        $e zugewiesen. */
  21020.  
  21021. /* An diesem Punkt sind $d und $e beide gleich 6 */
  21022.  
  21023. $f = verdoppeln($d++);  /* Weise $f den doppelten Wert von $d <SPAN
  21024. CLASS="emphasis"
  21025. ><I
  21026. CLASS="emphasis"
  21027. >vor</I
  21028. ></SPAN
  21029. > 
  21030.                        der Erh÷hung um eins zu, 2*6 = 12 */
  21031. $g = double(++$e);  /* Weise $g den doppelten Wert von $e <SPAN
  21032. CLASS="emphasis"
  21033. ><I
  21034. CLASS="emphasis"
  21035. >nach</I
  21036. ></SPAN
  21037. >
  21038.                        der Erhoehung zu, 2*7 = 14 to $g */
  21039. $h = $g += 10;      /* Zuerst wie $g um 10 erh÷ht und hat schliesslich den Wert
  21040.                        24. Der Wert dieser Zuweisung (24) wird dann $h zugewiesen,
  21041.                        womit $h ebenfalls den Wert von 24 hat. */</PRE
  21042. ></TD
  21043. ></TR
  21044. ></TABLE
  21045. ><P
  21046. ></P
  21047. ></DIV
  21048. ></P
  21049. ><P
  21050. >     Am Anfang dieses Kapitels hatten wir gesagt, wir wⁿrden die
  21051.     verschiedenen Arten von Anweisungen beschreiben und, wie versprochen,
  21052.     Ausdrⁿcke k÷nnen Anweisungen sein. Trotzdem ist nicht jeder Ausdruck
  21053.     eine Anweisung. In diesem Fall hat eine Anweisung die Form 
  21054.     ┤Ausdr┤ ┤;┤, d. h. ein Ausdruck gefolgt von einem Semikolon.
  21055.     In ┤$b=$a=5;┤ ist $a=5 ein gⁿltiger Ausdruck, aber fⁿr sich 
  21056.     allein keine Anweisung. ┤$b=$a=5;┤ ist jedoch eine gⁿltige
  21057.     Anweisung.</P
  21058. ><P
  21059. >     Ein letzter Punkt, der noch zu erwΣhnen ist, ist der ┤wahr┤-Wert
  21060.     von Ausdrⁿcken. In vielen FΣllen, hauptsΣchlich in bedingten 
  21061.     Anweisungen und Schleifen, ist man nicht am spezifischen Wert
  21062.     eines Ausdrucks interessiert, sondern kⁿmmert sich nur darum,
  21063.     ob er WAHR oder FALSCH bedeutet (PHP hat keinen speziellen
  21064.     boolean-Datentyp). Der Wahrheitswert eines Ausdrucks in 
  21065.     in PHP wird Σhnlich bestimmt wie in Perl. Jeder numerische
  21066.     Wert, der nicht <TT
  21067. CLASS="constant"
  21068. ><B
  21069. >NULL</B
  21070. ></TT
  21071. > ist, bedeutet WAHR, <TT
  21072. CLASS="constant"
  21073. ><B
  21074. >NULL</B
  21075. ></TT
  21076. > bedeutet FALSCH.
  21077.     Es ist zu beachten, dass negative Werte nicht <TT
  21078. CLASS="constant"
  21079. ><B
  21080. >NULL</B
  21081. ></TT
  21082. > sind und deshalb
  21083.     als WAHR aufgefasst werden! Eine leere Zeichenkette und die 
  21084.     Zeichenkette "0" sind FALSCH; alle anderen Zeichenketten sind
  21085.     WAHR. Nicht-skalare Datentypen (Arrays und Objekte) werden als
  21086.     FALSCH betrachtet, wenn sie keine Elemente enthalten, anderfalls
  21087.     geben sie WAHR zurⁿck.</P
  21088. ><P
  21089. >     PHP stellt eine vollstΣndige und mΣchtige Implementat von Ausdrⁿcken
  21090.     bereit und, deren vollstΣndige Dokumentation den Rahmen dieses Manuals
  21091.     sprengen wⁿrde. Die obigen Beispiele sollten Ihnen einen guten Eindruck
  21092.     darⁿber verschaffen, was Ausdrⁿcke sind und wie man nⁿtzliche Ausdrⁿcke
  21093.     konstruieren kann. Im Rest dieses Manuals werden wir 
  21094.     <VAR
  21095. CLASS="replaceable"
  21096. >ausdr</VAR
  21097. > schreiben, um ausdrⁿcken, dass an dieser
  21098.     Stelle  jeder gⁿltige PHP-Ausdruck stehen kann.</P
  21099. ></DIV
  21100. ><DIV
  21101. CLASS="chapter"
  21102. ><HR><H1
  21103. ><A
  21104. NAME="language.operators"
  21105. >Kapitel 14. Operatoren</A
  21106. ></H1
  21107. ><P
  21108. >    Ein Operator ist etwas das Sie mit einem oder mehreren Werten fⁿttern (oder
  21109.    Ausdrⁿcken, um im Programmierjargon zu sprechen) und Sie erhalten als
  21110.    Ergebnis einen anderen Wert (damit wird diese Konstruktion selbst zu einem
  21111.    Ausdruck). Als Eselsbrⁿcke k÷nnen Sie sich Operatoren als Funktionen oder
  21112.    Konstrukte vorstellen, die Ihnen einen Wert zurⁿck liefern (Σhnlich print)
  21113.    und alles, was Ihnen keinen Wert zurⁿck liefert (Σhnlich echo) als irgend
  21114.    etwas Anderes.
  21115.   </P
  21116. ><P
  21117. >    Es gibt drei Arten von Opratoren. Als erstes gibt es den unΣren Operator,
  21118.    der nur mit einem Wert umgehen kann, zum Beispiel ! (der
  21119.    Verneinungsoperator) oder ++ (der Inkrementoperator). Die zweite Gruppe
  21120.    sind die sogenannten binΣren Operatoren; diese Gruppe enthΣlt die meisten
  21121.    Operatoren, die PHP unterstⁿtzt. Eine Liste dieser Operatoren finden Sie
  21122.    weiter unten im Abschnitt
  21123.    <A
  21124. HREF="#language.operators.precedence"
  21125. >Operator-Rangfolge
  21126.    </A
  21127. >.
  21128.   </P
  21129. ><P
  21130. >    Die dritte Gruppe bildet der ternΣre Operator : ?:. Dieser sollte eher
  21131.    benutzt werden um abhΣngig von einem dritten Ausdruck eine Auswahl zwischen
  21132.    zwei Ausdrⁿcken zu treffen, als zwischen zwei SΣtzen oder Pfaden der
  21133.    Programmausfⁿhrung zu wΣhlen. ▄brigens ist es eine sehr gute Idee ternΣre
  21134.    Ausdrⁿcke in Klammern zu setzen.
  21135.   </P
  21136. ><DIV
  21137. CLASS="sect1"
  21138. ><HR><H2
  21139. CLASS="sect1"
  21140. ><A
  21141. NAME="language.operators.precedence"
  21142. >Operator-Rangfolge</A
  21143. ></H2
  21144. ><P
  21145. >     Die Operator-Rangfolge legt fest, wie "eng" ein Operator zwei
  21146.     Ausdrⁿcke miteinander verbindet. Zum Beispiel ist das Ergebnis des
  21147.     Ausdruckes <VAR
  21148. CLASS="literal"
  21149. >1 + 5 * 3</VAR
  21150. > <VAR
  21151. CLASS="literal"
  21152. >16</VAR
  21153. >
  21154.     und nicht <VAR
  21155. CLASS="literal"
  21156. >18</VAR
  21157. >, da der Multiplikations-Operator
  21158.     ("*") in der Rangfolge h÷her steht als der Additions-Operator
  21159.     ("+"). Wenn n÷tig, k÷nnen Sie Klammern setzen, um die Rangfolge
  21160.     der Operatoren zu beeinflussen. Zum Beispiel ergibt: <VAR
  21161. CLASS="literal"
  21162. >(1 + 5) *
  21163.     3</VAR
  21164. > <VAR
  21165. CLASS="literal"
  21166. >18</VAR
  21167. >. Ist die Rangfolge der Operatoren gleich,
  21168.     wird links nach rechts AssoziativitΣt benutzt.
  21169.    </P
  21170. ><P
  21171. >     Die folgende Tabelle zeigt die Rangfolge der Operatoren, oben
  21172.     steht der Operator mit dem h÷chsten Rang.
  21173.  
  21174.     <DIV
  21175. CLASS="table"
  21176. ><A
  21177. NAME="AEN3788"
  21178. ></A
  21179. ><P
  21180. ><B
  21181. >Tabelle 14-1. Operator-Rangfolge</B
  21182. ></P
  21183. ><TABLE
  21184. BORDER="1"
  21185. CLASS="CALSTABLE"
  21186. ><COL><COL><THEAD
  21187. ><TR
  21188. ><TH
  21189. >AssoziativitΣt</TH
  21190. ><TH
  21191. >Operator</TH
  21192. ></TR
  21193. ></THEAD
  21194. ><TBODY
  21195. ><TR
  21196. ><TD
  21197. >keine Richtung</TD
  21198. ><TD
  21199. >new</TD
  21200. ></TR
  21201. ><TR
  21202. ><TD
  21203. >rechts</TD
  21204. ><TD
  21205. >[</TD
  21206. ></TR
  21207. ><TR
  21208. ><TD
  21209. >rechts</TD
  21210. ><TD
  21211. >          ! ~ ++ -- (int) (float) (string) (array) (object) @
  21212.         </TD
  21213. ></TR
  21214. ><TR
  21215. ><TD
  21216. >links</TD
  21217. ><TD
  21218. >* / %</TD
  21219. ></TR
  21220. ><TR
  21221. ><TD
  21222. >links</TD
  21223. ><TD
  21224. >+ - .</TD
  21225. ></TR
  21226. ><TR
  21227. ><TD
  21228. >links</TD
  21229. ><TD
  21230. ><< >></TD
  21231. ></TR
  21232. ><TR
  21233. ><TD
  21234. >keine Richtung</TD
  21235. ><TD
  21236. >< <= > >=</TD
  21237. ></TR
  21238. ><TR
  21239. ><TD
  21240. >keine Richtung</TD
  21241. ><TD
  21242. >== != === !==</TD
  21243. ></TR
  21244. ><TR
  21245. ><TD
  21246. >links</TD
  21247. ><TD
  21248. >&</TD
  21249. ></TR
  21250. ><TR
  21251. ><TD
  21252. >links</TD
  21253. ><TD
  21254. >^</TD
  21255. ></TR
  21256. ><TR
  21257. ><TD
  21258. >links</TD
  21259. ><TD
  21260. >|</TD
  21261. ></TR
  21262. ><TR
  21263. ><TD
  21264. >links</TD
  21265. ><TD
  21266. >&&</TD
  21267. ></TR
  21268. ><TR
  21269. ><TD
  21270. >links</TD
  21271. ><TD
  21272. >||</TD
  21273. ></TR
  21274. ><TR
  21275. ><TD
  21276. >links</TD
  21277. ><TD
  21278. >? :</TD
  21279. ></TR
  21280. ><TR
  21281. ><TD
  21282. >rechts</TD
  21283. ><TD
  21284. >          = += -= *= /= .= %= &= |= ^= <<= >>=
  21285.         </TD
  21286. ></TR
  21287. ><TR
  21288. ><TD
  21289. >rechts</TD
  21290. ><TD
  21291. >print</TD
  21292. ></TR
  21293. ><TR
  21294. ><TD
  21295. >links</TD
  21296. ><TD
  21297. >and</TD
  21298. ></TR
  21299. ><TR
  21300. ><TD
  21301. >links</TD
  21302. ><TD
  21303. >xor</TD
  21304. ></TR
  21305. ><TR
  21306. ><TD
  21307. >links</TD
  21308. ><TD
  21309. >or</TD
  21310. ></TR
  21311. ><TR
  21312. ><TD
  21313. >links</TD
  21314. ><TD
  21315. >,</TD
  21316. ></TR
  21317. ></TBODY
  21318. ></TABLE
  21319. ></DIV
  21320. >
  21321.    </P
  21322. ><DIV
  21323. CLASS="note"
  21324. ><BLOCKQUOTE
  21325. CLASS="note"
  21326. ><P
  21327. ><B
  21328. >Anmerkung: </B
  21329. >
  21330.      Obwohl <VAR
  21331. CLASS="literal"
  21332. >!</VAR
  21333. > einen h÷heren Rang gegenⁿber
  21334.      <VAR
  21335. CLASS="literal"
  21336. >=</VAR
  21337. > hat, erlaubt es Ihnen PHP immer noch
  21338.      Σhnliche Ausdrⁿcke wie den folgenden zu schreiben: <VAR
  21339. CLASS="literal"
  21340. >if
  21341.      (!$a =foo())</VAR
  21342. >.In diesem Ausdruck wird die Ausgabe von
  21343.      <VAR
  21344. CLASS="literal"
  21345. >foo()</VAR
  21346. > der Variablen <VAR
  21347. CLASS="varname"
  21348. >$a</VAR
  21349. >
  21350.      zugewiesen.
  21351.     </P
  21352. ></BLOCKQUOTE
  21353. ></DIV
  21354. ></DIV
  21355. ><DIV
  21356. CLASS="sect1"
  21357. ><HR><H2
  21358. CLASS="sect1"
  21359. ><A
  21360. NAME="language.operators.arithmetic"
  21361. >Arithmetische Operatoren</A
  21362. ></H2
  21363. ><P
  21364. >     Erinnern Sie sich noch an die Grundrechenarten aus der Schule? Die
  21365.     arithmetischen Operatoren funktionieren genauso:
  21366.    </P
  21367. ><DIV
  21368. CLASS="table"
  21369. ><A
  21370. NAME="AEN3866"
  21371. ></A
  21372. ><P
  21373. ><B
  21374. >Tabelle 14-2. Arithmetische Operatoren</B
  21375. ></P
  21376. ><TABLE
  21377. BORDER="1"
  21378. CLASS="CALSTABLE"
  21379. ><COL><COL><COL><THEAD
  21380. ><TR
  21381. ><TH
  21382. >Beispiel</TH
  21383. ><TH
  21384. >Name</TH
  21385. ><TH
  21386. >Ergebnis</TH
  21387. ></TR
  21388. ></THEAD
  21389. ><TBODY
  21390. ><TR
  21391. ><TD
  21392. >$a + $b</TD
  21393. ><TD
  21394. >Addition</TD
  21395. ><TD
  21396. >Summe von $a und $b.</TD
  21397. ></TR
  21398. ><TR
  21399. ><TD
  21400. >$a - $b</TD
  21401. ><TD
  21402. >Subtraktion</TD
  21403. ><TD
  21404. >Differenz von $a und $b.</TD
  21405. ></TR
  21406. ><TR
  21407. ><TD
  21408. >$a * $b</TD
  21409. ><TD
  21410. >Multiplikation</TD
  21411. ><TD
  21412. >Produkt von $a und $b.</TD
  21413. ></TR
  21414. ><TR
  21415. ><TD
  21416. >$a / $b</TD
  21417. ><TD
  21418. >Division</TD
  21419. ><TD
  21420. >Quotient von $a und  $b.</TD
  21421. ></TR
  21422. ><TR
  21423. ><TD
  21424. >$a % $b</TD
  21425. ><TD
  21426. >Modulus</TD
  21427. ><TD
  21428. >Rest von $a geteilt durch $b.</TD
  21429. ></TR
  21430. ></TBODY
  21431. ></TABLE
  21432. ></DIV
  21433. ><P
  21434. >     Der Divisions-Operator ("/") gibt immer eine Flie▀kommazahl
  21435.     zurⁿck, sogar wenn die zwei Operanden Ganzzahlen sind (oder
  21436.     Zeichenketten, die nach Ganzzahlen umgewandelt wurden).
  21437.    </P
  21438. ><P
  21439. >     Siehe auch im Handbuch das Kapitel ⁿber <A
  21440. HREF="#ref.math"
  21441. >Mathematische Funktionen</A
  21442. >.
  21443.    </P
  21444. ></DIV
  21445. ><DIV
  21446. CLASS="sect1"
  21447. ><HR><H2
  21448. CLASS="sect1"
  21449. ><A
  21450. NAME="language.operators.assignment"
  21451. >Zuweisungsoperatoren</A
  21452. ></H2
  21453. ><P
  21454. >     Der einfachste Zuweisungsoperator ist "=". Wahrscheinlich kommt
  21455.     man als erstes auf die Idee, ihn mit "ist gleich" zu bezeichnen.
  21456.     Das ist falsch. In Wirklichkeit bedeutet er, dass dem linken
  21457.     Operanden der Wert des Ausdrucks auf der rechten Seite zugewiesen
  21458.     wird (man mⁿsste ihn also mit "wird gesetzt auf den Wert von"
  21459.     ⁿbersetzen).
  21460.    </P
  21461. ><P
  21462. >     Der Wert eines Zuweisungs-Ausdruckes ist der zugewiesene Wert.
  21463.     D.h. der Wert des Ausdruckes "$a = 3" ist 3. Das erlaubt es,
  21464.     einige raffinierte Dinge anzustellen:
  21465.     <DIV
  21466. CLASS="informalexample"
  21467. ><P
  21468. ></P
  21469. ><A
  21470. NAME="AEN3902"
  21471. ></A
  21472. ><TABLE
  21473. BORDER="0"
  21474. BGCOLOR="#E0E0E0"
  21475. CELLPADDING="5"
  21476. ><TR
  21477. ><TD
  21478. ><PRE
  21479. CLASS="php"
  21480. ><?php
  21481.  
  21482. $a = ($b = 4) + 5; // $a ist nun gleich 9 und $b wurde auf den Wert 4 gesetzt.
  21483.  
  21484. ?></PRE
  21485. ></TD
  21486. ></TR
  21487. ></TABLE
  21488. ><P
  21489. ></P
  21490. ></DIV
  21491. >
  21492.    </P
  21493. ><P
  21494. >     ZusΣtzlich zu dem oben vorgestellten Zuweisungsoperator "=" gibt
  21495.     es "kombinierte Operatoren" fⁿr alle
  21496.     <A
  21497. HREF="#language.operators"
  21498. >binΣren, arithmetischen</A
  21499. > und
  21500.     String-Operatoren, die es erlauben, den Wert einer Variablen in
  21501.     einem Ausdruck zu benutzen, und dieser anschlie▀end das Ergebnis
  21502.     des Ausdrucks als neuen Wert zuzuweisen. Zum Beispiel: 
  21503.     <DIV
  21504. CLASS="informalexample"
  21505. ><P
  21506. ></P
  21507. ><A
  21508. NAME="AEN3906"
  21509. ></A
  21510. ><TABLE
  21511. BORDER="0"
  21512. BGCOLOR="#E0E0E0"
  21513. CELLPADDING="5"
  21514. ><TR
  21515. ><TD
  21516. ><PRE
  21517. CLASS="php"
  21518. ><?php
  21519.  
  21520. $a = 3;
  21521. $a += 5; // setzt $a auf den Wert 8, als ob wir geschrieben haetten: $a = $a + 5;
  21522. $b = "Hallo ";
  21523. $b .= "Du!"; // setzt $b auf den Wert "Hallo Du!", aequivalent zu 
  21524.              // $b = $b . "Du!";
  21525. ?></PRE
  21526. ></TD
  21527. ></TR
  21528. ></TABLE
  21529. ><P
  21530. ></P
  21531. ></DIV
  21532. >
  21533.    </P
  21534. ><P
  21535. >     Man beachte, dass die Zuweisung nur den Wert der Ursprungsvarialbe
  21536.     der neuen Variable zuweist (Zuweisung als Wert, sie "kopiert"),
  21537.     weshalb sich ─nderungen an der einen Variablen nicht auf die
  21538.     andere auswirken werden. Das kann wichtig sein, wenn man ein
  21539.     gro▀es Array o. Σ. in einer Schleife kopieren muss. PHP 4
  21540.     unterstⁿtzt 'assignement by reference' (Zuweisung als Verweis),
  21541.     mit Hilfe der Schreibweise <SAMP
  21542. CLASS="computeroutput"
  21543. >$var =
  21544.     &$othervar;</SAMP
  21545. >, das funktioniert jedoch nicht in
  21546.     PHP 3. 'Assignement by reference' bedeutet, dass beide Variablen
  21547.     nach der Zuweisung die selben Daten reprΣsentieren und nichts
  21548.     kopiert wird. Um mehr ⁿber Referenzen zu lernen, lesen Sie bitte
  21549.     den Abschnitt <A
  21550. HREF="#language.references"
  21551. >Referenzen
  21552.     erklΣrt</A
  21553. >.
  21554.    </P
  21555. ></DIV
  21556. ><DIV
  21557. CLASS="sect1"
  21558. ><HR><H2
  21559. CLASS="sect1"
  21560. ><A
  21561. NAME="language.operators.bitwise"
  21562. >Bit-Operatoren</A
  21563. ></H2
  21564. ><P
  21565. >     Bit-Operatoren erlauben es, in einem Integer bestimmte Bits "ein-
  21566.     oder  auszuschalten" (auf 0 oder 1 zu setzen). Wenn beide, der
  21567.     links- und rechtsseitige Parameter, Zeichenketten sind, arbeiten
  21568.     die Bit-Operatoren mit ASCII-Werten der einzelnen Zeichen.
  21569.    </P
  21570. ><P
  21571. >     <DIV
  21572. CLASS="informalexample"
  21573. ><P
  21574. ></P
  21575. ><A
  21576. NAME="AEN3915"
  21577. ></A
  21578. ><TABLE
  21579. BORDER="0"
  21580. BGCOLOR="#E0E0E0"
  21581. CELLPADDING="5"
  21582. ><TR
  21583. ><TD
  21584. ><PRE
  21585. CLASS="php"
  21586. ><?php
  21587. echo 12 ^ 9; // Ausgabe '5'
  21588.  
  21589. echo "12" ^ "9"; // Ausgabe: das Backspace-Zeichen (ascii 8)
  21590.                  // ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8
  21591.  
  21592. echo "hallo" ^ "hello"; // Gibt die ASCII-Werte #0 #4 #0 #0 #0
  21593.                         // 'a' ^ 'e' = #4 aus
  21594. ?></PRE
  21595. ></TD
  21596. ></TR
  21597. ></TABLE
  21598. ><P
  21599. ></P
  21600. ></DIV
  21601. > 
  21602.    </P
  21603. ><DIV
  21604. CLASS="table"
  21605. ><A
  21606. NAME="AEN3917"
  21607. ></A
  21608. ><P
  21609. ><B
  21610. >Tabelle 14-3. Bit-Operatoren</B
  21611. ></P
  21612. ><TABLE
  21613. BORDER="1"
  21614. CLASS="CALSTABLE"
  21615. ><COL><COL><COL><THEAD
  21616. ><TR
  21617. ><TH
  21618. >Beispiel</TH
  21619. ><TH
  21620. >Name</TH
  21621. ><TH
  21622. >Ergebnis</TH
  21623. ></TR
  21624. ></THEAD
  21625. ><TBODY
  21626. ><TR
  21627. ><TD
  21628. >$a & $b</TD
  21629. ><TD
  21630. >Und</TD
  21631. ><TD
  21632. >         Bits, die in $a und $b gesetzt sind werden gesetzt.
  21633.        </TD
  21634. ></TR
  21635. ><TR
  21636. ><TD
  21637. >$a | $b</TD
  21638. ><TD
  21639. >Oder</TD
  21640. ><TD
  21641. >         Bits, die in $a oder $b gesetzt sind werden gesetzt.
  21642.        </TD
  21643. ></TR
  21644. ><TR
  21645. ><TD
  21646. >$a ^ $b</TD
  21647. ><TD
  21648. >Entweder oder (Xor)</TD
  21649. ><TD
  21650. >         Bits, die entweder in $a oder $b gesetzt sind, werden gesetzt
  21651.         aber nicht in beiden.
  21652.        </TD
  21653. ></TR
  21654. ><TR
  21655. ><TD
  21656. >~ $a</TD
  21657. ><TD
  21658. >Nicht</TD
  21659. ><TD
  21660. >         Die Bits, die in $a nicht gesetzt sind, werden gesetzt und
  21661.         umgekehrt.
  21662.        </TD
  21663. ></TR
  21664. ><TR
  21665. ><TD
  21666. >$a << $b</TD
  21667. ><TD
  21668. >Nach links verschieben</TD
  21669. ><TD
  21670. >         Verschiebung der Bits von $a um $b Stellen nach links (jede
  21671.         Stelle entspricht einer Mulitplikation mit zwei).
  21672.        </TD
  21673. ></TR
  21674. ><TR
  21675. ><TD
  21676. >$a >> $b</TD
  21677. ><TD
  21678. >Nach rechts verschieben</TD
  21679. ><TD
  21680. >         Verschiebt die Bits von $a um $b Stellen nach rechts (jede
  21681.         Stelle entspricht einer Division durch zwei).
  21682.        </TD
  21683. ></TR
  21684. ></TBODY
  21685. ></TABLE
  21686. ></DIV
  21687. ></DIV
  21688. ><DIV
  21689. CLASS="sect1"
  21690. ><HR><H2
  21691. CLASS="sect1"
  21692. ><A
  21693. NAME="language.operators.comparison"
  21694. >Vergleichs-Operatoren</A
  21695. ></H2
  21696. ><P
  21697. >     Vergleichs-Operatoren erlauben es - wie der Name schon sagt -
  21698.     zwei Werte zu vergleichen. Wenn Sie an Beispielen verschiedener
  21699.     auf Typen bezogener Vergleiche interessiert sind, k÷nnen Sie sich
  21700.     <A
  21701. HREF="#types.comparisons"
  21702. >PHP type comparison
  21703.     tables</A
  21704. > anschauen.
  21705.    </P
  21706. ><DIV
  21707. CLASS="table"
  21708. ><A
  21709. NAME="AEN3954"
  21710. ></A
  21711. ><P
  21712. ><B
  21713. >Tabelle 14-4. Vergleichsoperatoren</B
  21714. ></P
  21715. ><TABLE
  21716. BORDER="1"
  21717. CLASS="CALSTABLE"
  21718. ><COL><COL><COL><THEAD
  21719. ><TR
  21720. ><TH
  21721. >Beispiel</TH
  21722. ><TH
  21723. >Name</TH
  21724. ><TH
  21725. >Ergebnis</TH
  21726. ></TR
  21727. ></THEAD
  21728. ><TBODY
  21729. ><TR
  21730. ><TD
  21731. >$a == $b</TD
  21732. ><TD
  21733. >Gleich</TD
  21734. ><TD
  21735. >Gibt <TT
  21736. CLASS="constant"
  21737. ><B
  21738. >TRUE</B
  21739. ></TT
  21740. > zurⁿck, wenn $a gleich $b ist.</TD
  21741. ></TR
  21742. ><TR
  21743. ><TD
  21744. >$a === $b</TD
  21745. ><TD
  21746. >Identisch</TD
  21747. ><TD
  21748. >         Gibt <TT
  21749. CLASS="constant"
  21750. ><B
  21751. >TRUE</B
  21752. ></TT
  21753. > zurⁿck wenn $a gleich $b ist und beide vom
  21754.         gleichen Typ sind(nur PHP 4).
  21755.        </TD
  21756. ></TR
  21757. ><TR
  21758. ><TD
  21759. >$a != $b</TD
  21760. ><TD
  21761. >Ungleich</TD
  21762. ><TD
  21763. >         Gibt <TT
  21764. CLASS="constant"
  21765. ><B
  21766. >TRUE</B
  21767. ></TT
  21768. > zurⁿck, wenn $a nicht gleich $b ist.
  21769.        </TD
  21770. ></TR
  21771. ><TR
  21772. ><TD
  21773. >$a <> $b</TD
  21774. ><TD
  21775. >Ungleich</TD
  21776. ><TD
  21777. >         Gibt <TT
  21778. CLASS="constant"
  21779. ><B
  21780. >TRUE</B
  21781. ></TT
  21782. > zurⁿck, wenn $a nicht gleich $b ist.
  21783.        </TD
  21784. ></TR
  21785. ><TR
  21786. ><TD
  21787. >$a !== $b</TD
  21788. ><TD
  21789. >Nicht identisch</TD
  21790. ><TD
  21791. >         Gibt <TT
  21792. CLASS="constant"
  21793. ><B
  21794. >TRUE</B
  21795. ></TT
  21796. > zurⁿck, wenn $a nicht gleich $b ist, oder wenn
  21797.         beide nicht vom gleichen Typ sind (nur PHP 4).
  21798.        </TD
  21799. ></TR
  21800. ><TR
  21801. ><TD
  21802. >$a < $b</TD
  21803. ><TD
  21804. >Kleiner Als</TD
  21805. ><TD
  21806. >Gibt <TT
  21807. CLASS="constant"
  21808. ><B
  21809. >TRUE</B
  21810. ></TT
  21811. > zurⁿck, wenn $a kleiner als $b ist.</TD
  21812. ></TR
  21813. ><TR
  21814. ><TD
  21815. >$a > $b</TD
  21816. ><TD
  21817. >Gr÷▀er Als</TD
  21818. ><TD
  21819. >Gibt <TT
  21820. CLASS="constant"
  21821. ><B
  21822. >TRUE</B
  21823. ></TT
  21824. > zurⁿck, wenn $a gr÷▀er als $b ist.</TD
  21825. ></TR
  21826. ><TR
  21827. ><TD
  21828. >$a <= $b</TD
  21829. ><TD
  21830. >Kleiner Gleich </TD
  21831. ><TD
  21832. >         Gibt <TT
  21833. CLASS="constant"
  21834. ><B
  21835. >TRUE</B
  21836. ></TT
  21837. > zurⁿck, wenn $a kleiner oder gleich $b ist.
  21838.        </TD
  21839. ></TR
  21840. ><TR
  21841. ><TD
  21842. >$a >= $b</TD
  21843. ><TD
  21844. >Gr÷▀er Gleich</TD
  21845. ><TD
  21846. >         Gibt <TT
  21847. CLASS="constant"
  21848. ><B
  21849. >TRUE</B
  21850. ></TT
  21851. > zurⁿck, wenn $a gr÷▀er oder gleich $b ist.
  21852.        </TD
  21853. ></TR
  21854. ></TBODY
  21855. ></TABLE
  21856. ></DIV
  21857. ><P
  21858. >     Ein weiter Vergleichs-Operator ist der "?:"- oder
  21859.     TrinitΣts-Operator.
  21860.     <DIV
  21861. CLASS="informalexample"
  21862. ><P
  21863. ></P
  21864. ><A
  21865. NAME="AEN4009"
  21866. ></A
  21867. ><TABLE
  21868. BORDER="0"
  21869. BGCOLOR="#E0E0E0"
  21870. CELLPADDING="5"
  21871. ><TR
  21872. ><TD
  21873. ><PRE
  21874. CLASS="php"
  21875. ><?php
  21876. // Beispielanwendung fⁿr den TrinitΣts-Operator
  21877. $action = (empty($_POST['action'])) ? 'standard' : $_POST['action'];
  21878.  
  21879. // Obiges ist mit dieser if/else-Anweisung identisch
  21880. if (empty($_POST['action'])) {
  21881.     $action = 'standard';
  21882. } else {
  21883.     $action = $_POST['action'];
  21884. }
  21885. ?></PRE
  21886. ></TD
  21887. ></TR
  21888. ></TABLE
  21889. ><P
  21890. ></P
  21891. ></DIV
  21892. > 
  21893.     Der Ausdruck <VAR
  21894. CLASS="literal"
  21895. >(ausdr1) ? (ausdr2) : (ausdr3)</VAR
  21896. >
  21897.     gibt <VAR
  21898. CLASS="replaceable"
  21899. >ausdr2</VAR
  21900. > zurⁿck, wenn
  21901.     <VAR
  21902. CLASS="replaceable"
  21903. >ausdr1</VAR
  21904. > <TT
  21905. CLASS="constant"
  21906. ><B
  21907. >TRUE</B
  21908. ></TT
  21909. > zurⁿckgibt und
  21910.     <VAR
  21911. CLASS="replaceable"
  21912. >ausdr3</VAR
  21913. >, wenn
  21914.     <VAR
  21915. CLASS="replaceable"
  21916. >ausdr1</VAR
  21917. > <TT
  21918. CLASS="constant"
  21919. ><B
  21920. >FALSE</B
  21921. ></TT
  21922. > zurⁿckgibt.
  21923.    </P
  21924. ><P
  21925. >     Siehe auch <A
  21926. HREF="#function.strcasecmp"
  21927. ><B
  21928. CLASS="function"
  21929. >strcasecmp()</B
  21930. ></A
  21931. >,
  21932.     <A
  21933. HREF="#function.strcmp"
  21934. ><B
  21935. CLASS="function"
  21936. >strcmp()</B
  21937. ></A
  21938. >,
  21939.     <A
  21940. HREF="#language.operators.array"
  21941. >Array Operatoren</A
  21942. >
  21943.     und den Abschnitt ⁿber <A
  21944. HREF="#language.types"
  21945. >Typen</A
  21946. >.
  21947.    </P
  21948. ></DIV
  21949. ><DIV
  21950. CLASS="sect1"
  21951. ><HR><H2
  21952. CLASS="sect1"
  21953. ><A
  21954. NAME="language.operators.errorcontrol"
  21955. >Fehler-Kontroll-Operatoren</A
  21956. ></H2
  21957. ><P
  21958. >     PHP unterstⁿtzt einen Operator zur Fehlerkontrolle: Das @-Symbol.
  21959.     Stellt man das @ in PHP vor einen Ausdruck werden alle
  21960.     Fehlermeldungen, die von diesem Ausdruck erzeugt werden k÷nnten,
  21961.     ignoriert.
  21962.    </P
  21963. ><P
  21964. >     Ist das <A
  21965. HREF="#ini.track-errors"
  21966. ><VAR
  21967. CLASS="option"
  21968. >track_errors</VAR
  21969. ></A
  21970. >-Feature
  21971.     aktiviert, werden alle Fehlermeldungen, die von diesem Ausdruck erzeugt
  21972.     werden, in der Variablen <A
  21973. HREF="#reserved.variables.phperrormsg"
  21974. >$php_errormsg</A
  21975. >
  21976.     gespeichert. Da diese Variable mit jedem neuen Auftreten eines
  21977.     Fehlers ⁿberschrieben wird, sollte man sie m÷glichst bald nach
  21978.     Verwendung des Ausdrucks ⁿberprⁿfen, wenn man mit ihr arbeiten
  21979.     will.
  21980.    </P
  21981. ><P
  21982. >     <DIV
  21983. CLASS="informalexample"
  21984. ><P
  21985. ></P
  21986. ><A
  21987. NAME="AEN4031"
  21988. ></A
  21989. ><TABLE
  21990. BORDER="0"
  21991. BGCOLOR="#E0E0E0"
  21992. CELLPADDING="5"
  21993. ><TR
  21994. ><TD
  21995. ><PRE
  21996. CLASS="php"
  21997. ><?php
  21998. /* Beabsichtigter Dateifehler */
  21999. $my_file = @file ('nicht_vorhandene_Datei') or
  22000.     die ("Datei konnte nicht ge÷ffnetwerden: Fehler war:'$php_errormsg'");
  22001.  
  22002. // Das funktioniert bei jedem Ausdruck, nicht nur bei Funktionen:
  22003. $value = @$cache[$key]; 
  22004. // erzeugt keine Notice, falls der Index $key nicht vorhanden ist.
  22005.  
  22006. ?></PRE
  22007. ></TD
  22008. ></TR
  22009. ></TABLE
  22010. ><P
  22011. ></P
  22012. ></DIV
  22013. >
  22014.    </P
  22015. ><DIV
  22016. CLASS="note"
  22017. ><BLOCKQUOTE
  22018. CLASS="note"
  22019. ><P
  22020. ><B
  22021. >Anmerkung: </B
  22022. >
  22023.      Der @-Operator funktioniert nur bei <A
  22024. HREF="#language.expressions"
  22025. >Ausdrⁿcken</A
  22026. >. Eine einfache
  22027.      Daumenregel: wenn Sie den Wert von etwas bestimmen k÷nnen, dann
  22028.      k÷nnen Sie den @-Operator davor schreiben. Zum Beispiel k÷nnen
  22029.      Sie ihn vor Variablen, Funktionsaufrufe und vor
  22030.      <A
  22031. HREF="#function.include"
  22032. ><B
  22033. CLASS="function"
  22034. >include()</B
  22035. ></A
  22036. > setzen, vor Konstanten und so
  22037.      weiter. Nicht verwenden k÷nnen Sie diesen Operator vor Funktions-
  22038.      oder Klassendefinitionen oder vor Kontrollstrukturen wie zum
  22039.      Beispiel <VAR
  22040. CLASS="literal"
  22041. >if</VAR
  22042. > und <VAR
  22043. CLASS="literal"
  22044. >foreach</VAR
  22045. > und
  22046.      so weiter.
  22047.     </P
  22048. ></BLOCKQUOTE
  22049. ></DIV
  22050. ><P
  22051. >     Siehe auch <A
  22052. HREF="#function.error-reporting"
  22053. ><B
  22054. CLASS="function"
  22055. >error_reporting()</B
  22056. ></A
  22057. > und den Abschnitt
  22058.     ⁿber <A
  22059. HREF="#ref.errorfunc"
  22060. >Error Handling and Logging
  22061.     Functions</A
  22062. >.
  22063.    </P
  22064. ><DIV
  22065. CLASS="note"
  22066. ><BLOCKQUOTE
  22067. CLASS="note"
  22068. ><P
  22069. ><B
  22070. >Anmerkung: </B
  22071. >
  22072.      Der @ Fehler-Kontroll-Operator verhindert jedoch keine Meldungen,
  22073.      welche aus Fehlern beim Parsen resultieren.
  22074.     </P
  22075. ></BLOCKQUOTE
  22076. ></DIV
  22077. ><DIV
  22078. CLASS="warning"
  22079. ><P
  22080. ></P
  22081. ><TABLE
  22082. CLASS="warning"
  22083. BORDER="1"
  22084. WIDTH="100%"
  22085. ><TR
  22086. ><TD
  22087. ALIGN="CENTER"
  22088. ><B
  22089. >Warnung</B
  22090. ></TD
  22091. ></TR
  22092. ><TR
  22093. ><TD
  22094. ALIGN="LEFT"
  22095. ><P
  22096. >      Zum gegenwΣrtigen Zeitpunkt deaktiviert der "@"
  22097.      Fehler-Kontrolloperator die Fehlermeldungen selbst bei kritischen
  22098.      Fehlern, die die Ausfⁿhrung eines Skripts beenden. Unter anderem
  22099.      bedeutet das, wenn Sie "@" einer bestimmten Funktion
  22100.      voranstellen, diese aber nicht zur Verfⁿgung steht oder falsch
  22101.      geschrieben wurde, Ihr PHP-Skript einfach beendet wird, ohne
  22102.      Hinweis auf die Ursache.
  22103.     </P
  22104. ></TD
  22105. ></TR
  22106. ></TABLE
  22107. ></DIV
  22108. ></DIV
  22109. ><DIV
  22110. CLASS="sect1"
  22111. ><HR><H2
  22112. CLASS="sect1"
  22113. ><A
  22114. NAME="language.operators.execution"
  22115. >Operatoren zur Programmausfⁿhrung</A
  22116. ></H2
  22117. ><P
  22118. >     PHP unterstⁿtzt einen Operator zur Ausfⁿhrung externer Programme:
  22119.     Die sog. Backticks (``). Achtung: Die Backticks sind keine
  22120.     einfachen Anfⁿhrungszeichen! PHP versucht, den Text zwischen den
  22121.     Backticks als Kommandozeilen-Befehl auszufⁿhren. Die Ausgabe des
  22122.     aufgerufenen Programms wird zurⁿckgegeben (d.h. wird nicht einfach
  22123.     ausgegeben, sondern kann einer Variablen zugewiesen werden). Die
  22124.     Verwendung des Backtick-Operators ist mit
  22125.     <A
  22126. HREF="#function.shell-exec"
  22127. ><B
  22128. CLASS="function"
  22129. >shell_exec()</B
  22130. ></A
  22131. > identisch.
  22132.     <DIV
  22133. CLASS="informalexample"
  22134. ><P
  22135. ></P
  22136. ><A
  22137. NAME="AEN4050"
  22138. ></A
  22139. ><TABLE
  22140. BORDER="0"
  22141. BGCOLOR="#E0E0E0"
  22142. CELLPADDING="5"
  22143. ><TR
  22144. ><TD
  22145. ><PRE
  22146. CLASS="php"
  22147. ><?php
  22148. $output = `ls -al`;
  22149. echo "<pre>$output</pre>";
  22150. ?></PRE
  22151. ></TD
  22152. ></TR
  22153. ></TABLE
  22154. ><P
  22155. ></P
  22156. ></DIV
  22157. >
  22158.    </P
  22159. ><DIV
  22160. CLASS="note"
  22161. ><BLOCKQUOTE
  22162. CLASS="note"
  22163. ><P
  22164. ><B
  22165. >Anmerkung: </B
  22166. >
  22167.      Der Backtick-Operator steht nicht zur Verfⁿgung, wenn <A
  22168. HREF="#ini.safe-mode"
  22169. >Safe Mode</A
  22170. >
  22171.      aktiviert ist oder die Funktion <A
  22172. HREF="#function.shell-exec"
  22173. ><B
  22174. CLASS="function"
  22175. >shell_exec()</B
  22176. ></A
  22177. >
  22178.      deaktiviert wurde.
  22179.     </P
  22180. ></BLOCKQUOTE
  22181. ></DIV
  22182. ><P
  22183. >     Siehe auch den Abschnitt ⁿber <A
  22184. HREF="#ref.exec"
  22185. >Funktionen
  22186.     zur Programmausfⁿhrung</A
  22187. >, <A
  22188. HREF="#function.popen"
  22189. ><B
  22190. CLASS="function"
  22191. >popen()</B
  22192. ></A
  22193. >,
  22194.     <A
  22195. HREF="#function.proc-open"
  22196. ><B
  22197. CLASS="function"
  22198. >proc_open()</B
  22199. ></A
  22200. > und <A
  22201. HREF="#features.commandline"
  22202. >Using PHP from the
  22203.     commandline</A
  22204. >.
  22205.    </P
  22206. ></DIV
  22207. ><DIV
  22208. CLASS="sect1"
  22209. ><HR><H2
  22210. CLASS="sect1"
  22211. ><A
  22212. NAME="language.operators.increment"
  22213. >Inkrement- bzw. Dekrementoperatoren</A
  22214. ></H2
  22215. ><P
  22216. >     PHP unterstⁿtzt PrΣ- und Post-Inkrement- und Dekrementoperatoren
  22217.     im Stil der Programmiersprache C.
  22218.    </P
  22219. ><DIV
  22220. CLASS="table"
  22221. ><A
  22222. NAME="AEN4064"
  22223. ></A
  22224. ><P
  22225. ><B
  22226. >Tabelle 14-5. Inkrement- und Dekrementoperatoren</B
  22227. ></P
  22228. ><TABLE
  22229. BORDER="1"
  22230. CLASS="CALSTABLE"
  22231. ><COL><COL><COL><THEAD
  22232. ><TR
  22233. ><TH
  22234. >Beispiel</TH
  22235. ><TH
  22236. >Name</TH
  22237. ><TH
  22238. >Auswirkung</TH
  22239. ></TR
  22240. ></THEAD
  22241. ><TBODY
  22242. ><TR
  22243. ><TD
  22244. >++$a</TD
  22245. ><TD
  22246. >PrΣ-Inkrement</TD
  22247. ><TD
  22248. >         Erh÷ht den Wert von $a um eins (inkrementiert $a) und gibt
  22249.         anschlie▀end den neuen Wert von $a zurⁿck.
  22250.        </TD
  22251. ></TR
  22252. ><TR
  22253. ><TD
  22254. >$a++</TD
  22255. ><TD
  22256. >Post-Inkrement</TD
  22257. ><TD
  22258. >         Gibt zuerst den aktuellen Wert von $a zurⁿck und erh÷ht dann
  22259.         den Wert von $a um eins.
  22260.        </TD
  22261. ></TR
  22262. ><TR
  22263. ><TD
  22264. >--$a</TD
  22265. ><TD
  22266. >PrΣ-Dekrement</TD
  22267. ><TD
  22268. >         Vermindert den Wert von $a um eins (dekrementiert $a) und gibt
  22269.         anschlie▀end den neuen Wert von $a zurⁿck.
  22270.        </TD
  22271. ></TR
  22272. ><TR
  22273. ><TD
  22274. >$a--</TD
  22275. ><TD
  22276. >Post-Dekrement</TD
  22277. ><TD
  22278. >         Gibt zuerst den aktuellen Wert von $a zurⁿck und erniedrigt
  22279.         dann den Wert von $a um eins.
  22280.        </TD
  22281. ></TR
  22282. ></TBODY
  22283. ></TABLE
  22284. ></DIV
  22285. ><P
  22286. >     Ein einfaches Beispiel-Skript:
  22287.     <DIV
  22288. CLASS="informalexample"
  22289. ><P
  22290. ></P
  22291. ><A
  22292. NAME="AEN4090"
  22293. ></A
  22294. ><TABLE
  22295. BORDER="0"
  22296. BGCOLOR="#E0E0E0"
  22297. CELLPADDING="5"
  22298. ><TR
  22299. ><TD
  22300. ><PRE
  22301. CLASS="php"
  22302. ><?php
  22303. echo "<h3>Post-Inkrement</h3>";
  22304. $a = 5;
  22305. echo "Sollte 5 sein: " . $a++ . "<br />\n";
  22306. echo "Sollte 6 sein: " . $a . "<br />\n";
  22307.  
  22308. echo "<h3>Pre-Inkrement</h3>";
  22309. $a = 5;
  22310. echo "Sollte 6 sein: " . ++$a . "<br />\n";
  22311. echo "Sollte 6 sein: " . $a . "<br />\n";
  22312.  
  22313. echo "<h3>Post-Dekrement</h3>";
  22314. $a = 5;
  22315. echo "Sollte 5 sein: " . $a-- . "<br />\n";
  22316. echo "Sollte 4 sein: " . $a . "<br />\n";
  22317.  
  22318. echo "<h3>Pre-Dekrement</h3>";
  22319. $a = 5;
  22320. echo "Sollte 4 sein: " . --$a . "<br />\n";
  22321. echo "Sollte 4 sein: " . $a . "<br />\n";
  22322. ?></PRE
  22323. ></TD
  22324. ></TR
  22325. ></TABLE
  22326. ><P
  22327. ></P
  22328. ></DIV
  22329. >
  22330.    </P
  22331. ><P
  22332. >     PHP folgt bei der Behandlung arithmetischer Operationen an
  22333.     Zeichenvariablen der Perl-Konvention und nicht der von C. Zum
  22334.     Beispiel wird in Perl aus 'Z'+1 'AA', wΣhrend aus 'Z'+1 in C '['
  22335.     wird ( ord('Z') == 90, ord('[') == 91 ). Beachten Sie, dass
  22336.     Zeichenvariablen zwar inkrementiert aber nicht dekrementiert
  22337.     werden k÷nnen.
  22338.     <TABLE
  22339. WIDTH="100%"
  22340. BORDER="0"
  22341. CELLPADDING="0"
  22342. CELLSPACING="0"
  22343. CLASS="EXAMPLE"
  22344. ><TR
  22345. ><TD
  22346. ><DIV
  22347. CLASS="example"
  22348. ><A
  22349. NAME="AEN4093"
  22350. ></A
  22351. ><P
  22352. ><B
  22353. >Beispiel 14-1. Arithmetrische Operationen an Zeichenvariablen</B
  22354. ></P
  22355. ><TABLE
  22356. BORDER="0"
  22357. BGCOLOR="#E0E0E0"
  22358. CELLPADDING="5"
  22359. ><TR
  22360. ><TD
  22361. ><PRE
  22362. CLASS="php"
  22363. ><?php
  22364. $i = 'W';
  22365. for($n=0; $n<6; $n++)
  22366.   echo ++$i . "\n";
  22367.  
  22368. /*
  22369.   Erzeugt in etwa folgende Ausgabe:
  22370.  
  22371. X
  22372. Y
  22373. Z
  22374. AA
  22375. AB
  22376. AC
  22377.  
  22378. */
  22379. ?></PRE
  22380. ></TD
  22381. ></TR
  22382. ></TABLE
  22383. ></DIV
  22384. ></TD
  22385. ></TR
  22386. ></TABLE
  22387. >
  22388.    </P
  22389. ></DIV
  22390. ><DIV
  22391. CLASS="sect1"
  22392. ><HR><H2
  22393. CLASS="sect1"
  22394. ><A
  22395. NAME="language.operators.logical"
  22396. >Logische Operatoren</A
  22397. ></H2
  22398. ><DIV
  22399. CLASS="table"
  22400. ><A
  22401. NAME="AEN4098"
  22402. ></A
  22403. ><P
  22404. ><B
  22405. >Tabelle 14-6. Logische Operatoren</B
  22406. ></P
  22407. ><TABLE
  22408. BORDER="1"
  22409. CLASS="CALSTABLE"
  22410. ><COL><COL><COL><THEAD
  22411. ><TR
  22412. ><TH
  22413. >Beispiel</TH
  22414. ><TH
  22415. >Name</TH
  22416. ><TH
  22417. >Ergebnis</TH
  22418. ></TR
  22419. ></THEAD
  22420. ><TBODY
  22421. ><TR
  22422. ><TD
  22423. >$a and $b</TD
  22424. ><TD
  22425. >Und</TD
  22426. ><TD
  22427. ><TT
  22428. CLASS="constant"
  22429. ><B
  22430. >TRUE</B
  22431. ></TT
  22432. > wenn sowohl $a als auch $b <TT
  22433. CLASS="constant"
  22434. ><B
  22435. >TRUE</B
  22436. ></TT
  22437. > ist.</TD
  22438. ></TR
  22439. ><TR
  22440. ><TD
  22441. >$a or $b</TD
  22442. ><TD
  22443. >Oder</TD
  22444. ><TD
  22445. ><TT
  22446. CLASS="constant"
  22447. ><B
  22448. >TRUE</B
  22449. ></TT
  22450. > wenn $a oder $b <TT
  22451. CLASS="constant"
  22452. ><B
  22453. >TRUE</B
  22454. ></TT
  22455. > ist.</TD
  22456. ></TR
  22457. ><TR
  22458. ><TD
  22459. >$a xor $b</TD
  22460. ><TD
  22461. >Entweder Oder</TD
  22462. ><TD
  22463. >         <TT
  22464. CLASS="constant"
  22465. ><B
  22466. >TRUE</B
  22467. ></TT
  22468. > wenn entweder $a oder $b <TT
  22469. CLASS="constant"
  22470. ><B
  22471. >TRUE</B
  22472. ></TT
  22473. > ist, aber nicht beide.
  22474.        </TD
  22475. ></TR
  22476. ><TR
  22477. ><TD
  22478. >! $a</TD
  22479. ><TD
  22480. >Nicht</TD
  22481. ><TD
  22482. ><TT
  22483. CLASS="constant"
  22484. ><B
  22485. >TRUE</B
  22486. ></TT
  22487. > wenn $a nicht <TT
  22488. CLASS="constant"
  22489. ><B
  22490. >TRUE</B
  22491. ></TT
  22492. > ist.</TD
  22493. ></TR
  22494. ><TR
  22495. ><TD
  22496. >$a && $b</TD
  22497. ><TD
  22498. >Und</TD
  22499. ><TD
  22500. ><TT
  22501. CLASS="constant"
  22502. ><B
  22503. >TRUE</B
  22504. ></TT
  22505. > wenn sowohl $a als auch $b <TT
  22506. CLASS="constant"
  22507. ><B
  22508. >TRUE</B
  22509. ></TT
  22510. > ist.</TD
  22511. ></TR
  22512. ><TR
  22513. ><TD
  22514. >$a || $b</TD
  22515. ><TD
  22516. >Oder</TD
  22517. ><TD
  22518. ><TT
  22519. CLASS="constant"
  22520. ><B
  22521. >TRUE</B
  22522. ></TT
  22523. > wenn $a oder $b <TT
  22524. CLASS="constant"
  22525. ><B
  22526. >TRUE</B
  22527. ></TT
  22528. > ist.</TD
  22529. ></TR
  22530. ></TBODY
  22531. ></TABLE
  22532. ></DIV
  22533. ><P
  22534. >     Der Grund dafⁿr, dass es je zwei unterschiedliche Operatoren fⁿr 
  22535.     die "Und"- und die "Oder"-Verknⁿpfung gibt ist der, dass die beiden
  22536.     Operatoren jeweils Rangfolgen haben. (siehe auch <A
  22537. HREF="#language.operators.precedence"
  22538. >Operator-Rangfolge</A
  22539. >.)
  22540.    </P
  22541. ></DIV
  22542. ><DIV
  22543. CLASS="sect1"
  22544. ><HR><H2
  22545. CLASS="sect1"
  22546. ><A
  22547. NAME="language.operators.string"
  22548. >Zeichenketten-Operatoren</A
  22549. ></H2
  22550. ><P
  22551. >     Es gibt in PHP zwei Operatoren fⁿr <A
  22552. HREF="#language.types.string"
  22553. ><B
  22554. CLASS="type"
  22555. >string</B
  22556. ></A
  22557. >
  22558.     (Zeichenkette). Der erste ist der Vereinigungs-Operator ('.'),
  22559.     dessen Rⁿckgabewert eine zusammengesetzte Zeichenkette aus dem
  22560.     rechten und dem linken Argument ist. Der zweite ist der
  22561.     Vereinigungs-Zuweisungsoperator ('.='), der das Argument auf der
  22562.     rechten Seite an das Argument der linken Seite anhΣngt. Siehe
  22563.     <A
  22564. HREF="#language.operators.assignment"
  22565. >Zuweisungs-Operatoren</A
  22566. >
  22567.     fⁿr weitere Informationen.
  22568.    </P
  22569. ><P
  22570. >     <DIV
  22571. CLASS="informalexample"
  22572. ><P
  22573. ></P
  22574. ><A
  22575. NAME="AEN4151"
  22576. ></A
  22577. ><TABLE
  22578. BORDER="0"
  22579. BGCOLOR="#E0E0E0"
  22580. CELLPADDING="5"
  22581. ><TR
  22582. ><TD
  22583. ><PRE
  22584. CLASS="php"
  22585. ><?php
  22586. $a = "Hallo ";
  22587. $b = $a . "Welt!"; // $b enthΣlt jetzt den Text "Hallo Welt!"
  22588.  
  22589. $a = "Hallo ";
  22590. $a .= "Welt!";    // $a enthΣlt jetzt den Text "Hallo Welt!"
  22591. ?></PRE
  22592. ></TD
  22593. ></TR
  22594. ></TABLE
  22595. ><P
  22596. ></P
  22597. ></DIV
  22598. >
  22599.    </P
  22600. ><P
  22601. >     Siehe auch die Abschnitte ⁿber <A
  22602. HREF="#language.types.string"
  22603. >Strings / Zeichenketten</A
  22604. > und
  22605.     <A
  22606. HREF="#ref.strings"
  22607. >String-Funktionen</A
  22608. >.
  22609.    </P
  22610. ></DIV
  22611. ><DIV
  22612. CLASS="sect1"
  22613. ><HR><H2
  22614. CLASS="sect1"
  22615. ><A
  22616. NAME="language.operators.array"
  22617. >Array Operatoren</A
  22618. ></H2
  22619. ><DIV
  22620. CLASS="table"
  22621. ><A
  22622. NAME="AEN4158"
  22623. ></A
  22624. ><P
  22625. ><B
  22626. >Tabelle 14-7. Array Operatoren</B
  22627. ></P
  22628. ><TABLE
  22629. BORDER="1"
  22630. CLASS="CALSTABLE"
  22631. ><COL><COL><COL><THEAD
  22632. ><TR
  22633. ><TH
  22634. >Beispiel</TH
  22635. ><TH
  22636. >Name</TH
  22637. ><TH
  22638. >Ergebnis</TH
  22639. ></TR
  22640. ></THEAD
  22641. ><TBODY
  22642. ><TR
  22643. ><TD
  22644. >$a + $b</TD
  22645. ><TD
  22646. >Vereinigung</TD
  22647. ><TD
  22648. >Verinigung von $a und $b.</TD
  22649. ></TR
  22650. ><TR
  22651. ><TD
  22652. >$a == $b</TD
  22653. ><TD
  22654. >Gleichwerigkeit</TD
  22655. ><TD
  22656. ><TT
  22657. CLASS="constant"
  22658. ><B
  22659. >TRUE</B
  22660. ></TT
  22661. > wenn $a und $b die gleichen Elemente enthalten.</TD
  22662. ></TR
  22663. ><TR
  22664. ><TD
  22665. >$a === $b</TD
  22666. ><TD
  22667. >IdentitΣt</TD
  22668. ><TD
  22669. >         <TT
  22670. CLASS="constant"
  22671. ><B
  22672. >TRUE</B
  22673. ></TT
  22674. > wenn $a und $b die gleichen Elemente in der gleichen
  22675.         Reihenfolge enthalten.
  22676.        </TD
  22677. ></TR
  22678. ><TR
  22679. ><TD
  22680. >$a != $b</TD
  22681. ><TD
  22682. >Ungleichheit</TD
  22683. ><TD
  22684. ><TT
  22685. CLASS="constant"
  22686. ><B
  22687. >TRUE</B
  22688. ></TT
  22689. > wenn $a nicht gleich $b ist.</TD
  22690. ></TR
  22691. ><TR
  22692. ><TD
  22693. >$a <> $b</TD
  22694. ><TD
  22695. >Ungleichheit</TD
  22696. ><TD
  22697. ><TT
  22698. CLASS="constant"
  22699. ><B
  22700. >TRUE</B
  22701. ></TT
  22702. > wenn $a nicht gleich $b ist.</TD
  22703. ></TR
  22704. ><TR
  22705. ><TD
  22706. >$a !== $b</TD
  22707. ><TD
  22708. >nicht identisch</TD
  22709. ><TD
  22710. ><TT
  22711. CLASS="constant"
  22712. ><B
  22713. >TRUE</B
  22714. ></TT
  22715. > wenn $a nicht identisch zu $b ist.</TD
  22716. ></TR
  22717. ></TBODY
  22718. ></TABLE
  22719. ></DIV
  22720. ><P
  22721. >     Der <VAR
  22722. CLASS="literal"
  22723. >+</VAR
  22724. > Operator hΣngt das rechsstehende Array an das
  22725.     linksstehende Array an, wobei doppelte Schlⁿssel NICHT ⁿberschrieben
  22726.     werden.
  22727.    </P
  22728. ><P
  22729. >     <DIV
  22730. CLASS="informalexample"
  22731. ><P
  22732. ></P
  22733. ><A
  22734. NAME="AEN4199"
  22735. ></A
  22736. ><TABLE
  22737. BORDER="0"
  22738. BGCOLOR="#E0E0E0"
  22739. CELLPADDING="5"
  22740. ><TR
  22741. ><TD
  22742. ><PRE
  22743. CLASS="php"
  22744. ><?php
  22745. $a = array("a" => "Apfel", "b" => "Banane");
  22746. $b = array("a" =>"pear", "b" => "Erdbeere", "c" => "Kirsche");
  22747.  
  22748. $c = $a + $b; // Verinigung von $a mit $b;
  22749. echo "Vereinigung von \$a mit \$b: \n";
  22750. var_dump($c);
  22751.  
  22752. $c = $b + $a; // Vereinigung von $b mit $a;
  22753. echo "Vereinigung von \$b mit \$a: \n";
  22754. var_dump($c);
  22755. ?></PRE
  22756. ></TD
  22757. ></TR
  22758. ></TABLE
  22759. ><P
  22760. ></P
  22761. ></DIV
  22762. >
  22763.     Dieses Skript gibt folgendes aus:
  22764.     <TABLE
  22765. BORDER="0"
  22766. BGCOLOR="#E0E0E0"
  22767. CELLPADDING="5"
  22768. ><TR
  22769. ><TD
  22770. ><PRE
  22771. CLASS="php"
  22772. >Vereinigung von $a mit $b:
  22773. array(3) {
  22774.   ["a"]=>
  22775.   string(5) "Apfel"
  22776.   ["b"]=>
  22777.   string(6) "Banane"
  22778.   ["c"]=>
  22779.   string(7) "Kirsche"
  22780. }
  22781. Vereinigung von $b mit $a:
  22782. array(3) {
  22783.   ["a"]=>
  22784.   string(4) "pear"
  22785.   ["b"]=>
  22786.   string(8) "Erdbeere"
  22787.   ["c"]=>
  22788.   string(7) "Kirsche"
  22789. }</PRE
  22790. ></TD
  22791. ></TR
  22792. ></TABLE
  22793. >
  22794.    </P
  22795. ><P
  22796. >     Beim Vergleich werden Arrayelemente als gleich angesehen, wenn diese
  22797.     dieselben Schlⁿssel und Werte beinhalten.
  22798.    </P
  22799. ><P
  22800. >     <TABLE
  22801. WIDTH="100%"
  22802. BORDER="0"
  22803. CELLPADDING="0"
  22804. CELLSPACING="0"
  22805. CLASS="EXAMPLE"
  22806. ><TR
  22807. ><TD
  22808. ><DIV
  22809. CLASS="example"
  22810. ><A
  22811. NAME="AEN4204"
  22812. ></A
  22813. ><P
  22814. ><B
  22815. >Beispiel 14-2. Array Vergleiche</B
  22816. ></P
  22817. ><TABLE
  22818. BORDER="0"
  22819. BGCOLOR="#E0E0E0"
  22820. CELLPADDING="5"
  22821. ><TR
  22822. ><TD
  22823. ><PRE
  22824. CLASS="php"
  22825. ><?php
  22826. $a = array("a" => "Apfel", "b" => "Banane");
  22827. $b = array(1 => "Banane", "0" => "Apfel");
  22828.  
  22829. var_dump($a == $b); // bool(true)
  22830. var_dump($a === $b); // bool(false)
  22831. ?></PRE
  22832. ></TD
  22833. ></TR
  22834. ></TABLE
  22835. ></DIV
  22836. ></TD
  22837. ></TR
  22838. ></TABLE
  22839. >
  22840.    </P
  22841. ><P
  22842. >     Siehe auch die Abschnitte ⁿber <A
  22843. HREF="#language.types.array"
  22844. >Arrays</A
  22845. > und <A
  22846. HREF="#ref.array"
  22847. >Array Funktionen</A
  22848. >.
  22849.    </P
  22850. ></DIV
  22851. ><DIV
  22852. CLASS="sect1"
  22853. ><HR><H2
  22854. CLASS="sect1"
  22855. ><A
  22856. NAME="language.operators.type"
  22857. >Typ Operatoren</A
  22858. ></H2
  22859. ><P
  22860. >     In PHP gibt es einen einzigen Typ Operator: <VAR
  22861. CLASS="literal"
  22862. >instanceof</VAR
  22863. >.
  22864.     <VAR
  22865. CLASS="literal"
  22866. >instanceof</VAR
  22867. > wird dazu verwendet um festzustellen, ob ein
  22868.     gegebenes Objekt ein Objekt ist, das zu einer bestimmten
  22869.     <A
  22870. HREF="#language.oop"
  22871. >Klasse</A
  22872. > geh÷rt.
  22873.    </P
  22874. ><P
  22875. >     <VAR
  22876. CLASS="literal"
  22877. >instanceof</VAR
  22878. > wurde in PHP 5 eingefⁿhrt. Vorher wurde <A
  22879. HREF="#function.is-a"
  22880. ><B
  22881. CLASS="function"
  22882. >is_a()</B
  22883. ></A
  22884. >
  22885.     benutzt, aber <A
  22886. HREF="#function.is-a"
  22887. ><B
  22888. CLASS="function"
  22889. >is_a()</B
  22890. ></A
  22891. > ist veraltet und <VAR
  22892. CLASS="literal"
  22893. >instanceof</VAR
  22894. > sollte
  22895.     stattdessen benutzt werden.
  22896.    </P
  22897. ><DIV
  22898. CLASS="informalexample"
  22899. ><P
  22900. ></P
  22901. ><A
  22902. NAME="AEN4221"
  22903. ></A
  22904. ><TABLE
  22905. BORDER="0"
  22906. BGCOLOR="#E0E0E0"
  22907. CELLPADDING="5"
  22908. ><TR
  22909. ><TD
  22910. ><PRE
  22911. CLASS="programlisting"
  22912. ><?php
  22913. class A { }
  22914. class B { }
  22915.  
  22916. $ding = new A;
  22917.  
  22918. if ($ding instanceof A) {
  22919.     echo 'A';
  22920. }
  22921. if ($ding instanceof B) {
  22922.     echo 'B';
  22923. }
  22924. ?></PRE
  22925. ></TD
  22926. ></TR
  22927. ></TABLE
  22928. ><P
  22929. >      Da <VAR
  22930. CLASS="varname"
  22931. >$ding</VAR
  22932. > ein <A
  22933. HREF="#language.types.object"
  22934. ><B
  22935. CLASS="type"
  22936. >object</B
  22937. ></A
  22938. > vom Typ A und nicht
  22939.      von B ist, wird nur der Programmblock ausgefⁿhrt, der abhΣngig von Typ A ist:
  22940.     </P
  22941. ><TABLE
  22942. BORDER="0"
  22943. BGCOLOR="#E0E0E0"
  22944. CELLPADDING="5"
  22945. ><TR
  22946. ><TD
  22947. ><PRE
  22948. CLASS="screen"
  22949. >A</PRE
  22950. ></TD
  22951. ></TR
  22952. ></TABLE
  22953. ><P
  22954. ></P
  22955. ></DIV
  22956. ><P
  22957. >     See auch <A
  22958. HREF="#function.get-class"
  22959. ><B
  22960. CLASS="function"
  22961. >get_class()</B
  22962. ></A
  22963. > und 
  22964.     <A
  22965. HREF="#function.is-a"
  22966. ><B
  22967. CLASS="function"
  22968. >is_a()</B
  22969. ></A
  22970. >.
  22971.    </P
  22972. ></DIV
  22973. ></DIV
  22974. ><DIV
  22975. CLASS="chapter"
  22976. ><HR><H1
  22977. ><A
  22978. NAME="language.control-structures"
  22979. >Kapitel 15. Kontroll-Strukturen</A
  22980. ></H1
  22981. ><P
  22982. >    Jedes PHP-Skript besteht aus einer Reihe von Anweisungen. Eine Anweisung
  22983.    kann eine Zuweisung, ein Funktionsaufruf, eine Schleife, eine bedingte
  22984.    Anweisung oder ein Befehl sein, der nichts macht (eine leere Anweisung). 
  22985.    Jede Anweisung endet gew÷hnlich mit einem Semikolon. Darⁿber hinaus k÷nnen Anweisungen zu einer
  22986.    Anweisungsgruppe zusammengefasst werden, welche durch geschweifte Klammern
  22987.    begrenzt wird. Eine Anweisungsgruppe selbst ist auch wieder eine Anweisung.
  22988.    Die unterschiedlichen Arten von Anweisungen werden in diesem Kapitel
  22989.    erlΣutert.
  22990.   </P
  22991. ><DIV
  22992. CLASS="sect1"
  22993. ><HR><H2
  22994. CLASS="sect1"
  22995. ><A
  22996. NAME="control-structures.if"
  22997. ><VAR
  22998. CLASS="literal"
  22999. >if</VAR
  23000. ></A
  23001. ></H2
  23002. ><P
  23003. >     Das <VAR
  23004. CLASS="literal"
  23005. >if</VAR
  23006. >-Konstrukt ist eine der wichtigsten M÷glichkeiten
  23007.     vieler Programmier-Sprachen, PHP eingeschlossen. Es erlaubt die bedingte
  23008.     Ausfⁿhrung von Programmteilen. PHP kennt eine <VAR
  23009. CLASS="literal"
  23010. >if</VAR
  23011. >
  23012.     -Struktur, die Σhnlich wie in der Programmiersprache C implementiert ist:
  23013.     <DIV
  23014. CLASS="informalexample"
  23015. ><P
  23016. ></P
  23017. ><A
  23018. NAME="AEN4239"
  23019. ></A
  23020. ><TABLE
  23021. BORDER="0"
  23022. BGCOLOR="#E0E0E0"
  23023. CELLPADDING="5"
  23024. ><TR
  23025. ><TD
  23026. ><PRE
  23027. CLASS="programlisting"
  23028. ><?php
  23029.   if (ausdr)
  23030.     Anweisung
  23031. ?></PRE
  23032. ></TD
  23033. ></TR
  23034. ></TABLE
  23035. ><P
  23036. ></P
  23037. ></DIV
  23038. >
  23039.    </P
  23040. ><P
  23041. >     Wie im Abschnitt ⁿber
  23042.     <A
  23043. HREF="#language.expressions"
  23044. >Ausdrⁿcke</A
  23045. > beschrieben,
  23046.     wird <VAR
  23047. CLASS="replaceable"
  23048. >ausdr</VAR
  23049. > auf seinen boolschen Wertinhalt
  23050.     ausgewertet. Wenn <VAR
  23051. CLASS="replaceable"
  23052. >ausdr</VAR
  23053. > als <TT
  23054. CLASS="constant"
  23055. ><B
  23056. >TRUE</B
  23057. ></TT
  23058. > ausgewertet
  23059.     wird, fⁿhrt PHP die <VAR
  23060. CLASS="replaceable"
  23061. >Anweisung</VAR
  23062. > aus. Falls die
  23063.     Auswertung <TT
  23064. CLASS="constant"
  23065. ><B
  23066. >FALSE</B
  23067. ></TT
  23068. > ergibt, wird die <VAR
  23069. CLASS="replaceable"
  23070. >Anweisung</VAR
  23071. >
  23072.     ⁿbergangen. Mehr Informationen drⁿber welche Werte als <TT
  23073. CLASS="constant"
  23074. ><B
  23075. >FALSE</B
  23076. ></TT
  23077. > ausgewertet
  23078.     werden finden Sie im Abschnitt
  23079.     <A
  23080. HREF="#language.types.boolean.casting"
  23081. >'Umwandlung nach boolean'</A
  23082. >.
  23083.    </P
  23084. ><P
  23085. >     Das folgende Beispiel wird <SAMP
  23086. CLASS="computeroutput"
  23087. >a ist gr÷▀er als b
  23088.     </SAMP
  23089. >anzeigen, wenn <VAR
  23090. CLASS="varname"
  23091. >$a</VAR
  23092. > gr÷▀er als
  23093.     <VAR
  23094. CLASS="varname"
  23095. >$b</VAR
  23096. > ist:
  23097.     <DIV
  23098. CLASS="informalexample"
  23099. ><P
  23100. ></P
  23101. ><A
  23102. NAME="AEN4255"
  23103. ></A
  23104. ><TABLE
  23105. BORDER="0"
  23106. BGCOLOR="#E0E0E0"
  23107. CELLPADDING="5"
  23108. ><TR
  23109. ><TD
  23110. ><PRE
  23111. CLASS="php"
  23112. ><?php
  23113. if ($a > $b)
  23114.     echo "a ist gr÷▀er als b";
  23115. ?></PRE
  23116. ></TD
  23117. ></TR
  23118. ></TABLE
  23119. ><P
  23120. ></P
  23121. ></DIV
  23122. >
  23123.    </P
  23124. ><P
  23125. >     Oft werden Sie die bedingte Ausfⁿhrung von mehr als einer
  23126.     Anweisung wollen. SelbstverstΣndlich ist es nicht erforderlich,
  23127.     jede Anweisung mit einer <VAR
  23128. CLASS="literal"
  23129. >if</VAR
  23130. >-Bedingung zu
  23131.     versehen. Statt dessen k÷nnen Sie mehrere Anweisungen in Gruppen
  23132.     zusammenfassen. Der folgende Programm-Code wird zum Beispiel
  23133.     <SAMP
  23134. CLASS="computeroutput"
  23135. >a ist gr÷▀er als b</SAMP
  23136. > anzeigen,
  23137.     wenn <VAR
  23138. CLASS="varname"
  23139. >$a</VAR
  23140. > gr÷▀er als <VAR
  23141. CLASS="varname"
  23142. >$b</VAR
  23143. > ist und
  23144.     danach wird der Wert von <VAR
  23145. CLASS="varname"
  23146. >$a</VAR
  23147. > in <VAR
  23148. CLASS="varname"
  23149. >$b</VAR
  23150. >
  23151.     gespeichert:
  23152.     <DIV
  23153. CLASS="informalexample"
  23154. ><P
  23155. ></P
  23156. ><A
  23157. NAME="AEN4264"
  23158. ></A
  23159. ><TABLE
  23160. BORDER="0"
  23161. BGCOLOR="#E0E0E0"
  23162. CELLPADDING="5"
  23163. ><TR
  23164. ><TD
  23165. ><PRE
  23166. CLASS="php"
  23167. ><?php
  23168. if ($a > $b) {
  23169.     print "a ist gr÷▀er als b";
  23170.     $b = $a;
  23171. }
  23172. ?></PRE
  23173. ></TD
  23174. ></TR
  23175. ></TABLE
  23176. ><P
  23177. ></P
  23178. ></DIV
  23179. >
  23180.    </P
  23181. ><P
  23182. >     <VAR
  23183. CLASS="literal"
  23184. >if</VAR
  23185. >-Anweisungen k÷nnen beliebig oft innerhalb anderer
  23186.     <VAR
  23187. CLASS="literal"
  23188. >if</VAR
  23189. >-Anweisungen definiert werden. Das erm÷glicht
  23190.     ihnen v÷llige FlexibilitΣt bei der bedingten Ausfⁿhrung verschiedenster
  23191.     Programmteile.
  23192.    </P
  23193. ></DIV
  23194. ><DIV
  23195. CLASS="sect1"
  23196. ><HR><H2
  23197. CLASS="sect1"
  23198. ><A
  23199. NAME="control-structures.else"
  23200. ><VAR
  23201. CLASS="literal"
  23202. >else</VAR
  23203. ></A
  23204. ></H2
  23205. ><P
  23206. >     HΣufig m÷chten Sie eine Anweisung auszufⁿhren, wenn eine
  23207.     bestimmte Bedingung erfⁿllt ist und eine andere Anweisung, falls
  23208.     sie nicht erfⁿllt ist. Dafⁿr gibt es <VAR
  23209. CLASS="literal"
  23210. >else</VAR
  23211. >.
  23212.     <VAR
  23213. CLASS="literal"
  23214. >else</VAR
  23215. > erweitert eine <VAR
  23216. CLASS="literal"
  23217. >if</VAR
  23218. >-Anweisung um
  23219.     die Ausfⁿhrung von Anweisungen, sobald der Ausdruck der
  23220.     <VAR
  23221. CLASS="literal"
  23222. >if</VAR
  23223. >-Anweisung als <TT
  23224. CLASS="constant"
  23225. ><B
  23226. >FALSE</B
  23227. ></TT
  23228. > ausgewertet wird. Der folgende
  23229.     Code wird z.B. <SAMP
  23230. CLASS="computeroutput"
  23231. >a ist gr÷▀er als b</SAMP
  23232. >
  23233.     ausgeben, wenn <VAR
  23234. CLASS="varname"
  23235. >$a</VAR
  23236. > gr÷▀er als <VAR
  23237. CLASS="varname"
  23238. >$b</VAR
  23239. > ist,
  23240.     anderenfalls <SAMP
  23241. CLASS="computeroutput"
  23242. >a ist NICHT gr÷▀er als b</SAMP
  23243. >:
  23244.     <DIV
  23245. CLASS="informalexample"
  23246. ><P
  23247. ></P
  23248. ><A
  23249. NAME="AEN4282"
  23250. ></A
  23251. ><TABLE
  23252. BORDER="0"
  23253. BGCOLOR="#E0E0E0"
  23254. CELLPADDING="5"
  23255. ><TR
  23256. ><TD
  23257. ><PRE
  23258. CLASS="php"
  23259. ><?php
  23260. if ($a > $b) {
  23261.     print "a ist gr÷▀er als b";
  23262. } else {
  23263.     print "a ist NICHT gr÷▀er als b";
  23264. }
  23265. ?></PRE
  23266. ></TD
  23267. ></TR
  23268. ></TABLE
  23269. ><P
  23270. ></P
  23271. ></DIV
  23272. >
  23273.     Die <VAR
  23274. CLASS="literal"
  23275. >else</VAR
  23276. >-Anweisung wird nur ausgefⁿhrt, wenn
  23277.     der <VAR
  23278. CLASS="literal"
  23279. >if</VAR
  23280. >-Ausdruck als <TT
  23281. CLASS="constant"
  23282. ><B
  23283. >FALSE</B
  23284. ></TT
  23285. >
  23286.     ausgewertet wurde und wenn bei vorhandenen
  23287.     <VAR
  23288. CLASS="literal"
  23289. >elseif</VAR
  23290. >-Ausdrⁿcken diese ebenfalls
  23291.     <TT
  23292. CLASS="constant"
  23293. ><B
  23294. >FALSE</B
  23295. ></TT
  23296. > sind (siehe <A
  23297. HREF="#control-structures.elseif"
  23298. >elseif</A
  23299. >).
  23300.    </P
  23301. ></DIV
  23302. ><DIV
  23303. CLASS="sect1"
  23304. ><HR><H2
  23305. CLASS="sect1"
  23306. ><A
  23307. NAME="control-structures.elseif"
  23308. ><VAR
  23309. CLASS="literal"
  23310. >elseif</VAR
  23311. ></A
  23312. ></H2
  23313. ><P
  23314. >     Wie der Name schon sagt ist <VAR
  23315. CLASS="literal"
  23316. >elseif</VAR
  23317. > eine
  23318.     Verbindung von <VAR
  23319. CLASS="literal"
  23320. >if</VAR
  23321. > und <VAR
  23322. CLASS="literal"
  23323. >else</VAR
  23324. >.
  23325.     Wie <VAR
  23326. CLASS="literal"
  23327. >else</VAR
  23328. > erweitert sie eine
  23329.     <VAR
  23330. CLASS="literal"
  23331. >if</VAR
  23332. >-Anweisung um die Ausfⁿhrung anderer Anweisungen,
  23333.     sobald die normale <VAR
  23334. CLASS="literal"
  23335. >if</VAR
  23336. >-Bedingung als <TT
  23337. CLASS="constant"
  23338. ><B
  23339. >FALSE</B
  23340. ></TT
  23341. > ausgewertet
  23342.     wird. Anders als bei <VAR
  23343. CLASS="literal"
  23344. >else</VAR
  23345. > wird die Ausfⁿhrung dieser alternativen
  23346.     Anweisungen nur durchgefⁿhrt, wenn die bei <VAR
  23347. CLASS="literal"
  23348. >elseif</VAR
  23349. >
  23350.     angegebene alternative Bedingung als <TT
  23351. CLASS="constant"
  23352. ><B
  23353. >TRUE</B
  23354. ></TT
  23355. > ausgewertet wird. Der folgende
  23356.     Code wird z.B. <SAMP
  23357. CLASS="computeroutput"
  23358. >a ist gr÷▀er als b</SAMP
  23359. >,
  23360.     <SAMP
  23361. CLASS="computeroutput"
  23362. >a ist gleich b</SAMP
  23363. > oder
  23364.     <SAMP
  23365. CLASS="computeroutput"
  23366. >a ist kleiner als b</SAMP
  23367. > ausgeben:
  23368.     <DIV
  23369. CLASS="informalexample"
  23370. ><P
  23371. ></P
  23372. ><A
  23373. NAME="AEN4307"
  23374. ></A
  23375. ><TABLE
  23376. BORDER="0"
  23377. BGCOLOR="#E0E0E0"
  23378. CELLPADDING="5"
  23379. ><TR
  23380. ><TD
  23381. ><PRE
  23382. CLASS="php"
  23383. ><?php
  23384. if ($a > $b) {
  23385.     echo "a ist gr÷▀er als b";
  23386. } elseif ($a == $b) {
  23387.     echo "a ist gleich b";
  23388. } else {
  23389.     echo "a ist kleiner als b";
  23390. }
  23391. ?></PRE
  23392. ></TD
  23393. ></TR
  23394. ></TABLE
  23395. ><P
  23396. ></P
  23397. ></DIV
  23398. >
  23399.    </P
  23400. ><P
  23401. >     Es kann mehrere <VAR
  23402. CLASS="literal"
  23403. >elseif</VAR
  23404. >-Anweisungen innerhalb
  23405.     einer <VAR
  23406. CLASS="literal"
  23407. >if</VAR
  23408. >-Anweisung geben. Die erste
  23409.     <VAR
  23410. CLASS="literal"
  23411. >elseif</VAR
  23412. >-Bedingung (falls vorhanden), die <TT
  23413. CLASS="constant"
  23414. ><B
  23415. >TRUE</B
  23416. ></TT
  23417. > ist,
  23418.     wird ausgefⁿhrt. In PHP kann man auch 'else if' schreiben (zwei W÷rter).
  23419.     Das Verhalten ist identisch zu 'elseif' (ein Wort). Die Bedeutung der
  23420.     Syntax ist leicht unterschiedlich (falls Sie mit C vertraut sind, das ist
  23421.     das gleiche Verhalten) aber der Grundtenor ist der, dass beide
  23422.     Schreibweisen, bezogen auf das Ergebnis, sich exakt gleich verhalten.
  23423.    </P
  23424. ><P
  23425. >     Die <VAR
  23426. CLASS="literal"
  23427. >elseif</VAR
  23428. >-Anweisung wird nur ausgefⁿhrt, wenn die
  23429.     vorausgehende <VAR
  23430. CLASS="literal"
  23431. >if</VAR
  23432. >-Bedingung sowie jede vorherige
  23433.     <VAR
  23434. CLASS="literal"
  23435. >elseif</VAR
  23436. >-Bedingung als <TT
  23437. CLASS="constant"
  23438. ><B
  23439. >FALSE</B
  23440. ></TT
  23441. > ausgewertet wird und die
  23442.     aktuelle <VAR
  23443. CLASS="literal"
  23444. >elseif</VAR
  23445. >-Bedingung <TT
  23446. CLASS="constant"
  23447. ><B
  23448. >TRUE</B
  23449. ></TT
  23450. > ist.
  23451.    </P
  23452. ></DIV
  23453. ><DIV
  23454. CLASS="sect1"
  23455. ><HR><H2
  23456. CLASS="sect1"
  23457. ><A
  23458. NAME="control-structures.alternative-syntax"
  23459. >Alternative Syntax fⁿr Kontroll-Strukturen</A
  23460. ></H2
  23461. ><P
  23462. >     PHP bietet eine alternative Syntax fⁿr einige seiner Kontroll-Strukturen,
  23463.     als da sind <VAR
  23464. CLASS="literal"
  23465. >if</VAR
  23466. >, <VAR
  23467. CLASS="literal"
  23468. >while</VAR
  23469. >,
  23470.     <VAR
  23471. CLASS="literal"
  23472. >for</VAR
  23473. >, <VAR
  23474. CLASS="literal"
  23475. >foreach</VAR
  23476. > und
  23477.     <VAR
  23478. CLASS="literal"
  23479. >switch</VAR
  23480. >. Die ÷ffnende Klammer muss immer durch einen
  23481.     Doppelpunkt ":" und die schlie▀ende Klammer entsprechend durch
  23482.     <VAR
  23483. CLASS="literal"
  23484. >endif;</VAR
  23485. >, <VAR
  23486. CLASS="literal"
  23487. >endwhile;</VAR
  23488. >,
  23489.     <VAR
  23490. CLASS="literal"
  23491. >endfor;</VAR
  23492. >, <VAR
  23493. CLASS="literal"
  23494. >endforeach;</VAR
  23495. >
  23496.     oder <VAR
  23497. CLASS="literal"
  23498. >endswitch;</VAR
  23499. > ersetzt werden.
  23500.     <DIV
  23501. CLASS="informalexample"
  23502. ><P
  23503. ></P
  23504. ><A
  23505. NAME="AEN4334"
  23506. ></A
  23507. ><TABLE
  23508. BORDER="0"
  23509. BGCOLOR="#E0E0E0"
  23510. CELLPADDING="5"
  23511. ><TR
  23512. ><TD
  23513. ><PRE
  23514. CLASS="php"
  23515. ><?php if ($a == 5): ?>
  23516. A ist gleich 5
  23517. <?php endif; ?></PRE
  23518. ></TD
  23519. ></TR
  23520. ></TABLE
  23521. ><P
  23522. ></P
  23523. ></DIV
  23524. >
  23525.    </P
  23526. ><P
  23527. >     Im obigen Beispiel ist der HTML-Bereich "A ist gleich 5" in eine
  23528.     <VAR
  23529. CLASS="literal"
  23530. >if</VAR
  23531. >-Anweisung mit alternativer Syntax eingebettet. Der
  23532.     HTML-Bereich wird nur ausgegeben, wenn <VAR
  23533. CLASS="varname"
  23534. >$a</VAR
  23535. > gleich 5 ist.
  23536.    </P
  23537. ><P
  23538. >     Die alternative Syntax kann auch auf <VAR
  23539. CLASS="literal"
  23540. >else</VAR
  23541. > und
  23542.     <VAR
  23543. CLASS="literal"
  23544. >elseif</VAR
  23545. > angewendet werden. Es folgt eine
  23546.     <VAR
  23547. CLASS="literal"
  23548. >if</VAR
  23549. >-Struktur mit <VAR
  23550. CLASS="literal"
  23551. >elseif</VAR
  23552. >
  23553.     und <VAR
  23554. CLASS="literal"
  23555. >else</VAR
  23556. > im alternativen Format:
  23557.     <DIV
  23558. CLASS="informalexample"
  23559. ><P
  23560. ></P
  23561. ><A
  23562. NAME="AEN4345"
  23563. ></A
  23564. ><TABLE
  23565. BORDER="0"
  23566. BGCOLOR="#E0E0E0"
  23567. CELLPADDING="5"
  23568. ><TR
  23569. ><TD
  23570. ><PRE
  23571. CLASS="php"
  23572. ><?php
  23573. if ($a == 5):
  23574.     echo "a ist gleich 5";
  23575.     echo "...";
  23576. elseif ($a == 6):
  23577.     echo "a ist gleich 6";
  23578.     echo "!!!";
  23579. else:
  23580.     echo "a ist weder 5 noch 6";
  23581. endif;
  23582. ?></PRE
  23583. ></TD
  23584. ></TR
  23585. ></TABLE
  23586. ><P
  23587. ></P
  23588. ></DIV
  23589. >
  23590.    </P
  23591. ><P
  23592. >     Siehe auch <A
  23593. HREF="#control-structures.while"
  23594. >while</A
  23595. >,
  23596.     <A
  23597. HREF="#control-structures.for"
  23598. >for</A
  23599. > und <A
  23600. HREF="#control-structures.if"
  23601. >if</A
  23602. > fⁿr weitere Beispiele.
  23603.    </P
  23604. ></DIV
  23605. ><DIV
  23606. CLASS="sect1"
  23607. ><HR><H2
  23608. CLASS="sect1"
  23609. ><A
  23610. NAME="control-structures.while"
  23611. ><VAR
  23612. CLASS="literal"
  23613. >while</VAR
  23614. ></A
  23615. ></H2
  23616. ><P
  23617. >     Die <VAR
  23618. CLASS="literal"
  23619. >while</VAR
  23620. >-Schleifen sind die einfachste Form von
  23621.     Schleifen in PHP. Sie funktionieren genau wie in C. Die Grundform einer
  23622.     <VAR
  23623. CLASS="literal"
  23624. >while</VAR
  23625. >-Anweisung lautet:
  23626.     <DIV
  23627. CLASS="informalexample"
  23628. ><P
  23629. ></P
  23630. ><A
  23631. NAME="AEN4357"
  23632. ></A
  23633. ><TABLE
  23634. BORDER="0"
  23635. BGCOLOR="#E0E0E0"
  23636. CELLPADDING="5"
  23637. ><TR
  23638. ><TD
  23639. ><PRE
  23640. CLASS="programlisting"
  23641. >while (ausdr) Anweisung</PRE
  23642. ></TD
  23643. ></TR
  23644. ></TABLE
  23645. ><P
  23646. ></P
  23647. ></DIV
  23648. >
  23649.    </P
  23650. ><P
  23651. >     Die Bedeutung einer <VAR
  23652. CLASS="literal"
  23653. >while</VAR
  23654. >-Anweisung ist einfach.
  23655.     Sie weist PHP an, einen in ihr eingebetteten Befehl so lange zu
  23656.     wiederholen, wie die <VAR
  23657. CLASS="literal"
  23658. >while</VAR
  23659. >-Bedingung als <TT
  23660. CLASS="constant"
  23661. ><B
  23662. >TRUE</B
  23663. ></TT
  23664. >
  23665.     ausgewertet wird. Der Wert der Bedingung wird immer am Anfang der
  23666.     Schleife geprⁿft. Wird der Wert wΣhrend der Ausfⁿhrung der Anweisungen
  23667.     innerhalb der <VAR
  23668. CLASS="literal"
  23669. >while</VAR
  23670. >-Schleife verΣndert, endet die
  23671.     Ausfⁿhrung dieses Anweisungsblocks erst mit dem Ende der Iteration
  23672.     (Jeder Schleifendurchlauf ist eine Iteration). Falls die
  23673.     <VAR
  23674. CLASS="literal"
  23675. >while</VAR
  23676. >-Bedingung bereits beim ersten Mal <TT
  23677. CLASS="constant"
  23678. ><B
  23679. >FALSE</B
  23680. ></TT
  23681. > ist,
  23682.     werden die Anweisungen der <VAR
  23683. CLASS="literal"
  23684. >while</VAR
  23685. >-Schleife nicht ein
  23686.     einziges Mal durchlaufen.
  23687.    </P
  23688. ><P
  23689. >     Wie bei der <VAR
  23690. CLASS="literal"
  23691. >if</VAR
  23692. >-Anweisung k÷nnen Sie mehrere
  23693.     Anweisungen innerhalb der gleichen <VAR
  23694. CLASS="literal"
  23695. >while</VAR
  23696. >-Schleife
  23697.     angeben, indem Sie dieses mit geschweiften Klammern umschlie▀en oder die
  23698.     alternative Syntax verwenden:
  23699.     <DIV
  23700. CLASS="informalexample"
  23701. ><P
  23702. ></P
  23703. ><A
  23704. NAME="AEN4370"
  23705. ></A
  23706. ><TABLE
  23707. BORDER="0"
  23708. BGCOLOR="#E0E0E0"
  23709. CELLPADDING="5"
  23710. ><TR
  23711. ><TD
  23712. ><PRE
  23713. CLASS="programlisting"
  23714. >while (ausdr): Anweisung ... endwhile;</PRE
  23715. ></TD
  23716. ></TR
  23717. ></TABLE
  23718. ><P
  23719. ></P
  23720. ></DIV
  23721. >
  23722.    </P
  23723. ><P
  23724. >     Die folgenden Beispiele sind identisch; beide geben Zahlen von
  23725.     1 bis 10 aus:
  23726.     <DIV
  23727. CLASS="informalexample"
  23728. ><P
  23729. ></P
  23730. ><A
  23731. NAME="AEN4373"
  23732. ></A
  23733. ><TABLE
  23734. BORDER="0"
  23735. BGCOLOR="#E0E0E0"
  23736. CELLPADDING="5"
  23737. ><TR
  23738. ><TD
  23739. ><PRE
  23740. CLASS="programlisting"
  23741. >/* Beispiel 1 */
  23742.  
  23743. $i = 1;
  23744. while ($i <= 10) {
  23745.     echo $i++;  /* es wird erst $i ausgegeben, bevor der Wert erh÷ht wird
  23746.                   (Post-Inkrement) */
  23747. }
  23748.  
  23749. /* Beispiel 2 */
  23750.  
  23751. $i = 1;
  23752. while ($i <= 10):
  23753.     echo $i;
  23754.     $i++;
  23755. endwhile;</PRE
  23756. ></TD
  23757. ></TR
  23758. ></TABLE
  23759. ><P
  23760. ></P
  23761. ></DIV
  23762. >
  23763.    </P
  23764. ></DIV
  23765. ><DIV
  23766. CLASS="sect1"
  23767. ><HR><H2
  23768. CLASS="sect1"
  23769. ><A
  23770. NAME="control-structures.do.while"
  23771. ><VAR
  23772. CLASS="literal"
  23773. >do..while</VAR
  23774. ></A
  23775. ></H2
  23776. ><P
  23777. >     <VAR
  23778. CLASS="literal"
  23779. >do..while</VAR
  23780. >-Schleifen sind den <VAR
  23781. CLASS="literal"
  23782. >while</VAR
  23783. >
  23784.     -Schleifen sehr Σhnlich, au▀er dass der Wahrheitsgehalt des Ausdrucks erst
  23785.     am Ende jedes Durchlaufs geprⁿft wird, statt am Anfang. Der Hauptunterschied
  23786.     zu gew÷hnlichen <VAR
  23787. CLASS="literal"
  23788. >while</VAR
  23789. >-Schleifen ist der, dass die Schleife
  23790.     bei <VAR
  23791. CLASS="literal"
  23792. >do..while</VAR
  23793. > in jeden Fall einmal durchlaufen wird
  23794.     (die Bedingung wird erst am Ende eines Durchlaufs geprⁿft).Bei
  23795.     <VAR
  23796. CLASS="literal"
  23797. >while</VAR
  23798. >-Schleifen hingegen kann es durchaus passieren,
  23799.     dass die Schleife nie durchlaufen wird (die Bedingung wird immer am Anfang
  23800.     eines Durchlaufs ⁿberprⁿft. Wird diese Bedingung von Anfang an als <TT
  23801. CLASS="constant"
  23802. ><B
  23803. >FALSE</B
  23804. ></TT
  23805. >
  23806.     ausgewertet endet die Ausfⁿhrung der Schleife sofort).
  23807.    </P
  23808. ><P
  23809. >     Es gibt nur eine Syntax fⁿr <VAR
  23810. CLASS="literal"
  23811. >do..while</VAR
  23812. >-Schleifen:
  23813.     <DIV
  23814. CLASS="informalexample"
  23815. ><P
  23816. ></P
  23817. ><A
  23818. NAME="AEN4387"
  23819. ></A
  23820. ><TABLE
  23821. BORDER="0"
  23822. BGCOLOR="#E0E0E0"
  23823. CELLPADDING="5"
  23824. ><TR
  23825. ><TD
  23826. ><PRE
  23827. CLASS="php"
  23828. ><?php
  23829. $i = 0;
  23830. do {
  23831.     echo $i;
  23832. } while ($i>0);
  23833. ?></PRE
  23834. ></TD
  23835. ></TR
  23836. ></TABLE
  23837. ><P
  23838. ></P
  23839. ></DIV
  23840. >
  23841.    </P
  23842. ><P
  23843. >     Die obige Schleife wird genau einmal durchlaufen, da nach der
  23844.     ersten Wiederholung die Erfⁿllung der Bedingung geprⁿft wird. Diese
  23845.     Bedingung ist aber nicht erfⁿllt ($i ist nicht gr÷▀er als 0), wird als
  23846.     <TT
  23847. CLASS="constant"
  23848. ><B
  23849. >FALSE</B
  23850. ></TT
  23851. > ausgewertet, und die Schleifenausfⁿhrung beendet.
  23852.    </P
  23853. ><P
  23854. >     Erfahrene C-Anwender kennen auch die M÷glichkeit, Programm-Bl÷cke
  23855.     mit <VAR
  23856. CLASS="literal"
  23857. >do..while</VAR
  23858. > (0) einzuschliessen und dann die
  23859.     <A
  23860. HREF="#control-structures.break"
  23861. ><VAR
  23862. CLASS="literal"
  23863. >break</VAR
  23864. ></A
  23865. >
  23866.     Anweisung zu benutzen. Der folgende Programm-Ausschnitt zeigt diese
  23867.     M÷glichkeit:
  23868.     <DIV
  23869. CLASS="informalexample"
  23870. ><P
  23871. ></P
  23872. ><A
  23873. NAME="AEN4395"
  23874. ></A
  23875. ><TABLE
  23876. BORDER="0"
  23877. BGCOLOR="#E0E0E0"
  23878. CELLPADDING="5"
  23879. ><TR
  23880. ><TD
  23881. ><PRE
  23882. CLASS="php"
  23883. >do {
  23884.     if ($i < 5) {
  23885.         echo "i ist nicht gro▀ genug";
  23886.         break;
  23887.     }
  23888.     $i *= $factor;
  23889.     if ($i < $minimum_limit) {
  23890.         break;
  23891.     }
  23892.     echo "i ist ok";
  23893.  
  23894.     /* mach was mit i */
  23895.  
  23896. } while (0);</PRE
  23897. ></TD
  23898. ></TR
  23899. ></TABLE
  23900. ><P
  23901. ></P
  23902. ></DIV
  23903. >
  23904.    </P
  23905. ><P
  23906. >     Es ist nicht weiter tragisch, wenn Sie dieses Beispiel nicht
  23907.     oder nur zum Teil verstehen. Sie k÷nnen auch ohne dieses
  23908.     'Feature' effektive PHP-Programme und Skripte schreiben.
  23909.    </P
  23910. ></DIV
  23911. ><DIV
  23912. CLASS="sect1"
  23913. ><HR><H2
  23914. CLASS="sect1"
  23915. ><A
  23916. NAME="control-structures.for"
  23917. ><VAR
  23918. CLASS="literal"
  23919. >for</VAR
  23920. ></A
  23921. ></H2
  23922. ><P
  23923. >     Die <VAR
  23924. CLASS="literal"
  23925. >for</VAR
  23926. >-Schleifen sind die komplexesten Schleifen in
  23927.     PHP. Sie funktionieren wie ihr Gegenstⁿck in C. Die Syntax einer
  23928.     <VAR
  23929. CLASS="literal"
  23930. >for</VAR
  23931. >-Schleife sieht wie folgt aus:
  23932.     <DIV
  23933. CLASS="informalexample"
  23934. ><P
  23935. ></P
  23936. ><A
  23937. NAME="AEN4404"
  23938. ></A
  23939. ><TABLE
  23940. BORDER="0"
  23941. BGCOLOR="#E0E0E0"
  23942. CELLPADDING="5"
  23943. ><TR
  23944. ><TD
  23945. ><PRE
  23946. CLASS="programlisting"
  23947. >for (ausdr1; ausdr2; ausdr3) Anweisung</PRE
  23948. ></TD
  23949. ></TR
  23950. ></TABLE
  23951. ><P
  23952. ></P
  23953. ></DIV
  23954. >
  23955.    </P
  23956. ><P
  23957. >     Der erste Ausdruck (<VAR
  23958. CLASS="varname"
  23959. >ausdr1</VAR
  23960. >) wird beim
  23961.     Schleifenbeginn (ohne jegliche Vorbedingung) geprⁿft bzw. ausgefⁿhrt.
  23962.    </P
  23963. ><P
  23964. >     Zu Beginn jedes Durchlaufs wird nun <VAR
  23965. CLASS="varname"
  23966. >ausdr2</VAR
  23967. >
  23968.     geprⁿft. Wenn dieser <TT
  23969. CLASS="constant"
  23970. ><B
  23971. >TRUE</B
  23972. ></TT
  23973. > ist, fΣhrt die Schleife mit der Ausfⁿhrung der
  23974.     nachfolgenden Anweisung(en) fort. Ist das Ergebnis <TT
  23975. CLASS="constant"
  23976. ><B
  23977. >FALSE</B
  23978. ></TT
  23979. >, wird die
  23980.     Schleife beendet.
  23981.    </P
  23982. ><P
  23983. >     Am Ende jedes Durchlaufs wird <VAR
  23984. CLASS="varname"
  23985. >ausdr3</VAR
  23986. > geprⁿft
  23987.     (ausgefⁿhrt).
  23988.    </P
  23989. ><P
  23990. >     Jeder Ausdruck kann leer sein. Ist <VAR
  23991. CLASS="varname"
  23992. >ausdr2</VAR
  23993. > leer,
  23994.     wird die Schleife endlos oft durchlaufen (PHP wertet diesen, wie in C,
  23995.     implizit als <TT
  23996. CLASS="constant"
  23997. ><B
  23998. >TRUE</B
  23999. ></TT
  24000. >). Das ist gar nicht so sinnlos, wie Sie vielleicht
  24001.     zunΣchst glauben, weil man hΣufig eine Schleife erst durch eine bedingte
  24002.     <A
  24003. HREF="#control-structures.break"
  24004. ><VAR
  24005. CLASS="literal"
  24006. >break</VAR
  24007. >
  24008.     </A
  24009. >-Anweisung statt durch eine unwahr werdende
  24010.     <VAR
  24011. CLASS="literal"
  24012. >for</VAR
  24013. >-Bedingung beenden m÷chte.
  24014.    </P
  24015. ><P
  24016. >     Beachten Sie die folgenden Beispiele. Alle geben Zahlen von 1 bis
  24017.     10 aus:
  24018.     <DIV
  24019. CLASS="informalexample"
  24020. ><P
  24021. ></P
  24022. ><A
  24023. NAME="AEN4421"
  24024. ></A
  24025. ><TABLE
  24026. BORDER="0"
  24027. BGCOLOR="#E0E0E0"
  24028. CELLPADDING="5"
  24029. ><TR
  24030. ><TD
  24031. ><PRE
  24032. CLASS="php"
  24033. ><?php
  24034. /* Beispiel 1 */
  24035.  
  24036. for ($i = 1; $i <= 10; $i++) {
  24037.     echo $i;
  24038. }
  24039.  
  24040. /* Beispiel 2 */
  24041.  
  24042. for ($i = 1; ; $i++) {
  24043.     if ($i > 10) {
  24044.         break;
  24045.     }
  24046.     echo $i;
  24047. }
  24048.  
  24049. /* Beispiel 3 */
  24050.  
  24051. $i = 1;
  24052. for (; ; ) {
  24053.     if ($i > 10) {
  24054.         break;
  24055.     }
  24056.     echo $i;
  24057.     $i++;
  24058. }
  24059.  
  24060. /* Beispiel 4 */
  24061.  
  24062. for ($i = 1; $i <= 10; echo $i, $i++);
  24063. ?></PRE
  24064. ></TD
  24065. ></TR
  24066. ></TABLE
  24067. ><P
  24068. ></P
  24069. ></DIV
  24070. >
  24071.    </P
  24072. ><P
  24073. >     SelbstverstΣndlich sieht das erste (oder vielleicht das vierte) Beispiel
  24074.     am besten aus, aber Sie werden noch feststellen, dass es oftmals ganz
  24075.     nⁿtzlich sein kann, leere Parameter in <VAR
  24076. CLASS="literal"
  24077. >for</VAR
  24078. >-Schleifen zu
  24079.     verwenden.
  24080.    </P
  24081. ><P
  24082. >     PHP unterstⁿtzt auch bei <VAR
  24083. CLASS="literal"
  24084. >for</VAR
  24085. >-Schleifen die
  24086.     alternative "Doppelpunkt-Syntax".
  24087.     <DIV
  24088. CLASS="informalexample"
  24089. ><P
  24090. ></P
  24091. ><A
  24092. NAME="AEN4427"
  24093. ></A
  24094. ><TABLE
  24095. BORDER="0"
  24096. BGCOLOR="#E0E0E0"
  24097. CELLPADDING="5"
  24098. ><TR
  24099. ><TD
  24100. ><PRE
  24101. CLASS="programlisting"
  24102. >for (ausdr1; ausdr2; ausdr3): Anweisung; ...; endfor;</PRE
  24103. ></TD
  24104. ></TR
  24105. ></TABLE
  24106. ><P
  24107. ></P
  24108. ></DIV
  24109. >
  24110.    </P
  24111. ><P
  24112. >     Andere Sprachen haben fⁿr das Durchlaufen eines Hashs oder Arrays eine
  24113.     <VAR
  24114. CLASS="literal"
  24115. >foreach</VAR
  24116. >-Anweisung. PHP 3 hat dies nicht; im Gegensatz
  24117.     zu PHP 4 (vgl.
  24118.     <A
  24119. HREF="#control-structures.foreach"
  24120. >foreach</A
  24121. >).
  24122.     In PHP 3 k÷nnen Sie fⁿr diesen Zweck
  24123.     <A
  24124. HREF="#control-structures.while"
  24125. >while</A
  24126. > mit der
  24127.     <A
  24128. HREF="#function.list"
  24129. ><B
  24130. CLASS="function"
  24131. >list()</B
  24132. ></A
  24133. >- und <A
  24134. HREF="#function.each"
  24135. ><B
  24136. CLASS="function"
  24137. >each()</B
  24138. ></A
  24139. >-Funktion
  24140.     kombinieren. Beispiele finden Sie in der Dokumentation zu diesen
  24141.     Funktionen.
  24142.    </P
  24143. ></DIV
  24144. ><DIV
  24145. CLASS="sect1"
  24146. ><HR><H2
  24147. CLASS="sect1"
  24148. ><A
  24149. NAME="control-structures.foreach"
  24150. ><VAR
  24151. CLASS="literal"
  24152. >foreach</VAR
  24153. ></A
  24154. ></H2
  24155. ><P
  24156. >     PHP 4 (nicht PHP 3) enthΣlt ein <VAR
  24157. CLASS="literal"
  24158. >foreach</VAR
  24159. > Konstrukt,
  24160.     genau wie Perl und einige andere Sprachen. Diese erm÷glicht es, auf
  24161.     einfache Weise ein Array zu durchlaufen. <VAR
  24162. CLASS="literal"
  24163. >foreach</VAR
  24164. >
  24165.     funktioniert nur in Verbindung mit Arrays. Wenn Sie versuchen
  24166.     <VAR
  24167. CLASS="literal"
  24168. >foreach</VAR
  24169. > mit Variablen eines anderen Datentyps oder
  24170.     nicht initialisierten Variablen zu benutzen, gibt PHP einen Fehler aus. Es
  24171.     gibt zwei Syntaxformen; die zweite ist eine unbedeutende, aber sinnvolle
  24172.     Erweiterung der ersten Syntax:
  24173.     <DIV
  24174. CLASS="informalexample"
  24175. ><P
  24176. ></P
  24177. ><A
  24178. NAME="AEN4442"
  24179. ></A
  24180. ><TABLE
  24181. BORDER="0"
  24182. BGCOLOR="#E0E0E0"
  24183. CELLPADDING="5"
  24184. ><TR
  24185. ><TD
  24186. ><PRE
  24187. CLASS="programlisting"
  24188. >foreach (array_expression as $value) Anweisung
  24189. foreach (array_expression as $key => $value) Anweisung</PRE
  24190. ></TD
  24191. ></TR
  24192. ></TABLE
  24193. ><P
  24194. ></P
  24195. ></DIV
  24196. >
  24197.    </P
  24198. ><P
  24199. >     Die erste Form durchlΣuft das <VAR
  24200. CLASS="literal"
  24201. >array_expression</VAR
  24202. >-Array.
  24203.     Bei jedem Durchgang wird der Wert des aktuellen Elements
  24204.     <VAR
  24205. CLASS="literal"
  24206. >$value</VAR
  24207. > zugewiesen und der interne Array-Zeiger um eins
  24208.     erh÷ht. Dadurch wird beim nΣchsten Durchgang automatisch das nΣchste
  24209.     Element ausgewertet.
  24210.    </P
  24211. ><P
  24212. >     Die zweite Form arbeitet genauso, au▀er dass bei jedem Durchlauf
  24213.     auch der aktuelle Schlⁿssel der Variablen <VAR
  24214. CLASS="literal"
  24215. >$key</VAR
  24216. >
  24217.     zugewiesen wird.
  24218.    </P
  24219. ><P
  24220. >     <DIV
  24221. CLASS="note"
  24222. ><BLOCKQUOTE
  24223. CLASS="note"
  24224. ><P
  24225. ><B
  24226. >Anmerkung: </B
  24227. >
  24228.       Sobald <VAR
  24229. CLASS="literal"
  24230. >foreach</VAR
  24231. > zum ersten Mal ausgefⁿhrt wird,
  24232.       wird der interne Arrayzeiger automatisch auf das erste Element
  24233.       des Arrays gesetzt. Das bedeutet, dass Sie vor einem Durchlauf
  24234.       von <VAR
  24235. CLASS="literal"
  24236. >foreach</VAR
  24237. > <A
  24238. HREF="#function.reset"
  24239. ><B
  24240. CLASS="function"
  24241. >reset()</B
  24242. ></A
  24243. > nicht
  24244.       aufrufen mⁿssen.
  24245.      </P
  24246. ></BLOCKQUOTE
  24247. ></DIV
  24248. >
  24249.    </P
  24250. ><P
  24251. >     <DIV
  24252. CLASS="note"
  24253. ><BLOCKQUOTE
  24254. CLASS="note"
  24255. ><P
  24256. ><B
  24257. >Anmerkung: </B
  24258. >
  24259.       Beachten Sie auch, dass <VAR
  24260. CLASS="literal"
  24261. >foreach</VAR
  24262. > mit einer
  24263.       Kopie des angegebenen Arrays arbeitet, nicht mit dem Array selbst.
  24264.       Deshalb wird auch der Arrayzeiger nicht wie bei dem
  24265.       <A
  24266. HREF="#function.each"
  24267. ><B
  24268. CLASS="function"
  24269. >each()</B
  24270. ></A
  24271. >-Konstrukt verΣndert und VerΣnderungen an
  24272.       ausgegebenen Arrayelementen haben keine Auswirkung auf das originale
  24273.       Array. Trotzdem <SPAN
  24274. CLASS="emphasis"
  24275. ><I
  24276. CLASS="emphasis"
  24277. >wird</I
  24278. ></SPAN
  24279. > der interne Arrayzeiger
  24280.       des originalen Arrays bei der Verarbeitung bewegt. Angenommen, die
  24281.       foreach-Schleife ist komplett abgearbeitet, wird der interne
  24282.       Arrayzeiger (des originalen Arrays) auf das letzte Element zeigen.
  24283.      </P
  24284. ></BLOCKQUOTE
  24285. ></DIV
  24286. >
  24287.    </P
  24288. ><DIV
  24289. CLASS="note"
  24290. ><BLOCKQUOTE
  24291. CLASS="note"
  24292. ><P
  24293. ><B
  24294. >Anmerkung: </B
  24295. >
  24296.      Bei <VAR
  24297. CLASS="literal"
  24298. >foreach</VAR
  24299. > ist es nicht m÷glich Fehlermeldungen durch
  24300.      den Gebrauch von '@' zu unterdrⁿcken ist 
  24301.     </P
  24302. ></BLOCKQUOTE
  24303. ></DIV
  24304. ><P
  24305. >     Beachten Sie, dass die folgenden Beispiele in ihrer FunktionalitΣt
  24306.     identisch sind:
  24307.     <DIV
  24308. CLASS="informalexample"
  24309. ><P
  24310. ></P
  24311. ><A
  24312. NAME="AEN4465"
  24313. ></A
  24314. ><TABLE
  24315. BORDER="0"
  24316. BGCOLOR="#E0E0E0"
  24317. CELLPADDING="5"
  24318. ><TR
  24319. ><TD
  24320. ><PRE
  24321. CLASS="php"
  24322. ><?php
  24323. $arr = array("eins", "zwei", "drei");
  24324. reset ($arr);
  24325. while (list(, $value) = each ($arr)) {
  24326.     echo "Wert:  $value<br />\n";
  24327. }
  24328.  
  24329. foreach ($arr as $value) {
  24330.     echo "Wert:  $value<br />\n";
  24331. ?>
  24332. }</PRE
  24333. ></TD
  24334. ></TR
  24335. ></TABLE
  24336. ><P
  24337. ></P
  24338. ></DIV
  24339. >
  24340.     Auch hier funktioniert alles gleich:
  24341.     <DIV
  24342. CLASS="informalexample"
  24343. ><P
  24344. ></P
  24345. ><A
  24346. NAME="AEN4467"
  24347. ></A
  24348. ><TABLE
  24349. BORDER="0"
  24350. BGCOLOR="#E0E0E0"
  24351. CELLPADDING="5"
  24352. ><TR
  24353. ><TD
  24354. ><PRE
  24355. CLASS="php"
  24356. ><?php
  24357. $arr = array("eins", "zwei", "drei");
  24358. reset ($arr);
  24359. while (list($key, $value) = each ($arr)) {
  24360.     echo "Schlⁿssel: $key; Wert: $value<br />\n";
  24361. }
  24362.  
  24363. foreach ($arr as $key => $value) {
  24364.     echo "Schlⁿssel: $key; Wert: $value<br />\n";
  24365. }
  24366. ?></PRE
  24367. ></TD
  24368. ></TR
  24369. ></TABLE
  24370. ><P
  24371. ></P
  24372. ></DIV
  24373. >
  24374.    </P
  24375. ><P
  24376. >     Noch einige Beispiele, die die Anwendung verdeutlichen:
  24377.     <DIV
  24378. CLASS="informalexample"
  24379. ><P
  24380. ></P
  24381. ><A
  24382. NAME="AEN4470"
  24383. ></A
  24384. ><TABLE
  24385. BORDER="0"
  24386. BGCOLOR="#E0E0E0"
  24387. CELLPADDING="5"
  24388. ><TR
  24389. ><TD
  24390. ><PRE
  24391. CLASS="php"
  24392. ><?php
  24393. /* foreach Beispiel 1: Nur der Wert */
  24394.  
  24395. $a = array(1, 2, 3, 17);
  24396.  
  24397. foreach ($a as $v) {
  24398.    echo "Aktueller Wert von \$a: $v.\n";
  24399. }
  24400.  
  24401. /* foreach Beispiel 2:
  24402. Wert (mit Ausgabe des Arrayschlⁿssels zur Veranschaulichung) */
  24403.  
  24404. $a = array(1, 2, 3, 17);
  24405.  
  24406. $i = 0; /* nur zu Veranschaulichung */
  24407.  
  24408. foreach($a as $v) {
  24409.     echo "\$a[$i] => $v.\n";
  24410.     $i++;
  24411. }
  24412.  
  24413. /* foreach Beispiel 3: Schlⁿssel und Wert */
  24414.  
  24415. $a = array(
  24416.     "eins" => 1,
  24417.     "zwei" => 2,
  24418.     "drei" => 3,
  24419.     "siebzehn" => 17
  24420. );
  24421.  
  24422. foreach($a as $k => $v) {
  24423.     echo "\$a[$k] => $v.\n";
  24424. }
  24425.  
  24426. /* foreach Beispiel 4: multidimensionale Arrays */
  24427.  
  24428. $a[0][0] = "a";
  24429. $a[0][1] = "b";
  24430. $a[1][0] = "y";
  24431. $a[1][1] = "z";
  24432.  
  24433. foreach($a as $v1) {
  24434.     foreach ($v1 as $v2) {
  24435.         echo "$v2\n";
  24436.     }
  24437. }
  24438.  
  24439. /* foreach Beispiel 5: dynamische Arrays */
  24440.  
  24441. foreach (array(1, 2, 3, 4, 5) as $v) {
  24442.     echo "$v\n";
  24443. }
  24444. ?></PRE
  24445. ></TD
  24446. ></TR
  24447. ></TABLE
  24448. ><P
  24449. ></P
  24450. ></DIV
  24451. >
  24452.    </P
  24453. ></DIV
  24454. ><DIV
  24455. CLASS="sect1"
  24456. ><HR><H2
  24457. CLASS="sect1"
  24458. ><A
  24459. NAME="control-structures.break"
  24460. ><VAR
  24461. CLASS="literal"
  24462. >break</VAR
  24463. ></A
  24464. ></H2
  24465. ><P
  24466. >     <VAR
  24467. CLASS="literal"
  24468. >Break</VAR
  24469. > bricht die Ausfⁿhrung der aktuellen
  24470.     <VAR
  24471. CLASS="literal"
  24472. >for</VAR
  24473. >, <VAR
  24474. CLASS="literal"
  24475. >foreach</VAR
  24476. >
  24477.     <VAR
  24478. CLASS="literal"
  24479. >while</VAR
  24480. >, <VAR
  24481. CLASS="literal"
  24482. >do..while</VAR
  24483. > Schleife oder einer
  24484.     <VAR
  24485. CLASS="literal"
  24486. >switch</VAR
  24487. > Anweisungssequenz ab.
  24488.    </P
  24489. ><P
  24490. >     Einem <VAR
  24491. CLASS="literal"
  24492. >break</VAR
  24493. > kann optional ein nummerisches
  24494.     Argument angehΣngt werden, das die Anzahl der abzubrechenden
  24495.     Befehlssequenzen enthΣlt.
  24496.    </P
  24497. ><P
  24498. >     <DIV
  24499. CLASS="informalexample"
  24500. ><P
  24501. ></P
  24502. ><A
  24503. NAME="AEN4485"
  24504. ></A
  24505. ><TABLE
  24506. BORDER="0"
  24507. BGCOLOR="#E0E0E0"
  24508. CELLPADDING="5"
  24509. ><TR
  24510. ><TD
  24511. ><PRE
  24512. CLASS="php"
  24513. ><?php
  24514. $arr = array('eins', 'zwei', 'drei', 'vier', 'stop', 'fⁿnf');
  24515. while (list ( , $val) = each ($arr)) {
  24516.     if ($val == 'stop') {
  24517.         break;  /* Sie k÷nnten hier auch 'break 1;' schreiben. */
  24518.     }
  24519.     echo "$val<br />\n";
  24520.  
  24521. /* Benutzung des optionalen Argumentes. */
  24522.  
  24523. $i = 0;
  24524. while (++$i) {
  24525.     switch ($i) {
  24526.     case 5:
  24527.         echo "Bei 5<br />\n";
  24528.         break 1;  /* Beendet nur switch. */
  24529.     case 10:
  24530.         echo "Bei 10; aussteigen<br />\n";
  24531.         break 2;  /* Beendet switch und while. */
  24532.     default:
  24533.         break;
  24534.     }
  24535. }
  24536. ?></PRE
  24537. ></TD
  24538. ></TR
  24539. ></TABLE
  24540. ><P
  24541. ></P
  24542. ></DIV
  24543. >
  24544.    </P
  24545. ></DIV
  24546. ><DIV
  24547. CLASS="sect1"
  24548. ><HR><H2
  24549. CLASS="sect1"
  24550. ><A
  24551. NAME="control-structures.continue"
  24552. ><VAR
  24553. CLASS="literal"
  24554. >continue</VAR
  24555. ></A
  24556. ></H2
  24557. ><P
  24558. >     <VAR
  24559. CLASS="literal"
  24560. >continue</VAR
  24561. > wird innerhalb von Schleifen verwendet. Die
  24562.     Schleife wird an der aktuellen Stelle abgebrochen und es wird der nΣchste
  24563.     Durchlauf begonnen.
  24564.    </P
  24565. ><DIV
  24566. CLASS="note"
  24567. ><BLOCKQUOTE
  24568. CLASS="note"
  24569. ><P
  24570. ><B
  24571. >Anmerkung: </B
  24572. >
  24573.      Beachten Sie, dass in PHP die 
  24574.      <A
  24575. HREF="#control-structures.switch"
  24576. >switch</A
  24577. > Anweisung
  24578.      als Schleifenstruktur zum Zweck von <VAR
  24579. CLASS="literal"
  24580. >continue</VAR
  24581. > angesehen
  24582.      wird.
  24583.     </P
  24584. ></BLOCKQUOTE
  24585. ></DIV
  24586. ><P
  24587. >     Bei <VAR
  24588. CLASS="literal"
  24589. >continue</VAR
  24590. > k÷nnen Sie ein optionales nummerisches
  24591.     Argument mitgeben, das angibt, wie viele Ebenen von enhaltenen Schleifen
  24592.     ⁿbersprungen werden sollen.
  24593.    </P
  24594. ><P
  24595. >     <DIV
  24596. CLASS="informalexample"
  24597. ><P
  24598. ></P
  24599. ><A
  24600. NAME="AEN4499"
  24601. ></A
  24602. ><TABLE
  24603. BORDER="0"
  24604. BGCOLOR="#E0E0E0"
  24605. CELLPADDING="5"
  24606. ><TR
  24607. ><TD
  24608. ><PRE
  24609. CLASS="php"
  24610. ><?php
  24611. while (list ($key, $value) = each ($arr)) {
  24612.     if (!($key % 2)) { // ⁿberspringe ungerade Werte
  24613.         continue;
  24614.     }
  24615.     tue_was_mit_ungerade ($value);
  24616. }
  24617.  
  24618. $i = 0;
  24619. while ($i++ < 5) {
  24620.     echo "Au▀en<br />\n";
  24621.     while (1) {
  24622.         echo "&nbsp;&nbsp;Mitte<br />\n";
  24623.         while (1) {
  24624.             echo "&nbsp;&nbsp;Innen<br />\n";
  24625.             continue 3;
  24626.         }
  24627.         echo "Das wird nie ausgegeben.<br />\n";
  24628.     }
  24629.     echo "Das hier auch nicht.<br />\n";
  24630. }
  24631. ?></PRE
  24632. ></TD
  24633. ></TR
  24634. ></TABLE
  24635. ><P
  24636. ></P
  24637. ></DIV
  24638. >
  24639.     </P
  24640. ><P
  24641. >      Lassen Sie das Semikolon nach <VAR
  24642. CLASS="literal"
  24643. >continue</VAR
  24644. > weg, kann dies
  24645.      zu verwirrenden Ergebnissen fⁿhren. Es folgt ein Beispiel wie Sie es
  24646.      nicht machen sollten.
  24647.     </P
  24648. ><P
  24649. >      <DIV
  24650. CLASS="informalexample"
  24651. ><P
  24652. ></P
  24653. ><A
  24654. NAME="AEN4504"
  24655. ></A
  24656. ><TABLE
  24657. BORDER="0"
  24658. BGCOLOR="#E0E0E0"
  24659. CELLPADDING="5"
  24660. ><TR
  24661. ><TD
  24662. ><PRE
  24663. CLASS="php"
  24664. ><?php
  24665.   for ($i = 0; $i < 5; ++$i) {
  24666.       if ($i == 2)
  24667.           continue
  24668.       print "$i\n";
  24669.   }
  24670. ?></PRE
  24671. ></TD
  24672. ></TR
  24673. ></TABLE
  24674. ><P
  24675. >        Sie k÷nnten erwarten, dass das Ergebnis wie folgt aussieht,
  24676.       </P
  24677. ><TABLE
  24678. BORDER="0"
  24679. BGCOLOR="#E0E0E0"
  24680. CELLPADDING="5"
  24681. ><TR
  24682. ><TD
  24683. ><PRE
  24684. CLASS="screen"
  24685. >0
  24686. 1
  24687. 3
  24688. 4</PRE
  24689. ></TD
  24690. ></TR
  24691. ></TABLE
  24692. ><P
  24693. >        aber tatsΣchlich sieht die Ausgabe so aus,
  24694.       </P
  24695. ><TABLE
  24696. BORDER="0"
  24697. BGCOLOR="#E0E0E0"
  24698. CELLPADDING="5"
  24699. ><TR
  24700. ><TD
  24701. ><PRE
  24702. CLASS="screen"
  24703. >2</PRE
  24704. ></TD
  24705. ></TR
  24706. ></TABLE
  24707. ><P
  24708. >        weil der Rⁿckgabewert von <A
  24709. HREF="#function.print"
  24710. ><B
  24711. CLASS="function"
  24712. >print()</B
  24713. ></A
  24714. >
  24715.        <VAR
  24716. CLASS="literal"
  24717. >int(1)</VAR
  24718. > ist und das wird als das oben angesprochene
  24719.        optinale Argument gewertet.
  24720.       </P
  24721. ><P
  24722. ></P
  24723. ></DIV
  24724. >
  24725.     </P
  24726. ></DIV
  24727. ><DIV
  24728. CLASS="sect1"
  24729. ><HR><H2
  24730. CLASS="sect1"
  24731. ><A
  24732. NAME="control-structures.switch"
  24733. ><VAR
  24734. CLASS="literal"
  24735. >switch</VAR
  24736. ></A
  24737. ></H2
  24738. ><P
  24739. >     Die <VAR
  24740. CLASS="literal"
  24741. >switch</VAR
  24742. >-Anweisung ist gleichbedeutend einer
  24743.     Reihe von <VAR
  24744. CLASS="literal"
  24745. >if</VAR
  24746. >-Anweisungen mit dem gleichen Parameter.
  24747.     HΣufig wollen Sie ein und dieselbe Variable (bzw. den selben Ausdruck)
  24748.     mit verschiedensten Werten vergleichen und in AbhΣngigkeit vom 
  24749.     Auswertungsergebnis verschiedene Programmteile ausfⁿhren. Genau
  24750.     das erm÷glicht die <VAR
  24751. CLASS="literal"
  24752. >switch</VAR
  24753. >-Anweisung.
  24754.    </P
  24755. ><DIV
  24756. CLASS="note"
  24757. ><BLOCKQUOTE
  24758. CLASS="note"
  24759. ><P
  24760. ><B
  24761. >Anmerkung: </B
  24762. >
  24763.      Beachten Sie bitte, dass im Unterschied zu anderen Programmiersprachen
  24764.      die <A
  24765. HREF="#control-structures.continue"
  24766. >continue</A
  24767. >
  24768.      Anweisung auch bei switch ihre Gⁿltigkeit hat und Σhnlich wie
  24769.      <VAR
  24770. CLASS="literal"
  24771. >break</VAR
  24772. > funktioniert. Falls Sie switch innerhalb einer
  24773.      Schleife verwenden und mit dem nΣchsten Durchlauf der Σu▀eren Schleife
  24774.      beginnen m÷chten, verwenden Sie <VAR
  24775. CLASS="literal"
  24776. >continue 2</VAR
  24777. >.
  24778.     </P
  24779. ></BLOCKQUOTE
  24780. ></DIV
  24781. ><P
  24782. >     Das folgende Beispiele zeigt Ihnen zwei verschiedene M÷glichkeiten auf,
  24783.     das Gleiche zu erreichen. Einmal werden <VAR
  24784. CLASS="literal"
  24785. >if</VAR
  24786. > und
  24787.     <VAR
  24788. CLASS="literal"
  24789. >elseif</VAR
  24790. > Anweisungen benutzt, das andere Mal eine
  24791.     <VAR
  24792. CLASS="literal"
  24793. >switch</VAR
  24794. >-Anweisung:
  24795.     <DIV
  24796. CLASS="informalexample"
  24797. ><P
  24798. ></P
  24799. ><A
  24800. NAME="AEN4529"
  24801. ></A
  24802. ><TABLE
  24803. BORDER="0"
  24804. BGCOLOR="#E0E0E0"
  24805. CELLPADDING="5"
  24806. ><TR
  24807. ><TD
  24808. ><PRE
  24809. CLASS="php"
  24810. ><?php
  24811. if ($i == 0) {
  24812.     echo "i ist gleich 0";
  24813. } elseif ($i == 1) {
  24814.     echo "i ist gleich 1";
  24815. } elseif ($i == 2) {
  24816.     echo "i ist gleich 2";
  24817. }
  24818.  
  24819. switch ($i) {
  24820. case 0:
  24821.     echo "i ist gleich 0";
  24822.     break;
  24823. case 1:
  24824.     echo "i ist gleich 1";
  24825.     break;
  24826. case 2:
  24827.     echo "i ist gleich 2";
  24828.     break;
  24829. }
  24830. ?></PRE
  24831. ></TD
  24832. ></TR
  24833. ></TABLE
  24834. ><P
  24835. ></P
  24836. ></DIV
  24837. >
  24838.    </P
  24839. ><P
  24840. >     Es ist wichtig, die Ausfⁿhrung einer <VAR
  24841. CLASS="literal"
  24842. >switch</VAR
  24843. >-Anweisung
  24844.     zu verstehen, um Fehler zu vermeiden. Die <VAR
  24845. CLASS="literal"
  24846. >switch</VAR
  24847. >-Anweisung
  24848.     wird Zeile fⁿr Zeile (also Anweisung fⁿr Anweisung) abgearbeitet. Zu
  24849.     Beginn wird kein Code ausgefⁿhrt. Erst wenn bei einem
  24850.     <VAR
  24851. CLASS="literal"
  24852. >case</VAR
  24853. >-Teil eine Entsprechung zum
  24854.     <VAR
  24855. CLASS="literal"
  24856. >switch</VAR
  24857. >-Ausdruck vorliegt, werden die darin enthaltenen
  24858.     Anweisungen von PHP ausgefⁿhrt. PHP fΣhrt dann mit der Abarbeitung des
  24859.     restlichen Codes innerhalb des <VAR
  24860. CLASS="literal"
  24861. >switch</VAR
  24862. >-Blocks fort oder
  24863.     bis zum ersten Auftreten einer <VAR
  24864. CLASS="literal"
  24865. >break</VAR
  24866. >-Anweisung. Ohne
  24867.     <VAR
  24868. CLASS="literal"
  24869. >break</VAR
  24870. > am Ende eines case-Teils werden also
  24871.     noch die folgenden case-Bl÷cke ausgefⁿhrt. Zum Beispiel:
  24872.     <DIV
  24873. CLASS="informalexample"
  24874. ><P
  24875. ></P
  24876. ><A
  24877. NAME="AEN4539"
  24878. ></A
  24879. ><TABLE
  24880. BORDER="0"
  24881. BGCOLOR="#E0E0E0"
  24882. CELLPADDING="5"
  24883. ><TR
  24884. ><TD
  24885. ><PRE
  24886. CLASS="php"
  24887. ><?php
  24888. switch ($i) {
  24889. case 0:
  24890.     echo "i ist gleich 0";
  24891. case 1:
  24892.     echo "i ist gleich 1";
  24893. case 2:
  24894.     echo "i ist gleich 2";
  24895. }
  24896. ?></PRE
  24897. ></TD
  24898. ></TR
  24899. ></TABLE
  24900. ><P
  24901. ></P
  24902. ></DIV
  24903. >
  24904.    </P
  24905. ><P
  24906. >     Wenn hier <VAR
  24907. CLASS="varname"
  24908. >$i</VAR
  24909. > gleich 0 ist, wⁿrde PHP alle echo
  24910.     Anweisungen ausfⁿhren! Ist <VAR
  24911. CLASS="varname"
  24912. >$i</VAR
  24913. > gleich 1, werden die
  24914.     letzten beiden echo Anweisungen ausgefⁿhrt. Nur wenn <VAR
  24915. CLASS="varname"
  24916. >$i</VAR
  24917. >
  24918.     gleich 2 ist, erhalten Sie das erwartete Ergebnis: die Ausgabe von
  24919.     "i ist gleich 2". Deshalb ist es wichtig <VAR
  24920. CLASS="literal"
  24921. >break</VAR
  24922. >-Anweisungen
  24923.     zu setzen (abgesehen von bestimmten FΣllen, in denen Sie diese mit Absicht
  24924.     weglassen).
  24925.    </P
  24926. ><P
  24927. >     Bei einer <VAR
  24928. CLASS="literal"
  24929. >switch</VAR
  24930. >-Anweisung wird die Bedingung also nur
  24931.     einmal ⁿberprⁿft und das Ergebnis mit jeder <VAR
  24932. CLASS="literal"
  24933. >case</VAR
  24934. >-Anweisung
  24935.     verglichen. Bei einer <VAR
  24936. CLASS="literal"
  24937. >elseif</VAR
  24938. >-Anweisung wird die
  24939.     Bedingung neu geprⁿft. Ist ihre Bedingung komplizierter als ein einfacher
  24940.     Vergleich und/oder in einer umfangreichen Schleife eingebettet, kann eine
  24941.     <VAR
  24942. CLASS="literal"
  24943. >switch</VAR
  24944. >-Anweisung schneller sein.
  24945.    </P
  24946. ><P
  24947. >     Der Anweisungsteil von case kann auch leer sein. Dann wird die Kontrolle
  24948.     einfach an den nΣchsten case-Teil ⁿbergeben.
  24949.     <DIV
  24950. CLASS="informalexample"
  24951. ><P
  24952. ></P
  24953. ><A
  24954. NAME="AEN4552"
  24955. ></A
  24956. ><TABLE
  24957. BORDER="0"
  24958. BGCOLOR="#E0E0E0"
  24959. CELLPADDING="5"
  24960. ><TR
  24961. ><TD
  24962. ><PRE
  24963. CLASS="php"
  24964. ><?php
  24965. switch ($i) {
  24966. case 0:
  24967. case 1:
  24968. case 2:
  24969.     echo "i ist kleiner als 3 aber nicht negativ";
  24970.     break;
  24971. case 3:
  24972.     echo "i ist gleich 3";
  24973. }
  24974. ?></PRE
  24975. ></TD
  24976. ></TR
  24977. ></TABLE
  24978. ><P
  24979. ></P
  24980. ></DIV
  24981. >
  24982.    </P
  24983. ><P
  24984. >     Ein Spezialfall ist <VAR
  24985. CLASS="literal"
  24986. >default</VAR
  24987. >. Dieser Fall trifft
  24988.     auf alles zu, was nicht von den voranstehenden case-Ausdrⁿcken
  24989.     erfasst wurde und sollte als letzte <VAR
  24990. CLASS="literal"
  24991. >case</VAR
  24992. > Anweisung
  24993.     angegeben werden. Zum Beispiel:
  24994.     <DIV
  24995. CLASS="informalexample"
  24996. ><P
  24997. ></P
  24998. ><A
  24999. NAME="AEN4557"
  25000. ></A
  25001. ><TABLE
  25002. BORDER="0"
  25003. BGCOLOR="#E0E0E0"
  25004. CELLPADDING="5"
  25005. ><TR
  25006. ><TD
  25007. ><PRE
  25008. CLASS="php"
  25009. ><?php
  25010. switch ($i) {
  25011. case 0:
  25012.     echo "i ist gleich 0";
  25013.     break;
  25014. case 1:
  25015.     echo "i ist gleich 1";
  25016.     break;
  25017. case 2:
  25018.     echo "i ist gleich 2";
  25019.     break;
  25020. default:
  25021.     echo "i ist weder 0, 1 noch 2";
  25022. }
  25023. ?></PRE
  25024. ></TD
  25025. ></TR
  25026. ></TABLE
  25027. ><P
  25028. ></P
  25029. ></DIV
  25030. >
  25031.    </P
  25032. ><P
  25033. >     Der <VAR
  25034. CLASS="literal"
  25035. >case</VAR
  25036. >-Ausdruck kann eine Prⁿfung einfacher Typen
  25037.     sein, also von Integer- oder Flie▀komma-Zahlen oder von
  25038.     Strings/Zeichenketten. Arrays oder Objekte k÷nnen nicht benutzt werden, es
  25039.     sei denn, sie wurden in einfache Typen umgewandelt.
  25040.    </P
  25041. ><P
  25042. >     Die alternative Syntax der Kontrollstrukturen gilt auch fⁿr
  25043.     switch-Sequenzen. Mehr Informationen dazu erhalten Sie unter <A
  25044. HREF="#control-structures.alternative-syntax"
  25045. >Alternative Syntax
  25046.     fⁿr Kontroll-Strukturen</A
  25047. >.
  25048.     <DIV
  25049. CLASS="informalexample"
  25050. ><P
  25051. ></P
  25052. ><A
  25053. NAME="AEN4563"
  25054. ></A
  25055. ><TABLE
  25056. BORDER="0"
  25057. BGCOLOR="#E0E0E0"
  25058. CELLPADDING="5"
  25059. ><TR
  25060. ><TD
  25061. ><PRE
  25062. CLASS="php"
  25063. ><?php
  25064. switch ($i):
  25065. case 0:
  25066.     echo "i ist gleich 0";
  25067.     break;
  25068. case 1:
  25069.     echo "i ist gleich 1";
  25070.     break;
  25071. case 2:
  25072.     echo "i ist gleich 2";
  25073.     break;
  25074. default:
  25075.     echo "i ist weder 0, 1 noch 2";
  25076. endswitch;
  25077. ?></PRE
  25078. ></TD
  25079. ></TR
  25080. ></TABLE
  25081. ><P
  25082. ></P
  25083. ></DIV
  25084. >
  25085.    </P
  25086. ></DIV
  25087. ><DIV
  25088. CLASS="sect1"
  25089. ><HR><H2
  25090. CLASS="sect1"
  25091. ><A
  25092. NAME="control-structures.declare"
  25093. ><VAR
  25094. CLASS="literal"
  25095. >declare</VAR
  25096. ></A
  25097. ></H2
  25098. ><P
  25099. >     Das Sprachkonstrukt <VAR
  25100. CLASS="literal"
  25101. >declare</VAR
  25102. > wird dazu verwendet, um
  25103.     Ausfⁿhrungsdirektiven fⁿr einen Codeblock anzugeben.
  25104.     Die Schreibweise von <VAR
  25105. CLASS="literal"
  25106. >declare</VAR
  25107. > ist der anderer
  25108.     Kontrollstrukturen Σhnlich:
  25109.     <DIV
  25110. CLASS="informalexample"
  25111. ><P
  25112. ></P
  25113. ><A
  25114. NAME="AEN4571"
  25115. ></A
  25116. ><TABLE
  25117. BORDER="0"
  25118. BGCOLOR="#E0E0E0"
  25119. CELLPADDING="5"
  25120. ><TR
  25121. ><TD
  25122. ><PRE
  25123. CLASS="programlisting"
  25124. >declare (Direktive) Anweisung</PRE
  25125. ></TD
  25126. ></TR
  25127. ></TABLE
  25128. ><P
  25129. ></P
  25130. ></DIV
  25131. >
  25132.    </P
  25133. ><P
  25134. >     Die <VAR
  25135. CLASS="literal"
  25136. >Direktive</VAR
  25137. > gibt Ihnen die M÷glichkeit, das
  25138.     Verhalten des <VAR
  25139. CLASS="literal"
  25140. >declare</VAR
  25141. >-Blocks zu bestimmen.
  25142.     Zur Zeit wird nur eine Direktive unterstⁿtzt: die <VAR
  25143. CLASS="literal"
  25144. >ticks</VAR
  25145. >
  25146.     (Weiter unten finden Sie mehr Informationen zu den
  25147.     <A
  25148. HREF="#control-structures.declare.ticks"
  25149. >ticks</A
  25150. >).
  25151.    </P
  25152. ><P
  25153. >     Der <VAR
  25154. CLASS="literal"
  25155. >Anweisung</VAR
  25156. >steil des <VAR
  25157. CLASS="literal"
  25158. >declare</VAR
  25159. >-Blocks
  25160.     wird ausgefⁿhrt - wie genau diese Ausfⁿhrung passiert und welche
  25161.     Nebeneffekte wΣhrend der Ausfⁿhrung auftreten, hΣngt von der Direktive ab,
  25162.     die Sie im <VAR
  25163. CLASS="literal"
  25164. >directive</VAR
  25165. >-Block angegeben haben.
  25166.    </P
  25167. ><P
  25168. >     Das <VAR
  25169. CLASS="literal"
  25170. >declare</VAR
  25171. > Konstrukt kann auch im globalen
  25172.     Geltungsbereich benutzt werden und gilt dann fⁿr den folgenden Code.
  25173.     <DIV
  25174. CLASS="informalexample"
  25175. ><P
  25176. ></P
  25177. ><A
  25178. NAME="AEN4584"
  25179. ></A
  25180. ><TABLE
  25181. BORDER="0"
  25182. BGCOLOR="#E0E0E0"
  25183. CELLPADDING="5"
  25184. ><TR
  25185. ><TD
  25186. ><PRE
  25187. CLASS="php"
  25188. ><?php
  25189. // bewirkt das Gleiche:
  25190.  
  25191. // sie k÷nnen declare so benutzen:
  25192. declare(ticks=1) {
  25193.     // hier folgt Ihr ganzes Skript
  25194. }
  25195.  
  25196. // oder wie hier:
  25197. declare(ticks=1);
  25198. // hier folgt Ihr ganzes Skript
  25199. ?></PRE
  25200. ></TD
  25201. ></TR
  25202. ></TABLE
  25203. ><P
  25204. ></P
  25205. ></DIV
  25206. >
  25207.    </P
  25208. ><DIV
  25209. CLASS="sect2"
  25210. ><HR><H3
  25211. CLASS="sect2"
  25212. ><A
  25213. NAME="control-structures.declare.ticks"
  25214. >Ticks</A
  25215. ></H3
  25216. ><P
  25217. >      Ein tick ist ein Ereigniss, das bei jedem <VAR
  25218. CLASS="varname"
  25219. >N</VAR
  25220. >-ten
  25221.      Autreten der low-level Anweisungen innerhalb des
  25222.      <VAR
  25223. CLASS="literal"
  25224. >declare</VAR
  25225. > Blocks, die vom Parser ausgefⁿhrt werden,
  25226.      auftritt. Der Wert von <VAR
  25227. CLASS="varname"
  25228. >N</VAR
  25229. > wird durch die
  25230.      Angabe von <VAR
  25231. CLASS="literal"
  25232. >ticks=<VAR
  25233. CLASS="varname"
  25234. >N</VAR
  25235. ></VAR
  25236. >
  25237.      innerhalb des <VAR
  25238. CLASS="literal"
  25239. >declare</VAR
  25240. >-Blocks in dem
  25241.      <VAR
  25242. CLASS="literal"
  25243. >directive</VAR
  25244. > Abschnitt bestimmt.
  25245.     </P
  25246. ><P
  25247. >      Das Ereignis/die Ereignisse, die bei jedem tick eintreten, legen Sie mit
  25248.      der Funktion <A
  25249. HREF="#function.register-tick-function"
  25250. ><B
  25251. CLASS="function"
  25252. >register_tick_function()</B
  25253. ></A
  25254. > fest.
  25255.      Weitere Einzelheiten k÷nnen Sie dem Beispiel unten entnehmen. Beachten
  25256.      Sie, dass mehr als ein Ereigniss fⁿr jeden tick eintreten kann.
  25257.     </P
  25258. ><P
  25259. >      <TABLE
  25260. WIDTH="100%"
  25261. BORDER="0"
  25262. CELLPADDING="0"
  25263. CELLSPACING="0"
  25264. CLASS="EXAMPLE"
  25265. ><TR
  25266. ><TD
  25267. ><DIV
  25268. CLASS="example"
  25269. ><A
  25270. NAME="AEN4599"
  25271. ></A
  25272. ><P
  25273. ><B
  25274. >Beispiel 15-1. Profil eines Bereichs von PHP Code</B
  25275. ></P
  25276. ><TABLE
  25277. BORDER="0"
  25278. BGCOLOR="#E0E0E0"
  25279. CELLPADDING="5"
  25280. ><TR
  25281. ><TD
  25282. ><PRE
  25283. CLASS="php"
  25284. ><?php
  25285. // Funktion, die bei Aufruf die Zeit aufzeichnet
  25286. function profile($dump = FALSE)
  25287. {
  25288.     static $profile;
  25289.  
  25290.     // Rⁿckgabe der gespeicherten Zeit aus profile, danach l÷schen
  25291.     if ($dump) {
  25292.         $temp = $profile;
  25293.         unset ($profile);
  25294.         return ($temp);
  25295.     }
  25296.  
  25297.     $profile[] = microtime ();
  25298. }
  25299.  
  25300. // Einen tick handler bestimmen
  25301. register_tick_function("profile");
  25302.  
  25303. // Funktion vor dem declare-Block initialisieren
  25304. profile();
  25305.  
  25306. // Ausfⁿhren eines Code-Blocks, jede 2te Anweisung l÷st einen tick aus
  25307.  
  25308. declare(ticks=2) {
  25309.     for ($x = 1; $x < 50; ++$x) {
  25310.         echo similar_text(md5($x), md5($x*$x)), "<br />;";
  25311.     }
  25312. }
  25313.  
  25314. // Ausgabe der gespeicherten Daten aus dem Profiler
  25315. print_r(profile (TRUE));
  25316. ?></PRE
  25317. ></TD
  25318. ></TR
  25319. ></TABLE
  25320. ></DIV
  25321. ></TD
  25322. ></TR
  25323. ></TABLE
  25324. >
  25325.     Dieses Beispiel 'profiliert' den PHP Code der im 'declare'-Block steht,
  25326.     indem die Zeit festgehalten wird, zu der jede zweite low-level Anweisung
  25327.     im Codeblock ausgefⁿhrt wird. Diese Information k÷nnen Sie dazu benutzen,
  25328.     langsame Bereiche innerhalb bestimmter Codesegmente zu identifizieren. Das
  25329.     gleiche Ziel k÷nnen Sie auch mit anderen Methoden erreichen: die Benutzung
  25330.     von ticks ist bequemer und einfacher zu implementieren.
  25331.    </P
  25332. ><P
  25333. >     Ticks sind gut fⁿr Debugging, einfaches Multitasking,
  25334.     Hintergrund I/O und viele andere Aufgaben geeignet.
  25335.    </P
  25336. ><P
  25337. >     Siehe auch <A
  25338. HREF="#function.register-tick-function"
  25339. ><B
  25340. CLASS="function"
  25341. >register_tick_function()</B
  25342. ></A
  25343. > und
  25344.     <A
  25345. HREF="#function.unregister-tick-function"
  25346. ><B
  25347. CLASS="function"
  25348. >unregister_tick_function()</B
  25349. ></A
  25350. >.
  25351.    </P
  25352. ></DIV
  25353. ></DIV
  25354. ><DIV
  25355. CLASS="sect1"
  25356. ><HR><H2
  25357. CLASS="sect1"
  25358. ><A
  25359. NAME="function.return"
  25360. >return</A
  25361. ></H2
  25362. ><P
  25363. >     Wird die <A
  25364. HREF="#function.return"
  25365. ><B
  25366. CLASS="function"
  25367. >return()</B
  25368. ></A
  25369. > Anweisung innerhalb einer Funktion
  25370.     aufgerufen, wird die Ausfⁿhrung der Funktion sofort beendet und das
  25371.     Argument als Wert des Funktionsaufrufs zurⁿckgegeben.
  25372.     <A
  25373. HREF="#function.return"
  25374. ><B
  25375. CLASS="function"
  25376. >return()</B
  25377. ></A
  25378. > beendet auch die Ausfⁿhrung einer
  25379.     <A
  25380. HREF="#function.eval"
  25381. ><B
  25382. CLASS="function"
  25383. >eval()</B
  25384. ></A
  25385. > Anweisung oder einer Skriptdatei.
  25386.    </P
  25387. ><P
  25388. >     Erfolgt der Aufruf innerhalb des globalen Bereichs, wird die Ausfⁿhrung
  25389.     des aktuellen Skripts beendet. Wurde das aktuelle Skript
  25390.     <A
  25391. HREF="#function.include"
  25392. ><B
  25393. CLASS="function"
  25394. >include()</B
  25395. ></A
  25396. >ed oder <A
  25397. HREF="#function.require"
  25398. ><B
  25399. CLASS="function"
  25400. >require()</B
  25401. ></A
  25402. >ed, wird
  25403.     die Kontrolle an das aufrufende Skript zurⁿckgegeben. Wurde das
  25404.     aktuelle Skript <A
  25405. HREF="#function.include"
  25406. ><B
  25407. CLASS="function"
  25408. >include()</B
  25409. ></A
  25410. >ed, wird der Wert, der
  25411.     <A
  25412. HREF="#function.return"
  25413. ><B
  25414. CLASS="function"
  25415. >return()</B
  25416. ></A
  25417. > zugewiesen wurde, als Wert des Aufrufs
  25418.     von <A
  25419. HREF="#function.include"
  25420. ><B
  25421. CLASS="function"
  25422. >include()</B
  25423. ></A
  25424. > zurⁿckgegeben.
  25425.     Wird <A
  25426. HREF="#function.return"
  25427. ><B
  25428. CLASS="function"
  25429. >return()</B
  25430. ></A
  25431. > innerhalb des Hauptskripts aufgerufen,
  25432.     wird die Ausfⁿhrung beendet. Handelt es sich bei dem Skript um eine
  25433.     Datei, die ⁿber die EintrΣge
  25434.     <A
  25435. HREF="#ini.auto-prepend-file"
  25436. >auto_prepend_file</A
  25437. >
  25438.     oder <A
  25439. HREF="#ini.auto-append-file"
  25440. >auto_append_file</A
  25441. >
  25442.     in der <TT
  25443. CLASS="filename"
  25444. >php.ini</TT
  25445. > aufgerufen wurde, wird die Ausfⁿhrung dieses Skripts
  25446.     beendet.
  25447.    </P
  25448. ><P
  25449. >Weitere Informationen erhalten Sie im Abschnitt <A
  25450. HREF="#functions.returning-values"
  25451. >Rⁿckgabewerte</A
  25452. >.
  25453.    </P
  25454. ><DIV
  25455. CLASS="note"
  25456. ><BLOCKQUOTE
  25457. CLASS="note"
  25458. ><P
  25459. ><B
  25460. >Anmerkung: </B
  25461. >
  25462.      Beachten Sie, dass <A
  25463. HREF="#function.return"
  25464. ><B
  25465. CLASS="function"
  25466. >return()</B
  25467. ></A
  25468. > ein Sprachkonstrukt und
  25469.      keine Funktion ist. Die Klammern um ein Argument sind deshalb
  25470.      <SPAN
  25471. CLASS="emphasis"
  25472. ><I
  25473. CLASS="emphasis"
  25474. >nur</I
  25475. ></SPAN
  25476. > zwingend notwendig, wenn es sich um einen
  25477.      Ausdruck handelt, dessen Ergebnis zurⁿckgegeben werden soll.
  25478.      Es ist gebrΣuchlich die Klammern wegzulassen, wenn eine Variable zurⁿck
  25479.      gegeben soll.
  25480.     </P
  25481. ></BLOCKQUOTE
  25482. ></DIV
  25483. ></DIV
  25484. ><DIV
  25485. CLASS="sect1"
  25486. ><HR><H2
  25487. CLASS="sect1"
  25488. ><A
  25489. NAME="function.require"
  25490. ><A
  25491. HREF="#function.require"
  25492. ><B
  25493. CLASS="function"
  25494. >require()</B
  25495. ></A
  25496. ></A
  25497. ></H2
  25498. ><P
  25499. >     Die <A
  25500. HREF="#function.require"
  25501. ><B
  25502. CLASS="function"
  25503. >require()</B
  25504. ></A
  25505. > Anweisung bindet die angegebene Datei ein
  25506.     und wertet diese aus.
  25507.    </P
  25508. ><P
  25509. >     <A
  25510. HREF="#function.require"
  25511. ><B
  25512. CLASS="function"
  25513. >require()</B
  25514. ></A
  25515. > bindet die angegebene Datei ein und fⁿhrt
  25516.     diese aus. Genaue Informationen wie die Einbindung funktioniert ist in
  25517.     der Dokumentation fⁿr <A
  25518. HREF="#function.include"
  25519. ><B
  25520. CLASS="function"
  25521. >include()</B
  25522. ></A
  25523. > beschrieben.
  25524.    </P
  25525. ><P
  25526. >     <A
  25527. HREF="#function.require"
  25528. ><B
  25529. CLASS="function"
  25530. >require()</B
  25531. ></A
  25532. > und <A
  25533. HREF="#function.include"
  25534. ><B
  25535. CLASS="function"
  25536. >include()</B
  25537. ></A
  25538. > sind in
  25539.     jeder Hinsicht gleichwertig mit der einen Ausnahme: der Umgang mit
  25540.     Fehlern. <A
  25541. HREF="#function.include"
  25542. ><B
  25543. CLASS="function"
  25544. >include()</B
  25545. ></A
  25546. > erzeugt ein
  25547.     <A
  25548. HREF="#internal.e-warning"
  25549. >Warning</A
  25550. > wΣhrend
  25551.     <A
  25552. HREF="#function.require"
  25553. ><B
  25554. CLASS="function"
  25555. >require()</B
  25556. ></A
  25557. > in einem <A
  25558. HREF="#internal.e-error"
  25559. >     Fatal Error</A
  25560. > endet. Mit anderen Worten: scheuen Sie sich nicht,
  25561.     <A
  25562. HREF="#function.require"
  25563. ><B
  25564. CLASS="function"
  25565. >require()</B
  25566. ></A
  25567. > zu benutzen, wenn Sie m÷chten, dass eine
  25568.     fehlende Datei die Ausfⁿhrung ihres Skripts beendet.
  25569.     <A
  25570. HREF="#function.include"
  25571. ><B
  25572. CLASS="function"
  25573. >include()</B
  25574. ></A
  25575. > verhΣlt sich anders, ihr Skript wird
  25576.     weiterhin ausgefⁿhrt. Stellen Sie au▀erdem sicher, dass Sie einen gⁿltigen
  25577.     <A
  25578. HREF="#ini.include-path"
  25579. >include_path</A
  25580. > gesetzt haben.
  25581.    </P
  25582. ><P
  25583. >     <TABLE
  25584. WIDTH="100%"
  25585. BORDER="0"
  25586. CELLPADDING="0"
  25587. CELLSPACING="0"
  25588. CLASS="EXAMPLE"
  25589. ><TR
  25590. ><TD
  25591. ><DIV
  25592. CLASS="example"
  25593. ><A
  25594. NAME="AEN4647"
  25595. ></A
  25596. ><P
  25597. ><B
  25598. >Beispiel 15-2. Grundlegende <A
  25599. HREF="#function.require"
  25600. ><B
  25601. CLASS="function"
  25602. >require()</B
  25603. ></A
  25604. > Beispiele</B
  25605. ></P
  25606. ><TABLE
  25607. BORDER="0"
  25608. BGCOLOR="#E0E0E0"
  25609. CELLPADDING="5"
  25610. ><TR
  25611. ><TD
  25612. ><PRE
  25613. CLASS="php"
  25614. ><?php
  25615.  
  25616. require 'prepend.php';
  25617.  
  25618. require $somefile;
  25619.  
  25620. require ('somefile.txt');
  25621.  
  25622. ?></PRE
  25623. ></TD
  25624. ></TR
  25625. ></TABLE
  25626. ></DIV
  25627. ></TD
  25628. ></TR
  25629. ></TABLE
  25630. >
  25631.    </P
  25632. ><P
  25633. >     Weitere Beispiele finden Sie in der Dokumentation zu
  25634.     <A
  25635. HREF="#function.include"
  25636. ><B
  25637. CLASS="function"
  25638. >include()</B
  25639. ></A
  25640. >.
  25641.    </P
  25642. ><P
  25643. >     <DIV
  25644. CLASS="note"
  25645. ><BLOCKQUOTE
  25646. CLASS="note"
  25647. ><P
  25648. ><B
  25649. >Anmerkung: </B
  25650. >
  25651.       Fⁿr frⁿhere Versionen als PHP 4.0.2 gilt folgendes:
  25652.       <A
  25653. HREF="#function.require"
  25654. ><B
  25655. CLASS="function"
  25656. >require()</B
  25657. ></A
  25658. > wird immer versuchen die Zieldatei zu lesen,
  25659.       selbst wenn die Zeile in der die Anweisung steht, nie ausgefⁿhrt wird.
  25660.       Eine bedingte Anweisung hat keine Auswirkungen auf
  25661.       <A
  25662. HREF="#function.require"
  25663. ><B
  25664. CLASS="function"
  25665. >require()</B
  25666. ></A
  25667. >. Wenn jedoch die Zeile in der
  25668.       <A
  25669. HREF="#function.require"
  25670. ><B
  25671. CLASS="function"
  25672. >require()</B
  25673. ></A
  25674. > steht, nie ausgefⁿhrt wird, wird auch der
  25675.       Code der Zieldatei nie ausgefⁿhrt werden. ─hnliches gilt fⁿr
  25676.       Schleifenstrukturen, diese beeinflussen das Verhalten von
  25677.       <A
  25678. HREF="#function.require"
  25679. ><B
  25680. CLASS="function"
  25681. >require()</B
  25682. ></A
  25683. > nicht. Obwohl der Code, der in der Zieldatei
  25684.       enthalten ist, zur Schleife geh÷rt, wird <A
  25685. HREF="#function.require"
  25686. ><B
  25687. CLASS="function"
  25688. >require()</B
  25689. ></A
  25690. >
  25691.       selbst nur einmal ausgefⁿhrt.
  25692.      </P
  25693. ></BLOCKQUOTE
  25694. ></DIV
  25695. >
  25696.    </P
  25697. ><DIV
  25698. CLASS="note"
  25699. ><BLOCKQUOTE
  25700. CLASS="note"
  25701. ><P
  25702. ><B
  25703. >Anmerkung: </B
  25704. >Da dies ein Sprachkonstrukt
  25705. und keine Funktion ist, deshalb k÷nnen Sie dieses nicht mit
  25706. <A
  25707. HREF="#functions.variable-functions"
  25708. >Variablenfunktionen</A
  25709. >
  25710. verwenden.</P
  25711. ></BLOCKQUOTE
  25712. ></DIV
  25713. ><DIV
  25714. CLASS="warning"
  25715. ><P
  25716. ></P
  25717. ><TABLE
  25718. CLASS="warning"
  25719. BORDER="1"
  25720. WIDTH="100%"
  25721. ><TR
  25722. ><TD
  25723. ALIGN="CENTER"
  25724. ><B
  25725. >Warnung</B
  25726. ></TD
  25727. ></TR
  25728. ><TR
  25729. ><TD
  25730. ALIGN="LEFT"
  25731. ><P
  25732. >PHP Versionen kleiner 4.3.0
  25733. fⁿr Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht,
  25734. selbst wenn <A
  25735. HREF="#ini.allow-url-fopen"
  25736. >allow_url_fopen</A
  25737. > aktiviert
  25738. ist.</P
  25739. ></TD
  25740. ></TR
  25741. ></TABLE
  25742. ></DIV
  25743. ><P
  25744. >     Siehe auch <A
  25745. HREF="#function.include"
  25746. ><B
  25747. CLASS="function"
  25748. >include()</B
  25749. ></A
  25750. >, <A
  25751. HREF="#function.require-once"
  25752. ><B
  25753. CLASS="function"
  25754. >require_once()</B
  25755. ></A
  25756. >,
  25757.     <A
  25758. HREF="#function.include-once"
  25759. ><B
  25760. CLASS="function"
  25761. >include_once()</B
  25762. ></A
  25763. >, <A
  25764. HREF="#function.eval"
  25765. ><B
  25766. CLASS="function"
  25767. >eval()</B
  25768. ></A
  25769. >, 
  25770.     <A
  25771. HREF="#function.file"
  25772. ><B
  25773. CLASS="function"
  25774. >file()</B
  25775. ></A
  25776. >, <A
  25777. HREF="#function.readfile"
  25778. ><B
  25779. CLASS="function"
  25780. >readfile()</B
  25781. ></A
  25782. >, 
  25783.     <A
  25784. HREF="#function.virtual"
  25785. ><B
  25786. CLASS="function"
  25787. >virtual()</B
  25788. ></A
  25789. > und <A
  25790. HREF="#ini.include-path"
  25791. >include_path</A
  25792. >.
  25793.    </P
  25794. ></DIV
  25795. ><DIV
  25796. CLASS="sect1"
  25797. ><HR><H2
  25798. CLASS="sect1"
  25799. ><A
  25800. NAME="function.include"
  25801. ><A
  25802. HREF="#function.include"
  25803. ><B
  25804. CLASS="function"
  25805. >include()</B
  25806. ></A
  25807. ></A
  25808. ></H2
  25809. ><P
  25810. >     Die <A
  25811. HREF="#function.include"
  25812. ><B
  25813. CLASS="function"
  25814. >include()</B
  25815. ></A
  25816. > Anweisung bindet die angegebene Datei ein
  25817.     und wertet diese aus.
  25818.    </P
  25819. ><P
  25820. >     Die untenstehende Dokumentation gilt ebenso fⁿr
  25821.     <A
  25822. HREF="#function.require"
  25823. ><B
  25824. CLASS="function"
  25825. >require()</B
  25826. ></A
  25827. >. Diese beiden Konstrukte sind in jeder
  25828.     Hinsicht gleichwertig mit der einen Ausnahme: der Umgang mit Fehlern.
  25829.     <A
  25830. HREF="#function.include"
  25831. ><B
  25832. CLASS="function"
  25833. >include()</B
  25834. ></A
  25835. > erzeugt ein
  25836.     <A
  25837. HREF="#internal.e-warning"
  25838. >Warning</A
  25839. > wΣhrend 
  25840.     <A
  25841. HREF="#function.require"
  25842. ><B
  25843. CLASS="function"
  25844. >require()</B
  25845. ></A
  25846. > in einem <A
  25847. HREF="#internal.e-error"
  25848. >     Fatal Error</A
  25849. > endet. Mit anderen Worten, verwenden Sie
  25850.     <A
  25851. HREF="#function.require"
  25852. ><B
  25853. CLASS="function"
  25854. >require()</B
  25855. ></A
  25856. >, wenn Sie m÷chten, dass eine
  25857.     fehlende Datei die Ausfⁿhrung ihres Skripts beendet.
  25858.     <A
  25859. HREF="#function.include"
  25860. ><B
  25861. CLASS="function"
  25862. >include()</B
  25863. ></A
  25864. > verhΣlt sich anders, ihr Skript wird
  25865.     weiterhin ausgefⁿhrt. Stellen Sie au▀erdem sicher, dass Sie einen gⁿltigen
  25866.     <A
  25867. HREF="#ini.include-path"
  25868. >include_path</A
  25869. > gesetzt
  25870.     haben. Beachten Sie, dass eine Parse Error in einer Datei, die mit require
  25871.     eingebunden wurde, die Ausfⁿhrung ihre Skripts nicht unterbricht.
  25872.    </P
  25873. ><P
  25874. >     Dateien die mit include eingebunden werden, werden zuerst im include_path
  25875.     relativ zum gegenwΣrtigen Arbeitsverzeichnis gesucht und danach im
  25876.     include_path relativ zum Verzeichnis des ausgefⁿhrten Skripts. Zur
  25877.     Veranschaulichung: Falls Ihr include_path <VAR
  25878. CLASS="literal"
  25879. >.</VAR
  25880. > entspricht,
  25881.     ist das gegenwΣrtige Arbeitsverzeichnis
  25882.     <TT
  25883. CLASS="filename"
  25884. >/www/</TT
  25885. >. Sie haben ⁿber include
  25886.     <TT
  25887. CLASS="filename"
  25888. >include/a.php</TT
  25889. > eingebunden und in diesem Skript steht
  25890.     die Anweisung <VAR
  25891. CLASS="literal"
  25892. >include "b.php"</VAR
  25893. >. In diesem Fall wird
  25894.     <TT
  25895. CLASS="filename"
  25896. >b.php</TT
  25897. > zuerst im Verzeichnis
  25898.     <TT
  25899. CLASS="filename"
  25900. >/www/</TT
  25901. > gesucht und danach im
  25902.     Verzeichnis <TT
  25903. CLASS="filename"
  25904. >/www/include/</TT
  25905. >.
  25906.    </P
  25907. ><P
  25908. >     Wenn eine Datei eingebunden wird, erbt der enthaltene Code den
  25909.     <A
  25910. HREF="#language.variables.scope"
  25911. >Geltungsbereich von Variablen</A
  25912. >
  25913.     der Zeile in der die Anweisung steht. Ab dieser Zeile stehen alle verfⁿgbaren
  25914.     Variablen in der aufgerufenen Datei im aufrufenden Skript zur Verfⁿgung.
  25915.    </P
  25916. ><P
  25917. >      <TABLE
  25918. WIDTH="100%"
  25919. BORDER="0"
  25920. CELLPADDING="0"
  25921. CELLSPACING="0"
  25922. CLASS="EXAMPLE"
  25923. ><TR
  25924. ><TD
  25925. ><DIV
  25926. CLASS="example"
  25927. ><A
  25928. NAME="AEN4701"
  25929. ></A
  25930. ><P
  25931. ><B
  25932. >Beispiel 15-3. Grundlegendes <A
  25933. HREF="#function.include"
  25934. ><B
  25935. CLASS="function"
  25936. >include()</B
  25937. ></A
  25938. > Beispiel</B
  25939. ></P
  25940. ><TABLE
  25941. BORDER="0"
  25942. BGCOLOR="#E0E0E0"
  25943. CELLPADDING="5"
  25944. ><TR
  25945. ><TD
  25946. ><PRE
  25947. CLASS="php"
  25948. >vars.php
  25949. <?php
  25950.  
  25951. $color = 'grⁿn';
  25952. $fruit = 'Apfel';
  25953.  
  25954. ?>
  25955.  
  25956. test.php
  25957. <?php
  25958.  
  25959. echo "Ein $color $fruit"; // A
  25960.  
  25961. include 'vars.php';
  25962.  
  25963. echo "Ein $color $fruit"; // Ein grⁿner Apfel
  25964.  
  25965. ?></PRE
  25966. ></TD
  25967. ></TR
  25968. ></TABLE
  25969. ></DIV
  25970. ></TD
  25971. ></TR
  25972. ></TABLE
  25973. >
  25974.    </P
  25975. ><P
  25976. >     Steht include im aufrufenden Skript innerhalb einer Funktion, verhΣlt sich
  25977.     der gesamte Code der aufgerufenen Datei genau so, als ob Sie diesen Code
  25978.     innerhalb dieser Funktion definiert hΣtten. Aus diesem Grund hat dieser
  25979.     Code den Geltungsbereich der Variablen dieser Funktion.
  25980.    </P
  25981. ><P
  25982. >      <TABLE
  25983. WIDTH="100%"
  25984. BORDER="0"
  25985. CELLPADDING="0"
  25986. CELLSPACING="0"
  25987. CLASS="EXAMPLE"
  25988. ><TR
  25989. ><TD
  25990. ><DIV
  25991. CLASS="example"
  25992. ><A
  25993. NAME="AEN4707"
  25994. ></A
  25995. ><P
  25996. ><B
  25997. >Beispiel 15-4. Include innerhalb einer Funktion</B
  25998. ></P
  25999. ><TABLE
  26000. BORDER="0"
  26001. BGCOLOR="#E0E0E0"
  26002. CELLPADDING="5"
  26003. ><TR
  26004. ><TD
  26005. ><PRE
  26006. CLASS="php"
  26007. ><?php
  26008.  
  26009. function foo()
  26010. {
  26011. global $color;
  26012.  
  26013.     include 'vars.php';
  26014.  
  26015.     echo "Ein $color $fruit";
  26016. }
  26017.  
  26018. /* vars.php ist im Geltungsbereich von foo(),  *
  26019.  * d.h. $fruit steht au▀erhalb dieses Bereichs *
  26020.  * NICHT zur Verfⁿgung. $color schon, da wir   *
  26021.  * diese Variable als global definiert haben  */
  26022.  
  26023. foo();                    // Ein grⁿner Apfel
  26024. echo "Ein $color $fruit";   // Ein grⁿner
  26025.  
  26026. ?></PRE
  26027. ></TD
  26028. ></TR
  26029. ></TABLE
  26030. ></DIV
  26031. ></TD
  26032. ></TR
  26033. ></TABLE
  26034. >
  26035.    </P
  26036. ><P
  26037. >     Beim Einbinden einer Datei wechselt der Parser vom PHP-Modus zu Beginn
  26038.     der Zieldatei in den HTML-Modus und kehrt am Ende der eingebunden
  26039.     Datei wieder in den PHP-Modus zurⁿck. Deshalb muss jeglicher Code
  26040.     innerhalb der eingebundenen Datei, der als PHP-Code ausgefⁿhrt werden
  26041.     soll, von <A
  26042. HREF="#language.basic-syntax.phpmode"
  26043. >gⁿltigen
  26044.     PHP-Start- und Ende-Tags</A
  26045. > eingefa▀t sein.
  26046.    </P
  26047. ><P
  26048. >     Wenn "<A
  26049. HREF="#ini.allow-url-fopen"
  26050. >URL fopen wrappers</A
  26051. >"
  26052.     in PHP aktiviert sind (in der Standardkonfiguration ist das der Fall)
  26053.     k÷nnen Sie als Pfad der einzubindenden Datei auch eine URL (via HTTP oder
  26054.     anderen unterstⁿtzen Wrappern - eine Liste der unterstⁿtzen Protokolle
  26055.     finden Sie unter <A
  26056. HREF="#wrappers"
  26057. >Anhang L</A
  26058. >) statt einer lokalen
  26059.     Pfadangabe angeben. Falls der Zielserver die Zieldatei als PHP-Code
  26060.     interpretiert, k÷nnen Sie an die einzubindende Datei Variablen in einem
  26061.     Request-String ⁿbergeben, genauso wie bei HTTP GET. Streng genommen ist
  26062.     das nicht das Gleiche, wie diese Datei einzubinden und diesem den
  26063.     Geltungsbereich des Vater-Skripts zu vererben; das Skript wird auf dem
  26064.     Remote-Server ausgefⁿhrt und danach wird das Ergebnis in das lokale Skript
  26065.     eingebunden.
  26066.    </P
  26067. ><DIV
  26068. CLASS="warning"
  26069. ><P
  26070. ></P
  26071. ><TABLE
  26072. CLASS="warning"
  26073. BORDER="1"
  26074. WIDTH="100%"
  26075. ><TR
  26076. ><TD
  26077. ALIGN="CENTER"
  26078. ><B
  26079. >Warnung</B
  26080. ></TD
  26081. ></TR
  26082. ><TR
  26083. ><TD
  26084. ALIGN="LEFT"
  26085. ><P
  26086. >PHP Versionen kleiner 4.3.0
  26087. fⁿr Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht,
  26088. selbst wenn <A
  26089. HREF="#ini.allow-url-fopen"
  26090. >allow_url_fopen</A
  26091. > aktiviert
  26092. ist.</P
  26093. ></TD
  26094. ></TR
  26095. ></TABLE
  26096. ></DIV
  26097. ><P
  26098. >     <TABLE
  26099. WIDTH="100%"
  26100. BORDER="0"
  26101. CELLPADDING="0"
  26102. CELLSPACING="0"
  26103. CLASS="EXAMPLE"
  26104. ><TR
  26105. ><TD
  26106. ><DIV
  26107. CLASS="example"
  26108. ><A
  26109. NAME="AEN4719"
  26110. ></A
  26111. ><P
  26112. ><B
  26113. >Beispiel 15-5. <A
  26114. HREF="#function.include"
  26115. ><B
  26116. CLASS="function"
  26117. >include()</B
  26118. ></A
  26119. > ⁿber HTTP</B
  26120. ></P
  26121. ><TABLE
  26122. BORDER="0"
  26123. BGCOLOR="#E0E0E0"
  26124. CELLPADDING="5"
  26125. ><TR
  26126. ><TD
  26127. ><PRE
  26128. CLASS="php"
  26129. ><?php
  26130.  
  26131. /* Dieses Beispiel geht davon aus, dass www.example.com so konfiguriert     *
  26132.  * ist, dass .php-Dateien geparst werden und keine .txt Dateien. Also meint *
  26133.  * 'Funkt' hier, dass die Variablen $foo und $bar innerhalb der             *
  26134.  * angeforderten Datei zur Verfⁿgung stehen                                 */
  26135.  
  26136. // Funkt nicht; file.txt wird von www.example.com nicht als PHP geparst
  26137.  
  26138. include 'http://www.example.com/file.txt?foo=1&bar=2';
  26139.  
  26140. // Funkt nicht; schaut nach einer lokalen Datei namens
  26141. // 'file.php?foo=1&bar=2' im lokalen Dateisystem
  26142.  
  26143. include 'file.php?foo=1&bar=2';
  26144.  
  26145. // Funkt
  26146. include 'http://www.example.com/file.php?foo=1&bar=2';
  26147.  
  26148. $foo = 1;
  26149. $bar = 2;
  26150. include 'file.txt';  // Funkt
  26151. include 'file.php';  // Funkt
  26152.  
  26153. ?></PRE
  26154. ></TD
  26155. ></TR
  26156. ></TABLE
  26157. ></DIV
  26158. ></TD
  26159. ></TR
  26160. ></TABLE
  26161. >
  26162.      Siehe auch <A
  26163. HREF="#features.remote-files"
  26164. >      Zugriff auf entfernte Dateien</A
  26165. >, <A
  26166. HREF="#function.fopen"
  26167. ><B
  26168. CLASS="function"
  26169. >fopen()</B
  26170. ></A
  26171. > und
  26172.      <A
  26173. HREF="#function.file"
  26174. ><B
  26175. CLASS="function"
  26176. >file()</B
  26177. ></A
  26178. > fⁿr verwandte Informationen.
  26179.    </P
  26180. ><P
  26181. >     Da <A
  26182. HREF="#function.include"
  26183. ><B
  26184. CLASS="function"
  26185. >include()</B
  26186. ></A
  26187. > und <A
  26188. HREF="#function.require"
  26189. ><B
  26190. CLASS="function"
  26191. >require()</B
  26192. ></A
  26193. >
  26194.     spezielle Sprachkonstrukte sind, mⁿssen Sie diese innerhalb einer
  26195.     bedingten Anweisung in einen Anweisungsblock setzen.
  26196.    </P
  26197. ><P
  26198. >     <TABLE
  26199. WIDTH="100%"
  26200. BORDER="0"
  26201. CELLPADDING="0"
  26202. CELLSPACING="0"
  26203. CLASS="EXAMPLE"
  26204. ><TR
  26205. ><TD
  26206. ><DIV
  26207. CLASS="example"
  26208. ><A
  26209. NAME="AEN4730"
  26210. ></A
  26211. ><P
  26212. ><B
  26213. >Beispiel 15-6. include() und bedingte Bl÷cke</B
  26214. ></P
  26215. ><TABLE
  26216. BORDER="0"
  26217. BGCOLOR="#E0E0E0"
  26218. CELLPADDING="5"
  26219. ><TR
  26220. ><TD
  26221. ><PRE
  26222. CLASS="php"
  26223. ><?php
  26224.  
  26225. // Das ist FALSCH und fⁿhrt nicht zum gewⁿnschten Ergebnis.
  26226.  
  26227.  
  26228. if ($bedingung)
  26229.     include $datei;
  26230. else
  26231.     include $andere_datei;
  26232.  
  26233.  
  26234. // Das ist KORREKT.
  26235. if ($bedingung) {
  26236.     include $datei;
  26237. } else {
  26238.     include $andere_datei;
  26239. }
  26240.  
  26241. ?></PRE
  26242. ></TD
  26243. ></TR
  26244. ></TABLE
  26245. ></DIV
  26246. ></TD
  26247. ></TR
  26248. ></TABLE
  26249. >
  26250.    </P
  26251. ><P
  26252. >     Der Umgang mit Returns: Es ist m÷glich eine <A
  26253. HREF="#function.return"
  26254. ><B
  26255. CLASS="function"
  26256. >return()</B
  26257. ></A
  26258. >
  26259.     -Anweisung innerhalb einer eingebunden Datei anzugeben, um die 
  26260.     Ausfⁿhrung innerhalb dieser Datei abzubrechen und zum aufrufenden Skript
  26261.     zurⁿckzukehren. Ebenso ist die Rⁿckgabe von Werten aus einer
  26262.     eingebunden Datei m÷glich. Sie k÷nnen den Wert eines include-Aufrufs auf
  26263.     die gleiche Art und Weise nutzen, wie Sie es bei einer Funktion machen
  26264.     wⁿrden. Allerdings besteht diese M÷glichkeit nicht, wenn Sie entfernte
  26265.     Dateien mittels include einbinden au▀er, wenn die Ausgabe der
  26266.     entfernten Datei <A
  26267. HREF="#language.basic-syntax.phpmode"
  26268. >     gⁿltige PHP Start- und Endetags</A
  26269. > beeinhaltet (wie jede lokale Datei auch).
  26270.     Innerhalb dieser Tags k÷nnen Sie die ben÷tigten Variablen deklarieren und
  26271.     diese werden dann an dem Punkt Ihres Skripts eingefⁿhrt, von wo aus der
  26272.     Aufruf mit include erfolgt ist.
  26273.    </P
  26274. ><DIV
  26275. CLASS="note"
  26276. ><BLOCKQUOTE
  26277. CLASS="note"
  26278. ><P
  26279. ><B
  26280. >Anmerkung: </B
  26281. >
  26282.      In PHP 3 darf eine return-Anweisung nicht innerhalb eines Blocks
  26283.      auftreten, es sei denn, es ist ein Funktionsblock. In diesem Fall gilt
  26284.      <A
  26285. HREF="#function.return"
  26286. ><B
  26287. CLASS="function"
  26288. >return()</B
  26289. ></A
  26290. > fⁿr diese Funktion und nicht fⁿr die ganze
  26291.      Datei.
  26292.     </P
  26293. ></BLOCKQUOTE
  26294. ></DIV
  26295. ><P
  26296. >     <TABLE
  26297. WIDTH="100%"
  26298. BORDER="0"
  26299. CELLPADDING="0"
  26300. CELLSPACING="0"
  26301. CLASS="EXAMPLE"
  26302. ><TR
  26303. ><TD
  26304. ><DIV
  26305. CLASS="example"
  26306. ><A
  26307. NAME="AEN4740"
  26308. ></A
  26309. ><P
  26310. ><B
  26311. >Beispiel 15-7. <A
  26312. HREF="#function.include"
  26313. ><B
  26314. CLASS="function"
  26315. >include()</B
  26316. ></A
  26317. > und die <A
  26318. HREF="#function.return"
  26319. ><B
  26320. CLASS="function"
  26321. >return()</B
  26322. ></A
  26323. > Anweisung</B
  26324. ></P
  26325. ><TABLE
  26326. BORDER="0"
  26327. BGCOLOR="#E0E0E0"
  26328. CELLPADDING="5"
  26329. ><TR
  26330. ><TD
  26331. ><PRE
  26332. CLASS="php"
  26333. >return.php
  26334. <?php
  26335.  
  26336. $var = 'PHP';
  26337.  
  26338. return $var;
  26339.  
  26340. ?>
  26341.  
  26342. noreturn.php
  26343. <?php
  26344.  
  26345. $var = 'PHP';
  26346.  
  26347. ?>
  26348.  
  26349. testreturns.php
  26350. <?php
  26351.  
  26352. $foo = include 'return.php';
  26353.  
  26354. echo $foo; // gibt 'PHP' aus
  26355.  
  26356. $bar = include 'noreturn.php';
  26357.  
  26358. echo $bar; // gibt 1 aus
  26359.  
  26360. ?></PRE
  26361. ></TD
  26362. ></TR
  26363. ></TABLE
  26364. ></DIV
  26365. ></TD
  26366. ></TR
  26367. ></TABLE
  26368. >
  26369.    </P
  26370. ><P
  26371. >     <VAR
  26372. CLASS="literal"
  26373. >$bar</VAR
  26374. > hat den Wert <VAR
  26375. CLASS="literal"
  26376. >1</VAR
  26377. >, weil include
  26378.     erfolgreich war. Beachten Sie die Unterschiede in den obigen Beispielen.
  26379.     Das erste nutzt <A
  26380. HREF="#function.return"
  26381. ><B
  26382. CLASS="function"
  26383. >return()</B
  26384. ></A
  26385. > innerhalb der eingebundenen
  26386.     Datei im Gegensatz zum zweiten Beispiel. Weitere M÷glichkeiten Dateien in
  26387.     Variablen "einzubinden" bieten ihnen die Funktionen
  26388.     <A
  26389. HREF="#function.fopen"
  26390. ><B
  26391. CLASS="function"
  26392. >fopen()</B
  26393. ></A
  26394. > und <A
  26395. HREF="#function.file"
  26396. ><B
  26397. CLASS="function"
  26398. >file()</B
  26399. ></A
  26400. > oder
  26401.     <A
  26402. HREF="#function.include"
  26403. ><B
  26404. CLASS="function"
  26405. >include()</B
  26406. ></A
  26407. > im Zusammenspiel mit den
  26408.     <A
  26409. HREF="#ref.outcontrol"
  26410. >Funktionen zur Ausgabesteuerung</A
  26411. >.
  26412.    </P
  26413. ><DIV
  26414. CLASS="note"
  26415. ><BLOCKQUOTE
  26416. CLASS="note"
  26417. ><P
  26418. ><B
  26419. >Anmerkung: </B
  26420. >Da dies ein Sprachkonstrukt
  26421. und keine Funktion ist, deshalb k÷nnen Sie dieses nicht mit
  26422. <A
  26423. HREF="#functions.variable-functions"
  26424. >Variablenfunktionen</A
  26425. >
  26426. verwenden.</P
  26427. ></BLOCKQUOTE
  26428. ></DIV
  26429. ><P
  26430. >     Siehe auch <A
  26431. HREF="#function.require"
  26432. ><B
  26433. CLASS="function"
  26434. >require()</B
  26435. ></A
  26436. >, <A
  26437. HREF="#function.require-once"
  26438. ><B
  26439. CLASS="function"
  26440. >require_once()</B
  26441. ></A
  26442. >,
  26443.     <A
  26444. HREF="#function.include-once"
  26445. ><B
  26446. CLASS="function"
  26447. >include_once()</B
  26448. ></A
  26449. >, <A
  26450. HREF="#function.readfile"
  26451. ><B
  26452. CLASS="function"
  26453. >readfile()</B
  26454. ></A
  26455. >,
  26456.     <A
  26457. HREF="#function.virtual"
  26458. ><B
  26459. CLASS="function"
  26460. >virtual()</B
  26461. ></A
  26462. >und
  26463.     <A
  26464. HREF="#ini.include-path"
  26465. >include_path</A
  26466. >.
  26467.    </P
  26468. ></DIV
  26469. ><DIV
  26470. CLASS="sect1"
  26471. ><HR><H2
  26472. CLASS="sect1"
  26473. ><A
  26474. NAME="function.require-once"
  26475. ><A
  26476. HREF="#function.require-once"
  26477. ><B
  26478. CLASS="function"
  26479. >require_once()</B
  26480. ></A
  26481. ></A
  26482. ></H2
  26483. ><P
  26484. >     Die <A
  26485. HREF="#function.require-once"
  26486. ><B
  26487. CLASS="function"
  26488. >require_once()</B
  26489. ></A
  26490. > Anweisung bindet eine Datei ein
  26491.     und wertet diese zur Laufzeit des Skripts aus.
  26492.     Das Verhalten ist Σhnlich der <A
  26493. HREF="#function.require"
  26494. ><B
  26495. CLASS="function"
  26496. >require()</B
  26497. ></A
  26498. > Anweisung mit
  26499.     dem einzigen Unterschied, dass einmal eingebundener Code aus einer Datei
  26500.     nicht nocht einmal eingebunden wird. Lesen Sie die Dokumentation zu
  26501.     <A
  26502. HREF="#function.require"
  26503. ><B
  26504. CLASS="function"
  26505. >require()</B
  26506. ></A
  26507. > um mehr Informationen ⁿber die Arbeitsweise
  26508.     dieser Anweisung zu erhalten.
  26509.    </P
  26510. ><P
  26511. >     <A
  26512. HREF="#function.require-once"
  26513. ><B
  26514. CLASS="function"
  26515. >require_once()</B
  26516. ></A
  26517. > sollten Sie in den FΣllen benutzen,
  26518.     wenn die gleiche Datei in einem bestimmten Bereich mehrmals eingebunden
  26519.     und interpretiert werden soll und Sie sicher stellen wollen, dass diese
  26520.     Datei nur exakt einmal eingebunden wird, um Probleme mit Wiederholungen
  26521.     bei Funktions-Definitionen und Wertzuweisungen zu Variablen zu vermeiden,
  26522.     usw.
  26523.    </P
  26524. ><P
  26525. >     Weitere Beispiele zu <A
  26526. HREF="#function.require-once"
  26527. ><B
  26528. CLASS="function"
  26529. >require_once()</B
  26530. ></A
  26531. > und
  26532.     <A
  26533. HREF="#function.include-once"
  26534. ><B
  26535. CLASS="function"
  26536. >include_once()</B
  26537. ></A
  26538. > k÷nnen Sie dem
  26539.     <A
  26540. HREF="http://pear.php.net/"
  26541. TARGET="_top"
  26542. >PEAR</A
  26543. >-Code entnehmen, welcher
  26544.     im aktuellsten PHP-Sourcecode enthalten ist.
  26545.    </P
  26546. ><DIV
  26547. CLASS="note"
  26548. ><BLOCKQUOTE
  26549. CLASS="note"
  26550. ><P
  26551. ><B
  26552. >Anmerkung: </B
  26553. >
  26554.     <A
  26555. HREF="#function.require-once"
  26556. ><B
  26557. CLASS="function"
  26558. >require_once()</B
  26559. ></A
  26560. > steht ab PHP 4.01pl2 zur
  26561.     Verfⁿgung.
  26562.    </P
  26563. ></BLOCKQUOTE
  26564. ></DIV
  26565. ><DIV
  26566. CLASS="note"
  26567. ><BLOCKQUOTE
  26568. CLASS="note"
  26569. ><P
  26570. ><B
  26571. >Anmerkung: </B
  26572. >
  26573.      Beachten Sie, dass auf auf einem Betriebssystem, das nicht zwischen
  26574.      Gro▀- und Kleinschreibung unterschiedet (wie z.B. Windows) das Verhalten
  26575.      von <A
  26576. HREF="#function.require-once"
  26577. ><B
  26578. CLASS="function"
  26579. >require_once()</B
  26580. ></A
  26581. > und
  26582.      <A
  26583. HREF="#function.include-once"
  26584. ><B
  26585. CLASS="function"
  26586. >include_once()</B
  26587. ></A
  26588. > nicht unbedingt ihren Erwartungen
  26589.      entspricht.
  26590.      <TABLE
  26591. WIDTH="100%"
  26592. BORDER="0"
  26593. CELLPADDING="0"
  26594. CELLSPACING="0"
  26595. CLASS="EXAMPLE"
  26596. ><TR
  26597. ><TD
  26598. ><DIV
  26599. CLASS="example"
  26600. ><A
  26601. NAME="AEN4783"
  26602. ></A
  26603. ><P
  26604. ><B
  26605. >Beispiel 15-8. 
  26606.        <A
  26607. HREF="#function.require-once"
  26608. ><B
  26609. CLASS="function"
  26610. >require_once()</B
  26611. ></A
  26612. > unterscheidet nicht zwischen
  26613.        Gro▀-/Kleinschreibung unter Windows
  26614.       </B
  26615. ></P
  26616. ><TABLE
  26617. BORDER="0"
  26618. BGCOLOR="#E0E0E0"
  26619. CELLPADDING="5"
  26620. ><TR
  26621. ><TD
  26622. ><PRE
  26623. CLASS="php"
  26624. ><?php
  26625. require_once("a.php"); // bindet a.php ein
  26626. require_once("A.php"); // bindet a.php auf Windows nochmal ein!
  26627. ?></PRE
  26628. ></TD
  26629. ></TR
  26630. ></TABLE
  26631. ></DIV
  26632. ></TD
  26633. ></TR
  26634. ></TABLE
  26635. >
  26636.     </P
  26637. ></BLOCKQUOTE
  26638. ></DIV
  26639. ><DIV
  26640. CLASS="warning"
  26641. ><P
  26642. ></P
  26643. ><TABLE
  26644. CLASS="warning"
  26645. BORDER="1"
  26646. WIDTH="100%"
  26647. ><TR
  26648. ><TD
  26649. ALIGN="CENTER"
  26650. ><B
  26651. >Warnung</B
  26652. ></TD
  26653. ></TR
  26654. ><TR
  26655. ><TD
  26656. ALIGN="LEFT"
  26657. ><P
  26658. >PHP Versionen kleiner 4.3.0
  26659. fⁿr Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht,
  26660. selbst wenn <A
  26661. HREF="#ini.allow-url-fopen"
  26662. >allow_url_fopen</A
  26663. > aktiviert
  26664. ist.</P
  26665. ></TD
  26666. ></TR
  26667. ></TABLE
  26668. ></DIV
  26669. ><P
  26670. >     Siehe auch: <A
  26671. HREF="#function.require"
  26672. ><B
  26673. CLASS="function"
  26674. >require()</B
  26675. ></A
  26676. >,
  26677.     <A
  26678. HREF="#function.include"
  26679. ><B
  26680. CLASS="function"
  26681. >include()</B
  26682. ></A
  26683. >, <A
  26684. HREF="#function.include-once"
  26685. ><B
  26686. CLASS="function"
  26687. >include_once()</B
  26688. ></A
  26689. >,
  26690.     <A
  26691. HREF="#function.get-required-files"
  26692. ><B
  26693. CLASS="function"
  26694. >get_required_files()</B
  26695. ></A
  26696. >,
  26697.     <A
  26698. HREF="#function.get-included-files"
  26699. ><B
  26700. CLASS="function"
  26701. >get_included_files()</B
  26702. ></A
  26703. >, 
  26704.     <A
  26705. HREF="#function.readfile"
  26706. ><B
  26707. CLASS="function"
  26708. >readfile()</B
  26709. ></A
  26710. >
  26711.     und <A
  26712. HREF="#function.virtual"
  26713. ><B
  26714. CLASS="function"
  26715. >virtual()</B
  26716. ></A
  26717. >.
  26718.    </P
  26719. ></DIV
  26720. ><DIV
  26721. CLASS="sect1"
  26722. ><HR><H2
  26723. CLASS="sect1"
  26724. ><A
  26725. NAME="function.include-once"
  26726. ><A
  26727. HREF="#function.include-once"
  26728. ><B
  26729. CLASS="function"
  26730. >include_once()</B
  26731. ></A
  26732. ></A
  26733. ></H2
  26734. ><P
  26735. >     Die Anweisung <A
  26736. HREF="#function.include-once"
  26737. ><B
  26738. CLASS="function"
  26739. >include_once()</B
  26740. ></A
  26741. > schlie▀t zur
  26742.     Ausfⁿhrungszeit die angegebene Datei ein und wertet diese aus. Dies
  26743.     ist Σhnlich der <A
  26744. HREF="#function.include"
  26745. ><B
  26746. CLASS="function"
  26747. >include()</B
  26748. ></A
  26749. >-Anweisung; mit dem
  26750.     Unterschied, dass einmal eingebundener Code nicht nochmals 
  26751.     eingebunden wird. Wie der Name vermuten lΣsst, wird die Datei nur ein
  26752.     einziges Mal eingebunden.
  26753.    </P
  26754. ><P
  26755. >     <A
  26756. HREF="#function.include-once"
  26757. ><B
  26758. CLASS="function"
  26759. >include_once()</B
  26760. ></A
  26761. > sollten Sie in den FΣllen benutzen,
  26762.     wenn die gleiche Datei in einem bestimmten Bereich mehrmals eingebunden
  26763.     und interpretiert werden soll und Sie sicher stellen wollen, dass diese
  26764.     Datei nur exakt einmal eingebunden wird, um Probleme mit Wiederholungen
  26765.     von Funktionsdefinitionen und Wertzuweisungen an Variablen zu vermeiden,
  26766.     usw.
  26767.    </P
  26768. ><P
  26769. >     Weitere Beispiele zu <A
  26770. HREF="#function.require-once"
  26771. ><B
  26772. CLASS="function"
  26773. >require_once()</B
  26774. ></A
  26775. > und
  26776.     <A
  26777. HREF="#function.include-once"
  26778. ><B
  26779. CLASS="function"
  26780. >include_once()</B
  26781. ></A
  26782. > k÷nnen Sie dem
  26783.     <A
  26784. HREF="http://pear.php.net/"
  26785. TARGET="_top"
  26786. >PEAR</A
  26787. >-Code entnehmen, welcher
  26788.     im aktuellsten PHP-Source-Code enthalten ist.
  26789.    </P
  26790. ><DIV
  26791. CLASS="note"
  26792. ><BLOCKQUOTE
  26793. CLASS="note"
  26794. ><P
  26795. ><B
  26796. >Anmerkung: </B
  26797. >
  26798.     <A
  26799. HREF="#function.include-once"
  26800. ><B
  26801. CLASS="function"
  26802. >include_once()</B
  26803. ></A
  26804. > steht ab PHP 4.01pl2 zur
  26805.     Verfⁿgung.
  26806.    </P
  26807. ></BLOCKQUOTE
  26808. ></DIV
  26809. ><DIV
  26810. CLASS="note"
  26811. ><BLOCKQUOTE
  26812. CLASS="note"
  26813. ><P
  26814. ><B
  26815. >Anmerkung: </B
  26816. >
  26817.      Beachten Sie, dass auf auf einem Betriebssystem, das nicht zwischen
  26818.      Gro▀- und Kleinschreibung unterschiedet (wie z.B. Windows) das Verhalten
  26819.      von <A
  26820. HREF="#function.include-once"
  26821. ><B
  26822. CLASS="function"
  26823. >include_once()</B
  26824. ></A
  26825. > und
  26826.      <A
  26827. HREF="#function.require-once"
  26828. ><B
  26829. CLASS="function"
  26830. >require_once()</B
  26831. ></A
  26832. > nicht unbedingt ihren Erwartungen
  26833.      entspricht.
  26834.      <TABLE
  26835. WIDTH="100%"
  26836. BORDER="0"
  26837. CELLPADDING="0"
  26838. CELLSPACING="0"
  26839. CLASS="EXAMPLE"
  26840. ><TR
  26841. ><TD
  26842. ><DIV
  26843. CLASS="example"
  26844. ><A
  26845. NAME="AEN4817"
  26846. ></A
  26847. ><P
  26848. ><B
  26849. >Beispiel 15-9. 
  26850.        <A
  26851. HREF="#function.include-once"
  26852. ><B
  26853. CLASS="function"
  26854. >include_once()</B
  26855. ></A
  26856. > unterscheidet nicht zwischen
  26857.        Gro▀-/Kleinschreibung unter Windows
  26858.       </B
  26859. ></P
  26860. ><TABLE
  26861. BORDER="0"
  26862. BGCOLOR="#E0E0E0"
  26863. CELLPADDING="5"
  26864. ><TR
  26865. ><TD
  26866. ><PRE
  26867. CLASS="php"
  26868. ><?php
  26869. include_once("a.php"); // bindet a.php ein
  26870. include_once("A.php"); // bindet a.php auf Windows nochmal ein!
  26871. ?></PRE
  26872. ></TD
  26873. ></TR
  26874. ></TABLE
  26875. ></DIV
  26876. ></TD
  26877. ></TR
  26878. ></TABLE
  26879. >
  26880.     </P
  26881. ></BLOCKQUOTE
  26882. ></DIV
  26883. ><DIV
  26884. CLASS="warning"
  26885. ><P
  26886. ></P
  26887. ><TABLE
  26888. CLASS="warning"
  26889. BORDER="1"
  26890. WIDTH="100%"
  26891. ><TR
  26892. ><TD
  26893. ALIGN="CENTER"
  26894. ><B
  26895. >Warnung</B
  26896. ></TD
  26897. ></TR
  26898. ><TR
  26899. ><TD
  26900. ALIGN="LEFT"
  26901. ><P
  26902. >PHP Versionen kleiner 4.3.0
  26903. fⁿr Windows, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht,
  26904. selbst wenn <A
  26905. HREF="#ini.allow-url-fopen"
  26906. >allow_url_fopen</A
  26907. > aktiviert
  26908. ist.</P
  26909. ></TD
  26910. ></TR
  26911. ></TABLE
  26912. ></DIV
  26913. ><P
  26914. >     Siehe auch <A
  26915. HREF="#function.include"
  26916. ><B
  26917. CLASS="function"
  26918. >include()</B
  26919. ></A
  26920. >,
  26921.     <A
  26922. HREF="#function.require"
  26923. ><B
  26924. CLASS="function"
  26925. >require()</B
  26926. ></A
  26927. >, <A
  26928. HREF="#function.require-once"
  26929. ><B
  26930. CLASS="function"
  26931. >require_once()</B
  26932. ></A
  26933. >,
  26934.     <A
  26935. HREF="#function.get-required-files"
  26936. ><B
  26937. CLASS="function"
  26938. >get_required_files()</B
  26939. ></A
  26940. >,
  26941.     <A
  26942. HREF="#function.get-included-files"
  26943. ><B
  26944. CLASS="function"
  26945. >get_included_files()</B
  26946. ></A
  26947. >, <A
  26948. HREF="#function.readfile"
  26949. ><B
  26950. CLASS="function"
  26951. >readfile()</B
  26952. ></A
  26953. >
  26954.     und <A
  26955. HREF="#function.virtual"
  26956. ><B
  26957. CLASS="function"
  26958. >virtual()</B
  26959. ></A
  26960. >.
  26961.    </P
  26962. ></DIV
  26963. ></DIV
  26964. ><DIV
  26965. CLASS="chapter"
  26966. ><HR><H1
  26967. ><A
  26968. NAME="functions"
  26969. >Kapitel 16. Funktionen</A
  26970. ></H1
  26971. ><DIV
  26972. CLASS="sect1"
  26973. ><H2
  26974. CLASS="sect1"
  26975. ><A
  26976. NAME="functions.user-defined"
  26977. >Vom Nutzer definierte Funktionen</A
  26978. ></H2
  26979. ><P
  26980. >     Eine Funktion kann wie folgt definiert werden:
  26981.  
  26982.     <DIV
  26983. CLASS="informalexample"
  26984. ><P
  26985. ></P
  26986. ><A
  26987. NAME="AEN4837"
  26988. ></A
  26989. ><TABLE
  26990. BORDER="0"
  26991. BGCOLOR="#E0E0E0"
  26992. CELLPADDING="5"
  26993. ><TR
  26994. ><TD
  26995. ><PRE
  26996. CLASS="php"
  26997. >function foo ($arg_1, $arg_2, ..., $arg_n)
  26998. {
  26999.     echo "Beispielfunktion.\n";
  27000.     return $retval;
  27001. }</PRE
  27002. ></TD
  27003. ></TR
  27004. ></TABLE
  27005. ><P
  27006. ></P
  27007. ></DIV
  27008. >
  27009.    </P
  27010. ><P
  27011. >     Jeder beliebige korrekte PHP-Code kann in einer Funktion
  27012.     vorkommen, sogar andere Funktionen und <A
  27013. HREF="#keyword.class"
  27014. >Klassen-</A
  27015. > Definitionen.
  27016.    </P
  27017. ><P
  27018. >     In PHP 3 mⁿssen Funktionen definiert sein, bevor man auf sie
  27019.     verweist. In PHP4 ist das nicht mehr erforderlich,
  27020.     <SPAN
  27021. CLASS="emphasis"
  27022. ><I
  27023. CLASS="emphasis"
  27024. >au▀er</I
  27025. ></SPAN
  27026. > wenn eine Funktion nur bedingt definiert
  27027.     wird, wie in den beiden untenstehenden Beispielen gezeigt.
  27028.    </P
  27029. ><P
  27030. >     Wenn eine Funktion nur unter bestimmten Bedingungen definiert wird,
  27031.     mu▀ die Definition dieser Funktion noch <SPAN
  27032. CLASS="emphasis"
  27033. ><I
  27034. CLASS="emphasis"
  27035. >vor</I
  27036. ></SPAN
  27037. >
  27038.     deren Aufruf abgearbeitet werden.
  27039.     <TABLE
  27040. WIDTH="100%"
  27041. BORDER="0"
  27042. CELLPADDING="0"
  27043. CELLSPACING="0"
  27044. CLASS="EXAMPLE"
  27045. ><TR
  27046. ><TD
  27047. ><DIV
  27048. CLASS="example"
  27049. ><A
  27050. NAME="AEN4845"
  27051. ></A
  27052. ><P
  27053. ><B
  27054. >Beispiel 16-1. Bedingte Funktionen</B
  27055. ></P
  27056. ><TABLE
  27057. BORDER="0"
  27058. BGCOLOR="#E0E0E0"
  27059. CELLPADDING="5"
  27060. ><TR
  27061. ><TD
  27062. ><PRE
  27063. CLASS="php"
  27064. ><?php
  27065.  
  27066. $makefoo = true;
  27067.  
  27068. /* Wir k÷nnen foo() von her aus nicht
  27069.    aufrufen, da sie noch nicht existiert,
  27070.    aber wir k÷nnen bar() aufrufen */
  27071.  
  27072. bar();
  27073.  
  27074. if ($makefoo) {
  27075.   function foo ()
  27076.   {
  27077.     echo "Ich existiere nicht, bis mich die Programmausfⁿhrung erreicht hat.\n";
  27078.   }
  27079. }
  27080.  
  27081. /* Nun k÷nnen wir foo() sicher aufrufen,
  27082.    da $makefoo als true ausgewertet wurde */
  27083.  
  27084. if ($makefoo) foo();
  27085.  
  27086. function bar()
  27087. {
  27088.   echo "Ich existiere sofort nach Programmstart.\n";
  27089. }
  27090.  
  27091. ?></PRE
  27092. ></TD
  27093. ></TR
  27094. ></TABLE
  27095. ></DIV
  27096. ></TD
  27097. ></TR
  27098. ></TABLE
  27099. >
  27100.     <TABLE
  27101. WIDTH="100%"
  27102. BORDER="0"
  27103. CELLPADDING="0"
  27104. CELLSPACING="0"
  27105. CLASS="EXAMPLE"
  27106. ><TR
  27107. ><TD
  27108. ><DIV
  27109. CLASS="example"
  27110. ><A
  27111. NAME="AEN4848"
  27112. ></A
  27113. ><P
  27114. ><B
  27115. >Beispiel 16-2. Funktionen innerhalb von Funktionen</B
  27116. ></P
  27117. ><TABLE
  27118. BORDER="0"
  27119. BGCOLOR="#E0E0E0"
  27120. CELLPADDING="5"
  27121. ><TR
  27122. ><TD
  27123. ><PRE
  27124. CLASS="php"
  27125. ><?php
  27126. function foo() 
  27127. {
  27128.   function bar() 
  27129.   {
  27130.     echo "Ich existiere nicht, bis foo() aufgerufen wurde.\n";
  27131.   }
  27132. }
  27133.  
  27134. /* Wir k÷nnen bar() noch nicht
  27135.    aufrufen, da es nicht existiert */
  27136.  
  27137. foo();
  27138.  
  27139. /* Nun k÷nnen wir auch bar() aufrufen,
  27140.    da sie durch die Abarbeitung von
  27141.    foo() verfⁿgbar gemacht wurde */
  27142.  
  27143. bar();
  27144.  
  27145. ?></PRE
  27146. ></TD
  27147. ></TR
  27148. ></TABLE
  27149. ></DIV
  27150. ></TD
  27151. ></TR
  27152. ></TABLE
  27153. >
  27154.    </P
  27155. ><P
  27156. >     PHP unterstⁿtzt weder das ▄berladen von Funktionen, noch ist es
  27157.     m÷glich, zuvor deklarierte Funktionen neu zu definieren oder die
  27158.     Definition zu l÷schen.
  27159.    </P
  27160. ><P
  27161. >     PHP 3 unterstⁿtzt keine variable Anzahl von Parametern,
  27162.     obwohl Vorgabewerte fⁿr Parameter unterstⁿtzt werden
  27163.     (weitere Informationen finden Sie unter
  27164.     <A
  27165. HREF="#functions.arguments.default"
  27166. >Vorgabewerte
  27167.     fⁿr Parameter</A
  27168. >). PHP 4 unterstⁿtzt beides: siehe
  27169.     <A
  27170. HREF="#functions.variable-arg-list"
  27171. >Variable
  27172.     Parameteranzahl</A
  27173. > und die Funktionsreferenzen fⁿr
  27174.     <A
  27175. HREF="#function.func-num-args"
  27176. ><B
  27177. CLASS="function"
  27178. >func_num_args()</B
  27179. ></A
  27180. >,
  27181.     <A
  27182. HREF="#function.func-get-arg"
  27183. ><B
  27184. CLASS="function"
  27185. >func_get_arg()</B
  27186. ></A
  27187. > und
  27188.     <A
  27189. HREF="#function.func-get-args"
  27190. ><B
  27191. CLASS="function"
  27192. >func_get_args()</B
  27193. ></A
  27194. > fⁿr weitere Informationen.
  27195.    </P
  27196. ></DIV
  27197. ><DIV
  27198. CLASS="sect1"
  27199. ><HR><H2
  27200. CLASS="sect1"
  27201. ><A
  27202. NAME="functions.arguments"
  27203. >Funktionsparameter</A
  27204. ></H2
  27205. ><P
  27206. >     Mit einer Parameterliste kann man Informationen an eine Funktion 
  27207.     ⁿbergeben. Die Parameterliste ist eine durch Kommas getrennte
  27208.     Liste von Variablen und/oder Konstanten.
  27209.    </P
  27210. ><P
  27211. >     PHP unterstⁿtzt die Weitergabe von Parametern als Werte (das ist
  27212.     der Standard), als <A
  27213. HREF="#functions.arguments.by-reference"
  27214. >Verweise</A
  27215. >, und
  27216.     als <A
  27217. HREF="#functions.arguments.default"
  27218. >Vorgabewerte</A
  27219. >.
  27220.     Die ▄bergabe einer variablen Anzahl von Parametern wird nur von
  27221.     PHP 4 und h÷her unterstⁿtzt, siehe <A
  27222. HREF="#functions.variable-arg-list"
  27223. >Variable
  27224.     Parameteranzahl</A
  27225. > und die Funktionsreferenzen fⁿr
  27226.     <A
  27227. HREF="#function.func-num-args"
  27228. ><B
  27229. CLASS="function"
  27230. >func_num_args()</B
  27231. ></A
  27232. >,
  27233.     <A
  27234. HREF="#function.func-get-arg"
  27235. ><B
  27236. CLASS="function"
  27237. >func_get_arg()</B
  27238. ></A
  27239. > und
  27240.     <A
  27241. HREF="#function.func-get-args"
  27242. ><B
  27243. CLASS="function"
  27244. >func_get_args()</B
  27245. ></A
  27246. > fⁿr weitere Informationen. 
  27247.     Durch die ▄bergabe eines Arrays mit Parametern kann man auch
  27248.     in PHP 3 einen Σhnlichen Effekt erreichen:
  27249.  
  27250.     <DIV
  27251. CLASS="informalexample"
  27252. ><P
  27253. ></P
  27254. ><A
  27255. NAME="AEN4868"
  27256. ></A
  27257. ><TABLE
  27258. BORDER="0"
  27259. BGCOLOR="#E0E0E0"
  27260. CELLPADDING="5"
  27261. ><TR
  27262. ><TD
  27263. ><PRE
  27264. CLASS="php"
  27265. >function rechne_array($eingabe)
  27266. {
  27267.     echo "$eingabe[0] + $eingabe[1] = ", $eingabe[0]+$eingabe[1];
  27268. }</PRE
  27269. ></TD
  27270. ></TR
  27271. ></TABLE
  27272. ><P
  27273. ></P
  27274. ></DIV
  27275. >
  27276.    </P
  27277. ><DIV
  27278. CLASS="sect2"
  27279. ><HR><H3
  27280. CLASS="sect2"
  27281. ><A
  27282. NAME="functions.arguments.by-reference"
  27283. >Verweise als Parameter ⁿbergeben</A
  27284. ></H3
  27285. ><P
  27286. >      Normalerweise werden den Funktionen Werte als Parameter
  27287.      ⁿbermittelt. Wenn man den Wert dieses Parameters innerhalb der
  27288.      Funktion Σndert, bleibt der Parameter au▀erhalb der Funktion
  27289.      unverΣndert. Wollen Sie aber genau das erreichen, dann mⁿssen
  27290.      Sie die Parameter als Verweise (Referenzen) ⁿbergeben. 
  27291.     </P
  27292. ><P
  27293. >      Wenn eine Funktion einen Parameter generell als Verweis behandeln
  27294.      soll, setzt man in der Funktionsdefinition ein kaufmΣnnisches Und
  27295.      (&) vor den Parameternamen:
  27296.  
  27297.      <DIV
  27298. CLASS="informalexample"
  27299. ><P
  27300. ></P
  27301. ><A
  27302. NAME="AEN4874"
  27303. ></A
  27304. ><TABLE
  27305. BORDER="0"
  27306. BGCOLOR="#E0E0E0"
  27307. CELLPADDING="5"
  27308. ><TR
  27309. ><TD
  27310. ><PRE
  27311. CLASS="php"
  27312. >function fuege_etwas_anderes_an (&$string)
  27313. {
  27314.     $string .= 'und nun zu etwas anderem.';
  27315. }
  27316. $str = 'Dies ist ein String, ';
  27317. fuege_etwas_anderes_an ($str);
  27318. echo $str; // Ausgabe: 'Dies ist ein String, und nun zu etwas anderem.'</PRE
  27319. ></TD
  27320. ></TR
  27321. ></TABLE
  27322. ><P
  27323. ></P
  27324. ></DIV
  27325. >
  27326.     </P
  27327. ></DIV
  27328. ><DIV
  27329. CLASS="sect2"
  27330. ><HR><H3
  27331. CLASS="sect2"
  27332. ><A
  27333. NAME="functions.arguments.default"
  27334. >Vorgabewerte fⁿr Parameter</A
  27335. ></H3
  27336. ><P
  27337. >      Eine Funktion kann C++-artige Vorgabewerte fⁿr skalare Parameter
  27338.      wie folgt definieren:
  27339.  
  27340.      <DIV
  27341. CLASS="informalexample"
  27342. ><P
  27343. ></P
  27344. ><A
  27345. NAME="AEN4879"
  27346. ></A
  27347. ><TABLE
  27348. BORDER="0"
  27349. BGCOLOR="#E0E0E0"
  27350. CELLPADDING="5"
  27351. ><TR
  27352. ><TD
  27353. ><PRE
  27354. CLASS="php"
  27355. >function machkaffee ($typ = "Cappucino")
  27356. {
  27357.     return "Ich mache eine Tasse $typ.\n";
  27358. }
  27359. echo machkaffee ();
  27360. echo machkaffee ("Espresso");</PRE
  27361. ></TD
  27362. ></TR
  27363. ></TABLE
  27364. ><P
  27365. ></P
  27366. ></DIV
  27367. >
  27368.     </P
  27369. ><P
  27370. >      Die Ausgabe von diesem kleinen Skript ist:
  27371.  
  27372.      <TABLE
  27373. BORDER="0"
  27374. BGCOLOR="#E0E0E0"
  27375. CELLPADDING="5"
  27376. ><TR
  27377. ><TD
  27378. ><PRE
  27379. CLASS="screen"
  27380. >Ich mache eine Tasse Cappucino.
  27381. Ich mache eine Tasse Espresso.</PRE
  27382. ></TD
  27383. ></TR
  27384. ></TABLE
  27385. >
  27386.     </P
  27387. ><P
  27388. >      Der Vorgabewert muss ein konstanter Ausdruck sein, darf also (zum
  27389.      Beispiel) keine Variable oder Element einer Klasse sein.
  27390.     </P
  27391. ><P
  27392. >      Bitte beachten Sie, dass alle Vorgabewerte rechts von den 
  27393.      Nicht-Vorgabeparametern stehen sollten; - sonst wird es nicht 
  27394.      funktionieren. Betrachten Sie folgendes Beispiel:
  27395.  
  27396.      <DIV
  27397. CLASS="informalexample"
  27398. ><P
  27399. ></P
  27400. ><A
  27401. NAME="AEN4885"
  27402. ></A
  27403. ><TABLE
  27404. BORDER="0"
  27405. BGCOLOR="#E0E0E0"
  27406. CELLPADDING="5"
  27407. ><TR
  27408. ><TD
  27409. ><PRE
  27410. CLASS="php"
  27411. >function mach_joghurt ($typ = "rechtsdrehendes", $geschmack)
  27412. {
  27413.     return "Mache einen Becher $typ $geschmack-joghurt.\n";
  27414. }
  27415.  
  27416. echo mach_joghurt ("Brombeer");   // arbeitet nicht wie erwartet</PRE
  27417. ></TD
  27418. ></TR
  27419. ></TABLE
  27420. ><P
  27421. ></P
  27422. ></DIV
  27423. >
  27424.     </P
  27425. ><P
  27426. >      Die Ausgabe dieses Beispiels ist::
  27427.  
  27428.      <TABLE
  27429. BORDER="0"
  27430. BGCOLOR="#E0E0E0"
  27431. CELLPADDING="5"
  27432. ><TR
  27433. ><TD
  27434. ><PRE
  27435. CLASS="screen"
  27436. >Warning: Missing argument 2 in call to makeyogurt() in 
  27437. /usr/local/etc/httpd/htdocs/php3test/functest.html on line 41
  27438. Mache einen Becher Brombeer-joghurt.</PRE
  27439. ></TD
  27440. ></TR
  27441. ></TABLE
  27442. ></P
  27443. ><P
  27444. >      Nun vergleichen Sie bitte oberes Beispiel mit folgendem:
  27445.  
  27446.      <DIV
  27447. CLASS="informalexample"
  27448. ><P
  27449. ></P
  27450. ><A
  27451. NAME="AEN4890"
  27452. ></A
  27453. ><TABLE
  27454. BORDER="0"
  27455. BGCOLOR="#E0E0E0"
  27456. CELLPADDING="5"
  27457. ><TR
  27458. ><TD
  27459. ><PRE
  27460. CLASS="php"
  27461. >function mach_joghurt ($geschmack, $typ = "rechtsdrehendes")
  27462. {
  27463.     return "Mache einen Becher $typ $geschmack-joghurt.\n";
  27464. }
  27465.  
  27466. echo mach_joghurt ("Brombeer");   // arbeitet wie erwartet.</PRE
  27467. ></TD
  27468. ></TR
  27469. ></TABLE
  27470. ><P
  27471. ></P
  27472. ></DIV
  27473. >
  27474.     </P
  27475. ><P
  27476. >      ... und jetzt ist die Ausgabe:
  27477.  
  27478.      <TABLE
  27479. BORDER="0"
  27480. BGCOLOR="#E0E0E0"
  27481. CELLPADDING="5"
  27482. ><TR
  27483. ><TD
  27484. ><PRE
  27485. CLASS="screen"
  27486. >Mache einen Becher rechtsdrehendes Brombeer-Joghurt.</PRE
  27487. ></TD
  27488. ></TR
  27489. ></TABLE
  27490. >
  27491.     </P
  27492. ></DIV
  27493. ><DIV
  27494. CLASS="sect2"
  27495. ><HR><H3
  27496. CLASS="sect2"
  27497. ><A
  27498. NAME="functions.variable-arg-list"
  27499. >Variable Anzahl von Parametern</A
  27500. ></H3
  27501. ><P
  27502. >      PHP 4 unterstⁿtzt eine variable Anzahl von Parametern in
  27503.      benutzerdefinierten Funktionen. Das Handling dieser Parameter
  27504.      fΣllt mittels der Funktionen <A
  27505. HREF="#function.func-num-args"
  27506. ><B
  27507. CLASS="function"
  27508. >func_num_args()</B
  27509. ></A
  27510. >,
  27511.      <A
  27512. HREF="#function.func-get-arg"
  27513. ><B
  27514. CLASS="function"
  27515. >func_get_arg()</B
  27516. ></A
  27517. > und
  27518.      <A
  27519. HREF="#function.func-get-args"
  27520. ><B
  27521. CLASS="function"
  27522. >func_get_args()</B
  27523. ></A
  27524. > sehr leicht.
  27525.     </P
  27526. ><P
  27527. >      Es ist keine spezielle Syntax erforderlich. Die Parameter k÷nnen
  27528.      wie gehabt explizit in den Funktionsdeklarationen angegeben
  27529.      werden, und werden sich wie gewohnt verhalten.
  27530.     </P
  27531. ></DIV
  27532. ></DIV
  27533. ><DIV
  27534. CLASS="sect1"
  27535. ><HR><H2
  27536. CLASS="sect1"
  27537. ><A
  27538. NAME="functions.returning-values"
  27539. >Rⁿckgabewerte</A
  27540. ></H2
  27541. ><P
  27542. >     Sie k÷nnen Werte mit dem optionalen Befehl "return" zurⁿckgeben.
  27543.     Es k÷nnen Variablen jedes Typs zurⁿckgegeben werden, auch Listen
  27544.     oder Objekte. Die beendet sofort die Funktion, und die Kontrolle
  27545.     wird wieder an die aufrufende Zeile zurⁿckgegeben. Weitere
  27546.     Informationen finden Sie unter <A
  27547. HREF="#function.return"
  27548. ><B
  27549. CLASS="function"
  27550. >return()</B
  27551. ></A
  27552. >.
  27553.     <DIV
  27554. CLASS="informalexample"
  27555. ><P
  27556. ></P
  27557. ><A
  27558. NAME="AEN4905"
  27559. ></A
  27560. ><TABLE
  27561. BORDER="0"
  27562. BGCOLOR="#E0E0E0"
  27563. CELLPADDING="5"
  27564. ><TR
  27565. ><TD
  27566. ><PRE
  27567. CLASS="php"
  27568. >function quadrat ($zahl)
  27569. {
  27570.     return $zahl * $zahl;
  27571. }
  27572. echo quadrat (4);   // gibt '16' aus.</PRE
  27573. ></TD
  27574. ></TR
  27575. ></TABLE
  27576. ><P
  27577. ></P
  27578. ></DIV
  27579. >
  27580.    </P
  27581. ><P
  27582. >     Es ist nicht m÷glich, mehrere Werte von einer Funktion zurⁿckzugeben.
  27583.     Ein Σhnliches Resultat kann man aber durch die Rⁿckgabe von Listen
  27584.     erreichen.
  27585.  
  27586.     <DIV
  27587. CLASS="informalexample"
  27588. ><P
  27589. ></P
  27590. ><A
  27591. NAME="AEN4908"
  27592. ></A
  27593. ><TABLE
  27594. BORDER="0"
  27595. BGCOLOR="#E0E0E0"
  27596. CELLPADDING="5"
  27597. ><TR
  27598. ><TD
  27599. ><PRE
  27600. CLASS="php"
  27601. >function kleine_zahlen()
  27602. {
  27603.    return array (0, 1, 2);
  27604. }
  27605. list ($null, $eins, $zwei) = kleine_zahlen();</PRE
  27606. ></TD
  27607. ></TR
  27608. ></TABLE
  27609. ><P
  27610. ></P
  27611. ></DIV
  27612. >
  27613.    </P
  27614. ><P
  27615. >     Um von einer Funktion eine Referenz zurⁿckzugeben, mⁿssen Sie
  27616.     den Referenz-Operator & sowohl in der Funktionsdeklaration,
  27617.     als auch bei der Zuweisung des zurⁿckgegebenen Wertes verwenden: 
  27618.     <DIV
  27619. CLASS="informalexample"
  27620. ><P
  27621. ></P
  27622. ><A
  27623. NAME="AEN4911"
  27624. ></A
  27625. ><TABLE
  27626. BORDER="0"
  27627. BGCOLOR="#E0E0E0"
  27628. CELLPADDING="5"
  27629. ><TR
  27630. ><TD
  27631. ><PRE
  27632. CLASS="php"
  27633. >function &returniere_referenz()
  27634. {
  27635.     return $einereferenz;
  27636. }
  27637.  
  27638. $neuereferenz =& returniere_referenz();</PRE
  27639. ></TD
  27640. ></TR
  27641. ></TABLE
  27642. ><P
  27643. ></P
  27644. ></DIV
  27645. >
  27646.    </P
  27647. ><P
  27648. >     Weitere Informationen ⁿber Referenzen finden Sie im Kapitel
  27649.     <A
  27650. HREF="#language.references"
  27651. >Referenzen in PHP</A
  27652. >.
  27653.    </P
  27654. ></DIV
  27655. ><DIV
  27656. CLASS="sect1"
  27657. ><HR><H2
  27658. CLASS="sect1"
  27659. ><A
  27660. NAME="functions.old-syntax"
  27661. ><VAR
  27662. CLASS="literal"
  27663. >old_function</VAR
  27664. ></A
  27665. ></H2
  27666. ><P
  27667. >     Der Befehl <VAR
  27668. CLASS="literal"
  27669. >old_function</VAR
  27670. > erlaubt es, eine
  27671.     Funktion genauso wie bei PHP/FI2 zu definieren (nur "function"
  27672.     wird durch "old_function" ersetzt.
  27673.    </P
  27674. ><P
  27675. >     Dieser Befehl sollte nur vom PHP/FI2->PHP3-Konverter genutzt
  27676.     werden.
  27677.    </P
  27678. ><DIV
  27679. CLASS="warning"
  27680. ><P
  27681. ></P
  27682. ><TABLE
  27683. CLASS="warning"
  27684. BORDER="1"
  27685. WIDTH="100%"
  27686. ><TR
  27687. ><TD
  27688. ALIGN="CENTER"
  27689. ><B
  27690. >Warnung</B
  27691. ></TD
  27692. ></TR
  27693. ><TR
  27694. ><TD
  27695. ALIGN="LEFT"
  27696. ><P
  27697. >      Funktionen, die durch <VAR
  27698. CLASS="literal"
  27699. >old_function</VAR
  27700. > definiert
  27701.      werden, k÷nnen nicht von PHP selbst aufgerufen werden. Das hei▀t
  27702.      unter anderem, dass sie nicht in Funktionen wie <B
  27703. CLASS="function"
  27704. >usort
  27705.      ()</B
  27706. >, <A
  27707. HREF="#function.array-walk"
  27708. ><B
  27709. CLASS="function"
  27710. >array_walk()</B
  27711. ></A
  27712. > und <B
  27713. CLASS="function"
  27714. >      register_shutdown_function()</B
  27715. > benutzt werden k÷nnen.
  27716.      Dieses Manko k÷nnen Sie umgehen, indem Sie eine Adapterfunktion
  27717.      (in normalem PHP3) schreiben, welche die
  27718.      <VAR
  27719. CLASS="literal"
  27720. >old_function</VAR
  27721. > aufruft.
  27722.     </P
  27723. ></TD
  27724. ></TR
  27725. ></TABLE
  27726. ></DIV
  27727. ></DIV
  27728. ><DIV
  27729. CLASS="sect1"
  27730. ><HR><H2
  27731. CLASS="sect1"
  27732. ><A
  27733. NAME="functions.variable-functions"
  27734. >Variablenfunktionen</A
  27735. ></H2
  27736. ><P
  27737. >     PHP unterstⁿtzt das Konzept der Variablenfunktionen. Wenn Sie an
  27738.     das Ende einer Variablen Klammern hΣngen, versucht PHP eine
  27739.     Funktion aufzurufen, deren Name der aktuelle Wert der Variable
  27740.     ist. Dies kann unter anderem fⁿr Callbacks, Funktionstabellen,
  27741.     usw. genutzt werden.
  27742.    </P
  27743. ><P
  27744. >     Variablenfunktionen funktionieren nicht mit Sprachkonstrukten
  27745.     wie <A
  27746. HREF="#function.echo"
  27747. ><B
  27748. CLASS="function"
  27749. >echo()</B
  27750. ></A
  27751. >, <A
  27752. HREF="#function.print"
  27753. ><B
  27754. CLASS="function"
  27755. >print()</B
  27756. ></A
  27757. >,
  27758.     <A
  27759. HREF="#function.unset"
  27760. ><B
  27761. CLASS="function"
  27762. >unset()</B
  27763. ></A
  27764. >, <A
  27765. HREF="#function.isset"
  27766. ><B
  27767. CLASS="function"
  27768. >isset()</B
  27769. ></A
  27770. >,
  27771.     <A
  27772. HREF="#function.empty"
  27773. ><B
  27774. CLASS="function"
  27775. >empty()</B
  27776. ></A
  27777. >, <A
  27778. HREF="#function.include"
  27779. ><B
  27780. CLASS="function"
  27781. >include()</B
  27782. ></A
  27783. > und
  27784.     <A
  27785. HREF="#function.require"
  27786. ><B
  27787. CLASS="function"
  27788. >require()</B
  27789. ></A
  27790. >. Sie mⁿssen Ihre eigenen Wrapperfunktionen
  27791.     verwenden, um diese Konstrukte als variable Funktionen benutzen zu
  27792.     k÷nnen.
  27793.    </P
  27794. ><P
  27795. >     <TABLE
  27796. WIDTH="100%"
  27797. BORDER="0"
  27798. CELLPADDING="0"
  27799. CELLSPACING="0"
  27800. CLASS="EXAMPLE"
  27801. ><TR
  27802. ><TD
  27803. ><DIV
  27804. CLASS="example"
  27805. ><A
  27806. NAME="AEN4940"
  27807. ></A
  27808. ><P
  27809. ><B
  27810. >Beispiel 16-3. Beispiel fⁿr Variablenfunktionen</B
  27811. ></P
  27812. ><TABLE
  27813. BORDER="0"
  27814. BGCOLOR="#E0E0E0"
  27815. CELLPADDING="5"
  27816. ><TR
  27817. ><TD
  27818. ><PRE
  27819. CLASS="php"
  27820. ><?php
  27821. function foo()
  27822. {
  27823.     echo "In foo()<br>\n";
  27824. }
  27825.  
  27826. function bar($arg = '')
  27827. {
  27828.     echo "In bar(); der Parameter ist '$arg'.<br>\n";
  27829. }
  27830.  
  27831. // Dies ist eine Wrapperfunkiton fⁿr echo
  27832. function echoit($string)
  27833. {
  27834.     echo $string;
  27835. }
  27836.  
  27837. $func = 'foo';
  27838. $func();        // Dies ruft foo() auf
  27839.  
  27840. $func = 'bar';
  27841. $func('test');  // Dies ruft bar() auf
  27842.  
  27843. $func = 'echoit';
  27844. $func('test');  // Dies ruft echoit() auf
  27845. ?></PRE
  27846. ></TD
  27847. ></TR
  27848. ></TABLE
  27849. ></DIV
  27850. ></TD
  27851. ></TR
  27852. ></TABLE
  27853. >
  27854.    </P
  27855. ><P
  27856. >     Sie k÷nnen auch die Methode eines Objektes mittels der variablen
  27857.     Funktionen aufrufen.
  27858.     <TABLE
  27859. WIDTH="100%"
  27860. BORDER="0"
  27861. CELLPADDING="0"
  27862. CELLSPACING="0"
  27863. CLASS="EXAMPLE"
  27864. ><TR
  27865. ><TD
  27866. ><DIV
  27867. CLASS="example"
  27868. ><A
  27869. NAME="AEN4944"
  27870. ></A
  27871. ><P
  27872. ><B
  27873. >Beispiel 16-4. Variable Methode</B
  27874. ></P
  27875. ><TABLE
  27876. BORDER="0"
  27877. BGCOLOR="#E0E0E0"
  27878. CELLPADDING="5"
  27879. ><TR
  27880. ><TD
  27881. ><PRE
  27882. CLASS="php"
  27883. ><?php
  27884. class Foo
  27885. {
  27886.     function Var()
  27887.     {
  27888.         $name = 'Bar';
  27889.         $this->$name(); // Dies ruft die Bar() Methode auf
  27890.     }
  27891.     
  27892.     function Bar()
  27893.     {
  27894.         echo "Das ist Bar";
  27895.     }
  27896. }
  27897.  
  27898. $foo = new Foo();
  27899. $funcname = "Var";
  27900. $foo->$funcname();   // Dies ruft $foo->Var() auf
  27901.  
  27902. ?></PRE
  27903. ></TD
  27904. ></TR
  27905. ></TABLE
  27906. ></DIV
  27907. ></TD
  27908. ></TR
  27909. ></TABLE
  27910. >
  27911.    </P
  27912. ><P
  27913. >     Siehe auch <A
  27914. HREF="#function.call-user-func"
  27915. ><B
  27916. CLASS="function"
  27917. >call_user_func()</B
  27918. ></A
  27919. >,
  27920.     <A
  27921. HREF="#language.variables.variable"
  27922. >     Variable Variablen</A
  27923. > und <A
  27924. HREF="#function.function-exists"
  27925. ><B
  27926. CLASS="function"
  27927. >function_exists()</B
  27928. ></A
  27929. >.
  27930.    </P
  27931. ></DIV
  27932. ></DIV
  27933. ><DIV
  27934. CLASS="chapter"
  27935. ><HR><H1
  27936. ><A
  27937. NAME="language.oop"
  27938. >Kapitel 17. Klassen und Objekte</A
  27939. ></H1
  27940. ><DIV
  27941. CLASS="sect1"
  27942. ><H2
  27943. CLASS="sect1"
  27944. ><A
  27945. NAME="keyword.class"
  27946. ><VAR
  27947. CLASS="literal"
  27948. >Klassen</VAR
  27949. ></A
  27950. ></H2
  27951. ><P
  27952. >     Eine Klasse ist eine Sammlung von Variablen und Funktionen, die
  27953.     mit diesen Variablen arbeiten. Eine Klasse wird folgenderma▀en
  27954.     definiert:
  27955.     <DIV
  27956. CLASS="informalexample"
  27957. ><P
  27958. ></P
  27959. ><A
  27960. NAME="AEN4957"
  27961. ></A
  27962. ><TABLE
  27963. BORDER="0"
  27964. BGCOLOR="#E0E0E0"
  27965. CELLPADDING="5"
  27966. ><TR
  27967. ><TD
  27968. ><PRE
  27969. CLASS="php"
  27970. ><?php
  27971. class Cart
  27972. {
  27973.     var $items;  // Artikel in unserem Einkaufswagen
  27974.    
  27975.     // Fⁿge dem Einkaufswagen $num Artikel der Sorte $artnr zu
  27976.  
  27977.     function add_item ($artnr, $num)
  27978.     {
  27979.         $this->items[$artnr] += $num;
  27980.     }
  27981.    
  27982.     // Nimm $num Artikel von $artnr aus dem Einkaufswagen
  27983.  
  27984.     function remove_item ($artnr, $num)
  27985.     {
  27986.         if ($this->items[$artnr] > $num) {
  27987.             $this->items[$artnr] -= $num;
  27988.             return true;
  27989.         } else {
  27990.             return false;
  27991.         }   
  27992.     }
  27993. }
  27994. ?></PRE
  27995. ></TD
  27996. ></TR
  27997. ></TABLE
  27998. ><P
  27999. ></P
  28000. ></DIV
  28001. >
  28002.    </P
  28003. ><P
  28004. >     In diesem Beispiel wird eine Klasse "Cart" definiert. Sie
  28005.     besteht aus einem assoziativen Array von Produkten im
  28006.     Einkaufswagen und zwei Funktionen zum Hinzufⁿgen und Entfernen von
  28007.     Artikeln.
  28008.    </P
  28009. ><DIV
  28010. CLASS="caution"
  28011. ><P
  28012. ></P
  28013. ><TABLE
  28014. CLASS="caution"
  28015. BORDER="1"
  28016. WIDTH="100%"
  28017. ><TR
  28018. ><TD
  28019. ALIGN="CENTER"
  28020. ><B
  28021. >Achtung</B
  28022. ></TD
  28023. ></TR
  28024. ><TR
  28025. ><TD
  28026. ALIGN="LEFT"
  28027. ><P
  28028. >      Die folgenden warnenden Bemerkungen gelten fⁿr PHP 4.
  28029.     </P
  28030. ><P
  28031. >      Der Name <VAR
  28032. CLASS="literal"
  28033. >stdClass</VAR
  28034. > ist reserviert, da er intern
  28035.      von Zend benutzt wird. Sie k÷nnen in PHP keine Klasse mit dem
  28036.      Namen <VAR
  28037. CLASS="literal"
  28038. >stdClass</VAR
  28039. > haben.
  28040.     </P
  28041. ><P
  28042. >       Die Funktionsnamen <VAR
  28043. CLASS="literal"
  28044. >__sleep</VAR
  28045. > und
  28046.       <VAR
  28047. CLASS="literal"
  28048. >__wakeup</VAR
  28049. > sind in PHP Klassen "magisch". Sie
  28050.       k÷nnen in Ihren Klassen keine Funktionen mit diesen Namen haben,
  28051.       au▀er Sie wollen sie mit dieser "magischen" FunktionalitΣt
  28052.       assoziieren. Mehr Informationen dazu finden Sie weiter unten.
  28053.     </P
  28054. ><P
  28055. >       SΣmtliche mit __ beginnende Funktionsnamen sind PHP als "magisch"
  28056.       vorbehalten. Es wird empfohlen, in PHP keine Funktionsnamen mit
  28057.       __ zu verwenden, au▀er Sie m÷chten dokumentierte "magische"
  28058.       FunktionalitΣt.
  28059.     </P
  28060. ></TD
  28061. ></TR
  28062. ></TABLE
  28063. ></DIV
  28064. ><DIV
  28065. CLASS="note"
  28066. ><BLOCKQUOTE
  28067. CLASS="note"
  28068. ><P
  28069. ><B
  28070. >Anmerkung: </B
  28071. >
  28072.      In PHP 4 sind nur konstante Initialisierungen fⁿr
  28073.      <VAR
  28074. CLASS="literal"
  28075. >var</VAR
  28076. > Variablen erlaubt. Um Variablen mit nicht
  28077.      konstanten Werten zu initialisieren, ben÷tigen Sie eine Funktion
  28078.      zur Initialisierung, welche beim Erstellen eines Objektes
  28079.      automatisch von der Klasse aufgerufen wird. Eine solche Funktion
  28080.      wird Konstruktor genannt (siehe unten).
  28081.     </P
  28082. ><DIV
  28083. CLASS="informalexample"
  28084. ><P
  28085. ></P
  28086. ><A
  28087. NAME="AEN4972"
  28088. ></A
  28089. ><TABLE
  28090. BORDER="0"
  28091. BGCOLOR="#E0E0E0"
  28092. CELLPADDING="5"
  28093. ><TR
  28094. ><TD
  28095. ><PRE
  28096. CLASS="php"
  28097. ><?php
  28098. /* Keine wird in PHP 4 funktionieren */
  28099. class Cart
  28100. {
  28101.     var $todays_date = date("Y-m-d");
  28102.     var $name = $firstname;
  28103.     var $owner = 'Fred ' . 'Jones';
  28104.     var $items = array("VCR", "TV");
  28105. }
  28106.  
  28107. /* So sollte es gemacht werden */
  28108. class Cart
  28109. {
  28110.     var $todays_date;
  28111.     var $name;
  28112.     var $owner;
  28113.     var $items;
  28114.  
  28115.     function Cart()
  28116.     {
  28117.         $this->todays_date = date("Y-m-d");
  28118.         $this->name = $GLOBALS['firstname'];
  28119.         /* etc. . . */
  28120.     }
  28121. }
  28122. ?></PRE
  28123. ></TD
  28124. ></TR
  28125. ></TABLE
  28126. ><P
  28127. ></P
  28128. ></DIV
  28129. ></BLOCKQUOTE
  28130. ></DIV
  28131. ><P
  28132. >     Klassen sind Typen, das hei▀t sie sind die Blaupausen fⁿr reale
  28133.     Variablen. Um sie zu nutzen, muss zunΣchst eine Variable mit dem
  28134.     Operator <VAR
  28135. CLASS="literal"
  28136. >new</VAR
  28137. > angelegt werden.
  28138.    </P
  28139. ><DIV
  28140. CLASS="informalexample"
  28141. ><P
  28142. ></P
  28143. ><A
  28144. NAME="AEN4976"
  28145. ></A
  28146. ><TABLE
  28147. BORDER="0"
  28148. BGCOLOR="#E0E0E0"
  28149. CELLPADDING="5"
  28150. ><TR
  28151. ><TD
  28152. ><PRE
  28153. CLASS="php"
  28154. ><?php
  28155. $cart = new Cart;
  28156. $cart->add_item("10", 1);
  28157.  
  28158. $another_cart = new Cart;
  28159. $another_cart->add_item("0815", 3);</PRE
  28160. ></TD
  28161. ></TR
  28162. ></TABLE
  28163. ><P
  28164. ></P
  28165. ></DIV
  28166. ><P
  28167. >     Dies erstellt die Objekte $cart und $another_cart aus der Klasse
  28168.     Cart. Dann wird die Funktion add_item() des $cart Objektes
  28169.     aufgerufen, um $cart einen Artikel mit der Artikelnummer 10
  28170.     hinzuzufⁿgen. 3 Artikel mit der Artikelnummer 0815 werden
  28171.     $another_cart hinzugefⁿgt.
  28172.    </P
  28173. ><P
  28174. >     Sowohl $cart als auch $another_cart haben die Funktionen
  28175.     add_item(), remove_item() und die Variable items. Dies sind
  28176.     verschiedene Funktionen und Variablen. Sie k÷nnen sich Objekte
  28177.     Σhnlich den Verzeichnissen in einem Dateisystem vorstellen. Sie
  28178.     k÷nnen in einem Dateisystem zwei verschiedene Dateien README.TXT
  28179.     haben, solange sie sich in verschiedenen Verzeichnissen befinden.
  28180.     So wie Sie in Verzeichnissen den vollen Pfadnamen eingeben mⁿssen,
  28181.     um jede Datei von dem obersten Verzeichnis aus zu erreichen, mⁿssen
  28182.     Sie auch den vollen Namen der aufzurufenden Funktion angeben: Das
  28183.     hei▀t fⁿr PHP, dass das Hauptverzeichnis der globale Namensbereich,
  28184.     und der Separator des Pfadnamens -> wΣre. Deshalb benennen die
  28185.     Namen $cart->items und $another_cart->items auch zwei
  28186.     verschiedene Variablen. Beachten Sie, dass die Variable
  28187.     $cart->items, und nicht $cart->$items genannt wird, da
  28188.     ein Variablenname in PHP nur ein einziges Dollarzeichen hat.
  28189.    </P
  28190. ><DIV
  28191. CLASS="informalexample"
  28192. ><P
  28193. ></P
  28194. ><A
  28195. NAME="AEN4980"
  28196. ></A
  28197. ><TABLE
  28198. BORDER="0"
  28199. BGCOLOR="#E0E0E0"
  28200. CELLPADDING="5"
  28201. ><TR
  28202. ><TD
  28203. ><PRE
  28204. CLASS="php"
  28205. >// korrekt, einfaches $
  28206. $cart->items = array("10" => 1); 
  28207.  
  28208. // falsch, denn $cart->$items wird zu $cart->""
  28209. $cart->$items = array("10" => 1);
  28210.  
  28211. // richtig aber fraglich, ob dies erwⁿnscht war:
  28212. // $cart->$myvar wird zu $cart->items
  28213. $myvar = 'items';
  28214. $cart->$myvar = array("10" => 1);</PRE
  28215. ></TD
  28216. ></TR
  28217. ></TABLE
  28218. ><P
  28219. ></P
  28220. ></DIV
  28221. ><P
  28222. >     Innerhalb einer Klassendefinition ist nicht bekannt, unter welchem
  28223.     Namen das Objekt in Ihrem Programm erreichbar sein wird: Als die
  28224.     Klasse Cart geschrieben wurde war nicht bekannt, dass das Objekt
  28225.     spΣter $cart oder $another_cart genannt wird. Deshalb k÷nnen Sie
  28226.     innerhalb der Klasse Cart selbst auch nicht $cart->items schreiben.
  28227.     Um nun die eigenen Funktionen und Variablen innerhalb einer Klasse
  28228.     anzusprechen, k÷nnen Sie die Pseudo-Variable $this verwenden, welche
  28229.     Sie auch als 'meine eigene' oder 'aktuelles Objekt' verstehen k÷nnen.
  28230.     Deshalb kann '$this->items[$artnr] += $num' auch als 'addiere $num
  28231.     zu $artnr in meinem eigenen Array items', oder 'addiere $num zu
  28232.     $artnr im Array items innerhalb des aktuellen Objektes' lesen.
  28233.    </P
  28234. ><DIV
  28235. CLASS="note"
  28236. ><BLOCKQUOTE
  28237. CLASS="note"
  28238. ><P
  28239. ><B
  28240. >Anmerkung: </B
  28241. >
  28242.     Es gibt ein paar angenehme Funktionen, um mit Klassen und Objekten umzugehen.
  28243.     Mehr darⁿber erfahren Sie im Kapitel <A
  28244. HREF="#ref.classobj"
  28245. >Klassen- 
  28246.     und Objekt-Funktionen</A
  28247. >.
  28248.     </P
  28249. ></BLOCKQUOTE
  28250. ></DIV
  28251. ></DIV
  28252. ><DIV
  28253. CLASS="sect1"
  28254. ><HR><H2
  28255. CLASS="sect1"
  28256. ><A
  28257. NAME="keyword.extends"
  28258. ><VAR
  28259. CLASS="literal"
  28260. >extends</VAR
  28261. ></A
  28262. ></H2
  28263. ><P
  28264. >     Oft braucht man Klassen mit in einer anderen Klasse Σhnlichen Variablen
  28265.     und Funktionen. So ist es eine gute Vorgehensweise, eine in allen Ihren
  28266.     Projekten verwendbare Oberklasse zu definieren, und diese dann den
  28267.     Bedⁿrfnissen Ihrer einzelnen Projekte anzupassen. Um dies zu erleichtern,
  28268.     k÷nnen Klassen andere Klassen erweitern. Die erweiterte bzw. abgeleitete
  28269.     Klasse verfⁿgt ⁿber alle Variablen und Funktionen der Basisklasse (dies
  28270.     wird 'Vererbung' genannt, obwohl niemand gestorben ist), und was Sie in
  28271.     der erweiterten Definition hinzufⁿgen. Es ist nicht m÷glich, etwas von
  28272.     einer Klasse wegzunehmen, d.h. Sie k÷nnen keine existierenden Variablen
  28273.     oder Funktionen 'wegdefinieren'. Eine Unterklasse ist immer von einer
  28274.     einzigen Oberklasse abhΣngig, d.h. Mehrfachvererbung wird nicht
  28275.     unterstⁿtzt. Klassen werden mittels dem Schlⁿsselwort 'extends' erweitert.
  28276.    </P
  28277. ><DIV
  28278. CLASS="informalexample"
  28279. ><P
  28280. ></P
  28281. ><A
  28282. NAME="AEN4990"
  28283. ></A
  28284. ><TABLE
  28285. BORDER="0"
  28286. BGCOLOR="#E0E0E0"
  28287. CELLPADDING="5"
  28288. ><TR
  28289. ><TD
  28290. ><PRE
  28291. CLASS="php"
  28292. >class Named_Cart extends Cart
  28293. {
  28294.     var $owner;
  28295.   
  28296.     function set_owner ($name)
  28297.     {
  28298.         $this->owner = $name;
  28299.     }
  28300. }</PRE
  28301. ></TD
  28302. ></TR
  28303. ></TABLE
  28304. ><P
  28305. ></P
  28306. ></DIV
  28307. ><P
  28308. >     Hier wird die Klasse Named_Cart definiert, die ⁿber alle Variablen
  28309.     und Funktionen von Cart, plus der Variable $owner und der Funktion
  28310.     set_owner() verfⁿgt. Sie k÷nnen einen bestimmten Einkaufswagen
  28311.     (Named_Cart) auf dem ⁿblichen Weg erstellen, und nun auch den
  28312.     Besitzer (owner) bestimmen und erfragen. Sie k÷nnen noch immer
  28313.     die normalen Cart Funktionen an Named_Cart anwenden:
  28314.    </P
  28315. ><DIV
  28316. CLASS="informalexample"
  28317. ><P
  28318. ></P
  28319. ><A
  28320. NAME="AEN4993"
  28321. ></A
  28322. ><TABLE
  28323. BORDER="0"
  28324. BGCOLOR="#E0E0E0"
  28325. CELLPADDING="5"
  28326. ><TR
  28327. ><TD
  28328. ><PRE
  28329. CLASS="php"
  28330. >$ncart = new Named_Cart;    // Erstellt einen bestimmten Einkaufwagen
  28331. $ncart->set_owner("kris");  // den Besitzer festlegen
  28332. print $ncart->owner;        // den Besitzer ausgeben
  28333. $ncart->add_item("10", 1);  // (vererbte FunktionalitΣt von Cart)</PRE
  28334. ></TD
  28335. ></TR
  28336. ></TABLE
  28337. ><P
  28338. ></P
  28339. ></DIV
  28340. ><P
  28341. >     Dies wird auch eine "Eltern-Kind" Beziehung genannt. Sie erstellen eine
  28342.     Klasse ("Eltern"), und erstellen mittels <VAR
  28343. CLASS="literal"
  28344. >extends</VAR
  28345. > eine
  28346.     neue Klasse, die auf der "Eltern"-Klasse <SPAN
  28347. CLASS="emphasis"
  28348. ><I
  28349. CLASS="emphasis"
  28350. >basiert</I
  28351. ></SPAN
  28352. >:
  28353.     die "Kind"-Klasse. Sie k÷nnen auch diese neue Unterklasse verwenden und
  28354.     eine neue, auf dieser Klasse basierenden Klasse erstellen.
  28355.    </P
  28356. ><DIV
  28357. CLASS="note"
  28358. ><BLOCKQUOTE
  28359. CLASS="note"
  28360. ><P
  28361. ><B
  28362. >Anmerkung: </B
  28363. >
  28364.      Bevor Sie Klassen verwenden k÷nnen, mⁿssen Sie diese definieren. Wenn
  28365.      Sie wollen, dass <VAR
  28366. CLASS="literal"
  28367. >Named_Cart</VAR
  28368. > die Klasse
  28369.      <VAR
  28370. CLASS="literal"
  28371. >Cart</VAR
  28372. > erweitert, mⁿssen Sie <VAR
  28373. CLASS="literal"
  28374. >Cart</VAR
  28375. >
  28376.      erst definieren. Wenn Sie eine andere Klasse, z.B.
  28377.      <VAR
  28378. CLASS="literal"
  28379. >Yellow_named_cart</VAR
  28380. > erstellen wollen, welche
  28381.      auf <VAR
  28382. CLASS="literal"
  28383. >Named_Cart</VAR
  28384. > basiert, mⁿssen Sie zuerst 
  28385.      <VAR
  28386. CLASS="literal"
  28387. >Named_Cart</VAR
  28388. > definieren. Kurz gesagt ist die
  28389.      Reihenfolge, in der die Klassen definiert werden, sehr wichtig.
  28390.     </P
  28391. ></BLOCKQUOTE
  28392. ></DIV
  28393. ></DIV
  28394. ><DIV
  28395. CLASS="sect1"
  28396. ><HR><H2
  28397. CLASS="sect1"
  28398. ><A
  28399. NAME="language.oop.constructor"
  28400. ><VAR
  28401. CLASS="literal"
  28402. >Konstruktoren</VAR
  28403. ></A
  28404. ></H2
  28405. ><DIV
  28406. CLASS="caution"
  28407. ><P
  28408. ></P
  28409. ><TABLE
  28410. CLASS="caution"
  28411. BORDER="1"
  28412. WIDTH="100%"
  28413. ><TR
  28414. ><TD
  28415. ALIGN="CENTER"
  28416. ><B
  28417. >Achtung</B
  28418. ></TD
  28419. ></TR
  28420. ><TR
  28421. ><TD
  28422. ALIGN="LEFT"
  28423. ><P
  28424. >      In PHP 3 und PHP 4 verhalten sich die Konstruktoren
  28425.      unterschiedlich. Die PHP 4 Semantik wird dringend empfohlen.
  28426.     </P
  28427. ></TD
  28428. ></TR
  28429. ></TABLE
  28430. ></DIV
  28431. ><P
  28432. >     Konstruktoren sind Funktionen innerhalb einer Klasse, die
  28433.     automatisch aufgerufen wird, sobald Sie mittels
  28434.     <VAR
  28435. CLASS="literal"
  28436. >new</VAR
  28437. > eine neue Instanz erstellen. In PHP 3
  28438.     wird eine Funktion zum Konstruktor, wenn sie den gleichen Namen
  28439.     wie die Klasse hat. In PHP 4 wird eine Funktion zum Konstruktor,
  28440.     wenn sie den gleichen Namen wie die Klasse hat, in der sie
  28441.     definiert ist. Der Unterschied ist subtil, aber entscheidend
  28442.     (siehe unten).
  28443.    </P
  28444. ><DIV
  28445. CLASS="informalexample"
  28446. ><P
  28447. ></P
  28448. ><A
  28449. NAME="AEN5013"
  28450. ></A
  28451. ><TABLE
  28452. BORDER="0"
  28453. BGCOLOR="#E0E0E0"
  28454. CELLPADDING="5"
  28455. ><TR
  28456. ><TD
  28457. ><PRE
  28458. CLASS="php"
  28459. >// Funktioniert sowohl in PHP 3, als auch in PHP 4.
  28460. class Auto_Cart extends Cart
  28461. {
  28462.     function Auto_Cart()
  28463.     {
  28464.         $this->add_item ("10", 1);
  28465.     }
  28466. }</PRE
  28467. ></TD
  28468. ></TR
  28469. ></TABLE
  28470. ><P
  28471. ></P
  28472. ></DIV
  28473. ><P
  28474. >     Die Klasse Auto_Cart entspricht der Klasse Cart und hat einen
  28475.     Konstruktor, der Cart bereits mit einem Artikel der Nummer "10"
  28476.     initialisiert, sobald ein neuer Auto_Cart mittels "new" erstellt
  28477.     wird. Konstruktoren k÷nnen Argumente ⁿbernehmen, die optional
  28478.     sein k÷nnen, was sie sehr praktisch macht. Um eine Klasse auch
  28479.     ohne Parameter verwenden zu k÷nnen, sollten alle Parameter fⁿr
  28480.     Konstruktoren optional sein, indem sie mit Standardwerten
  28481.     ausgestattet werden.
  28482.    </P
  28483. ><DIV
  28484. CLASS="informalexample"
  28485. ><P
  28486. ></P
  28487. ><A
  28488. NAME="AEN5016"
  28489. ></A
  28490. ><TABLE
  28491. BORDER="0"
  28492. BGCOLOR="#E0E0E0"
  28493. CELLPADDING="5"
  28494. ><TR
  28495. ><TD
  28496. ><PRE
  28497. CLASS="php"
  28498. >// Funktioniert sowohl in PHP 3, als auch in PHP 4.
  28499. class Constructor_Cart extends Cart
  28500. {
  28501.     function Constructor_Cart($item = "10", $num = 1)
  28502.     {
  28503.         $this->add_item ($item, $num);
  28504.     }
  28505. }
  28506.  
  28507. // Kaufe das gleiche alte Zeug ein.
  28508.  
  28509. $default_cart = new Constructor_Cart;
  28510.  
  28511. // Kaufe etwas anderes...
  28512.  
  28513. $different_cart = new Constructor_Cart("20", 17);</PRE
  28514. ></TD
  28515. ></TR
  28516. ></TABLE
  28517. ><P
  28518. ></P
  28519. ></DIV
  28520. ><P
  28521. >     Sie k÷nnen auch den Operator <VAR
  28522. CLASS="literal"
  28523. >@</VAR
  28524. > verwenden, um
  28525.     Fehlermeldungen innerhalb des Konstruktors zu unterdrⁿcken, z.B.
  28526.     <VAR
  28527. CLASS="literal"
  28528. >@new</VAR
  28529. >.
  28530.    </P
  28531. ><DIV
  28532. CLASS="caution"
  28533. ><P
  28534. ></P
  28535. ><TABLE
  28536. CLASS="caution"
  28537. BORDER="1"
  28538. WIDTH="100%"
  28539. ><TR
  28540. ><TD
  28541. ALIGN="CENTER"
  28542. ><B
  28543. >Achtung</B
  28544. ></TD
  28545. ></TR
  28546. ><TR
  28547. ><TD
  28548. ALIGN="LEFT"
  28549. ><P
  28550. >      In PHP 3 haben abgeleitete Klassen und Konstruktoren ein paar
  28551.      EinschrΣnkungen. Sie sollten das folgende Beispiel sorgfΣltig
  28552.      lesen, um diese EinschrΣnkungen zu verstehen.
  28553.     </P
  28554. ></TD
  28555. ></TR
  28556. ></TABLE
  28557. ></DIV
  28558. ><DIV
  28559. CLASS="informalexample"
  28560. ><P
  28561. ></P
  28562. ><A
  28563. NAME="AEN5023"
  28564. ></A
  28565. ><TABLE
  28566. BORDER="0"
  28567. BGCOLOR="#E0E0E0"
  28568. CELLPADDING="5"
  28569. ><TR
  28570. ><TD
  28571. ><PRE
  28572. CLASS="php"
  28573. >class A
  28574. {
  28575.     function A()
  28576.     {
  28577.       echo "I am the constructor of A.<br>\n";
  28578.     }
  28579. }
  28580.  
  28581. class B extends A
  28582. {
  28583.     function C()
  28584.     {
  28585.         echo "I am a regular function.<br>\n";
  28586.     }
  28587. }
  28588.  
  28589. // In PHP 3 wurde kein Konstruktor aufgerufen.
  28590. $b = new B;</PRE
  28591. ></TD
  28592. ></TR
  28593. ></TABLE
  28594. ><P
  28595. ></P
  28596. ></DIV
  28597. ><P
  28598. >     In PHP 3 wird bei dem obigen Beispiel kein Konstruktor aufgerufen.
  28599.     Die Regel in PHP 3 besagt: 'Ein Konstruktor ist eine Funktion mit
  28600.     dem selben Namen wie die Klasse'. Der Name der Klasse ist B, und
  28601.     nachdem in Klasse B keine Funktion namens B() existiert, passiert
  28602.     nichts.
  28603.    </P
  28604. ><P
  28605. >     Dies ist in PHP 4 mit der Einfⁿhrung einer anderen Regel behoben:
  28606.     Wenn eine Klasse keinen Konstruktor hat, wird der Konstruktor der
  28607.     Basisklasse aufgerufen, so dieser existiert. Das obige Beispiel
  28608.     hΣtte in PHP 4 also 'I am the constructor of A.<br>' ausgegeben.
  28609.    </P
  28610. ><DIV
  28611. CLASS="informalexample"
  28612. ><P
  28613. ></P
  28614. ><A
  28615. NAME="AEN5027"
  28616. ></A
  28617. ><TABLE
  28618. BORDER="0"
  28619. BGCOLOR="#E0E0E0"
  28620. CELLPADDING="5"
  28621. ><TR
  28622. ><TD
  28623. ><PRE
  28624. CLASS="php"
  28625. >class A
  28626. {
  28627.     function A()
  28628.     {
  28629.         echo "I am the constructor of A.<br>\n";
  28630.     }
  28631.  
  28632.     function B()
  28633.     {
  28634.         echo "I am a regular function named B in class A.<br>\n";
  28635.         echo "I am not a constructor in A.<br>\n";
  28636.     }
  28637. }
  28638.  
  28639. class B extends A
  28640. {
  28641.     function C()
  28642.     {
  28643.         echo "I am a regular function.<br>\n";
  28644.     }
  28645. }
  28646.  
  28647. // Dies ruft B() als Konstruktor auf.
  28648. $b = new B;</PRE
  28649. ></TD
  28650. ></TR
  28651. ></TABLE
  28652. ><P
  28653. ></P
  28654. ></DIV
  28655. ><P
  28656. >     In PHP 3 wird die Funktion B() in der Klasse A pl÷tzlich zum
  28657.     Konstruktor in Klasse B, auch wenn dies nie beabsichtigt war.
  28658.     Die Regel in PHP 3 lautet: 'Ein Konstruktor ist eine Funktion
  28659.     mit dem gleichen Namen wie die Klasse'. PHP 3 kⁿmmert sich nicht
  28660.     darum, ob die Funktion in Klasse B definiert, oder ob sie nur
  28661.     vererbt wurde.
  28662.    </P
  28663. ><P
  28664. >     Dies ist in PHP 4 mit einer modifizierten Regel behoben: 'Ein
  28665.     Konstruktor ist eine Funktion mit dem selben Namen wie die Klasse,
  28666.     in der sie definiert wurde'. So hΣtte die Klasse B in dem obigen
  28667.     Beispiel keinen eigenen Konstruktor, und wⁿrde der Konstruktor
  28668.     der Basisklasse aufgerufen, welcher 'I am the constructor of
  28669.     A.<br>' ausgeben wⁿrde.
  28670.    </P
  28671. ><DIV
  28672. CLASS="caution"
  28673. ><P
  28674. ></P
  28675. ><TABLE
  28676. CLASS="caution"
  28677. BORDER="1"
  28678. WIDTH="100%"
  28679. ><TR
  28680. ><TD
  28681. ALIGN="CENTER"
  28682. ><B
  28683. >Achtung</B
  28684. ></TD
  28685. ></TR
  28686. ><TR
  28687. ><TD
  28688. ALIGN="LEFT"
  28689. ><P
  28690. >      Weder PHP 3, noch PHP 4 rufen vom Konstruktor der abgeleiteten
  28691.      Klasse aus automatisch Konstruktoren der Basisklasse auf. Wenn
  28692.      angebracht, ist der Aufruf von Konstruktoren aufwΣrts Ihre
  28693.      Aufgabe.
  28694.     </P
  28695. ></TD
  28696. ></TR
  28697. ></TABLE
  28698. ></DIV
  28699. ><DIV
  28700. CLASS="note"
  28701. ><BLOCKQUOTE
  28702. CLASS="note"
  28703. ><P
  28704. ><B
  28705. >Anmerkung: </B
  28706. >
  28707.      In PHP 3 und PHP 4 gibt es keine Destruktoren. Stattdessen k÷nnen
  28708.      Sie <A
  28709. HREF="#function.register-shutdown-function"
  28710. ><B
  28711. CLASS="function"
  28712. >register_shutdown_function()</B
  28713. ></A
  28714. > verwenden, um
  28715.      die meisten Effekte von Destruktoren zu simulieren.
  28716.     </P
  28717. ></BLOCKQUOTE
  28718. ></DIV
  28719. ><P
  28720. >     Destruktoren sind Funktionen die automatisch aufgerufen werden, wenn
  28721.     ein Objekt entweder mittels <A
  28722. HREF="#function.unset"
  28723. ><B
  28724. CLASS="function"
  28725. >unset()</B
  28726. ></A
  28727. >, oder durch
  28728.     Verlassen des Gⁿltigkeitsbereiches zerst÷rt wird. Es gibt in PHP
  28729.     keine Destruktoren.
  28730.    </P
  28731. ></DIV
  28732. ><DIV
  28733. CLASS="sect1"
  28734. ><HR><H2
  28735. CLASS="sect1"
  28736. ><A
  28737. NAME="keyword.paamayim-nekudotayim"
  28738. ><VAR
  28739. CLASS="literal"
  28740. >::</VAR
  28741. ></A
  28742. ></H2
  28743. ><DIV
  28744. CLASS="caution"
  28745. ><P
  28746. ></P
  28747. ><TABLE
  28748. CLASS="caution"
  28749. BORDER="1"
  28750. WIDTH="100%"
  28751. ><TR
  28752. ><TD
  28753. ALIGN="CENTER"
  28754. ><B
  28755. >Achtung</B
  28756. ></TD
  28757. ></TR
  28758. ><TR
  28759. ><TD
  28760. ALIGN="LEFT"
  28761. ><P
  28762. >      Die folgende Beschreibung ist nur fⁿr PHP 4 gⁿltig.
  28763.     </P
  28764. ></TD
  28765. ></TR
  28766. ></TABLE
  28767. ></DIV
  28768. ><P
  28769. >     Manchmal ist es hilfreich, auf Funktionen in Basisklassen bzw.
  28770.     auf Funktionen in Klassen zuzugreifen, die noch keine Instanzen
  28771.     haben. Dafⁿr wird der :: Operator verwendet. 
  28772.    </P
  28773. ><DIV
  28774. CLASS="informalexample"
  28775. ><P
  28776. ></P
  28777. ><A
  28778. NAME="AEN5044"
  28779. ></A
  28780. ><TABLE
  28781. BORDER="0"
  28782. BGCOLOR="#E0E0E0"
  28783. CELLPADDING="5"
  28784. ><TR
  28785. ><TD
  28786. ><PRE
  28787. CLASS="php"
  28788. >class A
  28789. {
  28790.     function example()
  28791.     {
  28792.         echo "I am the original function A::example().<br>\n";
  28793.     }
  28794. }
  28795.  
  28796. class B extends A
  28797. {
  28798.     function example()
  28799.     {
  28800.         echo "I am the redefined function B::example().<br>\n";
  28801.         A::example();
  28802.     }
  28803. }
  28804.  
  28805. // Es gibt kein Objekt der Klasse A.
  28806. // Dies wird folgendes ausgeben
  28807. //   I am the original function A::example().<br>
  28808. A::example();
  28809.  
  28810. // Erstellt ein Objekt der Klasse B.
  28811. $b = new B;
  28812.  
  28813. // Dies wird folgendes ausgeben
  28814. //   I am the redefined function B::example().<br>
  28815. //   I am the original function A::example().<br>
  28816. $b->example();</PRE
  28817. ></TD
  28818. ></TR
  28819. ></TABLE
  28820. ><P
  28821. ></P
  28822. ></DIV
  28823. ><P
  28824. >     Das obige Beispiel ruft die Funktion example() der Klasse A auf.
  28825.     Nachdem noch kein Objekt der Klasse A existiert, k÷nnen wir nicht
  28826.     $a->example() oder Σhnliches schreiben. Stattdessen rufen wir
  28827.     example() als 'Klassenfunktion' auf, d.h. als Funktion der Klasse
  28828.     selbst, und nicht irgendein Objekt dieser Klasse.
  28829.    </P
  28830. ><P
  28831. >     Es gibt Klassenfunktionen, aber keine Klassenvariablen. TatsΣchlich
  28832.     gibt es zur Zeit des Aufrufs kein Objekt. Deshalb darf eine
  28833.     Klassenfunktion keine Objektvariablen benutzen (aber sie kann lokale
  28834.     und globale Variablen verwenden), und sie darf $this ebenfalls nicht
  28835.     benutzen.
  28836.    </P
  28837. ><P
  28838. >     In dem obigen Beispiel definiert Klasse B die Funktion example() neu.
  28839.     Die ursprⁿngliche Definition in Klasse A ist ⁿberschattet und nicht
  28840.     lΣnger verfⁿgbar, au▀er Sie verweisen mittels des ::-Operators
  28841.     speziell auf example() in Klasse A. Schreiben Sie A::example(), um
  28842.     dies zu tun (TatsΣchlich sollten Sie parent::example() schreiben,
  28843.     wie im nΣchsten Abschnitt beschrieben).
  28844.    </P
  28845. ><P
  28846. >     In diesem Kontext besteht ein Objekt, das Objektvariablen haben
  28847.     kann. Deshalb k÷nnen Sie auch $this und Objektvariablen verwenden,
  28848.     wenn sie von innerhalb einer Objektfunktion verwendet werden.
  28849.    </P
  28850. ></DIV
  28851. ><DIV
  28852. CLASS="sect1"
  28853. ><HR><H2
  28854. CLASS="sect1"
  28855. ><A
  28856. NAME="keyword.parent"
  28857. ><VAR
  28858. CLASS="literal"
  28859. >parent</VAR
  28860. ></A
  28861. ></H2
  28862. ><P
  28863. >    Wahrscheinlich wollen Sie auch Code schreiben, der sich auch auf
  28864.    Variablen und Funktionen in Basisklassen bezieht. Dies gilt
  28865.    speziell dann, wenn Ihre abgeleitete Klasse eine Verfeinerung
  28866.    oder Spezialisierung von Code in Ihrer Basisklasse ist.
  28867.   </P
  28868. ><P
  28869. >    Anstatt in Ihrem Code den w÷rtlichen Namen der Basisklasse zu
  28870.    verwenden, sollten Sie den speziellen Namen
  28871.    <VAR
  28872. CLASS="literal"
  28873. >parent</VAR
  28874. > verwenden, welcher sich auf den in
  28875.    der Deklaration Ihrer Klasse mittels <VAR
  28876. CLASS="literal"
  28877. >extends</VAR
  28878. >
  28879.    gegebenen Namen Ihrer Basisklasse bezieht. So vermeiden Sie
  28880.    die mehrfache Verwendung des Namens der Basisklasse. Sollte
  28881.    sich Ihr Vererbungsbaum wΣhrend der Implementation Σndern,
  28882.    brauchen Sie nur mehr die <VAR
  28883. CLASS="literal"
  28884. >extends</VAR
  28885. > Deklaration
  28886.    Ihrer Klasse zu Σndern.
  28887.   </P
  28888. ><DIV
  28889. CLASS="informalexample"
  28890. ><P
  28891. ></P
  28892. ><A
  28893. NAME="AEN5058"
  28894. ></A
  28895. ><TABLE
  28896. BORDER="0"
  28897. BGCOLOR="#E0E0E0"
  28898. CELLPADDING="5"
  28899. ><TR
  28900. ><TD
  28901. ><PRE
  28902. CLASS="php"
  28903. >class A
  28904. {
  28905.     function example()
  28906.     {
  28907.         echo "I am A::example() and provide basic functionality.<br>\n";
  28908.     }
  28909. }
  28910.  
  28911. class B extends A
  28912. {
  28913.     function example()
  28914.     {
  28915.         echo "I am B::example() and provide additional functionality.<br>\n";
  28916.         parent::example();
  28917.     }
  28918. }
  28919.  
  28920. $b = new B;
  28921.  
  28922. // Dies ruft B::example() auf, welches wiederum A::example() aufruft.
  28923. $b->example();</PRE
  28924. ></TD
  28925. ></TR
  28926. ></TABLE
  28927. ><P
  28928. ></P
  28929. ></DIV
  28930. ></DIV
  28931. ><DIV
  28932. CLASS="sect1"
  28933. ><HR><H2
  28934. CLASS="sect1"
  28935. ><A
  28936. NAME="language.oop.serialization"
  28937. >Objekte serialisieren - Objekte in Sessions</A
  28938. ></H2
  28939. ><DIV
  28940. CLASS="note"
  28941. ><BLOCKQUOTE
  28942. CLASS="note"
  28943. ><P
  28944. ><B
  28945. >Anmerkung: </B
  28946. >
  28947.     In PHP 3 verlieren Objekte wΣhrend des Prozesses der Serialisierung
  28948.     und Deserialisierung ihre Assoziation zur Klasse. Die resultierende
  28949.     Variable ist vom Typ Objekt, hat aber keine Klasse und keine Methoden,
  28950.     weshalb sie ziemlich unbrauchbar ist (Sie wurde wie ein Array, jedoch
  28951.     mit einer ziemlich komischen Syntax).
  28952.    </P
  28953. ></BLOCKQUOTE
  28954. ></DIV
  28955. ><DIV
  28956. CLASS="caution"
  28957. ><P
  28958. ></P
  28959. ><TABLE
  28960. CLASS="caution"
  28961. BORDER="1"
  28962. WIDTH="100%"
  28963. ><TR
  28964. ><TD
  28965. ALIGN="CENTER"
  28966. ><B
  28967. >Achtung</B
  28968. ></TD
  28969. ></TR
  28970. ><TR
  28971. ><TD
  28972. ALIGN="LEFT"
  28973. ><P
  28974. >     Die folgende Information ist nur fⁿr PHP 4 gⁿltig.
  28975.    </P
  28976. ></TD
  28977. ></TR
  28978. ></TABLE
  28979. ></DIV
  28980. ><P
  28981. >    <A
  28982. HREF="#function.serialize"
  28983. ><B
  28984. CLASS="function"
  28985. >serialize()</B
  28986. ></A
  28987. > gibt eine Zeichenkette zurⁿck, die
  28988.    eine Byte-Strom-ReprΣsentation irgendeines in PHP speicherbaren
  28989.    Wertes enthΣlt. <A
  28990. HREF="#function.unserialize"
  28991. ><B
  28992. CLASS="function"
  28993. >unserialize()</B
  28994. ></A
  28995. > kann diese
  28996.    Zeichenkette verwenden, um die ursprⁿnglichen Variablenwerte
  28997.    wieder herzustellen. Die Verwendung von serialize zum Speichern
  28998.    eines Objektes wird alle Variablen innerhalb eines Objektes
  28999.    speichern. Die Funktionen in einem Objekt werden nicht gespeichert,
  29000.    sondern nur der Name der Klasse.
  29001.   </P
  29002. ><P
  29003. >    Um ein Objekt wieder deserialisieren zu k÷nnen, muss die Klasse
  29004.    dieses Objektes definiert werden. Das hei▀t, wenn Sie ein Objekt
  29005.    $a der Klasse A in page1.php haben und dieses serialisieren,
  29006.    erhalten Sie eine Zeichenkette, die sich auf die Klasse A bezieht,
  29007.    und alle Werte der in $a enthaltenen Variablen enthΣlt. Wenn Sie
  29008.    $a der Klasse A in page2.php mittels unserialize wiederherstellen
  29009.    m÷chten, muss die Definition von Klasse A in page2.php vorhanden
  29010.    sein. Dies kann zum Beispiel durch das Speichern der
  29011.    Klassendefiniton von Klasse A in einer Include-Datei, und das
  29012.    Einbinden dieser Datei sowohl in page1.php und page2.php realisiert
  29013.    werden.
  29014.   </P
  29015. ><DIV
  29016. CLASS="informalexample"
  29017. ><P
  29018. ></P
  29019. ><A
  29020. NAME="AEN5070"
  29021. ></A
  29022. ><TABLE
  29023. BORDER="0"
  29024. BGCOLOR="#E0E0E0"
  29025. CELLPADDING="5"
  29026. ><TR
  29027. ><TD
  29028. ><PRE
  29029. CLASS="php"
  29030. >classa.inc:
  29031.   class A 
  29032.   {
  29033.       var $one = 1;
  29034.     
  29035.       function show_one()
  29036.       {
  29037.           echo $this->one;
  29038.       }
  29039.   }
  29040.   
  29041. page1.php:
  29042.   include("classa.inc");
  29043.   
  29044.   $a = new A;
  29045.   $s = serialize($a);
  29046.   // speichere $s irgendwo, wo sie page2.php finden kann.
  29047.   $fp = fopen("store", "w");
  29048.   fputs($fp, $s);
  29049.   fclose($fp);
  29050.  
  29051. page2.php:
  29052.   // Dies ist fⁿr das korrekte Arbeiten von unserialize n÷tig.
  29053.   include("classa.inc");
  29054.  
  29055.   $s = implode("", @file("store"));
  29056.   $a = unserialize($s);
  29057.  
  29058.   // Nun verwenden wir die Funktion show_one() des Objektes $a.  
  29059.   $a->show_one();</PRE
  29060. ></TD
  29061. ></TR
  29062. ></TABLE
  29063. ><P
  29064. ></P
  29065. ></DIV
  29066. ><P
  29067. >    Wenn Sie mit Sessions arbeiten und <A
  29068. HREF="#function.session-register"
  29069. ><B
  29070. CLASS="function"
  29071. >session_register()</B
  29072. ></A
  29073. >
  29074.    verwenden, um Objekte zu registrieren, so werden diese Objekte am Ende
  29075.    der PHP Seite serialisiert, und in jeder folgenden Seite automatisch
  29076.    via unserialize wiederhergestellt. Das hei▀t, dass diese Objekte auf
  29077.    jeder Ihrer Seite auftauchen k÷nnen, sobald sie Teil Ihrer Session sind.
  29078.   </P
  29079. ><P
  29080. >    Es wird ausdrⁿcklich empfohlen, dass Sie die Klassendefinitionen der
  29081.    so registrierten Objekte in allen Ihren Seiten einbinden, auch wenn
  29082.    Sie diese Klassen eigentlich nicht auf allen Ihren Seiten ben÷tigen.
  29083.    Tun Sie es nicht und wird ein Objekt ohne einer vorhandenen
  29084.    Klassendefinition deserialisiert, verliert es seine Assoziation zur
  29085.    Klasse, und wird zu einem Objekt der Klasse <VAR
  29086. CLASS="literal"
  29087. >stdClass</VAR
  29088. >,
  29089.    ohne irgendwelchen Funktionen. Das bedeutet, dass es ziemlich nutzlos
  29090.    wird.
  29091.   </P
  29092. ><P
  29093. >    Wⁿrde also $a in dem obigen Beispiel mittels 
  29094.    <VAR
  29095. CLASS="literal"
  29096. >session_register("a")</VAR
  29097. > ein Teil einer Session,
  29098.    sollten Sie die Datei <VAR
  29099. CLASS="literal"
  29100. >classa.inc</VAR
  29101. > nicht nur in
  29102.    page1.php und page2.php, sondern in all Ihre Seiten einbinden.
  29103.   </P
  29104. ></DIV
  29105. ><DIV
  29106. CLASS="sect1"
  29107. ><HR><H2
  29108. CLASS="sect1"
  29109. ><A
  29110. NAME="language.oop.magic-functions"
  29111. >Die "magischen" Funktionen <VAR
  29112. CLASS="literal"
  29113. >__sleep</VAR
  29114. > und <VAR
  29115. CLASS="literal"
  29116. >__wakeup</VAR
  29117. ></A
  29118. ></H2
  29119. ><P
  29120. >    <A
  29121. HREF="#function.serialize"
  29122. ><B
  29123. CLASS="function"
  29124. >serialize()</B
  29125. ></A
  29126. > prⁿft, ob Ihre Klasse eine Funktion mit
  29127.    dem magischen Namen <VAR
  29128. CLASS="literal"
  29129. >__sleep</VAR
  29130. > enthΣlt. Wenn dem so ist,
  29131.    wird diese Funktion vor einer Serialisierung ausgefⁿhrt. Sie kann das
  29132.    Objekt aufrΣumen und soll ein Array mit den Namen aller Variablen des
  29133.    zu serialisierenden Objektes zurⁿckgeben.
  29134.   </P
  29135. ><P
  29136. >    Die beabsichtigte Verwendung von <VAR
  29137. CLASS="literal"
  29138. >__sleep</VAR
  29139. > ist,
  29140.    eventuelle Datenbankverbindungen des Objektes zu schlie▀en, noch
  29141.    offene Daten zu committen, oder Σhnliche SΣuberungsaktionen
  29142.    durchzufⁿhren. Weiters ist diese Funktion hilfreich, wenn Sie
  29143.    sehr gro▀e Objekte haben, die nicht komplett gespeichert werden 
  29144.    mⁿssen.
  29145.   </P
  29146. ><P
  29147. >    Umgekehrt prⁿft <A
  29148. HREF="#function.unserialize"
  29149. ><B
  29150. CLASS="function"
  29151. >unserialize()</B
  29152. ></A
  29153. > die Existenz einer
  29154.    Funktion mit dem magischen Namen <VAR
  29155. CLASS="literal"
  29156. >__wakeup</VAR
  29157. >. Ist
  29158.    diese vorhanden, kann sie Ressourcen des Objektes rekonstruieren.
  29159.   </P
  29160. ><P
  29161. >     Die vorgesehene Verwendung von <VAR
  29162. CLASS="literal"
  29163. >__wakeup</VAR
  29164. > ist die
  29165.     Wiederherstellung von Datenbankverbindungen, welche wΣhrend der
  29166.     Serialisierung verloren gegangen sein k÷nnten, sowie andere
  29167.     Neuinitialisierungen.
  29168.   </P
  29169. ></DIV
  29170. ><DIV
  29171. CLASS="sect1"
  29172. ><HR><H2
  29173. CLASS="sect1"
  29174. ><A
  29175. NAME="language.oop.newref"
  29176. >Referenzen innherhalb des Konstruktors</A
  29177. ></H2
  29178. ><P
  29179. >     Referenzen innerhalb des Konstruktors k÷nnen zu verwirrenden
  29180.     Resultaten fⁿhren. Dieser Abschnitt hilft, Probleme zu vermeiden.
  29181.  
  29182.     <DIV
  29183. CLASS="informalexample"
  29184. ><P
  29185. ></P
  29186. ><A
  29187. NAME="AEN5096"
  29188. ></A
  29189. ><TABLE
  29190. BORDER="0"
  29191. BGCOLOR="#E0E0E0"
  29192. CELLPADDING="5"
  29193. ><TR
  29194. ><TD
  29195. ><PRE
  29196. CLASS="php"
  29197. >class Foo
  29198. {
  29199.     function Foo($name)
  29200.     {
  29201.         // eine Referenz innerhalb des globalen Arrays  $globalref erstellen
  29202.         global $globalref;
  29203.         $globalref[] = &$this;
  29204.         // setze den Namen auf den ⁿbergebenen Wert
  29205.         $this->setName($name);
  29206.         // und gib' ihn aus
  29207.         $this->echoName();
  29208.     }
  29209.  
  29210.     function echoName()
  29211.     {
  29212.         echo "<br>",$this->name;
  29213.     }
  29214.     
  29215.     function setName($name)
  29216.     {
  29217.         $this->name = $name;
  29218.     }
  29219. }</PRE
  29220. ></TD
  29221. ></TR
  29222. ></TABLE
  29223. ><P
  29224. ></P
  29225. ></DIV
  29226. >
  29227.   </P
  29228. ><P
  29229. >     Prⁿfen wir, ob zwischen <VAR
  29230. CLASS="varname"
  29231. >$bar1</VAR
  29232. >, die mittels
  29233.     dem Operator zum Kopieren  <VAR
  29234. CLASS="literal"
  29235. >=</VAR
  29236. > erstellt wurde,
  29237.     und <VAR
  29238. CLASS="varname"
  29239. >$bar2</VAR
  29240. >, die mittels dem Referenzoperator
  29241.     <VAR
  29242. CLASS="literal"
  29243. >=&</VAR
  29244. > erstellt wurde, besteht...
  29245.  
  29246.     <DIV
  29247. CLASS="informalexample"
  29248. ><P
  29249. ></P
  29250. ><A
  29251. NAME="AEN5103"
  29252. ></A
  29253. ><TABLE
  29254. BORDER="0"
  29255. BGCOLOR="#E0E0E0"
  29256. CELLPADDING="5"
  29257. ><TR
  29258. ><TD
  29259. ><PRE
  29260. CLASS="php"
  29261. >$bar1 = new Foo('set in constructor');
  29262. $bar1->echoName();
  29263. $globalref[0]->echoName();
  29264.  
  29265. /* Ausgabe:
  29266. set in constructor
  29267. set in constructor
  29268. set in constructor */
  29269.  
  29270. $bar2 =& new Foo('set in constructor');
  29271. $bar2->echoName();
  29272. $globalref[1]->echoName();
  29273.  
  29274. /* Ausgabe:
  29275. set in constructor
  29276. set in constructor
  29277. set in constructor */</PRE
  29278. ></TD
  29279. ></TR
  29280. ></TABLE
  29281. ><P
  29282. ></P
  29283. ></DIV
  29284. >
  29285.    </P
  29286. ><P
  29287. >     Scheinbar besteht kein Unterschied, aber tatsΣchlich existiert ein
  29288.     signifikanter: <VAR
  29289. CLASS="varname"
  29290. >$bar1</VAR
  29291. > und
  29292.     <VAR
  29293. CLASS="varname"
  29294. >$globalref[0]</VAR
  29295. > sind NICHT referenziert, d.h. sie
  29296.     sind NICHT die selbe Variable. Das kommt daher, dass "new" nicht
  29297.     automatisch eine Referenz, sondern eine Kopie zurⁿckgibt.
  29298.     <DIV
  29299. CLASS="note"
  29300. ><BLOCKQUOTE
  29301. CLASS="note"
  29302. ><P
  29303. ><B
  29304. >Anmerkung: </B
  29305. >
  29306.       Das zurⁿckgeben von Kopien anstatt von Referenzen stellt keinen
  29307.       Performanceverlust dar (da PHP 4 und h÷her Reference Counting
  29308.       verwendet). Andererseits ist es sehr oft besser, einfach mit Kopien
  29309.       anstatt mit Referenzen zu arbeiten, da die Erstellung von Referenzen
  29310.       etwas Zeit in Anspruch nimmt, wΣhrend das Erstellen von Kopien so gut
  29311.       wie keine Zeit braucht (sofern keine von ihnen ein gro▀es Array oder
  29312.       Objekt ist, und eines davon geΣndert wird und das/die andere/n
  29313.       nachtrΣglich. In diesem Fall wΣre es besser, Referenzen zu verwenden,
  29314.       um sie alle gleichzeitig zu Σndern).
  29315.      </P
  29316. ></BLOCKQUOTE
  29317. ></DIV
  29318. >
  29319.     Um das zuvor geschriebene zu beweisen, sehen wir uns den folgenden Code an.
  29320.  
  29321.     <DIV
  29322. CLASS="informalexample"
  29323. ><P
  29324. ></P
  29325. ><A
  29326. NAME="AEN5110"
  29327. ></A
  29328. ><TABLE
  29329. BORDER="0"
  29330. BGCOLOR="#E0E0E0"
  29331. CELLPADDING="5"
  29332. ><TR
  29333. ><TD
  29334. ><PRE
  29335. CLASS="php"
  29336. >// nun werden wir den Namen Σndern. Was erwarten Sie?
  29337. // ...dass sowohl $bar1, als auch $globalref[0] ihre Namen Σndern...
  29338. $bar1->setName('set from outside');
  29339.  
  29340. // wie bereits zuvor erwΣhnt, ist dies nicht der Fall
  29341. $bar1->echoName();
  29342. $globalref[0]->echoName();
  29343.  
  29344. /* Ausgabe:
  29345. set from outside
  29346. set in constructor */
  29347.  
  29348. // lassen Sie uns den Unterschied zwischen $bar2 and $globalref[1] ansehen
  29349. $bar2->setName('set from outside');
  29350.  
  29351. // glⁿcklicherweise sind sie nicht nur nicht gleich, sondern auch die selbe
  29352. // Variable; demnach sind $bar2->name und $globalref[1]->name ebenfalls gleich
  29353. $bar2->echoName();
  29354. $globalref[1]->echoName();
  29355.  
  29356. /* Ausgabe:
  29357. set from outside
  29358. set from outside */</PRE
  29359. ></TD
  29360. ></TR
  29361. ></TABLE
  29362. ><P
  29363. ></P
  29364. ></DIV
  29365. >   
  29366.    </P
  29367. ><P
  29368. >    Ein anderes, letztes Beispiel zum VerstΣndnis:
  29369.    
  29370.     <DIV
  29371. CLASS="informalexample"
  29372. ><P
  29373. ></P
  29374. ><A
  29375. NAME="AEN5113"
  29376. ></A
  29377. ><TABLE
  29378. BORDER="0"
  29379. BGCOLOR="#E0E0E0"
  29380. CELLPADDING="5"
  29381. ><TR
  29382. ><TD
  29383. ><PRE
  29384. CLASS="php"
  29385. >class A
  29386. {
  29387.     function A($i)
  29388.     {
  29389.         $this->value = $i;
  29390.         // finden Sie heraus, warum wir hier keine Referenz ben÷tigen
  29391.         $this->b = new B($this);
  29392.     }
  29393.  
  29394.     function createRef()
  29395.     {
  29396.         $this->c = new B($this);
  29397.     }
  29398.  
  29399.     function echoValue()
  29400.     {
  29401.         echo "<br>","class ",get_class($this),': ',$this->value;
  29402.     }
  29403. }
  29404.  
  29405.  
  29406. class B
  29407. {
  29408.     function B(&$a)
  29409.     {
  29410.         $this->a = &$a;
  29411.     }
  29412.  
  29413.     function echoValue()
  29414.     {
  29415.         echo "<br>","class ",get_class($this),': ',$this->a->value;
  29416.     }
  29417. }
  29418.  
  29419. // ⁿberlegen Sie, warum hier die Verwendung einer einfachen Kopie in der
  29420. // mit * markierten Zeile zu einem unerwⁿnschten Ergebnis fⁿhren wⁿrde
  29421. $a =& new A(10);
  29422. $a->createRef();
  29423.  
  29424. $a->echoValue();
  29425. $a->b->echoValue();
  29426. $a->c->echoValue();
  29427.  
  29428. $a->value = 11;
  29429.  
  29430. $a->echoValue();
  29431. $a->b->echoValue(); // *
  29432. $a->c->echoValue();
  29433.  
  29434. /*
  29435. Ausgabe:
  29436. class A: 10
  29437. class B: 10
  29438. class B: 10
  29439. class A: 11
  29440. class B: 11
  29441. class B: 11
  29442. */</PRE
  29443. ></TD
  29444. ></TR
  29445. ></TABLE
  29446. ><P
  29447. ></P
  29448. ></DIV
  29449. >
  29450.    </P
  29451. ></DIV
  29452. ></DIV
  29453. ><DIV
  29454. CLASS="chapter"
  29455. ><HR><H1
  29456. ><A
  29457. NAME="language.oop5"
  29458. >Kapitel 18. Classes and Objects (PHP 5)</A
  29459. ></H1
  29460. ><DIV
  29461. CLASS="sect1"
  29462. ><H2
  29463. CLASS="sect1"
  29464. ><A
  29465. NAME="op5.intro"
  29466. >Introduction</A
  29467. ></H2
  29468. ><P
  29469. >      Intro to oop5 for php
  29470.     </P
  29471. ></DIV
  29472. ><DIV
  29473. CLASS="sect1"
  29474. ><HR><H2
  29475. CLASS="sect1"
  29476. ><A
  29477. NAME="language.oop5.decon"
  29478. >Constructors and Destructors</A
  29479. ></H2
  29480. ><DIV
  29481. CLASS="sect2"
  29482. ><H3
  29483. CLASS="sect2"
  29484. ><A
  29485. NAME="oop5-decon-constructor"
  29486. >Constructor</A
  29487. ></H3
  29488. >void <B
  29489. CLASS="methodname"
  29490. >__construct</B
  29491. > ( [mixed args [, ...]])<BR
  29492. ></BR
  29493. ><P
  29494. >     PHP 5 allows developers to declare constructor methods for classes.
  29495.     Classes which have a constructor method call this method on each
  29496.     newly-created object, so it is suitable for any initialization that the
  29497.     object may need before it is used.
  29498.    </P
  29499. ><DIV
  29500. CLASS="note"
  29501. ><BLOCKQUOTE
  29502. CLASS="note"
  29503. ><P
  29504. ><B
  29505. >Anmerkung: </B
  29506. >
  29507.      Parent constructors are not called implicitly.  In order to run
  29508.      a parent constructor, a call to
  29509.      <B
  29510. CLASS="function"
  29511. >parent::__construct()</B
  29512. > is required.
  29513.     </P
  29514. ></BLOCKQUOTE
  29515. ></DIV
  29516. ><TABLE
  29517. WIDTH="100%"
  29518. BORDER="0"
  29519. CELLPADDING="0"
  29520. CELLSPACING="0"
  29521. CLASS="EXAMPLE"
  29522. ><TR
  29523. ><TD
  29524. ><DIV
  29525. CLASS="example"
  29526. ><A
  29527. NAME="AEN5136"
  29528. ></A
  29529. ><P
  29530. ><B
  29531. >Beispiel 18-1. using new unified constructors</B
  29532. ></P
  29533. ><TABLE
  29534. BORDER="0"
  29535. BGCOLOR="#E0E0E0"
  29536. CELLPADDING="5"
  29537. ><TR
  29538. ><TD
  29539. ><PRE
  29540. CLASS="php"
  29541. ><?php
  29542. class BaseClass {
  29543.    function __construct() {
  29544.        print "In BaseClass constructor\n";
  29545.    }
  29546. }
  29547.  
  29548. class SubClass extends BaseClass {
  29549.    function __construct() {
  29550.        parent::__construct();
  29551.        print "In SubClass constructor\n";
  29552.    }
  29553. }
  29554.  
  29555. $obj = new BaseClass();
  29556. $obj = new SubClass();
  29557. ?></PRE
  29558. ></TD
  29559. ></TR
  29560. ></TABLE
  29561. ></DIV
  29562. ></TD
  29563. ></TR
  29564. ></TABLE
  29565. ><P
  29566. >     For backwards compatibility, if PHP 5 cannot find a 
  29567.     <B
  29568. CLASS="function"
  29569. >__construct()</B
  29570. > function for a given class, it will
  29571.     search for the old-style constructor function, by the name of the class.
  29572.     Effectively, it means that the only case that would have compatibility
  29573.     issues is if the class had a method named 
  29574.     <B
  29575. CLASS="function"
  29576. >__construct()</B
  29577. > which was used for different semantics.
  29578.    </P
  29579. ></DIV
  29580. ><DIV
  29581. CLASS="sect2"
  29582. ><HR><H3
  29583. CLASS="sect2"
  29584. ><A
  29585. NAME="oop5-decon-destructor"
  29586. >Destructor</A
  29587. ></H3
  29588. >void <B
  29589. CLASS="methodname"
  29590. >__destruct</B
  29591. > ( void )<BR
  29592. ></BR
  29593. ><P
  29594. >     PHP 5 introduces a destructor concept similar to that of other
  29595.     object-oriented languages, such as Java.  The destructor method will be
  29596.     called as soon as all references to a paticular object are removed or when
  29597.     the object is explicitly destroyed.
  29598.    </P
  29599. ><TABLE
  29600. WIDTH="100%"
  29601. BORDER="0"
  29602. CELLPADDING="0"
  29603. CELLSPACING="0"
  29604. CLASS="EXAMPLE"
  29605. ><TR
  29606. ><TD
  29607. ><DIV
  29608. CLASS="example"
  29609. ><A
  29610. NAME="AEN5149"
  29611. ></A
  29612. ><P
  29613. ><B
  29614. >Beispiel 18-2. Destructor Example</B
  29615. ></P
  29616. ><TABLE
  29617. BORDER="0"
  29618. BGCOLOR="#E0E0E0"
  29619. CELLPADDING="5"
  29620. ><TR
  29621. ><TD
  29622. ><PRE
  29623. CLASS="php"
  29624. ><?php
  29625. class MyDestructableClass {
  29626.    function __construct() {
  29627.        print "In constructor\n";
  29628.        $this->name = "MyDestructableClass";
  29629.    }
  29630.  
  29631.    function __destruct() {
  29632.        print "Destroying " . $this->name . "\n";
  29633.    }
  29634. }
  29635.  
  29636. $obj = new MyDestructableClass();
  29637. ?></PRE
  29638. ></TD
  29639. ></TR
  29640. ></TABLE
  29641. ></DIV
  29642. ></TD
  29643. ></TR
  29644. ></TABLE
  29645. ><P
  29646. >     Like constructors, parent destructors will not be called implicitly by
  29647.     the engine. In order to run a parent destructor, one would have to
  29648.     explicitly call <B
  29649. CLASS="function"
  29650. >parent::__destruct()</B
  29651. > in the destructor
  29652.     body.
  29653.    </P
  29654. ></DIV
  29655. ></DIV
  29656. ><DIV
  29657. CLASS="sect1"
  29658. ><HR><H2
  29659. CLASS="sect1"
  29660. ><A
  29661. NAME="language.oop5.visibility"
  29662. >Visibility</A
  29663. ></H2
  29664. ><P
  29665. >    The visibility of a property or method can be defined by prefixing the
  29666.    declaration with the keywords: public, protected or private. Public
  29667.    declared items can be acessed everywhere. Protected limits access to
  29668.    inherited classes (and to the class that defines the item). Private limits
  29669.    visiblity only to the class that defines the item.
  29670.   </P
  29671. ><DIV
  29672. CLASS="sect2"
  29673. ><HR><H3
  29674. CLASS="sect2"
  29675. ><A
  29676. NAME="language.oop5.visiblity-members"
  29677. >Members Visibility</A
  29678. ></H3
  29679. ><P
  29680. >    Class members must be defined with public, private, or protected.
  29681.    </P
  29682. ><TABLE
  29683. WIDTH="100%"
  29684. BORDER="0"
  29685. CELLPADDING="0"
  29686. CELLSPACING="0"
  29687. CLASS="EXAMPLE"
  29688. ><TR
  29689. ><TD
  29690. ><DIV
  29691. CLASS="example"
  29692. ><A
  29693. NAME="AEN5160"
  29694. ></A
  29695. ><P
  29696. ><B
  29697. >Beispiel 18-3. Member declaration</B
  29698. ></P
  29699. ><TABLE
  29700. BORDER="0"
  29701. BGCOLOR="#E0E0E0"
  29702. CELLPADDING="5"
  29703. ><TR
  29704. ><TD
  29705. ><PRE
  29706. CLASS="php"
  29707. ><?php
  29708.  
  29709. class MyClass {
  29710.    public    $public     = "MyClass::public!\n";
  29711.    protected $protected  = "MyClass::Protected!\n";
  29712.    protected $protected2 = "MyClass::Protected2!\n";
  29713.    private   $private    = "MyClass::private!\n";
  29714.  
  29715.    function printHello() {
  29716.       print "MyClass::printHello() " . $this->private;
  29717.       print "MyClass::printHello() " . $this->protected;
  29718.       print "MyClass::printHello() " . $this->protected2;
  29719.    }
  29720. }
  29721.  
  29722. class MyClass2 extends MyClass {
  29723.    protected $protected = "MyClass2::protected!\n";
  29724.  
  29725.    function printHello() {
  29726.  
  29727.       MyClass::printHello();    
  29728.  
  29729.       print "MyClass2::printHello() " . $this->public; 
  29730.       print "MyClass2::printHello() " . $this->protected; 
  29731.       print "MyClass2::printHello() " . $this->protected2;
  29732.  
  29733.       /* Will result in a Fatal Error: */
  29734.       //print "MyClass2::printHello() " . $this->private; /* Fatal Error */
  29735.  
  29736.    }
  29737. }
  29738.  
  29739. $obj = new MyClass();
  29740.  
  29741. print "Main:: " . $obj->public;
  29742. //print $obj->private; /* Fatal Error */
  29743. //print $obj->protected;  /* Fatal Error */
  29744. //print $obj->protected2;  /* Fatal Error */
  29745.  
  29746. $obj->printHello(); /* Should print */
  29747.  
  29748. $obj2 = new MyClass2();
  29749. print "Main:: " . $obj2->private; /* Undefined */ 
  29750.  
  29751. //print $obj2->protected;   /* Fatal Error */ 
  29752. //print $obj2->protected2;  /* Fatal Error */ 
  29753.  
  29754. $obj2->printHello();
  29755. ?></PRE
  29756. ></TD
  29757. ></TR
  29758. ></TABLE
  29759. ></DIV
  29760. ></TD
  29761. ></TR
  29762. ></TABLE
  29763. ><DIV
  29764. CLASS="note"
  29765. ><BLOCKQUOTE
  29766. CLASS="note"
  29767. ><P
  29768. ><B
  29769. >Anmerkung: </B
  29770. >
  29771.      The use PHP 4 use of declaring a variable with the keyword 'var' is
  29772.      no longer valid for PHP 5 objects. For compatiblity a variable declared
  29773.      in php will be assumed with public visiblity, and a
  29774.      <TT
  29775. CLASS="constant"
  29776. ><B
  29777. >E_STRICT</B
  29778. ></TT
  29779. > warning will be issued.
  29780.     </P
  29781. ></BLOCKQUOTE
  29782. ></DIV
  29783. ></DIV
  29784. ><DIV
  29785. CLASS="sect2"
  29786. ><HR><H3
  29787. CLASS="sect2"
  29788. ><A
  29789. NAME="language.oop5.visiblity-methods"
  29790. >Method Visibility</A
  29791. ></H3
  29792. ><P
  29793. >     .
  29794.    </P
  29795. ></DIV
  29796. ></DIV
  29797. ><DIV
  29798. CLASS="sect1"
  29799. ><HR><H2
  29800. CLASS="sect1"
  29801. ><A
  29802. NAME="language.oop5.paamayim-nekudotayim"
  29803. >::</A
  29804. ></H2
  29805. ><P
  29806. >    The Paamayim Nekudotayim, or in simpler terms, the double colon.
  29807.    This token provides a way to access <A
  29808. HREF="#language.oop5.static"
  29809. >static</A
  29810. >, <A
  29811. HREF="#language.oop5.constants"
  29812. >constant</A
  29813. > or overridden members
  29814.    or methods of a class. 
  29815.   </P
  29816. ><P
  29817. >    When referencing these items from outside the class definition, you use
  29818.    name of the class.
  29819.   </P
  29820. ><P
  29821. >    Paamayim Nekudotayim would, at first, seem a strange choice for a
  29822.    double-colon. However, at the time of writing of Zend Engine 0.5
  29823.    (which powered PHP3), that is what Andi and Zeev decided to call it.
  29824.    It actually does mean double-colon - in Hebrew! As PHP has progressed
  29825.    with its development it has just never changed.
  29826.   </P
  29827. ><TABLE
  29828. WIDTH="100%"
  29829. BORDER="0"
  29830. CELLPADDING="0"
  29831. CELLSPACING="0"
  29832. CLASS="EXAMPLE"
  29833. ><TR
  29834. ><TD
  29835. ><DIV
  29836. CLASS="example"
  29837. ><A
  29838. NAME="AEN5176"
  29839. ></A
  29840. ><P
  29841. ><B
  29842. >Beispiel 18-4. :: from outside class definition</B
  29843. ></P
  29844. ><TABLE
  29845. BORDER="0"
  29846. BGCOLOR="#E0E0E0"
  29847. CELLPADDING="5"
  29848. ><TR
  29849. ><TD
  29850. ><PRE
  29851. CLASS="php"
  29852. ><?php
  29853. class MyClass {
  29854.   const CONST_VALUE = 'A constant value';
  29855. }
  29856. echo MyClass::CONST_VALUE;
  29857. ?></PRE
  29858. ></TD
  29859. ></TR
  29860. ></TABLE
  29861. ></DIV
  29862. ></TD
  29863. ></TR
  29864. ></TABLE
  29865. ><P
  29866. >    Two special keywords <VAR
  29867. CLASS="varname"
  29868. >self</VAR
  29869. > and <VAR
  29870. CLASS="varname"
  29871. >parent</VAR
  29872. >
  29873.    are used to access members or methods from inside the class definition.
  29874.   </P
  29875. ><TABLE
  29876. WIDTH="100%"
  29877. BORDER="0"
  29878. CELLPADDING="0"
  29879. CELLSPACING="0"
  29880. CLASS="EXAMPLE"
  29881. ><TR
  29882. ><TD
  29883. ><DIV
  29884. CLASS="example"
  29885. ><A
  29886. NAME="AEN5182"
  29887. ></A
  29888. ><P
  29889. ><B
  29890. >Beispiel 18-5. :: from inside the class definition</B
  29891. ></P
  29892. ><TABLE
  29893. BORDER="0"
  29894. BGCOLOR="#E0E0E0"
  29895. CELLPADDING="5"
  29896. ><TR
  29897. ><TD
  29898. ><PRE
  29899. CLASS="php"
  29900. ><?php
  29901. class OtherClass extends MyClass {
  29902.   public static $my_static = 'static var';
  29903.  
  29904.   public static function doubleColon() {
  29905.      echo parent::CONST_VALUE . "\n";
  29906.      echo self::$my_static . "\n";
  29907.   }
  29908. }
  29909.  
  29910. OtherClass::doubleColon();
  29911. ?></PRE
  29912. ></TD
  29913. ></TR
  29914. ></TABLE
  29915. ></DIV
  29916. ></TD
  29917. ></TR
  29918. ></TABLE
  29919. ><P
  29920. >    When an extending class overrides the parents definition of a method,
  29921.    php will not call the parent's method.  It is up to the extending class
  29922.    to call the parent method or not, this also applies to <A
  29923. HREF="#language.oop5.decon"
  29924. >Constructors and Destructors</A
  29925. >, <A
  29926. HREF="#language.oop5.overloading"
  29927. >Overloading</A
  29928. > and <A
  29929. HREF="#language.oop5.magic"
  29930. >Magic</A
  29931. > method defintions as well.
  29932.   </P
  29933. ><TABLE
  29934. WIDTH="100%"
  29935. BORDER="0"
  29936. CELLPADDING="0"
  29937. CELLSPACING="0"
  29938. CLASS="EXAMPLE"
  29939. ><TR
  29940. ><TD
  29941. ><DIV
  29942. CLASS="example"
  29943. ><A
  29944. NAME="AEN5189"
  29945. ></A
  29946. ><P
  29947. ><B
  29948. >Beispiel 18-6. Calling a parent's method</B
  29949. ></P
  29950. ><TABLE
  29951. BORDER="0"
  29952. BGCOLOR="#E0E0E0"
  29953. CELLPADDING="5"
  29954. ><TR
  29955. ><TD
  29956. ><PRE
  29957. CLASS="php"
  29958. ><?php
  29959. class MyClass {
  29960.  
  29961.   protected function myFunc() {
  29962.     echo "MyClass::myFunc()\n";
  29963.   }
  29964. }
  29965.  
  29966. class OtherClass extends MyClass {
  29967.  
  29968.   /* Override parent's definition */
  29969.   public function myFunc() {
  29970.  
  29971.     /* But still call the parent function */
  29972.     parent::myFunc();
  29973.     echo "OtherClass::myFunc()\n";
  29974.   }
  29975. }
  29976.  
  29977. $class = new OtherClass();
  29978. $class->myFunc();
  29979. ?></PRE
  29980. ></TD
  29981. ></TR
  29982. ></TABLE
  29983. ></DIV
  29984. ></TD
  29985. ></TR
  29986. ></TABLE
  29987. ></DIV
  29988. ><DIV
  29989. CLASS="sect1"
  29990. ><HR><H2
  29991. CLASS="sect1"
  29992. ><A
  29993. NAME="language.oop5.static"
  29994. >Static Keyword</A
  29995. ></H2
  29996. ><P
  29997. >    Declaring class members or methods as static, makes them callable
  29998.    from outside the object context. A member or method declared
  29999.    with static can not be accessed with a variable that is an instance
  30000.    of the object and cannot be re-defined in an extending class.
  30001.   </P
  30002. ><P
  30003. >    The static declaration must be after the visibilty declaration. For 
  30004.    compatibility with PHP 4, if no <A
  30005. HREF="#language.oop5.visibility"
  30006. >visibility</A
  30007. >
  30008.    declaration is used, then the member or method will be treated
  30009.    as if it was declared as <VAR
  30010. CLASS="literal"
  30011. >public static</VAR
  30012. >.
  30013.   </P
  30014. ><P
  30015. >    Because static methods are callable without an instance of
  30016.    the object created, the pseudo variable <VAR
  30017. CLASS="varname"
  30018. >$this</VAR
  30019. > is
  30020.    not available inside the method declared as static.
  30021.   </P
  30022. ><TABLE
  30023. WIDTH="100%"
  30024. BORDER="0"
  30025. CELLPADDING="0"
  30026. CELLSPACING="0"
  30027. CLASS="EXAMPLE"
  30028. ><TR
  30029. ><TD
  30030. ><DIV
  30031. CLASS="example"
  30032. ><A
  30033. NAME="AEN5200"
  30034. ></A
  30035. ><P
  30036. ><B
  30037. >Beispiel 18-7. Static member example</B
  30038. ></P
  30039. ><TABLE
  30040. BORDER="0"
  30041. BGCOLOR="#E0E0E0"
  30042. CELLPADDING="5"
  30043. ><TR
  30044. ><TD
  30045. ><PRE
  30046. CLASS="php"
  30047. ><?php
  30048. class Foo {
  30049.   public static $my_static = 'foo';
  30050.  
  30051.   public function staticValue() {
  30052.     return self::$my_static;
  30053.   }
  30054. }
  30055.  
  30056. class Bar extends Foo {
  30057.  
  30058.   public function fooStatic() {
  30059.     return parent::$my_static;
  30060.   }
  30061. }
  30062.  
  30063.  
  30064. print Foo::$my_static . "\n";
  30065.  
  30066. $foo = new Foo();
  30067. print $foo->staticValue() . "\n";
  30068. print $foo->my_static . "\n";      // Undefined my_static 
  30069.  
  30070. print Bar::$my_static . "\n";
  30071. $bar = new Bar();
  30072. print $bar->fooStatic() . "\n";
  30073. ?></PRE
  30074. ></TD
  30075. ></TR
  30076. ></TABLE
  30077. ></DIV
  30078. ></TD
  30079. ></TR
  30080. ></TABLE
  30081. ><TABLE
  30082. WIDTH="100%"
  30083. BORDER="0"
  30084. CELLPADDING="0"
  30085. CELLSPACING="0"
  30086. CLASS="EXAMPLE"
  30087. ><TR
  30088. ><TD
  30089. ><DIV
  30090. CLASS="example"
  30091. ><A
  30092. NAME="AEN5203"
  30093. ></A
  30094. ><P
  30095. ><B
  30096. >Beispiel 18-8. Static method example</B
  30097. ></P
  30098. ><TABLE
  30099. BORDER="0"
  30100. BGCOLOR="#E0E0E0"
  30101. CELLPADDING="5"
  30102. ><TR
  30103. ><TD
  30104. ><PRE
  30105. CLASS="php"
  30106. ><?php
  30107. class Foo {
  30108.   public static function aStaticMethod() {
  30109.     // ...
  30110.   }
  30111. }
  30112.  
  30113. Foo::aStaticMethod();
  30114. ?></PRE
  30115. ></TD
  30116. ></TR
  30117. ></TABLE
  30118. ></DIV
  30119. ></TD
  30120. ></TR
  30121. ></TABLE
  30122. ></DIV
  30123. ><DIV
  30124. CLASS="sect1"
  30125. ><HR><H2
  30126. CLASS="sect1"
  30127. ><A
  30128. NAME="language.oop5.constants"
  30129. >Object Constants</A
  30130. ></H2
  30131. ><P
  30132. >    It is possible to define constant values on a per-class basis remaining the
  30133.    same and unchangeable. Constants differ from normal variables in that you
  30134.    don't use the <VAR
  30135. CLASS="varname"
  30136. >$</VAR
  30137. > symbol to declare or use them.  Like
  30138.    <A
  30139. HREF="#language.oop5.static"
  30140. >static</A
  30141. > members, constant values
  30142.    can not be accessed from an instance of the object.
  30143.   </P
  30144. ><TABLE
  30145. WIDTH="100%"
  30146. BORDER="0"
  30147. CELLPADDING="0"
  30148. CELLSPACING="0"
  30149. CLASS="EXAMPLE"
  30150. ><TR
  30151. ><TD
  30152. ><DIV
  30153. CLASS="example"
  30154. ><A
  30155. NAME="AEN5211"
  30156. ></A
  30157. ><P
  30158. ><B
  30159. >Beispiel 18-9. Defining and using a constant</B
  30160. ></P
  30161. ><TABLE
  30162. BORDER="0"
  30163. BGCOLOR="#E0E0E0"
  30164. CELLPADDING="5"
  30165. ><TR
  30166. ><TD
  30167. ><PRE
  30168. CLASS="php"
  30169. ><?php
  30170. class MyClass {
  30171.   const constant = 'constant value';
  30172.  
  30173.   function showConstant() {
  30174.     echo  self::constant . "\n";
  30175.   }
  30176. }
  30177.  
  30178. echo MyClass::constant . "\n";
  30179.  
  30180. $class = new MyClass();
  30181. $class->showConstant();
  30182. /* echo $class::constant;  is not allowed */
  30183. ?></PRE
  30184. ></TD
  30185. ></TR
  30186. ></TABLE
  30187. ></DIV
  30188. ></TD
  30189. ></TR
  30190. ></TABLE
  30191. ></DIV
  30192. ><DIV
  30193. CLASS="sect1"
  30194. ><HR><H2
  30195. CLASS="sect1"
  30196. ><A
  30197. NAME="language.oop5.abstract"
  30198. >Object Abstraction</A
  30199. ></H2
  30200. ><P
  30201. >    PHP 5 introduces abstract classes and methods. It is not allowed to create
  30202.    an instance of a class that has been defined as abstract.  Any class that
  30203.    contains at least one abstract method must also be abstract.  Methods
  30204.    defined as abstract simply declare the method's signature they cannot
  30205.    define the implementation.
  30206.   </P
  30207. ><P
  30208. >    The class that implements the abstract method must define with the same
  30209.    <A
  30210. HREF="#language.oop5.visibility"
  30211. >visibillity</A
  30212. > or weaker. If the
  30213.    abstract method is defined as protected, the function implenetation must be
  30214.    defined as either protected or public.
  30215.   </P
  30216. ><TABLE
  30217. WIDTH="100%"
  30218. BORDER="0"
  30219. CELLPADDING="0"
  30220. CELLSPACING="0"
  30221. CLASS="EXAMPLE"
  30222. ><TR
  30223. ><TD
  30224. ><DIV
  30225. CLASS="example"
  30226. ><A
  30227. NAME="AEN5219"
  30228. ></A
  30229. ><P
  30230. ><B
  30231. >Beispiel 18-10. Abstract class example</B
  30232. ></P
  30233. ><TABLE
  30234. BORDER="0"
  30235. BGCOLOR="#E0E0E0"
  30236. CELLPADDING="5"
  30237. ><TR
  30238. ><TD
  30239. ><PRE
  30240. CLASS="php"
  30241. ><?php
  30242.  
  30243. abstract class AbstractClass {
  30244.  
  30245.    /* Force Extending class to define this method */
  30246.    abstract protected function getValue();
  30247.  
  30248.    /* Common method */
  30249.    public function print() {
  30250.      print $this->getValue();
  30251.    }
  30252.  
  30253. }
  30254.  
  30255. class ConcreteClass1 extends AbstractClass {
  30256.  
  30257.    protected function getValue() {
  30258.      return "ConcreteClass1";
  30259.    }
  30260.  
  30261. }
  30262.  
  30263. class ConcreteClass2 extends AbstractClass {
  30264.  
  30265.    protected function getValue() {
  30266.      return "ConcreteClass2";
  30267.    }
  30268.  
  30269. }
  30270.  
  30271. $class1 = new ConcreteClass1;
  30272. $class1->print();
  30273.  
  30274. $class2 = new ConcreteClass2;
  30275. $class2->print();
  30276. ?></PRE
  30277. ></TD
  30278. ></TR
  30279. ></TABLE
  30280. ></DIV
  30281. ></TD
  30282. ></TR
  30283. ></TABLE
  30284. ><P
  30285. >     Old code that has no user-defined classes or functions named
  30286.     'abstract' should run without modifications.
  30287.    </P
  30288. ></DIV
  30289. ><DIV
  30290. CLASS="sect1"
  30291. ><HR><H2
  30292. CLASS="sect1"
  30293. ><A
  30294. NAME="language.oop5.interfaces"
  30295. >Object Interfaces</A
  30296. ></H2
  30297. ><P
  30298. >    Object interfaces allow you to create code which specifies which methods 
  30299.    and variables a class must implement, without having to define how these 
  30300.    methods are handled.
  30301.   </P
  30302. ><P
  30303. >    Interfaces are defined using the interface keyword, in the same way as a
  30304.    standard class, but without any of the methods having their contents
  30305.    defined. Classes which implement an interface should do so using the
  30306.    implements keyword, and must have definitions for all the methods listed
  30307.    in the interface. Classes may implement more than one interface if desired
  30308.    by listing each interface split by a space.
  30309.   </P
  30310. ><P
  30311. >    Stating that a class implements an interface, and then not implementing all
  30312.    the methods in the interface will result in a fatal error telling you which
  30313.    methods have not been implemented.
  30314.   </P
  30315. ><TABLE
  30316. WIDTH="100%"
  30317. BORDER="0"
  30318. CELLPADDING="0"
  30319. CELLSPACING="0"
  30320. CLASS="EXAMPLE"
  30321. ><TR
  30322. ><TD
  30323. ><DIV
  30324. CLASS="example"
  30325. ><A
  30326. NAME="AEN5228"
  30327. ></A
  30328. ><P
  30329. ><B
  30330. >Beispiel 18-11. Interface example</B
  30331. ></P
  30332. ><TABLE
  30333. BORDER="0"
  30334. BGCOLOR="#E0E0E0"
  30335. CELLPADDING="5"
  30336. ><TR
  30337. ><TD
  30338. ><PRE
  30339. CLASS="php"
  30340. ><?php
  30341. interface ITemplate
  30342. {
  30343.   public function setVariable($name, $var);
  30344.   public function getHtml($template);
  30345. }
  30346.  
  30347. class Template implements ITemplate
  30348. {
  30349.   private $vars = array();
  30350.   
  30351.   public function setVariable($name, $var)
  30352.   {
  30353.     $this->vars[$name] = $var;
  30354.   }
  30355.   
  30356.   public function getHtml($template)
  30357.   {
  30358.     foreach($this->vars as $name => $value) {
  30359.       $template = str_replace('{'.$name.'}', $value, $template);
  30360.     }
  30361.     
  30362.     return $template;
  30363.   }
  30364. }
  30365. ?></PRE
  30366. ></TD
  30367. ></TR
  30368. ></TABLE
  30369. ></DIV
  30370. ></TD
  30371. ></TR
  30372. ></TABLE
  30373. ></DIV
  30374. ><DIV
  30375. CLASS="sect1"
  30376. ><HR><H2
  30377. CLASS="sect1"
  30378. ><A
  30379. NAME="language.oop5.overloading"
  30380. >Overloading</A
  30381. ></H2
  30382. ><P
  30383. >    Both method calls and member accesses can be overloaded via the
  30384.    __call, __get and __set methods. These methods will only be
  30385.    triggered when your object or inherited object doesn't contain the 
  30386.    member or method you're trying to access.
  30387.   </P
  30388. ><DIV
  30389. CLASS="sect2"
  30390. ><HR><H3
  30391. CLASS="sect2"
  30392. ><A
  30393. NAME="language.oop5.overloading.members"
  30394. >Member overloading</A
  30395. ></H3
  30396. >void <B
  30397. CLASS="methodname"
  30398. >__set</B
  30399. > ( string name, mixed value)<BR
  30400. ></BR
  30401. >void <B
  30402. CLASS="methodname"
  30403. >__get</B
  30404. > ( mixed name)<BR
  30405. ></BR
  30406. ><P
  30407. >     Class members can be overloaded to run custom code defined in your class
  30408.     by defining these specially named methods. The <VAR
  30409. CLASS="varname"
  30410. >$name</VAR
  30411. > 
  30412.     parameter used is the name of the variable that should be set or retrieved.
  30413.     The __set() method's <VAR
  30414. CLASS="varname"
  30415. >$value</VAR
  30416. > parameter specifies the 
  30417.     value that the object should set set the <VAR
  30418. CLASS="varname"
  30419. >$name</VAR
  30420. >.
  30421.    </P
  30422. ><TABLE
  30423. WIDTH="100%"
  30424. BORDER="0"
  30425. CELLPADDING="0"
  30426. CELLSPACING="0"
  30427. CLASS="EXAMPLE"
  30428. ><TR
  30429. ><TD
  30430. ><DIV
  30431. CLASS="example"
  30432. ><A
  30433. NAME="AEN5255"
  30434. ></A
  30435. ><P
  30436. ><B
  30437. >Beispiel 18-12. overloading with __get and __set example</B
  30438. ></P
  30439. ><TABLE
  30440. BORDER="0"
  30441. BGCOLOR="#E0E0E0"
  30442. CELLPADDING="5"
  30443. ><TR
  30444. ><TD
  30445. ><PRE
  30446. CLASS="php"
  30447. ><?php
  30448. class Setter {
  30449.   public $n;
  30450.   private $x = array("a" => 1, "b" => 2, "c" => 3);
  30451.  
  30452.   function __get($nm) {
  30453.     print "Getting [$nm]\n";
  30454.  
  30455.     if (isset($this->x[$nm])) {
  30456.       $r = $this->x[$nm];
  30457.       print "Returning: $r\n";
  30458.       return $r;
  30459.     } else {
  30460.       print "Nothing!\n";
  30461.     }
  30462.   }
  30463.  
  30464.   function __set($nm, $val) {
  30465.     print "Setting [$nm] to $val\n";
  30466.  
  30467.     if (isset($this->x[$nm])) {
  30468.       $this->x[$nm] = $val;
  30469.       print "OK!\n";
  30470.     } else {
  30471.       print "Not OK!\n";
  30472.     }
  30473.   }
  30474. }
  30475.  
  30476. $foo = new Setter();
  30477. $foo->n = 1;
  30478. $foo->a = 100;
  30479. $foo->a++;
  30480. $foo->z++;
  30481. var_dump($foo);
  30482. ?></PRE
  30483. ></TD
  30484. ></TR
  30485. ></TABLE
  30486. ><P
  30487. >      Will output:
  30488.     </P
  30489. ><TABLE
  30490. BORDER="0"
  30491. BGCOLOR="#E0E0E0"
  30492. CELLPADDING="5"
  30493. ><TR
  30494. ><TD
  30495. ><PRE
  30496. CLASS="php"
  30497. >Setting [a] to 100
  30498. OK!
  30499. Getting [a]
  30500. Returning: 100
  30501. Setting [a] to 101
  30502. OK!
  30503. Getting [z]
  30504. Nothing!
  30505. Setting [z] to 1
  30506. Not OK!
  30507. object(Setter)#1 (2) {
  30508.   ["n"]=>
  30509.   int(1)
  30510.   ["x:private"]=>
  30511.   array(3) {
  30512.     ["a"]=>
  30513.     int(101)
  30514.     ["b"]=>
  30515.     int(2)
  30516.     ["c"]=>
  30517.     int(3)
  30518.   }
  30519. }</PRE
  30520. ></TD
  30521. ></TR
  30522. ></TABLE
  30523. ></DIV
  30524. ></TD
  30525. ></TR
  30526. ></TABLE
  30527. ></DIV
  30528. ><DIV
  30529. CLASS="sect2"
  30530. ><HR><H3
  30531. CLASS="sect2"
  30532. ><A
  30533. NAME="language.oop5.overloading.methods"
  30534. >Method overloading</A
  30535. ></H3
  30536. >mixed <B
  30537. CLASS="methodname"
  30538. >__call</B
  30539. > ( string name, array arguments)<BR
  30540. ></BR
  30541. ><P
  30542. >     Class methods can be overloaded to run custom code defined in your class
  30543.     by defining this specially named method. The <VAR
  30544. CLASS="varname"
  30545. >$name</VAR
  30546. > 
  30547.     parameter used is the name as the function name that was requested 
  30548.     to be used. The arguments that were passed in the function will be 
  30549.     defined as an array in the <VAR
  30550. CLASS="varname"
  30551. >$arguments</VAR
  30552. > parameter.
  30553.     The value returned from the __call() method will be returned to the
  30554.     caller of the method.
  30555.    </P
  30556. ><TABLE
  30557. WIDTH="100%"
  30558. BORDER="0"
  30559. CELLPADDING="0"
  30560. CELLSPACING="0"
  30561. CLASS="EXAMPLE"
  30562. ><TR
  30563. ><TD
  30564. ><DIV
  30565. CLASS="example"
  30566. ><A
  30567. NAME="AEN5274"
  30568. ></A
  30569. ><P
  30570. ><B
  30571. >Beispiel 18-13. overloading with __call example</B
  30572. ></P
  30573. ><TABLE
  30574. BORDER="0"
  30575. BGCOLOR="#E0E0E0"
  30576. CELLPADDING="5"
  30577. ><TR
  30578. ><TD
  30579. ><PRE
  30580. CLASS="php"
  30581. ><?php
  30582. class Caller {
  30583.   private $x = array(1, 2, 3);
  30584.  
  30585.   function __call($m, $a) {
  30586.     print "Method $m called:\n";
  30587.     var_dump($a);
  30588.     return $this->x;
  30589.   }
  30590. }
  30591.  
  30592. $foo = new Caller();
  30593. $a = $foo->test(1, "2", 3.4, true);
  30594. var_dump($a);
  30595. ?></PRE
  30596. ></TD
  30597. ></TR
  30598. ></TABLE
  30599. ><P
  30600. >      Will Output:
  30601.     </P
  30602. ><TABLE
  30603. BORDER="0"
  30604. BGCOLOR="#E0E0E0"
  30605. CELLPADDING="5"
  30606. ><TR
  30607. ><TD
  30608. ><PRE
  30609. CLASS="php"
  30610. >Method test called:
  30611. array(4) {
  30612.   [0]=>
  30613.   int(1)
  30614.   [1]=>
  30615.   string(1) "2"
  30616.   [2]=>
  30617.   float(3.4)
  30618.   [3]=>
  30619.   bool(true)
  30620. }
  30621. array(3) {
  30622.   [0]=>
  30623.   int(1)
  30624.   [1]=>
  30625.   int(2)
  30626.   [2]=>
  30627.   int(3)
  30628. }</PRE
  30629. ></TD
  30630. ></TR
  30631. ></TABLE
  30632. ></DIV
  30633. ></TD
  30634. ></TR
  30635. ></TABLE
  30636. ></DIV
  30637. ></DIV
  30638. ><DIV
  30639. CLASS="sect1"
  30640. ><HR><H2
  30641. CLASS="sect1"
  30642. ><A
  30643. NAME="language.oop5.iterations"
  30644. >Object Iteration</A
  30645. ></H2
  30646. ><P
  30647. >    PHP 5 provides a way for objects to be defined so it is possible
  30648.    to iterate through a list of items, with, for example a <A
  30649. HREF="#control-structures.foreach"
  30650. >Abschnitt namens <I
  30651. ><VAR
  30652. CLASS="literal"
  30653. >foreach</VAR
  30654. ></I
  30655. > in Kapitel 15</A
  30656. > statement. By default, all
  30657.    public properties will be used for the iteration.
  30658.   </P
  30659. ><TABLE
  30660. WIDTH="100%"
  30661. BORDER="0"
  30662. CELLPADDING="0"
  30663. CELLSPACING="0"
  30664. CLASS="EXAMPLE"
  30665. ><TR
  30666. ><TD
  30667. ><DIV
  30668. CLASS="example"
  30669. ><A
  30670. NAME="AEN5283"
  30671. ></A
  30672. ><P
  30673. ><B
  30674. >Beispiel 18-14. Simple Object Iteration</B
  30675. ></P
  30676. ><TABLE
  30677. BORDER="0"
  30678. BGCOLOR="#E0E0E0"
  30679. CELLPADDING="5"
  30680. ><TR
  30681. ><TD
  30682. ><PRE
  30683. CLASS="php"
  30684. ><?php
  30685.  
  30686. class MyClass {
  30687.   public $var1 = 'value 1';
  30688.   public $var2 = 'value 2';
  30689.   public $var3 = 'value 3';
  30690.  
  30691.   protected $protected = 'protected';
  30692.   private   $private   = 'private';
  30693.  
  30694. }
  30695.  
  30696. $class = new MyClass();
  30697.  
  30698. foreach($class as $key => $value) {
  30699.   print "$key => $value\n";
  30700. }</PRE
  30701. ></TD
  30702. ></TR
  30703. ></TABLE
  30704. ><P
  30705. >      Will output:
  30706.    </P
  30707. ><TABLE
  30708. BORDER="0"
  30709. BGCOLOR="#E0E0E0"
  30710. CELLPADDING="5"
  30711. ><TR
  30712. ><TD
  30713. ><PRE
  30714. CLASS="php"
  30715. >var1 => value 1
  30716. var2 => value 2
  30717. var3 => value 3</PRE
  30718. ></TD
  30719. ></TR
  30720. ></TABLE
  30721. ></DIV
  30722. ></TD
  30723. ></TR
  30724. ></TABLE
  30725. ><P
  30726. >   As the output shows, the <A
  30727. HREF="#control-structures.foreach"
  30728. >Abschnitt namens <I
  30729. ><VAR
  30730. CLASS="literal"
  30731. >foreach</VAR
  30732. ></I
  30733. > in Kapitel 15</A
  30734. >
  30735.   iterated through each public variable that is defined. To take it 
  30736.   a step further you can <VAR
  30737. CLASS="varname"
  30738. >implement</VAR
  30739. > one of PHP 5's 
  30740.   internal <A
  30741. HREF="#language.oop5.interfaces"
  30742. >Abschnitt namens <I
  30743. >Object Interfaces</I
  30744. ></A
  30745. > named
  30746.   <VAR
  30747. CLASS="varname"
  30748. >Iterator</VAR
  30749. >. This allows the object to decide what
  30750.   and how the object will be iterated.
  30751.  </P
  30752. ><TABLE
  30753. WIDTH="100%"
  30754. BORDER="0"
  30755. CELLPADDING="0"
  30756. CELLSPACING="0"
  30757. CLASS="EXAMPLE"
  30758. ><TR
  30759. ><TD
  30760. ><DIV
  30761. CLASS="example"
  30762. ><A
  30763. NAME="AEN5293"
  30764. ></A
  30765. ><P
  30766. ><B
  30767. >Beispiel 18-15. Object Iteration implenting Iterator</B
  30768. ></P
  30769. ><TABLE
  30770. BORDER="0"
  30771. BGCOLOR="#E0E0E0"
  30772. CELLPADDING="5"
  30773. ><TR
  30774. ><TD
  30775. ><PRE
  30776. CLASS="php"
  30777. ><?php
  30778. class MyIterator implements Iterator {
  30779.  
  30780.   private $var = array();
  30781.  
  30782.   public function __construct($array) {
  30783.     if (is_array($array) ) {
  30784.       $this->var = $array;
  30785.     }
  30786.   }
  30787.  
  30788.   public function rewind() {
  30789.     echo "rewinding\n";
  30790.     reset($this->var);
  30791.   }
  30792.  
  30793.   public function current() {
  30794.     $var = current($this->var);
  30795.     echo "current: $var\n";
  30796.     return $var;
  30797.   }
  30798.  
  30799.   public function key() {
  30800.     $var = key($this->var);
  30801.     echo "key: $var\n";
  30802.     return $var;
  30803.   }
  30804.  
  30805.   public function next() {
  30806.     $var = next($this->var);
  30807.     echo "next: $var\n";
  30808.     return $var;
  30809.   }
  30810.  
  30811.   public function valid() {
  30812.     $var = $this->current() !== false;
  30813.     echo "valid: {$var}\n";
  30814.     return $var;
  30815.   }
  30816.  
  30817. }
  30818.  
  30819. $values = array(1,2,3);
  30820. $it = new MyIterator($values);
  30821.  
  30822. foreach ($it as $a => $b) {
  30823.   print "$a: $b\n";
  30824. }</PRE
  30825. ></TD
  30826. ></TR
  30827. ></TABLE
  30828. ><P
  30829. >      Will output:
  30830.    </P
  30831. ><TABLE
  30832. BORDER="0"
  30833. BGCOLOR="#E0E0E0"
  30834. CELLPADDING="5"
  30835. ><TR
  30836. ><TD
  30837. ><PRE
  30838. CLASS="php"
  30839. >rewinding
  30840. current: 1
  30841. valid: 1
  30842. current: 1
  30843. key: 0
  30844. 0: 1
  30845. next: 2
  30846. current: 2
  30847. valid: 1
  30848. current: 2
  30849. key: 1
  30850. 1: 2
  30851. next: 3
  30852. current: 3
  30853. valid: 1
  30854. current: 3
  30855. key: 2
  30856. 2: 3
  30857. next:
  30858. current:
  30859. valid:</PRE
  30860. ></TD
  30861. ></TR
  30862. ></TABLE
  30863. ></DIV
  30864. ></TD
  30865. ></TR
  30866. ></TABLE
  30867. ><P
  30868. >    You can also define your class so that it doesn't have to define
  30869.    all the <VAR
  30870. CLASS="varname"
  30871. >Iterator</VAR
  30872. > functions by simply implementing
  30873.    the PHP 5 <VAR
  30874. CLASS="varname"
  30875. >IteratorAggregate</VAR
  30876. > interface.
  30877.   </P
  30878. ><TABLE
  30879. WIDTH="100%"
  30880. BORDER="0"
  30881. CELLPADDING="0"
  30882. CELLSPACING="0"
  30883. CLASS="EXAMPLE"
  30884. ><TR
  30885. ><TD
  30886. ><DIV
  30887. CLASS="example"
  30888. ><A
  30889. NAME="AEN5301"
  30890. ></A
  30891. ><P
  30892. ><B
  30893. >Beispiel 18-16. Object Iteration implenting IteratorAggregate</B
  30894. ></P
  30895. ><TABLE
  30896. BORDER="0"
  30897. BGCOLOR="#E0E0E0"
  30898. CELLPADDING="5"
  30899. ><TR
  30900. ><TD
  30901. ><PRE
  30902. CLASS="php"
  30903. ><?php
  30904. class MyCollection implements IteratorAggregate {
  30905.   private $items = array();
  30906.   private $count = 0;
  30907.  
  30908.   /* Required definition of interface IteratorAggregate */
  30909.   public function getIterator() {
  30910.     return new MyIterator($this->items);
  30911.   }
  30912.  
  30913.   public function add($value) {
  30914.     $this->items[$this->count++] = $value;
  30915.   }
  30916.  
  30917. }
  30918.  
  30919. $coll = new MyCollection();
  30920. $coll->add('value 1');
  30921. $coll->add('value 2');
  30922. $coll->add('value 3');
  30923.  
  30924. foreach ($coll as $key => $val) {
  30925.   echo "key/value: [$key -> $val]\n\n";
  30926. }
  30927.  
  30928. ?>
  30929. </pre></PRE
  30930. ></TD
  30931. ></TR
  30932. ></TABLE
  30933. ><P
  30934. >      Will output:
  30935.    </P
  30936. ><TABLE
  30937. BORDER="0"
  30938. BGCOLOR="#E0E0E0"
  30939. CELLPADDING="5"
  30940. ><TR
  30941. ><TD
  30942. ><PRE
  30943. CLASS="php"
  30944. >rewinding
  30945. current: value 1
  30946. valid: 1
  30947. current: value 1
  30948. key: 0
  30949. key/value: [0 -> value 1]
  30950.  
  30951. next: value 2
  30952. current: value 2
  30953. valid: 1
  30954. current: value 2
  30955. key: 1
  30956. key/value: [1 -> value 2]
  30957.  
  30958. next: value 3
  30959. current: value 3
  30960. valid: 1
  30961. current: value 3
  30962. key: 2
  30963. key/value: [2 -> value 3]
  30964.  
  30965. next:
  30966. current:
  30967. valid:</PRE
  30968. ></TD
  30969. ></TR
  30970. ></TABLE
  30971. ></DIV
  30972. ></TD
  30973. ></TR
  30974. ></TABLE
  30975. ></DIV
  30976. ><DIV
  30977. CLASS="sect1"
  30978. ><HR><H2
  30979. CLASS="sect1"
  30980. ><A
  30981. NAME="language.oop5.magic"
  30982. >Magic Methods</A
  30983. ></H2
  30984. ><P
  30985. >    .
  30986.   </P
  30987. ></DIV
  30988. ><DIV
  30989. CLASS="sect1"
  30990. ><HR><H2
  30991. CLASS="sect1"
  30992. ><A
  30993. NAME="language.oop5.final"
  30994. >Final Keyword</A
  30995. ></H2
  30996. ><P
  30997. >    PHP 5 introduces the final keyword, which prevents child classes from
  30998.    overriding a method or variable by prefixing the definition with final.
  30999.   </P
  31000. ><TABLE
  31001. WIDTH="100%"
  31002. BORDER="0"
  31003. CELLPADDING="0"
  31004. CELLSPACING="0"
  31005. CLASS="EXAMPLE"
  31006. ><TR
  31007. ><TD
  31008. ><DIV
  31009. CLASS="example"
  31010. ><A
  31011. NAME="AEN5312"
  31012. ></A
  31013. ><P
  31014. ><B
  31015. >Beispiel 18-17. Final methods example</B
  31016. ></P
  31017. ><TABLE
  31018. BORDER="0"
  31019. BGCOLOR="#E0E0E0"
  31020. CELLPADDING="5"
  31021. ><TR
  31022. ><TD
  31023. ><PRE
  31024. CLASS="php"
  31025. ><?php
  31026. class BaseClass {
  31027.    public function test() {
  31028.        echo "BaseClass::test() called\n";
  31029.    }
  31030.    
  31031.    final public function moreTesting() {
  31032.        echo "BaseClass::moreTesting() called\n";
  31033.    }
  31034. }
  31035.  
  31036. class ChildClass extends BaseClass {
  31037.    public function moreTesting() {
  31038.        echo "ChildClass::moreTesting() called\n";
  31039.    }
  31040. }
  31041. // Results in Fatal error: Cannot override final method BaseClass::moreTesting()
  31042. ?></PRE
  31043. ></TD
  31044. ></TR
  31045. ></TABLE
  31046. ></DIV
  31047. ></TD
  31048. ></TR
  31049. ></TABLE
  31050. ></DIV
  31051. ><DIV
  31052. CLASS="sect1"
  31053. ><HR><H2
  31054. CLASS="sect1"
  31055. ><A
  31056. NAME="language.oop5.cloning"
  31057. >Object cloning</A
  31058. ></H2
  31059. ><P
  31060. >    Creating a copy of an object with fully replicated properties is not
  31061.    always the wanted behavior. A good example of the need for copy
  31062.    constructors, is if you have an object which represents a GTK window and the
  31063.    object holds the resource of this GTK window, when you create a duplicate
  31064.    you might want to create a new window with the same properties and have the
  31065.    new object hold the resource of the new window. Another example is if your
  31066.    object holds a reference to another object which it uses and when you
  31067.    replicate the parent object you want to create a new instance of this other
  31068.    object so that the replica has its own separate copy.
  31069.   </P
  31070. ><P
  31071. >    An object copy is created by using the clone keyword (which calls the
  31072.    object's __clone() method if possible). An object's __clone()  method
  31073.    cannot be called directly.
  31074.   </P
  31075. ><DIV
  31076. CLASS="informalexample"
  31077. ><P
  31078. ></P
  31079. ><A
  31080. NAME="AEN5319"
  31081. ></A
  31082. ><TABLE
  31083. BORDER="0"
  31084. BGCOLOR="#E0E0E0"
  31085. CELLPADDING="5"
  31086. ><TR
  31087. ><TD
  31088. ><PRE
  31089. CLASS="programlisting"
  31090. >$copy_of_object = clone $object;</PRE
  31091. ></TD
  31092. ></TR
  31093. ></TABLE
  31094. ><P
  31095. ></P
  31096. ></DIV
  31097. ><P
  31098. >
  31099.    When an object is cloned, PHP 5 will perform a shallow copy of all of the
  31100.    object's properties. Any properties that are references to other variables,
  31101.    will remain references. If a __clone() method is defined, then the newly
  31102.    created  object's __clone() method will be called, to allow any necessary
  31103.    properties that need to be changed.
  31104.  
  31105.   </P
  31106. ><TABLE
  31107. WIDTH="100%"
  31108. BORDER="0"
  31109. CELLPADDING="0"
  31110. CELLSPACING="0"
  31111. CLASS="EXAMPLE"
  31112. ><TR
  31113. ><TD
  31114. ><DIV
  31115. CLASS="example"
  31116. ><A
  31117. NAME="AEN5322"
  31118. ></A
  31119. ><P
  31120. ><B
  31121. >Beispiel 18-18. Cloning an object</B
  31122. ></P
  31123. ><TABLE
  31124. BORDER="0"
  31125. BGCOLOR="#E0E0E0"
  31126. CELLPADDING="5"
  31127. ><TR
  31128. ><TD
  31129. ><PRE
  31130. CLASS="php"
  31131. ><?php
  31132.  
  31133. class SubObject {
  31134.   static $instances = 0;
  31135.   public $instance;
  31136.  
  31137.   public function __construct() {
  31138.     $this->instance = ++self::$instances;
  31139.   }
  31140.  
  31141.   public function __clone() {
  31142.     $this->instance = ++self::$instances;
  31143.   }
  31144. }
  31145.  
  31146. class MyCloneable {
  31147.  
  31148.   public $object1;
  31149.   public $object2;
  31150.  
  31151.   function __clone() {
  31152.     
  31153.     // Force a copy of this->object, otherwise
  31154.     // it will point to same object.
  31155.     $this->object1 = clone($this->object1);
  31156.   }
  31157. }
  31158.  
  31159. $obj = new MyCloneable();
  31160.  
  31161. $obj->object1 = new SubObject();
  31162. $obj->object2 = new SubObject();
  31163.  
  31164. $obj2 = clone $obj;
  31165.  
  31166.  
  31167. print("Original Object:\n");
  31168. print_r($obj);
  31169.  
  31170. print("Cloned Object:\n");
  31171. print_r($obj2);
  31172.  
  31173. ?></PRE
  31174. ></TD
  31175. ></TR
  31176. ></TABLE
  31177. ><P
  31178. >The above example will output:</P
  31179. ><TABLE
  31180. BORDER="0"
  31181. BGCOLOR="#E0E0E0"
  31182. CELLPADDING="5"
  31183. ><TR
  31184. ><TD
  31185. ><PRE
  31186. CLASS="php"
  31187. >Original Object:
  31188. MyCloneable Object
  31189. (
  31190.     [object1] => SubObject Object
  31191.         (
  31192.             [instance] => 1
  31193.         )
  31194.  
  31195.     [object2] => SubObject Object
  31196.         (
  31197.             [instance] => 2
  31198.         )
  31199.  
  31200. )
  31201. Cloned Object:
  31202. MyCloneable Object
  31203. (
  31204.     [object1] => SubObject Object
  31205.         (
  31206.             [instance] => 3
  31207.         )
  31208.  
  31209.     [object2] => SubObject Object
  31210.         (
  31211.             [instance] => 2
  31212.         )
  31213.  
  31214. )</PRE
  31215. ></TD
  31216. ></TR
  31217. ></TABLE
  31218. ></DIV
  31219. ></TD
  31220. ></TR
  31221. ></TABLE
  31222. ></DIV
  31223. ><DIV
  31224. CLASS="sect1"
  31225. ><HR><H2
  31226. CLASS="sect1"
  31227. ><A
  31228. NAME="language.oop5.object-comparison"
  31229. >Comparing objects</A
  31230. ></H2
  31231. ><P
  31232. >     In PHP 5, object comparison is more complicated than in PHP 4 and more
  31233.     in accordance to what one will expect from an Object Oriented Language
  31234.     (not that PHP 5 is such a language).
  31235.    </P
  31236. ><P
  31237. >     When using the comparison operator (<VAR
  31238. CLASS="literal"
  31239. >==</VAR
  31240. >), 
  31241.     object variables are compared in a simple manner, namely: Two object
  31242.     instances are equal if they have the same attributes and values, and are
  31243.     instances of the same class.
  31244.    </P
  31245. ><P
  31246. >     On the other hand, when using the identity operator (<VAR
  31247. CLASS="literal"
  31248. >===</VAR
  31249. >),
  31250.     object variables are identical if and only if they refer to the same
  31251.     instance of the same class.
  31252.    </P
  31253. ><P
  31254. >     An example will clarify these rules.
  31255.     <TABLE
  31256. WIDTH="100%"
  31257. BORDER="0"
  31258. CELLPADDING="0"
  31259. CELLSPACING="0"
  31260. CLASS="EXAMPLE"
  31261. ><TR
  31262. ><TD
  31263. ><DIV
  31264. CLASS="example"
  31265. ><A
  31266. NAME="AEN5335"
  31267. ></A
  31268. ><P
  31269. ><B
  31270. >Beispiel 18-19. Example of object comparison in PHP 5</B
  31271. ></P
  31272. ><TABLE
  31273. BORDER="0"
  31274. BGCOLOR="#E0E0E0"
  31275. CELLPADDING="5"
  31276. ><TR
  31277. ><TD
  31278. ><PRE
  31279. CLASS="php"
  31280. ><?php
  31281. function bool2str($bool) {
  31282.     if ($bool === false) {
  31283.             return 'FALSE';
  31284.     } else {
  31285.             return 'TRUE';
  31286.     }
  31287. }
  31288.  
  31289. function compareObjects(&$o1, &$o2) {
  31290.     echo 'o1 == o2 : '.bool2str($o1 == $o2)."\n";
  31291.     echo 'o1 != o2 : '.bool2str($o1 != $o2)."\n";
  31292.     echo 'o1 === o2 : '.bool2str($o1 === $o2)."\n";
  31293.     echo 'o1 !== o2 : '.bool2str($o1 !== $o2)."\n";
  31294. }
  31295.  
  31296. class Flag {
  31297.     var $flag;
  31298.  
  31299.     function Flag($flag=true) {
  31300.             $this->flag = $flag;
  31301.     }
  31302. }
  31303.  
  31304. class OtherFlag {
  31305.     var $flag;
  31306.  
  31307.     function OtherFlag($flag=true) {
  31308.             $this->flag = $flag;
  31309.     }
  31310. }
  31311.  
  31312. $o = new Flag();
  31313. $p = new Flag();
  31314. $q = $o;
  31315. $r = new OtherFlag();
  31316.  
  31317. echo "Two instances of the same class\n";
  31318. compareObjects($o, $p);
  31319.  
  31320. echo "\nTwo references to the same instance\n";
  31321. compareObjects($o, $q);
  31322.  
  31323. echo "\nInstances of two different classes\n";
  31324. compareObjects($o, $r);
  31325. ?></PRE
  31326. ></TD
  31327. ></TR
  31328. ></TABLE
  31329. ></DIV
  31330. ></TD
  31331. ></TR
  31332. ></TABLE
  31333. >
  31334.     This example will output:
  31335.     <TABLE
  31336. BORDER="0"
  31337. BGCOLOR="#E0E0E0"
  31338. CELLPADDING="5"
  31339. ><TR
  31340. ><TD
  31341. ><PRE
  31342. CLASS="screen"
  31343. >Two instances of the same class
  31344. o1 == o2 : TRUE
  31345. o1 != o2 : FALSE
  31346. o1 === o2 : FALSE
  31347. o1 !== o2 : TRUE
  31348.  
  31349. Two references to the same instance
  31350. o1 == o2 : TRUE
  31351. o1 != o2 : FALSE
  31352. o1 === o2 : TRUE
  31353. o1 !== o2 : FALSE
  31354.  
  31355. Instances of two different classes
  31356. o1 == o2 : FALSE
  31357. o1 != o2 : TRUE
  31358. o1 === o2 : FALSE
  31359. o1 !== o2 : TRUE</PRE
  31360. ></TD
  31361. ></TR
  31362. ></TABLE
  31363. >
  31364.    </P
  31365. ></DIV
  31366. ><DIV
  31367. CLASS="sect1"
  31368. ><HR><H2
  31369. CLASS="sect1"
  31370. ><A
  31371. NAME="language.oop5.reflection"
  31372. >Reflection</A
  31373. ></H2
  31374. ><DIV
  31375. CLASS="sect2"
  31376. ><H3
  31377. CLASS="sect2"
  31378. ><A
  31379. NAME="language.oop5.reflection.introduction"
  31380. >Introduction</A
  31381. ></H3
  31382. ><P
  31383. >     PHP 5 comes with a complete reflection API that adds the ability to
  31384.     reverse-engineer classes, interfaces, functions and methods as well
  31385.     as extensions. Additionally, the reflection API also offers ways of 
  31386.     retrieving doc comments for functions, classes and methods.
  31387.    </P
  31388. ><P
  31389. >     The reflection API is an object-oriented extension to the Zend Engine,
  31390.     consisting of the following classes:
  31391.    </P
  31392. ><DIV
  31393. CLASS="informalexample"
  31394. ><P
  31395. ></P
  31396. ><A
  31397. NAME="AEN5345"
  31398. ></A
  31399. ><TABLE
  31400. BORDER="0"
  31401. BGCOLOR="#E0E0E0"
  31402. CELLPADDING="5"
  31403. ><TR
  31404. ><TD
  31405. ><PRE
  31406. CLASS="php"
  31407. ><?php
  31408.   class Reflection { }
  31409.   interface Reflector { }
  31410.   class ReflectionException extends Exception { }
  31411.   class ReflectionFunction implements Reflector { }
  31412.   class ReflectionParameter implements Reflector { }
  31413.   class ReflectionMethod extends ReflectionFunction { }
  31414.   class ReflectionClass implements Reflector { }
  31415.   class ReflectionObject extends ReflectionClass { }
  31416.   class ReflectionProperty implements Reflector { }
  31417.   class ReflectionExtension implements Reflector { }
  31418. ?></PRE
  31419. ></TD
  31420. ></TR
  31421. ></TABLE
  31422. ><P
  31423. ></P
  31424. ></DIV
  31425. ><DIV
  31426. CLASS="note"
  31427. ><BLOCKQUOTE
  31428. CLASS="note"
  31429. ><P
  31430. ><B
  31431. >Anmerkung: </B
  31432. >
  31433.      For details on these classes, have a look at the next chapters.
  31434.     </P
  31435. ></BLOCKQUOTE
  31436. ></DIV
  31437. ><P
  31438. >     If we were to execute the code in the example below:
  31439.     <TABLE
  31440. WIDTH="100%"
  31441. BORDER="0"
  31442. CELLPADDING="0"
  31443. CELLSPACING="0"
  31444. CLASS="EXAMPLE"
  31445. ><TR
  31446. ><TD
  31447. ><DIV
  31448. CLASS="example"
  31449. ><A
  31450. NAME="AEN5350"
  31451. ></A
  31452. ><P
  31453. ><B
  31454. >Beispiel 18-20. Basic usage of the reflection API</B
  31455. ></P
  31456. ><TABLE
  31457. BORDER="0"
  31458. BGCOLOR="#E0E0E0"
  31459. CELLPADDING="5"
  31460. ><TR
  31461. ><TD
  31462. ><PRE
  31463. CLASS="php"
  31464. ><?php
  31465.   Reflection::export(new ReflectionClass('Exception'));
  31466. ?></PRE
  31467. ></TD
  31468. ></TR
  31469. ></TABLE
  31470. ></DIV
  31471. ></TD
  31472. ></TR
  31473. ></TABLE
  31474. >
  31475.     We will see:
  31476.     <TABLE
  31477. BORDER="0"
  31478. BGCOLOR="#E0E0E0"
  31479. CELLPADDING="5"
  31480. ><TR
  31481. ><TD
  31482. ><PRE
  31483. CLASS="screen"
  31484. >Class [ <internal> class Exception ] {
  31485.  
  31486.   - Constants [0] {
  31487.   }
  31488.  
  31489.   - Static properties [0] {
  31490.   }
  31491.  
  31492.   - Static methods [0] {
  31493.   }
  31494.  
  31495.   - Properties [6] {
  31496.     Property [ <default> protected $message ]
  31497.     Property [ <default> private $string ]
  31498.     Property [ <default> protected $code ]
  31499.     Property [ <default> protected $file ]
  31500.     Property [ <default> protected $line ]
  31501.     Property [ <default> private $trace ]
  31502.   }
  31503.  
  31504.   - Methods [9] {
  31505.     Method [ <internal> final private method __clone ] {
  31506.     }
  31507.  
  31508.     Method [ <internal> <ctor> method __construct ] {
  31509.     }
  31510.  
  31511.     Method [ <internal> final public method getMessage ] {
  31512.     }
  31513.  
  31514.     Method [ <internal> final public method getCode ] {
  31515.     }
  31516.  
  31517.     Method [ <internal> final public method getFile ] {
  31518.     }
  31519.  
  31520.     Method [ <internal> final public method getLine ] {
  31521.     }
  31522.  
  31523.     Method [ <internal> final public method getTrace ] {
  31524.     }
  31525.  
  31526.     Method [ <internal> final public method getTraceAsString ] {
  31527.     }
  31528.  
  31529.     Method [ <internal> public method __toString ] {
  31530.     }
  31531.   }
  31532. }</PRE
  31533. ></TD
  31534. ></TR
  31535. ></TABLE
  31536. >
  31537.    </P
  31538. ></DIV
  31539. ><DIV
  31540. CLASS="sect2"
  31541. ><HR><H3
  31542. CLASS="sect2"
  31543. ><A
  31544. NAME="language.oop5.reflection.reflectionfunction"
  31545. ><B
  31546. CLASS="classname"
  31547. >ReflectionFunction</B
  31548. ></A
  31549. ></H3
  31550. ><P
  31551. >     The <B
  31552. CLASS="classname"
  31553. >ReflectionFunction</B
  31554. > class lets you
  31555.     reverse-engineer functions.
  31556.    </P
  31557. ><DIV
  31558. CLASS="informalexample"
  31559. ><P
  31560. ></P
  31561. ><A
  31562. NAME="AEN5359"
  31563. ></A
  31564. ><TABLE
  31565. BORDER="0"
  31566. BGCOLOR="#E0E0E0"
  31567. CELLPADDING="5"
  31568. ><TR
  31569. ><TD
  31570. ><PRE
  31571. CLASS="php"
  31572. ><?php
  31573.   class ReflectionFunction implements Reflector {
  31574.       public object __construct(string name)
  31575.       public string __toString()
  31576.       public static string export()
  31577.       public string getName()
  31578.       public bool isInternal()
  31579.       public bool isUserDefined()
  31580.       public string getFileName()
  31581.       public int getStartLine()
  31582.       public int getEndLine()
  31583.       public string getDocComment()
  31584.       public array getStaticVariables()
  31585.       public mixed invoke(mixed* args)
  31586.       public bool returnsReference()
  31587.       public ReflectionParameter[] getParameters()
  31588.   }
  31589. ?></PRE
  31590. ></TD
  31591. ></TR
  31592. ></TABLE
  31593. ><P
  31594. ></P
  31595. ></DIV
  31596. ><P
  31597. >     To introspect a function, you will first have to create an instance
  31598.     of the <B
  31599. CLASS="classname"
  31600. >ReflectionFunction</B
  31601. > class. You can then call
  31602.     any of the above methods on this instance.
  31603.    </P
  31604. ><TABLE
  31605. WIDTH="100%"
  31606. BORDER="0"
  31607. CELLPADDING="0"
  31608. CELLSPACING="0"
  31609. CLASS="EXAMPLE"
  31610. ><TR
  31611. ><TD
  31612. ><DIV
  31613. CLASS="example"
  31614. ><A
  31615. NAME="AEN5363"
  31616. ></A
  31617. ><P
  31618. ><B
  31619. >Beispiel 18-21. Using the <B
  31620. CLASS="classname"
  31621. >ReflectionFunction</B
  31622. > class</B
  31623. ></P
  31624. ><TABLE
  31625. BORDER="0"
  31626. BGCOLOR="#E0E0E0"
  31627. CELLPADDING="5"
  31628. ><TR
  31629. ><TD
  31630. ><PRE
  31631. CLASS="php"
  31632. ><?php
  31633. /**
  31634.  * A simple counter
  31635.  *
  31636.  * @return    int
  31637.  */
  31638. function counter() 
  31639. {
  31640.     static $c = 0;
  31641.  
  31642.     return $c++;
  31643. }
  31644.  
  31645. // Create an instance of the Reflection_Function class
  31646. $func = new ReflectionFunction('counter');
  31647.  
  31648. // Print out basic information
  31649. printf(
  31650.     "===> The %s function '%s'\n".
  31651.     "     declared in %s\n".
  31652.     "     lines %d to %d\n",
  31653.     $func->isInternal() ? 'internal' : 'user-defined',
  31654.     $func->getName(),
  31655.     $func->getFileName(),
  31656.     $func->getStartLine(),
  31657.     $func->getEndline()
  31658. );
  31659.  
  31660. // Print documentation comment
  31661. printf("---> Documentation:\n %s\n", var_export($func->getDocComment(), 1));
  31662.  
  31663. // Print static variables if existant
  31664. if ($statics = $func->getStaticVariables())
  31665. {
  31666.     printf("---> Static variables: %s\n", var_export($statics, 1));
  31667. }
  31668.  
  31669. // Invoke the function
  31670. printf("---> Invokation results in: ");
  31671. var_dump($func->invoke());
  31672.  
  31673.  
  31674. // you may prefer to use the export() method
  31675. echo "\nReflectionFunction::export() results:\n";
  31676. echo ReflectionFunction::export('counter');
  31677. ?></PRE
  31678. ></TD
  31679. ></TR
  31680. ></TABLE
  31681. ></DIV
  31682. ></TD
  31683. ></TR
  31684. ></TABLE
  31685. ><DIV
  31686. CLASS="note"
  31687. ><BLOCKQUOTE
  31688. CLASS="note"
  31689. ><P
  31690. ><B
  31691. >Anmerkung: </B
  31692. >
  31693.      The method <B
  31694. CLASS="function"
  31695. >invoke()</B
  31696. > accepts a variable number of
  31697.      arguments which are passed to the function just as in
  31698.      <A
  31699. HREF="#function.call-user-func"
  31700. ><B
  31701. CLASS="function"
  31702. >call_user_func()</B
  31703. ></A
  31704. >.
  31705.     </P
  31706. ></BLOCKQUOTE
  31707. ></DIV
  31708. ></DIV
  31709. ><DIV
  31710. CLASS="sect2"
  31711. ><HR><H3
  31712. CLASS="sect2"
  31713. ><A
  31714. NAME="language.oop5.reflection.reflectionparameter"
  31715. ><B
  31716. CLASS="classname"
  31717. >ReflectionParameter</B
  31718. ></A
  31719. ></H3
  31720. ><P
  31721. >     The <B
  31722. CLASS="classname"
  31723. >ReflectionParameter</B
  31724. > class retrieves
  31725.     information about a function's or method's parameters.
  31726.    </P
  31727. ><DIV
  31728. CLASS="informalexample"
  31729. ><P
  31730. ></P
  31731. ><A
  31732. NAME="AEN5376"
  31733. ></A
  31734. ><TABLE
  31735. BORDER="0"
  31736. BGCOLOR="#E0E0E0"
  31737. CELLPADDING="5"
  31738. ><TR
  31739. ><TD
  31740. ><PRE
  31741. CLASS="php"
  31742. ><?php
  31743.   class ReflectionParameter implements Reflector {
  31744.       public object __construct(string name)
  31745.       public string __toString()
  31746.       public static string export()
  31747.       public string getName()
  31748.       public ReflectionClass getClass()
  31749.       public bool allowsNull()
  31750.       public bool isPassedByReference()
  31751.       public bool isOptional()
  31752.   }
  31753. ?></PRE
  31754. ></TD
  31755. ></TR
  31756. ></TABLE
  31757. ><P
  31758. ></P
  31759. ></DIV
  31760. ><DIV
  31761. CLASS="note"
  31762. ><BLOCKQUOTE
  31763. CLASS="note"
  31764. ><P
  31765. ><B
  31766. >Anmerkung: </B
  31767. >
  31768.      <B
  31769. CLASS="function"
  31770. >isOptional()</B
  31771. > was added in PHP 5.1.0.
  31772.     </P
  31773. ></BLOCKQUOTE
  31774. ></DIV
  31775. ><P
  31776. >     To introspect function parameters, you will first have to create an instance
  31777.     of the <B
  31778. CLASS="classname"
  31779. >ReflectionFunction</B
  31780. > or 
  31781.     <B
  31782. CLASS="classname"
  31783. >ReflectionMethod</B
  31784. > classes and then use their 
  31785.     <B
  31786. CLASS="function"
  31787. >getParameters()</B
  31788. > method to retrieve an array of parameters.
  31789.    </P
  31790. ><TABLE
  31791. WIDTH="100%"
  31792. BORDER="0"
  31793. CELLPADDING="0"
  31794. CELLSPACING="0"
  31795. CLASS="EXAMPLE"
  31796. ><TR
  31797. ><TD
  31798. ><DIV
  31799. CLASS="example"
  31800. ><A
  31801. NAME="AEN5385"
  31802. ></A
  31803. ><P
  31804. ><B
  31805. >Beispiel 18-22. Using the <B
  31806. CLASS="classname"
  31807. >ReflectionParameter</B
  31808. > class</B
  31809. ></P
  31810. ><TABLE
  31811. BORDER="0"
  31812. BGCOLOR="#E0E0E0"
  31813. CELLPADDING="5"
  31814. ><TR
  31815. ><TD
  31816. ><PRE
  31817. CLASS="php"
  31818. ><?php
  31819.     function foo($a, $b, $c) { }
  31820.     function bar(Exception $a, &$b, $c) { }
  31821.     function baz(ReflectionFunction $a, $b = 1, $c = null) { }
  31822.     function abc() { }
  31823.  
  31824.     // Create an instance of Reflection_Function with the
  31825.     // parameter given from the command line.    
  31826.     $reflect = new ReflectionFunction($argv[1]);
  31827.  
  31828.     echo $reflect;
  31829.  
  31830.     foreach ($reflect->getParameters() as $i => $param) 
  31831.     {
  31832.         printf(
  31833.             "-- Parameter #%d: %s {\n".
  31834.             "   Class: %s\n".
  31835.             "   Allows NULL: %s\n".
  31836.             "   Passed to by reference: %s\n".
  31837.             "   Is optional?: %s\n".
  31838.             "}\n",
  31839.             $i, 
  31840.             $param->getName(),
  31841.             var_export($param->getClass(), 1),
  31842.             var_export($param->allowsNull(), 1),
  31843.             var_export($param->isPassedByReference(), 1),
  31844.             $param->isOptional() ? 'yes' : 'no'
  31845.         );
  31846.     }
  31847. ?></PRE
  31848. ></TD
  31849. ></TR
  31850. ></TABLE
  31851. ></DIV
  31852. ></TD
  31853. ></TR
  31854. ></TABLE
  31855. ></DIV
  31856. ><DIV
  31857. CLASS="sect2"
  31858. ><HR><H3
  31859. CLASS="sect2"
  31860. ><A
  31861. NAME="language.oop5.reflection.reflectionclass"
  31862. ><B
  31863. CLASS="classname"
  31864. >ReflectionClass</B
  31865. ></A
  31866. ></H3
  31867. ><P
  31868. >     The <B
  31869. CLASS="classname"
  31870. >ReflectionClass</B
  31871. > class lets
  31872.     you reverse-engineer classes.
  31873.    </P
  31874. ><DIV
  31875. CLASS="informalexample"
  31876. ><P
  31877. ></P
  31878. ><A
  31879. NAME="AEN5394"
  31880. ></A
  31881. ><TABLE
  31882. BORDER="0"
  31883. BGCOLOR="#E0E0E0"
  31884. CELLPADDING="5"
  31885. ><TR
  31886. ><TD
  31887. ><PRE
  31888. CLASS="php"
  31889. ><?php
  31890.   class ReflectionClass implements Reflector {
  31891.       public __construct(string name)
  31892.       public string __toString()
  31893.       public static string export()
  31894.       public string getName()
  31895.       public bool isInternal()
  31896.       public bool isUserDefined()
  31897.       public string getFileName()
  31898.       public int getStartLine()
  31899.       public int getEndLine()
  31900.       public string getDocComment()
  31901.       public ReflectionMethod getConstructor()
  31902.       public ReflectionMethod getMethod(string name)
  31903.       public ReflectionMethod[] getMethods()
  31904.       public ReflectionProperty getProperty(string name)
  31905.       public ReflectionProperty[] getProperties()
  31906.       public array getConstants()
  31907.       public mixed getConstant(string name)
  31908.       public bool isInstantiable()
  31909.       public bool isInterface()
  31910.       public bool isFinal()
  31911.       public bool isAbstract()
  31912.       public int getModifiers()
  31913.       public bool isInstance(stdclass object)
  31914.       public stdclass newInstance(mixed* args)
  31915.       public ReflectionClass[] getInterfaces()
  31916.       public ReflectionClass getParentClass()
  31917.       public bool isSubclassOf(ReflectionClass class)
  31918.   }
  31919. ?></PRE
  31920. ></TD
  31921. ></TR
  31922. ></TABLE
  31923. ><P
  31924. ></P
  31925. ></DIV
  31926. ><P
  31927. >     To introspect a class, you will first have to create an instance
  31928.     of the <B
  31929. CLASS="classname"
  31930. >ReflectionClass</B
  31931. > class. You can then
  31932.     call any of the above methods on this instance.
  31933.    </P
  31934. ><TABLE
  31935. WIDTH="100%"
  31936. BORDER="0"
  31937. CELLPADDING="0"
  31938. CELLSPACING="0"
  31939. CLASS="EXAMPLE"
  31940. ><TR
  31941. ><TD
  31942. ><DIV
  31943. CLASS="example"
  31944. ><A
  31945. NAME="AEN5398"
  31946. ></A
  31947. ><P
  31948. ><B
  31949. >Beispiel 18-23. Using the <B
  31950. CLASS="classname"
  31951. >ReflectionClass</B
  31952. > class</B
  31953. ></P
  31954. ><TABLE
  31955. BORDER="0"
  31956. BGCOLOR="#E0E0E0"
  31957. CELLPADDING="5"
  31958. ><TR
  31959. ><TD
  31960. ><PRE
  31961. CLASS="php"
  31962. ><?php
  31963.   interface Serializable
  31964.   {
  31965.       // ...
  31966.   }
  31967.  
  31968.   class Object
  31969.   {
  31970.       // ...
  31971.   }
  31972.  
  31973.   /**
  31974.    * A counter class
  31975.    *
  31976.    */
  31977.   class Counter extends Object implements Serializable 
  31978.   {
  31979.       const START = 0;
  31980.       private static $c = Counter::START;
  31981.  
  31982.       /**
  31983.        * Invoke counter
  31984.        *
  31985.        * @access  public
  31986.        * @return  int
  31987.        */
  31988.       public function count()
  31989.       {
  31990.           return self::$c++;
  31991.       }
  31992.   }
  31993.  
  31994.   // Create an instance of the ReflectionClass class
  31995.   $class= new ReflectionClass('Counter');
  31996.  
  31997.   // Print out basic information
  31998.   printf(
  31999.       "===> The %s%s%s %s '%s' [extends %s]\n".
  32000.       "     declared in %s\n".
  32001.       "     lines %d to %d\n".
  32002.       "     having the modifiers %d [%s]\n",
  32003.       $class->isInternal() ? 'internal' : 'user-defined',
  32004.       $class->isAbstract() ? ' abstract' : '',
  32005.       $class->isFinal() ? ' final' : '',
  32006.       $class->isInterface() ? 'interface' : 'class',
  32007.       $class->getName(),
  32008.       var_export($class->getParentClass(), 1),
  32009.       $class->getFileName(),
  32010.       $class->getStartLine(),
  32011.       $class->getEndline(),
  32012.       $class->getModifiers(),
  32013.       implode(' ', Reflection::getModifierNames($class->getModifiers()))
  32014.   );
  32015.  
  32016.   // Print documentation comment
  32017.   printf("---> Documentation:\n %s\n", var_export($class->getDocComment(), 1));
  32018.  
  32019.   // Print which interfaces are implemented by this class
  32020.   printf("---> Implements:\n %s\n", var_export($class->getInterfaces(), 1));
  32021.  
  32022.   // Print class constants
  32023.   printf("---> Constants: %s\n", var_export($class->getConstants(), 1));
  32024.  
  32025.   // Print class properties
  32026.   printf("---> Properties: %s\n", var_export($class->getProperties(), 1));
  32027.  
  32028.   // Print class methods
  32029.   printf("---> Methods: %s\n", var_export($class->getMethods(), 1));
  32030.  
  32031.   // If this class is instantiable, create an instance
  32032.   if ($class->isInstantiable()) 
  32033.   {
  32034.       $counter= $class->newInstance();
  32035.  
  32036.       echo '---> $counter is instance? '; 
  32037.       echo $class->isInstance($counter) ? 'yes' : 'no';
  32038.  
  32039.       echo "\n---> new Object() is instance? ";
  32040.       echo $class->isInstance(new Object()) ? 'yes' : 'no';
  32041.   }
  32042. ?></PRE
  32043. ></TD
  32044. ></TR
  32045. ></TABLE
  32046. ></DIV
  32047. ></TD
  32048. ></TR
  32049. ></TABLE
  32050. ><DIV
  32051. CLASS="note"
  32052. ><BLOCKQUOTE
  32053. CLASS="note"
  32054. ><P
  32055. ><B
  32056. >Anmerkung: </B
  32057. >
  32058.      The method <B
  32059. CLASS="function"
  32060. >newInstance()</B
  32061. > accepts a variable number of
  32062.      arguments which are passed to the function just as in
  32063.      <A
  32064. HREF="#function.call-user-func"
  32065. ><B
  32066. CLASS="function"
  32067. >call_user_func()</B
  32068. ></A
  32069. >.
  32070.     </P
  32071. ></BLOCKQUOTE
  32072. ></DIV
  32073. ><DIV
  32074. CLASS="note"
  32075. ><BLOCKQUOTE
  32076. CLASS="note"
  32077. ><P
  32078. ><B
  32079. >Anmerkung: </B
  32080. >
  32081.      <VAR
  32082. CLASS="literal"
  32083. >$class = new ReflectionClass('Foo'); $class->isInstance($arg)</VAR
  32084. >
  32085.      is equivalent to <VAR
  32086. CLASS="literal"
  32087. >$arg instanceof Foo</VAR
  32088. > or 
  32089.      <VAR
  32090. CLASS="literal"
  32091. >is_a($arg, 'Foo')</VAR
  32092. >.
  32093.     </P
  32094. ></BLOCKQUOTE
  32095. ></DIV
  32096. ></DIV
  32097. ><DIV
  32098. CLASS="sect2"
  32099. ><HR><H3
  32100. CLASS="sect2"
  32101. ><A
  32102. NAME="language.oop5.reflection.reflectionmethod"
  32103. ><B
  32104. CLASS="classname"
  32105. >ReflectionMethod</B
  32106. ></A
  32107. ></H3
  32108. ><P
  32109. >     The <B
  32110. CLASS="classname"
  32111. >ReflectionMethod</B
  32112. > class lets you
  32113.     reverse-engineer class methods.
  32114.    </P
  32115. ><DIV
  32116. CLASS="informalexample"
  32117. ><P
  32118. ></P
  32119. ><A
  32120. NAME="AEN5416"
  32121. ></A
  32122. ><TABLE
  32123. BORDER="0"
  32124. BGCOLOR="#E0E0E0"
  32125. CELLPADDING="5"
  32126. ><TR
  32127. ><TD
  32128. ><PRE
  32129. CLASS="php"
  32130. ><?php
  32131.   class ReflectionMethod extends ReflectionFunction {
  32132.       public __construct(mixed class, string name)
  32133.       public static string export()
  32134.       public mixed invoke(stdclass object, mixed* args)
  32135.       public bool isFinal()
  32136.       public bool isAbstract()
  32137.       public bool isPublic()
  32138.       public bool isPrivate()
  32139.       public bool isProtected()
  32140.       public bool isStatic()
  32141.       public bool isConstructor()
  32142.       public int getModifiers()
  32143.       public ReflectionClass getDeclaringClass()
  32144.  
  32145.       /* Inherited from ReflectionFunction */
  32146.       public string __toString()
  32147.       public string getName()
  32148.       public bool isInternal()
  32149.       public bool isUserDefined()
  32150.       public string getFileName()
  32151.       public int getStartLine()
  32152.       public int getEndLine()
  32153.       public string getDocComment()
  32154.       public array getStaticVariables()
  32155.       public bool returnsReference()
  32156.       public ReflectionParameter[] getParameters()
  32157.   }
  32158. ?></PRE
  32159. ></TD
  32160. ></TR
  32161. ></TABLE
  32162. ><P
  32163. ></P
  32164. ></DIV
  32165. ><P
  32166. >     To introspect a method, you will first have to create an instance
  32167.     of the <B
  32168. CLASS="classname"
  32169. >ReflectionMethod</B
  32170. > class. You can then call
  32171.     any of the above methods on this instance.
  32172.    </P
  32173. ><TABLE
  32174. WIDTH="100%"
  32175. BORDER="0"
  32176. CELLPADDING="0"
  32177. CELLSPACING="0"
  32178. CLASS="EXAMPLE"
  32179. ><TR
  32180. ><TD
  32181. ><DIV
  32182. CLASS="example"
  32183. ><A
  32184. NAME="AEN5420"
  32185. ></A
  32186. ><P
  32187. ><B
  32188. >Beispiel 18-24. Using the <B
  32189. CLASS="classname"
  32190. >ReflectionMethod</B
  32191. > class</B
  32192. ></P
  32193. ><TABLE
  32194. BORDER="0"
  32195. BGCOLOR="#E0E0E0"
  32196. CELLPADDING="5"
  32197. ><TR
  32198. ><TD
  32199. ><PRE
  32200. CLASS="php"
  32201. ><?php
  32202.   class Counter {
  32203.       private static $c = 0;
  32204.  
  32205.       /**
  32206.        * Increment counter
  32207.        *
  32208.        * @final
  32209.        * @static
  32210.        * @access  public
  32211.        * @return  int
  32212.        */
  32213.       final public static function increment()
  32214.       {
  32215.           self::$c++;
  32216.           return self::$c;
  32217.       }
  32218.   }
  32219.  
  32220.   // Create an instance of the Reflection_Method class
  32221.   $method= new ReflectionMethod('Counter', 'increment');
  32222.  
  32223.   // Print out basic information
  32224.   printf(
  32225.     "===> The %s%s%s%s%s%s%s method '%s' (which is %s)\n".
  32226.     "     declared in %s\n".
  32227.     "     lines %d to %d\n".
  32228.     "     having the modifiers %d[%s]\n",
  32229.     $method->isInternal() ? 'internal' : 'user-defined',
  32230.     $method->isAbstract() ? ' abstract' : '',
  32231.     $method->isFinal() ? ' final' : '',
  32232.     $method->isPublic() ? ' public' : '',
  32233.     $method->isPrivate() ? ' private' : '',
  32234.     $method->isProtected() ? ' protected' : '',
  32235.     $method->isStatic() ? ' static' : '',
  32236.     $method->getName(),
  32237.     $method->isConstructor() ? 'the constructor' : 'a regular method',
  32238.     $method->getFileName(),
  32239.     $method->getStartLine(),
  32240.     $method->getEndline(),
  32241.     $method->getModifiers(),
  32242.     implode(' ', Reflection::getModifierNames($method->getModifiers()))
  32243.   );
  32244.  
  32245.   // Print documentation comment
  32246.   printf("---> Documentation:\n %s\n", var_export($method->getDocComment(), 1));
  32247.  
  32248.   // Print static variables if existant
  32249.   if ($statics= $method->getStaticVariables())
  32250.   {
  32251.       printf("---> Static variables: %s\n", var_export($statics, 1));
  32252.   }
  32253.  
  32254.   // Invoke the method
  32255.   printf("---> Invokation results in: ");
  32256.   var_dump($method->invoke(NULL));
  32257. ?></PRE
  32258. ></TD
  32259. ></TR
  32260. ></TABLE
  32261. ></DIV
  32262. ></TD
  32263. ></TR
  32264. ></TABLE
  32265. ><DIV
  32266. CLASS="note"
  32267. ><BLOCKQUOTE
  32268. CLASS="note"
  32269. ><P
  32270. ><B
  32271. >Anmerkung: </B
  32272. >
  32273.      Trying to invoke private, protected or abstract methods will result
  32274.      in an exception being thrown from the <B
  32275. CLASS="function"
  32276. >invoke()</B
  32277. >
  32278.      method.
  32279.     </P
  32280. ></BLOCKQUOTE
  32281. ></DIV
  32282. ><DIV
  32283. CLASS="note"
  32284. ><BLOCKQUOTE
  32285. CLASS="note"
  32286. ><P
  32287. ><B
  32288. >Anmerkung: </B
  32289. >
  32290.      For static methods as seen above, you should pass NULL as the first
  32291.      argument to <B
  32292. CLASS="function"
  32293. >invoke()</B
  32294. >. For non-static methods, pass 
  32295.      an instance of the class.
  32296.     </P
  32297. ></BLOCKQUOTE
  32298. ></DIV
  32299. ></DIV
  32300. ><DIV
  32301. CLASS="sect2"
  32302. ><HR><H3
  32303. CLASS="sect2"
  32304. ><A
  32305. NAME="language.oop5.reflection.reflectionproperty"
  32306. ><B
  32307. CLASS="classname"
  32308. >ReflectionProperty</B
  32309. ></A
  32310. ></H3
  32311. ><P
  32312. >     The <B
  32313. CLASS="classname"
  32314. >ReflectionProperty</B
  32315. > class lets you
  32316.     reverse-engineer class properties.
  32317.    </P
  32318. ><DIV
  32319. CLASS="informalexample"
  32320. ><P
  32321. ></P
  32322. ><A
  32323. NAME="AEN5435"
  32324. ></A
  32325. ><TABLE
  32326. BORDER="0"
  32327. BGCOLOR="#E0E0E0"
  32328. CELLPADDING="5"
  32329. ><TR
  32330. ><TD
  32331. ><PRE
  32332. CLASS="php"
  32333. ><?php
  32334.   class ReflectionProperty implements Reflector {
  32335.       public __construct(mixed class, string name)
  32336.       public string __toString()
  32337.       public static string export()
  32338.       public string getName()
  32339.       public bool isPublic()
  32340.       public bool isPrivate()
  32341.       public bool isProtected()
  32342.       public bool isStatic()
  32343.       public bool isDefault()
  32344.       public int getModifiers()
  32345.       public mixed getValue(stdclass object)
  32346.       public void setValue(stdclass object, mixed value)
  32347.       public ReflectionClass getDeclaringClass()
  32348.   }
  32349. ?></PRE
  32350. ></TD
  32351. ></TR
  32352. ></TABLE
  32353. ><P
  32354. ></P
  32355. ></DIV
  32356. ><P
  32357. >     To introspect a method, you will first have to create an instance
  32358.     of the <B
  32359. CLASS="classname"
  32360. >ReflectionProperty</B
  32361. > class. You can then
  32362.     call any of the above methods on this instance.
  32363.    </P
  32364. ><TABLE
  32365. WIDTH="100%"
  32366. BORDER="0"
  32367. CELLPADDING="0"
  32368. CELLSPACING="0"
  32369. CLASS="EXAMPLE"
  32370. ><TR
  32371. ><TD
  32372. ><DIV
  32373. CLASS="example"
  32374. ><A
  32375. NAME="AEN5439"
  32376. ></A
  32377. ><P
  32378. ><B
  32379. >Beispiel 18-25. Using the <B
  32380. CLASS="classname"
  32381. >ReflectionProperty</B
  32382. > class</B
  32383. ></P
  32384. ><TABLE
  32385. BORDER="0"
  32386. BGCOLOR="#E0E0E0"
  32387. CELLPADDING="5"
  32388. ><TR
  32389. ><TD
  32390. ><PRE
  32391. CLASS="php"
  32392. ><?php
  32393.   class String
  32394.   {
  32395.       public $length  = 5;
  32396.   }
  32397.  
  32398.   // Create an instance of the ReflectionProperty class
  32399.   $prop = new ReflectionProperty('String', 'length');
  32400.  
  32401.   // Print out basic information
  32402.   printf(
  32403.       "===> The%s%s%s%s property '%s' (which was %s)\n".
  32404.       "     having the modifiers %s\n",
  32405.       $prop->isPublic() ? ' public' : '',
  32406.       $prop->isPrivate() ? ' private' : '',
  32407.       $prop->isProtected() ? ' protected' : '',
  32408.       $prop->isStatic() ? ' static' : '',
  32409.       $prop->getName(),
  32410.       $prop->isDefault() ? 'declared at compile-time' : 'created at run-time',
  32411.       var_export(Reflection::getModifierNames($prop->getModifiers()), 1)
  32412.   );
  32413.  
  32414.   // Create an instance of String
  32415.   $obj= new String();
  32416.  
  32417.   // Get current value
  32418.   printf("---> Value is: ");
  32419.   var_dump($prop->getValue($obj));
  32420.  
  32421.   // Change value
  32422.   $prop->setValue($obj, 10);
  32423.   printf("---> Setting value to 10, new value is: ");
  32424.   var_dump($prop->getValue($obj));
  32425.  
  32426.   // Dump object
  32427.   var_dump($obj);
  32428. ?></PRE
  32429. ></TD
  32430. ></TR
  32431. ></TABLE
  32432. ></DIV
  32433. ></TD
  32434. ></TR
  32435. ></TABLE
  32436. ><DIV
  32437. CLASS="note"
  32438. ><BLOCKQUOTE
  32439. CLASS="note"
  32440. ><P
  32441. ><B
  32442. >Anmerkung: </B
  32443. >
  32444.      Trying to get or set private or protected class property's values
  32445.      will result in an exception being thrown.
  32446.     </P
  32447. ></BLOCKQUOTE
  32448. ></DIV
  32449. ></DIV
  32450. ><DIV
  32451. CLASS="sect2"
  32452. ><HR><H3
  32453. CLASS="sect2"
  32454. ><A
  32455. NAME="language.oop5.reflection.reflectionextension"
  32456. ><B
  32457. CLASS="classname"
  32458. >ReflectionExtension</B
  32459. ></A
  32460. ></H3
  32461. ><P
  32462. >     The <B
  32463. CLASS="classname"
  32464. >ReflectionExtension</B
  32465. > class lets you
  32466.     reverse-engineer extensions. You can retrieve all loaded extensions
  32467.     at runtime using the <A
  32468. HREF="#function.get-loaded-extensions"
  32469. ><B
  32470. CLASS="function"
  32471. >get_loaded_extensions()</B
  32472. ></A
  32473. >.
  32474.    </P
  32475. ><DIV
  32476. CLASS="informalexample"
  32477. ><P
  32478. ></P
  32479. ><A
  32480. NAME="AEN5451"
  32481. ></A
  32482. ><TABLE
  32483. BORDER="0"
  32484. BGCOLOR="#E0E0E0"
  32485. CELLPADDING="5"
  32486. ><TR
  32487. ><TD
  32488. ><PRE
  32489. CLASS="php"
  32490. ><?php
  32491.   class ReflectionExtension implements Reflector {
  32492.       public __construct(string name)
  32493.       public string __toString()
  32494.       public static string export()
  32495.       public string getName()
  32496.       public string getVersion()
  32497.       public ReflectionFunction[] getFunctions()
  32498.       public array getConstants()
  32499.       public array getINIEntries()
  32500.   }
  32501. ?></PRE
  32502. ></TD
  32503. ></TR
  32504. ></TABLE
  32505. ><P
  32506. ></P
  32507. ></DIV
  32508. ><P
  32509. >     To introspect a method, you will first have to create an instance
  32510.     of the <B
  32511. CLASS="classname"
  32512. >ReflectionProperty</B
  32513. > class. You can then call
  32514.     any of the above methods on this instance.
  32515.    </P
  32516. ><TABLE
  32517. WIDTH="100%"
  32518. BORDER="0"
  32519. CELLPADDING="0"
  32520. CELLSPACING="0"
  32521. CLASS="EXAMPLE"
  32522. ><TR
  32523. ><TD
  32524. ><DIV
  32525. CLASS="example"
  32526. ><A
  32527. NAME="AEN5455"
  32528. ></A
  32529. ><P
  32530. ><B
  32531. >Beispiel 18-26. Using the <B
  32532. CLASS="classname"
  32533. >ReflectionExtension</B
  32534. > class</B
  32535. ></P
  32536. ><TABLE
  32537. BORDER="0"
  32538. BGCOLOR="#E0E0E0"
  32539. CELLPADDING="5"
  32540. ><TR
  32541. ><TD
  32542. ><PRE
  32543. CLASS="php"
  32544. ><?php
  32545.   // Create an instance of the ReflectionProperty class
  32546.   $ext = new ReflectionExtension('standard');
  32547.  
  32548.   // Print out basic information
  32549.   printf(
  32550.       "Name        : %s\n".
  32551.       "Version     : %s\n".
  32552.       "Functions   : [%d] %s\n".
  32553.       "Constants   : [%d] %s\n".
  32554.       "INI entries : [%d] %s\n",
  32555.       $ext->getName(),
  32556.       $ext->getVersion() ? $ext->getVersion() : 'NO_VERSION',
  32557.       sizeof($ext->getFunctions()),
  32558.       var_export($ext->getFunctions(), 1),
  32559.       sizeof($ext->getConstants()),
  32560.       var_export($ext->getConstants(), 1),
  32561.       sizeof($ext->getINIEntries()),
  32562.       var_export($ext->getINIEntries(), 1)
  32563.   );
  32564. ?></PRE
  32565. ></TD
  32566. ></TR
  32567. ></TABLE
  32568. ></DIV
  32569. ></TD
  32570. ></TR
  32571. ></TABLE
  32572. ></DIV
  32573. ><DIV
  32574. CLASS="sect2"
  32575. ><HR><H3
  32576. CLASS="sect2"
  32577. ><A
  32578. NAME="language.oop5.reflection.extending"
  32579. >Extending the reflection classes</A
  32580. ></H3
  32581. ><P
  32582. >     In case you want to create specialized versions of the built-in
  32583.     classes (say, for creating colorized HTML when being exported,
  32584.     having easy-access member variables instead of methods or
  32585.     having utility methods), you may go ahead and extend them.
  32586.    </P
  32587. ><TABLE
  32588. WIDTH="100%"
  32589. BORDER="0"
  32590. CELLPADDING="0"
  32591. CELLSPACING="0"
  32592. CLASS="EXAMPLE"
  32593. ><TR
  32594. ><TD
  32595. ><DIV
  32596. CLASS="example"
  32597. ><A
  32598. NAME="AEN5462"
  32599. ></A
  32600. ><P
  32601. ><B
  32602. >Beispiel 18-27. Extending the built-in classes</B
  32603. ></P
  32604. ><TABLE
  32605. BORDER="0"
  32606. BGCOLOR="#E0E0E0"
  32607. CELLPADDING="5"
  32608. ><TR
  32609. ><TD
  32610. ><PRE
  32611. CLASS="php"
  32612. ><?php
  32613.   /**
  32614.    * My Reflection_Method class
  32615.    *
  32616.    */
  32617.   class My_Reflection_Method extends ReflectionMethod {
  32618.     public $visibility= '';
  32619.  
  32620.     public function __construct($o, $m) {
  32621.       parent::__construct($o, $m);
  32622.       $this->visibility= Reflection::getModifierNames($this->getModifiers());
  32623.     }
  32624.   }
  32625.  
  32626.   /**
  32627.    * Demo class #1
  32628.    *
  32629.    */
  32630.   class T {
  32631.     protected function x() {}
  32632.   }
  32633.  
  32634.   /**
  32635.    * Demo class #2
  32636.    *
  32637.    */
  32638.   class U extends T {
  32639.     function x() {}
  32640.   }
  32641.  
  32642.   // Print out information
  32643.   var_dump(new My_Reflection_Method('U', 'x'));
  32644. ?></PRE
  32645. ></TD
  32646. ></TR
  32647. ></TABLE
  32648. ></DIV
  32649. ></TD
  32650. ></TR
  32651. ></TABLE
  32652. ><DIV
  32653. CLASS="note"
  32654. ><BLOCKQUOTE
  32655. CLASS="note"
  32656. ><P
  32657. ><B
  32658. >Anmerkung: </B
  32659. >
  32660.      Caution: If you're overwriting the constructor, remember to call
  32661.      the parent's constructor _before_ any code you insert. Failing to
  32662.      do so will result in the following:
  32663.      <VAR
  32664. CLASS="literal"
  32665. >       Fatal error: Internal error: Failed to retrieve the reflection object
  32666.      </VAR
  32667. >
  32668.     </P
  32669. ></BLOCKQUOTE
  32670. ></DIV
  32671. ></DIV
  32672. ></DIV
  32673. ></DIV
  32674. ><DIV
  32675. CLASS="chapter"
  32676. ><HR><H1
  32677. ><A
  32678. NAME="language.references"
  32679. >Kapitel 19. Referenzen in PHP</A
  32680. ></H1
  32681. ><DIV
  32682. CLASS="sect1"
  32683. ><H2
  32684. CLASS="sect1"
  32685. ><A
  32686. NAME="language.references.whatare"
  32687. >Was Referenzen sind</A
  32688. ></H2
  32689. ><P
  32690. >  
  32691.     Referenzen sind in PHP ein Mechanismus um verschiedene Namen
  32692.     fⁿr den gleichen Inhalt von Variablen zu erm÷glichen. 
  32693.     Sie sind nicht mit Zeigern in C zu vergleichen, sondern 
  32694.     Aliasdefinitionen fⁿr die Symboltabelle. 
  32695.     PHP unterscheidet zwischen Variablenname und Variableninhalt, 
  32696.     wobei der gleiche Variableninhalt unterschiedliche Namen besitzen kann. 
  32697.     Der bestm÷gliche Vergleich ist der mit Dateinamen und Dateien 
  32698.     im Dateisystem von Unix - Variablennamen sind VerzeichniseintrΣge, 
  32699.     wΣhrend der Variableninhalt die eigentliche Datei darstellt. 
  32700.     Referenzen k÷nnen nun als Hardlinks im Dateisystem verstanden werden.
  32701.    </P
  32702. ></DIV
  32703. ><DIV
  32704. CLASS="sect1"
  32705. ><HR><H2
  32706. CLASS="sect1"
  32707. ><A
  32708. NAME="language.references.whatdo"
  32709. >Was Referenzen leisten</A
  32710. ></H2
  32711. ><P
  32712. >     PHP Referenzen erlauben es, zwei Variablennamen sich auf den
  32713.     gleichen Variableninhalt beziehen zu lassen. Das heisst im
  32714.     folgenden Beispiel, dass sich <VAR
  32715. CLASS="varname"
  32716. >$a</VAR
  32717. > und
  32718.     <VAR
  32719. CLASS="varname"
  32720. >$b</VAR
  32721. > auf dieselbe Variable beziehen:
  32722.  
  32723.     <DIV
  32724. CLASS="informalexample"
  32725. ><P
  32726. ></P
  32727. ><A
  32728. NAME="AEN5478"
  32729. ></A
  32730. ><TABLE
  32731. BORDER="0"
  32732. BGCOLOR="#E0E0E0"
  32733. CELLPADDING="5"
  32734. ><TR
  32735. ><TD
  32736. ><PRE
  32737. CLASS="php"
  32738. >$a =& $b</PRE
  32739. ></TD
  32740. ></TR
  32741. ></TABLE
  32742. ><P
  32743. ></P
  32744. ></DIV
  32745. >
  32746.  
  32747.     <DIV
  32748. CLASS="note"
  32749. ><BLOCKQUOTE
  32750. CLASS="note"
  32751. ><P
  32752. ><B
  32753. >Anmerkung: </B
  32754. >
  32755.       <VAR
  32756. CLASS="varname"
  32757. >$a</VAR
  32758. > und <VAR
  32759. CLASS="varname"
  32760. >$b</VAR
  32761. > sind hier
  32762.       gleichwertig, und <VAR
  32763. CLASS="varname"
  32764. >$a</VAR
  32765. > ist nicht nur ein
  32766.       Zeiger auf <VAR
  32767. CLASS="varname"
  32768. >$b</VAR
  32769. > oder umgekehrt, sondern
  32770.       <VAR
  32771. CLASS="varname"
  32772. >$a</VAR
  32773. > und <VAR
  32774. CLASS="varname"
  32775. >$b</VAR
  32776. > zeigen auf
  32777.       den selben Inhalt.
  32778.      </P
  32779. ></BLOCKQUOTE
  32780. ></DIV
  32781. >
  32782.    </P
  32783. ><P
  32784. >    Seit PHP 4.0.4 kann <VAR
  32785. CLASS="literal"
  32786. >&</VAR
  32787. > auch in Verbindung mit
  32788.    <VAR
  32789. CLASS="literal"
  32790. >new</VAR
  32791. > verwendet werden.
  32792.    <DIV
  32793. CLASS="informalexample"
  32794. ><P
  32795. ></P
  32796. ><A
  32797. NAME="AEN5491"
  32798. ></A
  32799. ><TABLE
  32800. BORDER="0"
  32801. BGCOLOR="#E0E0E0"
  32802. CELLPADDING="5"
  32803. ><TR
  32804. ><TD
  32805. ><PRE
  32806. CLASS="php"
  32807. >$bar =& new fooclass();
  32808. $foo =& find_var ($bar);</PRE
  32809. ></TD
  32810. ></TR
  32811. ></TABLE
  32812. ><P
  32813. ></P
  32814. ></DIV
  32815. >
  32816.     </P
  32817. ><DIV
  32818. CLASS="note"
  32819. ><BLOCKQUOTE
  32820. CLASS="note"
  32821. ><P
  32822. ><B
  32823. >Anmerkung: </B
  32824. >
  32825.      Wenn der <VAR
  32826. CLASS="literal"
  32827. >&</VAR
  32828. > Operator nicht verwendet wird, erzeugt
  32829.      PHP eine Kopie des Objekts. Wenn nun <VAR
  32830. CLASS="literal"
  32831. >$this</VAR
  32832. > innerhalb 
  32833.      der Klasse verwendet wird, bezieht es sich auf die aktuelle Instanz der 
  32834.      Klasse. Die Zuordnung ohne <VAR
  32835. CLASS="literal"
  32836. >&</VAR
  32837. > erzeugt eine Kopie der 
  32838.      Instanz (d.h. des Objekts) und <VAR
  32839. CLASS="literal"
  32840. >$this</VAR
  32841. > wird sich auf 
  32842.      die Kopie beziehen. In der Regel will man aus Performance- und 
  32843.      Speicherverbrausgrⁿnden nur eine einzige Instanz einer Klasse
  32844.      erzeugen. Dafⁿr stellt PHP den <VAR
  32845. CLASS="literal"
  32846. >&</VAR
  32847. > bereit. 
  32848.      </P
  32849. ></BLOCKQUOTE
  32850. ></DIV
  32851. ><P
  32852. >     Eine weitere Einsatzm÷glichkeit von Referenzen ist die ▄bergabe 
  32853.     von Parametern an eine Funktion mit pass-by-reference. Hierbei 
  32854.     beziehen sich der lokale Variablenname als auch der Variablenname 
  32855.     der aufrufenden Instanz auf denselben Variableninhalt:
  32856.     <DIV
  32857. CLASS="informalexample"
  32858. ><P
  32859. ></P
  32860. ><A
  32861. NAME="AEN5501"
  32862. ></A
  32863. ><TABLE
  32864. BORDER="0"
  32865. BGCOLOR="#E0E0E0"
  32866. CELLPADDING="5"
  32867. ><TR
  32868. ><TD
  32869. ><PRE
  32870. CLASS="php"
  32871. >function foo (&$var) {
  32872.     $var++;
  32873. }
  32874.  
  32875. $a=5;
  32876. foo ($a);</PRE
  32877. ></TD
  32878. ></TR
  32879. ></TABLE
  32880. ><P
  32881. ></P
  32882. ></DIV
  32883. >
  32884.     Nach der Ausfⁿhrung hat <VAR
  32885. CLASS="varname"
  32886. >$a</VAR
  32887. > den Wert 6, da sich 
  32888.     in der Funktion <VAR
  32889. CLASS="varname"
  32890. >foo</VAR
  32891. > der Variablenname 
  32892.     <VAR
  32893. CLASS="varname"
  32894. >$var</VAR
  32895. > auf denselben Variableninhalt bezieht wie 
  32896.     <VAR
  32897. CLASS="varname"
  32898. >$a</VAR
  32899. > in der aufrufenden Instanz (hier das Hauptprogramm).
  32900.    </P
  32901. ><P
  32902. >     Daneben besteht die M÷glichkeit aus Funktionen heraus Werte mit 
  32903.     <A
  32904. HREF="#language.references.return"
  32905. >return by-reference</A
  32906. > 
  32907.     zurⁿckzugeben.
  32908.    </P
  32909. ></DIV
  32910. ><DIV
  32911. CLASS="sect1"
  32912. ><HR><H2
  32913. CLASS="sect1"
  32914. ><A
  32915. NAME="language.references.arent"
  32916. >Was Referenzen nicht sind</A
  32917. ></H2
  32918. ><P
  32919. >     Wie bereits gesagt: Referenzen sind keine Zeiger. Das bedeutet, 
  32920.     der folgende Code tut nicht, was zum Beispiel ein C Programmierer 
  32921.     erwarten wⁿrde:
  32922.     <DIV
  32923. CLASS="informalexample"
  32924. ><P
  32925. ></P
  32926. ><A
  32927. NAME="AEN5512"
  32928. ></A
  32929. ><TABLE
  32930. BORDER="0"
  32931. BGCOLOR="#E0E0E0"
  32932. CELLPADDING="5"
  32933. ><TR
  32934. ><TD
  32935. ><PRE
  32936. CLASS="php"
  32937. >function foo (&$var) {
  32938.     $var =& $GLOBALS["baz"];
  32939. }
  32940. foo($bar);</PRE
  32941. ></TD
  32942. ></TR
  32943. ></TABLE
  32944. ><P
  32945. ></P
  32946. ></DIV
  32947. >
  32948.    </P
  32949. ><P
  32950. >     Folgendes wird passieren: <VAR
  32951. CLASS="varname"
  32952. >$var</VAR
  32953. > in foo wird zunΣchst 
  32954.     an  <VAR
  32955. CLASS="varname"
  32956. >$bar</VAR
  32957. > aus der aufrufenden Instanz, dann 
  32958.     aber an <VAR
  32959. CLASS="varname"
  32960. >$GLOBALS["baz"]</VAR
  32961. >, gebunden.
  32962.     Es gibt keine M÷glichkeit, <VAR
  32963. CLASS="varname"
  32964. >$bar</VAR
  32965. > aus der aufrufenden 
  32966.     Instanz mittels Referenz-Mechanismen an etwas anderes zu binden, da 
  32967.     <VAR
  32968. CLASS="varname"
  32969. >$bar</VAR
  32970. > in der Funktion foo nicht zur Verfⁿgung steht 
  32971.     (<VAR
  32972. CLASS="varname"
  32973. >$bar</VAR
  32974. > wird durch <VAR
  32975. CLASS="varname"
  32976. >$var</VAR
  32977. > reprΣsentiert; 
  32978.     <VAR
  32979. CLASS="varname"
  32980. >$var</VAR
  32981. > verfⁿgt nur ⁿber Variableninhalt, besitzt 
  32982.     aber keinen name-to-value Eintrag in der Symboltabelle der aufrufenden 
  32983.     Instanz).
  32984.    </P
  32985. ></DIV
  32986. ><DIV
  32987. CLASS="sect1"
  32988. ><HR><H2
  32989. CLASS="sect1"
  32990. ><A
  32991. NAME="language.references.return"
  32992. >Referenzen zurⁿckgeben</A
  32993. ></H2
  32994. ><P
  32995. >     Das Zurⁿckgeben von Ergebnissen per Referenz aus Funktionen 
  32996.     heraus kann manchmal recht nⁿzlich sein. Hierbei ist folgende
  32997.     Syntax zu beachten:
  32998.     <DIV
  32999. CLASS="informalexample"
  33000. ><P
  33001. ></P
  33002. ><A
  33003. NAME="AEN5526"
  33004. ></A
  33005. ><TABLE
  33006. BORDER="0"
  33007. BGCOLOR="#E0E0E0"
  33008. CELLPADDING="5"
  33009. ><TR
  33010. ><TD
  33011. ><PRE
  33012. CLASS="php"
  33013. >function &find_var ($param) {
  33014.     ...code...
  33015.     return $found_var;
  33016. }
  33017.  
  33018. $foo =& find_var ($bar);
  33019. $foo->x = 2;</PRE
  33020. ></TD
  33021. ></TR
  33022. ></TABLE
  33023. ><P
  33024. ></P
  33025. ></DIV
  33026. >
  33027.     In diesem Beispiel wird also die Eigenschaft des von 
  33028.     <VAR
  33029. CLASS="varname"
  33030. >find_var</VAR
  33031. > gelieferten Objektes gesetzt, nicht die der Kopie, 
  33032.     wie es der Fall wΣre, wenn die Funktion <VAR
  33033. CLASS="varname"
  33034. >find_var</VAR
  33035. > 
  33036.     ihr Ergebnis nicht per Referenz liefern wⁿrde.
  33037.    </P
  33038. ><DIV
  33039. CLASS="note"
  33040. ><BLOCKQUOTE
  33041. CLASS="note"
  33042. ><P
  33043. ><B
  33044. >Anmerkung: </B
  33045. >
  33046.      Im Gegensatz zur Parameterⁿbergabe per Referenz ist bei der 
  33047.      Rⁿckgabe mittels Referenz an beiden Stellen die Angabe des 
  33048.      <VAR
  33049. CLASS="literal"
  33050. >&</VAR
  33051. > notwendig.
  33052.     </P
  33053. ></BLOCKQUOTE
  33054. ></DIV
  33055. ></DIV
  33056. ><DIV
  33057. CLASS="sect1"
  33058. ><HR><H2
  33059. CLASS="sect1"
  33060. ><A
  33061. NAME="language.references.unset"
  33062. >Referenzen aufheben</A
  33063. ></H2
  33064. ><P
  33065. >     Wird eine Referenz aufgehoben, so wird nur die Bindung zwischen einem 
  33066.     Variablennamen und dem Variableninhalt entfernt. Der Inhalt der Variablen 
  33067.     wird hierbei nicht gel÷scht. Betrachten wir folgendes Beispiel:
  33068.     <DIV
  33069. CLASS="informalexample"
  33070. ><P
  33071. ></P
  33072. ><A
  33073. NAME="AEN5536"
  33074. ></A
  33075. ><TABLE
  33076. BORDER="0"
  33077. BGCOLOR="#E0E0E0"
  33078. CELLPADDING="5"
  33079. ><TR
  33080. ><TD
  33081. ><PRE
  33082. CLASS="php"
  33083. >$a = 1;
  33084. $b =& $a;
  33085. unset ($a);</PRE
  33086. ></TD
  33087. ></TR
  33088. ></TABLE
  33089. ><P
  33090. ></P
  33091. ></DIV
  33092. >
  33093.     Die Variable <VAR
  33094. CLASS="varname"
  33095. >$b</VAR
  33096. > wird nicht gel÷scht, sondern es 
  33097.     wird nur die Bindung des Variablennamen <VAR
  33098. CLASS="varname"
  33099. >$a</VAR
  33100. > an den 
  33101.     Variableninhalt aufgehoben. Dieser Variableninhalt ist immer noch 
  33102.     ⁿber <VAR
  33103. CLASS="varname"
  33104. >$b</VAR
  33105. > verfⁿgbar.
  33106.    </P
  33107. ><P
  33108. >     Wiederum sieht man die Analogie zwischen Unix und den Referenzen: Das 
  33109.     Aufheben einer Referenz entspricht einem Aufruf von 
  33110.     <B
  33111. CLASS="command"
  33112. >unlink</B
  33113. > unter Unix.
  33114.    </P
  33115. ></DIV
  33116. ><DIV
  33117. CLASS="sect1"
  33118. ><HR><H2
  33119. CLASS="sect1"
  33120. ><A
  33121. NAME="language.references.spot"
  33122. >Referenzen entdecken</A
  33123. ></H2
  33124. ><P
  33125. >     Viele Sprachelemente von PHP sind intern mit der Benutzung von Referenzen 
  33126.     implementiert, daher gilt alles bisher gesagte auch fⁿr diese 
  33127.     Konstrukte:
  33128.    </P
  33129. ><DIV
  33130. CLASS="sect2"
  33131. ><HR><H3
  33132. CLASS="sect2"
  33133. ><A
  33134. NAME="references.global"
  33135. ><VAR
  33136. CLASS="literal"
  33137. >global</VAR
  33138. > References</A
  33139. ></H3
  33140. ><P
  33141. >      Die Verwendung von <B
  33142. CLASS="command"
  33143. >global $var</B
  33144. > erzeugt im aktuellen 
  33145.      Scope eine Referenz auf die globale Variable <VAR
  33146. CLASS="varname"
  33147. >$var</VAR
  33148. >, 
  33149.      sie ist also Σquivalent zu folgendem:
  33150.      <DIV
  33151. CLASS="informalexample"
  33152. ><P
  33153. ></P
  33154. ><A
  33155. NAME="AEN5552"
  33156. ></A
  33157. ><TABLE
  33158. BORDER="0"
  33159. BGCOLOR="#E0E0E0"
  33160. CELLPADDING="5"
  33161. ><TR
  33162. ><TD
  33163. ><PRE
  33164. CLASS="php"
  33165. >$var =& $GLOBALS["var"];</PRE
  33166. ></TD
  33167. ></TR
  33168. ></TABLE
  33169. ><P
  33170. ></P
  33171. ></DIV
  33172. >
  33173.     </P
  33174. ><P
  33175. >      Dies hat zur Folge, dass das Anwenden von unset() auf <VAR
  33176. CLASS="varname"
  33177. >$var</VAR
  33178. > 
  33179.      keinen Einfluss auf die globale Variable hat.
  33180.     </P
  33181. ></DIV
  33182. ><DIV
  33183. CLASS="sect2"
  33184. ><HR><H3
  33185. CLASS="sect2"
  33186. ><A
  33187. NAME="references.this"
  33188. ><VAR
  33189. CLASS="literal"
  33190. >$this</VAR
  33191. ></A
  33192. ></H3
  33193. ><P
  33194. >      In einer Objektmethode ist <VAR
  33195. CLASS="varname"
  33196. >$this</VAR
  33197. > immer eine Referenz 
  33198.      auf die aufrufende Objektinstanz.
  33199.     </P
  33200. ></DIV
  33201. ></DIV
  33202. ></DIV
  33203. ></DIV
  33204. ><DIV
  33205. CLASS="PART"
  33206. ><A
  33207. NAME="security"
  33208. ></A
  33209. ><DIV
  33210. CLASS="TITLEPAGE"
  33211. ><H1
  33212. CLASS="title"
  33213. >IV. Sicherheit</H1
  33214. ><DIV
  33215. CLASS="TOC"
  33216. ><DL
  33217. ><DT
  33218. ><B
  33219. >Inhaltsverzeichnis</B
  33220. ></DT
  33221. ><DT
  33222. >20. <A
  33223. HREF="#security.intro"
  33224. >Einfⁿhrung</A
  33225. ></DT
  33226. ><DT
  33227. >21. <A
  33228. HREF="#security.general"
  33229. >Allgemeine ▄berlegungen</A
  33230. ></DT
  33231. ><DT
  33232. >22. <A
  33233. HREF="#security.cgi-bin"
  33234. >CGI-Version</A
  33235. ></DT
  33236. ><DT
  33237. >23. <A
  33238. HREF="#security.apache"
  33239. >Apache-Modul</A
  33240. ></DT
  33241. ><DT
  33242. >24. <A
  33243. HREF="#security.filesystem"
  33244. >Dateisystem - Sicherheit</A
  33245. ></DT
  33246. ><DT
  33247. >25. <A
  33248. HREF="#security.database"
  33249. >Datenbank - Sicherheit</A
  33250. ></DT
  33251. ><DT
  33252. >26. <A
  33253. HREF="#security.errors"
  33254. >Fehlerbehandlung</A
  33255. ></DT
  33256. ><DT
  33257. >27. <A
  33258. HREF="#security.globals"
  33259. >Verwendung von Register Globals</A
  33260. ></DT
  33261. ><DT
  33262. >28. <A
  33263. HREF="#security.variables"
  33264. >Vom Nutzer ⁿbermittelte Daten</A
  33265. ></DT
  33266. ><DT
  33267. >29. <A
  33268. HREF="#security.hiding"
  33269. >Verstecken von PHP</A
  33270. ></DT
  33271. ><DT
  33272. >30. <A
  33273. HREF="#security.current"
  33274. >Aktuell bleiben</A
  33275. ></DT
  33276. ></DL
  33277. ></DIV
  33278. ></DIV
  33279. ><DIV
  33280. CLASS="chapter"
  33281. ><HR><H1
  33282. ><A
  33283. NAME="security.intro"
  33284. >Kapitel 20. Einfⁿhrung</A
  33285. ></H1
  33286. ><P
  33287. >    PHP ist eine mΣchtige Sprache, und der Interpreter, der in einen
  33288.    Webserver als Modul oder als separate <ACRONYM
  33289. CLASS="acronym"
  33290. >CGI</ACRONYM
  33291. >-Version
  33292.    eingebunden werden kann, kann auf Dateien zugreifen, Befehle
  33293.    ausfⁿhren und Netzwerkverbindungen zu einem Server herstellen.
  33294.    Diese Eigenschaften k÷nnen einen Webserver unsicher machen, wenn man
  33295.    es bei den Voreinstellungen belΣsst.
  33296.    PHP wurde besonders dafⁿr entwickelt, um eine sicherere Sprache als
  33297.    Perl oder C fⁿr die Erstellung von CGI-Programmen bereitzustellen.
  33298.    Mit der richtigen Wahl der Einstellungen beim Kompilieren und
  33299.    zur Laufzeit bietet PHP genau die Kombination aus Freiheit und
  33300.    Sicherheit, die gerade ben÷tigt wird.
  33301.   </P
  33302. ><P
  33303. >    Da es sehr viele verschiedene M÷glichkeiten gibt, PHP zu nutzen,
  33304.    gibt es viele Konfigurationseinstellungen, die das Verhalten von
  33305.    PHP beeinflussen. Eine gro▀e Auswahl an Einstellungen garantiert,
  33306.    dass man PHP fⁿr viele Zwecke einsetzen kann. Allerdings
  33307.    bedeutet das auch, dass es Kombinationen gibt, die eine Installation
  33308.    mit nur ungenⁿgender Sicherheit zur Folge haben.
  33309.   </P
  33310. ><P
  33311. >    Die FlexibilitΣt der Konfiguration konkurriert mit der FlexibilitΣt
  33312.    in der Programmierung. Mit PHP k÷nnen komplette Server Applikationen
  33313.    mit allen M÷glichkeiten eines Shell Benutzers erstellt werden, oder
  33314.    auch nur einfache Server Side Includes mit einem minimalen Risiko in
  33315.    einer streng kontrollierten Umgebung. Wie die Umgebung erstellt wird,
  33316.    und wie sicher diese ist, ist zu einem gro▀en Teil die Sache des PHP
  33317.    Entwicklers.
  33318.   </P
  33319. ><P
  33320. >    Dieses Kapitel beginnt mit einigen generellen RatschlΣgen zur Sicherheit,
  33321.    erklΣrt die verschiedenen Kombinationen der Konfigurationseinstellungen
  33322.    und unter welchen Gegebenheiten sie sicher genutzt werden k÷nnen, und
  33323.    beschreibt verschiedene ▄berlegungen zur Programmierung fⁿr verschiedene
  33324.    Sicherheitsstufen.
  33325.   </P
  33326. ></DIV
  33327. ><DIV
  33328. CLASS="chapter"
  33329. ><HR><H1
  33330. ><A
  33331. NAME="security.general"
  33332. >Kapitel 21. Allgemeine ▄berlegungen</A
  33333. ></H1
  33334. ><P
  33335. >     Ein komplett sicheres System ist praktisch ein Ding der Unm÷glichkeit,
  33336.     weshalb ein unter Sicherheitsprofis oft genutzter Ansatz ist, einen
  33337.     Mittelweg zwischen Risiko und Verwendbarkeit zu finden.
  33338.     Wenn jede von einem Benutzer ⁿbermittelte Variable zwei Formen von
  33339.     biometrischer Prⁿfung (wie z.B. ein Scan der Netzhaut und ein
  33340.     Fingerabdruck) verlangen wⁿrde, wΣre eine extrem hohe Ebene der
  33341.     Verantwortlichkeit erreicht. Ein sehr komplexes Formular auszufⁿllen
  33342.     wⁿrde auch eine halbe Stunde in Anspruch nehmen, die Benutzer dazu
  33343.     ermuntern k÷nnte, Wege zur Umgehung der Sicherheitsma▀nahmen zu suchen.
  33344.    </P
  33345. ><P
  33346. >     Die beste Sicherheit ist oft unaufdringlich genug um den Anforderungen
  33347.     zu entsprechen, ohne den Benutzer an seiner Arbeit zu hindern oder den
  33348.     Code-Autor mit ⁿbertriebener KomplexitΣt zu ⁿberlasten. TatsΣchlich
  33349.     sind einige Sicherheitsangriffe nur die Folge von allzu strengen
  33350.     Sicherheitsma▀nahmen, was mit der Zeit nur zu deren Unterminierung
  33351.     fⁿhrt.
  33352.    </P
  33353. ><P
  33354. >     Eine Phrase die es wert ist, sich an sie zu erinnern: Ein System ist nur
  33355.     so gut wie das schwΣchste Glied in der Kette. Wenn alle Transaktionen
  33356.     mittels Zeit, Ort, Transaktionstyp, etc. streng mitprotokolliert werden,
  33357.     der Benutzer aber nur mittels einem einzigen Cookie verifiziert wird,
  33358.     lΣsst die ZuverlΣssigkeit fⁿr die Bindung des Benutzers an das
  33359.     Transaktions-Log bedrohlich nach.
  33360.    </P
  33361. ><P
  33362. >     Denken Sie wΣhrend der Tests daran, dass Sie selbst fⁿr die einfachsten
  33363.     Seiten nicht alle M÷glichkeiten testen k÷nnen. Der von Ihnen vielleicht
  33364.     erwartete Input wird zu dem eines verstimmten Mitarbeiters oder eines
  33365.     Crackers der Monate Zeit hat, oder einer Katze, die ⁿber die Tastatur
  33366.     lΣuft in keinerlei Zusammenhang stehen. Deshalb betrachten Sie Ihren
  33367.     Code am Besten aus der logischen Perspektive um zu erkennen, wo
  33368.     unerwartete Daten eingebracht werden k÷nnen und fragen sich dann,
  33369.     wie diese modifiziert, reduziert, oder weiter ausgefⁿhrt werden.
  33370.    </P
  33371. ><P
  33372. >     Das Internet ist voll von Leuten die versuchen, sich durch
  33373.     Entschlⁿsseln/zerst÷ren Ihres Codes, den Zusammenbruch Ihres
  33374.     Systems, Einsetzen von unangebrachten Inhalten, und anderen, Ihren
  33375.     Tag interessant gestaltenden Ma▀nahmen, einen Namen zu machen.
  33376.     Es ist egal, ob Sie eine kleine oder gro▀e Site haben, Sie sind
  33377.     einfach ein Ziel wenn Sie online sind oder wenn Sie einen Server
  33378.     haben, zu dem man eine Verbindung aufbauen kann. Viele
  33379.     Cracker-Programme erkennen nicht die Gr÷▀e, sondern durchsieben
  33380.     einfach gewaltige IP Bl÷cke im Netz, um Opfer zu finden. Versuchen
  33381.     Sie, keines zu werden.
  33382.    </P
  33383. ></DIV
  33384. ><DIV
  33385. CLASS="chapter"
  33386. ><HR><H1
  33387. ><A
  33388. NAME="security.cgi-bin"
  33389. >Kapitel 22. CGI-Version</A
  33390. ></H1
  33391. ><DIV
  33392. CLASS="sect1"
  33393. ><H2
  33394. CLASS="sect1"
  33395. ><A
  33396. NAME="security.cgi-bin.attacks"
  33397. >M÷gliche Angriffe</A
  33398. ></H2
  33399. ><P
  33400. >     PHP als <ACRONYM
  33401. CLASS="acronym"
  33402. >CGI</ACRONYM
  33403. > zu nutzen, ist eine M÷glichkeit
  33404.     fⁿr Installationen, bei denen aus irgendwelchen Grⁿnden kein Modul in
  33405.     die Serversoftware eingebunden werden soll (wie beim Apache) oder fⁿr
  33406.     Systeme, bei denen verschiedene CGI-Wrapper genutzt werden sollen,
  33407.     um sichere chroot- und setuid-Umgebungen fⁿrr Skripte zu schaffen.
  33408.     Bei dieser Konfiguration wird das ausfⁿhrbare PHP-Binary ⁿblicherweise
  33409.     im cgi-bin Verzeichnis des Webservers installiert.
  33410.     CERT advisory <A
  33411. HREF="http://www.cert.org/advisories/CA-1996-11.html"
  33412. TARGET="_top"
  33413. >CA-96.11</A
  33414. >
  33415.     spricht sich gegen die Platzierung von Interpretern im cgi-bin
  33416.     Verzeichnis aus. Obwohl das PHP-Binary als eigenstΣndiger Interpreter
  33417.     verwendet werden kann, wurde PHP so entwickelt, um den durch diese
  33418.     Konfiguration m÷glich werdenden Angriffe vorzubeugen:
  33419.    </P
  33420. ><P
  33421. ></P
  33422. ><UL
  33423. ><LI
  33424. ><P
  33425. >Zugriff auf Systemdateien:
  33426.         <TT
  33427. CLASS="filename"
  33428. >http://my.host/cgi-bin/php?/etc/passwd</TT
  33429. >
  33430.       </P
  33431. ><P
  33432. >        Die auf ein Fragezeichen (?) folgende Abfrageinformation in einer
  33433.        URL wird durch das CGI-Interface als Kommandozeilenargument an den
  33434.        Interpreter weitergereicht. In der Kommandozeile wird ⁿblicherweise
  33435.        die im ersten Argument angegebene Datei von Interpretern ge÷ffnet
  33436.        und ausgefⁿhrt.
  33437.       </P
  33438. ><P
  33439. >        Beim Aufruf als CGI-Binary verweigert PHP die Interpretation der
  33440.        Kommandozeilenargumente.
  33441.       </P
  33442. ></LI
  33443. ><LI
  33444. ><P
  33445. >        Zugriff auf beliebige Web-Dokumente auf dem Server: <TT
  33446. CLASS="filename"
  33447. >http://my.host/cgi-bin/php/secret/doc.html</TT
  33448. >
  33449.       </P
  33450. ><P
  33451. >        Der Teil der URL-Pfadinformation nach dem Namen der PHP BinΣrdatei,
  33452.        <TT
  33453. CLASS="filename"
  33454. >/secret/doc.html</TT
  33455. > wird im
  33456.        allgemeinen benutzt, um den Namen der Datei zu ⁿbergeben,
  33457.        die durch das <ACRONYM
  33458. CLASS="acronym"
  33459. >CGI</ACRONYM
  33460. >-Programm ge÷ffnet und
  33461.        interpretiert werden soll.
  33462.        Normalerweise werden einige EintrΣge in der Konfigurationsdatei
  33463.        des Webservers benutzt (Apache: Action), um Aufrufe von Dokumenten
  33464.        wie <TT
  33465. CLASS="filename"
  33466. >http://my.host/secret/script.php</TT
  33467. >
  33468.        an den PHP-Interpreter umzuleiten. Bei dieser Konfiguration
  33469.        ⁿberprⁿft der Webserver zuerst die Zugriffsrechte im Verzeichnis
  33470.        <TT
  33471. CLASS="filename"
  33472. >/secret</TT
  33473. > und erstellt anschlie▀end
  33474.        den umgeleiteten Aufruf <TT
  33475. CLASS="filename"
  33476. >http://my.host/cgi-bin/php/secret/script.php</TT
  33477. >.
  33478.        Unglⁿcklicherweise wird, wenn der Aufruf bereits in dieser Form
  33479.        geschieht, vom Webserver keine Zugriffsⁿberprⁿfung der Datei
  33480.        <TT
  33481. CLASS="filename"
  33482. >/secret/script.php</TT
  33483. >, sondern
  33484.        lediglich der Datei <TT
  33485. CLASS="filename"
  33486. >/cgi-bin/php</TT
  33487. >
  33488.        vorgenommen. So ist
  33489.        jeder Benutzer, der auf <TT
  33490. CLASS="filename"
  33491. >/cgi-bin/php</TT
  33492. >
  33493.        zugreifen darf in der Lage, sich zu jedem geschⁿtzten Dokument
  33494.        auf dem Webserver Zugriff zu verschaffen.
  33495.       </P
  33496. ><P
  33497. >        Bei PHP k÷nnen beim Kompilieren die Konfigurationsoption <A
  33498. HREF="#configure.enable-force-cgi-redirect"
  33499. >--enable-force-cgi-redirect</A
  33500. >
  33501.        und zur Laufzeit die Konfigurationsdirektiven <A
  33502. HREF="#ini.doc-root"
  33503. >doc_root</A
  33504. > und <A
  33505. HREF="#ini.user-dir"
  33506. >user_dir</A
  33507. >
  33508.        benutzt werden, um diesen Angriff zu verhindern, falls
  33509.        der Verzeichnisbaum des Servers Verzeichnisse mit
  33510.        ZugriffsbeschrΣnkungen beinhaltet.
  33511.        Ausfⁿhrliche Informationen ⁿber die verschiedenen Kombinationen
  33512.        siehe weiter unten.
  33513.       </P
  33514. ></LI
  33515. ></UL
  33516. ></DIV
  33517. ><DIV
  33518. CLASS="sect1"
  33519. ><HR><H2
  33520. CLASS="sect1"
  33521. ><A
  33522. NAME="security.cgi-bin.default"
  33523. >Fall 1: Nur ÷ffentliche Dateien vorhanden</A
  33524. ></H2
  33525. ><P
  33526. >      Wenn der Server keine Inhalte hat, die durch Passwort oder
  33527.      IP-basierte Zugriffskontrolle geschⁿtzt sind, werden diese
  33528.      Konfigurationsoptionen nicht ben÷tigt.
  33529.      Wenn der Webserver keine Redirects erlaubt oder keine M÷glichkeit
  33530.      hat, dem PHP-Binary mitzuteilen dass es sich um eine sicher umgeleitete
  33531.      Anfrage handelt, kann die Option <A
  33532. HREF="#configure.enable-force-cgi-redirect"
  33533. >--enable-force-cgi-redirect</A
  33534. >
  33535.      im configure-Script angegeben werden. Nichtsdestotrotz mⁿssen
  33536.      Sie sicherstellen, dass Ihre PHP-Skripte nicht auf die eine oder
  33537.      andere Art des Aufrufs angewiesen sind, weder direkt durch
  33538.      <TT
  33539. CLASS="filename"
  33540. >http://my.host/cgi-bin/php/dir/script.php</TT
  33541. >
  33542.      noch durch einen Redirect <TT
  33543. CLASS="filename"
  33544. >http://my.host/dir/script.php</TT
  33545. >.
  33546.     </P
  33547. ><P
  33548. >      Beim Apache kann der Redirect durch den Gebrauch von
  33549.      AddHandler und Action konfiguriert werden (siehe unten).
  33550.     </P
  33551. ></DIV
  33552. ><DIV
  33553. CLASS="sect1"
  33554. ><HR><H2
  33555. CLASS="sect1"
  33556. ><A
  33557. NAME="security.cgi-bin.force-redirect"
  33558. >Fall 2: --enable-force-cgi-redirect benutzen</A
  33559. ></H2
  33560. ><P
  33561. >      Diese beim Kompilieren verwendete Option verhindert grundsΣtzlich
  33562.      den Aufruf von PHP mit einer URL wie <TT
  33563. CLASS="filename"
  33564. >http://my.host/cgi-bin/php/secretdir/script.php</TT
  33565. >.
  33566.      Stattdessen parst PHP in diesem Modus nur dann, wenn der Aufruf
  33567.      durch einen korrekten Redirect des Webservers erfolgte.
  33568.     </P
  33569. ><P
  33570. >      Normalerweise wird der Redirect in der Apache-Konfiguration mit den
  33571.      folgenden EintrΣgen festgelegt:</P
  33572. ><TABLE
  33573. BORDER="0"
  33574. BGCOLOR="#E0E0E0"
  33575. CELLPADDING="5"
  33576. ><TR
  33577. ><TD
  33578. ><PRE
  33579. CLASS="apache-conf"
  33580. >Action php-script /cgi-bin/php
  33581. AddHandler php-script .php</PRE
  33582. ></TD
  33583. ></TR
  33584. ></TABLE
  33585. ><P
  33586. >      Diese Option wurde nur mit dem Apache Webserver getestet und
  33587.      ist abhΣngig davon, wie Apache die nicht standardmΣ▀ige
  33588.      CGI-Umgebungsvariable <VAR
  33589. CLASS="envar"
  33590. >REDIRECT_STATUS</VAR
  33591. > bei
  33592.      Redirect-Anfragen setzt.
  33593.      Sollte Ihr Webserver keine M÷glichkeit unterstⁿtzen, zu ⁿbermitteln,
  33594.      ob es sich um einen direkte Aufruf oder einen Redirect handelt,
  33595.      k÷nnen Sie diese Option nicht verwenden und mⁿssen einen der
  33596.      anderen hier beschriebenen Wege gehen, die CGI-Version zu
  33597.      nutzen.
  33598.     </P
  33599. ></DIV
  33600. ><DIV
  33601. CLASS="sect1"
  33602. ><HR><H2
  33603. CLASS="sect1"
  33604. ><A
  33605. NAME="security.cgi-bin.doc-root"
  33606. >Fall 3: doc_root oder user_dir festlegen</A
  33607. ></H2
  33608. ><P
  33609. >      Aktiven Inhalt, wie beispielsweise Skripts und ausfⁿhrbare
  33610.      Dateien, in den Dokumentverzeichnissen des Webservers abzulegen,
  33611.      wird manchmal als unsichere Methode angesehen.
  33612.      Wenn, beispielsweise aufgrund von Konfigurationsfehlern, die
  33613.      Skripte nicht ausgefⁿhrt, sondern als regulΣre HTML-Dokumente
  33614.      angezeigt werden kann dies ein Durchsickern von geistigem Eigentum
  33615.      und sicherheitsrelevanter Informationen (Passw÷rter!) zur Folge
  33616.      haben. Deshalb ziehen es viele Systemadministratoren vor, eine
  33617.      zweite Verzeichnisstruktur fⁿr Skripte einzurichten, auf die nur
  33618.      durch das PHP-CGI zugegriffen werden kann. Diese werden dann stets
  33619.      interpretiert und nicht angezeigt.
  33620.     </P
  33621. ><P
  33622. >      Auch wenn die Methode zum sichergestellten Verhindern einer Umleitung
  33623.      von Anfragen (wie im vorangegangenen Kapitel beschrieben) nicht
  33624.      verfⁿgbar ist, ist es notwendig, ein doc_root fⁿr Skripte  zusΣtzlich
  33625.      zum Web-Dokumentenverzeichnis einzurichten.
  33626.     </P
  33627. ><P
  33628. >      Sie k÷nnen das PHP-Skriptverzeichnis durch die Direktive
  33629.      <A
  33630. HREF="#ini.doc-root"
  33631. >doc_root</A
  33632. > in der
  33633.      <A
  33634. HREF="#configuration.file"
  33635. >Konfigurationsdatei</A
  33636. >
  33637.      festlegen, oder Sie setzen die Umgebungsvariable
  33638.      <VAR
  33639. CLASS="envar"
  33640. >PHP_DOCUMENT_ROOT</VAR
  33641. >. Wenn sie gesetzt ist, wird die
  33642.      CGI-Version von PHP den Namen der zu ÷ffnenden Datei stets aus
  33643.      <VAR
  33644. CLASS="parameter"
  33645. >doc_root</VAR
  33646. > und der Pfadinformation der Anfrage
  33647.      zusammensetzen, sodass man sicher sein kann, dass au▀erhalb dieses
  33648.      Verzeichnisses keine Skripte ausgefⁿhrt werden (au▀er
  33649.      <VAR
  33650. CLASS="parameter"
  33651. >user_dir</VAR
  33652. >, siehe unten).
  33653.     </P
  33654. ><P
  33655. >      Eine weitere hier nⁿtzliche Option ist <A
  33656. HREF="#ini.user-dir"
  33657. >user_dir</A
  33658. >. Wenn das
  33659.      <VAR
  33660. CLASS="parameter"
  33661. >user_dir</VAR
  33662. > nicht gesetzt ist, hat nur
  33663.      <VAR
  33664. CLASS="parameter"
  33665. >doc_root</VAR
  33666. > Einfluss auf die zu ÷ffnende Datei.
  33667.      Der Aufruf einer URL wie <TT
  33668. CLASS="filename"
  33669. >http://my.host/~user/doc.php</TT
  33670. > hat nicht zum
  33671.      Ergebnis, dass eine Datei im Home-Verzeichnis des Benutzers ge÷ffnet
  33672.      wird, sondern eine Datei namens <TT
  33673. CLASS="filename"
  33674. >~user/doc.php</TT
  33675. >
  33676.      unterhalb des doc_root (Ja, ein Verzeichnisname, der mit einer Tilde anfΣngt
  33677.      [<VAR
  33678. CLASS="literal"
  33679. >~</VAR
  33680. >]).
  33681.     </P
  33682. ><P
  33683. >      Ist das user_dir beispielsweise auf <TT
  33684. CLASS="filename"
  33685. >public_php</TT
  33686. > gesetzt,
  33687.      wird eine Anfrage wie <TT
  33688. CLASS="filename"
  33689. >http://my.host/~user/doc.php</TT
  33690. >
  33691.      eine Datei namens <TT
  33692. CLASS="filename"
  33693. >doc.php</TT
  33694. > im Verzeichnis
  33695.      <TT
  33696. CLASS="filename"
  33697. >public_php</TT
  33698. > im Heimatverzeichnis
  33699.      des Benutzers ÷ffnen.  Wenn das Heimatverzeichnis des Benutzers
  33700.      <TT
  33701. CLASS="filename"
  33702. >/home/user</TT
  33703. > ist, so ist die ausgefⁿhrte
  33704.      Datei <TT
  33705. CLASS="filename"
  33706. >/home/user/public_php/doc.php</TT
  33707. >.
  33708.     </P
  33709. ><P
  33710. >      Die <VAR
  33711. CLASS="parameter"
  33712. >user_dir</VAR
  33713. >-Expansion erfolgt ohne Berⁿcksichtigung
  33714.      der <VAR
  33715. CLASS="parameter"
  33716. >doc_root</VAR
  33717. > Einstellung. So k÷nnen Zugriffe
  33718.      auf die Dokumenten- und Benutzerverzeichnisse separat gesteuert werden.
  33719.     </P
  33720. ></DIV
  33721. ><DIV
  33722. CLASS="sect1"
  33723. ><HR><H2
  33724. CLASS="sect1"
  33725. ><A
  33726. NAME="security.cgi-bin.shell"
  33727. >Fall 4: PHP-Parser au▀erhalb des Webverzeichnisbaums</A
  33728. ></H2
  33729. ><P
  33730. >      Eine sehr sichere Sache ist es, das PHP-Parser-Binary irgendwo
  33731.      au▀erhalb des Webverzeichnisbaums zu platzieren, beispielsweise
  33732.      in <TT
  33733. CLASS="filename"
  33734. >/usr/local/bin</TT
  33735. >.  Der einzige
  33736.      Nachteil dieses Verfahrens ist, dass eine Zeile Σhnlich der folgenden:
  33737.      <DIV
  33738. CLASS="informalexample"
  33739. ><P
  33740. ></P
  33741. ><A
  33742. NAME="AEN5652"
  33743. ></A
  33744. ><TABLE
  33745. BORDER="0"
  33746. BGCOLOR="#E0E0E0"
  33747. CELLPADDING="5"
  33748. ><TR
  33749. ><TD
  33750. ><PRE
  33751. CLASS="programlisting"
  33752. >#!/usr/local/bin/php</PRE
  33753. ></TD
  33754. ></TR
  33755. ></TABLE
  33756. ><P
  33757. ></P
  33758. ></DIV
  33759. >
  33760.      als erste Zeile in jeder Datei, die PHP-Tags enthΣlt, stehen muss.
  33761.      Au▀erdem muss die Datei ausfⁿhrbar sein. Ansonsten ist sie genauso
  33762.      zu behandeln wie ein beliebiges CGI-Script in Perl oder sh oder
  33763.      anderen gebrΣuchlichen Scriptsprachen, die den
  33764.      <VAR
  33765. CLASS="literal"
  33766. >#!</VAR
  33767. > shell-escape-Mechanismus nutzen, um sich
  33768.      selbst aufzurufen.
  33769.     </P
  33770. ><P
  33771. >      Damit PHP bei dieser Konfiguration die <VAR
  33772. CLASS="envar"
  33773. >PATH_INFO</VAR
  33774. >- und
  33775.      <VAR
  33776. CLASS="envar"
  33777. >PATH_TRANSLATED</VAR
  33778. >-Informationen korrekt auswertet,
  33779.      sollte der PHP-Parser mit der Option <A
  33780. HREF="#configure.enable-discard-path"
  33781. >--enable-discard-path</A
  33782. >
  33783.      kompiliert werden.
  33784.     </P
  33785. ></DIV
  33786. ></DIV
  33787. ><DIV
  33788. CLASS="chapter"
  33789. ><HR><H1
  33790. ><A
  33791. NAME="security.apache"
  33792. >Kapitel 23. Apache-Modul</A
  33793. ></H1
  33794. ><P
  33795. >     Wenn PHP als Apache-Modul eingesetzt wird, ⁿbernimmt es die
  33796.     Benutzerrechte des Apache (ⁿblicherweise user "nobody"). Das hat
  33797.     verschiedene Auswirkungen auf Sicherheit und Authentifizierung, z.B.:
  33798.     Wenn Sie PHP zum Zugriff auf eine Datenbank benutzen, es sei denn
  33799.     diese Datenbank hat eine integrierte Zugriffskontrolle, mⁿssen Sie
  33800.     dem Benutzer "nobody" Zugriffsrechte auf die Datenbank erteilen. Das
  33801.     hei▀t, dass ein b÷swilliges Skript auch Benutzerkennung und Passwort
  33802.     auf die Datenbank zugreifen, und sie verΣndern k÷nnte. Es ist durchaus
  33803.     m÷glich, dass ein Web-Spider ⁿber die Webseite eines
  33804.     Datenbankadministrators stolpert, und alle Ihre Datenbanken l÷scht.
  33805.     Sie k÷nnen sich dagegen mit Apache Authentifizierung schⁿtzen, oder
  33806.     ein eigenes Zugangsmodell unter Verwendung von LDAP, .htaccess Dateien,
  33807.     etc. entwerfen, und diesen Code als Teil Ihrer PHP Skripte einbinden.
  33808.    </P
  33809. ><P
  33810. >     Es wurde festgestellt, dass wenn einmal die Sicherheitsma▀nahmen so
  33811.     weit eingerichtet sind dass dem PHP User (in diesem Fall ein Apache
  33812.     User) nur mehr ein geringes Risiko bleibt, PHP daran gehindert wird,
  33813.     virenverseuchte Dateien in das Benutzerverzeichnis zu schreiben. Oder
  33814.     vielleicht wurde es auch daran gehindert, auf Datenbanken zuzugreifen
  33815.     oder diese gar zu verΣndern. In gleicher Weise wird auch davor
  33816.     abgehalten, "gute" oder "b÷sartige" Dateien zu schreiben, oder "gute"
  33817.     bzw. "b÷sartige" Datenbanktransaktionen durchzufⁿhren.
  33818.    </P
  33819. ><P
  33820. >     Ein hΣufig gemachter Fehler in Punkto Sicherheit ist Apache Root-Rechte
  33821.     zu erteilen, oder die M÷glichkeiten von Apache in einer anderen Weise
  33822.     auszuweiten.
  33823.    </P
  33824. ><P
  33825. >     Die Ausweitung der Benutzerrechte fⁿr Apache auf root ist sehr
  33826.     gefΣhrlich, und kann dem gesamten System schaden, denn mit sudo,
  33827.     chroot, oder anderwΣrtig als root zu arbeiten sollte niemand anders
  33828.     als den Sicherheitsprofis ⁿberlassen werden.
  33829.    </P
  33830. ><P
  33831. >     Es gibt auch ein paar einfachere L÷sungen. Mit
  33832.     <A
  33833. HREF="#ini.open-basedir"
  33834. >open_basedir()</A
  33835. > k÷nnen Sie
  33836.     kontrollieren, welche Verzeichnisse PHP benutzen darf oder nicht. Sie
  33837.     k÷nnen auch einen Bereich nur fⁿr Apache einrichten, um alle
  33838.     webbasierten AktivitΣten auf nicht-Benutzer- bzw. nicht-System-Dateien
  33839.     einzuschrΣnken.
  33840.    </P
  33841. ></DIV
  33842. ><DIV
  33843. CLASS="chapter"
  33844. ><HR><H1
  33845. ><A
  33846. NAME="security.filesystem"
  33847. >Kapitel 24. Dateisystem - Sicherheit</A
  33848. ></H1
  33849. ><P
  33850. >     PHP ist von den in den meisten Serversystemen implementierten
  33851.     Sicherheitseinstellungen hinsichtlich der Berechtigungen auf Datei-
  33852.     und Verzeichnisebene abhΣngig. Dies verleiht Ihnen Kontrolle darⁿber,
  33853.     welche Dateien in dem Dateisystem gelesen werden dⁿrfen. Vorsicht ist
  33854.     bei weltweit lesbaren Dateien geboten um sicherzustellen, dass diese
  33855.     sicher von allen Usern mit Zugriff auf dieses Dateisystem (nur) gelesen
  33856.     werden k÷nnen.
  33857.    </P
  33858. ><P
  33859. >     Da PHP entwickelt wurde um Zugriffe auf das Dateisystem auf Benutzebene
  33860.     zu erlauben, ist es natⁿrlich auch m÷glich ein PHP Skript zu schreiben
  33861.     das Ihnen erlaubt Systemdateien wie /etc/passwd zu lesen,
  33862.     Ethernetverbindungen zu modifizieren, enorme DruckauftrΣge zu senden,
  33863.     etc. Dies hat offensichtliche Implikationen, indem Sie sicherstellen
  33864.     mⁿssen, dass alle von Ihnen zu lesenden bzw. zu schreibenden Dateien
  33865.     auch die richtigen sind.
  33866.    </P
  33867. ><P
  33868. >     Stellen Sie sich folgendes Skript vor, in dem ein User zum Ausdruck
  33869.     bringt, dass gerne eine Datei in seinem Heimatverzeichnis l÷schen
  33870.     m÷chte. Dies geht von einer Situation aus, in der ein PHP Web-Interface
  33871.     regelmΣ▀ig zum Dateimanagement verwendet wird, und der Apache User
  33872.     ist auch berechtigt, in seinem Heimatverzeichnis Dateien zu l÷schen.
  33873.    </P
  33874. ><P
  33875. >     <TABLE
  33876. WIDTH="100%"
  33877. BORDER="0"
  33878. CELLPADDING="0"
  33879. CELLSPACING="0"
  33880. CLASS="EXAMPLE"
  33881. ><TR
  33882. ><TD
  33883. ><DIV
  33884. CLASS="example"
  33885. ><A
  33886. NAME="AEN5673"
  33887. ></A
  33888. ><P
  33889. ><B
  33890. >Beispiel 24-1. Schlechte Variablenprⁿfung fⁿhrt zu....</B
  33891. ></P
  33892. ><TABLE
  33893. BORDER="0"
  33894. BGCOLOR="#E0E0E0"
  33895. CELLPADDING="5"
  33896. ><TR
  33897. ><TD
  33898. ><PRE
  33899. CLASS="php"
  33900. ><?php
  33901. // L÷schen einer Datei aus dem Heimatverzeichnis des Users
  33902. $username = $_POST['user_submitted_name'];
  33903. $homedir = "/home/$username";
  33904. $file_to_delete = "$userfile";
  33905. unlink ("$homedir/$userfile");
  33906. echo "$file_to_delete wurde gel÷scht!";
  33907. ?></PRE
  33908. ></TD
  33909. ></TR
  33910. ></TABLE
  33911. ></DIV
  33912. ></TD
  33913. ></TR
  33914. ></TABLE
  33915. >
  33916.    Da der Benutzername ⁿber ein User-Formular zu posten ist, kann
  33917.    jeder einen Benutzer- und Dateinamen von jemand anderen ⁿbertragen,
  33918.    und Dateien l÷schen. In diesem Fall empfiehlt es sich, eine andere
  33919.    Form der Authentifizierung zu verwenden. Stellen Sie sich vor was
  33920.    passieren wⁿrde, wenn die ⁿbertragenen Variablen "../etc/" und
  33921.    "passwd" beinhalten wⁿrden. Der Code wⁿrde dann effektiv lesen:
  33922.     <TABLE
  33923. WIDTH="100%"
  33924. BORDER="0"
  33925. CELLPADDING="0"
  33926. CELLSPACING="0"
  33927. CLASS="EXAMPLE"
  33928. ><TR
  33929. ><TD
  33930. ><DIV
  33931. CLASS="example"
  33932. ><A
  33933. NAME="AEN5676"
  33934. ></A
  33935. ><P
  33936. ><B
  33937. >Beispiel 24-2. ... Ein Angriff auf das Dateisystem</B
  33938. ></P
  33939. ><TABLE
  33940. BORDER="0"
  33941. BGCOLOR="#E0E0E0"
  33942. CELLPADDING="5"
  33943. ><TR
  33944. ><TD
  33945. ><PRE
  33946. CLASS="php"
  33947. ><?php
  33948. // l÷scht eine Datei irgendwo auf der Festplatte, wo der
  33949. // Benutzer die n÷tigen Rechte besitzt. Wenn PHP root hat:
  33950. $username = "../etc/";
  33951. $homedir = "/home/../etc/";
  33952. $file_to_delete = "passwd";
  33953. unlink ("/home/../etc/passwd");
  33954. echo "/home/../etc/passwd wurde gel÷scht!";
  33955. ?></PRE
  33956. ></TD
  33957. ></TR
  33958. ></TABLE
  33959. ></DIV
  33960. ></TD
  33961. ></TR
  33962. ></TABLE
  33963. >
  33964.     Es gibt zwei wichtige Kriterien die Sie beachten sollten, um diese
  33965.     Dinge zu vermeiden:
  33966.     <P
  33967. ></P
  33968. ><UL
  33969. ><LI
  33970. ><P
  33971. >        Erteilen Sie dem PHP Web-user (BinΣrdatei) nur eingeschrΣnkte Rechte.
  33972.       </P
  33973. ></LI
  33974. ><LI
  33975. ><P
  33976. >        Prⁿfen Sie alle ⁿbertragenen Variablen.
  33977.       </P
  33978. ></LI
  33979. ></UL
  33980. >
  33981.     Hier ist ein verbessertes Skript:
  33982.     <TABLE
  33983. WIDTH="100%"
  33984. BORDER="0"
  33985. CELLPADDING="0"
  33986. CELLSPACING="0"
  33987. CLASS="EXAMPLE"
  33988. ><TR
  33989. ><TD
  33990. ><DIV
  33991. CLASS="example"
  33992. ><A
  33993. NAME="AEN5684"
  33994. ></A
  33995. ><P
  33996. ><B
  33997. >Beispiel 24-3. Etwas sicherere Prⁿfung des Dateinamens</B
  33998. ></P
  33999. ><TABLE
  34000. BORDER="0"
  34001. BGCOLOR="#E0E0E0"
  34002. CELLPADDING="5"
  34003. ><TR
  34004. ><TD
  34005. ><PRE
  34006. CLASS="php"
  34007. ><?php
  34008. // l÷scht eine Datei von der Festplatte, auf die
  34009. // der PHP user Zugriff hat.
  34010. $username = $_SERVER['REMOTE_USER']; // verwendet eine
  34011.                                      // Authentifizierungsmethode
  34012. $homedir = "/home/$username";
  34013.  
  34014. $file_to_delete = basename("$userfile"); // den Pfad entfernen
  34015. unlink ($homedir/$file_to_delete);
  34016.  
  34017. $fp = fopen("/home/logging/filedelete.log","+a"); //logge die L÷schung
  34018. $logstring = "$username $homedir $file_to_delete";
  34019. fputs ($fp, $logstring);
  34020. fclose($fp);
  34021.  
  34022. echo "$file_to_delete wurde gel÷scht!";
  34023. ?></PRE
  34024. ></TD
  34025. ></TR
  34026. ></TABLE
  34027. ></DIV
  34028. ></TD
  34029. ></TR
  34030. ></TABLE
  34031. >
  34032.     Auch dies nicht v÷llig makellos. Wenn Ihr Authentifizierungssystem
  34033.     Benutzern erlauben sollte, deren eigene Logins zu kreieren, und ein
  34034.     Benutzer wΣhlt den Login "../etc", ist das System wieder aufgedeckt.
  34035.     Aus diesem Grund ziehen Sie es vielleicht vor, einen besseren Check
  34036.     zu schreiben:
  34037.     <TABLE
  34038. WIDTH="100%"
  34039. BORDER="0"
  34040. CELLPADDING="0"
  34041. CELLSPACING="0"
  34042. CLASS="EXAMPLE"
  34043. ><TR
  34044. ><TD
  34045. ><DIV
  34046. CLASS="example"
  34047. ><A
  34048. NAME="AEN5687"
  34049. ></A
  34050. ><P
  34051. ><B
  34052. >Beispiel 24-4. Sicherere Dateinamensprⁿfung</B
  34053. ></P
  34054. ><TABLE
  34055. BORDER="0"
  34056. BGCOLOR="#E0E0E0"
  34057. CELLPADDING="5"
  34058. ><TR
  34059. ><TD
  34060. ><PRE
  34061. CLASS="php"
  34062. ><?php
  34063. $username = $HTTP_SERVER_VARS['REMOTE_USER']; // verwendet eine
  34064.                                               // Authentifizierungsmethode
  34065. $homedir = "/home/$username";
  34066.  
  34067. if (!ereg('^[^./][^/]*$', $userfile))
  34068.     die('bad filename'); // "DIE", gehen Sie nicht weiter
  34069.  
  34070. if (!ereg('^[^./][^/]*$', $username))
  34071.      die('bad username'); // "DIE", gehen Sie nicht weiter
  34072. //etc...
  34073. ?></PRE
  34074. ></TD
  34075. ></TR
  34076. ></TABLE
  34077. ></DIV
  34078. ></TD
  34079. ></TR
  34080. ></TABLE
  34081. >
  34082.    </P
  34083. ><P
  34084. >     AbhΣngig vom Betriebssystem gibt es eine gro▀e Anzahl Dateien mit der
  34085.     Sie sich befassen sollten, inklusive EintrΣge fⁿr GerΣte (/dev/ oder
  34086.     com1), Konfigurationsdateien (/etc/ Dateien und die .ini Dateien), gut
  34087.     bekannte Verzeichnisse (/home/, My Documents), etc. Aus diesem Grund
  34088.     ist es gew÷hnlich einfacher eine Vorgangsweise einzufⁿhren, bei der
  34089.     au▀er den von Ihnen explizit erlaubten Dingen alles verboten ist.
  34090.    </P
  34091. ></DIV
  34092. ><DIV
  34093. CLASS="chapter"
  34094. ><HR><H1
  34095. ><A
  34096. NAME="security.database"
  34097. >Kapitel 25. Datenbank - Sicherheit</A
  34098. ></H1
  34099. ><P
  34100. >     Heutzutage sind Datenbanken die Hauptkomponenten jeder Webbasierten
  34101.     Applikation, aufgrund welcher Websites verschiedene dynamische Inhalte
  34102.     anbieten k÷nnen. Nachdem heikle oder geheime Informationen in solch einer
  34103.     Datenbank gespeichert werden k÷nnen, sollten Sie deren Schutz ernsthaft
  34104.     bedenken.
  34105.    </P
  34106. ><P
  34107. >     Um Informationen zu bekommen oder zu speichern, mⁿssen Sie eine legitime
  34108.     Abfrage senden, das Ergebnis holen, und die Verbindung schlie▀en.
  34109.     Heutzutage ist die allgemein verwendete Abfragesprache fⁿr solche
  34110.     Interaktionen die Structured Query Language (SQL). Sehen Sie, wie sich ein
  34111.     Angreifer <A
  34112. HREF="#security.database.sql-injection"
  34113. >an einer SQL
  34114.     Abfrage zu schaffen machen</A
  34115. > kann.
  34116.    </P
  34117. ><P
  34118. >     Sie werden merken, dass PHP Ihre Datenbank alleine nicht schⁿtzen kann.
  34119.     Die folgenden Abschnitte sind eine Einfⁿhrung in die Grundlagen, wie man
  34120.     innerhalb von PHP Skripten auf Datenbanken zugreift und diese manipuliert.
  34121.    </P
  34122. ><P
  34123. >     Denken Sie an diese einfache Regel: tief gestaffelte Verteidigung. Je mehr
  34124.     Platz Sie den Ma▀nahmen zum Schutz Ihrer Datenbank geben, desto geringer
  34125.     ist die Wahrscheinlichkeit, dass ein Angreifer Erfolg hat, und gespeicherte
  34126.     Geheiminformationen aufdeckt oder missbraucht. Gutes Design des
  34127.     Datenbankschemas und die Applikation wird mit Ihren gr÷▀ten Befⁿrchtungen
  34128.     fertig.
  34129.    </P
  34130. ><DIV
  34131. CLASS="sect1"
  34132. ><HR><H2
  34133. CLASS="sect1"
  34134. ><A
  34135. NAME="security.database.design"
  34136. >Datenbanken designen</A
  34137. ></H2
  34138. ><P
  34139. >       Der Erste Schritt liegt immer im Erstellen der Datenbank, au▀er Sie wollen
  34140.       eine bereits existierende Dritter verwenden. Ist eine Datenbank erstellt,
  34141.       ist sie einem Eigentⁿmer zugewiesen, welcher das Kommando zum Erstellen
  34142.       ausgefⁿhrt hat. Gew÷hnlich kann nur der Eigentⁿmer (oder ein Superuser)
  34143.       alles mit den Objekten in dieser Datenbank machen, und um anderen Benutzern
  34144.       die Verwendung zu erlauben, mⁿssen Rechte vergeben werden.
  34145.      </P
  34146. ><P
  34147. >       Applikationen sollten sich mit der Datenbank nie als deren Eigentⁿmer
  34148.       oder als ein Superuser verbinden, da diese Benutzer jede gewollte Abfrage
  34149.       ausfⁿhren k÷nnen, um z.B. das Schema zu modifizieren (z.B. Tabellen
  34150.       l÷schen) oder den gesamten Inhalt l÷schen.
  34151.      </P
  34152. ><P
  34153. >       Sie k÷nnen verschiedene Datenbanknutzer mit sehr limitierten Rechten auf
  34154.       Datenbankobjekte fⁿr jeden Aspekt Ihrer Applikation anlegen. Nur die
  34155.       wirklich ben÷tigten Rechte sollten gewΣhrt werden, und vermeiden Sie, dass
  34156.       der gleiche Benutzer in verschiedenen AnwendungsfΣllen mit der Datenbank
  34157.       interagieren kann. Das hei▀t, dass Eindringlinge, welche unter Verwendung
  34158.       einer dieser Referenzen Zugriff auf Ihre Datenbank erlangt haben, nur so
  34159.       viele ─nderungen durchfⁿhren k÷nnen, wie es Ihre Applikation kann.
  34160.      </P
  34161. ><P
  34162. >       Implementieren Sie nicht alle GeschΣftslogik in die Webapplikation (z.B.
  34163.       Ihr Skript), sondern tun Sie das im Datenbankschema unter Verwendung von
  34164.       Sichten, Triggern, oder Regeln. Wenn sich das System entwickelt, werden
  34165.       neu zu ÷ffnende Ports zu der Datenbank vorgesehen, und Sie mⁿssen die
  34166.       Logik in jedem Datenbank-Client neu implementieren. ▄berdies k÷nnen
  34167.       Trigger verwendet werden, um transparent und automatisch mit Feldern
  34168.       umzugehen, welche beim debuggen Ihrer Applikation oder beim
  34169.       Zurⁿckverfolgen von Transaktionen oft einen Einblick gewΣhren.
  34170.      </P
  34171. ></DIV
  34172. ><DIV
  34173. CLASS="sect1"
  34174. ><HR><H2
  34175. CLASS="sect1"
  34176. ><A
  34177. NAME="security.database.connection"
  34178. >Zur Datenbank verbinden</A
  34179. ></H2
  34180. ><P
  34181. >      Vielleicht wollen Sie die Verbindungen ⁿber SSL herstellen, um die
  34182.      Client/Server Kommunikation fⁿr eine erh÷hte Sicherheit zu verschlⁿsseln,
  34183.      oder aber auch ssh verwenden, um die Netzwerkverbindung zwischen den
  34184.      Clients und dem Datenbankserver zu verschlⁿsseln. Ist eines davon
  34185.      realisiert, wird ein Monitoring Ihres Verkehrs und das Erlangen von
  34186.      Informationen zu harter Arbeit.
  34187.     </P
  34188. ></DIV
  34189. ><DIV
  34190. CLASS="sect1"
  34191. ><HR><H2
  34192. CLASS="sect1"
  34193. ><A
  34194. NAME="security.database.storage"
  34195. >Verschlⁿsseltes Speichermodell</A
  34196. ></H2
  34197. ><P
  34198. >      SSL/SSH schⁿtzt zwar die gerade auf dem Weg befindlichen Daten vom Client
  34199.      zum Server, jedoch nicht die dauernd in einer Datenbank gespeicherten
  34200.      Daten. SSL ist ein "auf-der-Leitung" Protokoll.
  34201.     </P
  34202. ><P
  34203. >      Hat ein Angreifer direkten Zugriff auf Ihre Datenbank (den Webserver
  34204.      umgehend), k÷nnen die gespeicherten heiklen Daten aufgedeckt oder
  34205.      zweckentfremdet werden, au▀er wenn die Information von der Datenbank selbst
  34206.      geschⁿtzt ist. Die Daten zu verschlⁿsseln ist ein guter Weg, diese Gefahr
  34207.      zu mildern, doch bieten nur wenige Datenbanken diese Art der
  34208.      Verschlⁿsselung von Daten.
  34209.     </P
  34210. ><P
  34211. >      Der einfachste Weg, dieses Problem zu umgehen ist, erst einmal Ihr eigenes
  34212.      Verschlⁿsselungspaket zu erstellen, und dieses dann in Ihren PHP Skripten
  34213.      zu nutzen. PHP kann Ihnen in diesem Fall mit seinen verschiedenen
  34214.      Erweiterungen helfen, wie z.B. <A
  34215. HREF="#ref.mcrypt"
  34216. >Mcrypt</A
  34217. >
  34218.      and <A
  34219. HREF="#ref.mhash"
  34220. >Mhash</A
  34221. >, welche eine gro▀e Auswahl an
  34222.      Verschlⁿsselungsalgorhythmen abdecken. Das Skript verschlⁿsselt die Daten
  34223.      vor dem Speichern, und entschlⁿsselt diese wieder beim Erhalt. Siehe die
  34224.      Verweise fⁿr weitere Beispiele, wie Verschlⁿsselung arbeitet.
  34225.     </P
  34226. ><P
  34227. >      Im Fall von wirklich versteckten Daten, wenn deren unverfΣlschte
  34228.      ReprΣsentation nicht n÷tig ist (z.B. keine Anzeige), ist hashing ebenfalls
  34229.      ⁿberlegenswert. Das bekannte Beispiel fⁿr das Hashing ist das Speichern des
  34230.      MD5 hash eines Passwortes in einer Datenbank, anstatt des Passwortes selbst.
  34231.      Siehe auch <A
  34232. HREF="#function.crypt"
  34233. ><B
  34234. CLASS="function"
  34235. >crypt()</B
  34236. ></A
  34237. > und <A
  34238. HREF="#function.md5"
  34239. ><B
  34240. CLASS="function"
  34241. >md5()</B
  34242. ></A
  34243. >.
  34244.     </P
  34245. ><TABLE
  34246. WIDTH="100%"
  34247. BORDER="0"
  34248. CELLPADDING="0"
  34249. CELLSPACING="0"
  34250. CLASS="EXAMPLE"
  34251. ><TR
  34252. ><TD
  34253. ><DIV
  34254. CLASS="example"
  34255. ><A
  34256. NAME="AEN5717"
  34257. ></A
  34258. ><P
  34259. ><B
  34260. >Beispiel 25-1. Verwenden eines hashed Passwortfeldes</B
  34261. ></P
  34262. ><TABLE
  34263. BORDER="0"
  34264. BGCOLOR="#E0E0E0"
  34265. CELLPADDING="5"
  34266. ><TR
  34267. ><TD
  34268. ><PRE
  34269. CLASS="php"
  34270. >// Speichern des Passwort hash
  34271. $query  = sprintf("INSERT INTO users(name,pwd) VALUES('%s','%s');",
  34272.             addslashes($username), md5($password));
  34273. $result = pg_exec($connection, $query);
  34274.  
  34275. // Afragen, ob der User das richtige Passwort ⁿbermittelt hat
  34276. $query = sprintf("SELECT 1 FROM users WHERE name='%s' AND pwd='%s';",
  34277.             addslashes($username), md5($password));
  34278. $result = pg_exec($connection, $query);
  34279.  
  34280. if (pg_numrows($result) > 0) {
  34281.     echo "Welcome, $username!";
  34282. }
  34283. else {
  34284.     echo "Authentication failed for $username.";
  34285. }</PRE
  34286. ></TD
  34287. ></TR
  34288. ></TABLE
  34289. ></DIV
  34290. ></TD
  34291. ></TR
  34292. ></TABLE
  34293. ></DIV
  34294. ><DIV
  34295. CLASS="sect1"
  34296. ><HR><H2
  34297. CLASS="sect1"
  34298. ><A
  34299. NAME="security.database.sql-injection"
  34300. >SQL Injection</A
  34301. ></H2
  34302. ><P
  34303. >      Viele Entwickler sind sich nicht bewusst, wie man sich an SQL Abfragen
  34304.      zu schaffen machen kann und nehmen an, dass eine SQL Abfrage ein
  34305.      vertrauenswⁿrdiges Kommando ist. Das hei▀t, dass SQL Abfragen
  34306.      Zugriffskontrollen hinters Licht fⁿhren, und dadurch Standard
  34307.      Authentifizierungs- und Authorisationschecks umgehen k÷nnen, und
  34308.      manchmal k÷nnen SQL Abfragen sogar Zugriff zu Kommandos auf
  34309.      Betriebssystemebene erlauben.
  34310.     </P
  34311. ><P
  34312. >      Direkt SQL Command Injection ist eine Technik, wo ein Angreifer SQL
  34313.      Kommandos erstellt oder existierende verΣndert, um versteckte Daten
  34314.      sichtbar zu machen, wertvolle Daten zu ⁿberschreiben, oder sogar
  34315.      gefΣhrliche Kommandos auf Systemebene des Datenbank-Hosts auszufⁿhren.
  34316.      Dies wird durch die Applikation erreicht, welche den Input des Benutzers
  34317.      mit statischen Parametern kombiniert, um eine SQL Abfrage zu erstellen.
  34318.      Die folgenden Beispiele basieren - leider - auf wahren Begebenheiten.
  34319.     </P
  34320. ><P
  34321. >      Dank dem Mangel an Input Validierungen, und dem Verbinden zum
  34322.      Datenbankserver als ein Superuser oder jemand der Benutzer anlegen kann,
  34323.      kann ein Angreifer einen Superuser in Ihrer Datenbank anlegen.
  34324.      <TABLE
  34325. WIDTH="100%"
  34326. BORDER="0"
  34327. CELLPADDING="0"
  34328. CELLSPACING="0"
  34329. CLASS="EXAMPLE"
  34330. ><TR
  34331. ><TD
  34332. ><DIV
  34333. CLASS="example"
  34334. ><A
  34335. NAME="AEN5725"
  34336. ></A
  34337. ><P
  34338. ><B
  34339. >Beispiel 25-2. 
  34340.        Die Ergebnisliste in mehrere Seiten aufsplitten ... und Superuser anlegen
  34341.        (PostgreSQL and MySQL)
  34342.       </B
  34343. ></P
  34344. ><TABLE
  34345. BORDER="0"
  34346. BGCOLOR="#E0E0E0"
  34347. CELLPADDING="5"
  34348. ><TR
  34349. ><TD
  34350. ><PRE
  34351. CLASS="php"
  34352. >$offset = argv[0]; // Vorsicht, keine Validierung des Input !
  34353. $query  = "SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET $offset;";
  34354. // mit PostgreSQL
  34355. $result = pg_exec($conn, $query);
  34356. // mit MySQL
  34357. $result = mysql_query($query);</PRE
  34358. ></TD
  34359. ></TR
  34360. ></TABLE
  34361. ></DIV
  34362. ></TD
  34363. ></TR
  34364. ></TABLE
  34365. >
  34366.       Normale Benutzer klicken auf die 'nΣchste' bzw. 'vorige' Links, wo
  34367.       <VAR
  34368. CLASS="varname"
  34369. >$offset</VAR
  34370. > in der URL enthalten ist. Das Skript erwartet,
  34371.       dass die ankommende <VAR
  34372. CLASS="varname"
  34373. >$offset</VAR
  34374. > einen Dezimalwert enthΣlt.
  34375.       Ganz gleich, jemand versucht einzubrechen, indem er das folgende in einer
  34376.       <A
  34377. HREF="#function.urlencode"
  34378. ><B
  34379. CLASS="function"
  34380. >urlencode()</B
  34381. ></A
  34382. >'d Form an die URL anhΣngt
  34383.       <DIV
  34384. CLASS="informalexample"
  34385. ><P
  34386. ></P
  34387. ><A
  34388. NAME="AEN5731"
  34389. ></A
  34390. ><TABLE
  34391. BORDER="0"
  34392. BGCOLOR="#E0E0E0"
  34393. CELLPADDING="5"
  34394. ><TR
  34395. ><TD
  34396. ><PRE
  34397. CLASS="programlisting"
  34398. >// Im Fall von PostgreSQL
  34399. 0;
  34400. insert into pg_shadow(usename,usesysid,usesuper,usecatupd,passwd)
  34401.     select 'crack', usesysid, 't','t','crack'
  34402.     from pg_shadow where usename='postgres';
  34403. --
  34404.  
  34405. // Im Fall von MySQL
  34406. 0;
  34407. UPDATE user SET Password=PASSWORD('crack') WHERE user='root';
  34408. FLUSH PRIVILEGES;</PRE
  34409. ></TD
  34410. ></TR
  34411. ></TABLE
  34412. ><P
  34413. ></P
  34414. ></DIV
  34415. >
  34416.       Wenn es passiert ist, wⁿrde ihm das Skript einen Zugriff als Superuser
  34417.       prΣsentieren. Beachten Sie, dass <VAR
  34418. CLASS="literal"
  34419. >0;</VAR
  34420. > ein gⁿltiges
  34421.       Offset zur ursprⁿnglichen Abfrage liefert, und sie beendet.
  34422.     </P
  34423. ><DIV
  34424. CLASS="note"
  34425. ><BLOCKQUOTE
  34426. CLASS="note"
  34427. ><P
  34428. ><B
  34429. >Anmerkung: </B
  34430. >
  34431.       Es ist eine ⁿbliche Technik, den SQL Parser mittels dem Kommentarzeichen
  34432.       in SQL <VAR
  34433. CLASS="literal"
  34434. >--</VAR
  34435. > zu zwingen, den Rest der vom Entwickler
  34436.       geschriebenen Abfrage zu ignorieren.
  34437.      </P
  34438. ></BLOCKQUOTE
  34439. ></DIV
  34440. ><P
  34441. >      Ein gangbarer Weg um Passw÷rter zu finden ist, Ihre Seiten mit den
  34442.      Suchergebnissen hinters Licht zu fⁿhren. Der Angreifer braucht nur zu
  34443.      probieren, ob irgendeine ⁿbertragene Variable, die in dem SQL Statement
  34444.      verwendet wird, nicht richtig gehandhabt wird. Diese Filter k÷nnen
  34445.      gew÷hnlich in einer vorausgehenden Form gesetzt werden, indem
  34446.      <VAR
  34447. CLASS="literal"
  34448. >WHERE, ORDER BY, LIMIT</VAR
  34449. > und <VAR
  34450. CLASS="literal"
  34451. >OFFSET</VAR
  34452. >
  34453.      Klauseln in <VAR
  34454. CLASS="literal"
  34455. >SELECT</VAR
  34456. > Statements umgebaut werden. Wenn
  34457.      Ihre Datenbank das <VAR
  34458. CLASS="literal"
  34459. >UNION</VAR
  34460. > Konstrukt unterstⁿtzt, kann
  34461.      der Angreifer versuchen, eine komplette Abfrage an das Original anzuhΣngen,
  34462.      um Pa▀w÷rter aus einer willkⁿrlichen Tabelle aufzulisten. Die Verwendung
  34463.      von verschlⁿsselten Passwortfeldern wird ausdrⁿcklich empfohlen.
  34464.      <TABLE
  34465. WIDTH="100%"
  34466. BORDER="0"
  34467. CELLPADDING="0"
  34468. CELLSPACING="0"
  34469. CLASS="EXAMPLE"
  34470. ><TR
  34471. ><TD
  34472. ><DIV
  34473. CLASS="example"
  34474. ><A
  34475. NAME="AEN5742"
  34476. ></A
  34477. ><P
  34478. ><B
  34479. >Beispiel 25-3. 
  34480.        Artikel auflisten ... und ein paar Passw÷rter (irgendein Datenbankserver)
  34481.       </B
  34482. ></P
  34483. ><TABLE
  34484. BORDER="0"
  34485. BGCOLOR="#E0E0E0"
  34486. CELLPADDING="5"
  34487. ><TR
  34488. ><TD
  34489. ><PRE
  34490. CLASS="php"
  34491. >$query  = "SELECT id, name, inserted, size FROM products
  34492.                   WHERE size = '$size'
  34493.                   ORDER BY $order LIMIT $limit, $offset;";
  34494. $result = odbc_exec($conn, $query);</PRE
  34495. ></TD
  34496. ></TR
  34497. ></TABLE
  34498. ></DIV
  34499. ></TD
  34500. ></TR
  34501. ></TABLE
  34502. >
  34503.      Der statische Teil der Abfrage kann mit einem anderen
  34504.      <VAR
  34505. CLASS="literal"
  34506. >SELECT</VAR
  34507. > Statement kombiniert werden, welches alle
  34508.      Passw÷rter preisgibt
  34509.      <DIV
  34510. CLASS="informalexample"
  34511. ><P
  34512. ></P
  34513. ><A
  34514. NAME="AEN5746"
  34515. ></A
  34516. ><TABLE
  34517. BORDER="0"
  34518. BGCOLOR="#E0E0E0"
  34519. CELLPADDING="5"
  34520. ><TR
  34521. ><TD
  34522. ><PRE
  34523. CLASS="programlisting"
  34524. >'
  34525. union select '1', concat(uname||'-'||passwd) as name, '1971-01-01', '0' from usertable;
  34526. --</PRE
  34527. ></TD
  34528. ></TR
  34529. ></TABLE
  34530. ><P
  34531. ></P
  34532. ></DIV
  34533. >
  34534.      Wenn diese Abfrage (mit dem <VAR
  34535. CLASS="literal"
  34536. >'</VAR
  34537. > und
  34538.      <VAR
  34539. CLASS="literal"
  34540. >--</VAR
  34541. >) einer der in <VAR
  34542. CLASS="varname"
  34543. >$query</VAR
  34544. > verwendeten
  34545.      Variablen zugewiesen wⁿrde, wΣre das "Abfragebiest" erwacht.
  34546.     </P
  34547. ><P
  34548. >      SQL UPDATEs sind ebenfalls ein Anlass, Ihre Datenbank anzugreifen. Diese
  34549.      Abfragen sind auch durch das ─ndern und AnhΣngen einer komplett neuen
  34550.      Abfrage gefΣhrdet. Aber der Angreifer k÷nnte auch mit der
  34551.      <VAR
  34552. CLASS="literal"
  34553. >SET</VAR
  34554. > Klausel herumspielen. In diesem Fall muss eine
  34555.      Schemainformation vorhanden sein, um die Abfrage erfolgreich manipulieren
  34556.      zu k÷nnen. Diese kann durch Untersuchen der Variablennamen im Formular,
  34557.      oder simpel mittels brute force gesammelt werden. Es gibt nicht so viele
  34558.      Namenskonventionen fⁿr Felder, welche Passw÷rter oder Benutzernamen
  34559.      speichern.
  34560.      <TABLE
  34561. WIDTH="100%"
  34562. BORDER="0"
  34563. CELLPADDING="0"
  34564. CELLSPACING="0"
  34565. CLASS="EXAMPLE"
  34566. ><TR
  34567. ><TD
  34568. ><DIV
  34569. CLASS="example"
  34570. ><A
  34571. NAME="AEN5753"
  34572. ></A
  34573. ><P
  34574. ><B
  34575. >Beispiel 25-4. 
  34576.       Vom Zurⁿcksetzen eines Passwortes ... zum Erlangen von mehr Rechten
  34577.       (irgendein Datenbankserver)
  34578.      </B
  34579. ></P
  34580. ><TABLE
  34581. BORDER="0"
  34582. BGCOLOR="#E0E0E0"
  34583. CELLPADDING="5"
  34584. ><TR
  34585. ><TD
  34586. ><PRE
  34587. CLASS="php"
  34588. >$query = "UPDATE usertable SET pwd='$pwd' WHERE uid='$uid';";</PRE
  34589. ></TD
  34590. ></TR
  34591. ></TABLE
  34592. ></DIV
  34593. ></TD
  34594. ></TR
  34595. ></TABLE
  34596. >
  34597.      Aber ein b÷swilliger Benutzer ⁿbermittelt den Wert
  34598.      <VAR
  34599. CLASS="literal"
  34600. >' or uid like'%admin%'; --</VAR
  34601. > zu <VAR
  34602. CLASS="varname"
  34603. >$uid</VAR
  34604. >,
  34605.      um das Administrator Passwort zu Σndern, oder setzt einfach
  34606.      <VAR
  34607. CLASS="varname"
  34608. >$pwd</VAR
  34609. > auf <VAR
  34610. CLASS="literal"
  34611. >"hehehe', admin='yes', trusted=100
  34612.      "</VAR
  34613. > (mit dem hinteren Leerzeichen), um mehr Rechte zu erhalten.
  34614.      Dann wird die Abfrage verdreht:
  34615.      <DIV
  34616. CLASS="informalexample"
  34617. ><P
  34618. ></P
  34619. ><A
  34620. NAME="AEN5760"
  34621. ></A
  34622. ><TABLE
  34623. BORDER="0"
  34624. BGCOLOR="#E0E0E0"
  34625. CELLPADDING="5"
  34626. ><TR
  34627. ><TD
  34628. ><PRE
  34629. CLASS="php"
  34630. >// $uid == ' or uid like'%admin%'; --
  34631. $query = "UPDATE usertable SET pwd='...' WHERE uid='' or uid like '%admin%'; --";
  34632.  
  34633. // $pwd == "hehehe', admin='yes', trusted=100 "
  34634. $query = "UPDATE usertable SET pwd='hehehe', admin='yes', trusted=100 WHERE ...;"</PRE
  34635. ></TD
  34636. ></TR
  34637. ></TABLE
  34638. ><P
  34639. ></P
  34640. ></DIV
  34641. >
  34642.     </P
  34643. ><P
  34644. >      Ein furchterregendes Beispiel, wie der Zugriff auf Kommandos auf
  34645.      Betriebssystemebene bei manchen Datenbankservern erfolgen kann.
  34646.      <TABLE
  34647. WIDTH="100%"
  34648. BORDER="0"
  34649. CELLPADDING="0"
  34650. CELLSPACING="0"
  34651. CLASS="EXAMPLE"
  34652. ><TR
  34653. ><TD
  34654. ><DIV
  34655. CLASS="example"
  34656. ><A
  34657. NAME="AEN5763"
  34658. ></A
  34659. ><P
  34660. ><B
  34661. >Beispiel 25-5. Angriff auf das Betriebssystem des Datenbank Hosts (MSSQL Server)</B
  34662. ></P
  34663. ><TABLE
  34664. BORDER="0"
  34665. BGCOLOR="#E0E0E0"
  34666. CELLPADDING="5"
  34667. ><TR
  34668. ><TD
  34669. ><PRE
  34670. CLASS="php"
  34671. >$query  = "SELECT * FROM products WHERE id LIKE '%$prod%'";
  34672. $result = mssql_query($query);</PRE
  34673. ></TD
  34674. ></TR
  34675. ></TABLE
  34676. ></DIV
  34677. ></TD
  34678. ></TR
  34679. ></TABLE
  34680. >
  34681.      Wenn ein Angreifer den Wert
  34682.      <VAR
  34683. CLASS="literal"
  34684. >a%' exec master..xp_cmdshell 'net user test testpass /ADD' --</VAR
  34685. >
  34686.      zu <VAR
  34687. CLASS="varname"
  34688. >$prod</VAR
  34689. > ⁿbertrΣgt, wird <VAR
  34690. CLASS="varname"
  34691. >$query</VAR
  34692. > zu:
  34693.      <DIV
  34694. CLASS="informalexample"
  34695. ><P
  34696. ></P
  34697. ><A
  34698. NAME="AEN5769"
  34699. ></A
  34700. ><TABLE
  34701. BORDER="0"
  34702. BGCOLOR="#E0E0E0"
  34703. CELLPADDING="5"
  34704. ><TR
  34705. ><TD
  34706. ><PRE
  34707. CLASS="php"
  34708. >$query  = "SELECT * FROM products
  34709.                     WHERE id LIKE '%a%'
  34710.                     exec master..xp_cmdshell 'net user test testpass /ADD'--";
  34711. $result = mssql_query($query);</PRE
  34712. ></TD
  34713. ></TR
  34714. ></TABLE
  34715. ><P
  34716. ></P
  34717. ></DIV
  34718. >
  34719.      Der MSSQL Server fⁿhrt die SQL Statements in dem Batch aus, inklusive einem
  34720.      Kommando zum Anlegen eines neuen Benutzers in der Datenbank Accounts. Wⁿrde
  34721.      diese Applikation als <VAR
  34722. CLASS="literal"
  34723. >sa</VAR
  34724. > und der MSSQLSERVER Service
  34725.      mit genⁿgend Rechten laufen, hΣtte der Angreifer nun ein Konto, mit welchem
  34726.      er Zugriff auf diese Maschine hΣtte.
  34727.     </P
  34728. ><DIV
  34729. CLASS="note"
  34730. ><BLOCKQUOTE
  34731. CLASS="note"
  34732. ><P
  34733. ><B
  34734. >Anmerkung: </B
  34735. >
  34736.       Manche der obigen Beispiele sind an einen spezifischen Datenbankserver
  34737.       gebunden. Das hei▀t jedoch nicht, dass nicht ein Σhnlicher Angriff auf
  34738.       andere Produkte m÷glich wΣre. Ihr Datenbankserver k÷nnte auf andere
  34739.       Weise genauso verwundbar sein.
  34740.      </P
  34741. ></BLOCKQUOTE
  34742. ></DIV
  34743. ><DIV
  34744. CLASS="sect2"
  34745. ><HR><H3
  34746. CLASS="sect2"
  34747. ><A
  34748. NAME="security.database.avoiding"
  34749. >Techniken zur Vermeidung</A
  34750. ></H3
  34751. ><P
  34752. >       Sie k÷nnten sich nun darauf berufen, dass der Angreifer in den meisten
  34753.       Beispielen ein Stⁿck Information ⁿber das Datenbankschema haben muss. Sie
  34754.       haben recht, aber Sie wissen nie, wann und wie es genommen werden kann,
  34755.       und wenn es passiert, kann Ihre Datenbank entbl÷▀t werden. Wenn Sie ein
  34756.       Open Source, oder ÷ffentlich verfⁿgbares Paket zur Handhabung von
  34757.       Datenbanken verwenden, welches vielleicht zu einem Content Management
  34758.       System oder Forum geh÷rt, k÷nnen Eindringlinge leicht eine Kopie eines
  34759.       Stⁿcks Ihres Codes erstellen. Es kann auch ein Sicherheitsrisiko sein,
  34760.       wenn es sich um ein schlecht designtes Paket handelt.
  34761.      </P
  34762. ><P
  34763. >       Diese Angriffe basieren hauptsΣchlich auf dem Ausnutzen des Codes, welcher
  34764.       ohne Bedenken auf die Sicherheit geschrieben wurde. Vertrauen Sie nie auf
  34765.       irgendeine Art von Input, speziell wenn er von der Clientseite kommt,
  34766.       selbst wenn er von einer Auswahlbox, einem versteckten Eingabefeld, oder
  34767.       einem Cookie kommt. Das erste Beispiel zeigt, dass solch eine untadelige
  34768.       Abfrage ein Disaster anrichten kann.
  34769.      </P
  34770. ><P
  34771. ></P
  34772. ><UL
  34773. ><LI
  34774. ><P
  34775. >         Stellen Sie nie als Superuser oder Owner einer Datenbank eine Verbindung
  34776.         zur Datenbank her. Verwenden Sie immer speziell angelegte Benutzer mit
  34777.         sehr limitierten Rechten.
  34778.        </P
  34779. ></LI
  34780. ><LI
  34781. ><P
  34782. >         Prⁿfen Sie, ob der gegebene Input dem erwarteten Datentyp entspricht.
  34783.         PHP bietet eine gro▀e Auswahl an Funktionen zum Validieren des Input,
  34784.         von den einfachsten unter <A
  34785. HREF="#ref.variables"
  34786. >Variablenfunktionen</A
  34787. > und <A
  34788. HREF="#ref.ctype"
  34789. >Character Type Functions</A
  34790. > (z.B.
  34791.         <A
  34792. HREF="#function.is-numeric"
  34793. ><B
  34794. CLASS="function"
  34795. >is_numeric()</B
  34796. ></A
  34797. > bzw. <A
  34798. HREF="#function.ctype-digit"
  34799. ><B
  34800. CLASS="function"
  34801. >ctype_digit()</B
  34802. ></A
  34803. >),
  34804.         bis hin zu den <A
  34805. HREF="#ref.pcre"
  34806. >Perl kompatiblen RegulΣren
  34807.         Ausdrⁿcken</A
  34808. >.
  34809.        </P
  34810. ></LI
  34811. ><LI
  34812. ><P
  34813. >         Wenn die Applikation numerischen Input erwartet, erwΣgen Sie die Prⁿfung
  34814.         der Daten mit <A
  34815. HREF="#function.is-numeric"
  34816. ><B
  34817. CLASS="function"
  34818. >is_numeric()</B
  34819. ></A
  34820. >, oder die ─nderung des
  34821.         Typs mit <A
  34822. HREF="#function.settype"
  34823. ><B
  34824. CLASS="function"
  34825. >settype()</B
  34826. ></A
  34827. >, oder verwenden Sie die numerische
  34828.         ReprΣsentation mittels <A
  34829. HREF="#function.sprintf"
  34830. ><B
  34831. CLASS="function"
  34832. >sprintf()</B
  34833. ></A
  34834. >.
  34835.         <TABLE
  34836. WIDTH="100%"
  34837. BORDER="0"
  34838. CELLPADDING="0"
  34839. CELLSPACING="0"
  34840. CLASS="EXAMPLE"
  34841. ><TR
  34842. ><TD
  34843. ><DIV
  34844. CLASS="example"
  34845. ><A
  34846. NAME="AEN5793"
  34847. ></A
  34848. ><P
  34849. ><B
  34850. >Beispiel 25-6. Ein sicherer Weg, eine Abfrage zu erstellen</B
  34851. ></P
  34852. ><TABLE
  34853. BORDER="0"
  34854. BGCOLOR="#E0E0E0"
  34855. CELLPADDING="5"
  34856. ><TR
  34857. ><TD
  34858. ><PRE
  34859. CLASS="php"
  34860. >settype($offset, 'integer');
  34861. $query = "SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET $offset;";
  34862.  
  34863. // Beachten Sie %d im Formatstring, %s zu verwenden wΣre sinnlos
  34864. $query = sprintf("SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET %d;",
  34865.                  $offset);</PRE
  34866. ></TD
  34867. ></TR
  34868. ></TABLE
  34869. ></DIV
  34870. ></TD
  34871. ></TR
  34872. ></TABLE
  34873. >
  34874.        </P
  34875. ></LI
  34876. ><LI
  34877. ><P
  34878. >         Escapen Sie jeden nicht numerischen Input, welcher zur Datenbank
  34879.         weitergereicht werden soll mit <A
  34880. HREF="#function.addslashes"
  34881. ><B
  34882. CLASS="function"
  34883. >addslashes()</B
  34884. ></A
  34885. >
  34886.         oder <A
  34887. HREF="#function.addcslashes"
  34888. ><B
  34889. CLASS="function"
  34890. >addcslashes()</B
  34891. ></A
  34892. >. Siehe auch <A
  34893. HREF="#security.database.storage"
  34894. >das erste Beispiel</A
  34895. >. Wie
  34896.         dieses Beispiel zeigt, sind in den statischen Teil der Abfrage
  34897.         eingebrachten Escapes nicht genug, und k÷nnen leicht gehacked werden.
  34898.        </P
  34899. ></LI
  34900. ><LI
  34901. ><P
  34902. >         Geben Sie keinerlei datenbankspezifische Informationen aus, speziell
  34903.         ⁿber das Schema, egal wie (auf ehrliche oder unehrliche Weise). Siehe
  34904.         auch <A
  34905. HREF="#security.errors"
  34906. >Fehlerbehandlung</A
  34907. > und
  34908.         <A
  34909. HREF="#ref.errorfunc"
  34910. >Error Handling and Logging
  34911.         Functions</A
  34912. >.
  34913.        </P
  34914. ></LI
  34915. ><LI
  34916. ><P
  34917. >         Sie k÷nnen stored procedures und vorher definierte Cursor verwenden,
  34918.         um den Datenzugriff zu abstrahieren, sodass Benutzer nicht direkt auf
  34919.         Tabellen oder Views zugreifen, aber diese L÷sung hat andere
  34920.         Auswirkungen.
  34921.        </P
  34922. ></LI
  34923. ></UL
  34924. ><P
  34925. >       Abgesehen davon profitieren Sie von einer Protokollierung der Abfragen
  34926.       entweder in Ihrem Skript, oder durch die Datenbank selbst, wenn es hilft.
  34927.       Klar, die Protokollierung kann nicht irgendeinen schΣdlichen Versuch
  34928.       verhindern, aber es kann helfen herauszufinden, welche Applikation
  34929.       umgangen wurde. Das Log ist durch die in ihm enthaltene Information
  34930.       nⁿtzlich, und je mehr Details es enthΣlt, desto besser ist es im
  34931.       Allgemeinen.
  34932.      </P
  34933. ></DIV
  34934. ></DIV
  34935. ></DIV
  34936. ><DIV
  34937. CLASS="chapter"
  34938. ><HR><H1
  34939. ><A
  34940. NAME="security.errors"
  34941. >Kapitel 26. Fehlerbehandlung</A
  34942. ></H1
  34943. ><P
  34944. >     PHP Security hat zwei Seiten der Fehlerbehandlung. Eine ist fⁿr die
  34945.     Erh÷hung der Sicherheit vorteilhaft, die andere ist schΣdlich.
  34946.    </P
  34947. ><P
  34948. >     Eine Standard-Angriffstaktik beinhaltet die Erstellung eines Profils
  34949.     des anzugreifenden Systems, indem die aufgrund der Einspeisung von
  34950.     unzulΣssigen Daten zurⁿckgegebenen Fehlermeldungen anhand deren
  34951.     Art und des Kontextes ausgewertet werden. Wenn z.B. ein Angreifer
  34952.     Informationen ⁿber eine auf einem eingesendeten Formular basierte
  34953.     Seite zusammengetragen hat, kann er versuchen, Variablen zu
  34954.     ⁿberschreiben bzw. zu modifizieren:
  34955.     <TABLE
  34956. WIDTH="100%"
  34957. BORDER="0"
  34958. CELLPADDING="0"
  34959. CELLSPACING="0"
  34960. CLASS="EXAMPLE"
  34961. ><TR
  34962. ><TD
  34963. ><DIV
  34964. CLASS="example"
  34965. ><A
  34966. NAME="AEN5812"
  34967. ></A
  34968. ><P
  34969. ><B
  34970. >Beispiel 26-1. Variablen mit einer eigenen HTML Seite angreifen</B
  34971. ></P
  34972. ><TABLE
  34973. BORDER="0"
  34974. BGCOLOR="#E0E0E0"
  34975. CELLPADDING="5"
  34976. ><TR
  34977. ><TD
  34978. ><PRE
  34979. CLASS="html"
  34980. ><form method="post" action="attacktarget?username=badfoo&password=badfoo">
  34981. <input type="hidden" name="username" value="badfoo">
  34982. <input type="hidden" name="password" value="badfoo">
  34983. </form></PRE
  34984. ></TD
  34985. ></TR
  34986. ></TABLE
  34987. ></DIV
  34988. ></TD
  34989. ></TR
  34990. ></TABLE
  34991. >
  34992.    </P
  34993. ><P
  34994. >     Die normalerweise zurⁿckgegebenen PHP Fehler k÷nnen fⁿr den Entwickler
  34995.     hilfreich sein, wenn dieser ein Skript debuggen m÷chte, Hinweise auf
  34996.     eine nicht korrekt arbeitende Funktion oder Datei, oder die PHP Datei
  34997.     und die Zeilennummer des aufgetretenen Fehlers anzeigen lassen m÷chte.
  34998.     Das sind alles Informationen, die ausgenutzt werden k÷nnen. Es ist fⁿr
  34999.     einen PHP Entwickler nicht unⁿblich, <A
  35000. HREF="#function.show-source"
  35001. ><B
  35002. CLASS="function"
  35003. >show_source()</B
  35004. ></A
  35005. >,
  35006.     <A
  35007. HREF="#function.highlight-string"
  35008. ><B
  35009. CLASS="function"
  35010. >highlight_string()</B
  35011. ></A
  35012. >, oder
  35013.     <A
  35014. HREF="#function.highlight-file"
  35015. ><B
  35016. CLASS="function"
  35017. >highlight_file()</B
  35018. ></A
  35019. > zur Fehlersuche zu verwenden,
  35020.     jedoch kann dies in einem lebenden System auch versteckte Variablen,
  35021.     ungeprⁿfte Syntax und andere gefΣhrliche Informationen aufdecken.
  35022.     Speziell gefΣhrlich ist es, Code von bekannten Quellen mit integrierten
  35023.     Debugging Handlern auszufⁿhren, oder weit verbreitete Debuggingtechniken
  35024.     zu verwenden. Wenn ein Angreifer die von Ihnen benutzte generelle
  35025.     Technik herausfindet, kann er versuchen, mit Brute-Force Ihre Seite zu
  35026.     knacken, indem er verschiedene allgemein gebrΣuchliche Debug Strings
  35027.     sendet:
  35028.     <TABLE
  35029. WIDTH="100%"
  35030. BORDER="0"
  35031. CELLPADDING="0"
  35032. CELLSPACING="0"
  35033. CLASS="EXAMPLE"
  35034. ><TR
  35035. ><TD
  35036. ><DIV
  35037. CLASS="example"
  35038. ><A
  35039. NAME="AEN5819"
  35040. ></A
  35041. ><P
  35042. ><B
  35043. >Beispiel 26-2. Ausnutzen von gebrΣuchlichen Debugging Variablen</B
  35044. ></P
  35045. ><TABLE
  35046. BORDER="0"
  35047. BGCOLOR="#E0E0E0"
  35048. CELLPADDING="5"
  35049. ><TR
  35050. ><TD
  35051. ><PRE
  35052. CLASS="html"
  35053. ><form method="post" action="attacktarget?errors=Y&amp;showerrors=1"&debug=1">
  35054. <input type="hidden" name="errors" value="Y">
  35055. <input type="hidden" name="showerrors" value="1">
  35056. <input type="hidden" name="debug" value="1">
  35057. </form></PRE
  35058. ></TD
  35059. ></TR
  35060. ></TABLE
  35061. ></DIV
  35062. ></TD
  35063. ></TR
  35064. ></TABLE
  35065. >
  35066.    </P
  35067. ><P
  35068. >     Ungeachtet der Fehlerbehandlungsmethode fⁿhrt die M÷glichkeit ein
  35069.     System nach Fehlermeldungen zu sondieren dazu, dass einem Angreifer mehr
  35070.     Informationen geboten werden.
  35071.    </P
  35072. ><P
  35073. >     Zum Beispiel weist schon alleine der Stil einer Fehlermeldung darauf
  35074.     hin, dass auf einem System PHP lΣuft. Wenn der Angreifer auf eine
  35075.     .html Seite kommt und untersuchen m÷chte welches System im Hintergrund
  35076.     lΣuft (um nach bekannten SystemschwΣchen zu suchen), k÷nnte dieser
  35077.     mittels der Einspeisung von falschen Daten herausfinden, dass ein
  35078.     System mit PHP aufgebaut ist.
  35079.    </P
  35080. ><P
  35081. >     Ein Fehler einer Funktion gibt Aufschluss darⁿber, ob ein System eine
  35082.     bestimmte Datenbankapplikation benutzt, oder gibt Hinweise darauf,
  35083.     wie eine Webseite programmiert bzw. entworfen wurde. Dies erlaubt
  35084.     eine tiefere ▄berprⁿfung von offenen Datenbank-Ports, oder die Suche
  35085.     nach spezifischen Bugs bzw. SchwΣchen einer Webseite. Mit der
  35086.     Einspeisung von falschen Daten kann ein Angreifer z.B. die Reihenfolge
  35087.     der Authentifizierung in einem Skript bestimmen (anhand der
  35088.     Zeilennummern in den Fehlermeldungen), wie auch durch "Herumstochern"
  35089.     Missbrauchsm÷glichkeiten an verschiedenen Stellen im Script herausfinden.
  35090.    </P
  35091. ><P
  35092. >     Eine Fehlermeldung des Dateisystems oder eines generellen PHP-Errors
  35093.     welche Rechte der Server hat, wie auch die Struktur und Organisation
  35094.     der Dateien auf dem Webserver. Vom Entwickler geschriebene
  35095.     Fehlermeldungen k÷nnen das Problem verschlimmern, bis hin zum Preisgeben
  35096.     von zuvor "versteckten" Informationen.
  35097.    </P
  35098. ><P
  35099. >     Es gibt drei bedeutende L÷sungen zu diesem Thema. Die erste ist, alle
  35100.     Funktionen zu ⁿberprⁿfen und zu versuchen, die Menge an Fehlermeldungen
  35101.     zu ersetzen. Die zweite ist, die Ausgabe von Fehlermeldungen am laufenden
  35102.     Code generell zu deaktivieren. Die dritte ist, sich unter Verwendung der
  35103.     PHP Funktionen zur Fehlerbehandlung seinen eigenen Error-handler zu
  35104.     schreiben. AbhΣngig von Ihrer Sicherheitspolitik k÷nnte jede der drei
  35105.     L÷sungen fⁿr Sie geeignet sein.
  35106.    </P
  35107. ><P
  35108. >     Ein Weg, diesen Punkt vorzeitig zu behandeln ist, das PHP eigene
  35109.     <A
  35110. HREF="#function.error-reporting"
  35111. ><B
  35112. CLASS="function"
  35113. >error_reporting()</B
  35114. ></A
  35115. > zu benutzen, um Ihren Code
  35116.     sicherer zu gestalten und m÷glicherweise gefΣhrliche Nutzungen von
  35117.     Variablen zu entdecken. Wenn Sie Ihren Code noch vor dem Einsatz
  35118.     mit E_ALL testen, k÷nnen Sie Bereiche entdecken, in denen Ihre Variablen
  35119.     eventuell fⁿr Verseuchung oder andere Modifikationen offen sind.
  35120.     Sind Sie bereit zum Einsatz, k÷nnen Sie Ihren Code mit E_NONE vor
  35121.     Sondierungen schⁿtzen.
  35122.     <TABLE
  35123. WIDTH="100%"
  35124. BORDER="0"
  35125. CELLPADDING="0"
  35126. CELLSPACING="0"
  35127. CLASS="EXAMPLE"
  35128. ><TR
  35129. ><TD
  35130. ><DIV
  35131. CLASS="example"
  35132. ><A
  35133. NAME="AEN5829"
  35134. ></A
  35135. ><P
  35136. ><B
  35137. >Beispiel 26-3. GefΣhrliche Variablen mit E_ALL finden</B
  35138. ></P
  35139. ><TABLE
  35140. BORDER="0"
  35141. BGCOLOR="#E0E0E0"
  35142. CELLPADDING="5"
  35143. ><TR
  35144. ><TD
  35145. ><PRE
  35146. CLASS="php"
  35147. ><?php
  35148. if ($username) {  // Vor Verwendung nicht initialisiert oder geprⁿft
  35149.     $good_login = 1;
  35150. }
  35151. if ($good_login == 1) { // Wenn der obige Test fehlschlΣgt, ist vor der
  35152.                         // Verwendung nicht initialisiert oder geprⁿft
  35153.     fpassthru ("/highly/sensitive/data/index.html");
  35154. }
  35155. ?></PRE
  35156. ></TD
  35157. ></TR
  35158. ></TABLE
  35159. ></DIV
  35160. ></TD
  35161. ></TR
  35162. ></TABLE
  35163. >
  35164.    </P
  35165. ></DIV
  35166. ><DIV
  35167. CLASS="chapter"
  35168. ><HR><H1
  35169. ><A
  35170. NAME="security.globals"
  35171. >Kapitel 27. Verwendung von Register Globals</A
  35172. ></H1
  35173. ><P
  35174. >     Ein Feature von PHP zur Erh÷hung der Sicherheit ist die Konfiguration von
  35175.     PHP mit <A
  35176. HREF="#ini.register-globals"
  35177. >register_globals</A
  35178. > = off.
  35179.     Mit Deaktivierung der M÷glichkeit, irgendeine vom Benutzer ⁿbertragenen
  35180.     Variable in den PHP Code zu injizieren, k÷nnen Sie die Anzahl "vergifteter"
  35181.     Variablen reduzieren, welche ein potentieller Angreifer zufⁿgen k÷nnte.
  35182.     Dieser ben÷tigt mehr Zeit, um sich ▄bermittlungen auszudenken, und Ihre
  35183.     internen Variablen sind effektiv von den ⁿbergebenen Benutzervariablen
  35184.     isoliert.
  35185.    </P
  35186. ><P
  35187. >     WΣhrend dies den ben÷tigten Aufwand mit PHP zu arbeiten leicht erh÷ht
  35188.     ist dargelegt, dass die Vorteile gegenⁿber dem Aufwand klar ⁿberwiegen.
  35189.     <TABLE
  35190. WIDTH="100%"
  35191. BORDER="0"
  35192. CELLPADDING="0"
  35193. CELLSPACING="0"
  35194. CLASS="EXAMPLE"
  35195. ><TR
  35196. ><TD
  35197. ><DIV
  35198. CLASS="example"
  35199. ><A
  35200. NAME="AEN5837"
  35201. ></A
  35202. ><P
  35203. ><B
  35204. >Beispiel 27-1. Mit register_globals=on arbeiten</B
  35205. ></P
  35206. ><TABLE
  35207. BORDER="0"
  35208. BGCOLOR="#E0E0E0"
  35209. CELLPADDING="5"
  35210. ><TR
  35211. ><TD
  35212. ><PRE
  35213. CLASS="php"
  35214. ><?php
  35215. if ($username) {  // kann vom User mit get/post/cookies ⁿbermittelt werden
  35216.     $good_login = 1;
  35217. }
  35218.  
  35219. if ($good_login == 1) { // kann vom User mit get/post/cookies ⁿbermittelt werden
  35220.     fpassthru ("/highly/sensitive/data/index.html");
  35221. }
  35222. ?></PRE
  35223. ></TD
  35224. ></TR
  35225. ></TABLE
  35226. ></DIV
  35227. ></TD
  35228. ></TR
  35229. ></TABLE
  35230. >
  35231.     <TABLE
  35232. WIDTH="100%"
  35233. BORDER="0"
  35234. CELLPADDING="0"
  35235. CELLSPACING="0"
  35236. CLASS="EXAMPLE"
  35237. ><TR
  35238. ><TD
  35239. ><DIV
  35240. CLASS="example"
  35241. ><A
  35242. NAME="AEN5840"
  35243. ></A
  35244. ><P
  35245. ><B
  35246. >Beispiel 27-2. Mit register_globals = off arbeiten</B
  35247. ></P
  35248. ><TABLE
  35249. BORDER="0"
  35250. BGCOLOR="#E0E0E0"
  35251. CELLPADDING="5"
  35252. ><TR
  35253. ><TD
  35254. ><PRE
  35255. CLASS="php"
  35256. ><?php
  35257. if($_COOKIE['username']){
  35258.     // kann nur von einem Cookie kommen
  35259.     $good_login = 1;
  35260.     fpassthru ("/highly/sensitive/data/index.html");
  35261. }
  35262. ?></PRE
  35263. ></TD
  35264. ></TR
  35265. ></TABLE
  35266. ></DIV
  35267. ></TD
  35268. ></TR
  35269. ></TABLE
  35270. >
  35271.     Dies weise genutzt ist es auch m÷glich, prΣventive Messungen
  35272.     durchzufⁿhren, um bei versuchten Vorst÷▀en zu warnen. Wenn Sie
  35273.     im Voraus wissen, woher eine Variable kommen soll, k÷nnen Sie
  35274.     prⁿfen, ob die ⁿbermittelten Daten nicht einen unpassenden Weg
  35275.     genommen haben. Obwohl dies nicht garantiert, dass Daten nicht
  35276.     nur ausgedacht sind, erfordert es von einem Angreifer, auch den
  35277.     richtigen Weg zu finden.
  35278.     <TABLE
  35279. WIDTH="100%"
  35280. BORDER="0"
  35281. CELLPADDING="0"
  35282. CELLSPACING="0"
  35283. CLASS="EXAMPLE"
  35284. ><TR
  35285. ><TD
  35286. ><DIV
  35287. CLASS="example"
  35288. ><A
  35289. NAME="AEN5843"
  35290. ></A
  35291. ><P
  35292. ><B
  35293. >Beispiel 27-3. Entdecken einfacher Manipulationen von Variablen</B
  35294. ></P
  35295. ><TABLE
  35296. BORDER="0"
  35297. BGCOLOR="#E0E0E0"
  35298. CELLPADDING="5"
  35299. ><TR
  35300. ><TD
  35301. ><PRE
  35302. CLASS="php"
  35303. ><?php
  35304. if ($_COOKIE['username'] &&
  35305.     !$_POST['username'] &&
  35306.     !$_GET['username'] ) {
  35307.     // Durchfⁿhren anderer Checks, ob der Benutzername gⁿltig ist...
  35308.     $good_login = 1;
  35309.     fpassthru ("/highly/sensitive/data/index.html");
  35310. } else {
  35311.    mail("admin@example.com", "Possible breakin attempt", $_SERVER['REMOTE_ADDR']);
  35312.    echo "Security violation, admin has been alerted.";
  35313.    exit;
  35314. }
  35315. ?></PRE
  35316. ></TD
  35317. ></TR
  35318. ></TABLE
  35319. ></DIV
  35320. ></TD
  35321. ></TR
  35322. ></TABLE
  35323. >
  35324.     Natⁿrlich bedeutet ein einfaches Deaktivieren von register_globals nicht,
  35325.     dass Ihr Code nun automatisch sicher ist. Jeder Teil mit Daten sollte
  35326.     auch auf andere Arten geprⁿft werden. ▄berprⁿfen Sie immer die Eingaben von
  35327.     Benutzern und initialisieren Sie Ihre Variablen! Um Ihre Skripte auf nicht
  35328.     initialisierte Variablen zu prⁿfen, k÷nnen Sie
  35329.     <A
  35330. HREF="#function.error-reporting"
  35331. ><B
  35332. CLASS="function"
  35333. >error_reporting()</B
  35334. ></A
  35335. > so einstellen, dass Fehler des Levels
  35336.     <TT
  35337. CLASS="constant"
  35338. ><B
  35339. >E_NOTICE</B
  35340. ></TT
  35341. > angezeigt werden.
  35342.    </P
  35343. ><DIV
  35344. CLASS="note"
  35345. ><BLOCKQUOTE
  35346. CLASS="note"
  35347. ><P
  35348. ><B
  35349. >Superglobals: Hinweis zur
  35350. Verfⁿgbarkeit: </B
  35351. >Seit PHP 4.1.0 stehen superglobale Arrays wie
  35352. <VAR
  35353. CLASS="varname"
  35354. >$_GET</VAR
  35355. >, <VAR
  35356. CLASS="varname"
  35357. >$_POST</VAR
  35358. >,<VAR
  35359. CLASS="varname"
  35360. >$_SERVER</VAR
  35361. >, 
  35362. etc. zur Verfⁿgung. Weitere Informationen k÷nnen Sie dem Abschnitt zu 
  35363. <A
  35364. HREF="#language.variables.predefined"
  35365. >superglobals</A
  35366. > entnehmen.</P
  35367. ></BLOCKQUOTE
  35368. ></DIV
  35369. ></DIV
  35370. ><DIV
  35371. CLASS="chapter"
  35372. ><HR><H1
  35373. ><A
  35374. NAME="security.variables"
  35375. >Kapitel 28. Vom Nutzer ⁿbermittelte Daten</A
  35376. ></H1
  35377. ><P
  35378. >     In vielen PHP Programmen liegt die gr÷▀te SchwΣche nicht an der Sprache
  35379.     selbst, sondern blo▀ an Code, der nicht mit dem n÷tigen Augenmerk auf
  35380.     die Sicherheit geschrieben wurde. Deshalb sollten Sie sich immer Zeit
  35381.     nehmen, die Implikationen eines gegebenen Codestⁿcks zu bedenken, um
  35382.     einen m÷glichen Schaden durch eine eventuell unerwartete ⁿbergebene
  35383.     Variable festzustellen.
  35384.     <TABLE
  35385. WIDTH="100%"
  35386. BORDER="0"
  35387. CELLPADDING="0"
  35388. CELLSPACING="0"
  35389. CLASS="EXAMPLE"
  35390. ><TR
  35391. ><TD
  35392. ><DIV
  35393. CLASS="example"
  35394. ><A
  35395. NAME="AEN5858"
  35396. ></A
  35397. ><P
  35398. ><B
  35399. >Beispiel 28-1. GefΣhrliche Verwendung von Variablen</B
  35400. ></P
  35401. ><TABLE
  35402. BORDER="0"
  35403. BGCOLOR="#E0E0E0"
  35404. CELLPADDING="5"
  35405. ><TR
  35406. ><TD
  35407. ><PRE
  35408. CLASS="php"
  35409. ><?php
  35410. // l÷sche eine Datei aus dem Benutzer-Verzeichnis...
  35411. // oder vielleicht dem eines anderen Benutzers?
  35412. unlink ($evil_var);
  35413.  
  35414. // Schreibe die Log-Information von deren Zugriff...
  35415. // oder vielleicht einen /etc/passwd Eintrag?
  35416. fputs ($fp, $evil_var);
  35417.  
  35418. // Fⁿhre etwas triviales aus... oder rm -rf *?
  35419. system ($evil_var);
  35420. exec ($evil_var);
  35421.  
  35422. ?></PRE
  35423. ></TD
  35424. ></TR
  35425. ></TABLE
  35426. ></DIV
  35427. ></TD
  35428. ></TR
  35429. ></TABLE
  35430. >
  35431.     Sie sollten Ihren Code immer sorgfΣltig kontrollieren, um eine
  35432.     sorgfΣltige Prⁿfung irgendwelcher von einem Web-Browser ⁿbertragenen
  35433.     Variablen sicherzustellen, und sich selbst folgende Fragen stellen:
  35434.     <P
  35435. ></P
  35436. ><UL
  35437. ><LI
  35438. ><P
  35439. >        Wird sich dieses Skript nur auf die vorgesehenen Dateien auswirken?
  35440.       </P
  35441. ></LI
  35442. ><LI
  35443. ><P
  35444. >        Kann auf ungew÷hnliche oder unerwⁿnschte Daten reagiert werden?
  35445.       </P
  35446. ></LI
  35447. ><LI
  35448. ><P
  35449. >        Kann dieses Skript auf nicht vorgesehene Art genutzt werden?
  35450.       </P
  35451. ></LI
  35452. ><LI
  35453. ><P
  35454. >        Kann dies in Verbindung mit anderen Skripten in einer negativen
  35455.        Art benutzt werden?
  35456.       </P
  35457. ></LI
  35458. ><LI
  35459. ><P
  35460. >        Werden alle Transaktionen ausreichend geloggt?
  35461.       </P
  35462. ></LI
  35463. ></UL
  35464. >
  35465.     Wenn Sie sich diese Fragen anstatt danach schon wΣhrend dem Schreiben
  35466.     des Skriptes stellen, ersparen Sie sich das unangenehme Umschreiben,
  35467.     wenn eine Erh÷hung der Sicherheit erforderlich wird. Mit dieser Art
  35468.     zu denken werden Sie die Sicherheit des Systems zwar nicht garantieren,
  35469.     aber sie k÷nnen helfen, sie zu erh÷hen.
  35470.    </P
  35471. ><P
  35472. >     Sie k÷nnten auch ▄berlegungen anstellen, ob Sie nicht register_globals,
  35473.     magic_quotes, oder andere bequeme Einstellungen abschalten, welche Sie
  35474.     in Punkto Gⁿltigkeit, Herkunft, oder Inhalt einer gegebenen Variable
  35475.     durcheinanderbringen k÷nnten. Mit PHP im error_reporting(E_ALL) Modus
  35476.     zu arbeiten kann auch helfen, Sie vor Variablen zu warnen, welche
  35477.     benutzt werden, bevor sie geprⁿft oder initialisiert wurden (so k÷nnen
  35478.     Sie verhindern, dass mit ungew÷hnlichen Daten gearbeitet wird).
  35479.    </P
  35480. ></DIV
  35481. ><DIV
  35482. CLASS="chapter"
  35483. ><HR><H1
  35484. ><A
  35485. NAME="security.hiding"
  35486. >Kapitel 29. Verstecken von PHP</A
  35487. ></H1
  35488. ><P
  35489. >     Generell ist Sicherheit durch Unklarheit eine der schwΣchsten Formen von
  35490.     Sicherheit. Aber in manchen FΣllen ist ein klein Wenig mehr an extra
  35491.     Sicherheit wⁿnschenswert.
  35492.    </P
  35493. ><P
  35494. >     Ein paar einfache Techniken helfen PHP zu Verstecken, um einen nach
  35495.     SchwΣchen in Ihrem System suchenden Angreifer m÷glicherweise langsamer
  35496.     zu machen. Wenn Sie in Ihrer <TT
  35497. CLASS="filename"
  35498. >php.ini</TT
  35499. > expose_php = off setzen,
  35500.     reduzieren Sie damit die ihm zur Verfⁿgung stehenden Informationen.
  35501.    </P
  35502. ><P
  35503. >     Eine andere Taktik ist, den Webserver wie z.B. Apache entweder mittels
  35504.     einer <TT
  35505. CLASS="filename"
  35506. >.htaccess</TT
  35507. > Direktive oder in der Apache Konfigurationsdatei selbst
  35508.     so konfigurieren, dass dieser verschiedene Dateitypen durch PHP parst.
  35509.     So k÷nnen Sie irrefⁿhrende Dateierweiterungen verwenden:
  35510.     <TABLE
  35511. WIDTH="100%"
  35512. BORDER="0"
  35513. CELLPADDING="0"
  35514. CELLSPACING="0"
  35515. CLASS="EXAMPLE"
  35516. ><TR
  35517. ><TD
  35518. ><DIV
  35519. CLASS="example"
  35520. ><A
  35521. NAME="AEN5880"
  35522. ></A
  35523. ><P
  35524. ><B
  35525. >Beispiel 29-1. PHP als andere Sprache ausgeben</B
  35526. ></P
  35527. ><TABLE
  35528. BORDER="0"
  35529. BGCOLOR="#E0E0E0"
  35530. CELLPADDING="5"
  35531. ><TR
  35532. ><TD
  35533. ><PRE
  35534. CLASS="apache-conf"
  35535. ># Lasse PHP Code wie andere Arten von Code aussehen
  35536. AddType application/x-httpd-php .asp .py .pl</PRE
  35537. ></TD
  35538. ></TR
  35539. ></TABLE
  35540. ></DIV
  35541. ></TD
  35542. ></TR
  35543. ></TABLE
  35544. >
  35545.     Oder komplett unklar machen:
  35546.     <TABLE
  35547. WIDTH="100%"
  35548. BORDER="0"
  35549. CELLPADDING="0"
  35550. CELLSPACING="0"
  35551. CLASS="EXAMPLE"
  35552. ><TR
  35553. ><TD
  35554. ><DIV
  35555. CLASS="example"
  35556. ><A
  35557. NAME="AEN5883"
  35558. ></A
  35559. ><P
  35560. ><B
  35561. >Beispiel 29-2. Verwenden von unbekannten Typen fⁿr PHP Dateierweiterungen</B
  35562. ></P
  35563. ><TABLE
  35564. BORDER="0"
  35565. BGCOLOR="#E0E0E0"
  35566. CELLPADDING="5"
  35567. ><TR
  35568. ><TD
  35569. ><PRE
  35570. CLASS="apache-conf"
  35571. ># Lasse PHP Code wie unbekannte Typen aussehen
  35572. AddType application/x-httpd-php .bop .foo .133t</PRE
  35573. ></TD
  35574. ></TR
  35575. ></TABLE
  35576. ></DIV
  35577. ></TD
  35578. ></TR
  35579. ></TABLE
  35580. >
  35581.     Oder verstecken Sie ihn als html Code, was einen leichten
  35582.     Performanceverlust bedeutet, da alle html Dateien durch die PHP
  35583.     Engine geparst werden:
  35584.     <TABLE
  35585. WIDTH="100%"
  35586. BORDER="0"
  35587. CELLPADDING="0"
  35588. CELLSPACING="0"
  35589. CLASS="EXAMPLE"
  35590. ><TR
  35591. ><TD
  35592. ><DIV
  35593. CLASS="example"
  35594. ><A
  35595. NAME="AEN5886"
  35596. ></A
  35597. ><P
  35598. ><B
  35599. >Beispiel 29-3. Verwenden von html Typen fⁿr PHP Dateierweiterungen</B
  35600. ></P
  35601. ><TABLE
  35602. BORDER="0"
  35603. BGCOLOR="#E0E0E0"
  35604. CELLPADDING="5"
  35605. ><TR
  35606. ><TD
  35607. ><PRE
  35608. CLASS="apache-conf"
  35609. ># Lasse PHP code wie html aussehen
  35610. AddType application/x-httpd-php .htm .html</PRE
  35611. ></TD
  35612. ></TR
  35613. ></TABLE
  35614. ></DIV
  35615. ></TD
  35616. ></TR
  35617. ></TABLE
  35618. >
  35619.     Um dies effektiv arbeiten zu lassen, mⁿssen Sie Ihre PHP Dateien
  35620.     nach den obigen Dateierweiterungen umbenennen. WΣhrend dies eine
  35621.     Form der Sicherheit durch Verhⁿllung ist, ist es ein kleines
  35622.     prΣventives Ma▀ mit ein paar Nachteilen.
  35623.    </P
  35624. ></DIV
  35625. ><DIV
  35626. CLASS="chapter"
  35627. ><HR><H1
  35628. ><A
  35629. NAME="security.current"
  35630. >Kapitel 30. Aktuell bleiben</A
  35631. ></H1
  35632. ><P
  35633. >     PHP wird, wie jedes andere gro▀e System auch, stΣndig geprⁿft und
  35634.     weiterentwickelt. Jede neue Version wird oft sowohl gr÷▀e, als auch
  35635.     kleine ─nderungen enthalten, welche die Gesamtsicherheit und
  35636.     StabilitΣt des Systems betreffenden Punkte (z.B. Sicherheit,
  35637.     Konfiguration) verbessern bzw. vorhandene MΣngel beheben.
  35638.    </P
  35639. ><P
  35640. >     Wie auch bei anderen Scriptsprachen und Programmen auf Systemebene
  35641.     ist der beste Ansatz ein oftmaliges Update, und sich laufend ⁿber
  35642.     die letzten Versionen und deren ─nderungen zu informieren.
  35643.    </P
  35644. ></DIV
  35645. ></DIV
  35646. ><DIV
  35647. CLASS="PART"
  35648. ><A
  35649. NAME="features"
  35650. ></A
  35651. ><DIV
  35652. CLASS="TITLEPAGE"
  35653. ><H1
  35654. CLASS="title"
  35655. >V. Features</H1
  35656. ><DIV
  35657. CLASS="TOC"
  35658. ><DL
  35659. ><DT
  35660. ><B
  35661. >Inhaltsverzeichnis</B
  35662. ></DT
  35663. ><DT
  35664. >31. <A
  35665. HREF="#features.http-auth"
  35666. >HTTP-Authentifizierung mit PHP</A
  35667. ></DT
  35668. ><DT
  35669. >32. <A
  35670. HREF="#features.cookies"
  35671. >Cookies</A
  35672. ></DT
  35673. ><DT
  35674. >33. <A
  35675. HREF="#features.xforms"
  35676. >Dealing with XForms</A
  35677. ></DT
  35678. ><DT
  35679. >34. <A
  35680. HREF="#features.file-upload"
  35681. >Steuerung von Dateiuploads</A
  35682. ></DT
  35683. ><DT
  35684. >35. <A
  35685. HREF="#features.remote-files"
  35686. >Zugriff auf entfernte Dateien</A
  35687. ></DT
  35688. ><DT
  35689. >36. <A
  35690. HREF="#features.connection-handling"
  35691. >Verbindungssteuerung</A
  35692. ></DT
  35693. ><DT
  35694. >37. <A
  35695. HREF="#features.persistent-connections"
  35696. >Persistente Datenbankverbindungen</A
  35697. ></DT
  35698. ><DT
  35699. >38. <A
  35700. HREF="#features.safe-mode"
  35701. >Safe Mode</A
  35702. ></DT
  35703. ><DT
  35704. >39. <A
  35705. HREF="#features.commandline"
  35706. >PHP auf der Kommandozeile</A
  35707. ></DT
  35708. ></DL
  35709. ></DIV
  35710. ></DIV
  35711. ><DIV
  35712. CLASS="chapter"
  35713. ><HR><H1
  35714. ><A
  35715. NAME="features.http-auth"
  35716. >Kapitel 31. HTTP-Authentifizierung mit PHP</A
  35717. ></H1
  35718. ><P
  35719. >    Die HTTP-Authentifizierung durch PHP ist nur verfⁿgbar, wenn PHP als
  35720.    Apache-Modul lΣuft und funktioniert daher nicht mit der CGI-Version.
  35721.    In einem PHP-Skript fⁿr ein Apache-Modul kann man die Funktion
  35722.    <A
  35723. HREF="#function.header"
  35724. ><B
  35725. CLASS="function"
  35726. >header()</B
  35727. ></A
  35728. > benutzen, um die Nachricht "Authentifizierung 
  35729.    notwendig" an den Client-Browser zu senden, damit dieser
  35730.    ein Fenster zur Eingabe von Benutzername/Passwort ÷ffnet.
  35731.    Hat der Benutzer diese eingegeben, wird die URL des PHP-Scripts
  35732.    mit den Variablen $PHP_AUTH_USER, $PHP_AUTH_PW 
  35733.    und $PHP_AUTH_TYPE, die den jeweiligen Benutzernamen, das 
  35734.    Passwort und den Typ der Identifizierung enthalten, erneut aufgerufen.
  35735.    Momentan wird nur das Authentifizierungsmodell "basic" unterstⁿtzt. 
  35736.    NΣheres hierzu bei der <A
  35737. HREF="#function.header"
  35738. ><B
  35739. CLASS="function"
  35740. >header()</B
  35741. ></A
  35742. > Funktion.
  35743.   </P
  35744. ><DIV
  35745. CLASS="note"
  35746. ><BLOCKQUOTE
  35747. CLASS="note"
  35748. ><P
  35749. ><B
  35750. >Anmerkung zur PHP Version: </B
  35751. >
  35752.     <A
  35753. HREF="#language.variables.superglobals"
  35754. >Autoglobals</A
  35755. >,
  35756.     wie <A
  35757. HREF="#reserved.variables.server"
  35758. >$_SERVER</A
  35759. >, sind seit
  35760.     der PHP Version <A
  35761. HREF="http://www.php.net/release_4_1_0.php"
  35762. TARGET="_top"
  35763. >4.1.0</A
  35764. > verfⁿgbar.
  35765.     <VAR
  35766. CLASS="varname"
  35767. >$HTTP_SERVER_VARS</VAR
  35768. > seit PHP 3.
  35769.    </P
  35770. ></BLOCKQUOTE
  35771. ></DIV
  35772. ><P
  35773. >    Ein Auszug aus einem Skript, das die Clientauthentifizierung
  35774.    auf einer Seite erzwingt, wⁿrde so aussehen:
  35775.  
  35776.    <TABLE
  35777. WIDTH="100%"
  35778. BORDER="0"
  35779. CELLPADDING="0"
  35780. CELLSPACING="0"
  35781. CLASS="EXAMPLE"
  35782. ><TR
  35783. ><TD
  35784. ><DIV
  35785. CLASS="example"
  35786. ><A
  35787. NAME="AEN5908"
  35788. ></A
  35789. ><P
  35790. ><B
  35791. >Beispiel 31-1. HTTP-Authentifizierung</B
  35792. ></P
  35793. ><TABLE
  35794. BORDER="0"
  35795. BGCOLOR="#E0E0E0"
  35796. CELLPADDING="5"
  35797. ><TR
  35798. ><TD
  35799. ><PRE
  35800. CLASS="php"
  35801. ><?php
  35802.   if (!isset($_SERVER['PHP_AUTH_USER'])) {
  35803.        Header("WWW-Authenticate: Basic realm=\"My Realm\"");
  35804.        Header("HTTP/1.0 401 Unauthorized");
  35805.        echo "Text to send if user hits Cancel button\n";
  35806.        exit;
  35807.         } else {
  35808.     echo "Hello {$_SERVER['PHP_AUTH_USER']}";
  35809.     echo "<p>You entered {$_SERVER['PHP_AUTH_PW']} as your password.</p>";
  35810.   }
  35811. ?></PRE
  35812. ></TD
  35813. ></TR
  35814. ></TABLE
  35815. ></DIV
  35816. ></TD
  35817. ></TR
  35818. ></TABLE
  35819. >
  35820.    </P
  35821. ><DIV
  35822. CLASS="note"
  35823. ><BLOCKQUOTE
  35824. CLASS="note"
  35825. ><P
  35826. ><B
  35827. >Hinweis: </B
  35828. >
  35829.     Achten Sie bei den Header-Zeilen fⁿr maximale KompatibilitΣt auf die
  35830.     richtige Schreibweise! Das Schlⁿsselwort "Basic" sollte genau so geschrieben
  35831.     werden, der Realm-String muss in doppelte (nicht einfache) Anfⁿhrungszeichen
  35832.     eingeschlossen sein, und in der "HTTP/1.0 401"-Zeile
  35833.     darf nur genau ein Leerzeichen vor dem 401-Code stehen.
  35834.    </P
  35835. ></BLOCKQUOTE
  35836. ></DIV
  35837. ><P
  35838. >    Anstatt $_SERVER['PHP_AUTH_USER'] und $_SERVER['PHP_AUTH_PW'] einfach nur 
  35839.    auszugeben, werden Sie den Benutzernamen und das Passwort 
  35840.    auf Gⁿltigkeit ⁿberprⁿfen wollen. Dies kann durch die Abfrage 
  35841.    einer Datenbank oder das Einlesen einer Textdatei geschehen.
  35842.   </P
  35843. ><P
  35844. >    Vorsicht bei einigen Internet Explorer-Versionen - sie scheinen
  35845.    sehr wΣhlerisch zu sein, was die Reihenfolge der Header angeht.
  35846.    Abhilfe schafft hier das Senden des <SPAN
  35847. CLASS="emphasis"
  35848. ><I
  35849. CLASS="emphasis"
  35850. >WWW-Authenticate</I
  35851. ></SPAN
  35852. >
  35853.    Headers vor dem <SPAN
  35854. CLASS="errorcode"
  35855. >HTTP/1.0 401</SPAN
  35856. >.
  35857.   </P
  35858. ><P
  35859. >    Um zu unterbinden, dass ein Skript das Passwort einer durch 
  35860.    einen traditionellen externen Mechanismus geschⁿtzten Seite
  35861.    ausliest, werden die PHP_AUTH Variablen nicht gesetzt, wenn 
  35862.    eine externe Authentifizierung fⁿr diese bestimmte Seite aktiviert
  35863.    ist. In diesem Fall kann die $_SERVER['REMOTE_USER'] Variable benutzt
  35864.    werden, um den Benutzer durch die externe Zugriffskontrolle
  35865.    zu identifizieren.
  35866.   </P
  35867. ><DIV
  35868. CLASS="note"
  35869. ><BLOCKQUOTE
  35870. CLASS="note"
  35871. ><P
  35872. ><B
  35873. >Konfigurationshinweis: </B
  35874. >
  35875.     PHP prⁿft das Vorhandensein einer <VAR
  35876. CLASS="literal"
  35877. >AuthType</VAR
  35878. >
  35879.     Apache-Direktive, um zu entscheiden, ob eine externe
  35880.     Authentifizierung aktiv ist. Vermeiden Sie deshalb diese
  35881.     Konfigurationsdirektive im Kontext der PHP-Authentifizierung
  35882.     (anderenfalls wird jeder Authentifizierungsversuch misslingen).
  35883.    </P
  35884. ></BLOCKQUOTE
  35885. ></DIV
  35886. ><P
  35887. >    Zu beachten ist, dass obenstehendes keinesfalls jemanden,
  35888.    der die Kontrolle ⁿber eine nichtgeschⁿtzte URL hat, davon
  35889.    abhalten kann, Passw÷rter von geschⁿtzten URLs auf dem
  35890.    gleichen Rechner auszulesen.
  35891.   </P
  35892. ><P
  35893. >    Sowohl Netscape als auch der Internet Explorer l÷schen den
  35894.    lokalen Authentifizierungscache des Browserfensters, wenn der
  35895.    Server eine 401-Meldung zurⁿckgibt. Dies kann benutzt werden, um
  35896.    einen Benutzer "auszuloggen" und eine erneute Eingabe des
  35897.    Benutzernamens/Passworts zu erzwingen. Manchmal wird dieses Verhalten
  35898.    fⁿr das automatische Ausloggen nach Ablauf einer bestimmten Zeitspanne
  35899.    oder fⁿr einen Logout-Button genutzt.
  35900.   </P
  35901. ><TABLE
  35902. WIDTH="100%"
  35903. BORDER="0"
  35904. CELLPADDING="0"
  35905. CELLSPACING="0"
  35906. CLASS="EXAMPLE"
  35907. ><TR
  35908. ><TD
  35909. ><DIV
  35910. CLASS="example"
  35911. ><A
  35912. NAME="AEN5925"
  35913. ></A
  35914. ><P
  35915. ><B
  35916. >Beispiel 31-2. HTTP-Authentifizierung, mit erneuter Anforderung von Name/Passwort</B
  35917. ></P
  35918. ><TABLE
  35919. BORDER="0"
  35920. BGCOLOR="#E0E0E0"
  35921. CELLPADDING="5"
  35922. ><TR
  35923. ><TD
  35924. ><PRE
  35925. CLASS="php"
  35926. ><?php
  35927.   function authenticate()
  35928.   {
  35929.      Header("WWW-Authenticate: Basic realm=\"Test Authentication System\"");
  35930.      Header("HTTP/1.0 401 Unauthorized");
  35931.      echo "You must enter a valid login ID and password to access this resource\n";
  35932.      exit;
  35933.   }
  35934.  
  35935.   if (!isset($_SERVER['PHP_AUTH_USER']) || ($SeenBefore == 1 && ! strcmp( $OldAuth, $_SERVER['PHP_AUTH_USER']))) {
  35936.     authenticate();
  35937.   } else {
  35938.       echo "Welcome: {$_SERVER['PHP_AUTH_USER']}<br>";
  35939.       echo "Old: $OldAuth";
  35940.       echo "<form action=\"{$_SERVER['PHP_SELF']}\" method=\"post\">\n";
  35941.       echo "<input type=\"hidden\" name=\"SeenBefore\" value=\"1\">\n";
  35942.       echo "<input type=\"hidden\" name=\"OldAuth\" value=\"{$_SERVER['PHP_AUTH_USER']}\">\n";
  35943.       echo "<input type=\"submit\" value=\"Re Authenticate\">\n";
  35944.       echo "</form>\n";
  35945.   }
  35946. ?></PRE
  35947. ></TD
  35948. ></TR
  35949. ></TABLE
  35950. ></DIV
  35951. ></TD
  35952. ></TR
  35953. ></TABLE
  35954. ><P
  35955. >    Dieses Verhalten wird vom Authentifizierungsstandard HTTP Basic 
  35956.    nicht gefordert, daher sollte man sich nie darauf verlassen. Tests
  35957.    mit Lynx haben gezeigt, dass Lynx die Authentifizierungsinformationen
  35958.    bei Erhalt einer 401-Meldung nicht l÷scht. Ein Klick auf den Zurⁿck-
  35959.    Button und danach auf VorwΣrts wird die angeforderte Adresse
  35960.    ÷ffnen (und zwar so lange, bis die Identifizierung der Benutzer
  35961.    geΣndert wird).
  35962.   </P
  35963. ><P
  35964. >    Weiterhin muss beachtet werden, dass dies unter dem Microsoft
  35965.    IIS mit der CGI-Version von PHP aufgrund einer
  35966.    EinschrΣnkung des IIS nicht funktioniert.
  35967.   </P
  35968. ></DIV
  35969. ><DIV
  35970. CLASS="chapter"
  35971. ><HR><H1
  35972. ><A
  35973. NAME="features.cookies"
  35974. >Kapitel 32. Cookies</A
  35975. ></H1
  35976. ><P
  35977. >    PHP unterstⁿtzt HTTP-Cookies. Hierbei handelt es sich um einen
  35978.    Mechanismus, um Informationen beim Client zu speichern und somit
  35979.    wiederkehrende Besucher zu identifizieren oder ihren Weg innerhalb
  35980.    des Angebotes nachzuvollziehen. Cookies k÷nnen durch die Funktion
  35981.    <A
  35982. HREF="#function.setcookie"
  35983. ><B
  35984. CLASS="function"
  35985. >setcookie()</B
  35986. ></A
  35987. > gesetzt werden. Sie sind Bestandteil
  35988.    des HTTP-Headers, was bedeutet, dass die Funktion
  35989.    <A
  35990. HREF="#function.setcookie"
  35991. ><B
  35992. CLASS="function"
  35993. >setcookie()</B
  35994. ></A
  35995. > aufgerufen werden muss, bevor irgendeine
  35996.    Ausgabe an den Browser erfolgt. Dies ist die gleiche EinschrΣnkung, der
  35997.    auch die Funktion <A
  35998. HREF="#function.header"
  35999. ><B
  36000. CLASS="function"
  36001. >header()</B
  36002. ></A
  36003. > unterliegt. Sie k÷nnen
  36004.    die <A
  36005. HREF="#ref.outcontrol"
  36006. >Funktionen zur Ausgabesteuerung</A
  36007. >
  36008.    benutzen, um die Ausgaben des Skriptes zu verz÷gern, bis entschieden ist,
  36009.    ob Cookies gesetzt bzw. Header gesendet werden sollen oder nicht. 
  36010.   </P
  36011. ><P
  36012. >    Vom Client gesendete Cookies werden - abhΣngig von den
  36013.    Konfigurationsvariablen <VAR
  36014. CLASS="literal"
  36015. >register_globals</VAR
  36016. > und
  36017.    <VAR
  36018. CLASS="literal"
  36019. >variables_order</VAR
  36020. > - automatisch in eine Variable
  36021.    geschrieben, wie es auch bei mittels GET oder POST gesendeten Daten
  36022.    geschieht. Sollen einem Cookie mehrere Werte zugewiesen werden, so
  36023.    muss dem Cookienamen lediglich <SPAN
  36024. CLASS="emphasis"
  36025. ><I
  36026. CLASS="emphasis"
  36027. >[]</I
  36028. ></SPAN
  36029. > angefⁿgt
  36030.    werden.
  36031.   </P
  36032. ><P
  36033. >    Seit PHP 4.1.0 werden alle vom Client gesendeten Cookies in dem
  36034.    auto-globalen Array <VAR
  36035. CLASS="varname"
  36036. >$_COOKIE</VAR
  36037. > gespeichert. In
  36038.    Σlteren PHP-Versionen stehen diese Daten in
  36039.    <VAR
  36040. CLASS="varname"
  36041. >$HTTP_COOKIE_VARS</VAR
  36042. > gespeichert, sofern die
  36043.    Konfigurationsvariable <VAR
  36044. CLASS="literal"
  36045. >track_vars</VAR
  36046. > gesetzt ist.
  36047.   </P
  36048. ><P
  36049. >    Weitere Informationen sowie Anmerkungen zu Browser-Bugs finden
  36050.    Sie im Abschnitt <A
  36051. HREF="#function.setcookie"
  36052. ><B
  36053. CLASS="function"
  36054. >setcookie()</B
  36055. ></A
  36056. >.
  36057.   </P
  36058. ></DIV
  36059. ><DIV
  36060. CLASS="chapter"
  36061. ><HR><H1
  36062. ><A
  36063. NAME="features.xforms"
  36064. >Kapitel 33. Dealing with XForms</A
  36065. ></H1
  36066. ><P
  36067. >   <A
  36068. HREF="http://www.w3.org/MarkUp/Forms/"
  36069. TARGET="_top"
  36070. >XForms</A
  36071. > defines a variation on traditional
  36072.   webforms which allows them to be used on a wider variety of platforms and 
  36073.   browsers or even non-traditional media such as PDF documents.
  36074.  </P
  36075. ><P
  36076. >   The first key difference in XForms is how the form is sent to the client.
  36077.   <A
  36078. HREF="http://www.w3.org/MarkUp/Forms/2003/xforms-for-html-authors.html"
  36079. TARGET="_top"
  36080. >XForms for HTML Authors</A
  36081. >
  36082.   contains a detailed description of how to create XForms, for the purpose
  36083.   of this tutorial we'll only be looking at a simple example.
  36084.  </P
  36085. ><TABLE
  36086. WIDTH="100%"
  36087. BORDER="0"
  36088. CELLPADDING="0"
  36089. CELLSPACING="0"
  36090. CLASS="EXAMPLE"
  36091. ><TR
  36092. ><TD
  36093. ><DIV
  36094. CLASS="example"
  36095. ><A
  36096. NAME="AEN5953"
  36097. ></A
  36098. ><P
  36099. ><B
  36100. >Beispiel 33-1. A simple XForms search form</B
  36101. ></P
  36102. ><TABLE
  36103. BORDER="0"
  36104. BGCOLOR="#E0E0E0"
  36105. CELLPADDING="5"
  36106. ><TR
  36107. ><TD
  36108. ><PRE
  36109. CLASS="html"
  36110. ><h:html xmlns:h="http://www.w3.org/1999/xhtml"
  36111.         xmlns="http://www.w3.org/2002/xforms">
  36112. <h:head>
  36113.  <h:title>Search</h:title>
  36114.  <model>
  36115.   <submission action="http://example.com/search"
  36116.               method="post" id="s"/>
  36117.  </model>
  36118. </h:head>
  36119. <h:body>
  36120.  <h:p>
  36121.   <input ref="q"><label>Find</label></input>
  36122.   <submit submission="s"><label>Go</label></submit>
  36123.  </h:p>
  36124. </h:body>
  36125. </h:html></PRE
  36126. ></TD
  36127. ></TR
  36128. ></TABLE
  36129. ></DIV
  36130. ></TD
  36131. ></TR
  36132. ></TABLE
  36133. ><P
  36134. >   The above form displays a text input box (named <VAR
  36135. CLASS="parameter"
  36136. >q</VAR
  36137. >),
  36138.   and a submit button.  When the submit button is clicked, the form will be
  36139.   sent to the page referred to by <VAR
  36140. CLASS="literal"
  36141. >action</VAR
  36142. >.
  36143.  </P
  36144. ><P
  36145. >   Here's where it starts to look different from your web application's point
  36146.   of view.  In a normal HTML form, the data would be sent as 
  36147.   <VAR
  36148. CLASS="literal"
  36149. >application/x-www-form-urlencoded</VAR
  36150. >, in the XForms world
  36151.   however, this information is sent as XML formatted data.
  36152.  </P
  36153. ><P
  36154. >   If you're choosing to work with XForms then you probably want that data as
  36155.   XML, in that case, look in <VAR
  36156. CLASS="varname"
  36157. >$HTTP_RAW_POST_DATA</VAR
  36158. > where
  36159.   you'll find the XML document generated by the browser which you can pass
  36160.   into your favorite XSLT engine or document parser.
  36161.  </P
  36162. ><P
  36163. >   If you're not interrested in formatting and just want your data to be loaded
  36164.   into the traditional <VAR
  36165. CLASS="varname"
  36166. >$_POST</VAR
  36167. > variable, you can instruct
  36168.   the client browser to send it as <VAR
  36169. CLASS="literal"
  36170. >application/x-www-form-urlencoded</VAR
  36171. >
  36172.   by changing the <VAR
  36173. CLASS="parameter"
  36174. >method</VAR
  36175. > attribute to
  36176.   <SPAN
  36177. CLASS="emphasis"
  36178. ><I
  36179. CLASS="emphasis"
  36180. >urlencoded-post</I
  36181. ></SPAN
  36182. >.
  36183.  </P
  36184. ><TABLE
  36185. WIDTH="100%"
  36186. BORDER="0"
  36187. CELLPADDING="0"
  36188. CELLSPACING="0"
  36189. CLASS="EXAMPLE"
  36190. ><TR
  36191. ><TD
  36192. ><DIV
  36193. CLASS="example"
  36194. ><A
  36195. NAME="AEN5968"
  36196. ></A
  36197. ><P
  36198. ><B
  36199. >Beispiel 33-2. Using an XForm to populate <VAR
  36200. CLASS="varname"
  36201. >$_POST</VAR
  36202. ></B
  36203. ></P
  36204. ><TABLE
  36205. BORDER="0"
  36206. BGCOLOR="#E0E0E0"
  36207. CELLPADDING="5"
  36208. ><TR
  36209. ><TD
  36210. ><PRE
  36211. CLASS="html"
  36212. ><h:html xmlns:h="http://www.w3.org/1999/xhtml"
  36213.         xmlns="http://www.w3.org/2002/xforms">
  36214. <h:head>
  36215.  <h:title>Search</h:title>
  36216.  <model>
  36217.   <submission action="http://example.com/search"
  36218.               method="urlencoded-post" id="s"/>
  36219.  </model>
  36220. </h:head>
  36221. <h:body>
  36222.  <h:p>
  36223.   <input ref="q"><label>Find</label></input>
  36224.   <submit submission="s"><label>Go</label></submit>
  36225.  </h:p>
  36226. </h:body>
  36227. </h:html></PRE
  36228. ></TD
  36229. ></TR
  36230. ></TABLE
  36231. ></DIV
  36232. ></TD
  36233. ></TR
  36234. ></TABLE
  36235. ><DIV
  36236. CLASS="note"
  36237. ><BLOCKQUOTE
  36238. CLASS="note"
  36239. ><P
  36240. ><B
  36241. >Anmerkung: </B
  36242. >
  36243.    As of this writing, many browsers do not support XForms.
  36244.    Check your browser version if the above examples fails.
  36245.   </P
  36246. ></BLOCKQUOTE
  36247. ></DIV
  36248. ></DIV
  36249. ><DIV
  36250. CLASS="chapter"
  36251. ><HR><H1
  36252. ><A
  36253. NAME="features.file-upload"
  36254. >Kapitel 34. Steuerung von Dateiuploads</A
  36255. ></H1
  36256. ><DIV
  36257. CLASS="sect1"
  36258. ><H2
  36259. CLASS="sect1"
  36260. ><A
  36261. NAME="features.file-upload.post-method"
  36262. >Dateiuploads mit POST</A
  36263. ></H2
  36264. ><P
  36265. >     PHP kann Dateiuploads mit jedem RFC-1867 konformen Browser
  36266.     (dazu geh÷ren der Netscape Navigator 3 oder h÷her, Microsoft
  36267.     Internet Explorer 3 mit einem Patch von Microsoft oder h÷her
  36268.     ohne Patch) durchfⁿhren. Es k÷nnen sowohl Text- als auch
  36269.     BinΣrdaten hochgeladen werden. Mit PHP┤s Authentifizierungs-
  36270.     und Dateifunktionen besteht volle Kontrolle darⁿber, wer
  36271.     Dateien hochladen darf und was mit den Dateien geschehen soll,
  36272.     wenn der Upload beendet ist.
  36273.    </P
  36274. ><DIV
  36275. CLASS="note"
  36276. ><BLOCKQUOTE
  36277. CLASS="note"
  36278. ><P
  36279. ><B
  36280. >Diesbezⁿgliche Konfigurationshinweise: </B
  36281. >
  36282.      Siehe auch die Anweisungen
  36283.      <A
  36284. HREF="#ini.file-uploads"
  36285. >file_uploads</A
  36286. >, 
  36287.      <A
  36288. HREF="#ini.upload-max-filesize"
  36289. >upload_max_filesize</A
  36290. >,
  36291.      <A
  36292. HREF="#ini.upload-tmp-dir"
  36293. >upload_tmp_dir</A
  36294. > und
  36295.      <A
  36296. HREF="#ini.post-max-size"
  36297. >post_max_size</A
  36298. > in der <TT
  36299. CLASS="filename"
  36300. >php.ini</TT
  36301. >
  36302.     </P
  36303. ></BLOCKQUOTE
  36304. ></DIV
  36305. ><P
  36306. >     PHP unterstⁿtzt auch Dateiuploads nach der PUT-Methode, die
  36307.     beispielsweise vom Netscape Composer und den W3C Amaya
  36308.     Clients benutzt wird. Siehe dazu <A
  36309. HREF="#features.file-upload.put-method"
  36310. >PUT-Unterstⁿtzung</A
  36311. >
  36312.     fⁿr nΣhere Informationen.
  36313.    </P
  36314. ><P
  36315. >     Eine Maske fⁿr den Dateiupload kann erstellt werden, indem man
  36316.     ein Formular entwirft, das ungefΣhr so aussieht:
  36317.     <TABLE
  36318. WIDTH="100%"
  36319. BORDER="0"
  36320. CELLPADDING="0"
  36321. CELLSPACING="0"
  36322. CLASS="EXAMPLE"
  36323. ><TR
  36324. ><TD
  36325. ><DIV
  36326. CLASS="example"
  36327. ><A
  36328. NAME="AEN5990"
  36329. ></A
  36330. ><P
  36331. ><B
  36332. >Beispiel 34-1. Formular fⁿr den Dateiupload</B
  36333. ></P
  36334. ><TABLE
  36335. BORDER="0"
  36336. BGCOLOR="#E0E0E0"
  36337. CELLPADDING="5"
  36338. ><TR
  36339. ><TD
  36340. ><PRE
  36341. CLASS="html"
  36342. ><form enctype="multipart/form-data" action="_URL_" method="post">
  36343. <input type="hidden" name="MAX_FILE_SIZE" value="30000">
  36344. Send this file: <input name="userfile" type="file">
  36345. <input type="submit" value="Send File">
  36346. </form></PRE
  36347. ></TD
  36348. ></TR
  36349. ></TABLE
  36350. ></DIV
  36351. ></TD
  36352. ></TR
  36353. ></TABLE
  36354. >
  36355.     Die _URL_ sollte auf eine PHP-Datei verweisen. Das versteckte Feld
  36356.     MAX_FILE_SIZE muss dem Dateieingabefeld vorangestellt werden und den
  36357.     Wert der maximal akzeptierten Dateigr÷▀e in Bytes enthalten.
  36358.     <DIV
  36359. CLASS="warning"
  36360. ><P
  36361. ></P
  36362. ><TABLE
  36363. CLASS="warning"
  36364. BORDER="1"
  36365. WIDTH="100%"
  36366. ><TR
  36367. ><TD
  36368. ALIGN="CENTER"
  36369. ><B
  36370. >Warnung</B
  36371. ></TD
  36372. ></TR
  36373. ><TR
  36374. ><TD
  36375. ALIGN="LEFT"
  36376. ><P
  36377. >       Die maximale Dateigr÷▀e MAX_FILE_SIZE ist fⁿr den Browser nur
  36378.       ein Hinweis und es ist leicht, diese Grenze zu umgehen. Also
  36379.       verlassen Sie sich nicht darauf, dass der Browser Ihrem Wunsch
  36380.       auch nachkommt! Wie auch immer, die PHP-Einstellungen fⁿr die
  36381.       maximale Dateigr÷▀e k÷nnen nicht getΣuscht werden.
  36382.      </P
  36383. ></TD
  36384. ></TR
  36385. ></TABLE
  36386. ></DIV
  36387. >
  36388.    </P
  36389. ><P
  36390. >     Die fⁿr hochgeladene Dateien definierten Variablen sind je nach
  36391.     PHP Version und Konfiguration verschieden. Die Autoglobale
  36392.     <A
  36393. HREF="#reserved.variables.files"
  36394. >$_FILES</A
  36395. > existiert
  36396.     seit PHP 4.1.0 und das Array <VAR
  36397. CLASS="varname"
  36398. >$HTTP_POST_FILES</VAR
  36399. >
  36400.     seit PHP 4.0.0. Diese Arrays enthalten alle Informationen ⁿber
  36401.     Ihre hochgeladenen Dateien. Die Verwendung von
  36402.     <VAR
  36403. CLASS="varname"
  36404. >$_FILES</VAR
  36405. > wird bevorzugt. Ist die PHP Anweisung
  36406.     <A
  36407. HREF="#ini.register-globals"
  36408. >register_globals</A
  36409. > auf
  36410.     <SPAN
  36411. CLASS="emphasis"
  36412. ><I
  36413. CLASS="emphasis"
  36414. >on</I
  36415. ></SPAN
  36416. >, stehen auch entsprechende Variablennamen
  36417.     zur Verfⁿgung. Seit PHP <A
  36418. HREF="http://www.php.net/release_4_2_0.php"
  36419. TARGET="_top"
  36420. >4.2.0</A
  36421. >
  36422.     steht <A
  36423. HREF="#ini.register-globals"
  36424. >register_globals</A
  36425. >
  36426.     standardmΣ▀ig  auf <SPAN
  36427. CLASS="emphasis"
  36428. ><I
  36429. CLASS="emphasis"
  36430. >off</I
  36431. ></SPAN
  36432. >.
  36433.    </P
  36434. ><P
  36435. >     Im Folgenden sind die Inhalte von
  36436.     <A
  36437. HREF="#reserved.variables.files"
  36438. >$_FILES</A
  36439. > aus unserem
  36440.     Beispielskript aufgelistet. Beachten Sie, dass dies auf der Annahme
  36441.     basiert, dass der Name des Dateiuploads wie in dem obigen
  36442.     Beispielskript <SPAN
  36443. CLASS="emphasis"
  36444. ><I
  36445. CLASS="emphasis"
  36446. >userfile</I
  36447. ></SPAN
  36448. > ist.
  36449.     <P
  36450. ></P
  36451. ><DIV
  36452. CLASS="variablelist"
  36453. ><DL
  36454. ><DT
  36455. ><VAR
  36456. CLASS="varname"
  36457. >$_FILES['userfile']['name']</VAR
  36458. ></DT
  36459. ><DD
  36460. ><P
  36461. >         Der ursprⁿngliche Dateiname auf der Client Maschine.
  36462.        </P
  36463. ></DD
  36464. ><DT
  36465. ><VAR
  36466. CLASS="varname"
  36467. >$_FILES['userfile']['type']</VAR
  36468. ></DT
  36469. ><DD
  36470. ><P
  36471. >         Der Mime-Type der Datei, falls der Browser diese Information
  36472.         zur Verfⁿgung gestellt hat. Ein Beispiel wΣre
  36473.         <VAR
  36474. CLASS="literal"
  36475. >"image/gif"</VAR
  36476. >.
  36477.         </P
  36478. ></DD
  36479. ><DT
  36480. ><VAR
  36481. CLASS="varname"
  36482. >$_FILES['userfile']['size']</VAR
  36483. ></DT
  36484. ><DD
  36485. ><P
  36486. >         Die Gr÷▀e der hochgeladenen Datei in Bytes.
  36487.        </P
  36488. ></DD
  36489. ><DT
  36490. ><VAR
  36491. CLASS="varname"
  36492. >$_FILES['userfile']['tmp_name']</VAR
  36493. ></DT
  36494. ><DD
  36495. ><P
  36496. >         Der temporΣre Dateiname, unter dem die hochgeladene Datei auf
  36497.         dem Server gespeichert wurde.
  36498.        </P
  36499. ></DD
  36500. ><DT
  36501. ><VAR
  36502. CLASS="varname"
  36503. >$_FILES['userfile']['error']</VAR
  36504. ></DT
  36505. ><DD
  36506. ><P
  36507. >         Der <A
  36508. HREF="#features.file-upload.errors"
  36509. >Fehlercode</A
  36510. >
  36511.         im Zusammenhang mit dem hochladen der Datei.
  36512.         <SPAN
  36513. CLASS="emphasis"
  36514. ><I
  36515. CLASS="emphasis"
  36516. >['error']</I
  36517. ></SPAN
  36518. > wurde in PHP 4.2.0 eingefⁿhrt.
  36519.        </P
  36520. ></DD
  36521. ></DL
  36522. ></DIV
  36523. >
  36524.    </P
  36525. ><DIV
  36526. CLASS="note"
  36527. ><BLOCKQUOTE
  36528. CLASS="note"
  36529. ><P
  36530. ><B
  36531. >Anmerkung: </B
  36532. >
  36533.      In den Versionen vor PHP 4.1.0 war dies
  36534.      <VAR
  36535. CLASS="varname"
  36536. >$HTTP_POST_FILES</VAR
  36537. >, und ist keine 
  36538.      <A
  36539. HREF="#language.variables.superglobals"
  36540. >'Autoglobale'</A
  36541. >
  36542.      Variable wie <VAR
  36543. CLASS="varname"
  36544. >$_FILES</VAR
  36545. >. PHP 3 unterstⁿtzt
  36546.      <VAR
  36547. CLASS="varname"
  36548. >$HTTP_POST_FILES</VAR
  36549. > nicht.
  36550.     </P
  36551. ></BLOCKQUOTE
  36552. ></DIV
  36553. ><P
  36554. >     Ist <A
  36555. HREF="#ini.register-globals"
  36556. >register_globals</A
  36557. >
  36558.     in der <TT
  36559. CLASS="filename"
  36560. >php.ini</TT
  36561. > aktiviert, stehen zusΣtzliche Variablen zur Verfⁿgung.
  36562.     Zum Beispiel entspricht <VAR
  36563. CLASS="varname"
  36564. >$userfile_name</VAR
  36565. >
  36566.     <VAR
  36567. CLASS="varname"
  36568. >$_FILES['userfile']['name']</VAR
  36569. >,
  36570.     <VAR
  36571. CLASS="varname"
  36572. >$userfile_type</VAR
  36573. > entspricht
  36574.     <VAR
  36575. CLASS="varname"
  36576. >$_FILES['userfile']['type']</VAR
  36577. >, etc. Beachten Sie,
  36578.     dass register_globals standardmΣ▀ig  deaktiviert ist, jedoch wird
  36579.     empfohlen, sich nicht darauf zu verlassen.
  36580.    </P
  36581. ><P
  36582. >     StandardmΣ▀ig werden Dateien in dem vorgegebenen temporΣren
  36583.     Verzeichnis des Servers gespeichert, au▀er es wurde mittels
  36584.     <A
  36585. HREF="#ini.upload-tmp-dir"
  36586. >upload_tmp_dir</A
  36587. > in
  36588.     der <TT
  36589. CLASS="filename"
  36590. >php.ini</TT
  36591. > ein anderer Ort konfiguriert.
  36592.     Das Standardverzeichnis des Servers kann durch das Setzen der
  36593.     Umgebungsvariablen <VAR
  36594. CLASS="envar"
  36595. >TMPDIR</VAR
  36596. > in der Umgebung, in der
  36597.     PHP ausgefⁿhrt wird, geΣndert werden. Das Setzen mittels der
  36598.     Funktion <A
  36599. HREF="#function.putenv"
  36600. ><B
  36601. CLASS="function"
  36602. >putenv()</B
  36603. ></A
  36604. > innerhalb eines Skriptes
  36605.     ist nicht m÷glich. Mittels dieser Umgebungsvariable kann auch
  36606.     sichergestellt werden, dass auch andere Operationen an
  36607.     hochgeladenen Dateien arbeiten k÷nnen.
  36608.     <TABLE
  36609. WIDTH="100%"
  36610. BORDER="0"
  36611. CELLPADDING="0"
  36612. CELLSPACING="0"
  36613. CLASS="EXAMPLE"
  36614. ><TR
  36615. ><TD
  36616. ><DIV
  36617. CLASS="example"
  36618. ><A
  36619. NAME="AEN6054"
  36620. ></A
  36621. ><P
  36622. ><B
  36623. >Beispiel 34-2. Dateiuploads prⁿfen</B
  36624. ></P
  36625. ><P
  36626. >       Weitere Informationen finden Sie auch in den Beschreibungen fⁿr
  36627.       <A
  36628. HREF="#function.is-uploaded-file"
  36629. ><B
  36630. CLASS="function"
  36631. >is_uploaded_file()</B
  36632. ></A
  36633. > und
  36634.       <A
  36635. HREF="#function.move-uploaded-file"
  36636. ><B
  36637. CLASS="function"
  36638. >move_uploaded_file()</B
  36639. ></A
  36640. >. Das folgende Beispiel
  36641.       verarbeitet einen von einem HTML-Formular kommenden Dateiupload.
  36642.      </P
  36643. ><TABLE
  36644. BORDER="0"
  36645. BGCOLOR="#E0E0E0"
  36646. CELLPADDING="5"
  36647. ><TR
  36648. ><TD
  36649. ><PRE
  36650. CLASS="php"
  36651. ><?php 
  36652. // In PHP kleiner als 4.1.0 sollten Sie $HTTP_POST_FILES anstatt $_FILES verwenden.
  36653. // In PHP kleiner als 4.0.3 verwenden Sie copy() und is_uploaded_file() anstatt von
  36654. // move_uploaded_file()
  36655.  
  36656. $uploaddir = '/var/www/uploads/';
  36657.  
  36658. print "<pre>";
  36659. if (move_uploaded_file($_FILES['userfile']['tmp_name'], $uploaddir . $_FILES['userfile']['name'])) {
  36660.     print "File is valid, and was successfully uploaded.  Here's some more debugging info:\n";
  36661.     print_r($_FILES);
  36662. } else {
  36663.     print "Possible file upload attack!  Here's some debugging info:\n";
  36664.     print_r($_FILES);
  36665. }
  36666.  
  36667. ?></PRE
  36668. ></TD
  36669. ></TR
  36670. ></TABLE
  36671. ></DIV
  36672. ></TD
  36673. ></TR
  36674. ></TABLE
  36675. >
  36676.    </P
  36677. ><P
  36678. >     Das die hochgeladene Datei empfangende Skript sollte die notwendige
  36679.     Logik zur Entscheidung enthalten, was mit der hochgeladenen Datei
  36680.     geschehen soll. Sie k÷nnen zum Beispiel
  36681.     <VAR
  36682. CLASS="varname"
  36683. >$_FILES['userfile']['size']</VAR
  36684. > benutzen,
  36685.     um zu kleine bzw. zu gro▀e Dateien wegzuwerfen. Sie k÷nnen
  36686.     <VAR
  36687. CLASS="varname"
  36688. >$_FILES['userfile']['type']</VAR
  36689. > nutzen, um Dateien
  36690.     eines unerwⁿnschten Typs wegzuwerfen. Seit PHP 4.2.0 k÷nnen Sie Ihre
  36691.     Logik auch mittels <VAR
  36692. CLASS="varname"
  36693. >$_FILES['userfile']['error']</VAR
  36694. >
  36695.     anhand der <A
  36696. HREF="#features.file-upload.errors"
  36697. >Fehlercodes</A
  36698. >
  36699.     planen. Egal welche Logik Sie verwenden, Sie sollten die Datei in dem
  36700.     temporΣren Verzeichnis entweder l÷schen, oder an einen anderen Ort
  36701.     verschieben.
  36702.    </P
  36703. ><P
  36704. >     Wurde die Datei in dem temporΣren Verzeichnis nicht verschoben oder
  36705.     umbenannt, wird sie am Ende des Requests gel÷scht.
  36706.    </P
  36707. ></DIV
  36708. ><DIV
  36709. CLASS="sect1"
  36710. ><HR><H2
  36711. CLASS="sect1"
  36712. ><A
  36713. NAME="features.file-upload.errors"
  36714. >Fehlermeldungen erklΣrt</A
  36715. ></H2
  36716. ><P
  36717. >     Seit PHP 4.2.0 gibt PHP zusammen mit dem Datei-Array entsprechende
  36718.     Fehlermeldungen. Die Fehlermeldung befindet sich im Segment
  36719.     <SPAN
  36720. CLASS="emphasis"
  36721. ><I
  36722. CLASS="emphasis"
  36723. >['error']</I
  36724. ></SPAN
  36725. > des Datei-Arrays, welches wΣhrend des
  36726.     Hochladens der Datei erstellt wird. In anderen Worten kann der Fehler
  36727.     in <VAR
  36728. CLASS="varname"
  36729. >$_FILES['userfile']['error']</VAR
  36730. > gefunden werden.
  36731.    </P
  36732. ><P
  36733. >     <P
  36734. ></P
  36735. ><DIV
  36736. CLASS="variablelist"
  36737. ><DL
  36738. ><DT
  36739. ><VAR
  36740. CLASS="varname"
  36741. >UPLOAD_ERR_OK</VAR
  36742. ></DT
  36743. ><DD
  36744. ><P
  36745. >         Wert: 0; Es liegt kein Fehler vor, die Datei wurde erfolgreich hochgeladen.
  36746.        </P
  36747. ></DD
  36748. ><DT
  36749. ><VAR
  36750. CLASS="varname"
  36751. >UPLOAD_ERR_INI_SIZE</VAR
  36752. ></DT
  36753. ><DD
  36754. ><P
  36755. >         Wert: 1; Die hochgeladene Datei ⁿberschreitet die in der Anweisung
  36756.         <A
  36757. HREF="#ini.upload-max-filesize"
  36758. >upload_max_filesize</A
  36759. > 
  36760.         in <TT
  36761. CLASS="filename"
  36762. >php.ini</TT
  36763. > festgelegte Gr÷▀e.
  36764.        </P
  36765. ></DD
  36766. ><DT
  36767. ><VAR
  36768. CLASS="varname"
  36769. >UPLOAD_ERR_FORM_SIZE</VAR
  36770. ></DT
  36771. ><DD
  36772. ><P
  36773. >         Wert: 2; Die hochgeladene Datei ⁿberschreitet die in dem HTML Formular
  36774.         mittels der Anweisung <SPAN
  36775. CLASS="emphasis"
  36776. ><I
  36777. CLASS="emphasis"
  36778. >MAX_FILE_SIZE</I
  36779. ></SPAN
  36780. > angegebene
  36781.         maximale Dateigr÷▀e.
  36782.        </P
  36783. ></DD
  36784. ><DT
  36785. ><VAR
  36786. CLASS="varname"
  36787. >UPLOAD_ERR_PARTIAL</VAR
  36788. ></DT
  36789. ><DD
  36790. ><P
  36791. >         Wert: 3; Die Datei wurde nur teilweise hochgeladen.
  36792.        </P
  36793. ></DD
  36794. ><DT
  36795. ><VAR
  36796. CLASS="varname"
  36797. >UPLOAD_ERR_NO_FILE</VAR
  36798. ></DT
  36799. ><DD
  36800. ><P
  36801. >         Wert: 4; Es wurde keine Datei hochgeladen.
  36802.        </P
  36803. ></DD
  36804. ></DL
  36805. ></DIV
  36806. >
  36807.    </P
  36808. ><DIV
  36809. CLASS="note"
  36810. ><BLOCKQUOTE
  36811. CLASS="note"
  36812. ><P
  36813. ><B
  36814. >Anmerkung: </B
  36815. >
  36816.      Dies wurden Konstanten in PHP 4.3.0.
  36817.     </P
  36818. ></BLOCKQUOTE
  36819. ></DIV
  36820. ></DIV
  36821. ><DIV
  36822. CLASS="sect1"
  36823. ><HR><H2
  36824. CLASS="sect1"
  36825. ><A
  36826. NAME="features.file-upload.common-pitfalls"
  36827. >HΣufige Probleme</A
  36828. ></H2
  36829. ><P
  36830. >     Der mit <VAR
  36831. CLASS="literal"
  36832. >MAX_FILE_SIZE</VAR
  36833. > eingestellte Wert
  36834.     kann nicht gr÷▀er sein als der des ini-Parameters <A
  36835. HREF="#ini.upload-max-filesize"
  36836. >upload_max_filesize</A
  36837. >.
  36838.     Der Standardwert ist 2 Megabyte.
  36839.    </P
  36840. ><P
  36841. >     Ist <VAR
  36842. CLASS="literal"
  36843. >memory limit</VAR
  36844. > aktiviert, k÷nnte eine Erh÷hung
  36845.     von <A
  36846. HREF="#ini.memory-limit"
  36847. >memory_limit</A
  36848. > n÷tig sein.
  36849.     Stellen Sie sicher, dass der Wert von <A
  36850. HREF="#ini.memory-limit"
  36851. >memory_limit</A
  36852. > gro▀ genug ist.
  36853.    </P
  36854. ><P
  36855. >     Wenn <A
  36856. HREF="#ini.max-execution-time"
  36857. >max_execution_time</A
  36858. >
  36859.     zu kurz konfiguriert ist, k÷nnte das Skript den Wert ⁿberschritten
  36860.     haben. Stellen Sie sicher, dass der Wert von
  36861.     <VAR
  36862. CLASS="literal"
  36863. >max_execution_time</VAR
  36864. > gro▀ genug ist.
  36865.    </P
  36866. ><P
  36867. >     Ist <A
  36868. HREF="#ini.post-max-size"
  36869. >post_max_size</A
  36870. > zu klein
  36871.     konfiguriert, k÷nnen gro▀e Dateien nicht hochgeladen werden. Stellen
  36872.     Sie sicher, dass der Wert von <VAR
  36873. CLASS="literal"
  36874. >post_max_size</VAR
  36875. > gro▀
  36876.     genug ist.
  36877.    </P
  36878. ><P
  36879. >     Nicht zu prⁿfen an welcher Datei Sie arbeiten kann bedeuten, dass
  36880.     Benutzer auf sensible Informationen in anderen Verzeichnissen Zugriff
  36881.     erhalten.
  36882.    </P
  36883. ><P
  36884. >     Beachten Sie, dass CERN httpd in dem vom Client erhaltenen
  36885.     Content-Type Mime Header alles nach dem ersten Whitespace
  36886.     wegzuschneiden scheint. Solange dies der Fall ist, unterstⁿtzt
  36887.     CERN httpd keine Dateiuploads.
  36888.    </P
  36889. ><P
  36890. >     Aufgrund der vielen m÷glichen Arten der Darstellung von Verzeichnissen
  36891.     k÷nnen wir nicht garantieren, dass Dateien mit exotischen Namen (wie z.B.
  36892.     mit enthaltenen Leerzeichen) auch wirklich richtig verarbeitet werden.
  36893.    </P
  36894. ></DIV
  36895. ><DIV
  36896. CLASS="sect1"
  36897. ><HR><H2
  36898. CLASS="sect1"
  36899. ><A
  36900. NAME="features.file-upload.multiple"
  36901. >Upload mehrerer Dateien</A
  36902. ></H2
  36903. ><P
  36904. >     Mehrere Dateien k÷nnen hochgeladen werden, indem Sie verschiedene
  36905.     Namen <VAR
  36906. CLASS="literal"
  36907. >name</VAR
  36908. > fⁿr <VAR
  36909. CLASS="literal"
  36910. >input</VAR
  36911. > verwenden.
  36912.    </P
  36913. ><P
  36914. >     Es ist ebenfalls m÷glich, mehrere Dateien simultan hochzuladen, und
  36915.     die Informationen automatisch in Arrays zu erhalten. Um dies zu tun,
  36916.     verwenden Sie in dem HTML Formular die gleiche Array-Sende-Syntax
  36917.     wie bei Auswahllisten mit Mehrfachauswahl und Checkboxen:
  36918.    </P
  36919. ><DIV
  36920. CLASS="note"
  36921. ><BLOCKQUOTE
  36922. CLASS="note"
  36923. ><P
  36924. ><B
  36925. >Anmerkung: </B
  36926. >
  36927.      Die Unterstⁿtzung fⁿr den Upload von mehreren Dateien wurde in
  36928.      PHP 3.0.10 hinzugefⁿgt.
  36929.     </P
  36930. ></BLOCKQUOTE
  36931. ></DIV
  36932. ><P
  36933. >     <TABLE
  36934. WIDTH="100%"
  36935. BORDER="0"
  36936. CELLPADDING="0"
  36937. CELLSPACING="0"
  36938. CLASS="EXAMPLE"
  36939. ><TR
  36940. ><TD
  36941. ><DIV
  36942. CLASS="example"
  36943. ><A
  36944. NAME="AEN6130"
  36945. ></A
  36946. ><P
  36947. ><B
  36948. >Beispiel 34-3. Upload mehrerer Dateien</B
  36949. ></P
  36950. ><TABLE
  36951. BORDER="0"
  36952. BGCOLOR="#E0E0E0"
  36953. CELLPADDING="5"
  36954. ><TR
  36955. ><TD
  36956. ><PRE
  36957. CLASS="html"
  36958. ><form action="file-upload.php" method="post" enctype="multipart/form-data">
  36959.   Send these files:<br>
  36960.   <input name="userfile[]" type="file"><br>
  36961.   <input name="userfile[]" type="file"><br>
  36962.   <input type="submit" value="Send files">
  36963. </form></PRE
  36964. ></TD
  36965. ></TR
  36966. ></TABLE
  36967. ></DIV
  36968. ></TD
  36969. ></TR
  36970. ></TABLE
  36971. >
  36972.    </P
  36973. ><P
  36974. >     Wenn das obige Formular ⁿbermittelt ist, werden die Arrays
  36975.     <VAR
  36976. CLASS="varname"
  36977. >$_FILES['userfile']</VAR
  36978. >,
  36979.     <VAR
  36980. CLASS="varname"
  36981. >$_FILES['userfile']['name']</VAR
  36982. > und
  36983.     <VAR
  36984. CLASS="varname"
  36985. >$_FILES['userfile']['size']</VAR
  36986. >
  36987.     initialisiert (wie auch in $HTTP_POST_FILES vor PHP Version 4.1.0.).
  36988.     Ist <VAR
  36989. CLASS="literal"
  36990. >register_globals</VAR
  36991. > aktiviert, werden auch
  36992.     globale Variablen fⁿr die hochgeladenen Dateien initialisiert.
  36993.     Jedes von ihnen ist ein numerisch indiziertes Array mit den
  36994.     entsprechenden Werten fⁿr die hochgeladenen Dateien.
  36995.    </P
  36996. ><P
  36997. >     Nehmen wir zum Beispiel an, dass die Dateinamen
  36998.     <TT
  36999. CLASS="filename"
  37000. >/home/test/review.html</TT
  37001. > und
  37002.     <TT
  37003. CLASS="filename"
  37004. >/home/test/xwp.out</TT
  37005. > ⁿbermittelt wurden.
  37006.     In diesem Fall wⁿrde
  37007.     <VAR
  37008. CLASS="varname"
  37009. >$_FILES['userfile']['name'][0]</VAR
  37010. >
  37011.     <TT
  37012. CLASS="filename"
  37013. >review.html</TT
  37014. > enthalten, und
  37015.     <VAR
  37016. CLASS="varname"
  37017. >$_FILES['userfile']['name'][1]</VAR
  37018. >
  37019.     hΣtte den Wert <TT
  37020. CLASS="filename"
  37021. >xwp.out</TT
  37022. >. Genauso wⁿrde
  37023.     <VAR
  37024. CLASS="varname"
  37025. >$_FILES['userfile']['size'][0]</VAR
  37026. > die
  37027.     Dateigr÷▀e von <TT
  37028. CLASS="filename"
  37029. >review.html</TT
  37030. > enthalten, usw.
  37031.    </P
  37032. ><P
  37033. >     <VAR
  37034. CLASS="varname"
  37035. >$_FILES['userfile']['name'][0]</VAR
  37036. >,
  37037.     <VAR
  37038. CLASS="varname"
  37039. >$_FILES['userfile']['tmp_name'][0]</VAR
  37040. >,
  37041.     <VAR
  37042. CLASS="varname"
  37043. >$_FILES['userfile']['size'][0]</VAR
  37044. > und
  37045.     <VAR
  37046. CLASS="varname"
  37047. >$_FILES['userfile']['type'][0]</VAR
  37048. > sind
  37049.     ebenfalls gesetzt.
  37050.    </P
  37051. ></DIV
  37052. ><DIV
  37053. CLASS="sect1"
  37054. ><HR><H2
  37055. CLASS="sect1"
  37056. ><A
  37057. NAME="features.file-upload.put-method"
  37058. >PUT-Unterstⁿtzung</A
  37059. ></H2
  37060. ><P
  37061. >     Die Unterstⁿtzung der PUT-Methode hat sich zwischen PHP 3 und
  37062.     PHP 4 geΣndert. In PHP 4 sollten Sie den standard Input-Datenstrom
  37063.     benutzen, um die Inhalte eines HTTP PUT zu lesen.
  37064.    </P
  37065. ><P
  37066. >     <TABLE
  37067. WIDTH="100%"
  37068. BORDER="0"
  37069. CELLPADDING="0"
  37070. CELLSPACING="0"
  37071. CLASS="EXAMPLE"
  37072. ><TR
  37073. ><TD
  37074. ><DIV
  37075. CLASS="example"
  37076. ><A
  37077. NAME="AEN6156"
  37078. ></A
  37079. ><P
  37080. ><B
  37081. >Beispiel 34-4. Speicher von HTTP PUT Dateien mit PHP 4</B
  37082. ></P
  37083. ><TABLE
  37084. BORDER="0"
  37085. BGCOLOR="#E0E0E0"
  37086. CELLPADDING="5"
  37087. ><TR
  37088. ><TD
  37089. ><PRE
  37090. CLASS="php"
  37091. ><?php
  37092. /* PUT Daten kommen in den stdin Stream */
  37093. $putdata = fopen("php://stdin","r");
  37094.  
  37095. /* Eine Datei zum Schreiben ÷ffnen */
  37096. $fp = fopen("myputfile.ext","w");
  37097.  
  37098. /* Jeweils 1kB Daten lesen und
  37099.    in die Datei schreiben */
  37100. while ($data = fread($putdata,1024))
  37101.   fwrite($fp,$data);
  37102.  
  37103. /* Die Streams schlie▀en */
  37104. fclose($fp);
  37105. fclose($putdata);
  37106. ?></PRE
  37107. ></TD
  37108. ></TR
  37109. ></TABLE
  37110. ></DIV
  37111. ></TD
  37112. ></TR
  37113. ></TABLE
  37114. >
  37115.    </P
  37116. ><DIV
  37117. CLASS="note"
  37118. ><BLOCKQUOTE
  37119. CLASS="note"
  37120. ><P
  37121. ><B
  37122. >Anmerkung: </B
  37123. >
  37124.      SΣmtliche untenstehende Dokumentation betrifft nur PHP 3.
  37125.     </P
  37126. ></BLOCKQUOTE
  37127. ></DIV
  37128. ><P
  37129. >     PHP unterstⁿtzt die HTTP PUT-Methode, wie sie von Clients wie Netscape
  37130.     Composer oder W3C Amaya benutzt wird. PUT-Anfragen sind weitaus
  37131.     unkomplizierter als ein Dateiupload und sehen etwa so aus:
  37132.     <DIV
  37133. CLASS="informalexample"
  37134. ><P
  37135. ></P
  37136. ><A
  37137. NAME="AEN6162"
  37138. ></A
  37139. ><TABLE
  37140. BORDER="0"
  37141. BGCOLOR="#E0E0E0"
  37142. CELLPADDING="5"
  37143. ><TR
  37144. ><TD
  37145. ><PRE
  37146. CLASS="programlisting"
  37147. >PUT /path/filename.html HTTP/1.1</PRE
  37148. ></TD
  37149. ></TR
  37150. ></TABLE
  37151. ><P
  37152. ></P
  37153. ></DIV
  37154. >
  37155.    </P
  37156. ><P
  37157. >     Das wⁿrde normalerweise bedeuten, dass der entfernte Client den
  37158.     folgenden Inhalt als /path/filename.html im Webverzeichnisbaum
  37159.     speichert. Natⁿrlich ist es keine gute Idee, dass PHP oder
  37160.     Apache jeden Benutzer beliebige Dateien ⁿberschreiben lassen.
  37161.     Um eine solche Anfrage bearbeiten zu k÷nnen, muss der Webserver
  37162.     erst angewiesen werden, ein bestimmtes PHP-Skript fⁿr die
  37163.     Abarbeitung aufzurufen. Im Apache wird dies durch die
  37164.     <SPAN
  37165. CLASS="emphasis"
  37166. ><I
  37167. CLASS="emphasis"
  37168. >Script</I
  37169. ></SPAN
  37170. > - Direktive festgelegt. Sie kann fast
  37171.     ⁿberall in der Apache-Konfigurationsdatei platziert werden,
  37172.     gebrΣuchlich ist die Platzierung innerhalb einer <Directory>- oder
  37173.     <Virtualhost>- Sektion. Eine Zeile wie die folgende erledigt dies:
  37174.     <DIV
  37175. CLASS="informalexample"
  37176. ><P
  37177. ></P
  37178. ><A
  37179. NAME="AEN6166"
  37180. ></A
  37181. ><TABLE
  37182. BORDER="0"
  37183. BGCOLOR="#E0E0E0"
  37184. CELLPADDING="5"
  37185. ><TR
  37186. ><TD
  37187. ><PRE
  37188. CLASS="programlisting"
  37189. >Script PUT /put.php</PRE
  37190. ></TD
  37191. ></TR
  37192. ></TABLE
  37193. ><P
  37194. ></P
  37195. ></DIV
  37196. >
  37197.    </P
  37198. ><P
  37199. >     Diese Zeile legt fest, dass Apache alle PUT-Anfragen fⁿr URIs, die
  37200.     dem Kontext entsprechen, in dem diese Zeile steht, an das put.php
  37201.     Skript weiterleitet. Dies setzt natⁿrlich voraus, dass PHP aktiv
  37202.     und fⁿr die .php-Dateierweiterung registriert ist.
  37203.    </P
  37204. ><P
  37205. >     Innerhalb der put.php-Datei k÷nnte folgendes stehen:
  37206.    </P
  37207. ><P
  37208. >     <DIV
  37209. CLASS="informalexample"
  37210. ><P
  37211. ></P
  37212. ><A
  37213. NAME="AEN6171"
  37214. ></A
  37215. ><TABLE
  37216. BORDER="0"
  37217. BGCOLOR="#E0E0E0"
  37218. CELLPADDING="5"
  37219. ><TR
  37220. ><TD
  37221. ><PRE
  37222. CLASS="php"
  37223. ><?php copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); ?></PRE
  37224. ></TD
  37225. ></TR
  37226. ></TABLE
  37227. ><P
  37228. ></P
  37229. ></DIV
  37230. >
  37231.    </P
  37232. ><P
  37233. >     Dies kopiert die Datei an den vom Client angegebenen Ort.
  37234.     M÷glicherweise sollen vor dem Kopieren der Datei noch
  37235.     ▄berprⁿfungen und/oder Benutzerauthentifizierung stattfinden.
  37236.     Wenn PHP eine PUT-Anfrage erhΣlt, wird die Datei genau wie bei der
  37237.     <A
  37238. HREF="#features.file-upload.post-method"
  37239. >POST-Methode</A
  37240. >
  37241.     in einem temporΣren Verzeichnis gespeichert. Nach dem Abarbeiten
  37242.     der Anfrage wird die temporΣre Datei gel÷scht. Also muss das
  37243.     PHP-Skript, das die PUT-Anfrage bearbeitet, die Datei irgendwohin
  37244.     kopieren. Der Name der temporΣren Datei findet sich in der
  37245.     Variablen $PHP_PUT_FILENAME; der Name der zu speichernden
  37246.     Datei steht in $REQUEST_URI (kann bei Nicht-Apache Webservern
  37247.     variieren). Dieser Zieldateiname wird vom Client festgelegt. Man
  37248.     kann den Client auch umgehen; beispielsweise k÷nnten alle
  37249.     hochgeladenen Dateien in ein spezielles Upload-Directory kopiert
  37250.     werden.
  37251.    </P
  37252. ></DIV
  37253. ></DIV
  37254. ><DIV
  37255. CLASS="chapter"
  37256. ><HR><H1
  37257. ><A
  37258. NAME="features.remote-files"
  37259. >Kapitel 35. Zugriff auf entfernte Dateien</A
  37260. ></H1
  37261. ><P
  37262. >    Wenn die Unterstⁿtzung fⁿr den "URL fopen wrapper" bei der
  37263.    Konfiguration von PHP vorhanden ist (welche standardmΣ▀ig eingestellt ist, es sei denn,
  37264.    die Option <VAR
  37265. CLASS="option"
  37266. >--disable-url-fopen-wrapper</VAR
  37267. > wurde bei der Installation verwendet (Versionen 
  37268.    bis 4.0.3) oder der Parameter <VAR
  37269. CLASS="parameter"
  37270. >allow_url_fopen</VAR
  37271. > in der php.ini 
  37272.    deaktiviert wurde (neuere Versionen),
  37273.    k÷nnen HTTP und FTP URLs bei den meisten Funktionen verwendet werden, die einen
  37274.    Dateinamen als Parameter ben÷tigen, inklusive <A
  37275. HREF="#function.require"
  37276. ><B
  37277. CLASS="function"
  37278. >require()</B
  37279. ></A
  37280. >
  37281.    und <A
  37282. HREF="#function.include"
  37283. ><B
  37284. CLASS="function"
  37285. >include()</B
  37286. ></A
  37287. > Anweisungen.
  37288.   </P
  37289. ><P
  37290. >    <DIV
  37291. CLASS="note"
  37292. ><BLOCKQUOTE
  37293. CLASS="note"
  37294. ><P
  37295. ><B
  37296. >Anmerkung: </B
  37297. >
  37298.      remote files funktionieren nicht mit <A
  37299. HREF="#function.include"
  37300. ><B
  37301. CLASS="function"
  37302. >include()</B
  37303. ></A
  37304. > und
  37305.      <A
  37306. HREF="#function.require"
  37307. ><B
  37308. CLASS="function"
  37309. >require()</B
  37310. ></A
  37311. > Anweisungen unter Windows.
  37312.     </P
  37313. ></BLOCKQUOTE
  37314. ></DIV
  37315. >
  37316.   </P
  37317. ><P
  37318. >    Beispielsweise kann eine Datei auf einem anderen Webserver ge÷ffnet und verarbeitet werden. 
  37319.    Diese Daten k÷nnen zur Abfrage einer Datenbank benutzt werden oder passend zum Rest der eigenen 
  37320.    Website ausgegeben werden.
  37321.   </P
  37322. ><P
  37323. >    <TABLE
  37324. WIDTH="100%"
  37325. BORDER="0"
  37326. CELLPADDING="0"
  37327. CELLSPACING="0"
  37328. CLASS="EXAMPLE"
  37329. ><TR
  37330. ><TD
  37331. ><DIV
  37332. CLASS="example"
  37333. ><A
  37334. NAME="AEN6189"
  37335. ></A
  37336. ><P
  37337. ><B
  37338. >Beispiel 35-1. Den Titel einer entfernten Seite auslesen</B
  37339. ></P
  37340. ><TABLE
  37341. BORDER="0"
  37342. BGCOLOR="#E0E0E0"
  37343. CELLPADDING="5"
  37344. ><TR
  37345. ><TD
  37346. ><PRE
  37347. CLASS="php"
  37348. ><?php
  37349. $file = fopen ("http://www.example.com/", "r");
  37350. if (!$file) {
  37351.     echo "<p>Datei konnte nicht ge÷ffnet werden.\n";
  37352.     exit;
  37353. }
  37354. while (!feof ($file)) {
  37355.     $line = fgets ($file, 1024);
  37356.     /* Funktioniert nur, wenn Titel und title-Tags in einer Zeile stehen */
  37357.     if (eregi ("<title>(.*)</title>", $line, $out)) {
  37358.         $title = $out[1];
  37359.         break;
  37360.     }
  37361. }
  37362. fclose($file);
  37363. ?></PRE
  37364. ></TD
  37365. ></TR
  37366. ></TABLE
  37367. ></DIV
  37368. ></TD
  37369. ></TR
  37370. ></TABLE
  37371. >
  37372.   </P
  37373. ><P
  37374. >    Auch eine Datei auf einem FTP-Server kann geschrieben werden, solange man sich ⁿber 
  37375.    einen Benutzer mit entsprechenden Zugriffsrechten verbindet und die Datei noch nicht existiert.
  37376.    Um sich mit einem anderen Benutzer als 'anonymous' zu verbinden mu▀ ein
  37377.    username (und m÷glichst ein Passwort) innerhalb der URL angegeben werden, wie z.B.
  37378.    'ftp://user:password@ftp.example.com/pfad/zur/datei'. (Die selbe Syntax 
  37379.    kann verwendet werden, um auf Daten via HTTP zuzugreifen, wenn diese eine Basic
  37380.    Authentication ben÷tigen.)
  37381.   </P
  37382. ><P
  37383. >    <TABLE
  37384. WIDTH="100%"
  37385. BORDER="0"
  37386. CELLPADDING="0"
  37387. CELLSPACING="0"
  37388. CLASS="EXAMPLE"
  37389. ><TR
  37390. ><TD
  37391. ><DIV
  37392. CLASS="example"
  37393. ><A
  37394. NAME="AEN6194"
  37395. ></A
  37396. ><P
  37397. ><B
  37398. >Beispiel 35-2. Daten auf einen entfernten Server speichern</B
  37399. ></P
  37400. ><TABLE
  37401. BORDER="0"
  37402. BGCOLOR="#E0E0E0"
  37403. CELLPADDING="5"
  37404. ><TR
  37405. ><TD
  37406. ><PRE
  37407. CLASS="php"
  37408. ><?php
  37409. $file = fopen ("ftp://ftp.example.com/incoming/outputfile", "w");
  37410. if (!$file) {
  37411.     echo "<p>Datei konnte zum schreiben nicht ge÷ffnet werden.\n";
  37412.     exit;
  37413. }
  37414. /* Schreibe die Daten hier hin. */
  37415. fputs ($file, "$HTTP_USER_AGENT\n");
  37416. fclose ($file);
  37417. ?></PRE
  37418. ></TD
  37419. ></TR
  37420. ></TABLE
  37421. ></DIV
  37422. ></TD
  37423. ></TR
  37424. ></TABLE
  37425. >
  37426.   </P
  37427. ><P
  37428. >    <DIV
  37429. CLASS="note"
  37430. ><BLOCKQUOTE
  37431. CLASS="note"
  37432. ><P
  37433. ><B
  37434. >Anmerkung: </B
  37435. >
  37436.      Obiges Beispiel k÷nnte dazu verleiten, dieses Verfahren zu benutzen, um in ein 'remote log-file' 
  37437.      zu schreiben. Wie oben erwΣhnt kann man jedoch ausschlie▀lich neue Dateien anlegen, 
  37438.      wenn man URL fopen() wrapper benutzt. Fⁿr 'distributed logging' sollte man sich die Funktion 
  37439.      <A
  37440. HREF="#function.syslog"
  37441. ><B
  37442. CLASS="function"
  37443. >syslog()</B
  37444. ></A
  37445. > anschauen.
  37446.     </P
  37447. ></BLOCKQUOTE
  37448. ></DIV
  37449. >
  37450.   </P
  37451. ></DIV
  37452. ><DIV
  37453. CLASS="chapter"
  37454. ><HR><H1
  37455. ><A
  37456. NAME="features.connection-handling"
  37457. >Kapitel 36. Verbindungssteuerung</A
  37458. ></H1
  37459. ><DIV
  37460. CLASS="note"
  37461. ><BLOCKQUOTE
  37462. CLASS="note"
  37463. ><P
  37464. ><B
  37465. >Anmerkung: </B
  37466. >Folgendes trifft auf die Versionen 3.0.7 und spΣter zu.</P
  37467. ></BLOCKQUOTE
  37468. ></DIV
  37469. ><P
  37470. >    PHP erhΣlt intern einen Verbindungsstatus. Dieser kann drei
  37471.    ZustΣnde annehmen:
  37472.    <P
  37473. ></P
  37474. ><UL
  37475. ><LI
  37476. ><P
  37477. >0 - NORMAL</P
  37478. ></LI
  37479. ><LI
  37480. ><P
  37481. >1 - ABORTED</P
  37482. ></LI
  37483. ><LI
  37484. ><P
  37485. >2 - TIMEOUT</P
  37486. ></LI
  37487. ></UL
  37488. >
  37489.   </P
  37490. ><P
  37491. >    Wenn ein PHP-Skript aktiv ist, ist der Status ⁿblicherweise   
  37492.    NORMAL. Sollte der Client-Rechner die Verbindung beenden, wird
  37493.    der Status auf ABORTED gesetzt. Ein clientseitiges Beenden der
  37494.    Verbindung wird fⁿr gew÷hnlich veranla▀t, wenn der Benutzer den
  37495.    STOP-Button seines Browsers drⁿckt. Wenn das eingestellte Zeitlimit
  37496.    (siehe <A
  37497. HREF="#function.set-time-limit"
  37498. ><B
  37499. CLASS="function"
  37500. >set_time_limit()</B
  37501. ></A
  37502. >) ⁿberschritten wird,
  37503.    wird der Status TIMEOUT gesetzt.</P
  37504. ><P
  37505. >    Sie k÷nnen entscheiden, ob der Verbindungsabbruch seitens des Clients
  37506.    den Abbruch des Skriptes zur Folge haben soll.
  37507.    Manchmal ist es sinnvoll, Skripte sauber zu beenden, auch wenn
  37508.    kein Browser mehr zur Verfⁿgung steht, der die Ausgabe empfΣngt.
  37509.    Die Abarbeitung eines Skriptes wird standardmΣ▀ig abgebrochen, wenn
  37510.    der Client die Verbindung beendet.
  37511.    Dieses Verhalten kann sowohl durch die Option ignore_user_abort in
  37512.    der Konfigurationsdatei php3.ini, durch die entsprechende
  37513.    Option php3_ignore_user_abort in der Apache-Konfigurationsdatei
  37514.    als auch durch <A
  37515. HREF="#function.ignore-user-abort"
  37516. ><B
  37517. CLASS="function"
  37518. >ignore_user_abort()</B
  37519. ></A
  37520. > beeinflu▀t
  37521.    werden.
  37522.    Wenn PHP nicht angewiesen wird, einen Verbindungsabbruch durch den
  37523.    Benutzer zu ignorieren und die Verbindung dann durch den Benutzer
  37524.    beendet wird, wird die Abarbeitung des Scriptes abgebrochen. Die einzige
  37525.    Ausnahme ist, wenn durch die Funktion 
  37526.    <A
  37527. HREF="#function.register-shutdown-function"
  37528. ><B
  37529. CLASS="function"
  37530. >register_shutdown_function()</B
  37531. ></A
  37532. > eine Shutdown-Funktion
  37533.    angegeben wird, die bei clientseitigem Abbruch ausgefⁿhrt wird. 
  37534.    Wenn dann der Benutzer den STOP-Button seines Browsers drⁿckt, wird
  37535.    PHP bei der nΣchsten Ausgabe des Skriptes feststellen, dass die
  37536.    Verbindung abgebrochen wurde und die Shutdown-Funktion aufrufen.
  37537.    Diese Shutdown-Funktion wird auch aufgerufen, wenn das Skript auf 
  37538.    normalem Wege beendet wird, daher sollte man, wenn man fⁿr den
  37539.    Fall eines Benutzerabbruchs etwas anderes vorgesehen hat,
  37540.    die Funktion <A
  37541. HREF="#function.connection-aborted"
  37542. ><B
  37543. CLASS="function"
  37544. >connection_aborted()</B
  37545. ></A
  37546. > verwenden.
  37547.    Sie gibt <TT
  37548. CLASS="constant"
  37549. ><B
  37550. >TRUE</B
  37551. ></TT
  37552. > zurⁿck, wenn die Verbindung abgebrochen wurde.</P
  37553. ><P
  37554. >    Ein Skript kann ebenfalls durch den eingebauten Script-Timer
  37555.    beendet werden. Der Standard-Timeout betrΣgt 30 Sekunden. Er kann
  37556.    durch die Option max_execution_time in der php3.ini, durch
  37557.    den entsprechenden Eintrag php3_max_execution_time in der
  37558.    Apache-Konfigurationsdatei oder durch die Funktion
  37559.    <A
  37560. HREF="#function.set-time-limit"
  37561. ><B
  37562. CLASS="function"
  37563. >set_time_limit()</B
  37564. ></A
  37565. > beeinflu▀t werden. Bei
  37566.    Zeitⁿberschreitung wird das Skript beendet und, genau wie im obigen
  37567.    Fall des Verbindungsabbruchs, eine registrierte Shutdown-Funktion
  37568.    ausgefⁿhrt. Um zu ⁿberprⁿfen, ob es sich um einen Abbruch aufgrund
  37569.    von Zeitⁿberschreitung handelt, kann die Funktion
  37570.    <A
  37571. HREF="#function.connection-timeout"
  37572. ><B
  37573. CLASS="function"
  37574. >connection_timeout()</B
  37575. ></A
  37576. > benutzt werden. Sie gibt
  37577.    <TT
  37578. CLASS="constant"
  37579. ><B
  37580. >TRUE</B
  37581. ></TT
  37582. > zurⁿck, wenn es sich um eine Zeitⁿberschreitung handelt.</P
  37583. ><P
  37584. >    Zu bemerken ist, dass der ABORTED und der TIMEOUT-Status gleichzeitig
  37585.    auftreten k÷nnen. Dies ist m÷glich, wenn PHP angewiesen wird,
  37586.    Benutzerabbrⁿche zu ignorieren. PHP wird feststellen, dass der
  37587.    Benutzer die Verbindung abgebrochen hat, das Skript allerdings
  37588.    lΣuft weiter. Sollte es dann das Zeitlimit erreichen, wird es
  37589.    abgebrochen und eine Shutdown-Funktion, wenn definiert, wird
  37590.    aufgerufen. Zu diesem Zeitpunkt kann man feststellen, dass
  37591.    <A
  37592. HREF="#function.connection-timeout"
  37593. ><B
  37594. CLASS="function"
  37595. >connection_timeout()</B
  37596. ></A
  37597. >
  37598.    und <A
  37599. HREF="#function.connection-aborted"
  37600. ><B
  37601. CLASS="function"
  37602. >connection_aborted()</B
  37603. ></A
  37604. > <TT
  37605. CLASS="constant"
  37606. ><B
  37607. >TRUE</B
  37608. ></TT
  37609. > zurⁿckgeben.
  37610.    Diese beiden Statusm÷glichkeiten k÷nnen auch durch einen Aufruf
  37611.    der Funktion <A
  37612. HREF="#function.connection-status"
  37613. ><B
  37614. CLASS="function"
  37615. >connection_status()</B
  37616. ></A
  37617. > abgefragt
  37618.    werden. Sie liefert ein Bitfeld des aktiven Status. Wenn
  37619.    beispielsweise TIMEOUT und ABORTED aktiv sind, wird 3 zurⁿckgegeben.
  37620.    </P
  37621. ></DIV
  37622. ><DIV
  37623. CLASS="chapter"
  37624. ><HR><H1
  37625. ><A
  37626. NAME="features.persistent-connections"
  37627. >Kapitel 37. Persistente Datenbankverbindungen</A
  37628. ></H1
  37629. ><P
  37630. >    Persistente Verbindungen sind SQL-Verbindungen, die nach
  37631.    Abarbeitung des Skriptes nicht geschlossen werden. Wenn eine
  37632.    persistente Verbindung angefordert wird, prⁿft PHP zuerst, ob
  37633.    bereits eine identische persistente Verbindung (die vielleicht
  37634.    vorher offen geblieben ist) existiert und benutzt sie in diesem Fall.
  37635.    Sollte keine Verbindung existieren, wird eine hergestellt. Eine
  37636.    'identische' Verbindung ist eine Verbindung, die zu dem
  37637.    gleichen Host mit dem gleichen Usernamen und Passwort
  37638.    hergestellt wurde.</P
  37639. ><DIV
  37640. CLASS="note"
  37641. ><BLOCKQUOTE
  37642. CLASS="note"
  37643. ><P
  37644. ><B
  37645. >Anmerkung: </B
  37646. >
  37647.     Auch andere Erweiterungen bieten persistente Verbindungen, wie z.B.
  37648.     <A
  37649. HREF="#ref.imap"
  37650. >IMAP extension</A
  37651. >.
  37652.    </P
  37653. ></BLOCKQUOTE
  37654. ></DIV
  37655. ><P
  37656. >    Wer nicht durchgΣngig mit der Art und Weise vertraut ist, wie
  37657.    Webserver arbeiten und die Last verteilen, k÷nnte missverstehen,
  37658.    wofⁿr persistente Verbindungen gedacht sind. Im Besonderen bieten
  37659.    sie <SPAN
  37660. CLASS="emphasis"
  37661. ><I
  37662. CLASS="emphasis"
  37663. >keine</I
  37664. ></SPAN
  37665. > M÷glichkeit, 'Benutzersitzungen'
  37666.    ⁿber die gleiche SQL-Verbindung zu ÷ffnen und
  37667.    <SPAN
  37668. CLASS="emphasis"
  37669. ><I
  37670. CLASS="emphasis"
  37671. >keine</I
  37672. ></SPAN
  37673. > M÷glichkeit, eine Transaktion effizient
  37674.    aufzubauen, und sie k÷nnen auch viele andere Dinge nicht. Um
  37675.    absolute Klarheit zu schaffen: Persistente Verbindungen bieten
  37676.    <SPAN
  37677. CLASS="emphasis"
  37678. ><I
  37679. CLASS="emphasis"
  37680. >keine</I
  37681. ></SPAN
  37682. > FunktionalitΣt, die nicht auch von
  37683.    nicht-persistenten Verbindungen bereitgestellt wird.
  37684.   </P
  37685. ><P
  37686. >    Warum?
  37687.   </P
  37688. ><P
  37689. >    Das hat mit der Arbeitsweise von Webservern zu tun. Es gibt drei
  37690.    M÷glichkeiten, wie ein Webserver PHP zur Generierung von
  37691.    Webseiten einsetzen kann.
  37692.   </P
  37693. ><P
  37694. >    Die erste Methode ist, PHP als CGI-'Wrapper' zu benutzen. 
  37695.    Wenn diese Methode eingesetzt wird, wird fⁿr jede Anfrage 
  37696.    nach einer PHP-Seite vom Webserver eine Instanz des PHP-
  37697.    Interpreters gestartet und anschlie▀end wieder beendet. 
  37698.    Durch die Beendigung des Interpreters nach abgeschlossener
  37699.    Anfrage werden alle Ressourcen, auf die zugegriffen wurde 
  37700.    (wie beispielsweise eine Verbindung zu einem SQL-
  37701.    Datenbankserver) wieder geschlossen. In diesem Fall erreicht
  37702.    man nichts, wenn man persistente Verbindungen benutzt - sie
  37703.    sind eben nicht bestΣndig.
  37704.   </P
  37705. ><P
  37706. >    Die zweite und populΣrste Methode ist der Einsatz von PHP als
  37707.    Modul in einem Multiprozess-Webserver, was momentan nur auf den
  37708.    Apache zutrifft. Typischerweise hat ein Multiprozess-Webserver
  37709.    einen Prozess (den 'Eltern' Prozess), der einen Satz weiterer
  37710.    Prozesse (die 'Kinder') koordiniert, welche die eigentliche Arbeit
  37711.    des Bereitstellens der Seiten ⁿbernehmen. Jede Anfrage, die von
  37712.    einem Client erfolgt, wird an einen untergeordneten Prozess, der
  37713.    noch keine andere Anfrage bearbeitet, weitergereicht. Das bedeutet,
  37714.    dass eine zweite Anfrage des gleichen Clients an den Server unter
  37715.    UmstΣnden von einem anderen untergeordneten Prozess als die
  37716.    erste Anfrage bearbeitet wird. In diesem Fall sorgt eine persistente
  37717.    Verbindung dafⁿr, dass jeder untergeordnete Prozess sich nur 
  37718.    einmal mit dem SQL-Server verbinden muss, wenn eine solche
  37719.    ben÷tigt wird. Ben÷tigt dann eine weitere Seite die Verbindung mit 
  37720.    dem SQL-Server, kann auf die zurⁿckgegriffen werden,
  37721.    die der untergeordnete Prozess vorher hergestellt hat.
  37722.   </P
  37723. ><P
  37724. >    Die letzte Methode ist, PHP als Plug-in fⁿr einen Multithread-
  37725.    Webserver zu benutzen. Derzeit bietet PHP 4 Unterstⁿtzung fⁿr
  37726.    ISAPI, WSAPI und NSAPI (unter Windows), wodurch die Nutzung von
  37727.    PHP mit Multithread-Serven wie Netscape Fast Track (iPlanet),
  37728.    Microsoft Internet Information Server (IIS) und O'Reilly's WebSite
  37729.    Pro erm÷glicht wird. Das Verhalten entspricht im wesentlichen dem
  37730.    oben beschriebenen Multiprozess-Modell. Beachten Sie, dass PHP 3
  37731.    keine Unterstⁿtzung fⁿr SAPI bietet.
  37732.   </P
  37733. ><P
  37734. >    Wozu dienen persistente Verbindungen, wenn sie keine 
  37735.    zusΣtzliche FunktionalitΣt bieten?
  37736.   </P
  37737. ><P
  37738. >    Die Antwort ist au▀erordentlich einfach: Effizienz. Persistente
  37739.    Verbindungen sind nⁿtzlich, wenn der Aufwand fⁿr das Herstellen
  37740.    einer Verbindung zu einem SQL-Server hoch ist. Ob dies der Fall ist
  37741.    oder nicht, hΣngt von vielen Faktoren ab - zum Beispiel, um welche
  37742.    Datenbank es sich handelt, ob sie auf dem gleichen Rechner wie der
  37743.    Webserver lΣuft oder welche Last die SQL-Maschine zu bewΣltigen hat
  37744.    usw. GrundsΣtzlich gilt, dass, wenn viele Verbindungen hergestellt
  37745.    werden mⁿssen, persistente Verbindungen au▀erordentlich hilfreich
  37746.    sind. Sie veranlassen den untergeordneten Prozess, sich wΣhrend
  37747.    seiner gesamten Lebensdauer lediglich einmal mit dem SQL-Server zu
  37748.    verbinden, anstatt bei jedem Aufruf einer Seite, die eine Verbindung
  37749.    ben÷tigt. Das hei▀t, dass jeder untergeordnete Prozess, der eine
  37750.    persistente Verbindung ÷ffnet, seine eigene dauerhafte Verbindung
  37751.    zum Server hat. Bei 20 untergeordneten Prozessen, die ein Skript 
  37752.    ausfⁿhren, das eine persistente Verbindung zum SQL-Server 
  37753.    herstellt, hat man beispielsweise 20 verschiedene Verbindungen 
  37754.    zum SQL-Server - eine fⁿr jeden untergeordneten Prozess.
  37755.   </P
  37756. ><P
  37757. >    Beachten Sie jedoch, dass dies auch ein paar Nachteile haben kann,
  37758.    wenn Sie eine Datenbank mit limitierten Verbindungen benutzen, welche
  37759.    durch persistente Verbindungen ⁿberschritten werden. Wenn Ihre Datenbank
  37760.    ein Limit von 16 gleichzeitigen Verbindungen hat, und aufgrund einer
  37761.    stark ausgelasteten Server-Session 17 Kind-Prozesse versuchen, eine
  37762.    Verbindung herzustellen, wird es einem nicht gelingen. Sollten in
  37763.    Ihren Skripten Fehler bestehen, welche das Schlie▀en der Verbindungen
  37764.    nicht erlauben (wie z.B. Endlosschleifen), kann das eine Datenbank
  37765.    mit mit nur 16 Verbindungen sehr schnell ⁿberschwemmen. Konsultieren
  37766.    Sie die Dokumentation Ihrer Datenbank bezⁿglich der Behandlung von
  37767.    aufgegebenen Verbindungen oder Verbindungen im Leerlauf.
  37768.   </P
  37769. ><DIV
  37770. CLASS="warning"
  37771. ><P
  37772. ></P
  37773. ><TABLE
  37774. CLASS="warning"
  37775. BORDER="1"
  37776. WIDTH="100%"
  37777. ><TR
  37778. ><TD
  37779. ALIGN="CENTER"
  37780. ><B
  37781. >Warnung</B
  37782. ></TD
  37783. ></TR
  37784. ><TR
  37785. ><TD
  37786. ALIGN="LEFT"
  37787. ><P
  37788. >     Sie sollten sich zur Vorsicht noch ein paar Gedanken machen, wenn
  37789.     Sie persistente Verbindungen benutzen. Einer ist, wenn Sie ⁿber eine
  37790.     persistente Verbindung Tabellen sperren und das Skript diese Sperre
  37791.     aus welchem Grund auch immer nicht mehr aufheben kann, nachfolgende
  37792.     Skripte, welche die selbe Verbindung benutzen, blockieren und den
  37793.     Neustart von entweder dem Webserver oder dem Datenbankserver
  37794.     verlangen. Ein weiterer ist, dass wenn Sie Transaktionen benutzen,
  37795.     ein Transaktionsblock zu dem nΣchsten die Verbindung nutzenden Skript
  37796.     ⁿbertragen wird, wenn die Ausfⁿhrung des Skriptes vor dem
  37797.     Transaktionsblock gestoppt wird. In jedem Fall k÷nnen Sie
  37798.     <A
  37799. HREF="#function.register-shutdown-function"
  37800. ><B
  37801. CLASS="function"
  37802. >register_shutdown_function()</B
  37803. ></A
  37804. > benutzen, um eine
  37805.     einfache Funktion zu registrieren, welche Ihre Tabellen wieder
  37806.     entsperrt, oder Ihre Transaktionen zurⁿckstellt. Besser ist es, wenn
  37807.     Sie dieses Problem gΣnzlich vermeiden, indem keine persistenten
  37808.     Verbindungen in Skripten benutzen, welche Tabellen sperren oder
  37809.     Transaktionen verwenden (Sie k÷nnen sie immer noch anderswo benutzen).
  37810.    </P
  37811. ></TD
  37812. ></TR
  37813. ></TABLE
  37814. ></DIV
  37815. ><P
  37816. >    Eine wichtige Zusammenfassung. Persistente Verbindungen wurden
  37817.    entwickelt, um eins-zu-eins Abbildungen auf regulΣre Verbindungen 
  37818.    zu haben. Das hei▀t, dass man <SPAN
  37819. CLASS="emphasis"
  37820. ><I
  37821. CLASS="emphasis"
  37822. >immer</I
  37823. ></SPAN
  37824. > in der Lage
  37825.    sein sollte, die persistenten Verbindungen durch nicht-persistente
  37826.    zu ersetzten, ohne dass dies den Skriptablauf verΣndert. Es <SPAN
  37827. CLASS="emphasis"
  37828. ><I
  37829. CLASS="emphasis"
  37830. >    kann</I
  37831. ></SPAN
  37832. > (und wird vermutlich auch) die Effizienz des Skriptes
  37833.    beeinflussen, aber nicht dessen Verhalten.
  37834.   </P
  37835. ><P
  37836. >    Siehe auch <A
  37837. HREF="#function.fbsql-pconnect"
  37838. ><B
  37839. CLASS="function"
  37840. >fbsql_pconnect()</B
  37841. ></A
  37842. >,
  37843.    <A
  37844. HREF="#function.ibase-pconnect"
  37845. ><B
  37846. CLASS="function"
  37847. >ibase_pconnect()</B
  37848. ></A
  37849. >, <A
  37850. HREF="#function.ifx-pconnect"
  37851. ><B
  37852. CLASS="function"
  37853. >ifx_pconnect()</B
  37854. ></A
  37855. >,
  37856.    <B
  37857. CLASS="function"
  37858. >imap_popen()</B
  37859. >, <A
  37860. HREF="#function.ingres-pconnect"
  37861. ><B
  37862. CLASS="function"
  37863. >ingres_pconnect()</B
  37864. ></A
  37865. >,
  37866.    <A
  37867. HREF="#function.msql-pconnect"
  37868. ><B
  37869. CLASS="function"
  37870. >msql_pconnect()</B
  37871. ></A
  37872. >, <A
  37873. HREF="#function.mssql-pconnect"
  37874. ><B
  37875. CLASS="function"
  37876. >mssql_pconnect()</B
  37877. ></A
  37878. >,
  37879.    <A
  37880. HREF="#function.mysql-pconnect"
  37881. ><B
  37882. CLASS="function"
  37883. >mysql_pconnect()</B
  37884. ></A
  37885. >, <A
  37886. HREF="#function.ociplogon"
  37887. ><B
  37888. CLASS="function"
  37889. >ociplogon()</B
  37890. ></A
  37891. >,
  37892.    <A
  37893. HREF="#function.odbc-pconnect"
  37894. ><B
  37895. CLASS="function"
  37896. >odbc_pconnect()</B
  37897. ></A
  37898. >, <A
  37899. HREF="#function.ora-plogon"
  37900. ><B
  37901. CLASS="function"
  37902. >ora_plogon()</B
  37903. ></A
  37904. >,
  37905.    <A
  37906. HREF="#function.pfsockopen"
  37907. ><B
  37908. CLASS="function"
  37909. >pfsockopen()</B
  37910. ></A
  37911. >, <A
  37912. HREF="#function.pg-pconnect"
  37913. ><B
  37914. CLASS="function"
  37915. >pg_pconnect()</B
  37916. ></A
  37917. > und
  37918.    <A
  37919. HREF="#function.sybase-pconnect"
  37920. ><B
  37921. CLASS="function"
  37922. >sybase_pconnect()</B
  37923. ></A
  37924. >.
  37925.   </P
  37926. ></DIV
  37927. ><DIV
  37928. CLASS="chapter"
  37929. ><HR><H1
  37930. ><A
  37931. NAME="features.safe-mode"
  37932. >Kapitel 38. Safe Mode</A
  37933. ></H1
  37934. ><P
  37935. >     Safe Mode ist der Versuch, Sicherheitsprobleme bei gemeinsam 
  37936.     genutzten Servern zu l÷sen.
  37937.     Bezogen auf die Systemarchitektur, ist es der falsche Ansatz, 
  37938.     diese Probleme innerhalb der PHP Schicht l÷sen zu wollen. 
  37939.     Da es auf Ebene des Webservers bzw. des Betriebssystems keine
  37940.     praktischen Alternativen gibt, wird Safe Mode nunmehr von vielen
  37941.     Leuten, vor allem von Providern, eingesetzt.
  37942.    </P
  37943. ><P
  37944. >     Es existieren folgende Direktiven um Safe Mode zu konfigurieren:
  37945.     <TABLE
  37946. BORDER="0"
  37947. BGCOLOR="#E0E0E0"
  37948. CELLPADDING="5"
  37949. ><TR
  37950. ><TD
  37951. ><PRE
  37952. CLASS="ini"
  37953. >safe_mode = Off 
  37954. safe_mode_gid = 0
  37955. safe_mode_include_dir = 
  37956. safe_mode_exec_dir = 
  37957. open_basedir = 
  37958. safe_mode_allowed_env_vars = PHP_ 
  37959. safe_mode_protected_env_vars = LD_LIBRARY_PATH 
  37960. disable_functions =</PRE
  37961. ></TD
  37962. ></TR
  37963. ></TABLE
  37964. >
  37965.    </P
  37966. ><P
  37967. >     Wenn <A
  37968. HREF="#ini.safe-mode"
  37969. >safe_mode</A
  37970. > aktiviert ist, 
  37971.     ⁿberprⁿft PHP, ob der Eigentⁿmer des laufenden Skriptes dem Eigentⁿmer 
  37972.     der Datei entspricht, an der mit Hilfe der Dateifunktionen gearbeitet 
  37973.     werden soll.
  37974.     Beispiel:
  37975.     <TABLE
  37976. BORDER="0"
  37977. BGCOLOR="#E0E0E0"
  37978. CELLPADDING="5"
  37979. ><TR
  37980. ><TD
  37981. ><PRE
  37982. CLASS="ls"
  37983. >-rw-rw-r--    1 rasmus   rasmus       33 Jul  1 19:20 script.php 
  37984. -rw-r--r--    1 root     root       1116 May 26 18:01 /etc/passwd</PRE
  37985. ></TD
  37986. ></TR
  37987. ></TABLE
  37988. >
  37989.     Bei der Ausfⁿhrung dieses Skriptes
  37990.     <TABLE
  37991. BORDER="0"
  37992. BGCOLOR="#E0E0E0"
  37993. CELLPADDING="5"
  37994. ><TR
  37995. ><TD
  37996. ><PRE
  37997. CLASS="php"
  37998. ><?php
  37999.  readfile('/etc/passwd'); 
  38000. ?></PRE
  38001. ></TD
  38002. ></TR
  38003. ></TABLE
  38004. >
  38005.      erscheint bei aktiviertem Safe Mode folgende Warnung:
  38006.      <TABLE
  38007. BORDER="0"
  38008. BGCOLOR="#E0E0E0"
  38009. CELLPADDING="5"
  38010. ><TR
  38011. ><TD
  38012. ><PRE
  38013. CLASS="screen"
  38014. >Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not 
  38015. allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2</PRE
  38016. ></TD
  38017. ></TR
  38018. ></TABLE
  38019. >
  38020.    </P
  38021. ><P
  38022. >     Wenn anstelle von <A
  38023. HREF="#ini.safe-mode"
  38024. >safe_mode</A
  38025. > ein 
  38026.     <A
  38027. HREF="#ini.open-basedir"
  38028. >open_basedir</A
  38029. > 
  38030.     Verzeichnis angegeben wurde, k÷nnen Dateioperationen 
  38031.     nur noch unterhalb dieses Verzeichnisses vorgenommen werden.
  38032.     Beispiel (Apache httpd.conf):
  38033.     <TABLE
  38034. BORDER="0"
  38035. BGCOLOR="#E0E0E0"
  38036. CELLPADDING="5"
  38037. ><TR
  38038. ><TD
  38039. ><PRE
  38040. CLASS="ini"
  38041. ><Directory /docroot>
  38042. php_admin_value open_basedir /docroot 
  38043. </Directory></PRE
  38044. ></TD
  38045. ></TR
  38046. ></TABLE
  38047. >
  38048.     Wenn das Skript script.php mit der 
  38049.     <A
  38050. HREF="#ini.open-basedir"
  38051. >open_basedir</A
  38052. >
  38053.     Einstellung ausgefⁿhrt wird, erscheint folgende Warnung:
  38054.     <TABLE
  38055. BORDER="0"
  38056. BGCOLOR="#E0E0E0"
  38057. CELLPADDING="5"
  38058. ><TR
  38059. ><TD
  38060. ><PRE
  38061. CLASS="screen"
  38062. >Warning: open_basedir restriction in effect. File is in wrong directory in 
  38063. /docroot/script.php on line 2</PRE
  38064. ></TD
  38065. ></TR
  38066. ></TABLE
  38067. >
  38068.    </P
  38069. ><P
  38070. >     Darⁿberhinaus k÷nnen einzelne Funktionen deaktiviert werden.
  38071.     Wⁿrde man folgenden Eintrag in der php.ini vornehmen:
  38072.     <TABLE
  38073. BORDER="0"
  38074. BGCOLOR="#E0E0E0"
  38075. CELLPADDING="5"
  38076. ><TR
  38077. ><TD
  38078. ><PRE
  38079. CLASS="ini"
  38080. >disable_functions readfile,system</PRE
  38081. ></TD
  38082. ></TR
  38083. ></TABLE
  38084. >
  38085.     Wⁿrde diese Warnung erscheinen:
  38086.     <TABLE
  38087. BORDER="0"
  38088. BGCOLOR="#E0E0E0"
  38089. CELLPADDING="5"
  38090. ><TR
  38091. ><TD
  38092. ><PRE
  38093. CLASS="screen"
  38094. >Warning: readfile() has been disabled for security reasons in 
  38095. /docroot/script.php on line 2</PRE
  38096. ></TD
  38097. ></TR
  38098. ></TABLE
  38099. >
  38100.    </P
  38101. ><DIV
  38102. CLASS="sect1"
  38103. ><HR><H2
  38104. CLASS="sect1"
  38105. ><A
  38106. NAME="features.safe-mode.functions"
  38107. >Funktionen, die durch Safe Mode deaktiviert oder eingeschrΣnkt werden</A
  38108. ></H2
  38109. ><P
  38110. >      Dies ist eine Auflistung der Funktionen, die durch 
  38111.      <A
  38112. HREF="#features.safe-mode"
  38113. >Safe Mode</A
  38114. > eingeschrΣnkt
  38115.      werden. Diese Liste ist m÷glicherweise unvollstΣndig und fehlerhaft!
  38116.      
  38117.      <DIV
  38118. CLASS="table"
  38119. ><A
  38120. NAME="AEN6291"
  38121. ></A
  38122. ><P
  38123. ><B
  38124. >Tabelle 38-1. Durch Safe Mode eingeschrΣnkte Funktionen</B
  38125. ></P
  38126. ><TABLE
  38127. BORDER="1"
  38128. CLASS="CALSTABLE"
  38129. ><COL><COL><THEAD
  38130. ><TR
  38131. ><TH
  38132. >Funktion</TH
  38133. ><TH
  38134. >EinschrΣnkungen</TH
  38135. ></TR
  38136. ></THEAD
  38137. ><TBODY
  38138. ><TR
  38139. ><TD
  38140. ><A
  38141. HREF="#function.dbmopen"
  38142. ><B
  38143. CLASS="function"
  38144. >dbmopen()</B
  38145. ></A
  38146. ></TD
  38147. ><TD
  38148. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38149. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38150. selbst.</TD
  38151. ></TR
  38152. ><TR
  38153. ><TD
  38154. ><A
  38155. HREF="#function.dbase-open"
  38156. ><B
  38157. CLASS="function"
  38158. >dbase_open()</B
  38159. ></A
  38160. ></TD
  38161. ><TD
  38162. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38163. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38164. selbst.</TD
  38165. ></TR
  38166. ><TR
  38167. ><TD
  38168. ><A
  38169. HREF="#function.filepro"
  38170. ><B
  38171. CLASS="function"
  38172. >filepro()</B
  38173. ></A
  38174. ></TD
  38175. ><TD
  38176. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38177. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38178. selbst.</TD
  38179. ></TR
  38180. ><TR
  38181. ><TD
  38182. ><A
  38183. HREF="#function.filepro-rowcount"
  38184. ><B
  38185. CLASS="function"
  38186. >filepro_rowcount()</B
  38187. ></A
  38188. ></TD
  38189. ><TD
  38190. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38191. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38192. selbst.</TD
  38193. ></TR
  38194. ><TR
  38195. ><TD
  38196. ><A
  38197. HREF="#function.filepro-retrieve"
  38198. ><B
  38199. CLASS="function"
  38200. >filepro_retrieve()</B
  38201. ></A
  38202. ></TD
  38203. ><TD
  38204. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38205. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38206. selbst.</TD
  38207. ></TR
  38208. ><TR
  38209. ><TD
  38210. ><B
  38211. CLASS="function"
  38212. >ifx_*()</B
  38213. ></TD
  38214. ><TD
  38215. >sql_safe_mode restrictions, (!= Safe Mode)</TD
  38216. ></TR
  38217. ><TR
  38218. ><TD
  38219. ><B
  38220. CLASS="function"
  38221. >ingres_*()</B
  38222. ></TD
  38223. ><TD
  38224. >sql_safe_mode restrictions, (!= Safe Mode)</TD
  38225. ></TR
  38226. ><TR
  38227. ><TD
  38228. ><B
  38229. CLASS="function"
  38230. >mysql_*()</B
  38231. ></TD
  38232. ><TD
  38233. >sql_safe_mode restrictions, (!= Safe Mode)</TD
  38234. ></TR
  38235. ><TR
  38236. ><TD
  38237. ><B
  38238. CLASS="function"
  38239. >pg_loimport()</B
  38240. ></TD
  38241. ><TD
  38242. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38243. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38244. selbst.</TD
  38245. ></TR
  38246. ><TR
  38247. ><TD
  38248. ><A
  38249. HREF="#function.posix-mkfifo"
  38250. ><B
  38251. CLASS="function"
  38252. >posix_mkfifo()</B
  38253. ></A
  38254. ></TD
  38255. ><TD
  38256. >▄berprⁿft ob das Verzeichnis in dem das Skript
  38257. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst.</TD
  38258. ></TR
  38259. ><TR
  38260. ><TD
  38261. ><A
  38262. HREF="#function.putenv"
  38263. ><B
  38264. CLASS="function"
  38265. >putenv()</B
  38266. ></A
  38267. ></TD
  38268. ><TD
  38269. >           Fⁿhrt die safe_mode_protected_env_vars und 
  38270.           safe_mode_allowed_env_vars ini-directiven aus.
  38271.           Siehe auch Dokumentation zu <A
  38272. HREF="#function.putenv"
  38273. ><B
  38274. CLASS="function"
  38275. >putenv()</B
  38276. ></A
  38277. >
  38278.          </TD
  38279. ></TR
  38280. ><TR
  38281. ><TD
  38282. ><A
  38283. HREF="#function.move-uploaded-file"
  38284. ><B
  38285. CLASS="function"
  38286. >move_uploaded_file()</B
  38287. ></A
  38288. ></TD
  38289. ><TD
  38290. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38291. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38292. selbst. </TD
  38293. ></TR
  38294. ><TR
  38295. ><TD
  38296. ><A
  38297. HREF="#function.chdir"
  38298. ><B
  38299. CLASS="function"
  38300. >chdir()</B
  38301. ></A
  38302. ></TD
  38303. ><TD
  38304. >▄berprⁿft ob das Verzeichnis in dem das Skript
  38305. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst.</TD
  38306. ></TR
  38307. ><TR
  38308. ><TD
  38309. ><A
  38310. HREF="#function.dl"
  38311. ><B
  38312. CLASS="function"
  38313. >dl()</B
  38314. ></A
  38315. ></TD
  38316. ><TD
  38317. >Diese Funktion steht im <A
  38318. HREF="#features.safe-mode"
  38319. >Safe Mode</A
  38320. > nicht zur Verfⁿgung.</TD
  38321. ></TR
  38322. ><TR
  38323. ><TD
  38324. ><A
  38325. HREF="#language.operators.execution"
  38326. >           backtick operator</A
  38327. >
  38328.          </TD
  38329. ><TD
  38330. >Diese Funktion steht im <A
  38331. HREF="#features.safe-mode"
  38332. >Safe Mode</A
  38333. > nicht zur Verfⁿgung.</TD
  38334. ></TR
  38335. ><TR
  38336. ><TD
  38337. ><A
  38338. HREF="#function.shell-exec"
  38339. ><B
  38340. CLASS="function"
  38341. >shell_exec()</B
  38342. ></A
  38343. > (funktional gleichwertig zu den 
  38344.           Backtick-Operatoren)</TD
  38345. ><TD
  38346. >Diese Funktion steht im <A
  38347. HREF="#features.safe-mode"
  38348. >Safe Mode</A
  38349. > nicht zur Verfⁿgung.</TD
  38350. ></TR
  38351. ><TR
  38352. ><TD
  38353. ><A
  38354. HREF="#function.exec"
  38355. ><B
  38356. CLASS="function"
  38357. >exec()</B
  38358. ></A
  38359. ></TD
  38360. ><TD
  38361. >Ausfⁿhrbare Dateien k÷nnen nur innerhalb des durch <A
  38362. HREF="#ini.safe-mode-exec-dir"
  38363. >safe_mode_exec_dir</A
  38364. > angegebenen
  38365.           Verzeichnisses ausgefⁿhrt werden.
  38366.           Aus praktischen Grⁿnden ist es momentan nicht erlaubt, <VAR
  38367. CLASS="literal"
  38368. >..</VAR
  38369. >
  38370.           im Pfad zu den ausfⁿhrbaren Datein anzugeben.
  38371.          </TD
  38372. ></TR
  38373. ><TR
  38374. ><TD
  38375. ><A
  38376. HREF="#function.system"
  38377. ><B
  38378. CLASS="function"
  38379. >system()</B
  38380. ></A
  38381. ></TD
  38382. ><TD
  38383. >Ausfⁿhrbare Dateien k÷nnen nur innerhalb des durch <A
  38384. HREF="#ini.safe-mode-exec-dir"
  38385. >safe_mode_exec_dir</A
  38386. > angegebenen
  38387.           Verzeichnisses ausgefⁿhrt werden.
  38388.           Aus praktischen Grⁿnden ist es momentan nicht erlaubt, <VAR
  38389. CLASS="literal"
  38390. >..</VAR
  38391. >
  38392.           im Pfad zu den ausfⁿhrbaren Datein anzugeben.
  38393.          </TD
  38394. ></TR
  38395. ><TR
  38396. ><TD
  38397. ><A
  38398. HREF="#function.passthru"
  38399. ><B
  38400. CLASS="function"
  38401. >passthru()</B
  38402. ></A
  38403. ></TD
  38404. ><TD
  38405. >Ausfⁿhrbare Dateien k÷nnen nur innerhalb des durch <A
  38406. HREF="#ini.safe-mode-exec-dir"
  38407. >safe_mode_exec_dir</A
  38408. > angegebenen
  38409.           Verzeichnisses ausgefⁿhrt werden.
  38410.           Aus praktischen Grⁿnden ist es momentan nicht erlaubt, <VAR
  38411. CLASS="literal"
  38412. >..</VAR
  38413. >
  38414.           im Pfad zu den ausfⁿhrbaren Datein anzugeben.
  38415.          </TD
  38416. ></TR
  38417. ><TR
  38418. ><TD
  38419. ><A
  38420. HREF="#function.popen"
  38421. ><B
  38422. CLASS="function"
  38423. >popen()</B
  38424. ></A
  38425. ></TD
  38426. ><TD
  38427. >Ausfⁿhrbare Dateien k÷nnen nur innerhalb des durch <A
  38428. HREF="#ini.safe-mode-exec-dir"
  38429. >safe_mode_exec_dir</A
  38430. > angegebenen
  38431.           Verzeichnisses ausgefⁿhrt werden.
  38432.           Aus praktischen Grⁿnden ist es momentan nicht erlaubt, <VAR
  38433. CLASS="literal"
  38434. >..</VAR
  38435. >
  38436.           im Pfad zu den ausfⁿhrbaren Datein anzugeben.
  38437.          </TD
  38438. ></TR
  38439. ><TR
  38440. ><TD
  38441. ><A
  38442. HREF="#function.mkdir"
  38443. ><B
  38444. CLASS="function"
  38445. >mkdir()</B
  38446. ></A
  38447. ></TD
  38448. ><TD
  38449. >▄berprⁿft ob das Verzeichnis in dem das Skript
  38450. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst.</TD
  38451. ></TR
  38452. ><TR
  38453. ><TD
  38454. ><A
  38455. HREF="#function.rmdir"
  38456. ><B
  38457. CLASS="function"
  38458. >rmdir()</B
  38459. ></A
  38460. ></TD
  38461. ><TD
  38462. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38463. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38464. selbst.</TD
  38465. ></TR
  38466. ><TR
  38467. ><TD
  38468. ><A
  38469. HREF="#function.rename"
  38470. ><B
  38471. CLASS="function"
  38472. >rename()</B
  38473. ></A
  38474. ></TD
  38475. ><TD
  38476. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38477. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38478. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38479. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst.
  38480.           
  38481.          </TD
  38482. ></TR
  38483. ><TR
  38484. ><TD
  38485. ><A
  38486. HREF="#function.unlink"
  38487. ><B
  38488. CLASS="function"
  38489. >unlink()</B
  38490. ></A
  38491. ></TD
  38492. ><TD
  38493. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38494. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38495. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38496. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst.</TD
  38497. ></TR
  38498. ><TR
  38499. ><TD
  38500. ><A
  38501. HREF="#function.copy"
  38502. ><B
  38503. CLASS="function"
  38504. >copy()</B
  38505. ></A
  38506. ></TD
  38507. ><TD
  38508. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38509. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38510. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38511. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst. (on 
  38512.          <VAR
  38513. CLASS="parameter"
  38514. >source</VAR
  38515. > and 
  38516.          <VAR
  38517. CLASS="parameter"
  38518. >target</VAR
  38519. >) </TD
  38520. ></TR
  38521. ><TR
  38522. ><TD
  38523. ><A
  38524. HREF="#function.chgrp"
  38525. ><B
  38526. CLASS="function"
  38527. >chgrp()</B
  38528. ></A
  38529. ></TD
  38530. ><TD
  38531. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38532. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38533. selbst.</TD
  38534. ></TR
  38535. ><TR
  38536. ><TD
  38537. ><A
  38538. HREF="#function.chown"
  38539. ><B
  38540. CLASS="function"
  38541. >chown()</B
  38542. ></A
  38543. ></TD
  38544. ><TD
  38545. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38546. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38547. selbst.</TD
  38548. ></TR
  38549. ><TR
  38550. ><TD
  38551. ><A
  38552. HREF="#function.chmod"
  38553. ><B
  38554. CLASS="function"
  38555. >chmod()</B
  38556. ></A
  38557. ></TD
  38558. ><TD
  38559. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38560. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38561. selbst. In addition, you cannot  
  38562.          set the SUID, SGID and sticky bits</TD
  38563. ></TR
  38564. ><TR
  38565. ><TD
  38566. ><A
  38567. HREF="#function.touch"
  38568. ><B
  38569. CLASS="function"
  38570. >touch()</B
  38571. ></A
  38572. ></TD
  38573. ><TD
  38574. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38575. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38576. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38577. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst.</TD
  38578. ></TR
  38579. ><TR
  38580. ><TD
  38581. ><A
  38582. HREF="#function.symlink"
  38583. ><B
  38584. CLASS="function"
  38585. >symlink()</B
  38586. ></A
  38587. ></TD
  38588. ><TD
  38589. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38590. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38591. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38592. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst. (note: only the target is 
  38593.          checked)</TD
  38594. ></TR
  38595. ><TR
  38596. ><TD
  38597. ><A
  38598. HREF="#function.link"
  38599. ><B
  38600. CLASS="function"
  38601. >link()</B
  38602. ></A
  38603. ></TD
  38604. ><TD
  38605. >▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38606. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38607. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38608. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst. (note: only the target is 
  38609.          checked)</TD
  38610. ></TR
  38611. ><TR
  38612. ><TD
  38613. ><A
  38614. HREF="#function.getallheaders"
  38615. ><B
  38616. CLASS="function"
  38617. >getallheaders()</B
  38618. ></A
  38619. ></TD
  38620. ><TD
  38621. >           Header die mit 'authorization' (unabhΣngig von Gro▀- oder Kleinschreibung)
  38622.           beginnen, werden bei Verwendung von Safe Mode nicht zurⁿckgegeben. 
  38623.           Achtung: Dies ist fehlerhaft bei der AOL-Server Implementation 
  38624.           der Funktion <A
  38625. HREF="#function.getallheaders"
  38626. ><B
  38627. CLASS="function"
  38628. >getallheaders()</B
  38629. ></A
  38630. >!
  38631.          </TD
  38632. ></TR
  38633. ><TR
  38634. ><TD
  38635. >           <A
  38636. HREF="#function.highlight-file"
  38637. ><B
  38638. CLASS="function"
  38639. >highlight_file()</B
  38640. ></A
  38641. >,
  38642.           <A
  38643. HREF="#function.show-source"
  38644. ><B
  38645. CLASS="function"
  38646. >show_source()</B
  38647. ></A
  38648. >
  38649.          </TD
  38650. ><TD
  38651. >           ▄berprⁿft ob die Dateien/Verzeichnisse, die mit dem Skript
  38652. bearbeitet werden sollen, die gleiche UID Eigentⁿmer haben wie das Skript
  38653. selbst. ▄berprⁿft ob das Verzeichnis in dem das Skript
  38654. ausgefⁿhrt werden soll, die gleiche UID (Eigentⁿmer) hat wie das Skript selbst. (Hinweis: gilt nur ab Version PHP 4.2.1)
  38655.          </TD
  38656. ></TR
  38657. ><TR
  38658. ><TD
  38659. >Jede Funktion, die 
  38660.           <TT
  38661. CLASS="filename"
  38662. >php4/main/fopen_wrappers.c</TT
  38663. >
  38664.           benutzt...
  38665.          </TD
  38666. ><TD
  38667. >??</TD
  38668. ></TR
  38669. ></TBODY
  38670. ></TABLE
  38671. ></DIV
  38672. >
  38673.     </P
  38674. ></DIV
  38675. ></DIV
  38676. ><DIV
  38677. CLASS="chapter"
  38678. ><HR><H1
  38679. ><A
  38680. NAME="features.commandline"
  38681. >Kapitel 39. PHP auf der Kommandozeile</A
  38682. ></H1
  38683. ><P
  38684. >   Seit Version 4.3.0 unterstⁿtzt <VAR
  38685. CLASS="literal"
  38686. >PHP</VAR
  38687. > einen neuen
  38688.   Typ <VAR
  38689. CLASS="literal"
  38690. >SAPI</VAR
  38691. > (Server Application Programming 
  38692.   Interface) namens <VAR
  38693. CLASS="literal"
  38694. >CLI</VAR
  38695. > (<SPAN
  38696. CLASS="emphasis"
  38697. ><I
  38698. CLASS="emphasis"
  38699. >Command Line
  38700.   Interface</I
  38701. ></SPAN
  38702. >). Wie der Name schon verrΣt, liegt das 
  38703.   Hauptaugemerk dieses <VAR
  38704. CLASS="literal"
  38705. >SAPI</VAR
  38706. >-Typs auf der Entwicklung
  38707.   von Anwendungen fⁿr die Kommandozeile (und auch den Desktop) mit 
  38708.   <VAR
  38709. CLASS="literal"
  38710. >PHP</VAR
  38711. >. Es gibt etliche Unterschiede zwischen dem 
  38712.   <VAR
  38713. CLASS="literal"
  38714. >CLI SAPI</VAR
  38715. > und anderen <VAR
  38716. CLASS="literal"
  38717. >SAPI</VAR
  38718. >s,
  38719.   die in diesem Kapitel beschrieben werden. Es ist erwΣhnenswert, 
  38720.   dass <VAR
  38721. CLASS="literal"
  38722. >CLI</VAR
  38723. > und <VAR
  38724. CLASS="literal"
  38725. >CGI</VAR
  38726. > verschiedene
  38727.   SAPIs sind, obwohl sie viele Verhaltensweisen teilen.
  38728.  </P
  38729. ><P
  38730. >   Das <VAR
  38731. CLASS="literal"
  38732. >CLI SAPI</VAR
  38733. > wurde zum ersten Mal mit 
  38734.   <VAR
  38735. CLASS="literal"
  38736. >PHP 4.2.0</VAR
  38737. > eingefⁿhrt, war aber noch experimentell
  38738.   und musste explizit mit <VAR
  38739. CLASS="literal"
  38740. >--enable-cli</VAR
  38741. > beim 
  38742.   <VAR
  38743. CLASS="literal"
  38744. >./configure</VAR
  38745. >-Aufruf eingeschaltet werden. Seit
  38746.   <VAR
  38747. CLASS="literal"
  38748. >PHP 4.3.0</VAR
  38749. > ist das <VAR
  38750. CLASS="literal"
  38751. >CLI SAPI</VAR
  38752. > nicht
  38753.   lΣnger experimentell und die Option <VAR
  38754. CLASS="literal"
  38755. >--enable-cli</VAR
  38756. >
  38757.   standardmΣ▀ig auf <VAR
  38758. CLASS="literal"
  38759. >on</VAR
  38760. > gestellt. Sie k÷nnen 
  38761.   <VAR
  38762. CLASS="literal"
  38763. >--disable-cli</VAR
  38764. > benutzen, um es auszuschalten.
  38765.  </P
  38766. ><P
  38767. >   Von <VAR
  38768. CLASS="literal"
  38769. >PHP 4.3.0</VAR
  38770. > an werden Namen, Pfade und
  38771.   Vorhandensein der CLI/CGI-Binaries voneinander abweichen, abhΣngig
  38772.   davon, wie <VAR
  38773. CLASS="literal"
  38774. >PHP</VAR
  38775. > auf Ihrem System installiert ist.
  38776.   StandarmΣ▀ig werden nach dem Aufruf von <VAR
  38777. CLASS="literal"
  38778. >make</VAR
  38779. >
  38780.   sowohl CGI als auch CLI kompiliert und als <VAR
  38781. CLASS="literal"
  38782. >sapi/cgi/php</VAR
  38783. >
  38784.   beziehungsweise <VAR
  38785. CLASS="literal"
  38786. >sapi/cli/php</VAR
  38787. > in Ihrem
  38788.   PHP-Quellcodeverzeichnis hinterlegt. Sie werden bemerken, dass beide
  38789.   <VAR
  38790. CLASS="literal"
  38791. >php</VAR
  38792. > benannt sind. Was wΣhrend 
  38793.   <VAR
  38794. CLASS="literal"
  38795. >make install</VAR
  38796. > passiert, hΣngt von Ihrem 
  38797.   configure-Kommando ab. Wenn ein Modul-SAPI wΣhrend configure gewΣhlt
  38798.   wird, wie etwa <VAR
  38799. CLASS="literal"
  38800. >apxs</VAR
  38801. > oder wenn die 
  38802.   <VAR
  38803. CLASS="literal"
  38804. >--disable-cgi</VAR
  38805. >-Option benutzt wird, wird das CLI
  38806.   wΣhrend <VAR
  38807. CLASS="literal"
  38808. >make install</VAR
  38809. > nach 
  38810.   <VAR
  38811. CLASS="literal"
  38812. >{PREFIX}/bin/php</VAR
  38813. > kopiert, ansonsten wird das CGI
  38814.   dort hinterlegt. Also wird, wenn beispielsweise 
  38815.   <VAR
  38816. CLASS="literal"
  38817. >--with--apxs</VAR
  38818. > in Ihrem configure-Kommando auftaucht,
  38819.   das CLI wΣhrend  <VAR
  38820. CLASS="literal"
  38821. >make install</VAR
  38822. > nach 
  38823.   <VAR
  38824. CLASS="literal"
  38825. >{PREFIX}/bin/php</VAR
  38826. > kopiert. Wenn Sie die Installation
  38827.   des CGI-Binaries au▀er Kraft setzen wollen, benutzen Sie 
  38828.   <VAR
  38829. CLASS="literal"
  38830. >make install-cli</VAR
  38831. > nach
  38832.   <VAR
  38833. CLASS="literal"
  38834. >make install</VAR
  38835. >. Alternativ k÷nnen Sie 
  38836.   <VAR
  38837. CLASS="literal"
  38838. >--disable-cgi</VAR
  38839. > in Ihrem configure-Kommando angeben.
  38840.  </P
  38841. ><P
  38842. >   <DIV
  38843. CLASS="note"
  38844. ><BLOCKQUOTE
  38845. CLASS="note"
  38846. ><P
  38847. ><B
  38848. >Anmerkung: </B
  38849. >
  38850.     Weil sowohl <VAR
  38851. CLASS="literal"
  38852. >--enable-cli</VAR
  38853. > als auch <VAR
  38854. CLASS="literal"
  38855. >     --enable-cgi</VAR
  38856. > standardmΣ▀ig eingeschaltet sind, 
  38857.     muss <VAR
  38858. CLASS="literal"
  38859. >--enable-cli</VAR
  38860. > in Ihrem configure-Kommando
  38861.     nicht zwingend bedeuten, dass das CLI wΣhrend 
  38862.     <VAR
  38863. CLASS="literal"
  38864. >make install</VAR
  38865. > nach 
  38866.     <VAR
  38867. CLASS="literal"
  38868. >{PREFIX}/bin/php</VAR
  38869. > kopiert wird.
  38870.    </P
  38871. ></BLOCKQUOTE
  38872. ></DIV
  38873. >
  38874.  </P
  38875. ><P
  38876. >   Die Windows-Pakete zwischen PHP 4.2.0 und PHP 4.2.3 enthielten das
  38877.   CLI als <TT
  38878. CLASS="filename"
  38879. >php-cli.exe</TT
  38880. >, beheimatet im selben
  38881.   Verzeichnis wie das CGI <TT
  38882. CLASS="filename"
  38883. >php.exe</TT
  38884. >. Beginnend mit
  38885.   PHP 4.3.0 enthΣlt das Windows-Paket das CLI als <TT
  38886. CLASS="filename"
  38887. >php.exe</TT
  38888. >
  38889.   in einem eigenen Verzeichnis namens <VAR
  38890. CLASS="literal"
  38891. >cli</VAR
  38892. >, also 
  38893.   <VAR
  38894. CLASS="literal"
  38895. >cli/php.exe</VAR
  38896. >. Beginnend mit PHP 5 wird das CLI im
  38897.   Hauptordner al <TT
  38898. CLASS="filename"
  38899. >php.exe</TT
  38900. > ausgeliefert. Die CGI-Version
  38901.   heisst <TT
  38902. CLASS="filename"
  38903. >php-cgi.exe</TT
  38904. >.
  38905.  </P
  38906. ><P
  38907. >   Seit PHP gibt es eine neue Datei, <TT
  38908. CLASS="filename"
  38909. >php-win.exe</TT
  38910. >. Diese ist
  38911.   identisch mit der CLI-Version, die einzige Ausnahme besteht darin, dass
  38912.   php-win nichts ausgibt und somit keine Konsole bietet. (Es erscheint keine
  38913.   "MS-DOS-Eingabeaufforderung".)  Dieses Verhalten ist Σhnlich php-gtk. Sie
  38914.   sollten die folgende Option fⁿr ./configure benutzen:
  38915.   <VAR
  38916. CLASS="literal"
  38917. >--enable-cli-win32</VAR
  38918. >.
  38919.  </P
  38920. ><P
  38921. >   <DIV
  38922. CLASS="note"
  38923. ><BLOCKQUOTE
  38924. CLASS="note"
  38925. ><P
  38926. ><B
  38927. >Welche SAPI habe ich?: </B
  38928. >
  38929.     Auf der Kommandozeile wird Ihnen die Eingabe von <VAR
  38930. CLASS="literal"
  38931. >php -v</VAR
  38932. >
  38933.     verraten, ob Sie <VAR
  38934. CLASS="literal"
  38935. >php</VAR
  38936. > als CGI oder CLI einsetzen.  
  38937.     Sehen Sie sich auch die Funktion <A
  38938. HREF="#function.php-sapi-name"
  38939. ><B
  38940. CLASS="function"
  38941. >php_sapi_name()</B
  38942. ></A
  38943. > 
  38944.     und die Konstante <TT
  38945. CLASS="constant"
  38946. ><B
  38947. >PHP_SAPI</B
  38948. ></TT
  38949. > an.
  38950.    </P
  38951. ></BLOCKQUOTE
  38952. ></DIV
  38953. >
  38954.  </P
  38955. ><P
  38956. >   <DIV
  38957. CLASS="note"
  38958. ><BLOCKQUOTE
  38959. CLASS="note"
  38960. ><P
  38961. ><B
  38962. >Anmerkung: </B
  38963. >
  38964.     Eine UNIX <VAR
  38965. CLASS="literal"
  38966. >man</VAR
  38967. >ual page wurde in PHP 4.3.2 hinzugefⁿgt.
  38968.     Sie k÷nnen sie ansehen, indem sie <VAR
  38969. CLASS="literal"
  38970. >man php</VAR
  38971. > auf der
  38972.     Kommandozeile eintippen.
  38973.    </P
  38974. ></BLOCKQUOTE
  38975. ></DIV
  38976. >
  38977.  </P
  38978. ><P
  38979. >   Beachtenswerte Unterschiede des <VAR
  38980. CLASS="literal"
  38981. >CLI SAPI</VAR
  38982. > verglichen mit
  38983.   anderen <VAR
  38984. CLASS="literal"
  38985. >SAPI</VAR
  38986. >s:
  38987.   <P
  38988. ></P
  38989. ><UL
  38990. ><LI
  38991. ><P
  38992. >      Anders als beim <VAR
  38993. CLASS="literal"
  38994. >CGI SAPI</VAR
  38995. > werden keine 
  38996.      Header ausgegeben.
  38997.     </P
  38998. ><P
  38999. >      Obwohl das <VAR
  39000. CLASS="literal"
  39001. >CGI SAPI</VAR
  39002. > einen Weg bietet, HTTP-Header zu
  39003.      unterdrⁿcken, gibt es keine gleichwertige Option, sie im <VAR
  39004. CLASS="literal"
  39005. >CLI
  39006.      SAPI</VAR
  39007. > anzuzeigen.
  39008.     </P
  39009. ><P
  39010. >      CLI wird standardmΣ▀ig im stillen Modus gestartet, dennoch gibt
  39011.      es die Optionen <VAR
  39012. CLASS="literal"
  39013. >-q</VAR
  39014. > und <VAR
  39015. CLASS="literal"
  39016. >--no-header</VAR
  39017. >
  39018.      aus KompatibilitΣtsgrⁿnden noch, so dass Sie auch Σltere CGI-Skripte noch
  39019.      benutzen k÷nnen.
  39020.     </P
  39021. ><P
  39022. >      Es verΣndert das Arbeitsverzeichnis nicht zu dem des Skriptes.
  39023.      (Die Optionen <VAR
  39024. CLASS="literal"
  39025. >-C</VAR
  39026. > und <VAR
  39027. CLASS="literal"
  39028. >--no-chdir</VAR
  39029. >
  39030.      wurden aus KompatibilitΣtsgrⁿnden beibehalten.)
  39031.     </P
  39032. ><P
  39033. >      Fehlermeldungen in Plaintext (keine HTML-Formatierung).
  39034.     </P
  39035. ></LI
  39036. ><LI
  39037. ><P
  39038. >      Es gibt bestimmte <TT
  39039. CLASS="filename"
  39040. >php.ini</TT
  39041. >-Direktiven, die vom 
  39042.      <VAR
  39043. CLASS="literal"
  39044. >CLI SAPI</VAR
  39045. > au▀er Kraft gesetzt werden, weil sie in
  39046.      einer Kommandozeilenumgebung keinen Sinn ergeben.
  39047.     </P
  39048. ><P
  39049. >      <DIV
  39050. CLASS="table"
  39051. ><A
  39052. NAME="AEN6546"
  39053. ></A
  39054. ><P
  39055. ><B
  39056. >Tabelle 39-1. ▄berschriebene <TT
  39057. CLASS="filename"
  39058. >php.ini</TT
  39059. >-Direktiven</B
  39060. ></P
  39061. ><TABLE
  39062. BORDER="1"
  39063. CLASS="CALSTABLE"
  39064. ><COL><COL><COL><THEAD
  39065. ><TR
  39066. ><TH
  39067. >Direktive</TH
  39068. ><TH
  39069. ><VAR
  39070. CLASS="literal"
  39071. >CLI SAPI</VAR
  39072. >-Standardwert</TH
  39073. ><TH
  39074. >Kommentar</TH
  39075. ></TR
  39076. ></THEAD
  39077. ><TBODY
  39078. ><TR
  39079. ><TD
  39080. ><A
  39081. HREF="#ini.html-errors"
  39082. >html_errors</A
  39083. ></TD
  39084. ><TD
  39085. ><TT
  39086. CLASS="constant"
  39087. ><B
  39088. >FALSE</B
  39089. ></TT
  39090. ></TD
  39091. ><TD
  39092. >           Es kann sehr schwierig sein, eine Fehlermeldung auf der
  39093.           Kommandozeile zu lesen, wenn sie mit all diesen bedeutungslosen
  39094.           <VAR
  39095. CLASS="literal"
  39096. >HTML</VAR
  39097. >-Tags vollgestopft ist, deswegen wird 
  39098.           diese Direktive auf <TT
  39099. CLASS="constant"
  39100. ><B
  39101. >FALSE</B
  39102. ></TT
  39103. > gesetzt.
  39104.          </TD
  39105. ></TR
  39106. ><TR
  39107. ><TD
  39108. ><A
  39109. HREF="#ini.implicit-flush"
  39110. >implicit_flush</A
  39111. ></TD
  39112. ><TD
  39113. ><TT
  39114. CLASS="constant"
  39115. ><B
  39116. >TRUE</B
  39117. ></TT
  39118. ></TD
  39119. ><TD
  39120. >           Es ist erwⁿnscht, dass alle Ausgaben, die von 
  39121.           <A
  39122. HREF="#function.print"
  39123. ><B
  39124. CLASS="function"
  39125. >print()</B
  39126. ></A
  39127. >, <A
  39128. HREF="#function.echo"
  39129. ><B
  39130. CLASS="function"
  39131. >echo()</B
  39132. ></A
  39133. > und Konsorten
  39134.           kommen, sofort auf die Ausgabe geschrieben werden und nicht in
  39135.           irgendeinem Puffer gecacht werden. Sie k÷nnen immer noch 
  39136.           <A
  39137. HREF="#ref.outcontrol"
  39138. >output buffering</A
  39139. > benutzen,
  39140.           wenn Sie die Standardausgabe aufschieben oder manipulieren wollen.
  39141.          </TD
  39142. ></TR
  39143. ><TR
  39144. ><TD
  39145. ><A
  39146. HREF="#ini.max-execution-time"
  39147. >max_execution_time</A
  39148. ></TD
  39149. ><TD
  39150. >0 (unlimited)</TD
  39151. ><TD
  39152. >           Wegen der unendlichen M÷glichkeiten, <VAR
  39153. CLASS="literal"
  39154. >PHP</VAR
  39155. > in 
  39156.           Kommandozeilenumgebungen zu benutzen wurde die maximale 
  39157.           Ausfⁿhrungszeit auf unbegrenzte Zeit eingestellt. Wohingegen
  39158.           Anwendungen, die fⁿr das Web geschrieben wurden, oft in sehr kurzer
  39159.           Zeit ausgefⁿhrt werden, neigen Anwendungen fⁿr die Kommandozeile
  39160.           dazu, eine viel lΣngere Ausfⁿhrungszeit zu beanspruchen. 
  39161.          </TD
  39162. ></TR
  39163. ><TR
  39164. ><TD
  39165. ><A
  39166. HREF="#ini.register-argc-argv"
  39167. >register_argc_argv</A
  39168. ></TD
  39169. ><TD
  39170. ><TT
  39171. CLASS="constant"
  39172. ><B
  39173. >TRUE</B
  39174. ></TT
  39175. ></TD
  39176. ><TD
  39177. >          <P
  39178. >           Weil diese Einstellung auf <TT
  39179. CLASS="constant"
  39180. ><B
  39181. >TRUE</B
  39182. ></TT
  39183. > gesetzt ist, werden Sie immer
  39184.           Zugriff auf <SPAN
  39185. CLASS="emphasis"
  39186. ><I
  39187. CLASS="emphasis"
  39188. >argc</I
  39189. ></SPAN
  39190. > (Anzahl der Argumente, die
  39191.           der Anwendung ⁿbergeben wurden) und <SPAN
  39192. CLASS="emphasis"
  39193. ><I
  39194. CLASS="emphasis"
  39195. >argv</I
  39196. ></SPAN
  39197. >
  39198.           (Array der eigentlichen Argumente) im <VAR
  39199. CLASS="literal"
  39200. >CLI SAPI</VAR
  39201. >
  39202.           haben.
  39203.          </P
  39204. >
  39205.          <P
  39206. >           Seit PHP 4.3.0 werden die <VAR
  39207. CLASS="literal"
  39208. >PHP</VAR
  39209. >-Variablen 
  39210.           <VAR
  39211. CLASS="varname"
  39212. >$argc</VAR
  39213. > und <VAR
  39214. CLASS="varname"
  39215. >$argv</VAR
  39216. > registriert
  39217.           und mit den entsprechenden Werten gefⁿllt, wenn das 
  39218.           <VAR
  39219. CLASS="literal"
  39220. >CLI SAPI</VAR
  39221. > benutzt wird. Vor dieser Version
  39222.           verhielt sich die Erzeugung dieser Variablen so wie in den 
  39223.           <VAR
  39224. CLASS="literal"
  39225. >CGI</VAR
  39226. > und <VAR
  39227. CLASS="literal"
  39228. >MODULE</VAR
  39229. >-Versionen,
  39230.           die die PHP-Direktive 
  39231.           <A
  39232. HREF="#ini.register-globals"
  39233. >register_globals</A
  39234. > auf
  39235.           <SPAN
  39236. CLASS="emphasis"
  39237. ><I
  39238. CLASS="emphasis"
  39239. >on</I
  39240. ></SPAN
  39241. > verlangen. Ungeachtet der Version oder der
  39242.           Einstellung von 
  39243.           <A
  39244. HREF="#ini.register-globals"
  39245. >register_globals</A
  39246. >
  39247.           k÷nnen Sie immer 
  39248.           <A
  39249. HREF="#reserved.variables.server"
  39250. >$_SERVER</A
  39251. > oder 
  39252.           <VAR
  39253. CLASS="varname"
  39254. >$HTTP_SERVER_VARS</VAR
  39255. > benutzen. Beispiel:
  39256.           <VAR
  39257. CLASS="varname"
  39258. >$_SERVER['argv']</VAR
  39259. >
  39260.          </P
  39261. >
  39262.          </TD
  39263. ></TR
  39264. ></TBODY
  39265. ></TABLE
  39266. ></DIV
  39267. >
  39268.     </P
  39269. ><DIV
  39270. CLASS="note"
  39271. ><BLOCKQUOTE
  39272. CLASS="note"
  39273. ><P
  39274. ><B
  39275. >Anmerkung: </B
  39276. >
  39277.       Diese Direktiven k÷nnen nicht mit einem anderen Wert aus der
  39278.       Konfigurationsdatei <TT
  39279. CLASS="filename"
  39280. >php.ini</TT
  39281. > oder einer eigenen (falls angegeben)
  39282.       initialisiert werden. Das ist eine EinschrΣnkung, weil diese
  39283.       Standardwerte angewandt werden, nachdem alle Konfigurationsdateien
  39284.       durchlaufen wurden. Dennoch k÷nnen die Werte zur Laufzeit
  39285.       verΣndert werden (was aber fⁿr alle diese Direktiven keinen
  39286.       Sinn ergibt, beispielsweise 
  39287.       <A
  39288. HREF="#ini.register-argc-argv"
  39289. >register_argc_argv</A
  39290. >).
  39291.      </P
  39292. ></BLOCKQUOTE
  39293. ></DIV
  39294. ></LI
  39295. ><LI
  39296. ><P
  39297. >      Um die Arbeit in der Kommandozeilenumgebung zu vereinfachen, wurden
  39298.      folgende Konstanten definiert:
  39299.      <DIV
  39300. CLASS="table"
  39301. ><A
  39302. NAME="AEN6610"
  39303. ></A
  39304. ><P
  39305. ><B
  39306. >Tabelle 39-2. CLI-spezifische Konstanten</B
  39307. ></P
  39308. ><TABLE
  39309. BORDER="1"
  39310. CLASS="CALSTABLE"
  39311. ><COL><COL><THEAD
  39312. ><TR
  39313. ><TH
  39314. >Konstante</TH
  39315. ><TH
  39316. >Beschreibung</TH
  39317. ></TR
  39318. ></THEAD
  39319. ><TBODY
  39320. ><TR
  39321. ><TD
  39322. ><TT
  39323. CLASS="constant"
  39324. ><B
  39325. >STDIN</B
  39326. ></TT
  39327. ></TD
  39328. ><TD
  39329. >          Ein schon ge÷ffneter Stream auf <VAR
  39330. CLASS="literal"
  39331. >stdin</VAR
  39332. >.
  39333.          Das erspart das ÷ffnen mit
  39334.          <TABLE
  39335. BORDER="0"
  39336. BGCOLOR="#E0E0E0"
  39337. CELLPADDING="5"
  39338. ><TR
  39339. ><TD
  39340. ><PRE
  39341. CLASS="php"
  39342. ><?php
  39343.  
  39344. $stdin = fopen('php://stdin', 'r');
  39345.  
  39346. ?></PRE
  39347. ></TD
  39348. ></TR
  39349. ></TABLE
  39350. >
  39351.          </TD
  39352. ></TR
  39353. ><TR
  39354. ><TD
  39355. ><TT
  39356. CLASS="constant"
  39357. ><B
  39358. >STDOUT</B
  39359. ></TT
  39360. ></TD
  39361. ><TD
  39362. >          Ein schon ge÷ffneter Stream auf <VAR
  39363. CLASS="literal"
  39364. >stdout</VAR
  39365. >.
  39366.          Das erspart das ÷ffnen mit
  39367.          <TABLE
  39368. BORDER="0"
  39369. BGCOLOR="#E0E0E0"
  39370. CELLPADDING="5"
  39371. ><TR
  39372. ><TD
  39373. ><PRE
  39374. CLASS="php"
  39375. ><?php
  39376.  
  39377. $stdout = fopen('php://stdout', 'w');
  39378.  
  39379. ?></PRE
  39380. ></TD
  39381. ></TR
  39382. ></TABLE
  39383. >
  39384.          </TD
  39385. ></TR
  39386. ><TR
  39387. ><TD
  39388. ><TT
  39389. CLASS="constant"
  39390. ><B
  39391. >STDERR</B
  39392. ></TT
  39393. ></TD
  39394. ><TD
  39395. >          Ein schon ge÷ffneter Stream auf <VAR
  39396. CLASS="literal"
  39397. >stderr</VAR
  39398. >.
  39399.          Das erspart das ÷ffnen mit
  39400.          <TABLE
  39401. BORDER="0"
  39402. BGCOLOR="#E0E0E0"
  39403. CELLPADDING="5"
  39404. ><TR
  39405. ><TD
  39406. ><PRE
  39407. CLASS="php"
  39408. ><?php
  39409.  
  39410. $stderr = fopen('php://stderr', 'w');
  39411.  
  39412. ?></PRE
  39413. ></TD
  39414. ></TR
  39415. ></TABLE
  39416. >
  39417.          </TD
  39418. ></TR
  39419. ></TBODY
  39420. ></TABLE
  39421. ></DIV
  39422. >
  39423.     </P
  39424. ><P
  39425. >      Angesichts des oben genannten brauchen Sie beispielsweise nicht 
  39426.      selbst einen Stream fⁿr <VAR
  39427. CLASS="literal"
  39428. >stderr</VAR
  39429. > ÷ffnen, sondern
  39430.      einfach die Konstante statt der Ressource:
  39431.      <TABLE
  39432. BORDER="0"
  39433. BGCOLOR="#E0E0E0"
  39434. CELLPADDING="5"
  39435. ><TR
  39436. ><TD
  39437. ><PRE
  39438. CLASS="shell"
  39439. >php -r 'fwrite(STDERR, "stderr\n");'</PRE
  39440. ></TD
  39441. ></TR
  39442. ></TABLE
  39443. >
  39444.      Sie brauchen diese Ressourcen nicht explizit schliessen, weil sie
  39445.      automatisch von <VAR
  39446. CLASS="literal"
  39447. >PHP</VAR
  39448. > geschlossen werden, wenn 
  39449.      ihr Skript endet.
  39450.     </P
  39451. ></LI
  39452. ><LI
  39453. ><P
  39454. >      Das <VAR
  39455. CLASS="literal"
  39456. >CLI SAPI</VAR
  39457. > Σndert das aktuelle Verzeichnis
  39458.      <SPAN
  39459. CLASS="strong"
  39460. ><B
  39461. CLASS="emphasis"
  39462. >nicht</B
  39463. ></SPAN
  39464. > auf das Verzeichnis des
  39465.      ausgefⁿhrten Skriptes!
  39466.     </P
  39467. ><P
  39468. >      Ein Beispiel, das den Unterschied zum <VAR
  39469. CLASS="literal"
  39470. >CGI SAPI</VAR
  39471. > zeigt:
  39472.      <TABLE
  39473. BORDER="0"
  39474. BGCOLOR="#E0E0E0"
  39475. CELLPADDING="5"
  39476. ><TR
  39477. ><TD
  39478. ><PRE
  39479. CLASS="php"
  39480. ><?php
  39481. // Our simple test application named test.php
  39482. echo getcwd(), "\n";
  39483. ?></PRE
  39484. ></TD
  39485. ></TR
  39486. ></TABLE
  39487. >
  39488.     </P
  39489. ><P
  39490. >      Bei der <VAR
  39491. CLASS="literal"
  39492. >CGI</VAR
  39493. >-Version ist die Ausgabe folgende:
  39494.      <TABLE
  39495. BORDER="0"
  39496. BGCOLOR="#E0E0E0"
  39497. CELLPADDING="5"
  39498. ><TR
  39499. ><TD
  39500. ><PRE
  39501. CLASS="screen"
  39502. >$ pwd
  39503. /tmp
  39504.  
  39505. $ php -q another_directory/test.php
  39506. /tmp/another_directory</PRE
  39507. ></TD
  39508. ></TR
  39509. ></TABLE
  39510. >
  39511.      Dies zeigt deutlich, dass <VAR
  39512. CLASS="literal"
  39513. >PHP</VAR
  39514. > das aktuelle
  39515.      Verzeichnis auf das des asugefⁿhrten Skriptes Σndert.
  39516.     </P
  39517. ><P
  39518. >      Benutzen der <VAR
  39519. CLASS="literal"
  39520. >CLI SAPI</VAR
  39521. >-Version ergibt:
  39522.      <TABLE
  39523. BORDER="0"
  39524. BGCOLOR="#E0E0E0"
  39525. CELLPADDING="5"
  39526. ><TR
  39527. ><TD
  39528. ><PRE
  39529. CLASS="screen"
  39530. >$ pwd
  39531. /tmp
  39532.  
  39533. $ php -f another_directory/test.php
  39534. /tmp</PRE
  39535. ></TD
  39536. ></TR
  39537. ></TABLE
  39538. >
  39539.      Dies erlaubt eine gr÷▀ere AnpassungsfΣhigkeit beim
  39540.      Schreiben von Kommandozeilenanwendungen in <VAR
  39541. CLASS="literal"
  39542. >PHP</VAR
  39543. >.
  39544.     </P
  39545. ><DIV
  39546. CLASS="note"
  39547. ><BLOCKQUOTE
  39548. CLASS="note"
  39549. ><P
  39550. ><B
  39551. >Anmerkung: </B
  39552. >
  39553.       Das <VAR
  39554. CLASS="literal"
  39555. >CGI SAPI</VAR
  39556. > unterstⁿtzt das Verhalten des 
  39557.       <VAR
  39558. CLASS="literal"
  39559. >CLI SAPI</VAR
  39560. > anhand der Option <VAR
  39561. CLASS="literal"
  39562. >-C</VAR
  39563. >,
  39564.       wenn es auf der Kommandozeile gestartet wird.
  39565.      </P
  39566. ></BLOCKQUOTE
  39567. ></DIV
  39568. ></LI
  39569. ></UL
  39570. >
  39571.  </P
  39572. ><P
  39573. >   Die Liste der Kommandozeilenoptionen, die das <VAR
  39574. CLASS="literal"
  39575. >PHP</VAR
  39576. >-Binary
  39577.   bereitstellt, k÷nnen jederzeit abgerufen werden, wenn man
  39578.   <VAR
  39579. CLASS="literal"
  39580. >PHP</VAR
  39581. > mit der Option <VAR
  39582. CLASS="literal"
  39583. >-h</VAR
  39584. > startet:
  39585.   <TABLE
  39586. BORDER="0"
  39587. BGCOLOR="#E0E0E0"
  39588. CELLPADDING="5"
  39589. ><TR
  39590. ><TD
  39591. ><PRE
  39592. CLASS="screen"
  39593. >Usage: php [options] [-f] <file> [args...]
  39594.        php [options] -r <code> [args...]
  39595.        php [options] [-- args...]
  39596.   -s               Display colour syntax highlighted source.
  39597.   -w               Display source with stripped comments and whitespace.
  39598.   -f <file>        Parse <file>.
  39599.   -v               Version number
  39600.   -c <path>|<file> Look for php.ini file in this directory
  39601.   -a               Run interactively
  39602.   -d foo[=bar]     Define INI entry foo with value 'bar'
  39603.   -e               Generate extended information for debugger/profiler
  39604.   -z <file>        Load Zend extension <file>.
  39605.   -l               Syntax check only (lint)
  39606.   -m               Show compiled in modules
  39607.   -i               PHP information
  39608.   -r <code>        Run PHP <code> without using script tags <?..?>
  39609.   -h               This help
  39610.  
  39611.   args...          Arguments passed to script. Use -- args when first argument 
  39612.                    starts with - or script is read from stdin</PRE
  39613. ></TD
  39614. ></TR
  39615. ></TABLE
  39616. >
  39617.  </P
  39618. ><P
  39619. >   Beim <VAR
  39620. CLASS="literal"
  39621. >CLI SAPI</VAR
  39622. > gibt es drei verschiedene
  39623.   M÷glichkeiten, den zur Ausfⁿhrung bestimmten 
  39624.   <VAR
  39625. CLASS="literal"
  39626. >PHP</VAR
  39627. >-Code zu ⁿbergeben: 
  39628.   <P
  39629. ></P
  39630. ><OL
  39631. TYPE="1"
  39632. ><LI
  39633. ><P
  39634. >      <VAR
  39635. CLASS="literal"
  39636. >PHP</VAR
  39637. > mitteilen, eine bestimmte Datei auszufⁿhren.
  39638.     </P
  39639. ><P
  39640. >      <TABLE
  39641. BORDER="0"
  39642. BGCOLOR="#E0E0E0"
  39643. CELLPADDING="5"
  39644. ><TR
  39645. ><TD
  39646. ><PRE
  39647. CLASS="screen"
  39648. >php my_script.php
  39649.  
  39650. php -f my_script.php</PRE
  39651. ></TD
  39652. ></TR
  39653. ></TABLE
  39654. >
  39655.      Beide Arten (ob sie die Option <VAR
  39656. CLASS="literal"
  39657. >-f</VAR
  39658. > benutzen oder 
  39659.      nicht) fⁿhren die Datei <TT
  39660. CLASS="filename"
  39661. >my_script.php</TT
  39662. > aus.
  39663.      Sie k÷nnen eine beliebige Datei ausfⁿhren - Ihr <VAR
  39664. CLASS="literal"
  39665. >PHP</VAR
  39666. >-Skript
  39667.      muss nicht die Dateiendung <TT
  39668. CLASS="filename"
  39669. >.php</TT
  39670. > haben, sie
  39671.      kann einen beliebigen Namen und eine beliebige Endung haben.
  39672.     </P
  39673. ></LI
  39674. ><LI
  39675. ><P
  39676. >      Den <VAR
  39677. CLASS="literal"
  39678. >PHP</VAR
  39679. >-Code, der ausgefⁿhrt werden soll,
  39680.      direkt auf der Kommandozeile ⁿbergeben.
  39681.     </P
  39682. ><P
  39683. >      <TABLE
  39684. BORDER="0"
  39685. BGCOLOR="#E0E0E0"
  39686. CELLPADDING="5"
  39687. ><TR
  39688. ><TD
  39689. ><PRE
  39690. CLASS="screen"
  39691. >php -r 'print_r(get_defined_constants());'</PRE
  39692. ></TD
  39693. ></TR
  39694. ></TABLE
  39695. >
  39696.      Bezⁿglich Ersetzung von Kommandozeilenvariablen und Benutzung von
  39697.      Quotes muss besondere Vorsicht getroffen werden. 
  39698.     </P
  39699. ><DIV
  39700. CLASS="note"
  39701. ><BLOCKQUOTE
  39702. CLASS="note"
  39703. ><P
  39704. ><B
  39705. >Anmerkung: </B
  39706. >
  39707.       Betrachten Sie das Beispiel sorgfΣltig, es sind keine Start- oder 
  39708.       Endtags gesetzt. Die Option <VAR
  39709. CLASS="literal"
  39710. >-r</VAR
  39711. > ben÷tigt sie nicht.
  39712.       Werden sie dennoch verwendet, kommt es zu einem Parser-Fehler.
  39713.      </P
  39714. ></BLOCKQUOTE
  39715. ></DIV
  39716. ></LI
  39717. ><LI
  39718. ><P
  39719. >      Stellen Sie den <VAR
  39720. CLASS="literal"
  39721. >PHP</VAR
  39722. >-Code, der ausgefⁿhrt werden soll
  39723.      ⁿber den Standard-Input (<VAR
  39724. CLASS="literal"
  39725. >stdin</VAR
  39726. >) bereit.
  39727.     </P
  39728. ><P
  39729. >      Dies er÷ffnet die leistungsfΣhige M÷glichkeit,
  39730.      <VAR
  39731. CLASS="literal"
  39732. >PHP</VAR
  39733. >-Code dynamisch zu generieren und ihn dem
  39734.      <VAR
  39735. CLASS="literal"
  39736. >PHP</VAR
  39737. >-Binary zu ⁿbergeben, wie in diesem
  39738.      m÷glichem Beispiel:
  39739.      <TABLE
  39740. BORDER="0"
  39741. BGCOLOR="#E0E0E0"
  39742. CELLPADDING="5"
  39743. ><TR
  39744. ><TD
  39745. ><PRE
  39746. CLASS="screen"
  39747. >$ some_application | some_filter | php | sort -u >final_output.txt</PRE
  39748. ></TD
  39749. ></TR
  39750. ></TABLE
  39751. >
  39752.     </P
  39753. ></LI
  39754. ></OL
  39755. >
  39756.   Sie k÷nnen diese drei M÷glichkeiten zur Ausfⁿhrung nicht kombinieren.
  39757.  </P
  39758. ><P
  39759. >   Wie jede Kommandozeilenanwendung nimmt das <VAR
  39760. CLASS="literal"
  39761. >PHP</VAR
  39762. >-Binary
  39763.   etliche Argumente entegegen, aber auch ein <VAR
  39764. CLASS="literal"
  39765. >PHP</VAR
  39766. >-Skript
  39767.   kann Argumente entgegennehmen. Die Anzahl der Argumente, die an ein
  39768.   Skript ⁿbergeben werden k÷nnen, ist nicht von <VAR
  39769. CLASS="literal"
  39770. >PHP</VAR
  39771. >
  39772.   beschrΣnkt (aber die Kommandozeilenumgebung hat ein bestimmtes Gr÷ssenlimit
  39773.   fⁿr die Anzahl der Argumente, die ⁿbergeben werden k÷nnen; normalerweise
  39774.   werden Sie dieses Limit nicht erreichen). Die Argumente, die dem Skript
  39775.   ⁿbergeben werden, sind in dem globalen Array <VAR
  39776. CLASS="literal"
  39777. >$argv</VAR
  39778. >
  39779.   gespeichert. Der Null-Index enthΣlt immer den Skriptnamen (das bedeutet
  39780.   <VAR
  39781. CLASS="literal"
  39782. >-</VAR
  39783. >, wenn der <VAR
  39784. CLASS="literal"
  39785. >PHP</VAR
  39786. >-Code entweder
  39787.   von der Standardeingabe oder von der Kommandozeilenoption 
  39788.   <VAR
  39789. CLASS="literal"
  39790. >-r</VAR
  39791. > kommt). Die zweite registrierte globale
  39792.   Variable ist <VAR
  39793. CLASS="literal"
  39794. >$argc</VAR
  39795. >, die die Anzahl der Elemente
  39796.   im Array <VAR
  39797. CLASS="literal"
  39798. >$argv</VAR
  39799. > enthΣlt
  39800.   (<SPAN
  39801. CLASS="strong"
  39802. ><B
  39803. CLASS="emphasis"
  39804. >nicht</B
  39805. ></SPAN
  39806. > die Anzahl
  39807.   Argumente, die dem Skript ⁿbergeben wurden).
  39808.  </P
  39809. ><P
  39810. >   Solange die Argumente, die Sie dem Skript ⁿbergeben m÷chten, nicht
  39811.   mit dem Zeichen <VAR
  39812. CLASS="literal"
  39813. >-</VAR
  39814. > beginnen, gibt es nichts besonderes
  39815.   zu beachten. Ein Argument, das mit <VAR
  39816. CLASS="literal"
  39817. >-</VAR
  39818. > beginnt zu
  39819.   ⁿbergeben, wird Probleme bereiten, weil <VAR
  39820. CLASS="literal"
  39821. >PHP</VAR
  39822. >
  39823.   selbst denkt, dass sie verarbeitet werden muss. Benutzen Sie das
  39824.   Argument-Trennzeichen <VAR
  39825. CLASS="literal"
  39826. >--</VAR
  39827. > um das zu vermeiden.
  39828.   Nachdem dieses Trennzeichen von <VAR
  39829. CLASS="literal"
  39830. >PHP</VAR
  39831. > geparst
  39832.   wurde, wird jedes folgende Argument 
  39833.   unangetastet an das Skript weitergereicht.
  39834.  </P
  39835. ><P
  39836. >   <TABLE
  39837. BORDER="0"
  39838. BGCOLOR="#E0E0E0"
  39839. CELLPADDING="5"
  39840. ><TR
  39841. ><TD
  39842. ><PRE
  39843. CLASS="screen"
  39844. ># This will not execute the given code but will show the PHP usage
  39845. $ php -r 'var_dump($argv);' -h
  39846. Usage: php [options] [-f] <file> [args...]
  39847. [...]
  39848.  
  39849. # This will pass the '-h' argument to your script and prevent PHP from showing it's usage
  39850. $ php -r 'var_dump($argv);' -- -h
  39851. array(2) {
  39852.   [0]=>
  39853.   string(1) "-"
  39854.   [1]=>
  39855.   string(2) "-h"
  39856. }</PRE
  39857. ></TD
  39858. ></TR
  39859. ></TABLE
  39860. >
  39861.  </P
  39862. ><P
  39863. >   Dennoch gibt es einen anderen Weg, um <VAR
  39864. CLASS="literal"
  39865. >PHP</VAR
  39866. > fⁿr
  39867.   Kommandozeilenskripte zu benutzen. Sie k÷nnen ein Skript erstellen,
  39868.   in dem die erste Zeile mit <VAR
  39869. CLASS="literal"
  39870. >#!/usr/bin/php</VAR
  39871. > beginnt.
  39872.   Nachfolgend k÷nnen Sie normalen <VAR
  39873. CLASS="literal"
  39874. >PHP</VAR
  39875. >-Code innerhalb
  39876.   der <VAR
  39877. CLASS="literal"
  39878. >PHP</VAR
  39879. >-Start- und -End-Tags setzen. Sobald Sie
  39880.   die Datei ausfⁿhrbar gemacht haben (beispielsweise 
  39881.   <VAR
  39882. CLASS="literal"
  39883. >chmod +x test</VAR
  39884. >), kann Ihr Skript wie ein normales
  39885.   Kommandozeilen- oder Perlskript gestartet werden.
  39886.   <TABLE
  39887. BORDER="0"
  39888. BGCOLOR="#E0E0E0"
  39889. CELLPADDING="5"
  39890. ><TR
  39891. ><TD
  39892. ><PRE
  39893. CLASS="php"
  39894. >#!/usr/bin/php
  39895. <?php
  39896. var_dump($argv);
  39897. ?></PRE
  39898. ></TD
  39899. ></TR
  39900. ></TABLE
  39901. >
  39902.   Angenommen, die Datei heisst <TT
  39903. CLASS="filename"
  39904. >test</TT
  39905. > und befindet
  39906.   sich im aktuellen Verzeichnis, dann k÷nnen wir nun folgendes tun:
  39907.   <TABLE
  39908. BORDER="0"
  39909. BGCOLOR="#E0E0E0"
  39910. CELLPADDING="5"
  39911. ><TR
  39912. ><TD
  39913. ><PRE
  39914. CLASS="screen"
  39915. >$ chmod 755 test
  39916. $ ./test -h -- foo
  39917. array(4) {
  39918.   [0]=>
  39919.   string(6) "./test"
  39920.   [1]=>
  39921.   string(2) "-h"
  39922.   [2]=>
  39923.   string(2) "--"
  39924.   [3]=>
  39925.   string(3) "foo"
  39926. }</PRE
  39927. ></TD
  39928. ></TR
  39929. ></TABLE
  39930. >
  39931.   Wie Sie sehen k÷nnen, mⁿssen Sie sich in diesem Fall um nichts weiter
  39932.   kⁿmmern, wenn Sie Ihrem Skript Paramater, die mit <VAR
  39933. CLASS="literal"
  39934. >-</VAR
  39935. >
  39936.   beginnen, ⁿbergeben.
  39937.  </P
  39938. ><P
  39939. >   Die Langformen der Optionen sind seit PHP 4.3.3 verfⁿgbar.
  39940.   <DIV
  39941. CLASS="table"
  39942. ><A
  39943. NAME="AEN6724"
  39944. ></A
  39945. ><P
  39946. ><B
  39947. >Tabelle 39-3. Kommandozeilenoption</B
  39948. ></P
  39949. ><TABLE
  39950. BORDER="1"
  39951. CLASS="CALSTABLE"
  39952. ><COL><COL><THEAD
  39953. ><TR
  39954. ><TH
  39955. >Option</TH
  39956. ><TH
  39957. >Langform</TH
  39958. ><TH
  39959. >Beschreibung</TH
  39960. ></TR
  39961. ></THEAD
  39962. ><TBODY
  39963. ><TR
  39964. ><TD
  39965. >-s</TD
  39966. ><TD
  39967. >--syntax-highlight</TD
  39968. ><TD
  39969. >        <P
  39970. >            Den Quelltext mit farbiger Syntaxhervorhebung anzeigen.
  39971.        </P
  39972. >
  39973.        <P
  39974. >         Diese Option benutzt den internen Mechanismus zum Analysieren
  39975.         der Datei, generiert eine <VAR
  39976. CLASS="literal"
  39977. >HTML</VAR
  39978. >-Version mit
  39979.         Syntax-Highlighting davon, und schreibt sie auf die
  39980.         Standardausgabe. Beachten Sie, dass sie nur einen Block von
  39981.         <VAR
  39982. CLASS="literal"
  39983. ><code> [...] </code></VAR
  39984. >-HTML-Tags 
  39985.         erzeugt, keine HTML-Header.
  39986.        </P
  39987. >
  39988.        <DIV
  39989. CLASS="note"
  39990. ><BLOCKQUOTE
  39991. CLASS="note"
  39992. ><P
  39993. ><B
  39994. >Anmerkung: </B
  39995. >
  39996.          Diese Option funktioniert nicht zusammen mit <VAR
  39997. CLASS="literal"
  39998. >-r</VAR
  39999. >.
  40000.         </P
  40001. ></BLOCKQUOTE
  40002. ></DIV
  40003. >
  40004.       </TD
  40005. ></TR
  40006. ><TR
  40007. ><TD
  40008. >-s</TD
  40009. ><TD
  40010. >--syntax-highlighting</TD
  40011. ><TD
  40012. >        <P
  40013. >         Ein Alias fⁿr <VAR
  40014. CLASS="literal"
  40015. >--syntax-highlight</VAR
  40016. >.
  40017.        </P
  40018. >
  40019.       </TD
  40020. ></TR
  40021. ><TR
  40022. ><TD
  40023. >-w</TD
  40024. ><TD
  40025. >--strip</TD
  40026. ><TD
  40027. >        <P
  40028. >         Den Quelltext mit entfernten Kommentaren und Leerzeichen anzeigen.
  40029.        </P
  40030. >
  40031.        <DIV
  40032. CLASS="note"
  40033. ><BLOCKQUOTE
  40034. CLASS="note"
  40035. ><P
  40036. ><B
  40037. >Anmerkung: </B
  40038. >
  40039.          Diese Option funktioniert nicht zusammen mit <VAR
  40040. CLASS="literal"
  40041. >-r</VAR
  40042. >.
  40043.         </P
  40044. ></BLOCKQUOTE
  40045. ></DIV
  40046. >
  40047.       </TD
  40048. ></TR
  40049. ><TR
  40050. ><TD
  40051. >-f</TD
  40052. ><TD
  40053. >--file</TD
  40054. ><TD
  40055. >        <P
  40056. >         Parst und fⁿhrt die angegebene Datei aus. Diese Option ist nicht
  40057.         verbindlich und kann weggelassen werden. Alleinige Angabe des
  40058.         Dateinamens ist ausreichend.
  40059.        </P
  40060. >
  40061.       </TD
  40062. ></TR
  40063. ><TR
  40064. ><TD
  40065. >-v</TD
  40066. ><TD
  40067. >--version</TD
  40068. ><TD
  40069. >        <P
  40070. >         Schreibt die <VAR
  40071. CLASS="literal"
  40072. >PHP</VAR
  40073. >, <VAR
  40074. CLASS="literal"
  40075. >PHP SAPI</VAR
  40076. > und
  40077.         <VAR
  40078. CLASS="literal"
  40079. >Zend</VAR
  40080. >-Version auf die Standardausgabe. Zum Beispiel:
  40081.         <TABLE
  40082. BORDER="0"
  40083. BGCOLOR="#E0E0E0"
  40084. CELLPADDING="5"
  40085. ><TR
  40086. ><TD
  40087. ><PRE
  40088. CLASS="screen"
  40089. >$ php -v
  40090. PHP 4.3.0 (cli), Copyright (c) 1997-2002 The PHP Group
  40091. Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies</PRE
  40092. ></TD
  40093. ></TR
  40094. ></TABLE
  40095. >
  40096.        </P
  40097. >
  40098.       </TD
  40099. ></TR
  40100. ><TR
  40101. ><TD
  40102. >-c</TD
  40103. ><TD
  40104. >--php-ini</TD
  40105. ><TD
  40106. >        <P
  40107. >         Mit dieser Option kann man entweder ein Verzichnis angeben, 
  40108.         wo nach <TT
  40109. CLASS="filename"
  40110. >php.ini</TT
  40111. > gesucht werden soll, oder man kann eine
  40112.         eigene <VAR
  40113. CLASS="literal"
  40114. >INI</VAR
  40115. >-Datei direkt angeben (diese
  40116.         muss nicht <TT
  40117. CLASS="filename"
  40118. >php.ini</TT
  40119. > heissen). Zum Beispiel:
  40120.         <TABLE
  40121. BORDER="0"
  40122. BGCOLOR="#E0E0E0"
  40123. CELLPADDING="5"
  40124. ><TR
  40125. ><TD
  40126. ><PRE
  40127. CLASS="screen"
  40128. >$ php -c /custom/directory/ my_script.php
  40129.  
  40130. $ php -c /custom/directory/custom-file.ini my_script.php</PRE
  40131. ></TD
  40132. ></TR
  40133. ></TABLE
  40134. >
  40135.        </P
  40136. >
  40137.       </TD
  40138. ></TR
  40139. ><TR
  40140. ><TD
  40141. >-n</TD
  40142. ><TD
  40143. >--no-php-ini</TD
  40144. ><TD
  40145. >        <P
  40146. >         php.ini komplett ignorieren. Diese Option gibt es seit PHP 4.3.0.
  40147.        </P
  40148. >
  40149.       </TD
  40150. ></TR
  40151. ><TR
  40152. ><TD
  40153. >-d</TD
  40154. ><TD
  40155. >--define</TD
  40156. ><TD
  40157. >        <P
  40158. >         Diese Option erlaubt es Ihnen, einen eigenen Wert fⁿr eine beliebige
  40159.         in <TT
  40160. CLASS="filename"
  40161. >php.ini</TT
  40162. > erlaubte Direktive zu setzen. Die Syntax ist:
  40163.         <TABLE
  40164. BORDER="0"
  40165. BGCOLOR="#E0E0E0"
  40166. CELLPADDING="5"
  40167. ><TR
  40168. ><TD
  40169. ><PRE
  40170. CLASS="screen"
  40171. >-d configuration_directive[=value]</PRE
  40172. ></TD
  40173. ></TR
  40174. ></TABLE
  40175. >
  40176.        </P
  40177. >
  40178.        <P
  40179. >            Beispiel (Die Zeilen sind aus layouttechnischen Grⁿnden umgebrochen):
  40180.         <TABLE
  40181. BORDER="0"
  40182. BGCOLOR="#E0E0E0"
  40183. CELLPADDING="5"
  40184. ><TR
  40185. ><TD
  40186. ><PRE
  40187. CLASS="screen"
  40188. ># Omitting the value part will set the given configuration directive to "1"
  40189. $ php -d max_execution_time
  40190.         -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
  40191. string(1) "1"
  40192.  
  40193. # Passing an empty value part will set the configuration directive to ""
  40194. php -d max_execution_time=
  40195.         -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
  40196. string(0) ""
  40197.  
  40198. # The configuration directive will be set to anything passed after the '=' character
  40199. $  php -d max_execution_time=20
  40200.         -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
  40201. string(2) "20"
  40202. $  php
  40203.         -d max_execution_time=doesntmakesense
  40204.         -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
  40205. string(15) "doesntmakesense"</PRE
  40206. ></TD
  40207. ></TR
  40208. ></TABLE
  40209. >
  40210.        </P
  40211. >
  40212.       </TD
  40213. ></TR
  40214. ><TR
  40215. ><TD
  40216. >-a</TD
  40217. ><TD
  40218. >--interactive</TD
  40219. ><TD
  40220. >        <P
  40221. >         <VAR
  40222. CLASS="literal"
  40223. >PHP</VAR
  40224. > interaktiv starten.
  40225.         
  40226.        </P
  40227. >
  40228.       </TD
  40229. ></TR
  40230. ><TR
  40231. ><TD
  40232. >-e</TD
  40233. ><TD
  40234. >--profile-info</TD
  40235. ><TD
  40236. >        <P
  40237. >         Erweiterte Informationen fⁿr Debugger/Profiler erstellen.
  40238.         
  40239.        </P
  40240. >
  40241.       </TD
  40242. ></TR
  40243. ><TR
  40244. ><TD
  40245. >-z</TD
  40246. ><TD
  40247. >--zend-extension</TD
  40248. ><TD
  40249. >        <P
  40250. >         Eine <VAR
  40251. CLASS="literal"
  40252. >Zend</VAR
  40253. >-Erweiterung laden. Wenn nur ein Dateiname
  40254.         angegeben wird, versucht <VAR
  40255. CLASS="literal"
  40256. >PHP</VAR
  40257. >, die Erweiterung aus
  40258.         dem momentanen Standard-Bibliotheken-Pfad auf Ihrem System zu laden
  40259.         (auf Linux-Systemen normalerweise in
  40260.         <TT
  40261. CLASS="filename"
  40262. >/etc/ld.so.conf</TT
  40263. > angegeben). Wenn ein Dateiname mit
  40264.         absoluter Pfadinformation ⁿbergeben wird, wird der Bibliotheken-Pfad
  40265.         des Systems nicht benutzt. Ein relativer Dateiname mit 
  40266.         Pfadinformationen wird <VAR
  40267. CLASS="literal"
  40268. >PHP</VAR
  40269. > nur veranlassen,
  40270.         zu versuchen, die Erweiterung in einem Pfad relativ zum
  40271.         aktuellen Verzeichnis zu laden.
  40272.        </P
  40273. >
  40274.       </TD
  40275. ></TR
  40276. ><TR
  40277. ><TD
  40278. >-l</TD
  40279. ><TD
  40280. >--syntax-check</TD
  40281. ><TD
  40282. >        <P
  40283. >         Diese Option stellt eine angenehme Methode bereit, nur eine
  40284.         Syntaxⁿberprⁿfung auf den angegebenen <VAR
  40285. CLASS="literal"
  40286. >PHP</VAR
  40287. >-Code
  40288.         durchzufⁿhren. Bei Erfolg wird der Text <VAR
  40289. CLASS="literal"
  40290. >No syntax errors 
  40291.         detected in <filename></VAR
  40292. > auf die Standardausgabe
  40293.         geschrieben und der Rⁿckgabewert ist <VAR
  40294. CLASS="literal"
  40295. >0</VAR
  40296. >. Bei
  40297.         Misserfolg wird der Text <VAR
  40298. CLASS="literal"
  40299. >Errors parsing 
  40300.         <filename></VAR
  40301. > zusΣtzlich zur internen 
  40302.         Parser-Fehlermeldung auf der Standardausgabe
  40303.         ausgegeben und der Rⁿckgabewert auf <VAR
  40304. CLASS="literal"
  40305. >255</VAR
  40306. > gesetzt.
  40307.        </P
  40308. >
  40309.        <P
  40310. >         Diese Option wird keine Fatalen Fehler (wie undefinierte Funktionen)
  40311.         finden. Benutzen Sie die Option <VAR
  40312. CLASS="literal"
  40313. >-f</VAR
  40314. >, wenn sie
  40315.         auch diese ⁿberprⁿfen wollen.
  40316.        </P
  40317. >
  40318.        <DIV
  40319. CLASS="note"
  40320. ><BLOCKQUOTE
  40321. CLASS="note"
  40322. ><P
  40323. ><B
  40324. >Anmerkung: </B
  40325. >
  40326.          Diese Option funktioniert nicht zusammen mit <VAR
  40327. CLASS="literal"
  40328. >-r</VAR
  40329. >.
  40330.         </P
  40331. ></BLOCKQUOTE
  40332. ></DIV
  40333. >
  40334.       </TD
  40335. ></TR
  40336. ><TR
  40337. ><TD
  40338. >-m</TD
  40339. ><TD
  40340. >--modules</TD
  40341. ><TD
  40342. >        <P
  40343. >         Wird diese Option benutzt, gibt <VAR
  40344. CLASS="literal"
  40345. >PHP</VAR
  40346. > die
  40347.         eingebauten (und geladenen) <VAR
  40348. CLASS="literal"
  40349. >PHP</VAR
  40350. >- und
  40351.         <VAR
  40352. CLASS="literal"
  40353. >Zend</VAR
  40354. >-Module aus:
  40355.         <TABLE
  40356. BORDER="0"
  40357. BGCOLOR="#E0E0E0"
  40358. CELLPADDING="5"
  40359. ><TR
  40360. ><TD
  40361. ><PRE
  40362. CLASS="screen"
  40363. >$ php -m
  40364. [PHP Modules]
  40365. xml
  40366. tokenizer
  40367. standard
  40368. session
  40369. posix
  40370. pcre
  40371. overload
  40372. mysql
  40373. mbstring
  40374. ctype
  40375.  
  40376. [Zend Modules]</PRE
  40377. ></TD
  40378. ></TR
  40379. ></TABLE
  40380. >
  40381.        </P
  40382. >
  40383.       </TD
  40384. ></TR
  40385. ><TR
  40386. ><TD
  40387. >-i</TD
  40388. ><TD
  40389. >--info</TD
  40390. ><TD
  40391. >        Diese Kommandozeilenoption ruft <A
  40392. HREF="#function.phpinfo"
  40393. ><B
  40394. CLASS="function"
  40395. >phpinfo()</B
  40396. ></A
  40397. >
  40398.        auf und gibt das Ergebnis aus. Wenn <VAR
  40399. CLASS="literal"
  40400. >PHP</VAR
  40401. >
  40402.        nicht korrekt funktioniert, ist es ratsam, <VAR
  40403. CLASS="literal"
  40404. >php -i</VAR
  40405. >
  40406.        zu benutzen und nachzusehen, ob etwa Fehlermeldungen vor oder
  40407.        statt der Informationstabellen ausgegeben werden. Beachten Sie,
  40408.        dass die Ausgabe in <VAR
  40409. CLASS="literal"
  40410. >HTML</VAR
  40411. > erfolgt
  40412.        und deswegen ziemlich umfangreich ist.
  40413.       </TD
  40414. ></TR
  40415. ><TR
  40416. ><TD
  40417. >-r</TD
  40418. ><TD
  40419. >--run</TD
  40420. ><TD
  40421. >        <P
  40422. >         Diese Option erlaubt die Ausfⁿhrung von <VAR
  40423. CLASS="literal"
  40424. >PHP</VAR
  40425. >
  40426.         direkt aus der Kommandozeile. Die <VAR
  40427. CLASS="literal"
  40428. >PHP</VAR
  40429. >-Start-
  40430.         und -End-Tags (<VAR
  40431. CLASS="literal"
  40432. ><?php</VAR
  40433. > and 
  40434.         <VAR
  40435. CLASS="literal"
  40436. >?></VAR
  40437. >) werden
  40438.         <SPAN
  40439. CLASS="strong"
  40440. ><B
  40441. CLASS="emphasis"
  40442. >nicht ben÷tigt</B
  40443. ></SPAN
  40444. > und verursachen
  40445.         Parserfehler, wenn sie dennoch vorhanden sind.
  40446.        </P
  40447. >
  40448.        <DIV
  40449. CLASS="note"
  40450. ><BLOCKQUOTE
  40451. CLASS="note"
  40452. ><P
  40453. ><B
  40454. >Anmerkung: </B
  40455. >
  40456.          Man muss bei Benutzung dieser Form  von <VAR
  40457. CLASS="literal"
  40458. >PHP</VAR
  40459. >
  40460.          aufpassen, dass es zu keinen Kollisionen mit
  40461.          Kommandozeilenvariablen kommt.
  40462.         </P
  40463. ><P
  40464. >          Dieses Beispiel zeigt einen Parserfehler:
  40465.          <TABLE
  40466. BORDER="0"
  40467. BGCOLOR="#E0E0E0"
  40468. CELLPADDING="5"
  40469. ><TR
  40470. ><TD
  40471. ><PRE
  40472. CLASS="screen"
  40473. >$ php -r "$foo = get_defined_constants();"
  40474. Command line code(1) : Parse error - parse error, unexpected '='</PRE
  40475. ></TD
  40476. ></TR
  40477. ></TABLE
  40478. >
  40479.          Das Problem hier ist, dass die sh/bash Variablen auch ersetzt,
  40480.          wenn doppelte Anfⁿhrungszeichen benutzt werden (<VAR
  40481. CLASS="literal"
  40482. >"</VAR
  40483. >).
  40484.          Weil die Variable <VAR
  40485. CLASS="literal"
  40486. >$foo</VAR
  40487. > wahrscheinlich nicht
  40488.          definiert ist, passiert nichts. Der tatsΣchliche Code, der an
  40489.          <VAR
  40490. CLASS="literal"
  40491. >PHP</VAR
  40492. > ⁿbergeben wird, sieht so aus:
  40493.          <TABLE
  40494. BORDER="0"
  40495. BGCOLOR="#E0E0E0"
  40496. CELLPADDING="5"
  40497. ><TR
  40498. ><TD
  40499. ><PRE
  40500. CLASS="screen"
  40501. >$ php -r " = get_defined_constants();"</PRE
  40502. ></TD
  40503. ></TR
  40504. ></TABLE
  40505. >
  40506.          Der korrekte Weg wΣre, einfache Anfⁿhrungszeichen zu benutzen
  40507.          (<VAR
  40508. CLASS="literal"
  40509. >'</VAR
  40510. >). Variablen in einfachen Anfⁿhrungszeichen
  40511.          werden von sh/bash nicht ersetzt.
  40512.          <TABLE
  40513. BORDER="0"
  40514. BGCOLOR="#E0E0E0"
  40515. CELLPADDING="5"
  40516. ><TR
  40517. ><TD
  40518. ><PRE
  40519. CLASS="screen"
  40520. >$ php -r '$foo = get_defined_constants(); var_dump($foo);'
  40521. array(370) {
  40522.   ["E_ERROR"]=>
  40523.   int(1)
  40524.   ["E_WARNING"]=>
  40525.   int(2)
  40526.   ["E_PARSE"]=>
  40527.   int(4)
  40528.   ["E_NOTICE"]=>
  40529.   int(8)
  40530.   ["E_CORE_ERROR"]=>
  40531.   [...]</PRE
  40532. ></TD
  40533. ></TR
  40534. ></TABLE
  40535. >
  40536.          Wenn Sie eine andere Kommandozeilenumgebung als sh/bash benutzen,
  40537.          k÷nnten Sie auf weitere Probleme stossen. Sie k÷nnen gerne einen
  40538.          Bugreport anmelden oder eine Email an phpdoc@lists.php.net schreiben.
  40539.  
  40540.          Man kann dennoch leicht in Schwierigkeiten kommen, wenn man versucht, 
  40541.          Kommandozeilenvariablen zu verwenden oder mit Backslashes zu escapen.
  40542.          Sie wurden gewarnt. 
  40543.         </P
  40544. ></BLOCKQUOTE
  40545. ></DIV
  40546. >
  40547.        <DIV
  40548. CLASS="note"
  40549. ><BLOCKQUOTE
  40550. CLASS="note"
  40551. ><P
  40552. ><B
  40553. >Anmerkung: </B
  40554. >
  40555.          <VAR
  40556. CLASS="literal"
  40557. >-r</VAR
  40558. > ist nur im <SPAN
  40559. CLASS="emphasis"
  40560. ><I
  40561. CLASS="emphasis"
  40562. >CLI</I
  40563. ></SPAN
  40564. >-SAPI
  40565.          verfⁿgbar und nicht im <SPAN
  40566. CLASS="emphasis"
  40567. ><I
  40568. CLASS="emphasis"
  40569. >CGI</I
  40570. ></SPAN
  40571. >-SAPI
  40572.         </P
  40573. ></BLOCKQUOTE
  40574. ></DIV
  40575. >
  40576.       </TD
  40577. ></TR
  40578. ><TR
  40579. ><TD
  40580. >-h</TD
  40581. ><TD
  40582. >--help</TD
  40583. ><TD
  40584. >        Mit dieser Option bekommen Sie Informationen ⁿber die tatsΣchlichen
  40585.        Kommandozeilenoptionen und kurze Beschreibungen dazu.
  40586.       </TD
  40587. ></TR
  40588. ><TR
  40589. ><TD
  40590. >-?</TD
  40591. ><TD
  40592. >--usage</TD
  40593. ><TD
  40594. >        Ein Alias fⁿr <VAR
  40595. CLASS="literal"
  40596. >--help</VAR
  40597. >.
  40598.       </TD
  40599. ></TR
  40600. ></TBODY
  40601. ></TABLE
  40602. ></DIV
  40603. >
  40604.  </P
  40605. ><P
  40606. >   Die ausfⁿhrbare PHP-Version kann benutzt werden, um PHP-Skripte vollkommen
  40607.   unabhΣngig von einem Webserver auszufⁿhren. Wenn Sie auf einem UNIX-System
  40608.   arbeiten, sollten Sie Ihrem Skript eine spezielle erste Zeile hinzufⁿgen und
  40609.   es ausfⁿhrbar machen, so dass das System erkennt, welches Programm das Skript
  40610.   ausfⁿhren soll. Auf einem Windows-System k÷nnen Sie <VAR
  40611. CLASS="literal"
  40612. >php.exe</VAR
  40613. >
  40614.   mit der Doppelklick-Option von <VAR
  40615. CLASS="literal"
  40616. >.php</VAR
  40617. >-Dateien verknⁿpfen.
  40618.   Sie k÷nnen auch eine Batchdatei erzeugen, um das Skript von PHP ausfⁿhren zu
  40619.   lassen. Die erste Zeile, die dem Skript hinzugefⁿgt wird, damit es unter UNIX
  40620.   lΣuft, st÷rt unter Windows nicht, so dass Sie auf diese Weise problemlos 
  40621.   plattformⁿbergreifende Programme schreiben k÷nnen. Sie finden anschlie▀end
  40622.   ein einfaches Beispiel, wie man ein Kommandozeilenprogramm in PHP schreibt.
  40623.  </P
  40624. ><P
  40625. >   <TABLE
  40626. WIDTH="100%"
  40627. BORDER="0"
  40628. CELLPADDING="0"
  40629. CELLSPACING="0"
  40630. CLASS="EXAMPLE"
  40631. ><TR
  40632. ><TD
  40633. ><DIV
  40634. CLASS="example"
  40635. ><A
  40636. NAME="AEN6886"
  40637. ></A
  40638. ><P
  40639. ><B
  40640. >Beispiel 39-1. Ein Skript, das von der Kommandozeile aus ausgefⁿhrt werden soll (script.php)</B
  40641. ></P
  40642. ><TABLE
  40643. BORDER="0"
  40644. BGCOLOR="#E0E0E0"
  40645. CELLPADDING="5"
  40646. ><TR
  40647. ><TD
  40648. ><PRE
  40649. CLASS="php"
  40650. >#!/usr/bin/php
  40651. <?php
  40652.  
  40653. if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
  40654. ?>
  40655.  
  40656. This is a command line PHP script with one option.
  40657.  
  40658.   Usage:
  40659.   <?php echo $argv[0]; ?> <option>
  40660.  
  40661.   <option> can be some word you would like
  40662.   to print out. With the --help, -help, -h,
  40663.   or -? options, you can get this help.
  40664.  
  40665. <?php
  40666. } else {
  40667.     echo $argv[1];
  40668. }
  40669. ?></PRE
  40670. ></TD
  40671. ></TR
  40672. ></TABLE
  40673. ></DIV
  40674. ></TD
  40675. ></TR
  40676. ></TABLE
  40677. >
  40678.  </P
  40679. ><P
  40680. >   In dem oben beschriebenen Skript haben wir die erste Zeile dazu benutzt,
  40681.   anzugeben, dass die Datei von PHP ausgefⁿhrt werden soll. Wir arbeiten hier
  40682.   mit einer CLI-version, deswegen werden keine HTTP-Header ausgegeben. Es gibt
  40683.   zwei Variablen, die Sie in Kommandozeilen-Applikationen mit PHP benutzen
  40684.   k÷nnen: <VAR
  40685. CLASS="varname"
  40686. >$argc</VAR
  40687. > und <VAR
  40688. CLASS="varname"
  40689. >$argv</VAR
  40690. >. Die erste ist
  40691.   die Anzahl der Argumente plus Eins (dem Namen des laufenden Skripts). Die
  40692.   zweite ist ein Array, das die Argumente enthΣlt, beginnend mit dem Skriptnamen
  40693.   als Nummer Null (<VAR
  40694. CLASS="varname"
  40695. >$argv[0]</VAR
  40696. >).
  40697.  </P
  40698. ><P
  40699. >   In dem oben genannten Programm haben wir ⁿberprⁿft, ob es weniger oder mehr
  40700.   als zwei Argumente gibt. Falls das Argument <VAR
  40701. CLASS="literal"
  40702. >--help</VAR
  40703. >,
  40704.   <VAR
  40705. CLASS="literal"
  40706. >-help</VAR
  40707. >, <VAR
  40708. CLASS="literal"
  40709. >-h</VAR
  40710. > oder <VAR
  40711. CLASS="literal"
  40712. >-?</VAR
  40713. >
  40714.   war, haben wir die Hilfe-Nachricht mit dem dynamisch ⁿbergebenen 
  40715.   Skriptnamen ausgegeben. Wenn wir ein anderes Argument erhalten haben, haben
  40716.   wir es ausgegeben.
  40717.  </P
  40718. ><P
  40719. >   Wenn Sie das oben genannte Skript unter UNIX laufen lassen wollen, mⁿssen Sie
  40720.   es zuerst ausfⁿhrbar machen, und es danach einfach als 
  40721.   <VAR
  40722. CLASS="literal"
  40723. >script.php echothis</VAR
  40724. > oder
  40725.   <VAR
  40726. CLASS="literal"
  40727. >script.php -h</VAR
  40728. > aufrufen. Unter Windows k÷nnen Sie zu diesem
  40729.   Zweck eine Batchdatei erstellen:
  40730.  </P
  40731. ><P
  40732. >   <TABLE
  40733. WIDTH="100%"
  40734. BORDER="0"
  40735. CELLPADDING="0"
  40736. CELLSPACING="0"
  40737. CLASS="EXAMPLE"
  40738. ><TR
  40739. ><TD
  40740. ><DIV
  40741. CLASS="example"
  40742. ><A
  40743. NAME="AEN6902"
  40744. ></A
  40745. ><P
  40746. ><B
  40747. >Beispiel 39-2. Batchdatei zur Ausfⁿhrung eines Kommandozeilen-Skripts in PHP (script.bat)</B
  40748. ></P
  40749. ><TABLE
  40750. BORDER="0"
  40751. BGCOLOR="#E0E0E0"
  40752. CELLPADDING="5"
  40753. ><TR
  40754. ><TD
  40755. ><PRE
  40756. CLASS="shell"
  40757. >@c:\php\cli\php.exe script.php %1 %2 %3 %4</PRE
  40758. ></TD
  40759. ></TR
  40760. ></TABLE
  40761. ></DIV
  40762. ></TD
  40763. ></TR
  40764. ></TABLE
  40765. >
  40766.  </P
  40767. ><P
  40768. >   Angenommen, Sie haben das Programm <TT
  40769. CLASS="filename"
  40770. >script.php</TT
  40771. > genannt
  40772.   und die CLI-<TT
  40773. CLASS="filename"
  40774. >php.exe</TT
  40775. > hat den Pfad
  40776.   <TT
  40777. CLASS="filename"
  40778. >c:\php\cli\php.exe</TT
  40779. >, wird diese Batchdatei es mit den von
  40780.   Ihnen ⁿbergebnen Optionen <VAR
  40781. CLASS="literal"
  40782. >script.bat echothis</VAR
  40783. > oder
  40784.   <VAR
  40785. CLASS="literal"
  40786. >script.bat -h</VAR
  40787. > ausfⁿhren.
  40788.  </P
  40789. ><P
  40790. >   Sehen Sie sich auch die zusΣtzlichen Funktionen in der Dokumentation der 
  40791.   <A
  40792. HREF="#ref.readline"
  40793. >Readline</A
  40794. >-Extension an, um Ihre in PHP
  40795.   geschriebenen Kommandozeilenanwendungen weiterzuentwickeln.
  40796.  </P
  40797. ></DIV
  40798. ></DIV
  40799. ><DIV
  40800. CLASS="PART"
  40801. ><A
  40802. NAME="funcref"
  40803. ></A
  40804. ><DIV
  40805. CLASS="TITLEPAGE"
  40806. ><H1
  40807. CLASS="title"
  40808. >VI. Funktionsreferenz</H1
  40809. ><DIV
  40810. CLASS="TOC"
  40811. ><DL
  40812. ><DT
  40813. ><B
  40814. >Inhaltsverzeichnis</B
  40815. ></DT
  40816. ><DT
  40817. >I. <A
  40818. HREF="#ref.apache"
  40819. >Apache-spezifische Funktionen</A
  40820. ></DT
  40821. ><DT
  40822. >II. <A
  40823. HREF="#ref.array"
  40824. >Array Funktionen</A
  40825. ></DT
  40826. ><DT
  40827. >III. <A
  40828. HREF="#ref.aspell"
  40829. >Aspell Funktionen [veraltet]</A
  40830. ></DT
  40831. ><DT
  40832. >IV. <A
  40833. HREF="#ref.bc"
  40834. >Mathematische Funktionen mit beliebiger Genauigkeit</A
  40835. ></DT
  40836. ><DT
  40837. >V. <A
  40838. HREF="#ref.bzip2"
  40839. >Bzip2 Komprimierungsfunktionen</A
  40840. ></DT
  40841. ><DT
  40842. >VI. <A
  40843. HREF="#ref.calendar"
  40844. >Kalender-Funktionen</A
  40845. ></DT
  40846. ><DT
  40847. >VII. <A
  40848. HREF="#ref.ccvs"
  40849. >CCVS API Funktionen</A
  40850. ></DT
  40851. ><DT
  40852. >VIII. <A
  40853. HREF="#ref.com"
  40854. >COM Support Funktionen fⁿr Windows</A
  40855. ></DT
  40856. ><DT
  40857. >IX. <A
  40858. HREF="#ref.classobj"
  40859. >Klassen- und Objekt-Funktionen</A
  40860. ></DT
  40861. ><DT
  40862. >X. <A
  40863. HREF="#ref.cpdf"
  40864. >ClibPDF Funktionen</A
  40865. ></DT
  40866. ><DT
  40867. >XI. <A
  40868. HREF="#ref.crack"
  40869. >Crack Funktionen</A
  40870. ></DT
  40871. ><DT
  40872. >XII. <A
  40873. HREF="#ref.curl"
  40874. >cURL, Client URL Bibiothek-Funktionen</A
  40875. ></DT
  40876. ><DT
  40877. >XIII. <A
  40878. HREF="#ref.cybercash"
  40879. >Cybercash Bezahl Funktionen</A
  40880. ></DT
  40881. ><DT
  40882. >XIV. <A
  40883. HREF="#ref.cyrus"
  40884. >Cyrus IMAP administration Functions</A
  40885. ></DT
  40886. ><DT
  40887. >XV. <A
  40888. HREF="#ref.ctype"
  40889. >Character type functions</A
  40890. ></DT
  40891. ><DT
  40892. >XVI. <A
  40893. HREF="#ref.dba"
  40894. >dba Datenbank (dbm-style) Abstraktions-Funktionen</A
  40895. ></DT
  40896. ><DT
  40897. >XVII. <A
  40898. HREF="#ref.datetime"
  40899. >Datums- und Zeit-Funktionen</A
  40900. ></DT
  40901. ><DT
  40902. >XVIII. <A
  40903. HREF="#ref.dbase"
  40904. >dBase Funktionen</A
  40905. ></DT
  40906. ><DT
  40907. >XIX. <A
  40908. HREF="#ref.dbm"
  40909. >DBM Datenbankfunktionen</A
  40910. ></DT
  40911. ><DT
  40912. >XX. <A
  40913. HREF="#ref.dbx"
  40914. >dbx Funktionen</A
  40915. ></DT
  40916. ><DT
  40917. >XXI. <A
  40918. HREF="#ref.dbplus"
  40919. >DB++ Functions</A
  40920. ></DT
  40921. ><DT
  40922. >XXII. <A
  40923. HREF="#ref.dio"
  40924. >Direkte Ein-/Ausgabe Funktionen</A
  40925. ></DT
  40926. ><DT
  40927. >XXIII. <A
  40928. HREF="#ref.dir"
  40929. >Verzeichnis-Funktionen</A
  40930. ></DT
  40931. ><DT
  40932. >XXIV. <A
  40933. HREF="#ref.dom"
  40934. >DOM Functions</A
  40935. ></DT
  40936. ><DT
  40937. >XXV. <A
  40938. HREF="#ref.domxml"
  40939. >DOM XML Funktionen</A
  40940. ></DT
  40941. ><DT
  40942. >XXVI. <A
  40943. HREF="#ref.dotnet"
  40944. >.NET Funktionen</A
  40945. ></DT
  40946. ><DT
  40947. >XXVII. <A
  40948. HREF="#ref.errorfunc"
  40949. >Error Handling and Logging Functions</A
  40950. ></DT
  40951. ><DT
  40952. >XXVIII. <A
  40953. HREF="#ref.exif"
  40954. >Exif Functions</A
  40955. ></DT
  40956. ><DT
  40957. >XXIX. <A
  40958. HREF="#ref.fam"
  40959. >File Alteration Monitor Functions</A
  40960. ></DT
  40961. ><DT
  40962. >XXX. <A
  40963. HREF="#ref.fbsql"
  40964. >FrontBase Funktionen</A
  40965. ></DT
  40966. ><DT
  40967. >XXXI. <A
  40968. HREF="#ref.filepro"
  40969. >filePro Funktionen</A
  40970. ></DT
  40971. ><DT
  40972. >XXXII. <A
  40973. HREF="#ref.filesystem"
  40974. >Funktionen des Dateisystems</A
  40975. ></DT
  40976. ><DT
  40977. >XXXIII. <A
  40978. HREF="#ref.fdf"
  40979. >Forms Data Format Funktionen</A
  40980. ></DT
  40981. ><DT
  40982. >XXXIV. <A
  40983. HREF="#ref.fribidi"
  40984. >FriBiDi Funktionen</A
  40985. ></DT
  40986. ><DT
  40987. >XXXV. <A
  40988. HREF="#ref.ftp"
  40989. >FTP-Funktionen</A
  40990. ></DT
  40991. ><DT
  40992. >XXXVI. <A
  40993. HREF="#ref.funchand"
  40994. >Function Handling functions</A
  40995. ></DT
  40996. ><DT
  40997. >XXXVII. <A
  40998. HREF="#ref.gettext"
  40999. >GNU Gettext</A
  41000. ></DT
  41001. ><DT
  41002. >XXXVIII. <A
  41003. HREF="#ref.gmp"
  41004. >GMP Functions</A
  41005. ></DT
  41006. ><DT
  41007. >XXXIX. <A
  41008. HREF="#ref.http"
  41009. >HTTP functions</A
  41010. ></DT
  41011. ><DT
  41012. >XL. <A
  41013. HREF="#ref.hw"
  41014. >Hyperwave Functions</A
  41015. ></DT
  41016. ><DT
  41017. >XLI. <A
  41018. HREF="#ref.hwapi"
  41019. >Hyperwave API Functions</A
  41020. ></DT
  41021. ><DT
  41022. >XLII. <A
  41023. HREF="#ref.iconv"
  41024. >iconv Funktionen</A
  41025. ></DT
  41026. ><DT
  41027. >XLIII. <A
  41028. HREF="#ref.image"
  41029. >Grafik-Funktionen</A
  41030. ></DT
  41031. ><DT
  41032. >XLIV. <A
  41033. HREF="#ref.imap"
  41034. >IMAP, POP3 und NNTP Funktionen</A
  41035. ></DT
  41036. ><DT
  41037. >XLV. <A
  41038. HREF="#ref.ifx"
  41039. >Informix Funktionen</A
  41040. ></DT
  41041. ><DT
  41042. >XLVI. <A
  41043. HREF="#ref.ibase"
  41044. >InterBase-Funktionen</A
  41045. ></DT
  41046. ><DT
  41047. >XLVII. <A
  41048. HREF="#ref.id3"
  41049. >ID3 Functions</A
  41050. ></DT
  41051. ><DT
  41052. >XLVIII. <A
  41053. HREF="#ref.ingres"
  41054. >Ingres II Funktionen</A
  41055. ></DT
  41056. ><DT
  41057. >XLIX. <A
  41058. HREF="#ref.ircg"
  41059. >IRC Gateway Funktionen</A
  41060. ></DT
  41061. ><DT
  41062. >L. <A
  41063. HREF="#ref.java"
  41064. >Java</A
  41065. ></DT
  41066. ><DT
  41067. >LI. <A
  41068. HREF="#ref.ldap"
  41069. >LDAP Funktionen</A
  41070. ></DT
  41071. ><DT
  41072. >LII. <A
  41073. HREF="#ref.lzf"
  41074. >LZF Functions</A
  41075. ></DT
  41076. ><DT
  41077. >LIII. <A
  41078. HREF="#ref.mail"
  41079. >Mail-Funktionen</A
  41080. ></DT
  41081. ><DT
  41082. >LIV. <A
  41083. HREF="#ref.mailparse"
  41084. >mailparse Functions</A
  41085. ></DT
  41086. ><DT
  41087. >LV. <A
  41088. HREF="#ref.math"
  41089. >Mathematische Funktionen</A
  41090. ></DT
  41091. ><DT
  41092. >LVI. <A
  41093. HREF="#ref.mbstring"
  41094. >Multibyte String Functions</A
  41095. ></DT
  41096. ><DT
  41097. >LVII. <A
  41098. HREF="#ref.mcal"
  41099. >MCAL Funktionen</A
  41100. ></DT
  41101. ><DT
  41102. >LVIII. <A
  41103. HREF="#ref.mcrypt"
  41104. >Mcrypt Encryption Functions</A
  41105. ></DT
  41106. ><DT
  41107. >LIX. <A
  41108. HREF="#ref.mcve"
  41109. >MCVE Payment Functions</A
  41110. ></DT
  41111. ><DT
  41112. >LX. <A
  41113. HREF="#ref.memcache"
  41114. >Memcache Functions</A
  41115. ></DT
  41116. ><DT
  41117. >LXI. <A
  41118. HREF="#ref.mhash"
  41119. >Hash Funktionen</A
  41120. ></DT
  41121. ><DT
  41122. >LXII. <A
  41123. HREF="#ref.mime-magic"
  41124. >Mimetype Functions</A
  41125. ></DT
  41126. ><DT
  41127. >LXIII. <A
  41128. HREF="#ref.mssql"
  41129. >Microsoft SQL Server Funktionen</A
  41130. ></DT
  41131. ><DT
  41132. >LXIV. <A
  41133. HREF="#ref.ming"
  41134. >Ming functions for Flash</A
  41135. ></DT
  41136. ><DT
  41137. >LXV. <A
  41138. HREF="#ref.misc"
  41139. >Sonstige Funktionen</A
  41140. ></DT
  41141. ><DT
  41142. >LXVI. <A
  41143. HREF="#ref.mnogo"
  41144. >mnoGoSearch Funktionen</A
  41145. ></DT
  41146. ><DT
  41147. >LXVII. <A
  41148. HREF="#ref.msql"
  41149. >mSQL Funktionen</A
  41150. ></DT
  41151. ><DT
  41152. >LXVIII. <A
  41153. HREF="#ref.mysql"
  41154. >MySQL Funktionen</A
  41155. ></DT
  41156. ><DT
  41157. >LXIX. <A
  41158. HREF="#ref.mysqli"
  41159. >Verbesserte MySQL Erweiterung</A
  41160. ></DT
  41161. ><DT
  41162. >LXX. <A
  41163. HREF="#ref.msession"
  41164. >Mohawk Software Session Handler Funktionen</A
  41165. ></DT
  41166. ><DT
  41167. >LXXI. <A
  41168. HREF="#ref.muscat"
  41169. >muscat Functions</A
  41170. ></DT
  41171. ><DT
  41172. >LXXII. <A
  41173. HREF="#ref.network"
  41174. >Netzwerk Funktionen</A
  41175. ></DT
  41176. ><DT
  41177. >LXXIII. <A
  41178. HREF="#ref.ncurses"
  41179. >Ncurses Terminal Screen Control Functions</A
  41180. ></DT
  41181. ><DT
  41182. >LXXIV. <A
  41183. HREF="#ref.notes"
  41184. >Lotus Notes Functions</A
  41185. ></DT
  41186. ><DT
  41187. >LXXV. <A
  41188. HREF="#ref.nsapi"
  41189. >NSAPI-specific Functions</A
  41190. ></DT
  41191. ><DT
  41192. >LXXVI. <A
  41193. HREF="#ref.odbc"
  41194. >ODBC Funktionen</A
  41195. ></DT
  41196. ><DT
  41197. >LXXVII. <A
  41198. HREF="#ref.objaggregation"
  41199. >Object Aggregation/Composition Functions</A
  41200. ></DT
  41201. ><DT
  41202. >LXXVIII. <A
  41203. HREF="#ref.oci8"
  41204. >Oracle 8 Funktionen</A
  41205. ></DT
  41206. ><DT
  41207. >LXXIX. <A
  41208. HREF="#ref.openssl"
  41209. >OpenSSL Funktionen</A
  41210. ></DT
  41211. ><DT
  41212. >LXXX. <A
  41213. HREF="#ref.oracle"
  41214. >Oracle Funktionen</A
  41215. ></DT
  41216. ><DT
  41217. >LXXXI. <A
  41218. HREF="#ref.ovrimos"
  41219. >Ovrimos SQL Functions</A
  41220. ></DT
  41221. ><DT
  41222. >LXXXII. <A
  41223. HREF="#ref.outcontrol"
  41224. >Funktionen zur Ausgabesteuerung</A
  41225. ></DT
  41226. ><DT
  41227. >LXXXIII. <A
  41228. HREF="#ref.overload"
  41229. >Object property and method call overloading</A
  41230. ></DT
  41231. ><DT
  41232. >LXXXIV. <A
  41233. HREF="#ref.pdf"
  41234. >PDF Funktionen</A
  41235. ></DT
  41236. ><DT
  41237. >LXXXV. <A
  41238. HREF="#ref.pfpro"
  41239. >Verisign Payflow Pro Funktionen</A
  41240. ></DT
  41241. ><DT
  41242. >LXXXVI. <A
  41243. HREF="#ref.info"
  41244. >PHP Optionen & Informationen</A
  41245. ></DT
  41246. ><DT
  41247. >LXXXVII. <A
  41248. HREF="#ref.posix"
  41249. >POSIX Funktionen</A
  41250. ></DT
  41251. ><DT
  41252. >LXXXVIII. <A
  41253. HREF="#ref.pgsql"
  41254. >PostgreSQL Funktionen</A
  41255. ></DT
  41256. ><DT
  41257. >LXXXIX. <A
  41258. HREF="#ref.pcntl"
  41259. >Process Control Functions</A
  41260. ></DT
  41261. ><DT
  41262. >XC. <A
  41263. HREF="#ref.exec"
  41264. >Funktionen zur Programmausfⁿhrung</A
  41265. ></DT
  41266. ><DT
  41267. >XCI. <A
  41268. HREF="#ref.printer"
  41269. >Printer Functions</A
  41270. ></DT
  41271. ><DT
  41272. >XCII. <A
  41273. HREF="#ref.pspell"
  41274. >Pspell Funktionen</A
  41275. ></DT
  41276. ><DT
  41277. >XCIII. <A
  41278. HREF="#ref.readline"
  41279. >GNU Readline</A
  41280. ></DT
  41281. ><DT
  41282. >XCIV. <A
  41283. HREF="#ref.recode"
  41284. >GNU Recode Funktionen</A
  41285. ></DT
  41286. ><DT
  41287. >XCV. <A
  41288. HREF="#ref.pcre"
  41289. >RegulΣre Ausdrⁿcke Funktionen (Perl-kompatibel)</A
  41290. ></DT
  41291. ><DT
  41292. >XCVI. <A
  41293. HREF="#ref.qtdom"
  41294. >qtdom Functions</A
  41295. ></DT
  41296. ><DT
  41297. >XCVII. <A
  41298. HREF="#ref.regex"
  41299. >RegulΣre Ausdrⁿcke Funktionen (POSIX erweitert)</A
  41300. ></DT
  41301. ><DT
  41302. >XCVIII. <A
  41303. HREF="#ref.sem"
  41304. >Semaphor und Shared Memory Funktionen</A
  41305. ></DT
  41306. ><DT
  41307. >XCIX. <A
  41308. HREF="#ref.sesam"
  41309. >SESAM Datenbankfunktionen</A
  41310. ></DT
  41311. ><DT
  41312. >C. <A
  41313. HREF="#ref.session"
  41314. >Session Funktionen</A
  41315. ></DT
  41316. ><DT
  41317. >CI. <A
  41318. HREF="#ref.shmop"
  41319. >Shared Memory Funktionen (Gemeinsamer Speicher)</A
  41320. ></DT
  41321. ><DT
  41322. >CII. <A
  41323. HREF="#ref.simplexml"
  41324. >SimpleXML functions</A
  41325. ></DT
  41326. ><DT
  41327. >CIII. <A
  41328. HREF="#ref.soap"
  41329. >SOAP Functions</A
  41330. ></DT
  41331. ><DT
  41332. >CIV. <A
  41333. HREF="#ref.sqlite"
  41334. >SQLite</A
  41335. ></DT
  41336. ><DT
  41337. >CV. <A
  41338. HREF="#ref.swf"
  41339. >Shockwave Flash Funktionen</A
  41340. ></DT
  41341. ><DT
  41342. >CVI. <A
  41343. HREF="#ref.snmp"
  41344. >SNMP Funktionen</A
  41345. ></DT
  41346. ><DT
  41347. >CVII. <A
  41348. HREF="#ref.sockets"
  41349. >Socket Funktionen</A
  41350. ></DT
  41351. ><DT
  41352. >CVIII. <A
  41353. HREF="#ref.spl"
  41354. >Standard PHP Library (SPL) Functions</A
  41355. ></DT
  41356. ><DT
  41357. >CIX. <A
  41358. HREF="#ref.stream"
  41359. >Stream Functions</A
  41360. ></DT
  41361. ><DT
  41362. >CX. <A
  41363. HREF="#ref.strings"
  41364. >String-Funktionen</A
  41365. ></DT
  41366. ><DT
  41367. >CXI. <A
  41368. HREF="#ref.sybase"
  41369. >Sybase Funktionen</A
  41370. ></DT
  41371. ><DT
  41372. >CXII. <A
  41373. HREF="#ref.tcpwrap"
  41374. >TCP Wrappers Functions</A
  41375. ></DT
  41376. ><DT
  41377. >CXIII. <A
  41378. HREF="#ref.tidy"
  41379. >Tidy Functions</A
  41380. ></DT
  41381. ><DT
  41382. >CXIV. <A
  41383. HREF="#ref.tokenizer"
  41384. >Tokenizer Functions</A
  41385. ></DT
  41386. ><DT
  41387. >CXV. <A
  41388. HREF="#ref.url"
  41389. >URL Funktionen</A
  41390. ></DT
  41391. ><DT
  41392. >CXVI. <A
  41393. HREF="#ref.variables"
  41394. >Variablen-Funktionen</A
  41395. ></DT
  41396. ><DT
  41397. >CXVII. <A
  41398. HREF="#ref.vpopmail"
  41399. >vpopmail Functions</A
  41400. ></DT
  41401. ><DT
  41402. >CXVIII. <A
  41403. HREF="#ref.w32api"
  41404. >W32api Functions</A
  41405. ></DT
  41406. ><DT
  41407. >CXIX. <A
  41408. HREF="#ref.wddx"
  41409. >WDDX Funktionen</A
  41410. ></DT
  41411. ><DT
  41412. >CXX. <A
  41413. HREF="#ref.xml"
  41414. >XML Parser Functions</A
  41415. ></DT
  41416. ><DT
  41417. >CXXI. <A
  41418. HREF="#ref.xmlrpc"
  41419. >XML-RPC Functions</A
  41420. ></DT
  41421. ><DT
  41422. >CXXII. <A
  41423. HREF="#ref.xdiff"
  41424. >xdiff Functions</A
  41425. ></DT
  41426. ><DT
  41427. >CXXIII. <A
  41428. HREF="#ref.xsl"
  41429. >XSL functions</A
  41430. ></DT
  41431. ><DT
  41432. >CXXIV. <A
  41433. HREF="#ref.xslt"
  41434. >XSLT Funktionen</A
  41435. ></DT
  41436. ><DT
  41437. >CXXV. <A
  41438. HREF="#ref.yaz"
  41439. >YAZ Functions</A
  41440. ></DT
  41441. ><DT
  41442. >CXXVI. <A
  41443. HREF="#ref.nis"
  41444. >YP/NIS Funktionen</A
  41445. ></DT
  41446. ><DT
  41447. >CXXVII. <A
  41448. HREF="#ref.zip"
  41449. >ZIP Funktionen (Lesezugriff)</A
  41450. ></DT
  41451. ><DT
  41452. >CXXVIII. <A
  41453. HREF="#ref.zlib"
  41454. >Zlib Komprimierungsfunktionen</A
  41455. ></DT
  41456. ></DL
  41457. ></DIV
  41458. ></DIV
  41459. ><DIV
  41460. CLASS="reference"
  41461. ><A
  41462. NAME="ref.apache"
  41463. ></A
  41464. ><DIV
  41465. CLASS="TITLEPAGE"
  41466. ><H1
  41467. CLASS="title"
  41468. >I. Apache-spezifische Funktionen</H1
  41469. ><DIV
  41470. CLASS="PARTINTRO"
  41471. ><A
  41472. NAME="AEN6918"
  41473. ></A
  41474. ><DIV
  41475. CLASS="section"
  41476. ><H2
  41477. CLASS="section"
  41478. ><A
  41479. NAME="apache.intro"
  41480. >Einfⁿhrung</A
  41481. ></H2
  41482. ><P
  41483. >      Diese Funktionen stehen nur zur Verfⁿgung, wenn PHP als Apache Modul
  41484.      lΣuft.
  41485.     </P
  41486. ><DIV
  41487. CLASS="note"
  41488. ><BLOCKQUOTE
  41489. CLASS="note"
  41490. ><P
  41491. ><B
  41492. >Anmerkung: </B
  41493. >
  41494.       Die Servervariable PATH_TRANSLATED wird bei Verwendung des Apache 2 SAPI
  41495.       nicht mehr lΣnger implizit gesetzt. Im Gegensatz hierzu wird bei
  41496.       Verwendung des Apache 1 SAPI PATH_TRANSLATED, falls von Apache nicht zur
  41497.       Verfⁿgung gestellt, auf den gleichen Wert wie die Servervariable
  41498.       SCRIPT_FILENAME gesetzt. Die VerΣnderung unter Apache 2 wurde
  41499.       vorgenommen um der <A
  41500. HREF="http://hoohoo.ncsa.uiuc.edu/cgi/"
  41501. TARGET="_top"
  41502. >CGI Spezification</A
  41503. >
  41504.       zu entsprechen. Fⁿr weitere Informationen shauen Sie bitte unter
  41505.       <A
  41506. HREF="http://bugs.php.net/23610"
  41507. TARGET="_top"
  41508. >bug #23610</A
  41509. > nach.
  41510.      </P
  41511. ></BLOCKQUOTE
  41512. ></DIV
  41513. ></DIV
  41514. ><DIV
  41515. CLASS="section"
  41516. ><HR><H2
  41517. CLASS="section"
  41518. ><A
  41519. NAME="apache.installation"
  41520. >Installation</A
  41521. ></H2
  41522. ><P
  41523. >      Informationen zur Installation von PHP unter Apache finden Sie im
  41524.      Kapitel Installation unter dem
  41525.      <A
  41526. HREF="#install.apache"
  41527. >Abschnitt zu Apache</A
  41528. >
  41529.     </P
  41530. ></DIV
  41531. ><DIV
  41532. CLASS="section"
  41533. ><HR><H2
  41534. CLASS="section"
  41535. ><A
  41536. NAME="apache.configuration"
  41537. >Laufzeit Konfiguration</A
  41538. ></H2
  41539. ><P
  41540. >   Das Verhalten des Apache PHP-Moduls wird durch Einstellungen in der
  41541.   <TT
  41542. CLASS="filename"
  41543. >php.ini</TT
  41544. > beeinflusst. Konfigurationseinstellungen aus der <TT
  41545. CLASS="filename"
  41546. >php.ini</TT
  41547. > k÷nnen
  41548.   Sie durch <A
  41549. HREF="#configuration.changes.apache"
  41550. >php_flag</A
  41551. >
  41552.   Einstellungen in der Server Konfigurationsdatei oder lokal in <TT
  41553. CLASS="filename"
  41554. >.htaccess</TT
  41555. >
  41556.   Dateien ⁿberschreiben.
  41557.  </P
  41558. ><TABLE
  41559. WIDTH="100%"
  41560. BORDER="0"
  41561. CELLPADDING="0"
  41562. CELLSPACING="0"
  41563. CLASS="EXAMPLE"
  41564. ><TR
  41565. ><TD
  41566. ><DIV
  41567. CLASS="example"
  41568. ><A
  41569. NAME="AEN6937"
  41570. ></A
  41571. ><P
  41572. ><B
  41573. >Beispiel 1. Parsen von PHP fⁿr ein Verzeichnis ausschalten mittels <TT
  41574. CLASS="filename"
  41575. >.htaccess</TT
  41576. ></B
  41577. ></P
  41578. ><TABLE
  41579. BORDER="0"
  41580. BGCOLOR="#E0E0E0"
  41581. CELLPADDING="5"
  41582. ><TR
  41583. ><TD
  41584. ><PRE
  41585. CLASS="programlisting"
  41586. >php_flag engine off</PRE
  41587. ></TD
  41588. ></TR
  41589. ></TABLE
  41590. ></DIV
  41591. ></TD
  41592. ></TR
  41593. ></TABLE
  41594. ><P
  41595. >   <DIV
  41596. CLASS="table"
  41597. ><A
  41598. NAME="AEN6942"
  41599. ></A
  41600. ><P
  41601. ><B
  41602. >Tabelle 1. Apache Konfigurations Optionen</B
  41603. ></P
  41604. ><TABLE
  41605. BORDER="1"
  41606. CLASS="CALSTABLE"
  41607. ><COL><COL><COL><COL><THEAD
  41608. ><TR
  41609. ><TH
  41610. >Bezeichnung</TH
  41611. ><TH
  41612. >Grundeinstellung</TH
  41613. ><TH
  41614. >─nderbar</TH
  41615. ><TH
  41616. >Bedeutung</TH
  41617. ></TR
  41618. ></THEAD
  41619. ><TBODY
  41620. ><TR
  41621. ><TD
  41622. >engine</TD
  41623. ><TD
  41624. >On</TD
  41625. ><TD
  41626. >PHP_INI_ALL</TD
  41627. ><TD
  41628. >Parsen von PHP ein/-auschalten</TD
  41629. ></TR
  41630. ><TR
  41631. ><TD
  41632. >child_terminate</TD
  41633. ><TD
  41634. >Off</TD
  41635. ><TD
  41636. >PHP_INI_ALL</TD
  41637. ><TD
  41638. >        Gibt an, ob PHP Skripte veranlassen, dass Kindprozesse nach dem Request
  41639.        beendet werden, siehe auch <A
  41640. HREF="#function.apache-child-terminate"
  41641. ><B
  41642. CLASS="function"
  41643. >apache_child_terminate()</B
  41644. ></A
  41645. >.
  41646.       </TD
  41647. ></TR
  41648. ><TR
  41649. ><TD
  41650. >last_modified</TD
  41651. ><TD
  41652. >Off</TD
  41653. ><TD
  41654. >PHP_INI_ALL</TD
  41655. ><TD
  41656. >        Das letzte Datum der ─nderung des PHP Skripts wird als
  41657.        Last-Modified: header fⁿr diesen Request gesendet.
  41658.       </TD
  41659. ></TR
  41660. ><TR
  41661. ><TD
  41662. >xbithack</TD
  41663. ><TD
  41664. >Off</TD
  41665. ><TD
  41666. >PHP_INI_ALL</TD
  41667. ><TD
  41668. >        Dateien mit gesetztem ausfⁿhrbaren Bit werden unabhΣngig
  41669.        von ihrer Dateiendung durch PHP geparst.
  41670.       </TD
  41671. ></TR
  41672. ></TBODY
  41673. ></TABLE
  41674. ></DIV
  41675. >
  41676.  </P
  41677. ><P
  41678. >Hier eine kurze ErklΣrung der
  41679. Konfigurationsoptionen:</P
  41680. ><P
  41681. >  <P
  41682. ></P
  41683. ><DIV
  41684. CLASS="variablelist"
  41685. ><DL
  41686. ><DT
  41687. ><A
  41688. NAME="ini.engine"
  41689. ></A
  41690. ><VAR
  41691. CLASS="parameter"
  41692. >engine</VAR
  41693. >
  41694.    <A
  41695. HREF="#language.types.boolean"
  41696. ><B
  41697. CLASS="type"
  41698. >boolean</B
  41699. ></A
  41700. ></DT
  41701. ><DD
  41702. ><P
  41703. >      Diese Option ist in erster Linie nur sinnvoll, wenn PHP als
  41704.      Modul in den Apache einkompiliert wurde. Sie wird von Seiten benutzt,
  41705.      die den PHP-Parser fⁿr bestimmte Verzeichnisse oder virtuelle
  41706.      Server aus- bzw. einschalten wollen. Wenn Sie
  41707.      <KBD
  41708. CLASS="userinput"
  41709. >engine off</KBD
  41710. > in den dafⁿr vorgesehenen
  41711.      Bl÷cken in der <TT
  41712. CLASS="filename"
  41713. >httpd.conf</TT
  41714. > Datei benutzen, kann
  41715.      PHP aktiviert bzw. deaktiviert werden.
  41716.     </P
  41717. ></DD
  41718. ></DL
  41719. ></DIV
  41720. >
  41721.  </P
  41722. ></DIV
  41723. ><DIV
  41724. CLASS="section"
  41725. ><HR><H2
  41726. CLASS="section"
  41727. ><A
  41728. NAME="apache.resources"
  41729. >Resource Typen</A
  41730. ></H2
  41731. ><P
  41732. >Diese Erweiterung definiert keine Resource-Typen.</P
  41733. ></DIV
  41734. ><DIV
  41735. CLASS="section"
  41736. ><HR><H2
  41737. CLASS="section"
  41738. ><A
  41739. NAME="apache.constants"
  41740. >Vordefinierte Konstanten</A
  41741. ></H2
  41742. ><P
  41743. >Diese Erweiterung definiert keine Konstanten.</P
  41744. ></DIV
  41745. ></DIV
  41746. ><DIV
  41747. CLASS="TOC"
  41748. ><DL
  41749. ><DT
  41750. ><B
  41751. >Inhaltsverzeichnis</B
  41752. ></DT
  41753. ><DT
  41754. ><A
  41755. HREF="#function.apache-child-terminate"
  41756. >apache_child_terminate</A
  41757. > -- Beendet einen Apache Prozess nach der Anfrage</DT
  41758. ><DT
  41759. ><A
  41760. HREF="#function.apache-get-modules"
  41761. >apache_get_modules</A
  41762. > -- 
  41763.      Liste der geladenen Apachemodule
  41764.     </DT
  41765. ><DT
  41766. ><A
  41767. HREF="#function.apache-get-version"
  41768. >apache_get_version</A
  41769. > -- 
  41770.      Liefert die Version von Apache
  41771.     </DT
  41772. ><DT
  41773. ><A
  41774. HREF="#function.apache-getenv"
  41775. >apache_getenv</A
  41776. > -- 
  41777.      Get an Apache subprocess_env variable
  41778.     </DT
  41779. ><DT
  41780. ><A
  41781. HREF="#function.apache-lookup-uri"
  41782. >apache_lookup_uri</A
  41783. > -- 
  41784.      Fⁿhrt eine Teilanfrage fⁿr eine URI durch und liefert alle
  41785.      Informationen darⁿber zurⁿck.
  41786.     </DT
  41787. ><DT
  41788. ><A
  41789. HREF="#function.apache-note"
  41790. >apache_note</A
  41791. > -- Setzt und liest Apache Notes</DT
  41792. ><DT
  41793. ><A
  41794. HREF="#function.apache-request-headers"
  41795. >apache_request_headers</A
  41796. > -- Liefert alle HTTP-Header der aktuellen Anfrage</DT
  41797. ><DT
  41798. ><A
  41799. HREF="#function.apache-response-headers"
  41800. >apache_response_headers</A
  41801. > -- 
  41802.      Liefert alle HTTP-Antwort Header
  41803.     </DT
  41804. ><DT
  41805. ><A
  41806. HREF="#function.apache-setenv"
  41807. >apache_setenv</A
  41808. > -- Setzt eine Apache subprocess_env Variable</DT
  41809. ><DT
  41810. ><A
  41811. HREF="#function.ascii2ebcdic"
  41812. >ascii2ebcdic</A
  41813. > -- Zeichenkette von ASCII in EBCDIC ⁿbersetzen</DT
  41814. ><DT
  41815. ><A
  41816. HREF="#function.ebcdic2ascii"
  41817. >ebcdic2ascii</A
  41818. > -- Zeichenkette von EBCDIC in ASCII ⁿbersetzen</DT
  41819. ><DT
  41820. ><A
  41821. HREF="#function.getallheaders"
  41822. >getallheaders</A
  41823. > -- 
  41824.      Liefert alle HTTP-Header der aktuellen Anfrage aus
  41825.     </DT
  41826. ><DT
  41827. ><A
  41828. HREF="#function.virtual"
  41829. >virtual</A
  41830. > -- Fⁿhrt eine Apache-Unteranfrage durch</DT
  41831. ></DL
  41832. ></DIV
  41833. ></DIV
  41834. ><H1
  41835. ><A
  41836. NAME="function.apache-child-terminate"
  41837. ></A
  41838. >apache_child_terminate</H1
  41839. ><DIV
  41840. CLASS="refnamediv"
  41841. ><A
  41842. NAME="AEN6991"
  41843. ></A
  41844. ><P
  41845. >    (PHP 4 >= 4.0.5, PHP 5)</P
  41846. >apache_child_terminate -- Beendet einen Apache Prozess nach der Anfrage</DIV
  41847. ><DIV
  41848. CLASS="refsect1"
  41849. ><A
  41850. NAME="AEN6994"
  41851. ></A
  41852. ><H2
  41853. >Beschreibung</H2
  41854. >bool <B
  41855. CLASS="methodname"
  41856. >apache_child_terminate</B
  41857. > ( void )<BR
  41858. ></BR
  41859. ><P
  41860. >      <B
  41861. CLASS="function"
  41862. >apache_child_terminate()</B
  41863. > beendet den Apache Prozess,
  41864.      der die aktuelle PHP-Anfrage ausfⁿhrt, nachdem diese vollstΣndig
  41865.      ausgefⁿhrt wurde. Sie k÷nnen diese Funktion benutzen, nachdem Sie ein
  41866.      Skript mit hohem Speicherverbrauch ausgefⁿhrt haben. Der verbrauchte
  41867.      Speicher wird gew÷hnlich nur intern, aber nicht fⁿr das Betriebsystem,
  41868.      freigegeben.
  41869.     </P
  41870. ><DIV
  41871. CLASS="note"
  41872. ><BLOCKQUOTE
  41873. CLASS="note"
  41874. ><P
  41875. ><B
  41876. >Anmerkung: </B
  41877. >
  41878.       Die Verfⁿgbarkeit dieses Features wird durch die Anweisung
  41879.       <VAR
  41880. CLASS="option"
  41881. >child_terminate</VAR
  41882. > in der <TT
  41883. CLASS="filename"
  41884. >php.ini</TT
  41885. > beeinflusst.
  41886.       Die Standardeinstellung ist <VAR
  41887. CLASS="literal"
  41888. >off</VAR
  41889. >.
  41890.      </P
  41891. ><P
  41892. >       Dieses Feature steht bei multithreaded Versionen von Apache, wie der win32
  41893.       Version, nicht zur Verfⁿgung.
  41894.      </P
  41895. ></BLOCKQUOTE
  41896. ></DIV
  41897. ><P
  41898. >      Siehe auch <A
  41899. HREF="#function.exit"
  41900. ><B
  41901. CLASS="function"
  41902. >exit()</B
  41903. ></A
  41904. >.
  41905.     </P
  41906. ></DIV
  41907. ><H1
  41908. ><A
  41909. NAME="function.apache-get-modules"
  41910. ></A
  41911. >apache_get_modules</H1
  41912. ><DIV
  41913. CLASS="refnamediv"
  41914. ><A
  41915. NAME="AEN7011"
  41916. ></A
  41917. ><P
  41918. >    (PHP 4 >= 4.3.2, PHP 5)</P
  41919. >apache_get_modules -- 
  41920.      Liste der geladenen Apachemodule
  41921.     </DIV
  41922. ><DIV
  41923. CLASS="refsect1"
  41924. ><A
  41925. NAME="AEN7014"
  41926. ></A
  41927. ><H2
  41928. >Beschreibung</H2
  41929. >array <B
  41930. CLASS="methodname"
  41931. >apache_get_modules</B
  41932. > ( void )<BR
  41933. ></BR
  41934. ><P
  41935. >      Diese Funktion liefert Ihnen ein Array mit allen geladenen Apachemodulen.
  41936.     </P
  41937. ><P
  41938. >      <TABLE
  41939. WIDTH="100%"
  41940. BORDER="0"
  41941. CELLPADDING="0"
  41942. CELLSPACING="0"
  41943. CLASS="EXAMPLE"
  41944. ><TR
  41945. ><TD
  41946. ><DIV
  41947. CLASS="example"
  41948. ><A
  41949. NAME="AEN7022"
  41950. ></A
  41951. ><P
  41952. ><B
  41953. >Beispiel 1. <B
  41954. CLASS="function"
  41955. >apache_get_modules()</B
  41956. > Beispiel</B
  41957. ></P
  41958. ><TABLE
  41959. BORDER="0"
  41960. BGCOLOR="#E0E0E0"
  41961. CELLPADDING="5"
  41962. ><TR
  41963. ><TD
  41964. ><PRE
  41965. CLASS="php"
  41966. ><?php
  41967. print_r(apache_get_modules());
  41968. ?></PRE
  41969. ></TD
  41970. ></TR
  41971. ></TABLE
  41972. ><P
  41973. >        Die Ausgabe des obigen Programms sieht ├ñhnlich wie folgt aus:
  41974.       </P
  41975. ><TABLE
  41976. BORDER="0"
  41977. BGCOLOR="#E0E0E0"
  41978. CELLPADDING="5"
  41979. ><TR
  41980. ><TD
  41981. ><PRE
  41982. CLASS="screen"
  41983. >Array
  41984. (
  41985.     [0] => core
  41986.     [1] => http_core
  41987.     [2] => mod_so
  41988.     [3] => sapi_apache2
  41989.     [4] => mod_mime
  41990.     [5] => mod_rewrite
  41991. )</PRE
  41992. ></TD
  41993. ></TR
  41994. ></TABLE
  41995. ></DIV
  41996. ></TD
  41997. ></TR
  41998. ></TABLE
  41999. >
  42000.     </P
  42001. ></DIV
  42002. ><H1
  42003. ><A
  42004. NAME="function.apache-get-version"
  42005. ></A
  42006. >apache_get_version</H1
  42007. ><DIV
  42008. CLASS="refnamediv"
  42009. ><A
  42010. NAME="AEN7029"
  42011. ></A
  42012. ><P
  42013. >    (PHP 4 >= 4.3.2, PHP 5)</P
  42014. >apache_get_version -- 
  42015.      Liefert die Version von Apache
  42016.     </DIV
  42017. ><DIV
  42018. CLASS="refsect1"
  42019. ><A
  42020. NAME="AEN7032"
  42021. ></A
  42022. ><H2
  42023. >Beschreibung</H2
  42024. >string <B
  42025. CLASS="methodname"
  42026. >apache_get_version</B
  42027. > ( void )<BR
  42028. ></BR
  42029. ><P
  42030. >      <B
  42031. CLASS="function"
  42032. >apache_get_version()</B
  42033. > gibt die Apache-Version als
  42034.      Zeichenkette zurⁿck, oder <TT
  42035. CLASS="constant"
  42036. ><B
  42037. >FALSE</B
  42038. ></TT
  42039. > bei einem Fehler.
  42040.     </P
  42041. ><TABLE
  42042. WIDTH="100%"
  42043. BORDER="0"
  42044. CELLPADDING="0"
  42045. CELLSPACING="0"
  42046. CLASS="EXAMPLE"
  42047. ><TR
  42048. ><TD
  42049. ><DIV
  42050. CLASS="example"
  42051. ><A
  42052. NAME="AEN7041"
  42053. ></A
  42054. ><P
  42055. ><B
  42056. >Beispiel 1. <B
  42057. CLASS="function"
  42058. >apache_get_version()</B
  42059. > Beispiel</B
  42060. ></P
  42061. ><TABLE
  42062. BORDER="0"
  42063. BGCOLOR="#E0E0E0"
  42064. CELLPADDING="5"
  42065. ><TR
  42066. ><TD
  42067. ><PRE
  42068. CLASS="php"
  42069. ><?php
  42070. $version = apache_get_version();
  42071. echo "$version\n";
  42072. ?></PRE
  42073. ></TD
  42074. ></TR
  42075. ></TABLE
  42076. ><P
  42077. >       Die Ausgabe des obigen Programms sieht Σhnlich wie folgt aus:
  42078.      </P
  42079. ><TABLE
  42080. BORDER="0"
  42081. BGCOLOR="#E0E0E0"
  42082. CELLPADDING="5"
  42083. ><TR
  42084. ><TD
  42085. ><PRE
  42086. CLASS="screen"
  42087. >Apache/1.3.29 (Unix) PHP/4.3.4</PRE
  42088. ></TD
  42089. ></TR
  42090. ></TABLE
  42091. ></DIV
  42092. ></TD
  42093. ></TR
  42094. ></TABLE
  42095. ><P
  42096. >      Siehe auch <A
  42097. HREF="#function.phpinfo"
  42098. ><B
  42099. CLASS="function"
  42100. >phpinfo()</B
  42101. ></A
  42102. >.
  42103.     </P
  42104. ></DIV
  42105. ><H1
  42106. ><A
  42107. NAME="function.apache-getenv"
  42108. ></A
  42109. >apache_getenv</H1
  42110. ><DIV
  42111. CLASS="refnamediv"
  42112. ><A
  42113. NAME="AEN7050"
  42114. ></A
  42115. ><P
  42116. >    (PHP 4 >= 4.3.0, PHP 5)</P
  42117. >apache_getenv -- 
  42118.      Get an Apache subprocess_env variable
  42119.     </DIV
  42120. ><DIV
  42121. CLASS="refsect1"
  42122. ><A
  42123. NAME="AEN7053"
  42124. ></A
  42125. ><H2
  42126. >Description</H2
  42127. >string <B
  42128. CLASS="methodname"
  42129. >apache_getenv</B
  42130. > ( string variable [, bool walk_to_top])<BR
  42131. ></BR
  42132. ><DIV
  42133. CLASS="warning"
  42134. ><P
  42135. ></P
  42136. ><TABLE
  42137. CLASS="warning"
  42138. BORDER="1"
  42139. WIDTH="100%"
  42140. ><TR
  42141. ><TD
  42142. ALIGN="CENTER"
  42143. ><B
  42144. >Warnung</B
  42145. ></TD
  42146. ></TR
  42147. ><TR
  42148. ><TD
  42149. ALIGN="LEFT"
  42150. ><P
  42151. >Diese Funktion ist bis jetzt
  42152. nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfⁿgung.
  42153. </P
  42154. ></TD
  42155. ></TR
  42156. ></TABLE
  42157. ></DIV
  42158. ></DIV
  42159. ><H1
  42160. ><A
  42161. NAME="function.apache-lookup-uri"
  42162. ></A
  42163. >apache_lookup_uri</H1
  42164. ><DIV
  42165. CLASS="refnamediv"
  42166. ><A
  42167. NAME="AEN7067"
  42168. ></A
  42169. ><P
  42170. >    (PHP 3>= 3.0.4, PHP 4 , PHP 5)</P
  42171. >apache_lookup_uri -- 
  42172.      Fⁿhrt eine Teilanfrage fⁿr eine URI durch und liefert alle
  42173.      Informationen darⁿber zurⁿck.
  42174.     </DIV
  42175. ><DIV
  42176. CLASS="refsect1"
  42177. ><A
  42178. NAME="AEN7070"
  42179. ></A
  42180. ><H2
  42181. >Beschreibung</H2
  42182. >object <B
  42183. CLASS="methodname"
  42184. >apache_lookup_uri</B
  42185. > ( string Dateiname)<BR
  42186. ></BR
  42187. ><P
  42188. >      <B
  42189. CLASS="function"
  42190. >apache_lookup_uri()</B
  42191. > fⁿhrt eine Teilanfrage
  42192.      ⁿber eine bestimmte URI durch. Die Abfrage geht gerade soweit,
  42193.      dass alle wichtigen Informationen ⁿber die gegebene Quelle
  42194.      gesammelt werden k÷nnen. Als Resultat wird eine Klasse
  42195.      zurⁿckgeliefert, die folgende Elemente enthΣlt:
  42196.      <P
  42197. ></P
  42198. ><TABLE
  42199. BORDER="0"
  42200. ><TBODY
  42201. ><TR
  42202. ><TD
  42203. >status</TD
  42204. ></TR
  42205. ><TR
  42206. ><TD
  42207. >the_request</TD
  42208. ></TR
  42209. ><TR
  42210. ><TD
  42211. >status_line</TD
  42212. ></TR
  42213. ><TR
  42214. ><TD
  42215. >method</TD
  42216. ></TR
  42217. ><TR
  42218. ><TD
  42219. >content_type</TD
  42220. ></TR
  42221. ><TR
  42222. ><TD
  42223. >handler</TD
  42224. ></TR
  42225. ><TR
  42226. ><TD
  42227. >uri</TD
  42228. ></TR
  42229. ><TR
  42230. ><TD
  42231. >filename</TD
  42232. ></TR
  42233. ><TR
  42234. ><TD
  42235. >path_info</TD
  42236. ></TR
  42237. ><TR
  42238. ><TD
  42239. >args</TD
  42240. ></TR
  42241. ><TR
  42242. ><TD
  42243. >boundary</TD
  42244. ></TR
  42245. ><TR
  42246. ><TD
  42247. >no_cache</TD
  42248. ></TR
  42249. ><TR
  42250. ><TD
  42251. >no_local_copy</TD
  42252. ></TR
  42253. ><TR
  42254. ><TD
  42255. >allowed</TD
  42256. ></TR
  42257. ><TR
  42258. ><TD
  42259. >send_bodyct</TD
  42260. ></TR
  42261. ><TR
  42262. ><TD
  42263. >bytes_sent</TD
  42264. ></TR
  42265. ><TR
  42266. ><TD
  42267. >byterange</TD
  42268. ></TR
  42269. ><TR
  42270. ><TD
  42271. >clength</TD
  42272. ></TR
  42273. ><TR
  42274. ><TD
  42275. >unparsed_uri</TD
  42276. ></TR
  42277. ><TR
  42278. ><TD
  42279. >mtime</TD
  42280. ></TR
  42281. ><TR
  42282. ><TD
  42283. >request_time</TD
  42284. ></TR
  42285. ></TBODY
  42286. ></TABLE
  42287. ><P
  42288. ></P
  42289. >
  42290.     </P
  42291. ><P
  42292. >      <TABLE
  42293. WIDTH="100%"
  42294. BORDER="0"
  42295. CELLPADDING="0"
  42296. CELLSPACING="0"
  42297. CLASS="EXAMPLE"
  42298. ><TR
  42299. ><TD
  42300. ><DIV
  42301. CLASS="example"
  42302. ><A
  42303. NAME="AEN7103"
  42304. ></A
  42305. ><P
  42306. ><B
  42307. >Beispiel 1. <B
  42308. CLASS="function"
  42309. >apache_lookup_uri()</B
  42310. > Beispiel</B
  42311. ></P
  42312. ><TABLE
  42313. BORDER="0"
  42314. BGCOLOR="#E0E0E0"
  42315. CELLPADDING="5"
  42316. ><TR
  42317. ><TD
  42318. ><PRE
  42319. CLASS="php"
  42320. ><?php
  42321. $info = apache_lookup_uri('index.php?var=value');
  42322. print_r($info);
  42323.  
  42324. if (file_exists($info->filename)) {
  42325.     echo 'file exists!';
  42326. }
  42327. ?></PRE
  42328. ></TD
  42329. ></TR
  42330. ></TABLE
  42331. ><P
  42332. >        Die Ausgabe des obigen Beispiel sieht so Σhnlich aus wie folgt:
  42333.       </P
  42334. ><TABLE
  42335. BORDER="0"
  42336. BGCOLOR="#E0E0E0"
  42337. CELLPADDING="5"
  42338. ><TR
  42339. ><TD
  42340. ><PRE
  42341. CLASS="screen"
  42342. >stdClass Object
  42343. (
  42344.     [status] => 200
  42345.     [the_request] => GET /dir/file.php HTTP/1.1
  42346.     [method] => GET
  42347.     [mtime] => 0
  42348.     [clength] => 0
  42349.     [chunked] => 0
  42350.     [content_type] => application/x-httpd-php
  42351.     [no_cache] => 0
  42352.     [no_local_copy] => 1
  42353.     [unparsed_uri] => /dir/index.php?var=value
  42354.     [uri] => /dir/index.php
  42355.     [filename] => /home/htdocs/dir/index.php
  42356.     [args] => var=value
  42357.     [allowed] => 0
  42358.     [sent_bodyct] => 0
  42359.     [bytes_sent] => 0
  42360.     [request_time] => 1074282764
  42361. )
  42362. file exists!</PRE
  42363. ></TD
  42364. ></TR
  42365. ></TABLE
  42366. ></DIV
  42367. ></TD
  42368. ></TR
  42369. ></TABLE
  42370. >
  42371.     </P
  42372. ><DIV
  42373. CLASS="note"
  42374. ><BLOCKQUOTE
  42375. CLASS="note"
  42376. ><P
  42377. ><B
  42378. >Anmerkung: </B
  42379. >
  42380.       <B
  42381. CLASS="function"
  42382. >apache_lookup_uri()</B
  42383. > funktioniert nur, wenn PHP
  42384.       als Apache-Modul eingerichtet wurde.
  42385.      </P
  42386. ></BLOCKQUOTE
  42387. ></DIV
  42388. ></DIV
  42389. ><H1
  42390. ><A
  42391. NAME="function.apache-note"
  42392. ></A
  42393. >apache_note</H1
  42394. ><DIV
  42395. CLASS="refnamediv"
  42396. ><A
  42397. NAME="AEN7113"
  42398. ></A
  42399. ><P
  42400. >    (PHP 3>= 3.0.2, PHP 4 , PHP 5)</P
  42401. >apache_note -- Setzt und liest Apache Notes</DIV
  42402. ><DIV
  42403. CLASS="refsect1"
  42404. ><A
  42405. NAME="AEN7116"
  42406. ></A
  42407. ><H2
  42408. >Beschreibung</H2
  42409. >string <B
  42410. CLASS="methodname"
  42411. >apache_note</B
  42412. > ( string note_name [, string note_value])<BR
  42413. ></BR
  42414. ><P
  42415. >      <B
  42416. CLASS="function"
  42417. >apache_note()</B
  42418. > ist eine Apache-spezifische
  42419.      Funktion, die EintrΣge in Apaches
  42420.      <VAR
  42421. CLASS="literal"
  42422. >notes</VAR
  42423. >-Tabelle setzt und ausliest. Wenn sie mit
  42424.      einem einzelnen Parameter aufgerufen wird, gibt sie den aktuellen
  42425.      Wert der Note <VAR
  42426. CLASS="parameter"
  42427. >note_name</VAR
  42428. > zurⁿck. Bei zwei
  42429.      Parametern wird der Eintrag <VAR
  42430. CLASS="parameter"
  42431. >note_name</VAR
  42432. > auf
  42433.      den zweiten Parameter <VAR
  42434. CLASS="parameter"
  42435. >note_value</VAR
  42436. > gesetzt
  42437.      und liefert den bisherigen Wert zurⁿck.
  42438.     </P
  42439. ></DIV
  42440. ><H1
  42441. ><A
  42442. NAME="function.apache-request-headers"
  42443. ></A
  42444. >apache_request_headers</H1
  42445. ><DIV
  42446. CLASS="refnamediv"
  42447. ><A
  42448. NAME="AEN7134"
  42449. ></A
  42450. ><P
  42451. >    (PHP 4 >= 4.3.0, PHP 5)</P
  42452. >apache_request_headers -- Liefert alle HTTP-Header der aktuellen Anfrage</DIV
  42453. ><DIV
  42454. CLASS="refsect1"
  42455. ><A
  42456. NAME="AEN7137"
  42457. ></A
  42458. ><H2
  42459. >Beschreibung</H2
  42460. >array <B
  42461. CLASS="methodname"
  42462. >apache_request_headers</B
  42463. > ( void )<BR
  42464. ></BR
  42465. ><P
  42466. >      Die Funktion <B
  42467. CLASS="function"
  42468. >apache_request_headers()</B
  42469. > liefert ein
  42470.      assoziatives Array zurⁿck, das alle HTTP-Header-Informationen der
  42471.      aktuellen HTTP-Anfrage enthΣlt. Diese Funktion wird nur untersstⁿtzt,
  42472.      wenn PHP als Modul fⁿr <SPAN
  42473. CLASS="productname"
  42474. >Apache</SPAN
  42475. > lΣuft.
  42476.     </P
  42477. ><P
  42478. >      <TABLE
  42479. WIDTH="100%"
  42480. BORDER="0"
  42481. CELLPADDING="0"
  42482. CELLSPACING="0"
  42483. CLASS="EXAMPLE"
  42484. ><TR
  42485. ><TD
  42486. ><DIV
  42487. CLASS="example"
  42488. ><A
  42489. NAME="AEN7147"
  42490. ></A
  42491. ><P
  42492. ><B
  42493. >Beispiel 1. <B
  42494. CLASS="function"
  42495. >apache_request_headers()</B
  42496. > Beispiel</B
  42497. ></P
  42498. ><TABLE
  42499. BORDER="0"
  42500. BGCOLOR="#E0E0E0"
  42501. CELLPADDING="5"
  42502. ><TR
  42503. ><TD
  42504. ><PRE
  42505. CLASS="php"
  42506. ><?php
  42507. $headers = apache_request_headers();
  42508.  
  42509. foreach ($headers as $header => $value) {
  42510.     echo "$header: $value <br />\n";
  42511. }
  42512. ?></PRE
  42513. ></TD
  42514. ></TR
  42515. ></TABLE
  42516. ></DIV
  42517. ></TD
  42518. ></TR
  42519. ></TABLE
  42520. >
  42521.     </P
  42522. ><DIV
  42523. CLASS="note"
  42524. ><BLOCKQUOTE
  42525. CLASS="note"
  42526. ><P
  42527. ><B
  42528. >Anmerkung: </B
  42529. >
  42530.       In frⁿheren Versionen als PHP 4.3.0 hie▀ die Funktion
  42531.       <B
  42532. CLASS="function"
  42533. >apache_request_headers()</B
  42534. >
  42535.       <A
  42536. HREF="#function.getallheaders"
  42537. ><B
  42538. CLASS="function"
  42539. >getallheaders()</B
  42540. ></A
  42541. >. Mit PHP 4.3.0 ist
  42542.       <A
  42543. HREF="#function.getallheaders"
  42544. ><B
  42545. CLASS="function"
  42546. >getallheaders()</B
  42547. ></A
  42548. > ein Alias fⁿr
  42549.       <B
  42550. CLASS="function"
  42551. >apache_request_headers()</B
  42552. >.
  42553.      </P
  42554. ></BLOCKQUOTE
  42555. ></DIV
  42556. ><DIV
  42557. CLASS="note"
  42558. ><BLOCKQUOTE
  42559. CLASS="note"
  42560. ><P
  42561. ><B
  42562. >Anmerkung: </B
  42563. >
  42564.       Die Werte der gebrΣuchlichsten CGI-Variablen k÷nnen Sie auch durch das
  42565.       Auslesen der Umgebungsvariablen erhalten. Dieser Weg funktioniert
  42566.       unabhΣngig davon, ob Sie PHP als Modul fⁿr
  42567.       <SPAN
  42568. CLASS="productname"
  42569. >Apache</SPAN
  42570. > benutzen.
  42571.       Benutzen Sie <A
  42572. HREF="#function.phpinfo"
  42573. ><B
  42574. CLASS="function"
  42575. >phpinfo()</B
  42576. ></A
  42577. >, um eine Liste aller zur
  42578.       Verfⁿgung stehenden
  42579.       <A
  42580. HREF="#language.variables.predefined"
  42581. >Umgebungsvariablen</A
  42582. >
  42583.       zu erhalten.
  42584.      </P
  42585. ></BLOCKQUOTE
  42586. ></DIV
  42587. ><DIV
  42588. CLASS="note"
  42589. ><BLOCKQUOTE
  42590. CLASS="note"
  42591. ><P
  42592. ><B
  42593. >Anmerkung: </B
  42594. >Ab PHP 4.3.3 k÷nnen Sie diese
  42595. Funktion auch mit dem <A
  42596. HREF="#ref.nsapi"
  42597. >NSAPI Server Modul</A
  42598. > fⁿr
  42599. Netscape/iPlanet/SunONE Webserver nutzen.</P
  42600. ></BLOCKQUOTE
  42601. ></DIV
  42602. ><P
  42603. >      Siehe auch <A
  42604. HREF="#function.apache-response-headers"
  42605. ><B
  42606. CLASS="function"
  42607. >apache_response_headers()</B
  42608. ></A
  42609. >.
  42610.     </P
  42611. ></DIV
  42612. ><H1
  42613. ><A
  42614. NAME="function.apache-response-headers"
  42615. ></A
  42616. >apache_response_headers</H1
  42617. ><DIV
  42618. CLASS="refnamediv"
  42619. ><A
  42620. NAME="AEN7168"
  42621. ></A
  42622. ><P
  42623. >    (PHP 4 >= 4.3.0, PHP 5)</P
  42624. >apache_response_headers -- 
  42625.      Liefert alle HTTP-Antwort Header
  42626.     </DIV
  42627. ><DIV
  42628. CLASS="refsect1"
  42629. ><A
  42630. NAME="AEN7171"
  42631. ></A
  42632. ><H2
  42633. >Beschreibung</H2
  42634. >array <B
  42635. CLASS="methodname"
  42636. >apache_response_headers</B
  42637. > ( void )<BR
  42638. ></BR
  42639. ><P
  42640. >      Rⁿckgabewert: ein assoziatives Array mit allen Apache-Antwort Headern.
  42641.     </P
  42642. ><P
  42643. >      Siehe auch <A
  42644. HREF="#function.apache-request-headers"
  42645. ><B
  42646. CLASS="function"
  42647. >apache_request_headers()</B
  42648. ></A
  42649. > und
  42650.      <A
  42651. HREF="#function.headers-sent"
  42652. ><B
  42653. CLASS="function"
  42654. >headers_sent()</B
  42655. ></A
  42656. >.
  42657.     </P
  42658. ><DIV
  42659. CLASS="note"
  42660. ><BLOCKQUOTE
  42661. CLASS="note"
  42662. ><P
  42663. ><B
  42664. >Anmerkung: </B
  42665. >Ab PHP 4.3.3 k÷nnen Sie diese
  42666. Funktion auch mit dem <A
  42667. HREF="#ref.nsapi"
  42668. >NSAPI Server Modul</A
  42669. > fⁿr
  42670. Netscape/iPlanet/SunONE Webserver nutzen.</P
  42671. ></BLOCKQUOTE
  42672. ></DIV
  42673. ></DIV
  42674. ><H1
  42675. ><A
  42676. NAME="function.apache-setenv"
  42677. ></A
  42678. >apache_setenv</H1
  42679. ><DIV
  42680. CLASS="refnamediv"
  42681. ><A
  42682. NAME="AEN7185"
  42683. ></A
  42684. ><P
  42685. >    (PHP 4 >= 4.2.0, PHP 5)</P
  42686. >apache_setenv -- Setzt eine Apache subprocess_env Variable</DIV
  42687. ><DIV
  42688. CLASS="refsect1"
  42689. ><A
  42690. NAME="AEN7188"
  42691. ></A
  42692. ><H2
  42693. >Beschreibung</H2
  42694. >int <B
  42695. CLASS="methodname"
  42696. >apache_setenv</B
  42697. > ( string Variable, string Wert [, bool walk_to_top])<BR
  42698. ></BR
  42699. ><P
  42700. >      <DIV
  42701. CLASS="warning"
  42702. ><P
  42703. ></P
  42704. ><TABLE
  42705. CLASS="warning"
  42706. BORDER="1"
  42707. WIDTH="100%"
  42708. ><TR
  42709. ><TD
  42710. ALIGN="CENTER"
  42711. ><B
  42712. >Warnung</B
  42713. ></TD
  42714. ></TR
  42715. ><TR
  42716. ><TD
  42717. ALIGN="LEFT"
  42718. ><P
  42719. >Diese Funktion ist bis jetzt
  42720. nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfⁿgung.
  42721. </P
  42722. ></TD
  42723. ></TR
  42724. ></TABLE
  42725. ></DIV
  42726. >
  42727.     </P
  42728. ></DIV
  42729. ><H1
  42730. ><A
  42731. NAME="function.ascii2ebcdic"
  42732. ></A
  42733. >ascii2ebcdic</H1
  42734. ><DIV
  42735. CLASS="refnamediv"
  42736. ><A
  42737. NAME="AEN7206"
  42738. ></A
  42739. ><P
  42740. >    (PHP 3>= 3.0.17)</P
  42741. >ascii2ebcdic -- Zeichenkette von ASCII in EBCDIC ⁿbersetzen</DIV
  42742. ><DIV
  42743. CLASS="refsect1"
  42744. ><A
  42745. NAME="AEN7209"
  42746. ></A
  42747. ><H2
  42748. >Beschreibung</H2
  42749. >int <B
  42750. CLASS="methodname"
  42751. >ascii2ebcdic</B
  42752. > ( string ascii_str)<BR
  42753. ></BR
  42754. ><P
  42755. >      <B
  42756. CLASS="function"
  42757. >ascii2ebcdic()</B
  42758. > ist eine Apache-spezifische
  42759.      Funktion, die nur auf Systemen mit EBCDIC-Zeichensatz
  42760.      existiert (Betriebssysteme: OS/390, BS2000).
  42761.      Die Funktion setzt die ASCII-kodierte Zeichenkette
  42762.      <VAR
  42763. CLASS="parameter"
  42764. >ascii_str</VAR
  42765. >
  42766.      in ihre Σquivalente EBCDIC-Darstellung um
  42767.      (binΣrfest), und liefert das konvertierte Ergebnis
  42768.      zurⁿck.
  42769.     </P
  42770. ><P
  42771. >      Siehe auch die Umkehrfunktion
  42772.      <A
  42773. HREF="#function.ebcdic2ascii"
  42774. ><B
  42775. CLASS="function"
  42776. >ebcdic2ascii()</B
  42777. ></A
  42778. >.
  42779.     </P
  42780. ></DIV
  42781. ><H1
  42782. ><A
  42783. NAME="function.ebcdic2ascii"
  42784. ></A
  42785. >ebcdic2ascii</H1
  42786. ><DIV
  42787. CLASS="refnamediv"
  42788. ><A
  42789. NAME="AEN7223"
  42790. ></A
  42791. ><P
  42792. >    (PHP 3>= 3.0.17)</P
  42793. >ebcdic2ascii -- Zeichenkette von EBCDIC in ASCII ⁿbersetzen</DIV
  42794. ><DIV
  42795. CLASS="refsect1"
  42796. ><A
  42797. NAME="AEN7226"
  42798. ></A
  42799. ><H2
  42800. >Beschreibung</H2
  42801. >int <B
  42802. CLASS="methodname"
  42803. >ebcdic2ascii</B
  42804. > ( string ebcdic_str)<BR
  42805. ></BR
  42806. ><P
  42807. >      <B
  42808. CLASS="function"
  42809. >ebcdic2ascii()</B
  42810. > ist eine Apache-spezifische
  42811.      Funktion, die nur auf Systemen mit EBCDIC-Zeichensatz
  42812.      existiert (Betriebssysteme: OS/390, BS2000).
  42813.      Die Funktion setzt die EBCDIC-kodierte Zeichenkette
  42814.      <VAR
  42815. CLASS="parameter"
  42816. >ebcdic_str</VAR
  42817. >
  42818.      in ihre Σquivalente ASCII-Darstellung um
  42819.      (binΣrfest), und liefert das konvertierte Ergebnis
  42820.      zurⁿck.
  42821.     </P
  42822. ><P
  42823. >      Siehe auch die Umkehrfunktion
  42824.      <A
  42825. HREF="#function.ascii2ebcdic"
  42826. ><B
  42827. CLASS="function"
  42828. >ascii2ebcdic()</B
  42829. ></A
  42830. >.
  42831.     </P
  42832. ></DIV
  42833. ><H1
  42834. ><A
  42835. NAME="function.getallheaders"
  42836. ></A
  42837. >getallheaders</H1
  42838. ><DIV
  42839. CLASS="refnamediv"
  42840. ><A
  42841. NAME="AEN7240"
  42842. ></A
  42843. ><P
  42844. >    (PHP 3, PHP 4 , PHP 5)</P
  42845. >getallheaders -- 
  42846.      Liefert alle HTTP-Header der aktuellen Anfrage aus
  42847.     </DIV
  42848. ><DIV
  42849. CLASS="refsect1"
  42850. ><A
  42851. NAME="AEN7243"
  42852. ></A
  42853. ><H2
  42854. >Beschreibung</H2
  42855. >array <B
  42856. CLASS="methodname"
  42857. >getallheaders</B
  42858. > ( void )<BR
  42859. ></BR
  42860. ><P
  42861. >      <B
  42862. CLASS="function"
  42863. >getallheaders()</B
  42864. > ist ein Alias fⁿr die Funktion
  42865.      <A
  42866. HREF="#function.apache-request-headers"
  42867. ><B
  42868. CLASS="function"
  42869. >apache_request_headers()</B
  42870. ></A
  42871. >. Die Funktion liefert ein
  42872.      assoziatives Array zurⁿck, das alle HTTP-Header der
  42873.      aktuellen HTTP-Anfrage enthΣlt. Lesen Sie bitte die Dokumentation zu
  42874.      <A
  42875. HREF="#function.apache-request-headers"
  42876. ><B
  42877. CLASS="function"
  42878. >apache_request_headers()</B
  42879. ></A
  42880. > um mehr Informationen ⁿber die
  42881.      Funktionsweise zu erhalten.
  42882.     </P
  42883. ><DIV
  42884. CLASS="note"
  42885. ><BLOCKQUOTE
  42886. CLASS="note"
  42887. ><P
  42888. ><B
  42889. >Anmerkung: </B
  42890. >
  42891.       In PHP 4.3.0 wurde aus <B
  42892. CLASS="function"
  42893. >getallheaders()</B
  42894. > ein Alias fⁿr
  42895.       <A
  42896. HREF="#function.apache-request-headers"
  42897. ><B
  42898. CLASS="function"
  42899. >apache_request_headers()</B
  42900. ></A
  42901. >. TatsΣchlich wurde die
  42902.       Funktion umbenannt. Der Grund: diese Funktion funktioniert nur, wenn PHP
  42903.       als Modul fⁿr <SPAN
  42904. CLASS="productname"
  42905. >Apache</SPAN
  42906. > kompiliert wurde.
  42907.      </P
  42908. ></BLOCKQUOTE
  42909. ></DIV
  42910. ><DIV
  42911. CLASS="note"
  42912. ><BLOCKQUOTE
  42913. CLASS="note"
  42914. ><P
  42915. ><B
  42916. >Anmerkung: </B
  42917. >Ab PHP 4.3.3 k÷nnen Sie diese
  42918. Funktion auch mit dem <A
  42919. HREF="#ref.nsapi"
  42920. >NSAPI Server Modul</A
  42921. > fⁿr
  42922. Netscape/iPlanet/SunONE Webserver nutzen.</P
  42923. ></BLOCKQUOTE
  42924. ></DIV
  42925. ><P
  42926. >      Siehe auch <A
  42927. HREF="#function.apache-request-headers"
  42928. ><B
  42929. CLASS="function"
  42930. >apache_request_headers()</B
  42931. ></A
  42932. >.
  42933.     </P
  42934. ></DIV
  42935. ><H1
  42936. ><A
  42937. NAME="function.virtual"
  42938. ></A
  42939. >virtual</H1
  42940. ><DIV
  42941. CLASS="refnamediv"
  42942. ><A
  42943. NAME="AEN7264"
  42944. ></A
  42945. ><P
  42946. >    (PHP 3, PHP 4 , PHP 5)</P
  42947. >virtual -- Fⁿhrt eine Apache-Unteranfrage durch</DIV
  42948. ><DIV
  42949. CLASS="refsect1"
  42950. ><A
  42951. NAME="AEN7267"
  42952. ></A
  42953. ><H2
  42954. >Beschreibung</H2
  42955. >int <B
  42956. CLASS="methodname"
  42957. >virtual</B
  42958. > ( string filename)<BR
  42959. ></BR
  42960. ><P
  42961. >      <B
  42962. CLASS="function"
  42963. >virtual()</B
  42964. > ist eine Apache-spezifische 
  42965.      Funktion, die <!--#include virtual... --> aus mod_include
  42966.      entspricht. Diese Funktion fⁿhrt eine Unteranfrage durch. Das ist
  42967.      nⁿtzlich fⁿr das Einbinden von CGI-Skripten, .shtml-Dateien oder allen
  42968.      anderen Inhalten, die von Apache verarbeitet werden sollen. Beachten Sie
  42969.      bitte, dass ein CGI-Skript gⁿltige CGI-Header generieren muss,
  42970.      mindestens einen Content-type-Header.
  42971.     </P
  42972. ><P
  42973. >      Um die Unteranfrage auszufⁿhren, werden alle Buffer beendet und der
  42974.      Inhalt im Browser ausgegeben. Anstehende Header werden ebenfalls
  42975.      abgeschickt.
  42976.     </P
  42977. ><P
  42978. >      Seit PHP 4.0.6 k÷nnen Sie <B
  42979. CLASS="function"
  42980. >virtual()</B
  42981. > fⁿr PHP Dateien
  42982.      benutzen. Trotzdem ist es typischerweise besser,
  42983.      <A
  42984. HREF="#function.include"
  42985. ><B
  42986. CLASS="function"
  42987. >include()</B
  42988. ></A
  42989. > oder <A
  42990. HREF="#function.require"
  42991. ><B
  42992. CLASS="function"
  42993. >require()</B
  42994. ></A
  42995. > zu benutzen
  42996.      um PHP Dateien einzubinden.
  42997.     </P
  42998. ><DIV
  42999. CLASS="note"
  43000. ><BLOCKQUOTE
  43001. CLASS="note"
  43002. ><P
  43003. ><B
  43004. >Anmerkung: </B
  43005. >Ab PHP 4.3.3 k÷nnen Sie diese
  43006. Funktion auch mit dem <A
  43007. HREF="#ref.nsapi"
  43008. >NSAPI Server Modul</A
  43009. > fⁿr
  43010. Netscape/iPlanet/SunONE Webserver nutzen.</P
  43011. ></BLOCKQUOTE
  43012. ></DIV
  43013. ></DIV
  43014. ></DIV
  43015. ><DIV
  43016. CLASS="reference"
  43017. ><A
  43018. NAME="ref.array"
  43019. ></A
  43020. ><DIV
  43021. CLASS="TITLEPAGE"
  43022. ><H1
  43023. CLASS="title"
  43024. >II. Array Funktionen</H1
  43025. ><DIV
  43026. CLASS="PARTINTRO"
  43027. ><A
  43028. NAME="AEN7288"
  43029. ></A
  43030. ><DIV
  43031. CLASS="section"
  43032. ><H2
  43033. CLASS="section"
  43034. ><A
  43035. NAME="array.intro"
  43036. >Einfⁿhrung</A
  43037. ></H2
  43038. ><P
  43039. >     Diese Funktionen erlauben es, Arrays auf verschiedene Arten zu
  43040.     manipulieren bzw. mit ihnen zu interagieren. Arrays sind wichtig,
  43041.     um Gruppen von Variablen zu verwalten, zu bearbeiten, oder zu
  43042.     speichern.
  43043.    </P
  43044. ><P
  43045. >     Es werden einfache und mehrdimensionale Arrays unterstⁿtzt, welche
  43046.     entweder vom Benutzer oder von einer anderen Funktion erstellt
  43047.     werden k÷nnen. Es gibt bestimmte Datenbankfunktionen, welche die
  43048.     Ergebnisse aus Datenbankabfragen in Arrays speichern, und
  43049.     verschiedene andere Funktionen, die Arrays als Rⁿckgabewerte
  43050.     haben.
  43051.    </P
  43052. ><P
  43053. >     Im Abschnitt <A
  43054. HREF="#language.types.array"
  43055. >Arrays</A
  43056. >
  43057.     finden Sie eine detaillierte ErklΣrung, wie Arrays in PHP
  43058.     implementiert sind und wie sie benutzt werden.
  43059.    </P
  43060. ></DIV
  43061. ><DIV
  43062. CLASS="section"
  43063. ><HR><H2
  43064. CLASS="section"
  43065. ><A
  43066. NAME="array.requirements"
  43067. >Anforderungen</A
  43068. ></H2
  43069. ><P
  43070. >Diese Erweiterung ben÷tigt keine externen Bibliotheken.</P
  43071. ></DIV
  43072. ><DIV
  43073. CLASS="section"
  43074. ><HR><H2
  43075. CLASS="section"
  43076. ><A
  43077. NAME="array.installation"
  43078. >Installation</A
  43079. ></H2
  43080. ><P
  43081. >Fⁿr diese Funktionen ist keine Installation erforderlich, 
  43082. diese geh÷ren zum Grundbestand von PHP.</P
  43083. ></DIV
  43084. ><DIV
  43085. CLASS="section"
  43086. ><HR><H2
  43087. CLASS="section"
  43088. ><A
  43089. NAME="array.configuration"
  43090. >Laufzeit Konfiguration</A
  43091. ></H2
  43092. ><P
  43093. >Diese Erweiterung definiert keine Konfigurationseinstellungen in der <TT
  43094. CLASS="filename"
  43095. >php.ini</TT
  43096. >.</P
  43097. ></DIV
  43098. ><DIV
  43099. CLASS="section"
  43100. ><HR><H2
  43101. CLASS="section"
  43102. ><A
  43103. NAME="array.resources"
  43104. >Resource Typen</A
  43105. ></H2
  43106. ><P
  43107. >Diese Erweiterung definiert keine Resource-Typen.</P
  43108. ></DIV
  43109. ><DIV
  43110. CLASS="section"
  43111. ><HR><H2
  43112. CLASS="section"
  43113. ><A
  43114. NAME="array.constants"
  43115. >Vordefinierte Konstanten</A
  43116. ></H2
  43117. ><P
  43118. >Die aufgelisteten Konstanten
  43119. stehen immer zur Verfⁿgung, da sie zum Grundbestand von PHP geh÷ren.</P
  43120. ><P
  43121. ></P
  43122. ><DIV
  43123. CLASS="variablelist"
  43124. ><DL
  43125. ><DT
  43126. ><TT
  43127. CLASS="constant"
  43128. ><B
  43129. >CASE_LOWER</B
  43130. ></TT
  43131. >
  43132.     (<A
  43133. HREF="#language.types.integer"
  43134. >integer</A
  43135. >)</DT
  43136. ><DD
  43137. ><P
  43138. >      <TT
  43139. CLASS="constant"
  43140. ><B
  43141. >CASE_LOWER</B
  43142. ></TT
  43143. > wird benⁿtzt mit
  43144.      <A
  43145. HREF="#function.array-change-key-case"
  43146. ><B
  43147. CLASS="function"
  43148. >array_change_key_case()</B
  43149. ></A
  43150. > um die Schlⁿssel von Arrays
  43151.      in Kleinbuchstaben umzuwandeln. Das ist auch der Standard fⁿr
  43152.      <A
  43153. HREF="#function.array-change-key-case"
  43154. ><B
  43155. CLASS="function"
  43156. >array_change_key_case()</B
  43157. ></A
  43158. >.
  43159.     </P
  43160. ></DD
  43161. ><DT
  43162. ><TT
  43163. CLASS="constant"
  43164. ><B
  43165. >CASE_UPPER</B
  43166. ></TT
  43167. >
  43168.     (<A
  43169. HREF="#language.types.integer"
  43170. >integer</A
  43171. >)</DT
  43172. ><DD
  43173. ><P
  43174. >      <TT
  43175. CLASS="constant"
  43176. ><B
  43177. >CASE_UPPER</B
  43178. ></TT
  43179. > wird benⁿtzt mit
  43180.      <A
  43181. HREF="#function.array-change-key-case"
  43182. ><B
  43183. CLASS="function"
  43184. >array_change_key_case()</B
  43185. ></A
  43186. > um die Schlⁿssel von Arrays
  43187.      in Gro▀buchstaben umzuwandeln.
  43188.     </P
  43189. ></DD
  43190. ></DL
  43191. ></DIV
  43192. ></DIV
  43193. ><DIV
  43194. CLASS="section"
  43195. ><HR><H2
  43196. CLASS="section"
  43197. ><A
  43198. NAME="array.seealso"
  43199. >Siehe auch</A
  43200. ></H2
  43201. ><P
  43202. >      Siehe auch <A
  43203. HREF="#function.is-array"
  43204. ><B
  43205. CLASS="function"
  43206. >is_array()</B
  43207. ></A
  43208. >, <A
  43209. HREF="#function.explode"
  43210. ><B
  43211. CLASS="function"
  43212. >explode()</B
  43213. ></A
  43214. >,
  43215.      <A
  43216. HREF="#function.implode"
  43217. ><B
  43218. CLASS="function"
  43219. >implode()</B
  43220. ></A
  43221. >, <A
  43222. HREF="#function.split"
  43223. ><B
  43224. CLASS="function"
  43225. >split()</B
  43226. ></A
  43227. >,
  43228.      <A
  43229. HREF="#function.preg-split"
  43230. ><B
  43231. CLASS="function"
  43232. >preg_split()</B
  43233. ></A
  43234. > und <A
  43235. HREF="#function.unset"
  43236. ><B
  43237. CLASS="function"
  43238. >unset()</B
  43239. ></A
  43240. >.
  43241.     </P
  43242. ></DIV
  43243. ></DIV
  43244. ><DIV
  43245. CLASS="TOC"
  43246. ><DL
  43247. ><DT
  43248. ><B
  43249. >Inhaltsverzeichnis</B
  43250. ></DT
  43251. ><DT
  43252. ><A
  43253. HREF="#function.array-change-key-case"
  43254. >array_change_key_case</A
  43255. > -- 
  43256.      Liefert ein Array mit allen String-Schlⁿsseln in Klein- oder Gro▀buchstaben
  43257.     </DT
  43258. ><DT
  43259. ><A
  43260. HREF="#function.array-chunk"
  43261. >array_chunk</A
  43262. > -- Splittet ein Array in Teile auf</DT
  43263. ><DT
  43264. ><A
  43265. HREF="#function.array-combine"
  43266. >array_combine</A
  43267. > -- 
  43268.      Creates an array by using one array for keys and another for its values
  43269.     </DT
  43270. ><DT
  43271. ><A
  43272. HREF="#function.array-count-values"
  43273. >array_count_values</A
  43274. > -- ZΣhlt die Werte eines Arrays</DT
  43275. ><DT
  43276. ><A
  43277. HREF="#function.array-diff-assoc"
  43278. >array_diff_assoc</A
  43279. > -- Computes the difference of arrays with additional index check</DT
  43280. ><DT
  43281. ><A
  43282. HREF="#function.array-diff-key"
  43283. >array_diff_key</A
  43284. > -- Computes the difference of arrays using keys for comparison</DT
  43285. ><DT
  43286. ><A
  43287. HREF="#function.array-diff-uassoc"
  43288. >array_diff_uassoc</A
  43289. > -- 
  43290.      Computes the difference of arrays with additional index check
  43291.      which is performed by a user supplied callback function
  43292.     </DT
  43293. ><DT
  43294. ><A
  43295. HREF="#function.array-diff-ukey"
  43296. >array_diff_ukey</A
  43297. > -- Computes the difference of arrays using a callback function on the keys for comparison</DT
  43298. ><DT
  43299. ><A
  43300. HREF="#function.array-diff"
  43301. >array_diff</A
  43302. > -- Ermittelt die Unterschiede von Arrays</DT
  43303. ><DT
  43304. ><A
  43305. HREF="#function.array-fill"
  43306. >array_fill</A
  43307. > -- Fⁿllt ein Array mit Werten</DT
  43308. ><DT
  43309. ><A
  43310. HREF="#function.array-filter"
  43311. >array_filter</A
  43312. > -- 
  43313.      Filtert Elemente eines Arrays mittels einer Callback-Funktion
  43314.     </DT
  43315. ><DT
  43316. ><A
  43317. HREF="#function.array-flip"
  43318. >array_flip</A
  43319. > -- Vertauscht Werte und Schlⁿssel in einem Array</DT
  43320. ><DT
  43321. ><A
  43322. HREF="#function.array-intersect-assoc"
  43323. >array_intersect_assoc</A
  43324. > -- Computes the intersection of arrays with additional index check</DT
  43325. ><DT
  43326. ><A
  43327. HREF="#function.array-intersect-key"
  43328. >array_intersect_key</A
  43329. > -- Computes the intersection of arrays using keys for comparison</DT
  43330. ><DT
  43331. ><A
  43332. HREF="#function.array-intersect-uassoc"
  43333. >array_intersect_uassoc</A
  43334. > -- Computes the intersection of arrays with additional index check. The indexes are compared by using a callback function</DT
  43335. ><DT
  43336. ><A
  43337. HREF="#function.array-intersect-ukey"
  43338. >array_intersect_ukey</A
  43339. > -- Computes the intersection of arrays using a callback function on the keys for comparison</DT
  43340. ><DT
  43341. ><A
  43342. HREF="#function.array-intersect"
  43343. >array_intersect</A
  43344. > -- Ermittelt die Schnittmenge von Arrays</DT
  43345. ><DT
  43346. ><A
  43347. HREF="#function.array-key-exists"
  43348. >array_key_exists</A
  43349. > -- Prⁿft, ob ein Schlⁿssel in einem Array existiert</DT
  43350. ><DT
  43351. ><A
  43352. HREF="#function.array-keys"
  43353. >array_keys</A
  43354. > -- Liefert alle Schlⁿssel eines Arrays</DT
  43355. ><DT
  43356. ><A
  43357. HREF="#function.array-map"
  43358. >array_map</A
  43359. > -- 
  43360.      Wendet eine Callback-Funktion auf die Elemente von Arrays an
  43361.     </DT
  43362. ><DT
  43363. ><A
  43364. HREF="#function.array-merge-recursive"
  43365. >array_merge_recursive</A
  43366. > -- 
  43367.      Fⁿhrt zwei oder mehr Arrays rekursiv zusammen
  43368.     </DT
  43369. ><DT
  43370. ><A
  43371. HREF="#function.array-merge"
  43372. >array_merge</A
  43373. > -- Fⁿhrt zwei oder mehr Arrays zusammen</DT
  43374. ><DT
  43375. ><A
  43376. HREF="#function.array-multisort"
  43377. >array_multisort</A
  43378. > -- Sortiert mehrere oder multidimensionale Arrays</DT
  43379. ><DT
  43380. ><A
  43381. HREF="#function.array-pad"
  43382. >array_pad</A
  43383. > -- 
  43384.      Vergr÷▀ert ein Array auf die spezifizierte LΣnge mit einem Wert
  43385.     </DT
  43386. ><DT
  43387. ><A
  43388. HREF="#function.array-pop"
  43389. >array_pop</A
  43390. > -- Liefert das letzte Element eines Arrays</DT
  43391. ><DT
  43392. ><A
  43393. HREF="#function.array-push"
  43394. >array_push</A
  43395. > -- 
  43396.      Fⁿgt ein oder mehr Elemente an das Ende eines Arrays
  43397.     </DT
  43398. ><DT
  43399. ><A
  43400. HREF="#function.array-rand"
  43401. >array_rand</A
  43402. > -- 
  43403.      Liefert einen oder mehrere zufΣllige EintrΣge eines Arrays
  43404.     </DT
  43405. ><DT
  43406. ><A
  43407. HREF="#function.array-reduce"
  43408. >array_reduce</A
  43409. > -- 
  43410.      Iterative Reduktion eines Arrays zu einem Wert mittels einer
  43411.      Callback Funktion
  43412.     </DT
  43413. ><DT
  43414. ><A
  43415. HREF="#function.array-reverse"
  43416. >array_reverse</A
  43417. > -- 
  43418.      Liefert ein Array mit umgekehrter Reihenfolge der Elemente
  43419.     </DT
  43420. ><DT
  43421. ><A
  43422. HREF="#function.array-search"
  43423. >array_search</A
  43424. > -- 
  43425.      Durchsucht ein Array nach einem Wert liefert bei Erfolg den
  43426.      Schlⁿssel
  43427.     </DT
  43428. ><DT
  43429. ><A
  43430. HREF="#function.array-shift"
  43431. >array_shift</A
  43432. > -- 
  43433.      Liefert ein Element vom Beginn eines Arrays
  43434.     </DT
  43435. ><DT
  43436. ><A
  43437. HREF="#function.array-slice"
  43438. >array_slice</A
  43439. > -- Extrahiert einen Ausschnitt eines Arrays</DT
  43440. ><DT
  43441. ><A
  43442. HREF="#function.array-splice"
  43443. >array_splice</A
  43444. > -- 
  43445.      Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas
  43446.      anderes
  43447.     </DT
  43448. ><DT
  43449. ><A
  43450. HREF="#function.array-sum"
  43451. >array_sum</A
  43452. > -- 
  43453.      Liefert die Summe der Werte in einem Array
  43454.     </DT
  43455. ><DT
  43456. ><A
  43457. HREF="#function.array-udiff-assoc"
  43458. >array_udiff_assoc</A
  43459. > -- Computes the difference of arrays with additional index check. The data is compared by using a callback function</DT
  43460. ><DT
  43461. ><A
  43462. HREF="#function.array-udiff-uassoc"
  43463. >array_udiff_uassoc</A
  43464. > -- Computes the difference of arrays with additional index check. The data is compared by using a callback function. The index check is done by a callback function also</DT
  43465. ><DT
  43466. ><A
  43467. HREF="#function.array-udiff"
  43468. >array_udiff</A
  43469. > -- Computes the difference of arrays by using a callback function for data comparison</DT
  43470. ><DT
  43471. ><A
  43472. HREF="#function.array-uintersect-assoc"
  43473. >array_uintersect_assoc</A
  43474. > -- Computes the intersection of arrays with additional index check. The data is compared by using a callback function</DT
  43475. ><DT
  43476. ><A
  43477. HREF="#function.array-uintersect-uassoc"
  43478. >array_uintersect_uassoc</A
  43479. > -- Computes the intersection of arrays with additional index check. Both the data and the indexes are compared by using a callback functions</DT
  43480. ><DT
  43481. ><A
  43482. HREF="#function.array-uintersect"
  43483. >array_uintersect</A
  43484. > -- Computes the intersection of arrays. The data is compared by using a callback function</DT
  43485. ><DT
  43486. ><A
  43487. HREF="#function.array-unique"
  43488. >array_unique</A
  43489. > -- Entfernt doppelte Werte aus einem Array</DT
  43490. ><DT
  43491. ><A
  43492. HREF="#function.array-unshift"
  43493. >array_unshift</A
  43494. > -- 
  43495.      Fⁿgt ein oder mehr Elemente am Anfang eines Arrays ein
  43496.     </DT
  43497. ><DT
  43498. ><A
  43499. HREF="#function.array-values"
  43500. >array_values</A
  43501. > -- Liefert alle Werte eines Arrays</DT
  43502. ><DT
  43503. ><A
  43504. HREF="#function.array-walk-recursive"
  43505. >array_walk_recursive</A
  43506. > -- 
  43507.    Apply a user function recursively to every member of an array
  43508.   </DT
  43509. ><DT
  43510. ><A
  43511. HREF="#function.array-walk"
  43512. >array_walk</A
  43513. > -- 
  43514.      Wendet eine Benutzerfunktion an jedem Element eines Arrays an
  43515.     </DT
  43516. ><DT
  43517. ><A
  43518. HREF="#function.array"
  43519. >array</A
  43520. > -- 
  43521.      Erstellt ein Array
  43522.     </DT
  43523. ><DT
  43524. ><A
  43525. HREF="#function.arsort"
  43526. >arsort</A
  43527. > -- 
  43528.      Sortiert ein Array in umgekehrter Reihenfolge und behΣlt die
  43529.      Verbindung zum Index
  43530.     </DT
  43531. ><DT
  43532. ><A
  43533. HREF="#function.asort"
  43534. >asort</A
  43535. > -- 
  43536.      Sortiert ein Array und behΣlt die Indexverbindungen
  43537.     </DT
  43538. ><DT
  43539. ><A
  43540. HREF="#function.compact"
  43541. >compact</A
  43542. > -- 
  43543.      Erstellt ein Array mit Variablen und deren Werten
  43544.     </DT
  43545. ><DT
  43546. ><A
  43547. HREF="#function.count"
  43548. >count</A
  43549. > -- ZΣhlt die Elemente einer Variable</DT
  43550. ><DT
  43551. ><A
  43552. HREF="#function.current"
  43553. >current</A
  43554. > -- Liefert das aktuelle Element eines Arrays</DT
  43555. ><DT
  43556. ><A
  43557. HREF="#function.each"
  43558. >each</A
  43559. > -- 
  43560.      Liefert das aktuelle Paar (Schlⁿssel und Wert) eines Arrays und
  43561.      rⁿckt den Array Cursor vor.
  43562.     </DT
  43563. ><DT
  43564. ><A
  43565. HREF="#function.end"
  43566. >end</A
  43567. > -- 
  43568.      Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
  43569.     </DT
  43570. ><DT
  43571. ><A
  43572. HREF="#function.extract"
  43573. >extract</A
  43574. > -- 
  43575.      Importiert Variablen eines Arrays in die aktuelle Symboltabelle 
  43576.     </DT
  43577. ><DT
  43578. ><A
  43579. HREF="#function.in-array"
  43580. >in_array</A
  43581. > -- Prⁿft, ob ein Wert in einem Array existiert</DT
  43582. ><DT
  43583. ><A
  43584. HREF="#function.key"
  43585. >key</A
  43586. > -- 
  43587.      Liefert einen Schlⁿssel eines assoziativen Arrays
  43588.     </DT
  43589. ><DT
  43590. ><A
  43591. HREF="#function.krsort"
  43592. >krsort</A
  43593. > -- 
  43594.      Sortiert ein Array nach Schlⁿsseln in umgekehrter Reihenfolge
  43595.     </DT
  43596. ><DT
  43597. ><A
  43598. HREF="#function.ksort"
  43599. >ksort</A
  43600. > -- Sortiert ein Array nach Schlⁿsseln</DT
  43601. ><DT
  43602. ><A
  43603. HREF="#function.list"
  43604. >list</A
  43605. > -- 
  43606.      Weist Variablen zu, als wΣren sie ein Array
  43607.     </DT
  43608. ><DT
  43609. ><A
  43610. HREF="#function.natcasesort"
  43611. >natcasesort</A
  43612. > -- 
  43613.      Sortiert ein Array in "natⁿrlicher Reihenfolge",
  43614.      Gro▀/Kleinschreibung wird ignoriert
  43615.     </DT
  43616. ><DT
  43617. ><A
  43618. HREF="#function.natsort"
  43619. >natsort</A
  43620. > -- 
  43621.      Sortiert ein Array in "natⁿrlicher Reihenfolge"
  43622.     </DT
  43623. ><DT
  43624. ><A
  43625. HREF="#function.next"
  43626. >next</A
  43627. > -- 
  43628.      Rⁿckt den internen Zeiger eines Arrays vor
  43629.     </DT
  43630. ><DT
  43631. ><A
  43632. HREF="#function.pos"
  43633. >pos</A
  43634. > -- Liefert das aktuelle Element eines Arrays</DT
  43635. ><DT
  43636. ><A
  43637. HREF="#function.prev"
  43638. >prev</A
  43639. > -- 
  43640.      Verkleinert den internen Zeiger eines Arrays
  43641.     </DT
  43642. ><DT
  43643. ><A
  43644. HREF="#function.range"
  43645. >range</A
  43646. > -- 
  43647.      Erstellt ein Array mit einem Bereich von Elementen
  43648.     </DT
  43649. ><DT
  43650. ><A
  43651. HREF="#function.reset"
  43652. >reset</A
  43653. > -- 
  43654.      Setzt den internen Zeiger eines Arrays auf sein erstes Element
  43655.     </DT
  43656. ><DT
  43657. ><A
  43658. HREF="#function.rsort"
  43659. >rsort</A
  43660. > -- 
  43661.      Sortiert ein Array in umgekehrter Reihenfolge
  43662.     </DT
  43663. ><DT
  43664. ><A
  43665. HREF="#function.shuffle"
  43666. >shuffle</A
  43667. > -- Mischt die Elemente eines Arrays</DT
  43668. ><DT
  43669. ><A
  43670. HREF="#function.sizeof"
  43671. >sizeof</A
  43672. > -- Alias fⁿr <A
  43673. HREF="#function.count"
  43674. ><B
  43675. CLASS="function"
  43676. >count()</B
  43677. ></A
  43678. ></DT
  43679. ><DT
  43680. ><A
  43681. HREF="#function.sort"
  43682. >sort</A
  43683. > -- Sortiert ein Array</DT
  43684. ><DT
  43685. ><A
  43686. HREF="#function.uasort"
  43687. >uasort</A
  43688. > -- 
  43689.      Sortiert ein Array mittels einer benutzerdefinierten
  43690.      Vergleichsfunktion und behΣlt Indexassoziationen bei.
  43691.     </DT
  43692. ><DT
  43693. ><A
  43694. HREF="#function.uksort"
  43695. >uksort</A
  43696. > -- 
  43697.      Sortiert ein Array nach Schlⁿsseln mittels einer
  43698.      benutzerdefinierten Vergleichsfunktion.
  43699.     </DT
  43700. ><DT
  43701. ><A
  43702. HREF="#function.usort"
  43703. >usort</A
  43704. > -- 
  43705.      Sortiert ein Array nach Werten mittels einer benutzerdefinierten
  43706.      Vergleichsfunktion.
  43707.     </DT
  43708. ></DL
  43709. ></DIV
  43710. ></DIV
  43711. ><H1
  43712. ><A
  43713. NAME="function.array-change-key-case"
  43714. ></A
  43715. >array_change_key_case</H1
  43716. ><DIV
  43717. CLASS="refnamediv"
  43718. ><A
  43719. NAME="AEN7339"
  43720. ></A
  43721. ><P
  43722. >    (PHP 4 >= 4.2.0, PHP 5)</P
  43723. >array_change_key_case -- 
  43724.      Liefert ein Array mit allen String-Schlⁿsseln in Klein- oder Gro▀buchstaben
  43725.     </DIV
  43726. ><DIV
  43727. CLASS="refsect1"
  43728. ><A
  43729. NAME="AEN7342"
  43730. ></A
  43731. ><H2
  43732. >Beschreibung</H2
  43733. >array <B
  43734. CLASS="methodname"
  43735. >array_change_key_case</B
  43736. > ( array input [, int case])<BR
  43737. ></BR
  43738. ><P
  43739. >      <B
  43740. CLASS="function"
  43741. >array_change_key_case()</B
  43742. > wandelt die Schlⁿssel des
  43743.      Arrays <VAR
  43744. CLASS="parameter"
  43745. >input</VAR
  43746. > in Klein- bzw. Gro▀buchstaben um.
  43747.      Die Richtung der Umwandlung wird mit dem optionalen Parameter
  43748.      <VAR
  43749. CLASS="parameter"
  43750. >case</VAR
  43751. > festgelegt, mit dem die zwei Konstanten
  43752.      <TT
  43753. CLASS="constant"
  43754. ><B
  43755. >CASE_UPPER</B
  43756. ></TT
  43757. > und <TT
  43758. CLASS="constant"
  43759. ><B
  43760. >CASE_LOWER</B
  43761. ></TT
  43762. >
  43763.      ⁿbergeben werden k÷nnen. Default ist <TT
  43764. CLASS="constant"
  43765. ><B
  43766. >CASE_LOWER</B
  43767. ></TT
  43768. >.
  43769.      Diese Funktion lΣsst die numerischen Indizes unverΣndert.
  43770.     </P
  43771. ><TABLE
  43772. WIDTH="100%"
  43773. BORDER="0"
  43774. CELLPADDING="0"
  43775. CELLSPACING="0"
  43776. CLASS="EXAMPLE"
  43777. ><TR
  43778. ><TD
  43779. ><DIV
  43780. CLASS="example"
  43781. ><A
  43782. NAME="AEN7360"
  43783. ></A
  43784. ><P
  43785. ><B
  43786. >Beispiel 1. <B
  43787. CLASS="function"
  43788. >array_change_key_case()</B
  43789. ></B
  43790. ></P
  43791. ><TABLE
  43792. BORDER="0"
  43793. BGCOLOR="#E0E0E0"
  43794. CELLPADDING="5"
  43795. ><TR
  43796. ><TD
  43797. ><PRE
  43798. CLASS="php"
  43799. ><?php
  43800. $input_array = array("FirSt" => 1, "SecOnd" => 4);
  43801. print_r(array_change_key_case($input_array, CASE_UPPER));
  43802. ?></PRE
  43803. ></TD
  43804. ></TR
  43805. ></TABLE
  43806. ><P
  43807. >       wird folgendes ausgeben:
  43808.      </P
  43809. ><TABLE
  43810. BORDER="0"
  43811. BGCOLOR="#E0E0E0"
  43812. CELLPADDING="5"
  43813. ><TR
  43814. ><TD
  43815. ><PRE
  43816. CLASS="screen"
  43817. >Array
  43818. (
  43819.     [FIRST] => 1
  43820.     [SECOND] => 4
  43821. )</PRE
  43822. ></TD
  43823. ></TR
  43824. ></TABLE
  43825. ></DIV
  43826. ></TD
  43827. ></TR
  43828. ></TABLE
  43829. ><P
  43830. >      Hat ein Array Indices, die bei einem Durchlauf durch diese Funktion gleich
  43831.      sind (z.B. "keY" and "kEY"), hebt der letztere Wert im Array andere
  43832.      Indices auf.
  43833.     </P
  43834. ></DIV
  43835. ><H1
  43836. ><A
  43837. NAME="function.array-chunk"
  43838. ></A
  43839. >array_chunk</H1
  43840. ><DIV
  43841. CLASS="refnamediv"
  43842. ><A
  43843. NAME="AEN7368"
  43844. ></A
  43845. ><P
  43846. >    (PHP 4 >= 4.2.0, PHP 5)</P
  43847. >array_chunk -- Splittet ein Array in Teile auf</DIV
  43848. ><DIV
  43849. CLASS="refsect1"
  43850. ><A
  43851. NAME="AEN7371"
  43852. ></A
  43853. ><H2
  43854. >Beschreibung</H2
  43855. >array <B
  43856. CLASS="methodname"
  43857. >array_chunk</B
  43858. > ( array input, int size [, bool preserve_keys])<BR
  43859. ></BR
  43860. ><P
  43861. >      <B
  43862. CLASS="function"
  43863. >array_chunk()</B
  43864. > teilt das Array in verschiedene
  43865.      Arrays mit <VAR
  43866. CLASS="parameter"
  43867. >size</VAR
  43868. > Werten auf. Am Ende kann
  43869.      auch ein Array mit weniger Werten erzeugt werden. Die Arrays werden
  43870.      als Teile eines mehrdimensionalen Arrays erzeugt, welches bei Null
  43871.      und beginnend numerisch indiziert ist.
  43872.     </P
  43873. ><P
  43874. >      Sie k÷nnen PHP dazu zwingen, die originalen Schlⁿssel des
  43875.      Arrays input beizubehalten, indem Sie den optionalen Parameter
  43876.      <VAR
  43877. CLASS="parameter"
  43878. >preserve_keys</VAR
  43879. > auf <TT
  43880. CLASS="constant"
  43881. ><B
  43882. >TRUE</B
  43883. ></TT
  43884. > setzen. Geben
  43885.      Sie <TT
  43886. CLASS="constant"
  43887. ><B
  43888. >FALSE</B
  43889. ></TT
  43890. > an, werden in jedem erzeugten Array neue numerische
  43891.      Indizes erzeugt, welche bei Null beginnen. Default ist <TT
  43892. CLASS="constant"
  43893. ><B
  43894. >FALSE</B
  43895. ></TT
  43896. >.
  43897.     </P
  43898. ><TABLE
  43899. WIDTH="100%"
  43900. BORDER="0"
  43901. CELLPADDING="0"
  43902. CELLSPACING="0"
  43903. CLASS="EXAMPLE"
  43904. ><TR
  43905. ><TD
  43906. ><DIV
  43907. CLASS="example"
  43908. ><A
  43909. NAME="AEN7393"
  43910. ></A
  43911. ><P
  43912. ><B
  43913. >Beispiel 1. <B
  43914. CLASS="function"
  43915. >array_chunk()</B
  43916. ></B
  43917. ></P
  43918. ><TABLE
  43919. BORDER="0"
  43920. BGCOLOR="#E0E0E0"
  43921. CELLPADDING="5"
  43922. ><TR
  43923. ><TD
  43924. ><PRE
  43925. CLASS="php"
  43926. ><?php
  43927. $input_array = array('a', 'b', 'c', 'd', 'e');
  43928. print_r(array_chunk($input_array, 2));
  43929. print_r(array_chunk($input_array, 2, TRUE));
  43930. ?></PRE
  43931. ></TD
  43932. ></TR
  43933. ></TABLE
  43934. ><P
  43935. >       wird folgendes ausgeben:
  43936.      </P
  43937. ><TABLE
  43938. BORDER="0"
  43939. BGCOLOR="#E0E0E0"
  43940. CELLPADDING="5"
  43941. ><TR
  43942. ><TD
  43943. ><PRE
  43944. CLASS="screen"
  43945. >Array
  43946. (
  43947.     [0] => Array
  43948.         (
  43949.             [0] => a
  43950.             [1] => b
  43951.         )
  43952.  
  43953.     [1] => Array
  43954.         (
  43955.             [0] => c
  43956.             [1] => d
  43957.         )
  43958.  
  43959.     [2] => Array
  43960.         (
  43961.             [0] => e
  43962.         )
  43963.  
  43964. )
  43965. Array
  43966. (
  43967.     [0] => Array
  43968.         (
  43969.             [0] => a
  43970.             [1] => b
  43971.         )
  43972.  
  43973.     [1] => Array
  43974.         (
  43975.             [2] => c
  43976.             [3] => d
  43977.         )
  43978.  
  43979.     [2] => Array
  43980.         (
  43981.             [4] => e
  43982.         )
  43983.  
  43984. )</PRE
  43985. ></TD
  43986. ></TR
  43987. ></TABLE
  43988. ></DIV
  43989. ></TD
  43990. ></TR
  43991. ></TABLE
  43992. ></DIV
  43993. ><H1
  43994. ><A
  43995. NAME="function.array-combine"
  43996. ></A
  43997. >array_combine</H1
  43998. ><DIV
  43999. CLASS="refnamediv"
  44000. ><A
  44001. NAME="AEN7400"
  44002. ></A
  44003. ><P
  44004. >    (PHP 5)</P
  44005. >array_combine -- 
  44006.      Creates an array by using one array for keys and another for its values
  44007.     </DIV
  44008. ><DIV
  44009. CLASS="refsect1"
  44010. ><A
  44011. NAME="AEN7403"
  44012. ></A
  44013. ><H2
  44014. >Description</H2
  44015. >array <B
  44016. CLASS="methodname"
  44017. >array_combine</B
  44018. > ( array keys, array values)<BR
  44019. ></BR
  44020. ><P
  44021. >      Returns an <A
  44022. HREF="#language.types.array"
  44023. ><B
  44024. CLASS="type"
  44025. >array</B
  44026. ></A
  44027. > by using the values from the
  44028.      <VAR
  44029. CLASS="parameter"
  44030. >keys</VAR
  44031. > array as keys and the values from the
  44032.      <VAR
  44033. CLASS="parameter"
  44034. >values</VAR
  44035. > array as the corresponding values.
  44036.     </P
  44037. ><P
  44038. >      Returns <TT
  44039. CLASS="constant"
  44040. ><B
  44041. >FALSE</B
  44042. ></TT
  44043. > if the number of elements for each array isn't equal or
  44044.      if the arrays are empty.
  44045.     </P
  44046. ><P
  44047. >      <TABLE
  44048. WIDTH="100%"
  44049. BORDER="0"
  44050. CELLPADDING="0"
  44051. CELLSPACING="0"
  44052. CLASS="EXAMPLE"
  44053. ><TR
  44054. ><TD
  44055. ><DIV
  44056. CLASS="example"
  44057. ><A
  44058. NAME="AEN7421"
  44059. ></A
  44060. ><P
  44061. ><B
  44062. >Beispiel 1. A simple <B
  44063. CLASS="function"
  44064. >array_combine()</B
  44065. > example</B
  44066. ></P
  44067. ><TABLE
  44068. BORDER="0"
  44069. BGCOLOR="#E0E0E0"
  44070. CELLPADDING="5"
  44071. ><TR
  44072. ><TD
  44073. ><PRE
  44074. CLASS="php"
  44075. ><?php
  44076. $a = array('green', 'red', 'yellow');
  44077. $b = array('avocado', 'apple', 'banana');
  44078. $c = array_combine($a, $b);
  44079.  
  44080. print_r($c);
  44081. ?></PRE
  44082. ></TD
  44083. ></TR
  44084. ></TABLE
  44085. ><P
  44086. >        Outputs:
  44087.       </P
  44088. ><TABLE
  44089. BORDER="0"
  44090. BGCOLOR="#E0E0E0"
  44091. CELLPADDING="5"
  44092. ><TR
  44093. ><TD
  44094. ><PRE
  44095. CLASS="screen"
  44096. >Array
  44097. (
  44098.     [green]  => avocado
  44099.     [red]    => apple
  44100.     [yellow] => banana
  44101. )</PRE
  44102. ></TD
  44103. ></TR
  44104. ></TABLE
  44105. ></DIV
  44106. ></TD
  44107. ></TR
  44108. ></TABLE
  44109. >
  44110.     </P
  44111. ><P
  44112. >      See also <A
  44113. HREF="#function.array-merge"
  44114. ><B
  44115. CLASS="function"
  44116. >array_merge()</B
  44117. ></A
  44118. >,
  44119.      <A
  44120. HREF="#function.array-walk"
  44121. ><B
  44122. CLASS="function"
  44123. >array_walk()</B
  44124. ></A
  44125. >, and
  44126.      <A
  44127. HREF="#function.array-values"
  44128. ><B
  44129. CLASS="function"
  44130. >array_values()</B
  44131. ></A
  44132. >.
  44133.     </P
  44134. ></DIV
  44135. ><H1
  44136. ><A
  44137. NAME="function.array-count-values"
  44138. ></A
  44139. >array_count_values</H1
  44140. ><DIV
  44141. CLASS="refnamediv"
  44142. ><A
  44143. NAME="AEN7432"
  44144. ></A
  44145. ><P
  44146. >    (PHP 4 , PHP 5)</P
  44147. >array_count_values -- ZΣhlt die Werte eines Arrays</DIV
  44148. ><DIV
  44149. CLASS="refsect1"
  44150. ><A
  44151. NAME="AEN7435"
  44152. ></A
  44153. ><H2
  44154. >Beschreibung</H2
  44155. >array <B
  44156. CLASS="methodname"
  44157. >array_count_values</B
  44158. > ( array input)<BR
  44159. ></BR
  44160. ><P
  44161. >      <B
  44162. CLASS="function"
  44163. >array_count_values()</B
  44164. > gibt ein Array zurⁿck, in
  44165.      dem die Werte des Arrays <VAR
  44166. CLASS="parameter"
  44167. >input</VAR
  44168. > als
  44169.      Schlⁿssel, und deren Anzahl als Werte angegeben sind.
  44170.     </P
  44171. ><P
  44172. >      <TABLE
  44173. WIDTH="100%"
  44174. BORDER="0"
  44175. CELLPADDING="0"
  44176. CELLSPACING="0"
  44177. CLASS="EXAMPLE"
  44178. ><TR
  44179. ><TD
  44180. ><DIV
  44181. CLASS="example"
  44182. ><A
  44183. NAME="AEN7447"
  44184. ></A
  44185. ><P
  44186. ><B
  44187. >Beispiel 1. <B
  44188. CLASS="function"
  44189. >array_count_values()</B
  44190. ></B
  44191. ></P
  44192. ><TABLE
  44193. BORDER="0"
  44194. BGCOLOR="#E0E0E0"
  44195. CELLPADDING="5"
  44196. ><TR
  44197. ><TD
  44198. ><PRE
  44199. CLASS="php"
  44200. ><?php
  44201. $array = array (1, "hello", 1, "world", "hello");
  44202. print_r(array_count_values ($array));
  44203. ?></PRE
  44204. ></TD
  44205. ></TR
  44206. ></TABLE
  44207. ><P
  44208. >        Wird folgendes ausgeben:
  44209.       </P
  44210. ><TABLE
  44211. BORDER="0"
  44212. BGCOLOR="#E0E0E0"
  44213. CELLPADDING="5"
  44214. ><TR
  44215. ><TD
  44216. ><PRE
  44217. CLASS="screen"
  44218. >Array
  44219. (
  44220.     [1] => 2
  44221.     [hello] => 2
  44222.     [world] => 1
  44223. )</PRE
  44224. ></TD
  44225. ></TR
  44226. ></TABLE
  44227. ></DIV
  44228. ></TD
  44229. ></TR
  44230. ></TABLE
  44231. >
  44232.     </P
  44233. ></DIV
  44234. ><H1
  44235. ><A
  44236. NAME="function.array-diff-assoc"
  44237. ></A
  44238. >array_diff_assoc</H1
  44239. ><DIV
  44240. CLASS="refnamediv"
  44241. ><A
  44242. NAME="AEN7454"
  44243. ></A
  44244. ><P
  44245. >    (PHP 4 >= 4.3.0, PHP 5)</P
  44246. >array_diff_assoc -- Computes the difference of arrays with additional index check</DIV
  44247. ><DIV
  44248. CLASS="refsect1"
  44249. ><A
  44250. NAME="AEN7457"
  44251. ></A
  44252. ><H2
  44253. >Description</H2
  44254. >array <B
  44255. CLASS="methodname"
  44256. >array_diff_assoc</B
  44257. > ( array array1, array array2 [, array ...])<BR
  44258. ></BR
  44259. ><P
  44260. >      <B
  44261. CLASS="function"
  44262. >array_diff_assoc()</B
  44263. > returns an <A
  44264. HREF="#language.types.array"
  44265. ><B
  44266. CLASS="type"
  44267. >array</B
  44268. ></A
  44269. >
  44270.      containing all the values from <VAR
  44271. CLASS="parameter"
  44272. >array1</VAR
  44273. >
  44274.      that are not present in any of the other arguments.
  44275.      Note that the keys are used in the comparison unlike
  44276.      <A
  44277. HREF="#function.array-diff"
  44278. ><B
  44279. CLASS="function"
  44280. >array_diff()</B
  44281. ></A
  44282. >.
  44283.     </P
  44284. ><P
  44285. >      <TABLE
  44286. WIDTH="100%"
  44287. BORDER="0"
  44288. CELLPADDING="0"
  44289. CELLSPACING="0"
  44290. CLASS="EXAMPLE"
  44291. ><TR
  44292. ><TD
  44293. ><DIV
  44294. CLASS="example"
  44295. ><A
  44296. NAME="AEN7477"
  44297. ></A
  44298. ><P
  44299. ><B
  44300. >Beispiel 1. <B
  44301. CLASS="function"
  44302. >array_diff_assoc()</B
  44303. > example</B
  44304. ></P
  44305. ><TABLE
  44306. BORDER="0"
  44307. BGCOLOR="#E0E0E0"
  44308. CELLPADDING="5"
  44309. ><TR
  44310. ><TD
  44311. ><PRE
  44312. CLASS="php"
  44313. ><?php
  44314. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  44315. $array2 = array("a" => "green", "yellow", "red");
  44316. $result = array_diff_assoc($array1, $array2);
  44317. print_r($result);
  44318. ?></PRE
  44319. ></TD
  44320. ></TR
  44321. ></TABLE
  44322. ><P
  44323. >        The result is:
  44324.       </P
  44325. ><TABLE
  44326. BORDER="0"
  44327. BGCOLOR="#E0E0E0"
  44328. CELLPADDING="5"
  44329. ><TR
  44330. ><TD
  44331. ><PRE
  44332. CLASS="screen"
  44333. >Array
  44334. (
  44335.     [b] => brown
  44336.     [c] => blue
  44337.     [0] => red
  44338. )</PRE
  44339. ></TD
  44340. ></TR
  44341. ></TABLE
  44342. ></DIV
  44343. ></TD
  44344. ></TR
  44345. ></TABLE
  44346. >
  44347.     </P
  44348. ><P
  44349. >      In our example above you see the <VAR
  44350. CLASS="literal"
  44351. >"a" => "green"</VAR
  44352. >
  44353.      pair is present in both arrays and thus it is not in the ouput from the
  44354.      function. Unlike this, the pair <VAR
  44355. CLASS="literal"
  44356. >0 => "red"</VAR
  44357. > 
  44358.      is in the ouput because in the second argument <VAR
  44359. CLASS="literal"
  44360. >"red"</VAR
  44361. >
  44362.      has key which is <VAR
  44363. CLASS="literal"
  44364. >1</VAR
  44365. >. 
  44366.     </P
  44367. ><P
  44368. >      Two values from <SPAN
  44369. CLASS="emphasis"
  44370. ><I
  44371. CLASS="emphasis"
  44372. >key => value</I
  44373. ></SPAN
  44374. > pairs are
  44375.      considered equal only if <VAR
  44376. CLASS="literal"
  44377. >(string) $elem1 === (string)
  44378.      $elem2 </VAR
  44379. >. In other words a strict check takes place so 
  44380.      the string representations must be the same.
  44381.      
  44382.     </P
  44383. ><DIV
  44384. CLASS="note"
  44385. ><BLOCKQUOTE
  44386. CLASS="note"
  44387. ><P
  44388. ><B
  44389. >Anmerkung: </B
  44390. >
  44391.       Please note that this function only checks one dimension of a n-dimensional
  44392.       array. Of course you can check deeper dimensions by using, for example, 
  44393.       <VAR
  44394. CLASS="literal"
  44395. >array_diff_assoc($array1[0], $array2[0]);</VAR
  44396. >.
  44397.      </P
  44398. ></BLOCKQUOTE
  44399. ></DIV
  44400. ><P
  44401. >      See also <A
  44402. HREF="#function.array-diff"
  44403. ><B
  44404. CLASS="function"
  44405. >array_diff()</B
  44406. ></A
  44407. >,
  44408.      <A
  44409. HREF="#function.array-intersect"
  44410. ><B
  44411. CLASS="function"
  44412. >array_intersect()</B
  44413. ></A
  44414. >,
  44415.      and <A
  44416. HREF="#function.array-intersect-assoc"
  44417. ><B
  44418. CLASS="function"
  44419. >array_intersect_assoc()</B
  44420. ></A
  44421. >.
  44422.     </P
  44423. ></DIV
  44424. ><H1
  44425. ><A
  44426. NAME="function.array-diff-key"
  44427. ></A
  44428. >array_diff_key</H1
  44429. ><DIV
  44430. CLASS="refnamediv"
  44431. ><A
  44432. NAME="AEN7499"
  44433. ></A
  44434. ><P
  44435. >    (no version information, might be only in CVS)</P
  44436. >array_diff_key -- Computes the difference of arrays using keys for comparison</DIV
  44437. ><DIV
  44438. CLASS="refsect1"
  44439. ><A
  44440. NAME="AEN7502"
  44441. ></A
  44442. ><H2
  44443. >Description</H2
  44444. >array <B
  44445. CLASS="methodname"
  44446. >array_diff_key</B
  44447. > ( array array1, array array2 [, array ...])<BR
  44448. ></BR
  44449. ><P
  44450. >      <B
  44451. CLASS="function"
  44452. >array_diff_key()</B
  44453. > returns an array
  44454.      containing all the values of <VAR
  44455. CLASS="parameter"
  44456. >array1</VAR
  44457. >
  44458.      that have keys that are not present in any of the other arguments.
  44459.      Note that the associativity is preserved. This function is like
  44460.      <A
  44461. HREF="#function.array-diff"
  44462. ><B
  44463. CLASS="function"
  44464. >array_diff()</B
  44465. ></A
  44466. > except the comparison is done on the
  44467.      keys instead of the values.
  44468.     </P
  44469. ><P
  44470. >      <TABLE
  44471. WIDTH="100%"
  44472. BORDER="0"
  44473. CELLPADDING="0"
  44474. CELLSPACING="0"
  44475. CLASS="EXAMPLE"
  44476. ><TR
  44477. ><TD
  44478. ><DIV
  44479. CLASS="example"
  44480. ><A
  44481. NAME="AEN7521"
  44482. ></A
  44483. ><P
  44484. ><B
  44485. >Beispiel 1. <B
  44486. CLASS="function"
  44487. >array_diff_key()</B
  44488. > example</B
  44489. ></P
  44490. ><TABLE
  44491. BORDER="0"
  44492. BGCOLOR="#E0E0E0"
  44493. CELLPADDING="5"
  44494. ><TR
  44495. ><TD
  44496. ><PRE
  44497. CLASS="php"
  44498. ><?php
  44499. $array1 = array('blue'  => 1, 'red'  => 2, 'green'  => 3, 'purple' => 4);
  44500. $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan'   => 8);
  44501.  
  44502. var_dump(array_diff_key($array1, $array2));
  44503. ?></PRE
  44504. ></TD
  44505. ></TR
  44506. ></TABLE
  44507. ><P
  44508. >        The printout of the above program will be:
  44509.       </P
  44510. ><TABLE
  44511. BORDER="0"
  44512. BGCOLOR="#E0E0E0"
  44513. CELLPADDING="5"
  44514. ><TR
  44515. ><TD
  44516. ><PRE
  44517. CLASS="screen"
  44518. >array(2) {
  44519.   ["red"]=>
  44520.   int(2)
  44521.   ["purple"]=>
  44522.   int(4)
  44523. }</PRE
  44524. ></TD
  44525. ></TR
  44526. ></TABLE
  44527. ></DIV
  44528. ></TD
  44529. ></TR
  44530. ></TABLE
  44531. >
  44532.     </P
  44533. ><P
  44534. >      The two keys from the <VAR
  44535. CLASS="literal"
  44536. >key => value</VAR
  44537. > pairs are
  44538.      considered equal only if 
  44539.      <VAR
  44540. CLASS="literal"
  44541. >(string) $key1 === (string) $key2 </VAR
  44542. >. In other words
  44543.      a strict type check is executed so the string representation must be
  44544.      the same.
  44545.     </P
  44546. ><DIV
  44547. CLASS="note"
  44548. ><BLOCKQUOTE
  44549. CLASS="note"
  44550. ><P
  44551. ><B
  44552. >Anmerkung: </B
  44553. >
  44554.       Please note that this function only checks one dimension of a n-dimensional
  44555.       array. Of course you can check deeper dimensions by using
  44556.       <VAR
  44557. CLASS="literal"
  44558. >array_diff_key($array1[0], $array2[0]);</VAR
  44559. >.
  44560.      </P
  44561. ></BLOCKQUOTE
  44562. ></DIV
  44563. ><P
  44564. >      See also <A
  44565. HREF="#function.array-diff"
  44566. ><B
  44567. CLASS="function"
  44568. >array_diff()</B
  44569. ></A
  44570. >,
  44571.      <A
  44572. HREF="#function.array-udiff"
  44573. ><B
  44574. CLASS="function"
  44575. >array_udiff()</B
  44576. ></A
  44577. >
  44578.      <A
  44579. HREF="#function.array-diff-assoc"
  44580. ><B
  44581. CLASS="function"
  44582. >array_diff_assoc()</B
  44583. ></A
  44584. >,
  44585.      <A
  44586. HREF="#function.array-diff-uassoc"
  44587. ><B
  44588. CLASS="function"
  44589. >array_diff_uassoc()</B
  44590. ></A
  44591. >,
  44592.      <A
  44593. HREF="#function.array-udiff-assoc"
  44594. ><B
  44595. CLASS="function"
  44596. >array_udiff_assoc()</B
  44597. ></A
  44598. >,
  44599.      <A
  44600. HREF="#function.array-udiff-uassoc"
  44601. ><B
  44602. CLASS="function"
  44603. >array_udiff_uassoc()</B
  44604. ></A
  44605. >,
  44606.      <A
  44607. HREF="#function.array-diff-ukey"
  44608. ><B
  44609. CLASS="function"
  44610. >array_diff_ukey()</B
  44611. ></A
  44612. >,
  44613.      <A
  44614. HREF="#function.array-intersect"
  44615. ><B
  44616. CLASS="function"
  44617. >array_intersect()</B
  44618. ></A
  44619. >,
  44620.      <A
  44621. HREF="#function.array-intersect-assoc"
  44622. ><B
  44623. CLASS="function"
  44624. >array_intersect_assoc()</B
  44625. ></A
  44626. >,
  44627.      <A
  44628. HREF="#function.array-intersect-uassoc"
  44629. ><B
  44630. CLASS="function"
  44631. >array_intersect_uassoc()</B
  44632. ></A
  44633. >,
  44634.      <A
  44635. HREF="#function.array-intersect-key"
  44636. ><B
  44637. CLASS="function"
  44638. >array_intersect_key()</B
  44639. ></A
  44640. > and
  44641.      <A
  44642. HREF="#function.array-intersect-ukey"
  44643. ><B
  44644. CLASS="function"
  44645. >array_intersect_ukey()</B
  44646. ></A
  44647. >.
  44648.     </P
  44649. ></DIV
  44650. ><H1
  44651. ><A
  44652. NAME="function.array-diff-uassoc"
  44653. ></A
  44654. >array_diff_uassoc</H1
  44655. ><DIV
  44656. CLASS="refnamediv"
  44657. ><A
  44658. NAME="AEN7547"
  44659. ></A
  44660. ><P
  44661. >    (PHP 5)</P
  44662. >array_diff_uassoc -- 
  44663.      Computes the difference of arrays with additional index check
  44664.      which is performed by a user supplied callback function
  44665.     </DIV
  44666. ><DIV
  44667. CLASS="refsect1"
  44668. ><A
  44669. NAME="AEN7550"
  44670. ></A
  44671. ><H2
  44672. >Description</H2
  44673. >array <B
  44674. CLASS="methodname"
  44675. >array_diff_uassoc</B
  44676. > ( array array1, array array2 [, array ..., callback key_compare_func])<BR
  44677. ></BR
  44678. ><P
  44679. >      <B
  44680. CLASS="function"
  44681. >array_diff_uassoc()</B
  44682. > returns an <A
  44683. HREF="#language.types.array"
  44684. ><B
  44685. CLASS="type"
  44686. >array</B
  44687. ></A
  44688. >
  44689.      containing all the values from <VAR
  44690. CLASS="parameter"
  44691. >array1</VAR
  44692. >
  44693.      that are not present in any of the other arguments.
  44694.      Note that the keys are used in the comparison unlike
  44695.      <A
  44696. HREF="#function.array-diff"
  44697. ><B
  44698. CLASS="function"
  44699. >array_diff()</B
  44700. ></A
  44701. >. This comparison is done by a user supplied callback function.
  44702.      It must return an integer less than, equal
  44703.      to, or greater than zero if the first argument is considered to
  44704.      be respectively less than, equal to, or greater than the
  44705.      second. This is unlike <A
  44706. HREF="#function.array-diff-assoc"
  44707. ><B
  44708. CLASS="function"
  44709. >array_diff_assoc()</B
  44710. ></A
  44711. > where an
  44712.      internal function for comparing the indices is used.
  44713.     </P
  44714. ><P
  44715. >      <TABLE
  44716. WIDTH="100%"
  44717. BORDER="0"
  44718. CELLPADDING="0"
  44719. CELLSPACING="0"
  44720. CLASS="EXAMPLE"
  44721. ><TR
  44722. ><TD
  44723. ><DIV
  44724. CLASS="example"
  44725. ><A
  44726. NAME="AEN7574"
  44727. ></A
  44728. ><P
  44729. ><B
  44730. >Beispiel 1. <B
  44731. CLASS="function"
  44732. >array_diff_uassoc()</B
  44733. > example</B
  44734. ></P
  44735. ><TABLE
  44736. BORDER="0"
  44737. BGCOLOR="#E0E0E0"
  44738. CELLPADDING="5"
  44739. ><TR
  44740. ><TD
  44741. ><PRE
  44742. CLASS="php"
  44743. ><?php
  44744. function key_compare_func($a, $b) 
  44745. {
  44746.     if ($a === $b) {
  44747.         return 0;
  44748.     }
  44749.     return ($a > $b)? 1:-1;
  44750. }
  44751.  
  44752. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  44753. $array2 = array("a" => "green", "yellow", "red");
  44754. $result = array_diff_uassoc($array1, $array2, "key_compare_func");
  44755. ?></PRE
  44756. ></TD
  44757. ></TR
  44758. ></TABLE
  44759. ><P
  44760. >        The result is:
  44761.       </P
  44762. ><TABLE
  44763. BORDER="0"
  44764. BGCOLOR="#E0E0E0"
  44765. CELLPADDING="5"
  44766. ><TR
  44767. ><TD
  44768. ><PRE
  44769. CLASS="screen"
  44770. >Array
  44771. (
  44772.     [b] => brown
  44773.     [c] => blue
  44774.     [0] => red
  44775. )</PRE
  44776. ></TD
  44777. ></TR
  44778. ></TABLE
  44779. ></DIV
  44780. ></TD
  44781. ></TR
  44782. ></TABLE
  44783. >
  44784.     </P
  44785. ><P
  44786. >      In our example above you see the <VAR
  44787. CLASS="literal"
  44788. >"a" => "green"</VAR
  44789. >
  44790.      pair is present in both arrays and thus it is not in the ouput from the
  44791.      function. Unlike this, the pair <VAR
  44792. CLASS="literal"
  44793. >0 => "red"</VAR
  44794. >
  44795.      is in the ouput because in the second argument <VAR
  44796. CLASS="literal"
  44797. >"red"</VAR
  44798. >
  44799.      has key which is <VAR
  44800. CLASS="literal"
  44801. >1</VAR
  44802. >.
  44803.     </P
  44804. ><P
  44805. >      The equality of 2 indices is checked by the user supplied callback function.
  44806.     </P
  44807. ><DIV
  44808. CLASS="note"
  44809. ><BLOCKQUOTE
  44810. CLASS="note"
  44811. ><P
  44812. ><B
  44813. >Anmerkung: </B
  44814. >
  44815.       Please note that this function only checks one dimension of a n-dimensional
  44816.       array. Of course you can check deeper dimensions by using, for example,
  44817.       <VAR
  44818. CLASS="literal"
  44819. >array_diff_uassoc($array1[0], $array2[0], "key_compare_func");</VAR
  44820. >.
  44821.      </P
  44822. ></BLOCKQUOTE
  44823. ></DIV
  44824. ><P
  44825. >      See also
  44826.      <A
  44827. HREF="#function.array-diff"
  44828. ><B
  44829. CLASS="function"
  44830. >array_diff()</B
  44831. ></A
  44832. >,
  44833.      <A
  44834. HREF="#function.array-diff-assoc"
  44835. ><B
  44836. CLASS="function"
  44837. >array_diff_assoc()</B
  44838. ></A
  44839. >,
  44840.      <A
  44841. HREF="#function.array-udiff"
  44842. ><B
  44843. CLASS="function"
  44844. >array_udiff()</B
  44845. ></A
  44846. >,
  44847.      <A
  44848. HREF="#function.array-udiff-assoc"
  44849. ><B
  44850. CLASS="function"
  44851. >array_udiff_assoc()</B
  44852. ></A
  44853. >, 
  44854.      <A
  44855. HREF="#function.array-udiff-uassoc"
  44856. ><B
  44857. CLASS="function"
  44858. >array_udiff_uassoc()</B
  44859. ></A
  44860. >, 
  44861.      <A
  44862. HREF="#function.array-intersect"
  44863. ><B
  44864. CLASS="function"
  44865. >array_intersect()</B
  44866. ></A
  44867. >,  
  44868.      <A
  44869. HREF="#function.array-intersect-assoc"
  44870. ><B
  44871. CLASS="function"
  44872. >array_intersect_assoc()</B
  44873. ></A
  44874. >,
  44875.      <A
  44876. HREF="#function.array-uintersect"
  44877. ><B
  44878. CLASS="function"
  44879. >array_uintersect()</B
  44880. ></A
  44881. >,  
  44882.      <A
  44883. HREF="#function.array-uintersect-assoc"
  44884. ><B
  44885. CLASS="function"
  44886. >array_uintersect_assoc()</B
  44887. ></A
  44888. > and 
  44889.      <A
  44890. HREF="#function.array-uintersect-uassoc"
  44891. ><B
  44892. CLASS="function"
  44893. >array_uintersect_uassoc()</B
  44894. ></A
  44895. >.
  44896.     </P
  44897. ></DIV
  44898. ><H1
  44899. ><A
  44900. NAME="function.array-diff-ukey"
  44901. ></A
  44902. >array_diff_ukey</H1
  44903. ><DIV
  44904. CLASS="refnamediv"
  44905. ><A
  44906. NAME="AEN7601"
  44907. ></A
  44908. ><P
  44909. >    (no version information, might be only in CVS)</P
  44910. >array_diff_ukey -- Computes the difference of arrays using a callback function on the keys for comparison</DIV
  44911. ><DIV
  44912. CLASS="refsect1"
  44913. ><A
  44914. NAME="AEN7604"
  44915. ></A
  44916. ><H2
  44917. >Description</H2
  44918. >array <B
  44919. CLASS="methodname"
  44920. >array_diff_ukey</B
  44921. > ( array array1, array array2 [, array ..., callback key_compare_func])<BR
  44922. ></BR
  44923. ><P
  44924. >      <B
  44925. CLASS="function"
  44926. >array_diff_ukey()</B
  44927. > returns an array
  44928.      containing all the values of <VAR
  44929. CLASS="parameter"
  44930. >array1</VAR
  44931. >
  44932.      that have keys that are not present in any of the other arguments.
  44933.      Note that the associativity is preserved. This function is like
  44934.      <A
  44935. HREF="#function.array-diff"
  44936. ><B
  44937. CLASS="function"
  44938. >array_diff()</B
  44939. ></A
  44940. > except the comparison is done on the
  44941.      keys instead of the values.
  44942.     </P
  44943. ><P
  44944. >      This comparison is done by a user supplied callback function.
  44945.      It must return an integer less than, equal to, or greater than zero if the
  44946.      first key is considered to be respectively less than, equal to, or
  44947.      greater than the second.
  44948.     </P
  44949. ><P
  44950. >      <TABLE
  44951. WIDTH="100%"
  44952. BORDER="0"
  44953. CELLPADDING="0"
  44954. CELLSPACING="0"
  44955. CLASS="EXAMPLE"
  44956. ><TR
  44957. ><TD
  44958. ><DIV
  44959. CLASS="example"
  44960. ><A
  44961. NAME="AEN7627"
  44962. ></A
  44963. ><P
  44964. ><B
  44965. >Beispiel 1. <B
  44966. CLASS="function"
  44967. >array_diff_ukey()</B
  44968. > example</B
  44969. ></P
  44970. ><TABLE
  44971. BORDER="0"
  44972. BGCOLOR="#E0E0E0"
  44973. CELLPADDING="5"
  44974. ><TR
  44975. ><TD
  44976. ><PRE
  44977. CLASS="php"
  44978. ><?php
  44979. function key_compare_func($key1, $key2)
  44980. {
  44981.     if ($key1 == $key2)
  44982.         return 0;
  44983.     else if ($key1 > $key2)
  44984.         return 1;
  44985.     else
  44986.         return -1;
  44987. }
  44988.  
  44989. $array1 = array('blue'  => 1, 'red'  => 2, 'green'  => 3, 'purple' => 4);
  44990. $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan'   => 8);
  44991.  
  44992. var_dump(array_diff_ukey($array1, $array2, 'key_compare_func'));
  44993. ?></PRE
  44994. ></TD
  44995. ></TR
  44996. ></TABLE
  44997. ><P
  44998. >        The printout of the above program will be:
  44999.       </P
  45000. ><TABLE
  45001. BORDER="0"
  45002. BGCOLOR="#E0E0E0"
  45003. CELLPADDING="5"
  45004. ><TR
  45005. ><TD
  45006. ><PRE
  45007. CLASS="screen"
  45008. >array(2) {
  45009.   ["red"]=>
  45010.   int(2)
  45011.   ["purple"]=>
  45012.   int(4)
  45013. }</PRE
  45014. ></TD
  45015. ></TR
  45016. ></TABLE
  45017. ></DIV
  45018. ></TD
  45019. ></TR
  45020. ></TABLE
  45021. >
  45022.     </P
  45023. ><P
  45024. >      The two keys from the <VAR
  45025. CLASS="literal"
  45026. >key => value</VAR
  45027. > pairs are
  45028.      considered equal only if 
  45029.      <VAR
  45030. CLASS="literal"
  45031. >(string) $key1 === (string) $key2 </VAR
  45032. >. In other words
  45033.      a strict type check is executed so the string representation must be
  45034.      the same.
  45035.     </P
  45036. ><DIV
  45037. CLASS="note"
  45038. ><BLOCKQUOTE
  45039. CLASS="note"
  45040. ><P
  45041. ><B
  45042. >Anmerkung: </B
  45043. >
  45044.       Please note that this function only checks one dimension of a n-dimensional
  45045.       array. Of course you can check deeper dimensions by using
  45046.       <VAR
  45047. CLASS="literal"
  45048. >array_diff_ukey($array1[0], $array2[0], 'callback_func');</VAR
  45049. >.
  45050.      </P
  45051. ></BLOCKQUOTE
  45052. ></DIV
  45053. ><P
  45054. >      See also <A
  45055. HREF="#function.array-diff"
  45056. ><B
  45057. CLASS="function"
  45058. >array_diff()</B
  45059. ></A
  45060. >,
  45061.      <A
  45062. HREF="#function.array-udiff"
  45063. ><B
  45064. CLASS="function"
  45065. >array_udiff()</B
  45066. ></A
  45067. >
  45068.      <A
  45069. HREF="#function.array-diff-assoc"
  45070. ><B
  45071. CLASS="function"
  45072. >array_diff_assoc()</B
  45073. ></A
  45074. >,
  45075.      <A
  45076. HREF="#function.array-diff-uassoc"
  45077. ><B
  45078. CLASS="function"
  45079. >array_diff_uassoc()</B
  45080. ></A
  45081. >,
  45082.      <A
  45083. HREF="#function.array-udiff-assoc"
  45084. ><B
  45085. CLASS="function"
  45086. >array_udiff_assoc()</B
  45087. ></A
  45088. >,
  45089.      <A
  45090. HREF="#function.array-udiff-uassoc"
  45091. ><B
  45092. CLASS="function"
  45093. >array_udiff_uassoc()</B
  45094. ></A
  45095. >,
  45096.      <A
  45097. HREF="#function.array-diff-key"
  45098. ><B
  45099. CLASS="function"
  45100. >array_diff_key()</B
  45101. ></A
  45102. >,
  45103.      <A
  45104. HREF="#function.array-intersect"
  45105. ><B
  45106. CLASS="function"
  45107. >array_intersect()</B
  45108. ></A
  45109. >,
  45110.      <A
  45111. HREF="#function.array-intersect-assoc"
  45112. ><B
  45113. CLASS="function"
  45114. >array_intersect_assoc()</B
  45115. ></A
  45116. >,
  45117.      <A
  45118. HREF="#function.array-intersect-uassoc"
  45119. ><B
  45120. CLASS="function"
  45121. >array_intersect_uassoc()</B
  45122. ></A
  45123. >,
  45124.      <A
  45125. HREF="#function.array-intersect-key"
  45126. ><B
  45127. CLASS="function"
  45128. >array_intersect_key()</B
  45129. ></A
  45130. > and
  45131.      <A
  45132. HREF="#function.array-intersect-ukey"
  45133. ><B
  45134. CLASS="function"
  45135. >array_intersect_ukey()</B
  45136. ></A
  45137. >.
  45138.     </P
  45139. ></DIV
  45140. ><H1
  45141. ><A
  45142. NAME="function.array-diff"
  45143. ></A
  45144. >array_diff</H1
  45145. ><DIV
  45146. CLASS="refnamediv"
  45147. ><A
  45148. NAME="AEN7653"
  45149. ></A
  45150. ><P
  45151. >    (PHP 4 >= 4.0.1, PHP 5)</P
  45152. >array_diff -- Ermittelt die Unterschiede von Arrays</DIV
  45153. ><DIV
  45154. CLASS="refsect1"
  45155. ><A
  45156. NAME="AEN7656"
  45157. ></A
  45158. ><H2
  45159. >Beschreibung</H2
  45160. >array <B
  45161. CLASS="methodname"
  45162. >array_diff</B
  45163. > ( array array1, array array2 [, array ...])<BR
  45164. ></BR
  45165. ><P
  45166. >      <B
  45167. CLASS="function"
  45168. >array_diff()</B
  45169. > gibt ein Array mit allen Werten von
  45170.      <VAR
  45171. CLASS="parameter"
  45172. >array1</VAR
  45173. >, welche in keinem der anderen Argumente
  45174.      enthalten sind, zurⁿck. Beachten Sie, dass Schlⁿssel erhalten bleiben.
  45175.     </P
  45176. ><P
  45177. >      <TABLE
  45178. WIDTH="100%"
  45179. BORDER="0"
  45180. CELLPADDING="0"
  45181. CELLSPACING="0"
  45182. CLASS="EXAMPLE"
  45183. ><TR
  45184. ><TD
  45185. ><DIV
  45186. CLASS="example"
  45187. ><A
  45188. NAME="AEN7674"
  45189. ></A
  45190. ><P
  45191. ><B
  45192. >Beispiel 1. <B
  45193. CLASS="function"
  45194. >array_diff()</B
  45195. ></B
  45196. ></P
  45197. ><TABLE
  45198. BORDER="0"
  45199. BGCOLOR="#E0E0E0"
  45200. CELLPADDING="5"
  45201. ><TR
  45202. ><TD
  45203. ><PRE
  45204. CLASS="php"
  45205. >$array1 = array ("a" => "grⁿn", "rot", "blau", "rot");
  45206. $array2 = array ("b" => "grⁿn", "gelb", "rot");
  45207. $result = array_diff ($array1, $array2);</PRE
  45208. ></TD
  45209. ></TR
  45210. ></TABLE
  45211. ></DIV
  45212. ></TD
  45213. ></TR
  45214. ></TABLE
  45215. >
  45216.     </P
  45217. ><P
  45218. >      Dies speichert <VAR
  45219. CLASS="literal"
  45220. >array("blau");</VAR
  45221. > in
  45222.      <VAR
  45223. CLASS="varname"
  45224. >$result</VAR
  45225. >.  Mehrfache Vorkommen in $array1
  45226.      werden auf die gleiche Weise behandelt.
  45227.     </P
  45228. ><DIV
  45229. CLASS="note"
  45230. ><BLOCKQUOTE
  45231. CLASS="note"
  45232. ><P
  45233. ><B
  45234. >Anmerkung: </B
  45235. >
  45236.       Zwei Elemente werden nur dann als gleich angesehen, wenn
  45237.       <VAR
  45238. CLASS="literal"
  45239. >(string) $elem1 === (string) $elem2</VAR
  45240. >. In Worten:
  45241.       Wenn die String-ReprΣsentation die gleiche ist.
  45242.      </P
  45243. ></BLOCKQUOTE
  45244. ></DIV
  45245. ><DIV
  45246. CLASS="note"
  45247. ><BLOCKQUOTE
  45248. CLASS="note"
  45249. ><P
  45250. ><B
  45251. >Anmerkung: </B
  45252. >
  45253.       Beachten Sie, dass diese Funktion nur eine Dimension eines n-dimensionalen
  45254.       Arrays prⁿft. Natⁿrlich k÷nnen Sie tiefere Dimensionen prⁿfen, indem Sie
  45255.       z.B. <VAR
  45256. CLASS="literal"
  45257. >array_diff($array1[0], $array2[0]);</VAR
  45258. > benutzen.
  45259.      </P
  45260. ></BLOCKQUOTE
  45261. ></DIV
  45262. ><DIV
  45263. CLASS="warning"
  45264. ><P
  45265. ></P
  45266. ><TABLE
  45267. CLASS="warning"
  45268. BORDER="1"
  45269. WIDTH="100%"
  45270. ><TR
  45271. ><TD
  45272. ALIGN="CENTER"
  45273. ><B
  45274. >Warnung</B
  45275. ></TD
  45276. ></TR
  45277. ><TR
  45278. ><TD
  45279. ALIGN="LEFT"
  45280. ><P
  45281. >       Dies war in PHP 4.0.4 fehlerhaft!
  45282.      </P
  45283. ></TD
  45284. ></TR
  45285. ></TABLE
  45286. ></DIV
  45287. ><P
  45288. >      Siehe auch <A
  45289. HREF="#function.array-diff-assoc"
  45290. ><B
  45291. CLASS="function"
  45292. >array_diff_assoc()</B
  45293. ></A
  45294. >,
  45295.      <A
  45296. HREF="#function.array-intersect"
  45297. ><B
  45298. CLASS="function"
  45299. >array_intersect()</B
  45300. ></A
  45301. > und
  45302.      <A
  45303. HREF="#function.array-intersect-assoc"
  45304. ><B
  45305. CLASS="function"
  45306. >array_intersect_assoc()</B
  45307. ></A
  45308. >.
  45309.     </P
  45310. ></DIV
  45311. ><H1
  45312. ><A
  45313. NAME="function.array-fill"
  45314. ></A
  45315. >array_fill</H1
  45316. ><DIV
  45317. CLASS="refnamediv"
  45318. ><A
  45319. NAME="AEN7694"
  45320. ></A
  45321. ><P
  45322. >    (PHP 4 >= 4.2.0, PHP 5)</P
  45323. >array_fill -- Fⁿllt ein Array mit Werten</DIV
  45324. ><DIV
  45325. CLASS="refsect1"
  45326. ><A
  45327. NAME="AEN7697"
  45328. ></A
  45329. ><H2
  45330. >Beschreibung</H2
  45331. >array <B
  45332. CLASS="methodname"
  45333. >array_fill</B
  45334. > ( int start_index, int num, mixed value)<BR
  45335. ></BR
  45336. ><P
  45337. >      <B
  45338. CLASS="function"
  45339. >array_fill()</B
  45340. > fⁿllt ein Array mit
  45341.      <VAR
  45342. CLASS="parameter"
  45343. >num</VAR
  45344. > EintrΣgen des Wertes des
  45345.      <VAR
  45346. CLASS="parameter"
  45347. >value</VAR
  45348. > Parameters. Die Indizes des Arrays
  45349.      beginnen mit dem <VAR
  45350. CLASS="parameter"
  45351. >start_index</VAR
  45352. > Parameter.
  45353.      Beachten Sie, dass <VAR
  45354. CLASS="parameter"
  45355. >num</VAR
  45356. > eine Zahl gr÷▀er als
  45357.      Null sein muss, ansonsten gibt PHP eine Warnung aus.
  45358.     </P
  45359. ><P
  45360. >      <TABLE
  45361. WIDTH="100%"
  45362. BORDER="0"
  45363. CELLPADDING="0"
  45364. CELLSPACING="0"
  45365. CLASS="EXAMPLE"
  45366. ><TR
  45367. ><TD
  45368. ><DIV
  45369. CLASS="example"
  45370. ><A
  45371. NAME="AEN7718"
  45372. ></A
  45373. ><P
  45374. ><B
  45375. >Beispiel 1. <B
  45376. CLASS="function"
  45377. >array_fill()</B
  45378. ></B
  45379. ></P
  45380. ><TABLE
  45381. BORDER="0"
  45382. BGCOLOR="#E0E0E0"
  45383. CELLPADDING="5"
  45384. ><TR
  45385. ><TD
  45386. ><PRE
  45387. CLASS="php"
  45388. ><?php
  45389. $a = array_fill(5, 6, 'Banane');
  45390. print_r($a);
  45391. ?></PRE
  45392. ></TD
  45393. ></TR
  45394. ></TABLE
  45395. ><P
  45396. >        Nun ist <VAR
  45397. CLASS="varname"
  45398. >$a</VAR
  45399. >:
  45400.       </P
  45401. ><TABLE
  45402. BORDER="0"
  45403. BGCOLOR="#E0E0E0"
  45404. CELLPADDING="5"
  45405. ><TR
  45406. ><TD
  45407. ><PRE
  45408. CLASS="screen"
  45409. >Array
  45410. (
  45411.     [5]  => Banane
  45412.     [6]  => Banane
  45413.     [7]  => Banane
  45414.     [8]  => Banane
  45415.     [9]  => Banane
  45416.     [10] => Banane
  45417. )</PRE
  45418. ></TD
  45419. ></TR
  45420. ></TABLE
  45421. ></DIV
  45422. ></TD
  45423. ></TR
  45424. ></TABLE
  45425. >
  45426.     </P
  45427. ></DIV
  45428. ><H1
  45429. ><A
  45430. NAME="function.array-filter"
  45431. ></A
  45432. >array_filter</H1
  45433. ><DIV
  45434. CLASS="refnamediv"
  45435. ><A
  45436. NAME="AEN7726"
  45437. ></A
  45438. ><P
  45439. >    (PHP 4 >= 4.0.6, PHP 5)</P
  45440. >array_filter -- 
  45441.      Filtert Elemente eines Arrays mittels einer Callback-Funktion
  45442.     </DIV
  45443. ><DIV
  45444. CLASS="refsect1"
  45445. ><A
  45446. NAME="AEN7729"
  45447. ></A
  45448. ><H2
  45449. >Beschreibung</H2
  45450. >array <B
  45451. CLASS="methodname"
  45452. >array_filter</B
  45453. > ( array input [, callback function])<BR
  45454. ></BR
  45455. ><P
  45456. >      <B
  45457. CLASS="function"
  45458. >array_filter()</B
  45459. > ⁿbergibt nacheinander alle Werte in dem
  45460.      Array <VAR
  45461. CLASS="parameter"
  45462. >input</VAR
  45463. > and die <VAR
  45464. CLASS="parameter"
  45465. >callback</VAR
  45466. >
  45467.      Funktion. Gibt die <VAR
  45468. CLASS="parameter"
  45469. >callback</VAR
  45470. > Funktion true zurⁿck,
  45471.      wird der aktuelle Wert von <VAR
  45472. CLASS="parameter"
  45473. >input</VAR
  45474. > in das Ergebnis-Array
  45475.      geschrieben. Die Schlⁿssel des Arrays bleiben erhalten.
  45476.     </P
  45477. ><P
  45478. >      <TABLE
  45479. WIDTH="100%"
  45480. BORDER="0"
  45481. CELLPADDING="0"
  45482. CELLSPACING="0"
  45483. CLASS="EXAMPLE"
  45484. ><TR
  45485. ><TD
  45486. ><DIV
  45487. CLASS="example"
  45488. ><A
  45489. NAME="AEN7747"
  45490. ></A
  45491. ><P
  45492. ><B
  45493. >Beispiel 1. <B
  45494. CLASS="function"
  45495. >array_filter()</B
  45496. ></B
  45497. ></P
  45498. ><TABLE
  45499. BORDER="0"
  45500. BGCOLOR="#E0E0E0"
  45501. CELLPADDING="5"
  45502. ><TR
  45503. ><TD
  45504. ><PRE
  45505. CLASS="php"
  45506. ><?php
  45507. function ungerade($var) {
  45508.     return ($var % 2 == 1);
  45509. }
  45510.  
  45511. function gerade($var) {
  45512.     return ($var % 2 == 0);
  45513. }
  45514.  
  45515. $array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);
  45516. $array2 = array (6, 7, 8, 9, 10, 11, 12);
  45517.  
  45518. echo "Ungerade :\n";
  45519. print_r(array_filter($array1, "ungerade"));
  45520. echo "Gerade:\n";
  45521. print_r(array_filter($array2, "gerade"));
  45522. ?></PRE
  45523. ></TD
  45524. ></TR
  45525. ></TABLE
  45526. ><P
  45527. >        Wird folgendes ausgeben:
  45528.       </P
  45529. ><TABLE
  45530. BORDER="0"
  45531. BGCOLOR="#E0E0E0"
  45532. CELLPADDING="5"
  45533. ><TR
  45534. ><TD
  45535. ><PRE
  45536. CLASS="php"
  45537. >Ungerade :
  45538. Array
  45539. (
  45540.     [a] => 1
  45541.     [c] => 3
  45542.     [e] => 5
  45543. )
  45544. Gerade:
  45545. Array
  45546. (
  45547.     [0] => 6
  45548.     [2] => 8
  45549.     [4] => 10
  45550.     [6] => 12
  45551. )</PRE
  45552. ></TD
  45553. ></TR
  45554. ></TABLE
  45555. ></DIV
  45556. ></TD
  45557. ></TR
  45558. ></TABLE
  45559. >
  45560.     </P
  45561. ><P
  45562. >      Von der Benutzerfunktion aus darf das Array selbst nicht geΣndert
  45563.      werden, wie zum Beispiel durch Hinzufⁿgen oder L÷schen eines
  45564.      Elementes, oder auch L÷schen des Arrays, auf das
  45565.      <B
  45566. CLASS="function"
  45567. >array_filter()</B
  45568. > angewendet wird. Ist das Array
  45569.      geΣndert, so ist das Verhalten dieser Funktion undefiniert.
  45570.     </P
  45571. ><P
  45572. >      Siehe auch <A
  45573. HREF="#function.array-map"
  45574. ><B
  45575. CLASS="function"
  45576. >array_map()</B
  45577. ></A
  45578. >,
  45579.      <A
  45580. HREF="#function.array-reduce"
  45581. ><B
  45582. CLASS="function"
  45583. >array_reduce()</B
  45584. ></A
  45585. > und <A
  45586. HREF="#function.array-walk"
  45587. ><B
  45588. CLASS="function"
  45589. >array_walk()</B
  45590. ></A
  45591. >.
  45592.     </P
  45593. ></DIV
  45594. ><H1
  45595. ><A
  45596. NAME="function.array-flip"
  45597. ></A
  45598. >array_flip</H1
  45599. ><DIV
  45600. CLASS="refnamediv"
  45601. ><A
  45602. NAME="AEN7760"
  45603. ></A
  45604. ><P
  45605. >    (PHP 4 , PHP 5)</P
  45606. >array_flip -- Vertauscht Werte und Schlⁿssel in einem Array</DIV
  45607. ><DIV
  45608. CLASS="refsect1"
  45609. ><A
  45610. NAME="AEN7763"
  45611. ></A
  45612. ><H2
  45613. >Beschreibung</H2
  45614. >array <B
  45615. CLASS="methodname"
  45616. >array_flip</B
  45617. > ( array trans)<BR
  45618. ></BR
  45619. ><P
  45620. >      <B
  45621. CLASS="function"
  45622. >array_flip()</B
  45623. > gibt ein Array
  45624.      in umgekehrter Reihenfolge zurⁿck, d.h. Schlⁿssel von
  45625.      <VAR
  45626. CLASS="parameter"
  45627. >trans</VAR
  45628. > werden Werte, und die Werte
  45629.      von <VAR
  45630. CLASS="parameter"
  45631. >trans</VAR
  45632. > werden zu Schlⁿsseln.
  45633.     </P
  45634. ><P
  45635. >      Beachten Sie, dass die Werte von <VAR
  45636. CLASS="parameter"
  45637. >trans</VAR
  45638. > gⁿltige
  45639.      Schlⁿssel sein mⁿssen, z.B. haben sie entweder <A
  45640. HREF="#language.types.integer"
  45641. ><B
  45642. CLASS="type"
  45643. >integer</B
  45644. ></A
  45645. >
  45646.      oder <A
  45647. HREF="#language.types.string"
  45648. ><B
  45649. CLASS="type"
  45650. >string</B
  45651. ></A
  45652. > zu sein. Ist ein Wert vom falschen Typ wird
  45653.      eine Warnung ausgegeben, und das Schlⁿssel/Werte-Paar <SPAN
  45654. CLASS="emphasis"
  45655. ><I
  45656. CLASS="emphasis"
  45657. >wird
  45658.      nicht vertauscht</I
  45659. ></SPAN
  45660. >.
  45661.     </P
  45662. ><P
  45663. >      Kommt ein Wert mehrmals vor, wird der letzte Schlⁿssel mit seinem
  45664.      Wert vertauscht, und alle anderen Schlⁿssel- Wertepaare gehen
  45665.      verloren.
  45666.     </P
  45667. ><P
  45668. >      <B
  45669. CLASS="function"
  45670. >array_flip()</B
  45671. > gibt im Fehlerfall
  45672.      <TT
  45673. CLASS="constant"
  45674. ><B
  45675. >FALSE</B
  45676. ></TT
  45677. > zurⁿck.
  45678.     </P
  45679. ><P
  45680. >      <TABLE
  45681. WIDTH="100%"
  45682. BORDER="0"
  45683. CELLPADDING="0"
  45684. CELLSPACING="0"
  45685. CLASS="EXAMPLE"
  45686. ><TR
  45687. ><TD
  45688. ><DIV
  45689. CLASS="example"
  45690. ><A
  45691. NAME="AEN7786"
  45692. ></A
  45693. ><P
  45694. ><B
  45695. >Beispiel 1. <B
  45696. CLASS="function"
  45697. >array_flip()</B
  45698. ></B
  45699. ></P
  45700. ><TABLE
  45701. BORDER="0"
  45702. BGCOLOR="#E0E0E0"
  45703. CELLPADDING="5"
  45704. ><TR
  45705. ><TD
  45706. ><PRE
  45707. CLASS="php"
  45708. ><?php
  45709. $trans = array_flip ($trans);
  45710. $original = strtr ($str, $trans);
  45711. ?></PRE
  45712. ></TD
  45713. ></TR
  45714. ></TABLE
  45715. ></DIV
  45716. ></TD
  45717. ></TR
  45718. ></TABLE
  45719. >
  45720.     </P
  45721. ><P
  45722. >      <TABLE
  45723. WIDTH="100%"
  45724. BORDER="0"
  45725. CELLPADDING="0"
  45726. CELLSPACING="0"
  45727. CLASS="EXAMPLE"
  45728. ><TR
  45729. ><TD
  45730. ><DIV
  45731. CLASS="example"
  45732. ><A
  45733. NAME="AEN7791"
  45734. ></A
  45735. ><P
  45736. ><B
  45737. >Beispiel 2. <B
  45738. CLASS="function"
  45739. >array_flip()</B
  45740. >: Kollision</B
  45741. ></P
  45742. ><TABLE
  45743. BORDER="0"
  45744. BGCOLOR="#E0E0E0"
  45745. CELLPADDING="5"
  45746. ><TR
  45747. ><TD
  45748. ><PRE
  45749. CLASS="php"
  45750. ><?php
  45751. $trans = array ("a" => 1, "b" => 1, "c" => 2);
  45752. $trans = array_flip ($trans);
  45753. print_r($trans);
  45754. ?></PRE
  45755. ></TD
  45756. ></TR
  45757. ></TABLE
  45758. ><P
  45759. >        Nun ist <VAR
  45760. CLASS="varname"
  45761. >$trans</VAR
  45762. >:
  45763.       </P
  45764. ><TABLE
  45765. BORDER="0"
  45766. BGCOLOR="#E0E0E0"
  45767. CELLPADDING="5"
  45768. ><TR
  45769. ><TD
  45770. ><PRE
  45771. CLASS="screen"
  45772. >Array
  45773. (
  45774.     [1] => b
  45775.     [2] => c
  45776. )</PRE
  45777. ></TD
  45778. ></TR
  45779. ></TABLE
  45780. ></DIV
  45781. ></TD
  45782. ></TR
  45783. ></TABLE
  45784. >
  45785.     </P
  45786. ></DIV
  45787. ><H1
  45788. ><A
  45789. NAME="function.array-intersect-assoc"
  45790. ></A
  45791. >array_intersect_assoc</H1
  45792. ><DIV
  45793. CLASS="refnamediv"
  45794. ><A
  45795. NAME="AEN7799"
  45796. ></A
  45797. ><P
  45798. >    (PHP 4 >= 4.3.0, PHP 5)</P
  45799. >array_intersect_assoc -- Computes the intersection of arrays with additional index check</DIV
  45800. ><DIV
  45801. CLASS="refsect1"
  45802. ><A
  45803. NAME="AEN7802"
  45804. ></A
  45805. ><H2
  45806. >Description</H2
  45807. >array <B
  45808. CLASS="methodname"
  45809. >array_intersect_assoc</B
  45810. > ( array array1, array array2 [, array ...])<BR
  45811. ></BR
  45812. ><P
  45813. >      <B
  45814. CLASS="function"
  45815. >array_intersect_assoc()</B
  45816. > returns an array
  45817.      containing all the values of <VAR
  45818. CLASS="parameter"
  45819. >array1</VAR
  45820. >
  45821.      that are present in all the arguments. Note that the keys are used in
  45822.      the comparison unlike in <A
  45823. HREF="#function.array-intersect"
  45824. ><B
  45825. CLASS="function"
  45826. >array_intersect()</B
  45827. ></A
  45828. >.
  45829.     </P
  45830. ><P
  45831. >      <TABLE
  45832. WIDTH="100%"
  45833. BORDER="0"
  45834. CELLPADDING="0"
  45835. CELLSPACING="0"
  45836. CLASS="EXAMPLE"
  45837. ><TR
  45838. ><TD
  45839. ><DIV
  45840. CLASS="example"
  45841. ><A
  45842. NAME="AEN7821"
  45843. ></A
  45844. ><P
  45845. ><B
  45846. >Beispiel 1. <B
  45847. CLASS="function"
  45848. >array_intersect_assoc()</B
  45849. > example</B
  45850. ></P
  45851. ><TABLE
  45852. BORDER="0"
  45853. BGCOLOR="#E0E0E0"
  45854. CELLPADDING="5"
  45855. ><TR
  45856. ><TD
  45857. ><PRE
  45858. CLASS="php"
  45859. ><?php
  45860. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  45861. $array2 = array("a" => "green", "yellow", "red");
  45862. $result_array = array_intersect_assoc($array1, $array2);
  45863. ?></PRE
  45864. ></TD
  45865. ></TR
  45866. ></TABLE
  45867. ><P
  45868. >        $result_array will look like:
  45869.       </P
  45870. ><TABLE
  45871. BORDER="0"
  45872. BGCOLOR="#E0E0E0"
  45873. CELLPADDING="5"
  45874. ><TR
  45875. ><TD
  45876. ><PRE
  45877. CLASS="screen"
  45878. >Array
  45879. (
  45880.     [a] => green
  45881. )</PRE
  45882. ></TD
  45883. ></TR
  45884. ></TABLE
  45885. ></DIV
  45886. ></TD
  45887. ></TR
  45888. ></TABLE
  45889. >
  45890.     </P
  45891. ><P
  45892. >      In our example you see that only the pair <VAR
  45893. CLASS="literal"
  45894. >"a" =>
  45895.      "green"</VAR
  45896. > is present in both arrays and thus is returned. 
  45897.      The value <VAR
  45898. CLASS="literal"
  45899. >"red"</VAR
  45900. > is not returned because in 
  45901.      <VAR
  45902. CLASS="varname"
  45903. >$array1</VAR
  45904. > its key is <VAR
  45905. CLASS="literal"
  45906. >0</VAR
  45907. > while
  45908.      the key of "red" in <VAR
  45909. CLASS="varname"
  45910. >$array2</VAR
  45911. > is 
  45912.      <VAR
  45913. CLASS="literal"
  45914. >1</VAR
  45915. >.
  45916.     </P
  45917. ><P
  45918. >      The two values from the <VAR
  45919. CLASS="literal"
  45920. >key => value</VAR
  45921. > pairs are
  45922.      considered equal only if 
  45923.      <VAR
  45924. CLASS="literal"
  45925. >(string) $elem1 === (string) $elem2 </VAR
  45926. >. In otherwords
  45927.      a strict type check is executed so the string representation must be
  45928.      the same. 
  45929.      
  45930.     </P
  45931. ><P
  45932. >      See also <A
  45933. HREF="#function.array-intersect"
  45934. ><B
  45935. CLASS="function"
  45936. >array_intersect()</B
  45937. ></A
  45938. >,
  45939.      <A
  45940. HREF="#function.array-uintersect-assoc"
  45941. ><B
  45942. CLASS="function"
  45943. >array_uintersect_assoc()</B
  45944. ></A
  45945. >,
  45946.      <A
  45947. HREF="#function.array-intersect-uassoc"
  45948. ><B
  45949. CLASS="function"
  45950. >array_intersect_uassoc()</B
  45951. ></A
  45952. >,
  45953.      <A
  45954. HREF="#function.array-uintersect-uassoc"
  45955. ><B
  45956. CLASS="function"
  45957. >array_uintersect_uassoc()</B
  45958. ></A
  45959. >,
  45960.      <A
  45961. HREF="#function.array-diff"
  45962. ><B
  45963. CLASS="function"
  45964. >array_diff()</B
  45965. ></A
  45966. > and
  45967.      <A
  45968. HREF="#function.array-diff-assoc"
  45969. ><B
  45970. CLASS="function"
  45971. >array_diff_assoc()</B
  45972. ></A
  45973. >.
  45974.     </P
  45975. ></DIV
  45976. ><H1
  45977. ><A
  45978. NAME="function.array-intersect-key"
  45979. ></A
  45980. >array_intersect_key</H1
  45981. ><DIV
  45982. CLASS="refnamediv"
  45983. ><A
  45984. NAME="AEN7845"
  45985. ></A
  45986. ><P
  45987. >    (no version information, might be only in CVS)</P
  45988. >array_intersect_key -- Computes the intersection of arrays using keys for comparison</DIV
  45989. ><DIV
  45990. CLASS="refsect1"
  45991. ><A
  45992. NAME="AEN7848"
  45993. ></A
  45994. ><H2
  45995. >Description</H2
  45996. >array <B
  45997. CLASS="methodname"
  45998. >array_intersect_key</B
  45999. > ( array array1, array array2 [, array ...])<BR
  46000. ></BR
  46001. ><P
  46002. >      <B
  46003. CLASS="function"
  46004. >array_intersect_key()</B
  46005. > returns an array
  46006.      containing all the values of <VAR
  46007. CLASS="parameter"
  46008. >array1</VAR
  46009. >
  46010.      which have matching keys that are present in all the arguments.
  46011.     </P
  46012. ><P
  46013. >      <TABLE
  46014. WIDTH="100%"
  46015. BORDER="0"
  46016. CELLPADDING="0"
  46017. CELLSPACING="0"
  46018. CLASS="EXAMPLE"
  46019. ><TR
  46020. ><TD
  46021. ><DIV
  46022. CLASS="example"
  46023. ><A
  46024. NAME="AEN7866"
  46025. ></A
  46026. ><P
  46027. ><B
  46028. >Beispiel 1. <B
  46029. CLASS="function"
  46030. >array_intersect_key()</B
  46031. > example</B
  46032. ></P
  46033. ><TABLE
  46034. BORDER="0"
  46035. BGCOLOR="#E0E0E0"
  46036. CELLPADDING="5"
  46037. ><TR
  46038. ><TD
  46039. ><PRE
  46040. CLASS="php"
  46041. ><?php
  46042. $array1 = array('blue'  => 1, 'red'  => 2, 'green'  => 3, 'purple' => 4);
  46043. $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan'   => 8);
  46044.  
  46045. var_dump(array_intersect_key($array1, $array2));
  46046. ?></PRE
  46047. ></TD
  46048. ></TR
  46049. ></TABLE
  46050. ><P
  46051. >        The printout of the above program will be:
  46052.       </P
  46053. ><TABLE
  46054. BORDER="0"
  46055. BGCOLOR="#E0E0E0"
  46056. CELLPADDING="5"
  46057. ><TR
  46058. ><TD
  46059. ><PRE
  46060. CLASS="screen"
  46061. >array(2) {
  46062.   ["blue"]=>
  46063.   int(1)
  46064.   ["green"]=>
  46065.   int(3)
  46066. })</PRE
  46067. ></TD
  46068. ></TR
  46069. ></TABLE
  46070. ></DIV
  46071. ></TD
  46072. ></TR
  46073. ></TABLE
  46074. >
  46075.     </P
  46076. ><P
  46077. >      In our example you see that only the keys <VAR
  46078. CLASS="literal"
  46079. >'blue'</VAR
  46080. >
  46081.      and <VAR
  46082. CLASS="literal"
  46083. >'green'</VAR
  46084. > are present in both arrays and thus
  46085.      returned. Also notice that the values for the keys
  46086.      <VAR
  46087. CLASS="literal"
  46088. >'blue'</VAR
  46089. > and <VAR
  46090. CLASS="literal"
  46091. >'green'</VAR
  46092. > differ between
  46093.      the two arrays. A match still occurs because only the keys are checked.
  46094.      The values returned are those of <VAR
  46095. CLASS="parameter"
  46096. >array1</VAR
  46097. >.
  46098.     </P
  46099. ><P
  46100. >      The two keys from the <VAR
  46101. CLASS="literal"
  46102. >key => value</VAR
  46103. > pairs are
  46104.      considered equal only if 
  46105.      <VAR
  46106. CLASS="literal"
  46107. >(string) $key1 === (string) $key2 </VAR
  46108. >. In other words
  46109.      a strict type check is executed so the string representation must be
  46110.      the same.
  46111.     </P
  46112. ><P
  46113. >      See also <A
  46114. HREF="#function.array-diff"
  46115. ><B
  46116. CLASS="function"
  46117. >array_diff()</B
  46118. ></A
  46119. >,
  46120.      <A
  46121. HREF="#function.array-udiff"
  46122. ><B
  46123. CLASS="function"
  46124. >array_udiff()</B
  46125. ></A
  46126. >
  46127.      <A
  46128. HREF="#function.array-diff-assoc"
  46129. ><B
  46130. CLASS="function"
  46131. >array_diff_assoc()</B
  46132. ></A
  46133. >,
  46134.      <A
  46135. HREF="#function.array-diff-uassoc"
  46136. ><B
  46137. CLASS="function"
  46138. >array_diff_uassoc()</B
  46139. ></A
  46140. >,
  46141.      <A
  46142. HREF="#function.array-udiff-assoc"
  46143. ><B
  46144. CLASS="function"
  46145. >array_udiff_assoc()</B
  46146. ></A
  46147. >,
  46148.      <A
  46149. HREF="#function.array-udiff-uassoc"
  46150. ><B
  46151. CLASS="function"
  46152. >array_udiff_uassoc()</B
  46153. ></A
  46154. >,
  46155.      <A
  46156. HREF="#function.array-diff-key"
  46157. ><B
  46158. CLASS="function"
  46159. >array_diff_key()</B
  46160. ></A
  46161. >,
  46162.      <A
  46163. HREF="#function.array-diff-ukey"
  46164. ><B
  46165. CLASS="function"
  46166. >array_diff_ukey()</B
  46167. ></A
  46168. >,
  46169.      <A
  46170. HREF="#function.array-intersect"
  46171. ><B
  46172. CLASS="function"
  46173. >array_intersect()</B
  46174. ></A
  46175. >,
  46176.      <A
  46177. HREF="#function.array-intersect-assoc"
  46178. ><B
  46179. CLASS="function"
  46180. >array_intersect_assoc()</B
  46181. ></A
  46182. >,
  46183.      <A
  46184. HREF="#function.array-intersect-uassoc"
  46185. ><B
  46186. CLASS="function"
  46187. >array_intersect_uassoc()</B
  46188. ></A
  46189. > and
  46190.      <A
  46191. HREF="#function.array-intersect-ukey"
  46192. ><B
  46193. CLASS="function"
  46194. >array_intersect_ukey()</B
  46195. ></A
  46196. >.
  46197.     </P
  46198. ></DIV
  46199. ><H1
  46200. ><A
  46201. NAME="function.array-intersect-uassoc"
  46202. ></A
  46203. >array_intersect_uassoc</H1
  46204. ><DIV
  46205. CLASS="refnamediv"
  46206. ><A
  46207. NAME="AEN7895"
  46208. ></A
  46209. ><P
  46210. >    (PHP 5)</P
  46211. >array_intersect_uassoc -- Computes the intersection of arrays with additional index check. The indexes are compared by using a callback function</DIV
  46212. ><DIV
  46213. CLASS="refsect1"
  46214. ><A
  46215. NAME="AEN7898"
  46216. ></A
  46217. ><H2
  46218. >Description</H2
  46219. >array <B
  46220. CLASS="methodname"
  46221. >array_intersect_uassoc</B
  46222. > ( array array1, array array2 [, array ..., callback key_compare_func])<BR
  46223. ></BR
  46224. ><P
  46225. >      <B
  46226. CLASS="function"
  46227. >array_intersect_uassoc()</B
  46228. > returns an array
  46229.      containing all the values of <VAR
  46230. CLASS="parameter"
  46231. >array1</VAR
  46232. >
  46233.      that are present in all the arguments. Note that the keys are used in
  46234.      the comparison unlike in <A
  46235. HREF="#function.array-intersect"
  46236. ><B
  46237. CLASS="function"
  46238. >array_intersect()</B
  46239. ></A
  46240. >.
  46241.     </P
  46242. ><P
  46243. >      The index comparison is done by a user supplied callback function.
  46244.      It must return an integer less than, equal to, or greater than zero
  46245.      if the first argument is considered to be respectively less than,
  46246.      equal to, or greater than the second.
  46247.     </P
  46248. ><P
  46249. >      <TABLE
  46250. WIDTH="100%"
  46251. BORDER="0"
  46252. CELLPADDING="0"
  46253. CELLSPACING="0"
  46254. CLASS="EXAMPLE"
  46255. ><TR
  46256. ><TD
  46257. ><DIV
  46258. CLASS="example"
  46259. ><A
  46260. NAME="AEN7921"
  46261. ></A
  46262. ><P
  46263. ><B
  46264. >Beispiel 1. <B
  46265. CLASS="function"
  46266. >array_intersect_uassoc()</B
  46267. > example</B
  46268. ></P
  46269. ><TABLE
  46270. BORDER="0"
  46271. BGCOLOR="#E0E0E0"
  46272. CELLPADDING="5"
  46273. ><TR
  46274. ><TD
  46275. ><PRE
  46276. CLASS="php"
  46277. ><?php
  46278. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  46279. $array2 = array("a" => "GREEN", "B" => "brown", "yellow", "red");
  46280.  
  46281. print_r(array_intersect_uassoc($array1, $array2, "strcasecmp"));
  46282. ?></PRE
  46283. ></TD
  46284. ></TR
  46285. ></TABLE
  46286. ><P
  46287. >        Result will look like:
  46288.       </P
  46289. ><TABLE
  46290. BORDER="0"
  46291. BGCOLOR="#E0E0E0"
  46292. CELLPADDING="5"
  46293. ><TR
  46294. ><TD
  46295. ><PRE
  46296. CLASS="screen"
  46297. >Array
  46298. (
  46299.     [b] => brown
  46300. )</PRE
  46301. ></TD
  46302. ></TR
  46303. ></TABLE
  46304. ></DIV
  46305. ></TD
  46306. ></TR
  46307. ></TABLE
  46308. >
  46309.     </P
  46310. ><P
  46311. >      See also <A
  46312. HREF="#function.array-intersect"
  46313. ><B
  46314. CLASS="function"
  46315. >array_intersect()</B
  46316. ></A
  46317. >,
  46318.      <A
  46319. HREF="#function.array-intersect-assoc"
  46320. ><B
  46321. CLASS="function"
  46322. >array_intersect_assoc()</B
  46323. ></A
  46324. >,
  46325.      <A
  46326. HREF="#function.array-uintersect-assoc"
  46327. ><B
  46328. CLASS="function"
  46329. >array_uintersect_assoc()</B
  46330. ></A
  46331. >,
  46332.      <A
  46333. HREF="#function.array-uintersect-uassoc"
  46334. ><B
  46335. CLASS="function"
  46336. >array_uintersect_uassoc()</B
  46337. ></A
  46338. >,
  46339.      <A
  46340. HREF="#function.array-intersect-key"
  46341. ><B
  46342. CLASS="function"
  46343. >array_intersect_key()</B
  46344. ></A
  46345. > and
  46346.      <A
  46347. HREF="#function.array-intersect-ukey"
  46348. ><B
  46349. CLASS="function"
  46350. >array_intersect_ukey()</B
  46351. ></A
  46352. >.
  46353.     </P
  46354. ></DIV
  46355. ><H1
  46356. ><A
  46357. NAME="function.array-intersect-ukey"
  46358. ></A
  46359. >array_intersect_ukey</H1
  46360. ><DIV
  46361. CLASS="refnamediv"
  46362. ><A
  46363. NAME="AEN7935"
  46364. ></A
  46365. ><P
  46366. >    (no version information, might be only in CVS)</P
  46367. >array_intersect_ukey -- Computes the intersection of arrays using a callback function on the keys for comparison</DIV
  46368. ><DIV
  46369. CLASS="refsect1"
  46370. ><A
  46371. NAME="AEN7938"
  46372. ></A
  46373. ><H2
  46374. >Description</H2
  46375. >array <B
  46376. CLASS="methodname"
  46377. >array_intersect_ukey</B
  46378. > ( array array1, array array2 [, array ..., callback key_compare_func])<BR
  46379. ></BR
  46380. ><P
  46381. >      <B
  46382. CLASS="function"
  46383. >array_intersect_ukey()</B
  46384. > returns an array
  46385.      containing all the values of <VAR
  46386. CLASS="parameter"
  46387. >array1</VAR
  46388. >
  46389.      which have matching keys that are present in all the arguments.
  46390.     </P
  46391. ><P
  46392. >      This comparison is done by a user supplied callback function.
  46393.      It must return an integer less than, equal to, or greater than zero if the
  46394.      first key is considered to be respectively less than, equal to, or
  46395.      greater than the second.
  46396.     </P
  46397. ><P
  46398. >      <TABLE
  46399. WIDTH="100%"
  46400. BORDER="0"
  46401. CELLPADDING="0"
  46402. CELLSPACING="0"
  46403. CLASS="EXAMPLE"
  46404. ><TR
  46405. ><TD
  46406. ><DIV
  46407. CLASS="example"
  46408. ><A
  46409. NAME="AEN7960"
  46410. ></A
  46411. ><P
  46412. ><B
  46413. >Beispiel 1. <B
  46414. CLASS="function"
  46415. >array_intersect_ukey()</B
  46416. > example</B
  46417. ></P
  46418. ><TABLE
  46419. BORDER="0"
  46420. BGCOLOR="#E0E0E0"
  46421. CELLPADDING="5"
  46422. ><TR
  46423. ><TD
  46424. ><PRE
  46425. CLASS="php"
  46426. ><?php
  46427. function key_compare_func($key1, $key2)
  46428. {
  46429.     if ($key1 == $key2)
  46430.         return 0;
  46431.     else if ($key1 > $key2)
  46432.         return 1;
  46433.     else
  46434.         return -1;
  46435. }
  46436.  
  46437. $array1 = array('blue'  => 1, 'red'  => 2, 'green'  => 3, 'purple' => 4);
  46438. $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan'   => 8);
  46439.  
  46440. var_dump(array_intersect_ukey($array1, $array2, 'key_compare_func'));
  46441. ?></PRE
  46442. ></TD
  46443. ></TR
  46444. ></TABLE
  46445. ><P
  46446. >        The printout of the above program will be:
  46447.       </P
  46448. ><TABLE
  46449. BORDER="0"
  46450. BGCOLOR="#E0E0E0"
  46451. CELLPADDING="5"
  46452. ><TR
  46453. ><TD
  46454. ><PRE
  46455. CLASS="screen"
  46456. >array(2) {
  46457.   ["blue"]=>
  46458.   int(1)
  46459.   ["green"]=>
  46460.   int(3)
  46461. })</PRE
  46462. ></TD
  46463. ></TR
  46464. ></TABLE
  46465. ></DIV
  46466. ></TD
  46467. ></TR
  46468. ></TABLE
  46469. >
  46470.     </P
  46471. ><P
  46472. >      In our example you see that only the keys <VAR
  46473. CLASS="literal"
  46474. >'blue'</VAR
  46475. >
  46476.      and <VAR
  46477. CLASS="literal"
  46478. >'green'</VAR
  46479. > are present in both arrays and thus
  46480.      returned. Also notice that the values for the keys
  46481.      <VAR
  46482. CLASS="literal"
  46483. >'blue'</VAR
  46484. > and <VAR
  46485. CLASS="literal"
  46486. >'green'</VAR
  46487. > differ between
  46488.      the two arrays. A match still occurs because only the keys are checked.
  46489.      The values returned are those of <VAR
  46490. CLASS="parameter"
  46491. >array1</VAR
  46492. >.
  46493.     </P
  46494. ><P
  46495. >      The two keys from the <VAR
  46496. CLASS="literal"
  46497. >key => value</VAR
  46498. > pairs are
  46499.      considered equal only if 
  46500.      <VAR
  46501. CLASS="literal"
  46502. >(string) $key1 === (string) $key2 </VAR
  46503. >. In other words
  46504.      a strict type check is executed so the string representation must be
  46505.      the same.
  46506.     </P
  46507. ><P
  46508. >      See also <A
  46509. HREF="#function.array-diff"
  46510. ><B
  46511. CLASS="function"
  46512. >array_diff()</B
  46513. ></A
  46514. >,
  46515.      <A
  46516. HREF="#function.array-udiff"
  46517. ><B
  46518. CLASS="function"
  46519. >array_udiff()</B
  46520. ></A
  46521. >
  46522.      <A
  46523. HREF="#function.array-diff-assoc"
  46524. ><B
  46525. CLASS="function"
  46526. >array_diff_assoc()</B
  46527. ></A
  46528. >,
  46529.      <A
  46530. HREF="#function.array-diff-uassoc"
  46531. ><B
  46532. CLASS="function"
  46533. >array_diff_uassoc()</B
  46534. ></A
  46535. >,
  46536.      <A
  46537. HREF="#function.array-udiff-assoc"
  46538. ><B
  46539. CLASS="function"
  46540. >array_udiff_assoc()</B
  46541. ></A
  46542. >,
  46543.      <A
  46544. HREF="#function.array-udiff-uassoc"
  46545. ><B
  46546. CLASS="function"
  46547. >array_udiff_uassoc()</B
  46548. ></A
  46549. >,
  46550.      <A
  46551. HREF="#function.array-diff-key"
  46552. ><B
  46553. CLASS="function"
  46554. >array_diff_key()</B
  46555. ></A
  46556. >,
  46557.      <A
  46558. HREF="#function.array-diff-ukey"
  46559. ><B
  46560. CLASS="function"
  46561. >array_diff_ukey()</B
  46562. ></A
  46563. >,
  46564.      <A
  46565. HREF="#function.array-intersect"
  46566. ><B
  46567. CLASS="function"
  46568. >array_intersect()</B
  46569. ></A
  46570. >,
  46571.      <A
  46572. HREF="#function.array-intersect-assoc"
  46573. ><B
  46574. CLASS="function"
  46575. >array_intersect_assoc()</B
  46576. ></A
  46577. >,
  46578.      <A
  46579. HREF="#function.array-intersect-uassoc"
  46580. ><B
  46581. CLASS="function"
  46582. >array_intersect_uassoc()</B
  46583. ></A
  46584. > and
  46585.      <A
  46586. HREF="#function.array-intersect-key"
  46587. ><B
  46588. CLASS="function"
  46589. >array_intersect_key()</B
  46590. ></A
  46591. >.
  46592.     </P
  46593. ></DIV
  46594. ><H1
  46595. ><A
  46596. NAME="function.array-intersect"
  46597. ></A
  46598. >array_intersect</H1
  46599. ><DIV
  46600. CLASS="refnamediv"
  46601. ><A
  46602. NAME="AEN7989"
  46603. ></A
  46604. ><P
  46605. >    (PHP 4 >= 4.0.1, PHP 5)</P
  46606. >array_intersect -- Ermittelt die Schnittmenge von Arrays</DIV
  46607. ><DIV
  46608. CLASS="refsect1"
  46609. ><A
  46610. NAME="AEN7992"
  46611. ></A
  46612. ><H2
  46613. >Beschreibung</H2
  46614. >array <B
  46615. CLASS="methodname"
  46616. >array_intersect</B
  46617. > ( array array1, array array2 [, array ...])<BR
  46618. ></BR
  46619. ><P
  46620. >      <B
  46621. CLASS="function"
  46622. >array_intersect()</B
  46623. > gibt ein Array mit allen Werten
  46624.      von <VAR
  46625. CLASS="parameter"
  46626. >array1</VAR
  46627. >, die auch in allen anderen
  46628.      Argumenten enthalten sind, zurⁿck. Beachten Sie, dass die Schlⁿssel
  46629.      erhalten bleiben.
  46630.     </P
  46631. ><P
  46632. >      <TABLE
  46633. WIDTH="100%"
  46634. BORDER="0"
  46635. CELLPADDING="0"
  46636. CELLSPACING="0"
  46637. CLASS="EXAMPLE"
  46638. ><TR
  46639. ><TD
  46640. ><DIV
  46641. CLASS="example"
  46642. ><A
  46643. NAME="AEN8010"
  46644. ></A
  46645. ><P
  46646. ><B
  46647. >Beispiel 1. <B
  46648. CLASS="function"
  46649. >array_intersect()</B
  46650. > Beispiel</B
  46651. ></P
  46652. ><TABLE
  46653. BORDER="0"
  46654. BGCOLOR="#E0E0E0"
  46655. CELLPADDING="5"
  46656. ><TR
  46657. ><TD
  46658. ><PRE
  46659. CLASS="php"
  46660. ><?php
  46661. $array1 = array ("a" => "grⁿn", "rot", "blau");
  46662. $array2 = array ("b" => "grⁿn", "gelb", "rot");
  46663. $result = array_intersect ($array1, $array2);
  46664. ?></PRE
  46665. ></TD
  46666. ></TR
  46667. ></TABLE
  46668. ><P
  46669. >        Danach enthΣlt <VAR
  46670. CLASS="varname"
  46671. >$result</VAR
  46672. >
  46673.       </P
  46674. ><TABLE
  46675. BORDER="0"
  46676. BGCOLOR="#E0E0E0"
  46677. CELLPADDING="5"
  46678. ><TR
  46679. ><TD
  46680. ><PRE
  46681. CLASS="php"
  46682. >Array
  46683. (
  46684.     [a] => grⁿn
  46685.     [0] => rot
  46686. )</PRE
  46687. ></TD
  46688. ></TR
  46689. ></TABLE
  46690. ></DIV
  46691. ></TD
  46692. ></TR
  46693. ></TABLE
  46694. >
  46695.     </P
  46696. ><DIV
  46697. CLASS="note"
  46698. ><BLOCKQUOTE
  46699. CLASS="note"
  46700. ><P
  46701. ><B
  46702. >Anmerkung: </B
  46703. >
  46704.       Zwei Elemente werden nur dann als gleich angesehen, wenn
  46705.       <VAR
  46706. CLASS="literal"
  46707. >(string) $elem1 === (string) $elem2</VAR
  46708. >. In Worten:
  46709.       Wenn die String-ReprΣsentation die gleiche ist.
  46710.      </P
  46711. ></BLOCKQUOTE
  46712. ></DIV
  46713. ><DIV
  46714. CLASS="warning"
  46715. ><P
  46716. ></P
  46717. ><TABLE
  46718. CLASS="warning"
  46719. BORDER="1"
  46720. WIDTH="100%"
  46721. ><TR
  46722. ><TD
  46723. ALIGN="CENTER"
  46724. ><B
  46725. >Warnung</B
  46726. ></TD
  46727. ></TR
  46728. ><TR
  46729. ><TD
  46730. ALIGN="LEFT"
  46731. ><P
  46732. >       Dies war in PHP 4.0.4 fehlerhaft!
  46733.      </P
  46734. ></TD
  46735. ></TR
  46736. ></TABLE
  46737. ></DIV
  46738. ><P
  46739. >      Siehe auch <A
  46740. HREF="#function.array-intersect-assoc"
  46741. ><B
  46742. CLASS="function"
  46743. >array_intersect_assoc()</B
  46744. ></A
  46745. >,
  46746.      <A
  46747. HREF="#function.array-diff"
  46748. ><B
  46749. CLASS="function"
  46750. >array_diff()</B
  46751. ></A
  46752. > und
  46753.      <A
  46754. HREF="#function.array-diff-assoc"
  46755. ><B
  46756. CLASS="function"
  46757. >array_diff_assoc()</B
  46758. ></A
  46759. >.
  46760.     </P
  46761. ></DIV
  46762. ><H1
  46763. ><A
  46764. NAME="function.array-key-exists"
  46765. ></A
  46766. >array_key_exists</H1
  46767. ><DIV
  46768. CLASS="refnamediv"
  46769. ><A
  46770. NAME="AEN8027"
  46771. ></A
  46772. ><P
  46773. >    (PHP 4 >= 4.1.0, PHP 5)</P
  46774. >array_key_exists -- Prⁿft, ob ein Schlⁿssel in einem Array existiert</DIV
  46775. ><DIV
  46776. CLASS="refsect1"
  46777. ><A
  46778. NAME="AEN8030"
  46779. ></A
  46780. ><H2
  46781. >Beschreibung</H2
  46782. >bool <B
  46783. CLASS="methodname"
  46784. >array_key_exists</B
  46785. > ( mixed key, array search)<BR
  46786. ></BR
  46787. ><P
  46788. >      <B
  46789. CLASS="function"
  46790. >array_key_exists()</B
  46791. > gibt <TT
  46792. CLASS="constant"
  46793. ><B
  46794. >TRUE</B
  46795. ></TT
  46796. > zurⁿck, wenn
  46797.      <VAR
  46798. CLASS="parameter"
  46799. >key</VAR
  46800. > in dem Array vorhanden ist.
  46801.      <VAR
  46802. CLASS="parameter"
  46803. >key</VAR
  46804. > kann jeder fⁿr einen Array-Index
  46805.      m÷gliche Wert sein.
  46806.     </P
  46807. ><P
  46808. >      <TABLE
  46809. WIDTH="100%"
  46810. BORDER="0"
  46811. CELLPADDING="0"
  46812. CELLSPACING="0"
  46813. CLASS="EXAMPLE"
  46814. ><TR
  46815. ><TD
  46816. ><DIV
  46817. CLASS="example"
  46818. ><A
  46819. NAME="AEN8047"
  46820. ></A
  46821. ><P
  46822. ><B
  46823. >Beispiel 1. <B
  46824. CLASS="function"
  46825. >array_key_exists()</B
  46826. ></B
  46827. ></P
  46828. ><TABLE
  46829. BORDER="0"
  46830. BGCOLOR="#E0E0E0"
  46831. CELLPADDING="5"
  46832. ><TR
  46833. ><TD
  46834. ><PRE
  46835. CLASS="php"
  46836. ><?php
  46837. $search_array = array("erstes" => 1, "zweites" => 4);
  46838. if (array_key_exists("erstes", $search_array)) {
  46839.     echo "Das Element 'erstes' ist in dem Array vorhanden";
  46840. }
  46841. ?></PRE
  46842. ></TD
  46843. ></TR
  46844. ></TABLE
  46845. ></DIV
  46846. ></TD
  46847. ></TR
  46848. ></TABLE
  46849. >
  46850.     </P
  46851. ><DIV
  46852. CLASS="note"
  46853. ><BLOCKQUOTE
  46854. CLASS="note"
  46855. ><P
  46856. ><B
  46857. >Anmerkung: </B
  46858. >
  46859.       Der Name dieser Funktion ist in PHP 4.0.6
  46860.       <B
  46861. CLASS="function"
  46862. >key_exists()</B
  46863. >.
  46864.      </P
  46865. ></BLOCKQUOTE
  46866. ></DIV
  46867. ><P
  46868. >      Siehe auch <A
  46869. HREF="#function.isset"
  46870. ><B
  46871. CLASS="function"
  46872. >isset()</B
  46873. ></A
  46874. >.
  46875.     </P
  46876. ></DIV
  46877. ><H1
  46878. ><A
  46879. NAME="function.array-keys"
  46880. ></A
  46881. >array_keys</H1
  46882. ><DIV
  46883. CLASS="refnamediv"
  46884. ><A
  46885. NAME="AEN8057"
  46886. ></A
  46887. ><P
  46888. >    (PHP 4 , PHP 5)</P
  46889. >array_keys -- Liefert alle Schlⁿssel eines Arrays</DIV
  46890. ><DIV
  46891. CLASS="refsect1"
  46892. ><A
  46893. NAME="AEN8060"
  46894. ></A
  46895. ><H2
  46896. >Beschreibung</H2
  46897. >array <B
  46898. CLASS="methodname"
  46899. >array_keys</B
  46900. > ( array input [, mixed search_value])<BR
  46901. ></BR
  46902. ><P
  46903. >      <B
  46904. CLASS="function"
  46905. >array_keys()</B
  46906. > gibt die Schlⁿssel (numerisch und
  46907.      String) des Arrays <VAR
  46908. CLASS="parameter"
  46909. >input</VAR
  46910. > zurⁿck.
  46911.     </P
  46912. ><P
  46913. >      Ist der optionale Parameter <VAR
  46914. CLASS="parameter"
  46915. >search_value</VAR
  46916. >
  46917.      angegeben, werden nur die Schlⁿssel fⁿr diesen Wert zurⁿckgegeben.
  46918.      Andernfalls werden all Schlⁿssel von <VAR
  46919. CLASS="parameter"
  46920. >input</VAR
  46921. >
  46922.      zurⁿckgegeben.
  46923.     </P
  46924. ><P
  46925. >      <TABLE
  46926. WIDTH="100%"
  46927. BORDER="0"
  46928. CELLPADDING="0"
  46929. CELLSPACING="0"
  46930. CLASS="EXAMPLE"
  46931. ><TR
  46932. ><TD
  46933. ><DIV
  46934. CLASS="example"
  46935. ><A
  46936. NAME="AEN8078"
  46937. ></A
  46938. ><P
  46939. ><B
  46940. >Beispiel 1. <B
  46941. CLASS="function"
  46942. >array_keys()</B
  46943. ></B
  46944. ></P
  46945. ><TABLE
  46946. BORDER="0"
  46947. BGCOLOR="#E0E0E0"
  46948. CELLPADDING="5"
  46949. ><TR
  46950. ><TD
  46951. ><PRE
  46952. CLASS="php"
  46953. ><?php
  46954. $array = array (0 => 100, "Farbe" => "rot");
  46955. print_r(array_keys ($array));
  46956.  
  46957. $array = array ("blau", "rot", "grⁿn", "blau", "blau");
  46958. print_r(array_keys ($array, "blau"));
  46959.  
  46960. $array = array ("Farbe" => array("blau", "rot", "grⁿn"),
  46961.                 "Gr÷▀e" => array("klein", "mittel", "gro▀"));
  46962. print_r(array_keys ($array));
  46963. ?></PRE
  46964. ></TD
  46965. ></TR
  46966. ></TABLE
  46967. ><P
  46968. >        wⁿrde folgendes ausgeben:
  46969.       </P
  46970. ><TABLE
  46971. BORDER="0"
  46972. BGCOLOR="#E0E0E0"
  46973. CELLPADDING="5"
  46974. ><TR
  46975. ><TD
  46976. ><PRE
  46977. CLASS="screen"
  46978. >Array
  46979. (
  46980.     [0] => 0
  46981.     [1] => Farbe
  46982. )
  46983. Array
  46984. (
  46985.     [0] => 0
  46986.     [1] => 3
  46987.     [2] => 4
  46988. )
  46989. Array
  46990. (
  46991.     [0] => Farbe
  46992.     [1] => Gr÷▀e
  46993. )</PRE
  46994. ></TD
  46995. ></TR
  46996. ></TABLE
  46997. ></DIV
  46998. ></TD
  46999. ></TR
  47000. ></TABLE
  47001. >
  47002.     </P
  47003. ><P
  47004. >      Siehe auch <A
  47005. HREF="#function.array-values"
  47006. ><B
  47007. CLASS="function"
  47008. >array_values()</B
  47009. ></A
  47010. > und.
  47011.      <A
  47012. HREF="#function.array-key-exists"
  47013. ><B
  47014. CLASS="function"
  47015. >array_key_exists()</B
  47016. ></A
  47017. >.
  47018.     </P
  47019. ></DIV
  47020. ><H1
  47021. ><A
  47022. NAME="function.array-map"
  47023. ></A
  47024. >array_map</H1
  47025. ><DIV
  47026. CLASS="refnamediv"
  47027. ><A
  47028. NAME="AEN8088"
  47029. ></A
  47030. ><P
  47031. >    (PHP 4 >= 4.0.6, PHP 5)</P
  47032. >array_map -- 
  47033.      Wendet eine Callback-Funktion auf die Elemente von Arrays an
  47034.     </DIV
  47035. ><DIV
  47036. CLASS="refsect1"
  47037. ><A
  47038. NAME="AEN8091"
  47039. ></A
  47040. ><H2
  47041. >Beschreibung</H2
  47042. >array <B
  47043. CLASS="methodname"
  47044. >array_map</B
  47045. > ( mixed callback, array arr1 [, array ...])<BR
  47046. ></BR
  47047. ><P
  47048. >      <B
  47049. CLASS="function"
  47050. >array_map()</B
  47051. > gibt ein Array mit allen Elementen von
  47052.      <VAR
  47053. CLASS="parameter"
  47054. >arr1</VAR
  47055. > zurⁿck, nachdem die Callback-Funktion
  47056.      <VAR
  47057. CLASS="parameter"
  47058. >callback</VAR
  47059. > auf jedes einzelne Element angewandt
  47060.      wurde. Die Anzahl Parameter, welche die Callback-Funktion
  47061.      <VAR
  47062. CLASS="parameter"
  47063. >callback</VAR
  47064. > akzeptiert, sollte der Anzahl der an
  47065.      <B
  47066. CLASS="function"
  47067. >array_map()</B
  47068. > ⁿbergebenen Arrays entsprechen.
  47069.     </P
  47070. ><P
  47071. >      <TABLE
  47072. WIDTH="100%"
  47073. BORDER="0"
  47074. CELLPADDING="0"
  47075. CELLSPACING="0"
  47076. CLASS="EXAMPLE"
  47077. ><TR
  47078. ><TD
  47079. ><DIV
  47080. CLASS="example"
  47081. ><A
  47082. NAME="AEN8112"
  47083. ></A
  47084. ><P
  47085. ><B
  47086. >Beispiel 1. <B
  47087. CLASS="function"
  47088. >array_map()</B
  47089. ></B
  47090. ></P
  47091. ><TABLE
  47092. BORDER="0"
  47093. BGCOLOR="#E0E0E0"
  47094. CELLPADDING="5"
  47095. ><TR
  47096. ><TD
  47097. ><PRE
  47098. CLASS="php"
  47099. ><?php
  47100. function cube($n) {
  47101.     return $n*$n*$n;
  47102. }
  47103.  
  47104. $a = array(1, 2, 3, 4, 5);
  47105. $b = array_map("cube", $a);
  47106. print_r($b);
  47107. ?></PRE
  47108. ></TD
  47109. ></TR
  47110. ></TABLE
  47111. ><P
  47112. >        Dies speichert in <VAR
  47113. CLASS="varname"
  47114. >$b</VAR
  47115. >:
  47116.       </P
  47117. ><TABLE
  47118. BORDER="0"
  47119. BGCOLOR="#E0E0E0"
  47120. CELLPADDING="5"
  47121. ><TR
  47122. ><TD
  47123. ><PRE
  47124. CLASS="screen"
  47125. >Array
  47126. (
  47127.     [0] => 1
  47128.     [1] => 8
  47129.     [2] => 27
  47130.     [3] => 64
  47131.     [4] => 125
  47132. )</PRE
  47133. ></TD
  47134. ></TR
  47135. ></TABLE
  47136. ></DIV
  47137. ></TD
  47138. ></TR
  47139. ></TABLE
  47140. >
  47141.     </P
  47142. ><P
  47143. >      <TABLE
  47144. WIDTH="100%"
  47145. BORDER="0"
  47146. CELLPADDING="0"
  47147. CELLSPACING="0"
  47148. CLASS="EXAMPLE"
  47149. ><TR
  47150. ><TD
  47151. ><DIV
  47152. CLASS="example"
  47153. ><A
  47154. NAME="AEN8120"
  47155. ></A
  47156. ><P
  47157. ><B
  47158. >Beispiel 2. 
  47159.        <B
  47160. CLASS="function"
  47161. >array_map()</B
  47162. > - Verwendung mehrerer Arrays
  47163.       </B
  47164. ></P
  47165. ><TABLE
  47166. BORDER="0"
  47167. BGCOLOR="#E0E0E0"
  47168. CELLPADDING="5"
  47169. ><TR
  47170. ><TD
  47171. ><PRE
  47172. CLASS="php"
  47173. ><?php
  47174. function show_Spanish($n, $m) {
  47175.     return "Die Zahl $n hei▀t auf Spanisch  $m";
  47176. }
  47177.  
  47178. function map_Spanish($n, $m) {
  47179.     return array ($n => $m);
  47180. }
  47181.  
  47182. $a = array(1, 2, 3, 4, 5);
  47183. $b = array("uno", "dos", "tres", "cuatro", "cinco");
  47184.  
  47185. $c = array_map("show_Spanish", $a, $b);
  47186. print_r($c);
  47187.  
  47188. $d = array_map("map_Spanish", $a , $b);
  47189. print_r($d);
  47190. ?></PRE
  47191. ></TD
  47192. ></TR
  47193. ></TABLE
  47194. ><P
  47195. >        Dies resultiert in:
  47196.       </P
  47197. ><TABLE
  47198. BORDER="0"
  47199. BGCOLOR="#E0E0E0"
  47200. CELLPADDING="5"
  47201. ><TR
  47202. ><TD
  47203. ><PRE
  47204. CLASS="screen"
  47205. >// Ausgabe von $c
  47206. Array
  47207. (
  47208.     [0] => Die Zahl 1 hei▀t auf Spanisch  uno
  47209.     [1] => Die Zahl 2 hei▀t auf Spanisch  dos
  47210.     [2] => Die Zahl 3 hei▀t auf Spanisch  tres
  47211.     [3] => Die Zahl 4 hei▀t auf Spanisch  cuatro
  47212.     [4] => Die Zahl 5 hei▀t auf Spanisch  cinco
  47213. )
  47214.  
  47215. // Ausgabe von $d
  47216. Array
  47217. (
  47218.     [0] => Array
  47219.         (
  47220.             [1] => uno
  47221.         )
  47222.  
  47223.     [1] => Array
  47224.         (
  47225.             [2] => dos
  47226.         )
  47227.  
  47228.     [2] => Array
  47229.         (
  47230.             [3] => tres
  47231.         )
  47232.  
  47233.     [3] => Array
  47234.         (
  47235.             [4] => cuatro
  47236.         )
  47237.  
  47238.     [4] => Array
  47239.         (
  47240.             [5] => cinco
  47241.         )
  47242.  
  47243. )</PRE
  47244. ></TD
  47245. ></TR
  47246. ></TABLE
  47247. ></DIV
  47248. ></TD
  47249. ></TR
  47250. ></TABLE
  47251. >
  47252.     </P
  47253. ><P
  47254. >      Bei Verwendung von zwei oder mehr Arrays sollten diese gew÷hnlich
  47255.      die gleiche LΣnge besitzen, da die Callback-Funktion parallel auf
  47256.      die entsprechenden Elemente angewandt wird.  Haben die Arrays
  47257.      unterschiedliche LΣngen, wird das kⁿrzeste um leere Elemente
  47258.      erweitert.
  47259.     </P
  47260. ><P
  47261. >      Eine interessante Anwendung dieser Funktion ist die Konstruktion
  47262.      eines Arrays bestehend aus Arrays, was mit <TT
  47263. CLASS="constant"
  47264. ><B
  47265. >NULL</B
  47266. ></TT
  47267. > als Name der
  47268.      Callback-Funktion leicht realisiert werden kann.
  47269.     </P
  47270. ><P
  47271. >      <TABLE
  47272. WIDTH="100%"
  47273. BORDER="0"
  47274. CELLPADDING="0"
  47275. CELLSPACING="0"
  47276. CLASS="EXAMPLE"
  47277. ><TR
  47278. ><TD
  47279. ><DIV
  47280. CLASS="example"
  47281. ><A
  47282. NAME="AEN8130"
  47283. ></A
  47284. ><P
  47285. ><B
  47286. >Beispiel 3. Erstellen eines Arrays mit Arrays</B
  47287. ></P
  47288. ><TABLE
  47289. BORDER="0"
  47290. BGCOLOR="#E0E0E0"
  47291. CELLPADDING="5"
  47292. ><TR
  47293. ><TD
  47294. ><PRE
  47295. CLASS="php"
  47296. ><?php
  47297. $a = array(1, 2, 3, 4, 5);
  47298. $b = array("eins", "zwei", "drei", "vier", "fⁿnf");
  47299. $c = array("uno", "dos", "tres", "cuatro", "cinco");
  47300.  
  47301. $d = array_map(null, $a, $b, $c);
  47302. print_r($d);
  47303. ?></PRE
  47304. ></TD
  47305. ></TR
  47306. ></TABLE
  47307. ></DIV
  47308. ></TD
  47309. ></TR
  47310. ></TABLE
  47311. >
  47312.     </P
  47313. ><P
  47314. >      Wⁿrde folgendes ausgeben:
  47315.     </P
  47316. ><TABLE
  47317. BORDER="0"
  47318. BGCOLOR="#E0E0E0"
  47319. CELLPADDING="5"
  47320. ><TR
  47321. ><TD
  47322. ><PRE
  47323. CLASS="screen"
  47324. >Array
  47325. (
  47326.     [0] => Array
  47327.         (
  47328.             [0] => 1
  47329.             [1] => eins
  47330.             [2] => uno
  47331.         )
  47332.  
  47333.     [1] => Array
  47334.         (
  47335.             [0] => 2
  47336.             [1] => zwei
  47337.             [2] => dos
  47338.         )
  47339.  
  47340.     [2] => Array
  47341.         (
  47342.             [0] => 3
  47343.             [1] => drei
  47344.             [2] => tres
  47345.         )
  47346.  
  47347.     [3] => Array
  47348.         (
  47349.             [0] => 4
  47350.             [1] => vier
  47351.             [2] => cuatro
  47352.         )
  47353.  
  47354.     [4] => Array
  47355.         (
  47356.             [0] => 5
  47357.             [1] => fⁿnf
  47358.             [2] => cinco
  47359.         )
  47360.  
  47361. )</PRE
  47362. ></TD
  47363. ></TR
  47364. ></TABLE
  47365. ><P
  47366. >      Siehe auch <A
  47367. HREF="#function.array-filter"
  47368. ><B
  47369. CLASS="function"
  47370. >array_filter()</B
  47371. ></A
  47372. >, 
  47373.      <A
  47374. HREF="#function.array-reduce"
  47375. ><B
  47376. CLASS="function"
  47377. >array_reduce()</B
  47378. ></A
  47379. > und
  47380.      <A
  47381. HREF="#function.array-walk"
  47382. ><B
  47383. CLASS="function"
  47384. >array_walk()</B
  47385. ></A
  47386. >.
  47387.     </P
  47388. ></DIV
  47389. ><H1
  47390. ><A
  47391. NAME="function.array-merge-recursive"
  47392. ></A
  47393. >array_merge_recursive</H1
  47394. ><DIV
  47395. CLASS="refnamediv"
  47396. ><A
  47397. NAME="AEN8140"
  47398. ></A
  47399. ><P
  47400. >    (PHP 4 >= 4.0.1, PHP 5)</P
  47401. >array_merge_recursive -- 
  47402.      Fⁿhrt zwei oder mehr Arrays rekursiv zusammen
  47403.     </DIV
  47404. ><DIV
  47405. CLASS="refsect1"
  47406. ><A
  47407. NAME="AEN8143"
  47408. ></A
  47409. ><H2
  47410. >Beschreibung</H2
  47411. >array <B
  47412. CLASS="methodname"
  47413. >array_merge_recursive</B
  47414. > ( array array1, array array2 [, array ...])<BR
  47415. ></BR
  47416. ><P
  47417. >      <B
  47418. CLASS="function"
  47419. >array_merge_recursive()</B
  47420. > fⁿgt die Elemente von
  47421.      zwei oder mehr Arrays zusammen, so dass die Werte des einen
  47422.      Arrays an die des vorigen angehΣngt werden. Das daraus
  47423.      resultierende Array wird zurⁿckgegeben.
  47424.     </P
  47425. ><P
  47426. >      Haben die angegebenen Arrays die selben String-Schlⁿssel, dann
  47427.      wird der hintere Wert dieses Schlⁿssels den vorhergehenden
  47428.      ⁿberschreiben. Haben die Arrays den gleichen numerischen
  47429.      Schlⁿssel, dann wird der hintere Wert den vorhergehenden nicht
  47430.      ⁿberschreiben, sondern an den vorderen angehΣngt.
  47431.     </P
  47432. ><P
  47433. >      <TABLE
  47434. WIDTH="100%"
  47435. BORDER="0"
  47436. CELLPADDING="0"
  47437. CELLSPACING="0"
  47438. CLASS="EXAMPLE"
  47439. ><TR
  47440. ><TD
  47441. ><DIV
  47442. CLASS="example"
  47443. ><A
  47444. NAME="AEN8161"
  47445. ></A
  47446. ><P
  47447. ><B
  47448. >Beispiel 1. <B
  47449. CLASS="function"
  47450. >array_merge_recursive()</B
  47451. ></B
  47452. ></P
  47453. ><TABLE
  47454. BORDER="0"
  47455. BGCOLOR="#E0E0E0"
  47456. CELLPADDING="5"
  47457. ><TR
  47458. ><TD
  47459. ><PRE
  47460. CLASS="php"
  47461. ><?php
  47462. $ar1 = array ("farbe" => array ("favorit" => "rot"), 5);
  47463. $ar2 = array (10, "farbe" => array ("favorit" => "grⁿn", "blau"));
  47464. $result = array_merge_recursive ($ar1, $ar2);
  47465. ?></PRE
  47466. ></TD
  47467. ></TR
  47468. ></TABLE
  47469. ><P
  47470. >        The <VAR
  47471. CLASS="literal"
  47472. >$result</VAR
  47473. > will be:
  47474.       </P
  47475. ><TABLE
  47476. BORDER="0"
  47477. BGCOLOR="#E0E0E0"
  47478. CELLPADDING="5"
  47479. ><TR
  47480. ><TD
  47481. ><PRE
  47482. CLASS="php"
  47483. >Array
  47484. (
  47485.     [farbe] => Array
  47486.         (
  47487.             [favorit] => Array
  47488.                 (
  47489.                     [0] => rot
  47490.                     [1] => grⁿn
  47491.                 )
  47492.  
  47493.             [0] => blau
  47494.         )
  47495.  
  47496.     [0] => 5
  47497.     [1] => 10
  47498. )</PRE
  47499. ></TD
  47500. ></TR
  47501. ></TABLE
  47502. ></DIV
  47503. ></TD
  47504. ></TR
  47505. ></TABLE
  47506. >
  47507.     </P
  47508. ><P
  47509. >      See also <A
  47510. HREF="#function.array-merge"
  47511. ><B
  47512. CLASS="function"
  47513. >array_merge()</B
  47514. ></A
  47515. >.
  47516.     </P
  47517. ></DIV
  47518. ><H1
  47519. ><A
  47520. NAME="function.array-merge"
  47521. ></A
  47522. >array_merge</H1
  47523. ><DIV
  47524. CLASS="refnamediv"
  47525. ><A
  47526. NAME="AEN8171"
  47527. ></A
  47528. ><P
  47529. >    (PHP 4 , PHP 5)</P
  47530. >array_merge -- Fⁿhrt zwei oder mehr Arrays zusammen</DIV
  47531. ><DIV
  47532. CLASS="refsect1"
  47533. ><A
  47534. NAME="AEN8174"
  47535. ></A
  47536. ><H2
  47537. >Beschreibung</H2
  47538. >array <B
  47539. CLASS="methodname"
  47540. >array_merge</B
  47541. > ( array array1, array array2 [, array ...])<BR
  47542. ></BR
  47543. ><P
  47544. >      <B
  47545. CLASS="function"
  47546. >array_merge()</B
  47547. > fⁿgt die Elemente von zwei oder
  47548.      mehr Arrays zusammen, indem die Werte des einen an das Ende des
  47549.      anderen angehΣngt werden. Das daraus resultierende Array wird
  47550.      zurⁿckgegeben.
  47551.     </P
  47552. ><P
  47553. >      Haben die angegebenen Arrays die selben String-Schlⁿssel, dann
  47554.      wird der hintere Wert dieses Schlⁿssels den vorhergehenden
  47555.      ⁿberschreiben. Haben die Arrays den gleichen numerischen
  47556.      Schlⁿssel, dann wird der hintere Wert den vorhergehenden <SPAN
  47557. CLASS="strong"
  47558. ><B
  47559. CLASS="emphasis"
  47560. >nicht</B
  47561. ></SPAN
  47562. > ⁿberschreiben, sondern angehΣngt.
  47563.     </P
  47564. ><P
  47565. >      <TABLE
  47566. WIDTH="100%"
  47567. BORDER="0"
  47568. CELLPADDING="0"
  47569. CELLSPACING="0"
  47570. CLASS="EXAMPLE"
  47571. ><TR
  47572. ><TD
  47573. ><DIV
  47574. CLASS="example"
  47575. ><A
  47576. NAME="AEN8193"
  47577. ></A
  47578. ><P
  47579. ><B
  47580. >Beispiel 1. <B
  47581. CLASS="function"
  47582. >array_merge()</B
  47583. ></B
  47584. ></P
  47585. ><TABLE
  47586. BORDER="0"
  47587. BGCOLOR="#E0E0E0"
  47588. CELLPADDING="5"
  47589. ><TR
  47590. ><TD
  47591. ><PRE
  47592. CLASS="php"
  47593. ><?php
  47594. $array1 = array ("farbe" => "rot", 2, 4);
  47595. $array2 = array ("a", "b", "farbe" => "grⁿn", "form" => "trapezoid", 4);
  47596. $result = array_merge ($array1, $array2);
  47597. print_r($result);
  47598. ?></PRE
  47599. ></TD
  47600. ></TR
  47601. ></TABLE
  47602. ><P
  47603. >        Nun ist <VAR
  47604. CLASS="literal"
  47605. >$result</VAR
  47606. >:
  47607.       </P
  47608. ><TABLE
  47609. BORDER="0"
  47610. BGCOLOR="#E0E0E0"
  47611. CELLPADDING="5"
  47612. ><TR
  47613. ><TD
  47614. ><PRE
  47615. CLASS="php"
  47616. >Array
  47617. (
  47618.     [farbe] => grⁿn
  47619.     [0] => 2
  47620.     [1] => 4
  47621.     [2] => a
  47622.     [3] => b
  47623.     [form] => trapezoid
  47624.     [4] => 4
  47625. )</PRE
  47626. ></TD
  47627. ></TR
  47628. ></TABLE
  47629. ></DIV
  47630. ></TD
  47631. ></TR
  47632. ></TABLE
  47633. >
  47634.     </P
  47635. ><P
  47636. >      <TABLE
  47637. WIDTH="100%"
  47638. BORDER="0"
  47639. CELLPADDING="0"
  47640. CELLSPACING="0"
  47641. CLASS="EXAMPLE"
  47642. ><TR
  47643. ><TD
  47644. ><DIV
  47645. CLASS="example"
  47646. ><A
  47647. NAME="AEN8201"
  47648. ></A
  47649. ><P
  47650. ><B
  47651. >Beispiel 2. Einfaches <B
  47652. CLASS="function"
  47653. >array_merge()</B
  47654. > Beispiel</B
  47655. ></P
  47656. ><TABLE
  47657. BORDER="0"
  47658. BGCOLOR="#E0E0E0"
  47659. CELLPADDING="5"
  47660. ><TR
  47661. ><TD
  47662. ><PRE
  47663. CLASS="php"
  47664. ><?php
  47665. $array1 = array();
  47666. $array2 = array(1 => "data");
  47667. $result = array_merge($array1, $array2);
  47668. ?></PRE
  47669. ></TD
  47670. ></TR
  47671. ></TABLE
  47672. ><P
  47673. >        Vergessen Sie nicht, dass numerische Schlⁿssel neu numeriert werden!
  47674.       </P
  47675. ><TABLE
  47676. BORDER="0"
  47677. BGCOLOR="#E0E0E0"
  47678. CELLPADDING="5"
  47679. ><TR
  47680. ><TD
  47681. ><PRE
  47682. CLASS="php"
  47683. >Array
  47684. (
  47685.     [0] => data
  47686. )</PRE
  47687. ></TD
  47688. ></TR
  47689. ></TABLE
  47690. ><P
  47691. >        Wenn Sie die Arrays komplett erhalten und nur eines an das andere
  47692.        anhΣngen wollen, verwenden Sie den Operator <VAR
  47693. CLASS="literal"
  47694. >+</VAR
  47695. >:
  47696.       </P
  47697. ><TABLE
  47698. BORDER="0"
  47699. BGCOLOR="#E0E0E0"
  47700. CELLPADDING="5"
  47701. ><TR
  47702. ><TD
  47703. ><PRE
  47704. CLASS="php"
  47705. ><?php
  47706. $array1 = array();
  47707. $array2 = array(1 => "data");
  47708. $result = $array1 + $array2;
  47709. ?></PRE
  47710. ></TD
  47711. ></TR
  47712. ></TABLE
  47713. ><P
  47714. >        Der numerische Schlⁿssel sowie die Assoziation bleiben erhalten.
  47715.       </P
  47716. ><TABLE
  47717. BORDER="0"
  47718. BGCOLOR="#E0E0E0"
  47719. CELLPADDING="5"
  47720. ><TR
  47721. ><TD
  47722. ><PRE
  47723. CLASS="php"
  47724. >Array
  47725. (
  47726.     [1] => data
  47727. )</PRE
  47728. ></TD
  47729. ></TR
  47730. ></TABLE
  47731. ></DIV
  47732. ></TD
  47733. ></TR
  47734. ></TABLE
  47735. >
  47736.     </P
  47737. ><DIV
  47738. CLASS="note"
  47739. ><BLOCKQUOTE
  47740. CLASS="note"
  47741. ><P
  47742. ><B
  47743. >Anmerkung: </B
  47744. >
  47745.       Gemeinsame Schlⁿssel werden nach dem Prinzip "Wer zuerst kommt mahlt 
  47746.       zuerst" behandelt.
  47747.      </P
  47748. ></BLOCKQUOTE
  47749. ></DIV
  47750. ><P
  47751. >      Siehe auch <A
  47752. HREF="#function.array-merge-recursive"
  47753. ><B
  47754. CLASS="function"
  47755. >array_merge_recursive()</B
  47756. ></A
  47757. >.
  47758.     </P
  47759. ></DIV
  47760. ><H1
  47761. ><A
  47762. NAME="function.array-multisort"
  47763. ></A
  47764. >array_multisort</H1
  47765. ><DIV
  47766. CLASS="refnamediv"
  47767. ><A
  47768. NAME="AEN8217"
  47769. ></A
  47770. ><P
  47771. >    (PHP 4 , PHP 5)</P
  47772. >array_multisort -- Sortiert mehrere oder multidimensionale Arrays</DIV
  47773. ><DIV
  47774. CLASS="refsect1"
  47775. ><A
  47776. NAME="AEN8220"
  47777. ></A
  47778. ><H2
  47779. >Beschreibung</H2
  47780. >bool <B
  47781. CLASS="methodname"
  47782. >array_multisort</B
  47783. > ( array ar1 [, mixed arg [, mixed ... [, array ...]]])<BR
  47784. ></BR
  47785. ><P
  47786. >      <B
  47787. CLASS="function"
  47788. >array_multisort()</B
  47789. > wird zum Sortieren von
  47790.      entweder mehreren Arrays auf einmal, oder eines
  47791.      multidimensionalen Arrays (entsprechend einer von mehreren
  47792.      Dimensionen) benutzt. Bei der Sortierung werden die
  47793.      Schlⁿsselassoziationen beibehalten.
  47794.     </P
  47795. ><P
  47796. >      Die angegebenen Arrays werden als Spalten einer Tabelle
  47797.      behandelt, welche nach Reihen sortiert werden - Σhnlich der SQL
  47798.      Klausel ORDER BY.  Das erste Array ist auch das erste in der
  47799.      Sortierreihenfolge. Die in diesem Array gleichen Zeilen (Werte)
  47800.      werden anhand des nΣchsten angegebenen Arrays sortiert, usw.
  47801.     </P
  47802. ><P
  47803. >      Die Struktur der Argumente ist etwas ungew÷hnlich, aber
  47804.      flexibel. Das aller erste Argument muss ein Array sein. Die
  47805.      nachfolgenden Argumente k÷nnen entweder ein Array oder eines der
  47806.      folgenden Sortierflags sein.
  47807.     </P
  47808. ><P
  47809. >      Flags fⁿr Sortierreihenfolge:
  47810.      <P
  47811. ></P
  47812. ><UL
  47813. ><LI
  47814. ><P
  47815. >SORT_ASC - sortiere in aufsteigender Reihenfolge</P
  47816. ></LI
  47817. ><LI
  47818. ><P
  47819. >SORT_DESC - sortiere in absteigender Reihenfolge</P
  47820. ></LI
  47821. ></UL
  47822. >
  47823.     </P
  47824. ><P
  47825. >      Flags fⁿr Sortiertypen:
  47826.      <P
  47827. ></P
  47828. ><UL
  47829. ><LI
  47830. ><P
  47831. >SORT_REGULAR - vergleiche Felder normal</P
  47832. ></LI
  47833. ><LI
  47834. ><P
  47835. >SORT_NUMERIC - vergleiche Felder numerisch</P
  47836. ></LI
  47837. ><LI
  47838. ><P
  47839. >SORT_STRING - vergleiche Felder als Strings</P
  47840. ></LI
  47841. ></UL
  47842. >
  47843.     </P
  47844. ><P
  47845. >      Es kann nur ein Sortierflag des selben Typs nach jedem Array
  47846.      spezifiziert werden. Sortierflags nach einem Array Argument
  47847.      gelten nur fⁿr dieses Array, und werden vor jedem neuen Array
  47848.      Argument zu den Defaultflags SORT_ASC und SORT_REGULAR
  47849.      zurⁿckgesetzt.
  47850.     </P
  47851. ><P
  47852. >      Gibt bei Erfolg <TT
  47853. CLASS="constant"
  47854. ><B
  47855. >TRUE</B
  47856. ></TT
  47857. > zurⁿck, im Fehlerfall <TT
  47858. CLASS="constant"
  47859. ><B
  47860. >FALSE</B
  47861. ></TT
  47862. >.
  47863.     </P
  47864. ><P
  47865. >      <TABLE
  47866. WIDTH="100%"
  47867. BORDER="0"
  47868. CELLPADDING="0"
  47869. CELLSPACING="0"
  47870. CLASS="EXAMPLE"
  47871. ><TR
  47872. ><TD
  47873. ><DIV
  47874. CLASS="example"
  47875. ><A
  47876. NAME="AEN8260"
  47877. ></A
  47878. ><P
  47879. ><B
  47880. >Beispiel 1. Sortieren mehrerer Arrays</B
  47881. ></P
  47882. ><TABLE
  47883. BORDER="0"
  47884. BGCOLOR="#E0E0E0"
  47885. CELLPADDING="5"
  47886. ><TR
  47887. ><TD
  47888. ><PRE
  47889. CLASS="php"
  47890. ><?php
  47891. $ar1 = array ("10", 100, 100, "a");
  47892. $ar2 = array (1, 3, "2", 1);
  47893. array_multisort ($ar1, $ar2);
  47894. ?></PRE
  47895. ></TD
  47896. ></TR
  47897. ></TABLE
  47898. ></DIV
  47899. ></TD
  47900. ></TR
  47901. ></TABLE
  47902. >
  47903.     </P
  47904. ><P
  47905. >      In diesem Beispiel enthΣlt das erste Array nach dem Sortieren 10,
  47906.      "a", 100, 100. Das zweite Array wird 1, 1, "2", 3 enthalten. Die
  47907.      EintrΣge des zweiten Arrays, welche den identischen EintrΣgen des
  47908.      ersten Arrays entsprechen (100 und 100) wurden ebenfalls
  47909.      sortiert.
  47910.     </P
  47911. ><P
  47912. >      <TABLE
  47913. WIDTH="100%"
  47914. BORDER="0"
  47915. CELLPADDING="0"
  47916. CELLSPACING="0"
  47917. CLASS="EXAMPLE"
  47918. ><TR
  47919. ><TD
  47920. ><DIV
  47921. CLASS="example"
  47922. ><A
  47923. NAME="AEN8265"
  47924. ></A
  47925. ><P
  47926. ><B
  47927. >Beispiel 2. Sortieren eines mehrdimensionalen Arrays</B
  47928. ></P
  47929. ><TABLE
  47930. BORDER="0"
  47931. BGCOLOR="#E0E0E0"
  47932. CELLPADDING="5"
  47933. ><TR
  47934. ><TD
  47935. ><PRE
  47936. CLASS="php"
  47937. ><?php
  47938. $ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1));
  47939. array_multisort ($ar[0], SORT_ASC, SORT_STRING,
  47940.                  $ar[1], SORT_NUMERIC, SORT_DESC);
  47941. ?></PRE
  47942. ></TD
  47943. ></TR
  47944. ></TABLE
  47945. ></DIV
  47946. ></TD
  47947. ></TR
  47948. ></TABLE
  47949. >
  47950.     </P
  47951. ><P
  47952. >      In diesem Beispiel enthΣlt das erste Array nach dem Sortieren 10,
  47953.      100, 100, "a" (wurde als Strings in aufsteigender Reihenfolge
  47954.      sortiert), und das zweite enthΣlt 1, 3, "2", 1 (numerisch und
  47955.      absteigender Reihenfolge sortiert).
  47956.     </P
  47957. ></DIV
  47958. ><H1
  47959. ><A
  47960. NAME="function.array-pad"
  47961. ></A
  47962. >array_pad</H1
  47963. ><DIV
  47964. CLASS="refnamediv"
  47965. ><A
  47966. NAME="AEN8270"
  47967. ></A
  47968. ><P
  47969. >    (PHP 4 , PHP 5)</P
  47970. >array_pad -- 
  47971.      Vergr÷▀ert ein Array auf die spezifizierte LΣnge mit einem Wert
  47972.     </DIV
  47973. ><DIV
  47974. CLASS="refsect1"
  47975. ><A
  47976. NAME="AEN8273"
  47977. ></A
  47978. ><H2
  47979. >Beschreibung</H2
  47980. >array <B
  47981. CLASS="methodname"
  47982. >array_pad</B
  47983. > ( array input, int pad_size, mixed pad_value)<BR
  47984. ></BR
  47985. ><P
  47986. >      <B
  47987. CLASS="function"
  47988. >array_pad()</B
  47989. > liefert eine Kopie von
  47990.      <VAR
  47991. CLASS="parameter"
  47992. >input</VAR
  47993. >, welche auf die von
  47994.      <VAR
  47995. CLASS="parameter"
  47996. >pad_size</VAR
  47997. > spezifizierte Gr÷▀e mit dem Wert
  47998.      <VAR
  47999. CLASS="parameter"
  48000. >pad_value</VAR
  48001. > erweitert wurde. Ist der
  48002.      Parameter <VAR
  48003. CLASS="parameter"
  48004. >pad_size</VAR
  48005. > positiv, wird das Array
  48006.      rechts erweitert, ist er negativ, dann erfolgt die Erweiterung
  48007.      links. Ist der absolute Wert von <VAR
  48008. CLASS="parameter"
  48009. >pad_size</VAR
  48010. >
  48011.      kleiner oder gleich der LΣnge von <VAR
  48012. CLASS="parameter"
  48013. >input</VAR
  48014. >,
  48015.      erfolgt keine Erweiterung.
  48016.     </P
  48017. ><P
  48018. >      <TABLE
  48019. WIDTH="100%"
  48020. BORDER="0"
  48021. CELLPADDING="0"
  48022. CELLSPACING="0"
  48023. CLASS="EXAMPLE"
  48024. ><TR
  48025. ><TD
  48026. ><DIV
  48027. CLASS="example"
  48028. ><A
  48029. NAME="AEN8296"
  48030. ></A
  48031. ><P
  48032. ><B
  48033. >Beispiel 1. <B
  48034. CLASS="function"
  48035. >array_pad()</B
  48036. ></B
  48037. ></P
  48038. ><TABLE
  48039. BORDER="0"
  48040. BGCOLOR="#E0E0E0"
  48041. CELLPADDING="5"
  48042. ><TR
  48043. ><TD
  48044. ><PRE
  48045. CLASS="php"
  48046. ><?php
  48047. $input = array (12, 10, 9);
  48048.  
  48049. $result = array_pad ($input, 5, 0);
  48050. // Ergebnis ist array (12, 10, 9, 0, 0)
  48051.  
  48052. $result = array_pad ($input, -7, -1);
  48053. // Ergebnis ist array (-1, -1, -1, -1, 12, 10, 9)
  48054.  
  48055. $result = array_pad ($input, 2, "noop");
  48056. // nicht erweitert
  48057. ?></PRE
  48058. ></TD
  48059. ></TR
  48060. ></TABLE
  48061. ></DIV
  48062. ></TD
  48063. ></TR
  48064. ></TABLE
  48065. >
  48066.     </P
  48067. ></DIV
  48068. ><H1
  48069. ><A
  48070. NAME="function.array-pop"
  48071. ></A
  48072. >array_pop</H1
  48073. ><DIV
  48074. CLASS="refnamediv"
  48075. ><A
  48076. NAME="AEN8301"
  48077. ></A
  48078. ><P
  48079. >    (PHP 4 , PHP 5)</P
  48080. >array_pop -- Liefert das letzte Element eines Arrays</DIV
  48081. ><DIV
  48082. CLASS="refsect1"
  48083. ><A
  48084. NAME="AEN8304"
  48085. ></A
  48086. ><H2
  48087. >Beschreibung</H2
  48088. >mixed <B
  48089. CLASS="methodname"
  48090. >array_pop</B
  48091. > ( array array)<BR
  48092. ></BR
  48093. ><P
  48094. >      <B
  48095. CLASS="function"
  48096. >array_pop()</B
  48097. > liefert den letzten Wert von
  48098.      <VAR
  48099. CLASS="parameter"
  48100. >array</VAR
  48101. >, und verkⁿrzt
  48102.      <VAR
  48103. CLASS="parameter"
  48104. >array</VAR
  48105. > um ein Element. Ist
  48106.      <VAR
  48107. CLASS="parameter"
  48108. >array</VAR
  48109. > leer (oder kein Array), wird <TT
  48110. CLASS="constant"
  48111. ><B
  48112. >NULL</B
  48113. ></TT
  48114. >
  48115.      zurⁿckgegeben.
  48116.     </P
  48117. ><DIV
  48118. CLASS="note"
  48119. ><BLOCKQUOTE
  48120. CLASS="note"
  48121. ><P
  48122. ><B
  48123. >Anmerkung: </B
  48124. >Diese Funktion setzt
  48125. (<A
  48126. HREF="#function.reset"
  48127. ><B
  48128. CLASS="function"
  48129. >reset()</B
  48130. ></A
  48131. >) nach Verwendung den <A
  48132. HREF="#language.types.array"
  48133. ><B
  48134. CLASS="type"
  48135. >array</B
  48136. ></A
  48137. >-Zeiger
  48138. zurⁿck.</P
  48139. ></BLOCKQUOTE
  48140. ></DIV
  48141. ><P
  48142. >      <TABLE
  48143. WIDTH="100%"
  48144. BORDER="0"
  48145. CELLPADDING="0"
  48146. CELLSPACING="0"
  48147. CLASS="EXAMPLE"
  48148. ><TR
  48149. ><TD
  48150. ><DIV
  48151. CLASS="example"
  48152. ><A
  48153. NAME="AEN8323"
  48154. ></A
  48155. ><P
  48156. ><B
  48157. >Beispiel 1. <B
  48158. CLASS="function"
  48159. >array_pop()</B
  48160. ></B
  48161. ></P
  48162. ><TABLE
  48163. BORDER="0"
  48164. BGCOLOR="#E0E0E0"
  48165. CELLPADDING="5"
  48166. ><TR
  48167. ><TD
  48168. ><PRE
  48169. CLASS="php"
  48170. ><?php
  48171. $stack = array ("Orange", "Banane", "Apfel", "Himbeere");
  48172. $fruit = array_pop ($stack);
  48173. print_r($stack);
  48174. ?></PRE
  48175. ></TD
  48176. ></TR
  48177. ></TABLE
  48178. ><P
  48179. >        Danach hat <VAR
  48180. CLASS="varname"
  48181. >$stack</VAR
  48182. > nur 3 Elemente:
  48183.       </P
  48184. ><TABLE
  48185. BORDER="0"
  48186. BGCOLOR="#E0E0E0"
  48187. CELLPADDING="5"
  48188. ><TR
  48189. ><TD
  48190. ><PRE
  48191. CLASS="php"
  48192. >Array
  48193. (
  48194.     [0] => Orange
  48195.     [1] => Banane
  48196.     [2] => Apfel
  48197. )</PRE
  48198. ></TD
  48199. ></TR
  48200. ></TABLE
  48201. ><P
  48202. >        und <VAR
  48203. CLASS="literal"
  48204. >Himbeere</VAR
  48205. > wird <VAR
  48206. CLASS="varname"
  48207. >$fruit</VAR
  48208. >
  48209.        zugewiesen.
  48210.       </P
  48211. ></DIV
  48212. ></TD
  48213. ></TR
  48214. ></TABLE
  48215. >
  48216.     </P
  48217. ><DIV
  48218. CLASS="warning"
  48219. ><P
  48220. ></P
  48221. ><TABLE
  48222. CLASS="warning"
  48223. BORDER="1"
  48224. WIDTH="100%"
  48225. ><TR
  48226. ><TD
  48227. ALIGN="CENTER"
  48228. ><B
  48229. >Warnung</B
  48230. ></TD
  48231. ></TR
  48232. ><TR
  48233. ><TD
  48234. ALIGN="LEFT"
  48235. ><P
  48236. >Diese Funktion kann sowohl das
  48237. Boolsche <TT
  48238. CLASS="constant"
  48239. ><B
  48240. >FALSE</B
  48241. ></TT
  48242. > zurⁿckliefern, als auch einen nicht-Boolschen Wert, wie zum
  48243. Beispiel<VAR
  48244. CLASS="literal"
  48245. >0</VAR
  48246. > oder "". der von einem einfachen
  48247. if-Statement als <TT
  48248. CLASS="constant"
  48249. ><B
  48250. >FALSE</B
  48251. ></TT
  48252. > ausgewertet wird. Weitere Informationen entnehmen Sie
  48253. bitte dem Abschnitt ⁿber die <A
  48254. HREF="#language.types.boolean"
  48255. > Boolsche Typen</A
  48256. >. Benutzen Sie deshalb
  48257. <A
  48258. HREF="#language.operators.comparison"
  48259. >den === Operator</A
  48260. >
  48261. um den Rⁿckgabewert dieser Funktion zu ⁿberprⁿfen.</P
  48262. ></TD
  48263. ></TR
  48264. ></TABLE
  48265. ></DIV
  48266. ><P
  48267. >      Siehe auch <A
  48268. HREF="#function.array-push"
  48269. ><B
  48270. CLASS="function"
  48271. >array_push()</B
  48272. ></A
  48273. >,
  48274.      <A
  48275. HREF="#function.array-shift"
  48276. ><B
  48277. CLASS="function"
  48278. >array_shift()</B
  48279. ></A
  48280. > und
  48281.      <A
  48282. HREF="#function.array-unshift"
  48283. ><B
  48284. CLASS="function"
  48285. >array_unshift()</B
  48286. ></A
  48287. >.
  48288.     </P
  48289. ></DIV
  48290. ><H1
  48291. ><A
  48292. NAME="function.array-push"
  48293. ></A
  48294. >array_push</H1
  48295. ><DIV
  48296. CLASS="refnamediv"
  48297. ><A
  48298. NAME="AEN8345"
  48299. ></A
  48300. ><P
  48301. >    (PHP 4 , PHP 5)</P
  48302. >array_push -- 
  48303.      Fⁿgt ein oder mehr Elemente an das Ende eines Arrays
  48304.     </DIV
  48305. ><DIV
  48306. CLASS="refsect1"
  48307. ><A
  48308. NAME="AEN8348"
  48309. ></A
  48310. ><H2
  48311. >Beschreibung</H2
  48312. >int <B
  48313. CLASS="methodname"
  48314. >array_push</B
  48315. > ( array array, mixed var [, mixed ...])<BR
  48316. ></BR
  48317. ><P
  48318. >      <B
  48319. CLASS="function"
  48320. >array_push()</B
  48321. > behandelt
  48322.      <VAR
  48323. CLASS="parameter"
  48324. >array</VAR
  48325. > als Stapel (Stack), und fⁿgt die
  48326.      ⁿbergebenen Variablen an das Ende von
  48327.      <VAR
  48328. CLASS="parameter"
  48329. >array</VAR
  48330. >.  Die LΣnge von
  48331.      <VAR
  48332. CLASS="parameter"
  48333. >array</VAR
  48334. > wird dabei um die Anzahl der
  48335.      angefⁿgten Variablen erh÷ht. Dies hat den selben Effekt wie:
  48336.      <TABLE
  48337. BORDER="0"
  48338. BGCOLOR="#E0E0E0"
  48339. CELLPADDING="5"
  48340. ><TR
  48341. ><TD
  48342. ><PRE
  48343. CLASS="php"
  48344. ><?php
  48345. $array[] = $var;
  48346. ?></PRE
  48347. ></TD
  48348. ></TR
  48349. ></TABLE
  48350. >
  48351.      fⁿr jede Variable <VAR
  48352. CLASS="parameter"
  48353. >var</VAR
  48354. > wiederholt.
  48355.     </P
  48356. ><P
  48357. >      Liefert die neue Anzahl Elemente des Arrays.
  48358.     </P
  48359. ><P
  48360. >      <TABLE
  48361. WIDTH="100%"
  48362. BORDER="0"
  48363. CELLPADDING="0"
  48364. CELLSPACING="0"
  48365. CLASS="EXAMPLE"
  48366. ><TR
  48367. ><TD
  48368. ><DIV
  48369. CLASS="example"
  48370. ><A
  48371. NAME="AEN8371"
  48372. ></A
  48373. ><P
  48374. ><B
  48375. >Beispiel 1. <B
  48376. CLASS="function"
  48377. >array_push()</B
  48378. ></B
  48379. ></P
  48380. ><TABLE
  48381. BORDER="0"
  48382. BGCOLOR="#E0E0E0"
  48383. CELLPADDING="5"
  48384. ><TR
  48385. ><TD
  48386. ><PRE
  48387. CLASS="php"
  48388. ><?php
  48389. $stack = array ("Orange", "Banane");
  48390. array_push ($stack, "Apfel", "Himbeere");
  48391. print_r($stack);
  48392. ?></PRE
  48393. ></TD
  48394. ></TR
  48395. ></TABLE
  48396. ><P
  48397. >        Danach enthΣlt <VAR
  48398. CLASS="varname"
  48399. >$stack</VAR
  48400. >
  48401.        die folgenden Elemente:
  48402.       </P
  48403. ><TABLE
  48404. BORDER="0"
  48405. BGCOLOR="#E0E0E0"
  48406. CELLPADDING="5"
  48407. ><TR
  48408. ><TD
  48409. ><PRE
  48410. CLASS="php"
  48411. >Array
  48412. (
  48413.     [0] => Orange
  48414.     [1] => Banane
  48415.     [2] => Apfel
  48416.     [3] => Himbeere
  48417. )</PRE
  48418. ></TD
  48419. ></TR
  48420. ></TABLE
  48421. ></DIV
  48422. ></TD
  48423. ></TR
  48424. ></TABLE
  48425. >
  48426.     </P
  48427. ><P
  48428. >      Siehe auch <A
  48429. HREF="#function.array-pop"
  48430. ><B
  48431. CLASS="function"
  48432. >array_pop()</B
  48433. ></A
  48434. >,
  48435.      <A
  48436. HREF="#function.array-shift"
  48437. ><B
  48438. CLASS="function"
  48439. >array_shift()</B
  48440. ></A
  48441. > und
  48442.      <A
  48443. HREF="#function.array-unshift"
  48444. ><B
  48445. CLASS="function"
  48446. >array_unshift()</B
  48447. ></A
  48448. >.
  48449.     </P
  48450. ></DIV
  48451. ><H1
  48452. ><A
  48453. NAME="function.array-rand"
  48454. ></A
  48455. >array_rand</H1
  48456. ><DIV
  48457. CLASS="refnamediv"
  48458. ><A
  48459. NAME="AEN8383"
  48460. ></A
  48461. ><P
  48462. >    (PHP 4 , PHP 5)</P
  48463. >array_rand -- 
  48464.      Liefert einen oder mehrere zufΣllige EintrΣge eines Arrays
  48465.     </DIV
  48466. ><DIV
  48467. CLASS="refsect1"
  48468. ><A
  48469. NAME="AEN8386"
  48470. ></A
  48471. ><H2
  48472. >Beschreibung</H2
  48473. >mixed <B
  48474. CLASS="methodname"
  48475. >array_rand</B
  48476. > ( array input [, int num_req])<BR
  48477. ></BR
  48478. ><P
  48479. >      <B
  48480. CLASS="function"
  48481. >array_rand()</B
  48482. > ist ziemlich nⁿtzlich, wenn Sie
  48483.      einen oder mehrere zufΣllige EintrΣge eines Arrays auswΣhlen
  48484.      m÷chten. Die Funktion ⁿbernimmt das Array
  48485.      <VAR
  48486. CLASS="parameter"
  48487. >input</VAR
  48488. >, und ein optionales Argument
  48489.      <VAR
  48490. CLASS="parameter"
  48491. >num_req</VAR
  48492. >, welches die gewⁿnschte Anzahl
  48493.      EintrΣge spezifiziert. Ist <VAR
  48494. CLASS="parameter"
  48495. >num_req</VAR
  48496. > nicht
  48497.      angegeben, wird ein Defaultwert von 1 angenommen.
  48498.     </P
  48499. ><P
  48500. >      Wenn Sie nur einen Eintrag auswΣhlen, liefert
  48501.      <B
  48502. CLASS="function"
  48503. >array_rand()</B
  48504. > den Schlⁿssel eines zufΣlligen
  48505.      Eintrages.  Andernfalls wird ein Array mit den Schlⁿsseln der
  48506.      zufΣlligen EintrΣge zurⁿckgegeben. Dies hat den Zweck, dass Sie
  48507.      zufΣllige Schlⁿssel und auch Werte aus dem Array auswΣhlen
  48508.      k÷nnen.
  48509.     </P
  48510. ><DIV
  48511. CLASS="note"
  48512. ><BLOCKQUOTE
  48513. CLASS="note"
  48514. ><P
  48515. ><B
  48516. >Anmerkung: </B
  48517. >Seit PHP 4.2.0 besteht keine
  48518. Notwendigkeit mehr, den Zufallsgenerator fⁿr Zahlen mit
  48519. <A
  48520. HREF="#function.srand"
  48521. ><B
  48522. CLASS="function"
  48523. >srand()</B
  48524. ></A
  48525. > oder <A
  48526. HREF="#function.mt-srand"
  48527. ><B
  48528. CLASS="function"
  48529. >mt_srand()</B
  48530. ></A
  48531. > zu fⁿttern, das
  48532. geschieht nun automatisch.</P
  48533. ></BLOCKQUOTE
  48534. ></DIV
  48535. ><P
  48536. >      <TABLE
  48537. WIDTH="100%"
  48538. BORDER="0"
  48539. CELLPADDING="0"
  48540. CELLSPACING="0"
  48541. CLASS="EXAMPLE"
  48542. ><TR
  48543. ><TD
  48544. ><DIV
  48545. CLASS="example"
  48546. ><A
  48547. NAME="AEN8409"
  48548. ></A
  48549. ><P
  48550. ><B
  48551. >Beispiel 1. <B
  48552. CLASS="function"
  48553. >array_rand()</B
  48554. ></B
  48555. ></P
  48556. ><TABLE
  48557. BORDER="0"
  48558. BGCOLOR="#E0E0E0"
  48559. CELLPADDING="5"
  48560. ><TR
  48561. ><TD
  48562. ><PRE
  48563. CLASS="php"
  48564. ><?php
  48565. srand ((float) microtime() * 10000000);
  48566. $input = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
  48567. $rand_keys = array_rand ($input, 2);
  48568. print $input[$rand_keys[0]]."\n";
  48569. print $input[$rand_keys[1]]."\n";
  48570. ?></PRE
  48571. ></TD
  48572. ></TR
  48573. ></TABLE
  48574. ></DIV
  48575. ></TD
  48576. ></TR
  48577. ></TABLE
  48578. >
  48579.     </P
  48580. ></DIV
  48581. ><H1
  48582. ><A
  48583. NAME="function.array-reduce"
  48584. ></A
  48585. >array_reduce</H1
  48586. ><DIV
  48587. CLASS="refnamediv"
  48588. ><A
  48589. NAME="AEN8414"
  48590. ></A
  48591. ><P
  48592. >    (PHP 4 >= 4.0.5, PHP 5)</P
  48593. >array_reduce -- 
  48594.      Iterative Reduktion eines Arrays zu einem Wert mittels einer
  48595.      Callback Funktion
  48596.     </DIV
  48597. ><DIV
  48598. CLASS="refsect1"
  48599. ><A
  48600. NAME="AEN8417"
  48601. ></A
  48602. ><H2
  48603. >Beschreibung</H2
  48604. >mixed <B
  48605. CLASS="methodname"
  48606. >array_reduce</B
  48607. > ( array input, callback function [, int initial])<BR
  48608. ></BR
  48609. ><P
  48610. >      <B
  48611. CLASS="function"
  48612. >array_reduce()</B
  48613. > wendet die Funktion
  48614.      <VAR
  48615. CLASS="parameter"
  48616. >function</VAR
  48617. > iterativ bei den Elementen des Arrays
  48618.      <VAR
  48619. CLASS="parameter"
  48620. >input</VAR
  48621. > so an, dass das Array auf einen einzigen
  48622.      Wert reduziert wird. Ist der optionale Parameter
  48623.      <VAR
  48624. CLASS="parameter"
  48625. >intial</VAR
  48626. > angegeben, wird er am Beginn des Prozesses
  48627.      benutzt oder als Resultat verwendet, sollte das Array leer sein.
  48628.     </P
  48629. ><P
  48630. >      <TABLE
  48631. WIDTH="100%"
  48632. BORDER="0"
  48633. CELLPADDING="0"
  48634. CELLSPACING="0"
  48635. CLASS="EXAMPLE"
  48636. ><TR
  48637. ><TD
  48638. ><DIV
  48639. CLASS="example"
  48640. ><A
  48641. NAME="AEN8437"
  48642. ></A
  48643. ><P
  48644. ><B
  48645. >Beispiel 1. <B
  48646. CLASS="function"
  48647. >array_reduce()</B
  48648. ></B
  48649. ></P
  48650. ><TABLE
  48651. BORDER="0"
  48652. BGCOLOR="#E0E0E0"
  48653. CELLPADDING="5"
  48654. ><TR
  48655. ><TD
  48656. ><PRE
  48657. CLASS="php"
  48658. ><?php
  48659. function rsum($v, $w) {
  48660.     $v += $w;
  48661.     return $v;
  48662. }
  48663.  
  48664. function rmul($v, $w) {
  48665.     $v *= $w;
  48666.     return $v;
  48667. }
  48668.  
  48669. $a = array(1, 2, 3, 4, 5);
  48670. $x = array();
  48671. $b = array_reduce($a, "rsum");
  48672. $c = array_reduce($a, "rmul", 10);
  48673. $d = array_reduce($x, "rsum", 1);
  48674. ?></PRE
  48675. ></TD
  48676. ></TR
  48677. ></TABLE
  48678. ></DIV
  48679. ></TD
  48680. ></TR
  48681. ></TABLE
  48682. >
  48683.     </P
  48684. ><P
  48685. >      Hier enthΣlt <VAR
  48686. CLASS="varname"
  48687. >$b</VAR
  48688. > <VAR
  48689. CLASS="literal"
  48690. >15</VAR
  48691. >,
  48692.      <VAR
  48693. CLASS="varname"
  48694. >$c</VAR
  48695. > <VAR
  48696. CLASS="literal"
  48697. >1200</VAR
  48698. > (= 1*2*3*4*5*10),
  48699.      und <VAR
  48700. CLASS="varname"
  48701. >$d</VAR
  48702. > enthΣlt <VAR
  48703. CLASS="literal"
  48704. >1</VAR
  48705. >.
  48706.     </P
  48707. ><P
  48708. >      Siehe auch <A
  48709. HREF="#function.array-filter"
  48710. ><B
  48711. CLASS="function"
  48712. >array_filter()</B
  48713. ></A
  48714. > und
  48715.      <A
  48716. HREF="#function.array-map"
  48717. ><B
  48718. CLASS="function"
  48719. >array_map()</B
  48720. ></A
  48721. >.
  48722.     </P
  48723. ></DIV
  48724. ><H1
  48725. ><A
  48726. NAME="function.array-reverse"
  48727. ></A
  48728. >array_reverse</H1
  48729. ><DIV
  48730. CLASS="refnamediv"
  48731. ><A
  48732. NAME="AEN8452"
  48733. ></A
  48734. ><P
  48735. >    (PHP 4 , PHP 5)</P
  48736. >array_reverse -- 
  48737.      Liefert ein Array mit umgekehrter Reihenfolge der Elemente
  48738.     </DIV
  48739. ><DIV
  48740. CLASS="refsect1"
  48741. ><A
  48742. NAME="AEN8455"
  48743. ></A
  48744. ><H2
  48745. >Beschreibung</H2
  48746. >array <B
  48747. CLASS="methodname"
  48748. >array_reverse</B
  48749. > ( array array [, bool preserve_keys])<BR
  48750. ></BR
  48751. ><P
  48752. >      <B
  48753. CLASS="function"
  48754. >array_reverse()</B
  48755. > liefert ein Array mit der
  48756.      umgekehrten Reihenfolge der Elemente von
  48757.      <VAR
  48758. CLASS="parameter"
  48759. >array</VAR
  48760. >. Ist der optionale Parameter
  48761.      <VAR
  48762. CLASS="parameter"
  48763. >preserve_keys</VAR
  48764. > <TT
  48765. CLASS="constant"
  48766. ><B
  48767. >TRUE</B
  48768. ></TT
  48769. >, bleibt die
  48770.      Reihenfolge der Schlⁿssel aufrecht.
  48771.     </P
  48772. ><P
  48773. >      <TABLE
  48774. WIDTH="100%"
  48775. BORDER="0"
  48776. CELLPADDING="0"
  48777. CELLSPACING="0"
  48778. CLASS="EXAMPLE"
  48779. ><TR
  48780. ><TD
  48781. ><DIV
  48782. CLASS="example"
  48783. ><A
  48784. NAME="AEN8472"
  48785. ></A
  48786. ><P
  48787. ><B
  48788. >Beispiel 1. <B
  48789. CLASS="function"
  48790. >array_reverse()</B
  48791. ></B
  48792. ></P
  48793. ><TABLE
  48794. BORDER="0"
  48795. BGCOLOR="#E0E0E0"
  48796. CELLPADDING="5"
  48797. ><TR
  48798. ><TD
  48799. ><PRE
  48800. CLASS="php"
  48801. ><?php
  48802. $input  = array ("php", 4.0, array ("grⁿn", "rot"));
  48803. $result = array_reverse ($input);
  48804. $result_keyed = array_reverse ($input, TRUE);
  48805. ?></PRE
  48806. ></TD
  48807. ></TR
  48808. ></TABLE
  48809. ><P
  48810. >        Danach haben <VAR
  48811. CLASS="varname"
  48812. >$result</VAR
  48813. > und
  48814.        <VAR
  48815. CLASS="varname"
  48816. >$result_keyed</VAR
  48817. > die gleichen Elemente, aber
  48818.        Beachten Sie den Unterschied zwischen den Schlⁿsseln. Die
  48819.        Ausgabe von <VAR
  48820. CLASS="varname"
  48821. >$result</VAR
  48822. > und
  48823.        <VAR
  48824. CLASS="varname"
  48825. >$result_keyed</VAR
  48826. > wird wie folgt aussehen:
  48827.       </P
  48828. ><TABLE
  48829. BORDER="0"
  48830. BGCOLOR="#E0E0E0"
  48831. CELLPADDING="5"
  48832. ><TR
  48833. ><TD
  48834. ><PRE
  48835. CLASS="php"
  48836. >Array
  48837. (
  48838.     [0] => Array
  48839.         (
  48840.             [0] => grⁿn
  48841.             [1] => rot
  48842.         )
  48843.  
  48844.     [1] => 4
  48845.     [2] => php
  48846. )
  48847. Array
  48848. (
  48849.     [2] => Array
  48850.         (
  48851.             [0] => grⁿn
  48852.             [1] => rot
  48853.         )
  48854.  
  48855.     [1] => 4
  48856.     [0] => php
  48857. )</PRE
  48858. ></TD
  48859. ></TR
  48860. ></TABLE
  48861. ></DIV
  48862. ></TD
  48863. ></TR
  48864. ></TABLE
  48865. >
  48866.     </P
  48867. ><DIV
  48868. CLASS="note"
  48869. ><BLOCKQUOTE
  48870. CLASS="note"
  48871. ><P
  48872. ><B
  48873. >Anmerkung: </B
  48874. >
  48875.       Der zweite Parameter wurde in PHP 4.0.3 hinzugefⁿgt.
  48876.      </P
  48877. ></BLOCKQUOTE
  48878. ></DIV
  48879. ></DIV
  48880. ><H1
  48881. ><A
  48882. NAME="function.array-search"
  48883. ></A
  48884. >array_search</H1
  48885. ><DIV
  48886. CLASS="refnamediv"
  48887. ><A
  48888. NAME="AEN8485"
  48889. ></A
  48890. ><P
  48891. >    (PHP 4 >= 4.0.5, PHP 5)</P
  48892. >array_search -- 
  48893.      Durchsucht ein Array nach einem Wert liefert bei Erfolg den
  48894.      Schlⁿssel
  48895.     </DIV
  48896. ><DIV
  48897. CLASS="refsect1"
  48898. ><A
  48899. NAME="AEN8488"
  48900. ></A
  48901. ><H2
  48902. >Beschreibung</H2
  48903. >mixed <B
  48904. CLASS="methodname"
  48905. >array_search</B
  48906. > ( mixed needle, array haystack [, bool strict])<BR
  48907. ></BR
  48908. ><P
  48909. >      Diese Funktion durchsucht <VAR
  48910. CLASS="parameter"
  48911. >haystack</VAR
  48912. > nach
  48913.      <VAR
  48914. CLASS="parameter"
  48915. >needle</VAR
  48916. > und gibt bei Erfolg den Schlⁿssel
  48917.      zurⁿck, andernfalls <TT
  48918. CLASS="constant"
  48919. ><B
  48920. >FALSE</B
  48921. ></TT
  48922. >.
  48923.     </P
  48924. ><DIV
  48925. CLASS="note"
  48926. ><BLOCKQUOTE
  48927. CLASS="note"
  48928. ><P
  48929. ><B
  48930. >Anmerkung: </B
  48931. >
  48932.       Vor PHP 4.2.0 gibt <B
  48933. CLASS="function"
  48934. >array_search()</B
  48935. > im Fehlerfall
  48936.       <TT
  48937. CLASS="constant"
  48938. ><B
  48939. >NULL</B
  48940. ></TT
  48941. > statt <TT
  48942. CLASS="constant"
  48943. ><B
  48944. >FALSE</B
  48945. ></TT
  48946. > zurⁿck.
  48947.      </P
  48948. ></BLOCKQUOTE
  48949. ></DIV
  48950. ><P
  48951. >      Ist der optionale dritte Parameter <VAR
  48952. CLASS="parameter"
  48953. >strict</VAR
  48954. >
  48955.      auf <TT
  48956. CLASS="constant"
  48957. ><B
  48958. >TRUE</B
  48959. ></TT
  48960. > gesetzt, prⁿft <B
  48961. CLASS="function"
  48962. >array_search()</B
  48963. >
  48964.      auch die Typen von <VAR
  48965. CLASS="parameter"
  48966. >needle</VAR
  48967. > in
  48968.      <VAR
  48969. CLASS="parameter"
  48970. >haystack</VAR
  48971. >.
  48972.     </P
  48973. ><DIV
  48974. CLASS="warning"
  48975. ><P
  48976. ></P
  48977. ><TABLE
  48978. CLASS="warning"
  48979. BORDER="1"
  48980. WIDTH="100%"
  48981. ><TR
  48982. ><TD
  48983. ALIGN="CENTER"
  48984. ><B
  48985. >Warnung</B
  48986. ></TD
  48987. ></TR
  48988. ><TR
  48989. ><TD
  48990. ALIGN="LEFT"
  48991. ><P
  48992. >Diese Funktion kann sowohl das
  48993. Boolsche <TT
  48994. CLASS="constant"
  48995. ><B
  48996. >FALSE</B
  48997. ></TT
  48998. > zurⁿckliefern, als auch einen nicht-Boolschen Wert, wie zum
  48999. Beispiel<VAR
  49000. CLASS="literal"
  49001. >0</VAR
  49002. > oder "". der von einem einfachen
  49003. if-Statement als <TT
  49004. CLASS="constant"
  49005. ><B
  49006. >FALSE</B
  49007. ></TT
  49008. > ausgewertet wird. Weitere Informationen entnehmen Sie
  49009. bitte dem Abschnitt ⁿber die <A
  49010. HREF="#language.types.boolean"
  49011. > Boolsche Typen</A
  49012. >. Benutzen Sie deshalb
  49013. <A
  49014. HREF="#language.operators.comparison"
  49015. >den === Operator</A
  49016. >
  49017. um den Rⁿckgabewert dieser Funktion zu ⁿberprⁿfen.</P
  49018. ></TD
  49019. ></TR
  49020. ></TABLE
  49021. ></DIV
  49022. ><P
  49023. >      Siehe auch <A
  49024. HREF="#function.array-keys"
  49025. ><B
  49026. CLASS="function"
  49027. >array_keys()</B
  49028. ></A
  49029. > und <A
  49030. HREF="#function.in-array"
  49031. ><B
  49032. CLASS="function"
  49033. >in_array()</B
  49034. ></A
  49035. >.
  49036.     </P
  49037. ></DIV
  49038. ><H1
  49039. ><A
  49040. NAME="function.array-shift"
  49041. ></A
  49042. >array_shift</H1
  49043. ><DIV
  49044. CLASS="refnamediv"
  49045. ><A
  49046. NAME="AEN8528"
  49047. ></A
  49048. ><P
  49049. >    (PHP 4 , PHP 5)</P
  49050. >array_shift -- 
  49051.      Liefert ein Element vom Beginn eines Arrays
  49052.     </DIV
  49053. ><DIV
  49054. CLASS="refsect1"
  49055. ><A
  49056. NAME="AEN8531"
  49057. ></A
  49058. ><H2
  49059. >Beschreibung</H2
  49060. >mixed <B
  49061. CLASS="methodname"
  49062. >array_shift</B
  49063. > ( array array)<BR
  49064. ></BR
  49065. ><P
  49066. >      <B
  49067. CLASS="function"
  49068. >array_shift()</B
  49069. > liefert den ersten Wert von
  49070.      <VAR
  49071. CLASS="parameter"
  49072. >array</VAR
  49073. >, verschiebt die anderen Werte
  49074.      hinunter, und verkⁿrzt <VAR
  49075. CLASS="parameter"
  49076. >array</VAR
  49077. > um ein
  49078.      Element. Alle numerischen Schlⁿssel werden so modifiziert, dass
  49079.      bei null zu zΣhlen begonnen wird. Strings als Schlⁿssel bleiben
  49080.      unverΣndert. Ist <VAR
  49081. CLASS="parameter"
  49082. >array</VAR
  49083. > leer (oder kein
  49084.      Array), wird <TT
  49085. CLASS="constant"
  49086. ><B
  49087. >NULL</B
  49088. ></TT
  49089. > zurⁿckgegeben.
  49090.     </P
  49091. ><DIV
  49092. CLASS="note"
  49093. ><BLOCKQUOTE
  49094. CLASS="note"
  49095. ><P
  49096. ><B
  49097. >Anmerkung: </B
  49098. >Diese Funktion setzt
  49099. (<A
  49100. HREF="#function.reset"
  49101. ><B
  49102. CLASS="function"
  49103. >reset()</B
  49104. ></A
  49105. >) nach Verwendung den <A
  49106. HREF="#language.types.array"
  49107. ><B
  49108. CLASS="type"
  49109. >array</B
  49110. ></A
  49111. >-Zeiger
  49112. zurⁿck.</P
  49113. ></BLOCKQUOTE
  49114. ></DIV
  49115. ><TABLE
  49116. WIDTH="100%"
  49117. BORDER="0"
  49118. CELLPADDING="0"
  49119. CELLSPACING="0"
  49120. CLASS="EXAMPLE"
  49121. ><TR
  49122. ><TD
  49123. ><DIV
  49124. CLASS="example"
  49125. ><A
  49126. NAME="AEN8549"
  49127. ></A
  49128. ><P
  49129. ><B
  49130. >Beispiel 1. <B
  49131. CLASS="function"
  49132. >array_shift()</B
  49133. ></B
  49134. ></P
  49135. ><TABLE
  49136. BORDER="0"
  49137. BGCOLOR="#E0E0E0"
  49138. CELLPADDING="5"
  49139. ><TR
  49140. ><TD
  49141. ><PRE
  49142. CLASS="php"
  49143. ><?php
  49144. $stack = array ("Orange", "Banane", "Apfel", "Himbeere");
  49145. $fruit = array_shift ($stack);
  49146. print_r($stack);
  49147. ?></PRE
  49148. ></TD
  49149. ></TR
  49150. ></TABLE
  49151. ><P
  49152. >       Danach blieben in <VAR
  49153. CLASS="varname"
  49154. >$stack</VAR
  49155. > 3 Elemente ⁿbrig:
  49156.      </P
  49157. ><TABLE
  49158. BORDER="0"
  49159. BGCOLOR="#E0E0E0"
  49160. CELLPADDING="5"
  49161. ><TR
  49162. ><TD
  49163. ><PRE
  49164. CLASS="php"
  49165. >Array
  49166. (
  49167.     [0] => Banane
  49168.     [1] => Apfel
  49169.     [2] => Himbeere
  49170. )</PRE
  49171. ></TD
  49172. ></TR
  49173. ></TABLE
  49174. ><P
  49175. >       und <VAR
  49176. CLASS="literal"
  49177. >orange</VAR
  49178. > wird
  49179.       <VAR
  49180. CLASS="varname"
  49181. >$fruit</VAR
  49182. > zugeordnet.
  49183.      </P
  49184. ></DIV
  49185. ></TD
  49186. ></TR
  49187. ></TABLE
  49188. ><P
  49189. >      Siehe auch <A
  49190. HREF="#function.array-unshift"
  49191. ><B
  49192. CLASS="function"
  49193. >array_unshift()</B
  49194. ></A
  49195. >,
  49196.      <A
  49197. HREF="#function.array-push"
  49198. ><B
  49199. CLASS="function"
  49200. >array_push()</B
  49201. ></A
  49202. > und
  49203.      <A
  49204. HREF="#function.array-pop"
  49205. ><B
  49206. CLASS="function"
  49207. >array_pop()</B
  49208. ></A
  49209. >.
  49210.     </P
  49211. ></DIV
  49212. ><H1
  49213. ><A
  49214. NAME="function.array-slice"
  49215. ></A
  49216. >array_slice</H1
  49217. ><DIV
  49218. CLASS="refnamediv"
  49219. ><A
  49220. NAME="AEN8564"
  49221. ></A
  49222. ><P
  49223. >    (PHP 4 , PHP 5)</P
  49224. >array_slice -- Extrahiert einen Ausschnitt eines Arrays</DIV
  49225. ><DIV
  49226. CLASS="refsect1"
  49227. ><A
  49228. NAME="AEN8567"
  49229. ></A
  49230. ><H2
  49231. >Beschreibung</H2
  49232. >array <B
  49233. CLASS="methodname"
  49234. >array_slice</B
  49235. > ( array array, int offset [, int length])<BR
  49236. ></BR
  49237. ><P
  49238. >      <B
  49239. CLASS="function"
  49240. >array_slice()</B
  49241. > liefert die mittels
  49242.      <VAR
  49243. CLASS="parameter"
  49244. >offset</VAR
  49245. > und <VAR
  49246. CLASS="parameter"
  49247. >length</VAR
  49248. >
  49249.      spezifizierte Sequenz von Elementen des Arrays
  49250.      <VAR
  49251. CLASS="parameter"
  49252. >array</VAR
  49253. >
  49254.     </P
  49255. ><P
  49256. >      Ist <VAR
  49257. CLASS="parameter"
  49258. >offset</VAR
  49259. > positiv, beginnt die Sequenz bei
  49260.      diesem Offset in dem <VAR
  49261. CLASS="parameter"
  49262. >array</VAR
  49263. >. Ist
  49264.      <VAR
  49265. CLASS="parameter"
  49266. >offset</VAR
  49267. > negativ, beginnt die Sequenz
  49268.      <VAR
  49269. CLASS="parameter"
  49270. >offset</VAR
  49271. > Elemente vor dem Ende von
  49272.      <VAR
  49273. CLASS="parameter"
  49274. >array</VAR
  49275. >.
  49276.     </P
  49277. ><P
  49278. >      Ist <VAR
  49279. CLASS="parameter"
  49280. >length</VAR
  49281. > positiv, enthΣlt die Sequenz
  49282.      genauso viele Elemente. Ist <VAR
  49283. CLASS="parameter"
  49284. >length</VAR
  49285. >
  49286.      negativ, enthΣlt die Sequenz alle Elemente des Arrays von
  49287.      <VAR
  49288. CLASS="parameter"
  49289. >offset</VAR
  49290. > bis <VAR
  49291. CLASS="parameter"
  49292. >length</VAR
  49293. >
  49294.      Elemente vor dem Ende des Arrays. Ist
  49295.      <VAR
  49296. CLASS="parameter"
  49297. >length</VAR
  49298. > nicht angegeben, enthΣlt die
  49299.      Sequenz alle Elemente von <VAR
  49300. CLASS="parameter"
  49301. >offset</VAR
  49302. > bis zum
  49303.      Ende von <VAR
  49304. CLASS="parameter"
  49305. >array</VAR
  49306. >.
  49307.     </P
  49308. ><P
  49309. >      Beachten Sie, dass <B
  49310. CLASS="function"
  49311. >array_slice()</B
  49312. > Schlⁿssel
  49313.      ignoriert, und Offsets sowie LΣngen anhand der aktuellen
  49314.      Positionen berechnet.
  49315.     </P
  49316. ><P
  49317. >      <TABLE
  49318. WIDTH="100%"
  49319. BORDER="0"
  49320. CELLPADDING="0"
  49321. CELLSPACING="0"
  49322. CLASS="EXAMPLE"
  49323. ><TR
  49324. ><TD
  49325. ><DIV
  49326. CLASS="example"
  49327. ><A
  49328. NAME="AEN8603"
  49329. ></A
  49330. ><P
  49331. ><B
  49332. >Beispiel 1. <B
  49333. CLASS="function"
  49334. >array_slice()</B
  49335. ></B
  49336. ></P
  49337. ><TABLE
  49338. BORDER="0"
  49339. BGCOLOR="#E0E0E0"
  49340. CELLPADDING="5"
  49341. ><TR
  49342. ><TD
  49343. ><PRE
  49344. CLASS="php"
  49345. ><?php
  49346. $input = array ("a", "b", "c", "d", "e");
  49347.  
  49348. $output = array_slice ($input, 2);      // liefert "c", "d", und "e"
  49349. $output = array_slice ($input, 2, -1);  // liefert "c", "d"
  49350. $output = array_slice ($input, -2, 1);  // liefert "d"
  49351. $output = array_slice ($input, 0, 3);   // liefert "a", "b", und "c"
  49352. ?></PRE
  49353. ></TD
  49354. ></TR
  49355. ></TABLE
  49356. ></DIV
  49357. ></TD
  49358. ></TR
  49359. ></TABLE
  49360. >
  49361.     </P
  49362. ><P
  49363. >      Siehe auch <A
  49364. HREF="#function.array-splice"
  49365. ><B
  49366. CLASS="function"
  49367. >array_splice()</B
  49368. ></A
  49369. >.
  49370.     </P
  49371. ></DIV
  49372. ><H1
  49373. ><A
  49374. NAME="function.array-splice"
  49375. ></A
  49376. >array_splice</H1
  49377. ><DIV
  49378. CLASS="refnamediv"
  49379. ><A
  49380. NAME="AEN8610"
  49381. ></A
  49382. ><P
  49383. >    (PHP 4 , PHP 5)</P
  49384. >array_splice -- 
  49385.      Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas
  49386.      anderes
  49387.     </DIV
  49388. ><DIV
  49389. CLASS="refsect1"
  49390. ><A
  49391. NAME="AEN8613"
  49392. ></A
  49393. ><H2
  49394. >Beschreibung</H2
  49395. >array <B
  49396. CLASS="methodname"
  49397. >array_splice</B
  49398. > ( array input, int offset [, int length [, array replacement]])<BR
  49399. ></BR
  49400. ><P
  49401. >      <B
  49402. CLASS="function"
  49403. >array_splice()</B
  49404. > entfernt die durch
  49405.      <VAR
  49406. CLASS="parameter"
  49407. >offset</VAR
  49408. > und <VAR
  49409. CLASS="parameter"
  49410. >length</VAR
  49411. >
  49412.      angegebenen Elemente des Arrays <VAR
  49413. CLASS="parameter"
  49414. >input</VAR
  49415. >, und
  49416.      ersetzt diese durch die Elemente des Arrays
  49417.      <VAR
  49418. CLASS="parameter"
  49419. >replacement</VAR
  49420. >, wenn angegeben und gibt ein
  49421.      Array mit den entfernten Elemente zurⁿck.
  49422.     </P
  49423. ><P
  49424. >      Ist <VAR
  49425. CLASS="parameter"
  49426. >offset</VAR
  49427. > positiv, beginnt der zu
  49428.      entfernende Bereich bei diesem Offset vom Anfang des Arrays
  49429.      <VAR
  49430. CLASS="parameter"
  49431. >input</VAR
  49432. >. Ist <VAR
  49433. CLASS="parameter"
  49434. >offset</VAR
  49435. >
  49436.      negativ, beginnt der zu entfernende Bereich
  49437.      <VAR
  49438. CLASS="parameter"
  49439. >offset</VAR
  49440. > Elemente vor dem Ende des Arrays
  49441.      <VAR
  49442. CLASS="parameter"
  49443. >input</VAR
  49444. >.
  49445.     </P
  49446. ><P
  49447. >      Ist <VAR
  49448. CLASS="parameter"
  49449. >length</VAR
  49450. > nicht angegeben, wird alles von
  49451.      <VAR
  49452. CLASS="parameter"
  49453. >offset</VAR
  49454. > bis zum Ende des Arrays
  49455.      entfernt. Ist <VAR
  49456. CLASS="parameter"
  49457. >length</VAR
  49458. > positiv, wird die
  49459.      angegebene Anzahl Elemente entfernt. Ist
  49460.      <VAR
  49461. CLASS="parameter"
  49462. >length</VAR
  49463. > negativ, dann wird der Bereich von
  49464.      <VAR
  49465. CLASS="parameter"
  49466. >length</VAR
  49467. > Elementen vor dem Ende, bis zum
  49468.      Ende des Arrays entfernt. Tipp: Um alles von
  49469.      <VAR
  49470. CLASS="parameter"
  49471. >offset</VAR
  49472. > bis zum Ende des Arrays zu
  49473.      entfernen wenn <VAR
  49474. CLASS="parameter"
  49475. >replacement</VAR
  49476. > ebenfalls
  49477.      angegeben ist, verwenden Sie <VAR
  49478. CLASS="literal"
  49479. >count($input)</VAR
  49480. > als
  49481.      <VAR
  49482. CLASS="parameter"
  49483. >length</VAR
  49484. >.
  49485.     </P
  49486. ><P
  49487. >      Ist das Array <VAR
  49488. CLASS="parameter"
  49489. >replacement</VAR
  49490. > angegeben,
  49491.      werden die entfernten Elemente durch die Elemente dieses Arrays
  49492.      ersetzt. Sind <VAR
  49493. CLASS="parameter"
  49494. >offset</VAR
  49495. > und
  49496.      <VAR
  49497. CLASS="parameter"
  49498. >length</VAR
  49499. > so angegeben dass nichts entfernt
  49500.      wird, werden die Elemente von <VAR
  49501. CLASS="parameter"
  49502. >replacement</VAR
  49503. >
  49504.      an der von <VAR
  49505. CLASS="parameter"
  49506. >offset</VAR
  49507. > spezifizierten Stelle
  49508.      eingefⁿgt. Tipp: Soll die Ersetzung durch nur ein Element erfolgen
  49509.      ist es nicht n÷tig ein Array zu anzugeben es sei denn, dieses
  49510.      Element ist selbst ein Array.
  49511.     </P
  49512. ><P
  49513. >      Hier einige Entsprechungen:
  49514.      <DIV
  49515. CLASS="table"
  49516. ><A
  49517. NAME="AEN8659"
  49518. ></A
  49519. ><P
  49520. ><B
  49521. >Tabelle 1. <B
  49522. CLASS="function"
  49523. >array_splice()</B
  49524. > equivalents</B
  49525. ></P
  49526. ><TABLE
  49527. BORDER="1"
  49528. CLASS="CALSTABLE"
  49529. ><COL><COL><TBODY
  49530. ><TR
  49531. ><TD
  49532. >           array_push($input, $x, $y) 
  49533.          </TD
  49534. ><TD
  49535. >           array_splice($input, count($input), 0, array($x, $y))
  49536.          </TD
  49537. ></TR
  49538. ><TR
  49539. ><TD
  49540. >           array_pop($input) 
  49541.          </TD
  49542. ><TD
  49543. >           array_splice($input, -1)
  49544.          </TD
  49545. ></TR
  49546. ><TR
  49547. ><TD
  49548. >           array_shift($input)
  49549.          </TD
  49550. ><TD
  49551. >           array_splice($input, -1)
  49552.          </TD
  49553. ></TR
  49554. ><TR
  49555. ><TD
  49556. >           array_unshift($input, $x, $y)
  49557.          </TD
  49558. ><TD
  49559. >           array_splice($input, 0, 0, array($x, $y))
  49560.          </TD
  49561. ></TR
  49562. ><TR
  49563. ><TD
  49564. >           $a[$x] = $y
  49565.          </TD
  49566. ><TD
  49567. >           array_splice($input, $x, 1, $y)
  49568.          </TD
  49569. ></TR
  49570. ></TBODY
  49571. ></TABLE
  49572. ></DIV
  49573. >
  49574.     </P
  49575. ><P
  49576. >      Gibt das Array mit den entfernten Elementen zurⁿck.
  49577.     </P
  49578. ><P
  49579. >      <TABLE
  49580. WIDTH="100%"
  49581. BORDER="0"
  49582. CELLPADDING="0"
  49583. CELLSPACING="0"
  49584. CLASS="EXAMPLE"
  49585. ><TR
  49586. ><TD
  49587. ><DIV
  49588. CLASS="example"
  49589. ><A
  49590. NAME="AEN8681"
  49591. ></A
  49592. ><P
  49593. ><B
  49594. >Beispiel 1. <B
  49595. CLASS="function"
  49596. >array_splice()</B
  49597. ></B
  49598. ></P
  49599. ><TABLE
  49600. BORDER="0"
  49601. BGCOLOR="#E0E0E0"
  49602. CELLPADDING="5"
  49603. ><TR
  49604. ><TD
  49605. ><PRE
  49606. CLASS="php"
  49607. ><?php
  49608. $input = array ("rot", "grⁿn", "blau", "gelb");
  49609. array_splice ($input, 2);
  49610. // $input ist nun array ("rot", "grⁿn")
  49611.  
  49612. $input = array ("rot", "grⁿn", "blau", "gelb");
  49613. array_splice ($input, 1, -1);
  49614. // $input ist nun array ("rot", "gelb")
  49615.  
  49616. $input = array ("rot", "grⁿn", "blau", "gelb");
  49617. array_splice ($input, 1, count($input), "orange");
  49618. // $input ist nun array ("rot", "orange")
  49619.  
  49620. $input = array ("rot", "grⁿn", "blau", "gelb");
  49621. array_splice ($input, -1, 1, array("schwarz", "braun"));
  49622. // $input ist nun array ("rot", "grⁿn", "blau", "schwarz", "braun")
  49623. ?></PRE
  49624. ></TD
  49625. ></TR
  49626. ></TABLE
  49627. ></DIV
  49628. ></TD
  49629. ></TR
  49630. ></TABLE
  49631. >
  49632.     </P
  49633. ><P
  49634. >      Siehe auch <A
  49635. HREF="#function.array-slice"
  49636. ><B
  49637. CLASS="function"
  49638. >array_slice()</B
  49639. ></A
  49640. >.
  49641.     </P
  49642. ></DIV
  49643. ><H1
  49644. ><A
  49645. NAME="function.array-sum"
  49646. ></A
  49647. >array_sum</H1
  49648. ><DIV
  49649. CLASS="refnamediv"
  49650. ><A
  49651. NAME="AEN8688"
  49652. ></A
  49653. ><P
  49654. >    (PHP 4 >= 4.0.4, PHP 5)</P
  49655. >array_sum -- 
  49656.      Liefert die Summe der Werte in einem Array
  49657.     </DIV
  49658. ><DIV
  49659. CLASS="refsect1"
  49660. ><A
  49661. NAME="AEN8691"
  49662. ></A
  49663. ><H2
  49664. >Beschreibung</H2
  49665. >mixed <B
  49666. CLASS="methodname"
  49667. >array_sum</B
  49668. > ( array array)<BR
  49669. ></BR
  49670. ><P
  49671. >      <B
  49672. CLASS="function"
  49673. >array_sum()</B
  49674. > liefert die Summe der Werte eines
  49675.      Arrays als Integer oder Float.
  49676.     </P
  49677. ><P
  49678. >      <TABLE
  49679. WIDTH="100%"
  49680. BORDER="0"
  49681. CELLPADDING="0"
  49682. CELLSPACING="0"
  49683. CLASS="EXAMPLE"
  49684. ><TR
  49685. ><TD
  49686. ><DIV
  49687. CLASS="example"
  49688. ><A
  49689. NAME="AEN8702"
  49690. ></A
  49691. ><P
  49692. ><B
  49693. >Beispiel 1. <B
  49694. CLASS="function"
  49695. >array_sum()</B
  49696. ></B
  49697. ></P
  49698. ><TABLE
  49699. BORDER="0"
  49700. BGCOLOR="#E0E0E0"
  49701. CELLPADDING="5"
  49702. ><TR
  49703. ><TD
  49704. ><PRE
  49705. CLASS="php"
  49706. ><?php
  49707. $a = array(2, 4, 6, 8);
  49708. echo "sum(a) = ".array_sum($a)."\n";
  49709.  
  49710. $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4);
  49711. echo "sum(b) = ".array_sum($b)."\n";
  49712. ?></PRE
  49713. ></TD
  49714. ></TR
  49715. ></TABLE
  49716. ><P
  49717. >        Obiges Programm wird folgendes ausgeben:
  49718.       </P
  49719. ><TABLE
  49720. BORDER="0"
  49721. BGCOLOR="#E0E0E0"
  49722. CELLPADDING="5"
  49723. ><TR
  49724. ><TD
  49725. ><PRE
  49726. CLASS="php"
  49727. >sum(a) = 20
  49728. sum(b) = 6.9</PRE
  49729. ></TD
  49730. ></TR
  49731. ></TABLE
  49732. ></DIV
  49733. ></TD
  49734. ></TR
  49735. ></TABLE
  49736. >
  49737.     </P
  49738. ><DIV
  49739. CLASS="note"
  49740. ><BLOCKQUOTE
  49741. CLASS="note"
  49742. ><P
  49743. ><B
  49744. >Anmerkung: </B
  49745. >
  49746.       PHP Versionen vor 4.2.1 haben das ⁿbergebene Array selbst
  49747.       modifiziert, und Strings in Zahlen konvertiert (welche
  49748.       abhΣngig von deren Wert meist zu null konvertiert wurden).
  49749.      </P
  49750. ></BLOCKQUOTE
  49751. ></DIV
  49752. ></DIV
  49753. ><H1
  49754. ><A
  49755. NAME="function.array-udiff-assoc"
  49756. ></A
  49757. >array_udiff_assoc</H1
  49758. ><DIV
  49759. CLASS="refnamediv"
  49760. ><A
  49761. NAME="AEN8711"
  49762. ></A
  49763. ><P
  49764. >    (PHP 5)</P
  49765. >array_udiff_assoc -- Computes the difference of arrays with additional index check. The data is compared by using a callback function</DIV
  49766. ><DIV
  49767. CLASS="refsect1"
  49768. ><A
  49769. NAME="AEN8714"
  49770. ></A
  49771. ><H2
  49772. >Description</H2
  49773. >array <B
  49774. CLASS="methodname"
  49775. >array_udiff_assoc</B
  49776. > ( array array1, array array2 [, array ..., callback data_compare_func])<BR
  49777. ></BR
  49778. ><P
  49779. >      <B
  49780. CLASS="function"
  49781. >array_udiff_assoc()</B
  49782. > returns an <A
  49783. HREF="#language.types.array"
  49784. ><B
  49785. CLASS="type"
  49786. >array</B
  49787. ></A
  49788. >
  49789.      containing all the values from <VAR
  49790. CLASS="parameter"
  49791. >array1</VAR
  49792. >
  49793.      that are not present in any of the other arguments.
  49794.      Note that the keys are used in the comparison unlike 
  49795.      <A
  49796. HREF="#function.array-diff"
  49797. ><B
  49798. CLASS="function"
  49799. >array_diff()</B
  49800. ></A
  49801. > and <A
  49802. HREF="#function.array-udiff"
  49803. ><B
  49804. CLASS="function"
  49805. >array_udiff()</B
  49806. ></A
  49807. >.
  49808.      The comparison of arrays' data is performed by using an user-supplied
  49809.      callback. In this aspect the behaviour is opposite to the behaviour of
  49810.      <A
  49811. HREF="#function.array-diff-assoc"
  49812. ><B
  49813. CLASS="function"
  49814. >array_diff_assoc()</B
  49815. ></A
  49816. > which uses internal function for
  49817.      comparison.
  49818.     </P
  49819. ><P
  49820. >      <TABLE
  49821. WIDTH="100%"
  49822. BORDER="0"
  49823. CELLPADDING="0"
  49824. CELLSPACING="0"
  49825. CLASS="EXAMPLE"
  49826. ><TR
  49827. ><TD
  49828. ><DIV
  49829. CLASS="example"
  49830. ><A
  49831. NAME="AEN8739"
  49832. ></A
  49833. ><P
  49834. ><B
  49835. >Beispiel 1. <B
  49836. CLASS="function"
  49837. >array_udiff_assoc()</B
  49838. > example</B
  49839. ></P
  49840. ><TABLE
  49841. BORDER="0"
  49842. BGCOLOR="#E0E0E0"
  49843. CELLPADDING="5"
  49844. ><TR
  49845. ><TD
  49846. ><PRE
  49847. CLASS="php"
  49848. ><?php
  49849. class cr {
  49850.     private $priv_member;
  49851.     function cr($val) 
  49852.     {
  49853.         $this->priv_member = $val;
  49854.     }
  49855.     
  49856.     function comp_func_cr($a, $b) 
  49857.     {
  49858.         if ($a->priv_member === $b->priv_member) return 0;
  49859.         return ($a->priv_member > $b->priv_member)? 1:-1;
  49860.     }
  49861. }
  49862.  
  49863. $a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
  49864. $b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
  49865.  
  49866. $result = array_udiff_assoc($a, $b, array("cr", "comp_func_cr"));
  49867. print_r($result);
  49868. ?></PRE
  49869. ></TD
  49870. ></TR
  49871. ></TABLE
  49872. ><P
  49873. >        The result is:
  49874.       </P
  49875. ><TABLE
  49876. BORDER="0"
  49877. BGCOLOR="#E0E0E0"
  49878. CELLPADDING="5"
  49879. ><TR
  49880. ><TD
  49881. ><PRE
  49882. CLASS="screen"
  49883. >Array
  49884. (
  49885.     [0.1] => cr Object
  49886.         (
  49887.             [priv_member:private] => 9
  49888.         )
  49889.  
  49890.     [0.5] => cr Object
  49891.         (
  49892.             [priv_member:private] => 12
  49893.         )
  49894.  
  49895.     [0] => cr Object
  49896.         (
  49897.             [priv_member:private] => 23
  49898.         )
  49899. )</PRE
  49900. ></TD
  49901. ></TR
  49902. ></TABLE
  49903. ></DIV
  49904. ></TD
  49905. ></TR
  49906. ></TABLE
  49907. >
  49908.     </P
  49909. ><P
  49910. >      In our example above you see the <VAR
  49911. CLASS="literal"
  49912. >"1" => new cr(4)</VAR
  49913. >
  49914.      pair is present in both arrays and thus it is not in the ouput from the
  49915.      function.
  49916.     </P
  49917. ><P
  49918. >      For comparison is used the user supplied callback function.
  49919.      It must return an integer less than, equal
  49920.      to, or greater than zero if the first argument is considered to
  49921.      be respectively less than, equal to, or greater than the
  49922.      second.
  49923.     </P
  49924. ><DIV
  49925. CLASS="note"
  49926. ><BLOCKQUOTE
  49927. CLASS="note"
  49928. ><P
  49929. ><B
  49930. >Anmerkung: </B
  49931. >
  49932.       Please note that this function only checks one dimension of a n-dimensional
  49933.       array. Of course you can check deeper dimensions by using, for example, 
  49934.       <VAR
  49935. CLASS="literal"
  49936. >array_udiff_assoc($array1[0], $array2[0], "some_comparison_func");</VAR
  49937. >.
  49938.      </P
  49939. ></BLOCKQUOTE
  49940. ></DIV
  49941. ><P
  49942. >      See also
  49943.      <A
  49944. HREF="#function.array-diff"
  49945. ><B
  49946. CLASS="function"
  49947. >array_diff()</B
  49948. ></A
  49949. >,
  49950.      <A
  49951. HREF="#function.array-diff-assoc"
  49952. ><B
  49953. CLASS="function"
  49954. >array_diff_assoc()</B
  49955. ></A
  49956. >,
  49957.      <A
  49958. HREF="#function.array-diff-uassoc"
  49959. ><B
  49960. CLASS="function"
  49961. >array_diff_uassoc()</B
  49962. ></A
  49963. >,
  49964.      <A
  49965. HREF="#function.array-udiff"
  49966. ><B
  49967. CLASS="function"
  49968. >array_udiff()</B
  49969. ></A
  49970. >,
  49971.      <A
  49972. HREF="#function.array-udiff-uassoc"
  49973. ><B
  49974. CLASS="function"
  49975. >array_udiff_uassoc()</B
  49976. ></A
  49977. >, 
  49978.      <A
  49979. HREF="#function.array-intersect"
  49980. ><B
  49981. CLASS="function"
  49982. >array_intersect()</B
  49983. ></A
  49984. >,  
  49985.      <A
  49986. HREF="#function.array-intersect-assoc"
  49987. ><B
  49988. CLASS="function"
  49989. >array_intersect_assoc()</B
  49990. ></A
  49991. >,
  49992.      <A
  49993. HREF="#function.array-uintersect"
  49994. ><B
  49995. CLASS="function"
  49996. >array_uintersect()</B
  49997. ></A
  49998. >,  
  49999.      <A
  50000. HREF="#function.array-uintersect-assoc"
  50001. ><B
  50002. CLASS="function"
  50003. >array_uintersect_assoc()</B
  50004. ></A
  50005. > and 
  50006.      <A
  50007. HREF="#function.array-uintersect-uassoc"
  50008. ><B
  50009. CLASS="function"
  50010. >array_uintersect_uassoc()</B
  50011. ></A
  50012. >.
  50013.     </P
  50014. ></DIV
  50015. ><H1
  50016. ><A
  50017. NAME="function.array-udiff-uassoc"
  50018. ></A
  50019. >array_udiff_uassoc</H1
  50020. ><DIV
  50021. CLASS="refnamediv"
  50022. ><A
  50023. NAME="AEN8763"
  50024. ></A
  50025. ><P
  50026. >    (PHP 5)</P
  50027. >array_udiff_uassoc -- Computes the difference of arrays with additional index check. The data is compared by using a callback function. The index check is done by a callback function also</DIV
  50028. ><DIV
  50029. CLASS="refsect1"
  50030. ><A
  50031. NAME="AEN8766"
  50032. ></A
  50033. ><H2
  50034. >Description</H2
  50035. >array <B
  50036. CLASS="methodname"
  50037. >array_udiff_uassoc</B
  50038. > ( array array1, array array2 [, array ..., callback data_compare_func, callback key_compare_func])<BR
  50039. ></BR
  50040. ><P
  50041. >      <B
  50042. CLASS="function"
  50043. >array_udiff_uassoc()</B
  50044. > returns an <A
  50045. HREF="#language.types.array"
  50046. ><B
  50047. CLASS="type"
  50048. >array</B
  50049. ></A
  50050. >
  50051.      containing all the values from <VAR
  50052. CLASS="parameter"
  50053. >array1</VAR
  50054. >
  50055.      that are not present in any of the other arguments.
  50056.      Note that the keys are used in the comparison unlike 
  50057.      <A
  50058. HREF="#function.array-diff"
  50059. ><B
  50060. CLASS="function"
  50061. >array_diff()</B
  50062. ></A
  50063. > and <A
  50064. HREF="#function.array-udiff"
  50065. ><B
  50066. CLASS="function"
  50067. >array_udiff()</B
  50068. ></A
  50069. >.
  50070.      The comparison of arrays' data is performed by using an user-supplied
  50071.      callback : <VAR
  50072. CLASS="parameter"
  50073. >data_compare_func</VAR
  50074. >. In this aspect
  50075.      the behaviour is opposite to the behaviour of
  50076.      <A
  50077. HREF="#function.array-diff-assoc"
  50078. ><B
  50079. CLASS="function"
  50080. >array_diff_assoc()</B
  50081. ></A
  50082. > which uses internal function for
  50083.      comparison. The comparison of keys (indices) is done also by the 
  50084.      callback function <VAR
  50085. CLASS="parameter"
  50086. >key_compare_func</VAR
  50087. >. This
  50088.      behaviour is unlike what <A
  50089. HREF="#function.array-udiff-assoc"
  50090. ><B
  50091. CLASS="function"
  50092. >array_udiff_assoc()</B
  50093. ></A
  50094. > does, since
  50095.      the latter compares the indices by using an internal function.
  50096.     </P
  50097. ><P
  50098. >      <TABLE
  50099. WIDTH="100%"
  50100. BORDER="0"
  50101. CELLPADDING="0"
  50102. CELLSPACING="0"
  50103. CLASS="EXAMPLE"
  50104. ><TR
  50105. ><TD
  50106. ><DIV
  50107. CLASS="example"
  50108. ><A
  50109. NAME="AEN8797"
  50110. ></A
  50111. ><P
  50112. ><B
  50113. >Beispiel 1. <B
  50114. CLASS="function"
  50115. >array_udiff_uassoc()</B
  50116. > example</B
  50117. ></P
  50118. ><TABLE
  50119. BORDER="0"
  50120. BGCOLOR="#E0E0E0"
  50121. CELLPADDING="5"
  50122. ><TR
  50123. ><TD
  50124. ><PRE
  50125. CLASS="php"
  50126. ><?php
  50127. class cr {
  50128.     private $priv_member;
  50129.     function cr($val) 
  50130.     {
  50131.         $this->priv_member = $val;
  50132.     }
  50133.  
  50134.     function comp_func_cr($a, $b) 
  50135.     {
  50136.         if ($a->priv_member === $b->priv_member) return 0;
  50137.         return ($a->priv_member > $b->priv_member)? 1:-1;
  50138.     }
  50139.     
  50140.     function comp_func_key($a, $b) 
  50141.     {
  50142.         if ($a === $b) return 0;
  50143.         return ($a > $b)? 1:-1;
  50144.     }
  50145. }
  50146. $a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
  50147. $b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
  50148.  
  50149. $result = array_udiff_uassoc($a, $b, array("cr", "comp_func_cr"), array("cr", "comp_func_key"));
  50150. print_r($result);
  50151. ?></PRE
  50152. ></TD
  50153. ></TR
  50154. ></TABLE
  50155. ><P
  50156. >        The result is:
  50157.       </P
  50158. ><TABLE
  50159. BORDER="0"
  50160. BGCOLOR="#E0E0E0"
  50161. CELLPADDING="5"
  50162. ><TR
  50163. ><TD
  50164. ><PRE
  50165. CLASS="screen"
  50166. >Array
  50167. (
  50168.     [0.1] => cr Object
  50169.         (
  50170.             [priv_member:private] => 9
  50171.         )
  50172.  
  50173.     [0.5] => cr Object
  50174.         (
  50175.             [priv_member:private] => 12
  50176.         )
  50177.  
  50178.     [0] => cr Object
  50179.         (
  50180.             [priv_member:private] => 23
  50181.         )
  50182. )</PRE
  50183. ></TD
  50184. ></TR
  50185. ></TABLE
  50186. ></DIV
  50187. ></TD
  50188. ></TR
  50189. ></TABLE
  50190. >
  50191.     </P
  50192. ><P
  50193. >      In our example above you see the <VAR
  50194. CLASS="literal"
  50195. >"1" => new cr(4)</VAR
  50196. >
  50197.      pair is present in both arrays and thus it is not in the ouput from the
  50198.      function. Keep in mind that you have to supply 2 callback functions.
  50199.     </P
  50200. ><P
  50201. >      For comparison is used the user supplied callback function.
  50202.      It must return an integer less than, equal
  50203.      to, or greater than zero if the first argument is considered to
  50204.      be respectively less than, equal to, or greater than the
  50205.      second.
  50206.     </P
  50207. ><DIV
  50208. CLASS="note"
  50209. ><BLOCKQUOTE
  50210. CLASS="note"
  50211. ><P
  50212. ><B
  50213. >Anmerkung: </B
  50214. >
  50215.       Please note that this function only checks one dimension of a n-dimensional
  50216.       array. Of course you can check deeper dimensions by using, for example, 
  50217.       <VAR
  50218. CLASS="literal"
  50219. >array_udiff_uassoc($array1[0], $array2[0], "data_compare_func",
  50220.       "key_compare_func");</VAR
  50221. >.
  50222.      </P
  50223. ></BLOCKQUOTE
  50224. ></DIV
  50225. ><P
  50226. >      See also
  50227.      <A
  50228. HREF="#function.array-diff"
  50229. ><B
  50230. CLASS="function"
  50231. >array_diff()</B
  50232. ></A
  50233. >,
  50234.      <A
  50235. HREF="#function.array-diff-assoc"
  50236. ><B
  50237. CLASS="function"
  50238. >array_diff_assoc()</B
  50239. ></A
  50240. >,
  50241.      <A
  50242. HREF="#function.array-diff-uassoc"
  50243. ><B
  50244. CLASS="function"
  50245. >array_diff_uassoc()</B
  50246. ></A
  50247. >,
  50248.      <A
  50249. HREF="#function.array-udiff"
  50250. ><B
  50251. CLASS="function"
  50252. >array_udiff()</B
  50253. ></A
  50254. >,
  50255.      <A
  50256. HREF="#function.array-udiff-assoc"
  50257. ><B
  50258. CLASS="function"
  50259. >array_udiff_assoc()</B
  50260. ></A
  50261. >, 
  50262.      <A
  50263. HREF="#function.array-intersect"
  50264. ><B
  50265. CLASS="function"
  50266. >array_intersect()</B
  50267. ></A
  50268. >,  
  50269.      <A
  50270. HREF="#function.array-intersect-assoc"
  50271. ><B
  50272. CLASS="function"
  50273. >array_intersect_assoc()</B
  50274. ></A
  50275. >,
  50276.      <A
  50277. HREF="#function.array-uintersect"
  50278. ><B
  50279. CLASS="function"
  50280. >array_uintersect()</B
  50281. ></A
  50282. >,  
  50283.      <A
  50284. HREF="#function.array-uintersect-assoc"
  50285. ><B
  50286. CLASS="function"
  50287. >array_uintersect_assoc()</B
  50288. ></A
  50289. > and 
  50290.      <A
  50291. HREF="#function.array-uintersect-uassoc"
  50292. ><B
  50293. CLASS="function"
  50294. >array_uintersect_uassoc()</B
  50295. ></A
  50296. >.
  50297.     </P
  50298. ></DIV
  50299. ><H1
  50300. ><A
  50301. NAME="function.array-udiff"
  50302. ></A
  50303. >array_udiff</H1
  50304. ><DIV
  50305. CLASS="refnamediv"
  50306. ><A
  50307. NAME="AEN8821"
  50308. ></A
  50309. ><P
  50310. >    (PHP 5)</P
  50311. >array_udiff -- Computes the difference of arrays by using a callback function for data comparison</DIV
  50312. ><DIV
  50313. CLASS="refsect1"
  50314. ><A
  50315. NAME="AEN8824"
  50316. ></A
  50317. ><H2
  50318. >Description</H2
  50319. >array <B
  50320. CLASS="methodname"
  50321. >array_udiff</B
  50322. > ( array array1, array array2 [, array ..., callback data_compare_func])<BR
  50323. ></BR
  50324. ><P
  50325. >      <B
  50326. CLASS="function"
  50327. >array_udiff()</B
  50328. > returns an array
  50329.      containing all the values of <VAR
  50330. CLASS="parameter"
  50331. >array1</VAR
  50332. >
  50333.      that are not present in any of the other arguments.
  50334.      Note that keys are preserved. For the comparison of the data
  50335.      <VAR
  50336. CLASS="parameter"
  50337. >data_compare_func</VAR
  50338. > is used.
  50339.      It must return an integer less than, equal
  50340.      to, or greater than zero if the first argument is considered to
  50341.      be respectively less than, equal to, or greater than the
  50342.      second. This is unlike <A
  50343. HREF="#function.array-diff"
  50344. ><B
  50345. CLASS="function"
  50346. >array_diff()</B
  50347. ></A
  50348. > which uses an
  50349.      internal function for comparing the data.
  50350.     </P
  50351. ><P
  50352. >      <TABLE
  50353. WIDTH="100%"
  50354. BORDER="0"
  50355. CELLPADDING="0"
  50356. CELLSPACING="0"
  50357. CLASS="EXAMPLE"
  50358. ><TR
  50359. ><TD
  50360. ><DIV
  50361. CLASS="example"
  50362. ><A
  50363. NAME="AEN8847"
  50364. ></A
  50365. ><P
  50366. ><B
  50367. >Beispiel 1. <B
  50368. CLASS="function"
  50369. >array_udiff()</B
  50370. > example</B
  50371. ></P
  50372. ><TABLE
  50373. BORDER="0"
  50374. BGCOLOR="#E0E0E0"
  50375. CELLPADDING="5"
  50376. ><TR
  50377. ><TD
  50378. ><PRE
  50379. CLASS="php"
  50380. ><?php
  50381. class cr {
  50382.     private $priv_member;
  50383.     function cr($val) 
  50384.     {
  50385.         $this->priv_member = $val;
  50386.     }
  50387.     
  50388.     function comp_func_cr($a, $b) 
  50389.     {
  50390.         if ($a->priv_member === $b->priv_member) return 0;
  50391.         return ($a->priv_member > $b->priv_member)? 1:-1;
  50392.     }
  50393. }
  50394. $a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
  50395. $b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
  50396.  
  50397. $result = array_udiff($a, $b, array("cr", "comp_func_cr"));
  50398. print_r($result);
  50399. ?></PRE
  50400. ></TD
  50401. ></TR
  50402. ></TABLE
  50403. ><P
  50404. >        The result is:
  50405.       </P
  50406. ><TABLE
  50407. BORDER="0"
  50408. BGCOLOR="#E0E0E0"
  50409. CELLPADDING="5"
  50410. ><TR
  50411. ><TD
  50412. ><PRE
  50413. CLASS="screen"
  50414. >Array
  50415. (
  50416.     [0.5] => cr Object
  50417.         (
  50418.             [priv_member:private] => 12
  50419.         )
  50420.  
  50421.     [0] => cr Object
  50422.         (
  50423.             [priv_member:private] => 23
  50424.         )
  50425.  
  50426. )</PRE
  50427. ></TD
  50428. ></TR
  50429. ></TABLE
  50430. ></DIV
  50431. ></TD
  50432. ></TR
  50433. ></TABLE
  50434. >
  50435.     </P
  50436. ><DIV
  50437. CLASS="note"
  50438. ><BLOCKQUOTE
  50439. CLASS="note"
  50440. ><P
  50441. ><B
  50442. >Anmerkung: </B
  50443. >
  50444.       Two elements are considered equal if and only if
  50445.       <VAR
  50446. CLASS="literal"
  50447. >(string) $elem1 === (string) $elem2</VAR
  50448. >. In words:
  50449.       when the string representation is the same.
  50450.      </P
  50451. ></BLOCKQUOTE
  50452. ></DIV
  50453. ><DIV
  50454. CLASS="note"
  50455. ><BLOCKQUOTE
  50456. CLASS="note"
  50457. ><P
  50458. ><B
  50459. >Anmerkung: </B
  50460. >
  50461.       Please note that this function only checks one dimension of a n-dimensional
  50462.       array. Of course you can check deeper dimensions by using
  50463.       <VAR
  50464. CLASS="literal"
  50465. >array_udiff($array1[0], $array2[0], "data_compare_func");</VAR
  50466. >.
  50467.      </P
  50468. ></BLOCKQUOTE
  50469. ></DIV
  50470. ><P
  50471. >      See also
  50472.      <A
  50473. HREF="#function.array-diff"
  50474. ><B
  50475. CLASS="function"
  50476. >array_diff()</B
  50477. ></A
  50478. >,
  50479.      <A
  50480. HREF="#function.array-diff-assoc"
  50481. ><B
  50482. CLASS="function"
  50483. >array_diff_assoc()</B
  50484. ></A
  50485. >,
  50486.      <A
  50487. HREF="#function.array-diff-uassoc"
  50488. ><B
  50489. CLASS="function"
  50490. >array_diff_uassoc()</B
  50491. ></A
  50492. >,
  50493.      <A
  50494. HREF="#function.array-udiff-assoc"
  50495. ><B
  50496. CLASS="function"
  50497. >array_udiff_assoc()</B
  50498. ></A
  50499. >, 
  50500.      <A
  50501. HREF="#function.array-udiff-uassoc"
  50502. ><B
  50503. CLASS="function"
  50504. >array_udiff_uassoc()</B
  50505. ></A
  50506. >, 
  50507.      <A
  50508. HREF="#function.array-intersect"
  50509. ><B
  50510. CLASS="function"
  50511. >array_intersect()</B
  50512. ></A
  50513. >,  
  50514.      <A
  50515. HREF="#function.array-intersect-assoc"
  50516. ><B
  50517. CLASS="function"
  50518. >array_intersect_assoc()</B
  50519. ></A
  50520. >,
  50521.      <A
  50522. HREF="#function.array-uintersect"
  50523. ><B
  50524. CLASS="function"
  50525. >array_uintersect()</B
  50526. ></A
  50527. >,  
  50528.      <A
  50529. HREF="#function.array-uintersect-assoc"
  50530. ><B
  50531. CLASS="function"
  50532. >array_uintersect_assoc()</B
  50533. ></A
  50534. > and 
  50535.      <A
  50536. HREF="#function.array-uintersect-uassoc"
  50537. ><B
  50538. CLASS="function"
  50539. >array_uintersect_uassoc()</B
  50540. ></A
  50541. >.
  50542.     </P
  50543. ></DIV
  50544. ><H1
  50545. ><A
  50546. NAME="function.array-uintersect-assoc"
  50547. ></A
  50548. >array_uintersect_assoc</H1
  50549. ><DIV
  50550. CLASS="refnamediv"
  50551. ><A
  50552. NAME="AEN8871"
  50553. ></A
  50554. ><P
  50555. >    (PHP 5)</P
  50556. >array_uintersect_assoc -- Computes the intersection of arrays with additional index check. The data is compared by using a callback function</DIV
  50557. ><DIV
  50558. CLASS="refsect1"
  50559. ><A
  50560. NAME="AEN8874"
  50561. ></A
  50562. ><H2
  50563. >Description</H2
  50564. >array <B
  50565. CLASS="methodname"
  50566. >array_uintersect_assoc</B
  50567. > ( array array1, array array2 [, array ..., callback data_compare_func])<BR
  50568. ></BR
  50569. ><P
  50570. >      <B
  50571. CLASS="function"
  50572. >array_uintersect_assoc()</B
  50573. > returns an array
  50574.      containing all the values of <VAR
  50575. CLASS="parameter"
  50576. >array1</VAR
  50577. >
  50578.      that are present in all the arguments. Note that the keys are used in
  50579.      the comparison unlike in <A
  50580. HREF="#function.array-uintersect"
  50581. ><B
  50582. CLASS="function"
  50583. >array_uintersect()</B
  50584. ></A
  50585. >.
  50586.      The data is compared by using a callback function.
  50587.     </P
  50588. ><P
  50589. >      <TABLE
  50590. WIDTH="100%"
  50591. BORDER="0"
  50592. CELLPADDING="0"
  50593. CELLSPACING="0"
  50594. CLASS="EXAMPLE"
  50595. ><TR
  50596. ><TD
  50597. ><DIV
  50598. CLASS="example"
  50599. ><A
  50600. NAME="AEN8896"
  50601. ></A
  50602. ><P
  50603. ><B
  50604. >Beispiel 1. <B
  50605. CLASS="function"
  50606. >array_uintersect_assoc()</B
  50607. > example</B
  50608. ></P
  50609. ><TABLE
  50610. BORDER="0"
  50611. BGCOLOR="#E0E0E0"
  50612. CELLPADDING="5"
  50613. ><TR
  50614. ><TD
  50615. ><PRE
  50616. CLASS="php"
  50617. ><?php
  50618. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  50619. $array2 = array("a" => "GREEN", "B" => "brown", "yellow", "red");
  50620.  
  50621. print_r(array_uintersect_assoc($array1, $array2, "strcasecmp"));
  50622. ?></PRE
  50623. ></TD
  50624. ></TR
  50625. ></TABLE
  50626. ><P
  50627. >        Result will look like:
  50628.       </P
  50629. ><TABLE
  50630. BORDER="0"
  50631. BGCOLOR="#E0E0E0"
  50632. CELLPADDING="5"
  50633. ><TR
  50634. ><TD
  50635. ><PRE
  50636. CLASS="screen"
  50637. >Array
  50638. (
  50639.     [a] => green
  50640. )</PRE
  50641. ></TD
  50642. ></TR
  50643. ></TABLE
  50644. ></DIV
  50645. ></TD
  50646. ></TR
  50647. ></TABLE
  50648. >
  50649.     </P
  50650. ><P
  50651. >      For comparison is used the user supplied callback function.
  50652.      It must return an integer less than, equal
  50653.      to, or greater than zero if the first argument is considered to
  50654.      be respectively less than, equal to, or greater than the
  50655.      second.
  50656.     </P
  50657. ><P
  50658. >      See also <A
  50659. HREF="#function.array-uintersect"
  50660. ><B
  50661. CLASS="function"
  50662. >array_uintersect()</B
  50663. ></A
  50664. >,
  50665.      <A
  50666. HREF="#function.array-intersect-assoc"
  50667. ><B
  50668. CLASS="function"
  50669. >array_intersect_assoc()</B
  50670. ></A
  50671. >,
  50672.      <A
  50673. HREF="#function.array-intersect-uassoc"
  50674. ><B
  50675. CLASS="function"
  50676. >array_intersect_uassoc()</B
  50677. ></A
  50678. > and
  50679.      <A
  50680. HREF="#function.array-uintersect-uassoc"
  50681. ><B
  50682. CLASS="function"
  50683. >array_uintersect_uassoc()</B
  50684. ></A
  50685. >.
  50686.     </P
  50687. ></DIV
  50688. ><H1
  50689. ><A
  50690. NAME="function.array-uintersect-uassoc"
  50691. ></A
  50692. >array_uintersect_uassoc</H1
  50693. ><DIV
  50694. CLASS="refnamediv"
  50695. ><A
  50696. NAME="AEN8909"
  50697. ></A
  50698. ><P
  50699. >    (PHP 5)</P
  50700. >array_uintersect_uassoc -- Computes the intersection of arrays with additional index check. Both the data and the indexes are compared by using a callback functions</DIV
  50701. ><DIV
  50702. CLASS="refsect1"
  50703. ><A
  50704. NAME="AEN8912"
  50705. ></A
  50706. ><H2
  50707. >Description</H2
  50708. >array <B
  50709. CLASS="methodname"
  50710. >array_uintersect_uassoc</B
  50711. > ( array array1, array array2 [, array ..., callback data_compare_func, callback key_compare_func])<BR
  50712. ></BR
  50713. ><P
  50714. >      <B
  50715. CLASS="function"
  50716. >array_uintersect_uassoc()</B
  50717. > returns an array
  50718.      containing all the values of <VAR
  50719. CLASS="parameter"
  50720. >array1</VAR
  50721. >
  50722.      that are present in all the arguments. Note that the keys are used in
  50723.      the comparison unlike in <A
  50724. HREF="#function.array-uintersect"
  50725. ><B
  50726. CLASS="function"
  50727. >array_uintersect()</B
  50728. ></A
  50729. >.
  50730.      Both the data and the indexes are compared by using a callback functions.
  50731.     </P
  50732. ><P
  50733. >      <TABLE
  50734. WIDTH="100%"
  50735. BORDER="0"
  50736. CELLPADDING="0"
  50737. CELLSPACING="0"
  50738. CLASS="EXAMPLE"
  50739. ><TR
  50740. ><TD
  50741. ><DIV
  50742. CLASS="example"
  50743. ><A
  50744. NAME="AEN8937"
  50745. ></A
  50746. ><P
  50747. ><B
  50748. >Beispiel 1. <B
  50749. CLASS="function"
  50750. >array_uintersect_uassoc()</B
  50751. > example</B
  50752. ></P
  50753. ><TABLE
  50754. BORDER="0"
  50755. BGCOLOR="#E0E0E0"
  50756. CELLPADDING="5"
  50757. ><TR
  50758. ><TD
  50759. ><PRE
  50760. CLASS="php"
  50761. ><?php
  50762. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  50763. $array2 = array("a" => "GREEN", "B" => "brown", "yellow", "red");
  50764.  
  50765. print_r(array_uintersect_uassoc($array1, $array2, "strcasecmp", "strcasecmp"));
  50766. ?></PRE
  50767. ></TD
  50768. ></TR
  50769. ></TABLE
  50770. ><P
  50771. >        Result will look like:
  50772.       </P
  50773. ><TABLE
  50774. BORDER="0"
  50775. BGCOLOR="#E0E0E0"
  50776. CELLPADDING="5"
  50777. ><TR
  50778. ><TD
  50779. ><PRE
  50780. CLASS="screen"
  50781. >Array
  50782. (
  50783.     [a] => green
  50784.     [b] => brown
  50785. )</PRE
  50786. ></TD
  50787. ></TR
  50788. ></TABLE
  50789. ></DIV
  50790. ></TD
  50791. ></TR
  50792. ></TABLE
  50793. >
  50794.     </P
  50795. ><P
  50796. >      For comparison is used the user supplied callback function.
  50797.      It must return an integer less than, equal
  50798.      to, or greater than zero if the first argument is considered to
  50799.      be respectively less than, equal to, or greater than the
  50800.      second.
  50801.     </P
  50802. ><P
  50803. >      See also <A
  50804. HREF="#function.array-uintersect"
  50805. ><B
  50806. CLASS="function"
  50807. >array_uintersect()</B
  50808. ></A
  50809. >,
  50810.      <A
  50811. HREF="#function.array-intersect-assoc"
  50812. ><B
  50813. CLASS="function"
  50814. >array_intersect_assoc()</B
  50815. ></A
  50816. >,
  50817.      <A
  50818. HREF="#function.array-intersect-uassoc"
  50819. ><B
  50820. CLASS="function"
  50821. >array_intersect_uassoc()</B
  50822. ></A
  50823. > and
  50824.      <A
  50825. HREF="#function.array-uintersect-assoc"
  50826. ><B
  50827. CLASS="function"
  50828. >array_uintersect_assoc()</B
  50829. ></A
  50830. >.
  50831.     </P
  50832. ></DIV
  50833. ><H1
  50834. ><A
  50835. NAME="function.array-uintersect"
  50836. ></A
  50837. >array_uintersect</H1
  50838. ><DIV
  50839. CLASS="refnamediv"
  50840. ><A
  50841. NAME="AEN8950"
  50842. ></A
  50843. ><P
  50844. >    (PHP 5)</P
  50845. >array_uintersect -- Computes the intersection of arrays. The data is compared by using a callback function</DIV
  50846. ><DIV
  50847. CLASS="refsect1"
  50848. ><A
  50849. NAME="AEN8953"
  50850. ></A
  50851. ><H2
  50852. >Description</H2
  50853. >array <B
  50854. CLASS="methodname"
  50855. >array_uintersect</B
  50856. > ( array array1, array array2 [, array ..., callback data_compare_func])<BR
  50857. ></BR
  50858. ><P
  50859. >      <B
  50860. CLASS="function"
  50861. >array_uintersect()</B
  50862. > returns an array
  50863.      containing all the values of <VAR
  50864. CLASS="parameter"
  50865. >array1</VAR
  50866. >
  50867.      that are present in all the arguments.
  50868.      The data is compared by using a callback function.
  50869.     </P
  50870. ><P
  50871. >      <TABLE
  50872. WIDTH="100%"
  50873. BORDER="0"
  50874. CELLPADDING="0"
  50875. CELLSPACING="0"
  50876. CLASS="EXAMPLE"
  50877. ><TR
  50878. ><TD
  50879. ><DIV
  50880. CLASS="example"
  50881. ><A
  50882. NAME="AEN8974"
  50883. ></A
  50884. ><P
  50885. ><B
  50886. >Beispiel 1. <B
  50887. CLASS="function"
  50888. >array_uintersect()</B
  50889. > example</B
  50890. ></P
  50891. ><TABLE
  50892. BORDER="0"
  50893. BGCOLOR="#E0E0E0"
  50894. CELLPADDING="5"
  50895. ><TR
  50896. ><TD
  50897. ><PRE
  50898. CLASS="php"
  50899. ><?php
  50900. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  50901. $array2 = array("a" => "GREEN", "B" => "brown", "yellow", "red");
  50902.  
  50903. print_r(array_uintersect($array1, $array2, "strcasecmp"));
  50904. ?></PRE
  50905. ></TD
  50906. ></TR
  50907. ></TABLE
  50908. ><P
  50909. >        Result will look like:
  50910.       </P
  50911. ><TABLE
  50912. BORDER="0"
  50913. BGCOLOR="#E0E0E0"
  50914. CELLPADDING="5"
  50915. ><TR
  50916. ><TD
  50917. ><PRE
  50918. CLASS="screen"
  50919. >Array
  50920. (
  50921.     [a] => green
  50922.     [b] => brown
  50923.     [0] => red
  50924. )</PRE
  50925. ></TD
  50926. ></TR
  50927. ></TABLE
  50928. ></DIV
  50929. ></TD
  50930. ></TR
  50931. ></TABLE
  50932. >
  50933.     </P
  50934. ><P
  50935. >      For comparison is used the user supplied callback function.
  50936.      It must return an integer less than, equal
  50937.      to, or greater than zero if the first argument is considered to
  50938.      be respectively less than, equal to, or greater than the
  50939.      second.
  50940.     </P
  50941. ><P
  50942. >      See also <A
  50943. HREF="#function.array-intersect"
  50944. ><B
  50945. CLASS="function"
  50946. >array_intersect()</B
  50947. ></A
  50948. >,
  50949.      <A
  50950. HREF="#function.array-uintersect-assoc"
  50951. ><B
  50952. CLASS="function"
  50953. >array_uintersect_assoc()</B
  50954. ></A
  50955. >,
  50956.      <A
  50957. HREF="#function.array-intersect-uassoc"
  50958. ><B
  50959. CLASS="function"
  50960. >array_intersect_uassoc()</B
  50961. ></A
  50962. > and
  50963.      <A
  50964. HREF="#function.array-uintersect-uassoc"
  50965. ><B
  50966. CLASS="function"
  50967. >array_uintersect_uassoc()</B
  50968. ></A
  50969. >.
  50970.     </P
  50971. ></DIV
  50972. ><H1
  50973. ><A
  50974. NAME="function.array-unique"
  50975. ></A
  50976. >array_unique</H1
  50977. ><DIV
  50978. CLASS="refnamediv"
  50979. ><A
  50980. NAME="AEN8987"
  50981. ></A
  50982. ><P
  50983. >    (PHP 4 >= 4.0.1, PHP 5)</P
  50984. >array_unique -- Entfernt doppelte Werte aus einem Array</DIV
  50985. ><DIV
  50986. CLASS="refsect1"
  50987. ><A
  50988. NAME="AEN8990"
  50989. ></A
  50990. ><H2
  50991. >Beschreibung</H2
  50992. >array <B
  50993. CLASS="methodname"
  50994. >array_unique</B
  50995. > ( array array)<BR
  50996. ></BR
  50997. ><P
  50998. >      <B
  50999. CLASS="function"
  51000. >array_unique()</B
  51001. > nimmt
  51002.      <VAR
  51003. CLASS="parameter"
  51004. >array</VAR
  51005. > und gibt ein neues Array zurⁿck, aus
  51006.      dem alle doppelten EintrΣge entfernt wurden.
  51007.     </P
  51008. ><P
  51009. >      Beachten Sie, dass Schlⁿssel bewahrt bleiben. Erst behandelt
  51010.      <B
  51011. CLASS="function"
  51012. >array_unique()</B
  51013. > die Werte als Strings und sortiert
  51014.      sie, danach wird der erste gefundene Schlⁿssel behalten, und alle
  51015.      folgenden Schlⁿssel ignoriert. Das hei▀t nicht, dass der Schlⁿssel
  51016.      des ersten zugeh÷rigen Wertes aus dem unsortierten
  51017.      <VAR
  51018. CLASS="parameter"
  51019. >array</VAR
  51020. > behalten wird.
  51021.     </P
  51022. ><DIV
  51023. CLASS="note"
  51024. ><BLOCKQUOTE
  51025. CLASS="note"
  51026. ><P
  51027. ><B
  51028. >Anmerkung: </B
  51029. >
  51030.       Zwei Elemente werden nur dann als gleich angesehen, wenn
  51031.       <VAR
  51032. CLASS="literal"
  51033. >(string) $elem1 === (string) $elem2</VAR
  51034. >. In Worten:
  51035.       Wenn die String-ReprΣsentation die gleiche ist.
  51036.      </P
  51037. ><P
  51038. >       Das erste Element wird verwendet.
  51039.      </P
  51040. ></BLOCKQUOTE
  51041. ></DIV
  51042. ><P
  51043. >      <TABLE
  51044. WIDTH="100%"
  51045. BORDER="0"
  51046. CELLPADDING="0"
  51047. CELLSPACING="0"
  51048. CLASS="EXAMPLE"
  51049. ><TR
  51050. ><TD
  51051. ><DIV
  51052. CLASS="example"
  51053. ><A
  51054. NAME="AEN9009"
  51055. ></A
  51056. ><P
  51057. ><B
  51058. >Beispiel 1. <B
  51059. CLASS="function"
  51060. >array_unique()</B
  51061. > example</B
  51062. ></P
  51063. ><TABLE
  51064. BORDER="0"
  51065. BGCOLOR="#E0E0E0"
  51066. CELLPADDING="5"
  51067. ><TR
  51068. ><TD
  51069. ><PRE
  51070. CLASS="php"
  51071. ><?php
  51072. $input = array ("a" => "grⁿn", "rot", "b" => "grⁿn", "blau", "rot");
  51073. $result = array_unique ($input);
  51074. print_r($result);
  51075. ?></PRE
  51076. ></TD
  51077. ></TR
  51078. ></TABLE
  51079. ><P
  51080. >        Dies wird folgendes ausgeben:
  51081.       </P
  51082. ><TABLE
  51083. BORDER="0"
  51084. BGCOLOR="#E0E0E0"
  51085. CELLPADDING="5"
  51086. ><TR
  51087. ><TD
  51088. ><PRE
  51089. CLASS="php"
  51090. >Array
  51091. (
  51092.     [a] => grⁿn
  51093.     [0] => rot
  51094.     [1] => blau
  51095. )</PRE
  51096. ></TD
  51097. ></TR
  51098. ></TABLE
  51099. ></DIV
  51100. ></TD
  51101. ></TR
  51102. ></TABLE
  51103. >
  51104.     </P
  51105. ><P
  51106. >      <TABLE
  51107. WIDTH="100%"
  51108. BORDER="0"
  51109. CELLPADDING="0"
  51110. CELLSPACING="0"
  51111. CLASS="EXAMPLE"
  51112. ><TR
  51113. ><TD
  51114. ><DIV
  51115. CLASS="example"
  51116. ><A
  51117. NAME="AEN9016"
  51118. ></A
  51119. ><P
  51120. ><B
  51121. >Beispiel 2. <B
  51122. CLASS="function"
  51123. >array_unique()</B
  51124. > und Typen</B
  51125. ></P
  51126. ><TABLE
  51127. BORDER="0"
  51128. BGCOLOR="#E0E0E0"
  51129. CELLPADDING="5"
  51130. ><TR
  51131. ><TD
  51132. ><PRE
  51133. CLASS="php"
  51134. ><?php
  51135. $input = array (4,"4","3",4,3,"3");
  51136. $result = array_unique ($input);
  51137. var_dump($result);
  51138. ?></PRE
  51139. ></TD
  51140. ></TR
  51141. ></TABLE
  51142. ><P
  51143. >        Dies wird folgendes ausgeben:
  51144.       </P
  51145. ><TABLE
  51146. BORDER="0"
  51147. BGCOLOR="#E0E0E0"
  51148. CELLPADDING="5"
  51149. ><TR
  51150. ><TD
  51151. ><PRE
  51152. CLASS="php"
  51153. >array(2) {
  51154.   [0] => int(4)
  51155.   [2] => string(1) "3"
  51156. }</PRE
  51157. ></TD
  51158. ></TR
  51159. ></TABLE
  51160. ></DIV
  51161. ></TD
  51162. ></TR
  51163. ></TABLE
  51164. >
  51165.     </P
  51166. ></DIV
  51167. ><H1
  51168. ><A
  51169. NAME="function.array-unshift"
  51170. ></A
  51171. >array_unshift</H1
  51172. ><DIV
  51173. CLASS="refnamediv"
  51174. ><A
  51175. NAME="AEN9023"
  51176. ></A
  51177. ><P
  51178. >    (PHP 4 , PHP 5)</P
  51179. >array_unshift -- 
  51180.      Fⁿgt ein oder mehr Elemente am Anfang eines Arrays ein
  51181.     </DIV
  51182. ><DIV
  51183. CLASS="refsect1"
  51184. ><A
  51185. NAME="AEN9026"
  51186. ></A
  51187. ><H2
  51188. >Beschreibung</H2
  51189. >int <B
  51190. CLASS="methodname"
  51191. >array_unshift</B
  51192. > ( array array, mixed var [, mixed ...])<BR
  51193. ></BR
  51194. ><P
  51195. >      <B
  51196. CLASS="function"
  51197. >array_unshift()</B
  51198. > fⁿgt die ⁿbergebenen Elemente
  51199.      am Anfang von <VAR
  51200. CLASS="parameter"
  51201. >array</VAR
  51202. > ein. Beachten Sie,
  51203.      dass die Liste von Elementen als Ganzes eingefⁿgt wird, sodass
  51204.      die eingefⁿgten Elemente die selbe Reihenfolge haben. Die
  51205.      numerischen Schlⁿssel werden so modifiziert, dass bei null zu
  51206.      zΣhlen begonnen wird, Strings als Schlⁿssel bleiben unverΣndert.
  51207.     </P
  51208. ><P
  51209. >      Diese Funktion gibt die neue Anzahl der in
  51210.      <VAR
  51211. CLASS="parameter"
  51212. >array</VAR
  51213. > enthaltenen Elemente zurⁿck.
  51214.     </P
  51215. ><P
  51216. >      <TABLE
  51217. WIDTH="100%"
  51218. BORDER="0"
  51219. CELLPADDING="0"
  51220. CELLSPACING="0"
  51221. CLASS="EXAMPLE"
  51222. ><TR
  51223. ><TD
  51224. ><DIV
  51225. CLASS="example"
  51226. ><A
  51227. NAME="AEN9046"
  51228. ></A
  51229. ><P
  51230. ><B
  51231. >Beispiel 1. <B
  51232. CLASS="function"
  51233. >array_unshift()</B
  51234. ></B
  51235. ></P
  51236. ><TABLE
  51237. BORDER="0"
  51238. BGCOLOR="#E0E0E0"
  51239. CELLPADDING="5"
  51240. ><TR
  51241. ><TD
  51242. ><PRE
  51243. CLASS="php"
  51244. ><?php
  51245. $queue = array ("Orange", "Banane");
  51246. array_unshift ($queue, "Apfel", "Himbeere");
  51247. ?></PRE
  51248. ></TD
  51249. ></TR
  51250. ></TABLE
  51251. ><P
  51252. >        Als Ergebnis enthΣlt <VAR
  51253. CLASS="varname"
  51254. >$queue</VAR
  51255. >
  51256.        die folgenden Elemente:
  51257.       </P
  51258. ><TABLE
  51259. BORDER="0"
  51260. BGCOLOR="#E0E0E0"
  51261. CELLPADDING="5"
  51262. ><TR
  51263. ><TD
  51264. ><PRE
  51265. CLASS="php"
  51266. >Array
  51267. (
  51268.     [0] => Apfel
  51269.     [1] => Himbeere
  51270.     [2] => Orange
  51271.     [3] => Banane
  51272. )</PRE
  51273. ></TD
  51274. ></TR
  51275. ></TABLE
  51276. ></DIV
  51277. ></TD
  51278. ></TR
  51279. ></TABLE
  51280. >
  51281.     </P
  51282. ><P
  51283. >      Siehe auch <A
  51284. HREF="#function.array-shift"
  51285. ><B
  51286. CLASS="function"
  51287. >array_shift()</B
  51288. ></A
  51289. >,
  51290.      <A
  51291. HREF="#function.array-push"
  51292. ><B
  51293. CLASS="function"
  51294. >array_push()</B
  51295. ></A
  51296. > und
  51297.      <A
  51298. HREF="#function.array-pop"
  51299. ><B
  51300. CLASS="function"
  51301. >array_pop()</B
  51302. ></A
  51303. >.
  51304.     </P
  51305. ></DIV
  51306. ><H1
  51307. ><A
  51308. NAME="function.array-values"
  51309. ></A
  51310. >array_values</H1
  51311. ><DIV
  51312. CLASS="refnamediv"
  51313. ><A
  51314. NAME="AEN9058"
  51315. ></A
  51316. ><P
  51317. >    (PHP 4 , PHP 5)</P
  51318. >array_values -- Liefert alle Werte eines Arrays</DIV
  51319. ><DIV
  51320. CLASS="refsect1"
  51321. ><A
  51322. NAME="AEN9061"
  51323. ></A
  51324. ><H2
  51325. >Beschreibung</H2
  51326. >array <B
  51327. CLASS="methodname"
  51328. >array_values</B
  51329. > ( array input)<BR
  51330. ></BR
  51331. ><P
  51332. >      <B
  51333. CLASS="function"
  51334. >array_values()</B
  51335. > liefert alle Werte des Arrays
  51336.      <VAR
  51337. CLASS="parameter"
  51338. >input</VAR
  51339. > mit einem numerischen Index.
  51340.     </P
  51341. ><P
  51342. >      <TABLE
  51343. WIDTH="100%"
  51344. BORDER="0"
  51345. CELLPADDING="0"
  51346. CELLSPACING="0"
  51347. CLASS="EXAMPLE"
  51348. ><TR
  51349. ><TD
  51350. ><DIV
  51351. CLASS="example"
  51352. ><A
  51353. NAME="AEN9073"
  51354. ></A
  51355. ><P
  51356. ><B
  51357. >Beispiel 1. <B
  51358. CLASS="function"
  51359. >array_values()</B
  51360. ></B
  51361. ></P
  51362. ><TABLE
  51363. BORDER="0"
  51364. BGCOLOR="#E0E0E0"
  51365. CELLPADDING="5"
  51366. ><TR
  51367. ><TD
  51368. ><PRE
  51369. CLASS="php"
  51370. ><?php
  51371. $array = array ("gr÷▀e" => "XL", "farbe" => "gold");
  51372. print_r(array_values ($array));
  51373. ?></PRE
  51374. ></TD
  51375. ></TR
  51376. ></TABLE
  51377. ><P
  51378. >        Dies wird folgendes ausgeben:
  51379.       </P
  51380. ><TABLE
  51381. BORDER="0"
  51382. BGCOLOR="#E0E0E0"
  51383. CELLPADDING="5"
  51384. ><TR
  51385. ><TD
  51386. ><PRE
  51387. CLASS="php"
  51388. >Array
  51389. (
  51390.     [0] => XL
  51391.     [1] => gold
  51392. )</PRE
  51393. ></TD
  51394. ></TR
  51395. ></TABLE
  51396. ></DIV
  51397. ></TD
  51398. ></TR
  51399. ></TABLE
  51400. >
  51401.     </P
  51402. ><P
  51403. >      Siehe auch <A
  51404. HREF="#function.array-keys"
  51405. ><B
  51406. CLASS="function"
  51407. >array_keys()</B
  51408. ></A
  51409. >.
  51410.     </P
  51411. ></DIV
  51412. ><H1
  51413. ><A
  51414. NAME="function.array-walk-recursive"
  51415. ></A
  51416. >array_walk_recursive</H1
  51417. ><DIV
  51418. CLASS="refnamediv"
  51419. ><A
  51420. NAME="AEN9082"
  51421. ></A
  51422. ><P
  51423. >    (PHP 5)</P
  51424. >array_walk_recursive -- 
  51425.    Apply a user function recursively to every member of an array
  51426.   </DIV
  51427. ><DIV
  51428. CLASS="refsect1"
  51429. ><A
  51430. NAME="AEN9085"
  51431. ></A
  51432. ><H2
  51433. >Description</H2
  51434. >bool <B
  51435. CLASS="methodname"
  51436. >array_walk_recursive</B
  51437. > ( array &input, string funcname [, mixed userdata])<BR
  51438. ></BR
  51439. ><P
  51440. >    Applies the user-defined function <VAR
  51441. CLASS="parameter"
  51442. >funcname</VAR
  51443. > to each
  51444.    element of the <VAR
  51445. CLASS="parameter"
  51446. >input</VAR
  51447. > array. This function will recur
  51448.    into deeper arrays. Typically,  <VAR
  51449. CLASS="parameter"
  51450. >funcname</VAR
  51451. > takes on two
  51452.    parameters. The <VAR
  51453. CLASS="parameter"
  51454. >input</VAR
  51455. > parameter's value being the first, and
  51456.    the key/index second. If the optional <VAR
  51457. CLASS="parameter"
  51458. >userdata</VAR
  51459. >
  51460.    parameter is supplied, it will be passed as the third parameter to
  51461.    the callback <VAR
  51462. CLASS="parameter"
  51463. >funcname</VAR
  51464. >.
  51465.   </P
  51466. ><P
  51467. >    Gibt bei Erfolg <TT
  51468. CLASS="constant"
  51469. ><B
  51470. >TRUE</B
  51471. ></TT
  51472. > zurⁿck, im Fehlerfall <TT
  51473. CLASS="constant"
  51474. ><B
  51475. >FALSE</B
  51476. ></TT
  51477. >.
  51478.   </P
  51479. ><DIV
  51480. CLASS="note"
  51481. ><BLOCKQUOTE
  51482. CLASS="note"
  51483. ><P
  51484. ><B
  51485. >Anmerkung: </B
  51486. >
  51487.     If <VAR
  51488. CLASS="parameter"
  51489. >funcname</VAR
  51490. > needs to be working with the
  51491.     actual values of the array, specify the first parameter of
  51492.     <VAR
  51493. CLASS="parameter"
  51494. >funcname</VAR
  51495. > as a 
  51496.     <A
  51497. HREF="#language.references"
  51498. >reference</A
  51499. >. Then,
  51500.     any changes made to those elements will be made in the 
  51501.     original array itself.
  51502.    </P
  51503. ></BLOCKQUOTE
  51504. ></DIV
  51505. ><P
  51506. >    <TABLE
  51507. WIDTH="100%"
  51508. BORDER="0"
  51509. CELLPADDING="0"
  51510. CELLSPACING="0"
  51511. CLASS="EXAMPLE"
  51512. ><TR
  51513. ><TD
  51514. ><DIV
  51515. CLASS="example"
  51516. ><A
  51517. NAME="AEN9115"
  51518. ></A
  51519. ><P
  51520. ><B
  51521. >Beispiel 1. <B
  51522. CLASS="function"
  51523. >array_walk_recursive()</B
  51524. > example</B
  51525. ></P
  51526. ><TABLE
  51527. BORDER="0"
  51528. BGCOLOR="#E0E0E0"
  51529. CELLPADDING="5"
  51530. ><TR
  51531. ><TD
  51532. ><PRE
  51533. CLASS="php"
  51534. ><?php
  51535. $sweet = array('a' => 'apple', 'b' => 'banana');
  51536. $fruits = array('sweet' => $sweet, 'sour' => 'lemon');
  51537.  
  51538. function test_print($item, $key) 
  51539. {
  51540.     echo "$key holds $item\n";
  51541. }
  51542.  
  51543. array_walk_recursive($fruits, 'test_print');
  51544. ?></PRE
  51545. ></TD
  51546. ></TR
  51547. ></TABLE
  51548. ><P
  51549. >      The printout of the program above will be:
  51550.     </P
  51551. ><TABLE
  51552. BORDER="0"
  51553. BGCOLOR="#E0E0E0"
  51554. CELLPADDING="5"
  51555. ><TR
  51556. ><TD
  51557. ><PRE
  51558. CLASS="php"
  51559. >a holds apple
  51560. b holds banana
  51561. sour holds lemon</PRE
  51562. ></TD
  51563. ></TR
  51564. ></TABLE
  51565. ><P
  51566. >      You may notice that the key 'sweet' is never displayed. Any key that holds an
  51567.      <A
  51568. HREF="#language.types.array"
  51569. ><B
  51570. CLASS="type"
  51571. >array</B
  51572. ></A
  51573. > will not be passed to the function.
  51574.     </P
  51575. ></DIV
  51576. ></TD
  51577. ></TR
  51578. ></TABLE
  51579. >
  51580.   </P
  51581. ><P
  51582. >    See also <A
  51583. HREF="#function.array-walk"
  51584. ><B
  51585. CLASS="function"
  51586. >array_walk()</B
  51587. ></A
  51588. >.
  51589.   </P
  51590. ></DIV
  51591. ><H1
  51592. ><A
  51593. NAME="function.array-walk"
  51594. ></A
  51595. >array_walk</H1
  51596. ><DIV
  51597. CLASS="refnamediv"
  51598. ><A
  51599. NAME="AEN9126"
  51600. ></A
  51601. ><P
  51602. >    (PHP 3>= 3.0.3, PHP 4 , PHP 5)</P
  51603. >array_walk -- 
  51604.      Wendet eine Benutzerfunktion an jedem Element eines Arrays an
  51605.     </DIV
  51606. ><DIV
  51607. CLASS="refsect1"
  51608. ><A
  51609. NAME="AEN9129"
  51610. ></A
  51611. ><H2
  51612. >Beschreibung</H2
  51613. >int <B
  51614. CLASS="methodname"
  51615. >array_walk</B
  51616. > ( array array, callback function [, mixed userdata])<BR
  51617. ></BR
  51618. ><P
  51619. >
  51620.        Gibt bei Erfolg <TT
  51621. CLASS="constant"
  51622. ><B
  51623. >TRUE</B
  51624. ></TT
  51625. > zurⁿck, im Fehlerfall <TT
  51626. CLASS="constant"
  51627. ><B
  51628. >FALSE</B
  51629. ></TT
  51630. >.
  51631.  
  51632.       </P
  51633. ><P
  51634. >      Wendet die mittels <VAR
  51635. CLASS="parameter"
  51636. >function</VAR
  51637. > angegebene
  51638.      Benutzerfunktion fⁿr jedes Element von <VAR
  51639. CLASS="parameter"
  51640. >array</VAR
  51641. >
  51642.      an. <VAR
  51643. CLASS="parameter"
  51644. >function</VAR
  51645. > ben÷tigt zwei Parameter. Der Wert
  51646.      von <VAR
  51647. CLASS="parameter"
  51648. >array</VAR
  51649. > wird als erster ⁿbergeben, und der
  51650.      Schlⁿssel/Index als zweites. Ist der optionale Parameter
  51651.      <VAR
  51652. CLASS="parameter"
  51653. >userdata</VAR
  51654. > angegeben, so wird er als dritter
  51655.      Parameter an die Funktion <VAR
  51656. CLASS="parameter"
  51657. >function</VAR
  51658. > ⁿbergeben.
  51659.     </P
  51660. ><P
  51661. >      Sollte <VAR
  51662. CLASS="parameter"
  51663. >function</VAR
  51664. > mehr als die ihr ⁿbergebenen
  51665.      Parameter ben÷tigen, wird bei jedem Aufruf von
  51666.      <VAR
  51667. CLASS="parameter"
  51668. >function</VAR
  51669. > seitens <B
  51670. CLASS="function"
  51671. >array_walk()</B
  51672. >
  51673.      eine Fehlermeldung der Stufe <A
  51674. HREF="#errorfunc.constants"
  51675. >      E_WARNING</A
  51676. > generiert. Diese Warnmeldungen k÷nnen unterdrⁿckt
  51677.      werden, indem man dem Funktionsaufruf von
  51678.      <B
  51679. CLASS="function"
  51680. >array_walk()</B
  51681. > den Operator <A
  51682. HREF="#language.operators.errorcontrol"
  51683. >@</A
  51684. > voranstellt,
  51685.      oder <A
  51686. HREF="#function.error-reporting"
  51687. ><B
  51688. CLASS="function"
  51689. >error_reporting()</B
  51690. ></A
  51691. > verwendet.
  51692.     </P
  51693. ><DIV
  51694. CLASS="note"
  51695. ><BLOCKQUOTE
  51696. CLASS="note"
  51697. ><P
  51698. ><B
  51699. >Anmerkung: </B
  51700. >
  51701.       Wenn <VAR
  51702. CLASS="parameter"
  51703. >function</VAR
  51704. > direkt mit den Werten des
  51705.       Arrays arbeiten soll, spezifizieren Sie den ersten Parameter
  51706.       von <VAR
  51707. CLASS="parameter"
  51708. >function</VAR
  51709. > als <A
  51710. HREF="#language.references"
  51711. >Referenz</A
  51712. >. Dann werden alle
  51713.       ─nderungen an diesen Elementen direkt in dem originalen Array
  51714.       durchgefⁿhrt.
  51715.      </P
  51716. ><P
  51717. >       Die Modifizierung des Arrays aus <VAR
  51718. CLASS="parameter"
  51719. >function</VAR
  51720. >
  51721.       heraus k÷nnte ein unvorhersehbares Verhalten hervorrufen.
  51722.      </P
  51723. ></BLOCKQUOTE
  51724. ></DIV
  51725. ><DIV
  51726. CLASS="note"
  51727. ><BLOCKQUOTE
  51728. CLASS="note"
  51729. ><P
  51730. ><B
  51731. >Anmerkung: </B
  51732. >
  51733.       Die ▄bergabe des Schlⁿssels und von <VAR
  51734. CLASS="parameter"
  51735. >userdata</VAR
  51736. >
  51737.       an <VAR
  51738. CLASS="parameter"
  51739. >function</VAR
  51740. > wurde mit PHP 4.0.0 eingefⁿhrt.
  51741.      </P
  51742. ></BLOCKQUOTE
  51743. ></DIV
  51744. ><P
  51745. >      <B
  51746. CLASS="function"
  51747. >array_walk()</B
  51748. > ist nicht von dem internen
  51749.      Arrayzeiger von <VAR
  51750. CLASS="parameter"
  51751. >array</VAR
  51752. > betroffen. <B
  51753. CLASS="function"
  51754. >      array_walk()</B
  51755. > geht ungeachtet der Zeigerposition das
  51756.      gesamte Array durch. Um den Zeiger zurⁿckzusetzen, verwenden Sie
  51757.      <A
  51758. HREF="#function.reset"
  51759. ><B
  51760. CLASS="function"
  51761. >reset()</B
  51762. ></A
  51763. >. In PHP 3 setzt
  51764.      <B
  51765. CLASS="function"
  51766. >array_walk()</B
  51767. > den Zeiger zurⁿck.
  51768.     </P
  51769. ><P
  51770. >      Von der Benutzerfunktion aus darf das Array selbst nicht geΣndert
  51771.      werden, wie zum Beispiel durch Hinzufⁿgen oder L÷schen eines
  51772.      Elementes, etc. Wird das auf <B
  51773. CLASS="function"
  51774. >array_walk()</B
  51775. > 
  51776.      angewendete Array geΣndert, so ist das Verhalten dieser Funktion
  51777.      undefiniert und unvorhersagbar.
  51778.     </P
  51779. ><P
  51780. >      <TABLE
  51781. WIDTH="100%"
  51782. BORDER="0"
  51783. CELLPADDING="0"
  51784. CELLSPACING="0"
  51785. CLASS="EXAMPLE"
  51786. ><TR
  51787. ><TD
  51788. ><DIV
  51789. CLASS="example"
  51790. ><A
  51791. NAME="AEN9181"
  51792. ></A
  51793. ><P
  51794. ><B
  51795. >Beispiel 1. <B
  51796. CLASS="function"
  51797. >array_walk()</B
  51798. ></B
  51799. ></P
  51800. ><TABLE
  51801. BORDER="0"
  51802. BGCOLOR="#E0E0E0"
  51803. CELLPADDING="5"
  51804. ><TR
  51805. ><TD
  51806. ><PRE
  51807. CLASS="php"
  51808. ><?php
  51809. $fruits = array ("d"=>"Zitrone", "a"=>"Orange", "b"=>"Banane", "c"=>"Apfel");
  51810.  
  51811. function test_alter (&$item1, $key, $prefix) {
  51812.     $item1 = "$prefix: $item1";
  51813. }
  51814.  
  51815. function test_print ($item2, $key) {
  51816.     echo "$key. $item2<br>\n";
  51817. }
  51818.  
  51819. echo "Vorher ...:\n";
  51820. array_walk ($fruits, 'test_print');
  51821.  
  51822. array_walk ($fruits, 'test_alter', 'Frucht');
  51823. echo "... und nachher:\n";
  51824.  
  51825. array_walk ($fruits, 'test_print');
  51826. ?></PRE
  51827. ></TD
  51828. ></TR
  51829. ></TABLE
  51830. ><P
  51831. >        Das obige Programm wird folgendes ausgeben:
  51832.       </P
  51833. ><TABLE
  51834. BORDER="0"
  51835. BGCOLOR="#E0E0E0"
  51836. CELLPADDING="5"
  51837. ><TR
  51838. ><TD
  51839. ><PRE
  51840. CLASS="php"
  51841. >Vorher ...:
  51842. d. Zitrone
  51843. a. Orange
  51844. b. Banane
  51845. c. Apfel
  51846. ... und nachher:
  51847. d. Frucht: Zitrone
  51848. a. Frucht: Orange
  51849. b. Frucht: Banane
  51850. c. Frucht: Apfel</PRE
  51851. ></TD
  51852. ></TR
  51853. ></TABLE
  51854. ></DIV
  51855. ></TD
  51856. ></TR
  51857. ></TABLE
  51858. >
  51859.     </P
  51860. ><P
  51861. >      Siehe auch <A
  51862. HREF="#function.list"
  51863. ><B
  51864. CLASS="function"
  51865. >list()</B
  51866. ></A
  51867. >, 
  51868.      <A
  51869. HREF="#control-structures.foreach"
  51870. >foreach</A
  51871. >, 
  51872.      <A
  51873. HREF="#function.each"
  51874. ><B
  51875. CLASS="function"
  51876. >each()</B
  51877. ></A
  51878. > und <A
  51879. HREF="#function.call-user-func-array"
  51880. ><B
  51881. CLASS="function"
  51882. >call_user_func_array()</B
  51883. ></A
  51884. >.
  51885.     </P
  51886. ></DIV
  51887. ><H1
  51888. ><A
  51889. NAME="function.array"
  51890. ></A
  51891. >array</H1
  51892. ><DIV
  51893. CLASS="refnamediv"
  51894. ><A
  51895. NAME="AEN9193"
  51896. ></A
  51897. ><P
  51898. >    (PHP 3, PHP 4, PHP 5 )</P
  51899. >array -- 
  51900.      Erstellt ein Array
  51901.     </DIV
  51902. ><DIV
  51903. CLASS="refsect1"
  51904. ><A
  51905. NAME="AEN9196"
  51906. ></A
  51907. ><H2
  51908. >Beschreibung</H2
  51909. >array <B
  51910. CLASS="methodname"
  51911. >array</B
  51912. > ( [mixed ...])<BR
  51913. ></BR
  51914. ><P
  51915. >      Gibt ein den Parametern entsprechendes Array zurⁿck. Mit dem
  51916.      <VAR
  51917. CLASS="literal"
  51918. >=></VAR
  51919. > Operator k÷nnen die Parameter indiziert werden.
  51920.      Weitere Informationen zu Arrays finden Sie im Abschnitt
  51921.      <A
  51922. HREF="#language.types.array"
  51923. >array type</A
  51924. >.
  51925.     </P
  51926. ><P
  51927. >      <DIV
  51928. CLASS="note"
  51929. ><BLOCKQUOTE
  51930. CLASS="note"
  51931. ><P
  51932. ><B
  51933. >Anmerkung: </B
  51934. >
  51935.        <B
  51936. CLASS="function"
  51937. >array()</B
  51938. > ist keine richtige Funktion sondern ein
  51939.        Sprachkonstrukt, das zur Erzeugung eines Wertefeldes genutzt wird.
  51940.       </P
  51941. ></BLOCKQUOTE
  51942. ></DIV
  51943. >
  51944.     </P
  51945. ><P
  51946. >      Die Syntax "Index => Werte", durch Kommas getrennt, definiert
  51947.      Index und Werte. Index kann vom Typ String oder numerisch sein.
  51948.      Wird der Index weggelassen, erstellt die Funktion automatisch
  51949.      einen numerischen Index, der bei 0 beginnt. Ist der Index als
  51950.      Integer-Wert angegeben, wird der nΣchste generierte Index der
  51951.      gr÷▀te Integer Index + 1. Beachten Sie, dass wenn zwei identische
  51952.      Indexe definiert sind, der letzte den ersten ⁿberschreibt.
  51953.     </P
  51954. ><P
  51955. >      Das folgende Beispiel zeigt wie man ein zweidimensionales Array
  51956.      erstellt, wie man Schlⁿssel fⁿr assoziative Arrays festlegt, und
  51957.      wie man numerische Indizes in normalen Arrays ⁿberspringt und
  51958.      fortsetzt.
  51959.      <TABLE
  51960. WIDTH="100%"
  51961. BORDER="0"
  51962. CELLPADDING="0"
  51963. CELLSPACING="0"
  51964. CLASS="EXAMPLE"
  51965. ><TR
  51966. ><TD
  51967. ><DIV
  51968. CLASS="example"
  51969. ><A
  51970. NAME="AEN9213"
  51971. ></A
  51972. ><P
  51973. ><B
  51974. >Beispiel 1. <B
  51975. CLASS="function"
  51976. >array()</B
  51977. ></B
  51978. ></P
  51979. ><TABLE
  51980. BORDER="0"
  51981. BGCOLOR="#E0E0E0"
  51982. CELLPADDING="5"
  51983. ><TR
  51984. ><TD
  51985. ><PRE
  51986. CLASS="php"
  51987. ><?php
  51988. $fruits = array (
  51989.     "Frⁿchte" => array ("a"=>"Orange", "b"=>"Banane", "c"=>"Apfel"),
  51990.     "Zahlen"  => array (1, 2, 3, 4, 5, 6),
  51991.     "L÷cher"  => array ("erstes", 5 => "zweites", "drittes")
  51992. );
  51993. ?></PRE
  51994. ></TD
  51995. ></TR
  51996. ></TABLE
  51997. ></DIV
  51998. ></TD
  51999. ></TR
  52000. ></TABLE
  52001. >
  52002.     </P
  52003. ><P
  52004. >      <TABLE
  52005. WIDTH="100%"
  52006. BORDER="0"
  52007. CELLPADDING="0"
  52008. CELLSPACING="0"
  52009. CLASS="EXAMPLE"
  52010. ><TR
  52011. ><TD
  52012. ><DIV
  52013. CLASS="example"
  52014. ><A
  52015. NAME="AEN9218"
  52016. ></A
  52017. ><P
  52018. ><B
  52019. >Beispiel 2. Automatischer Index mit <B
  52020. CLASS="function"
  52021. >array()</B
  52022. ></B
  52023. ></P
  52024. ><TABLE
  52025. BORDER="0"
  52026. BGCOLOR="#E0E0E0"
  52027. CELLPADDING="5"
  52028. ><TR
  52029. ><TD
  52030. ><PRE
  52031. CLASS="php"
  52032. ><?php
  52033. $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13);
  52034. print_r($array);
  52035. ?></PRE
  52036. ></TD
  52037. ></TR
  52038. ></TABLE
  52039. ><P
  52040. >        wird folgendes anzeigen:
  52041.       </P
  52042. ><TABLE
  52043. BORDER="0"
  52044. BGCOLOR="#E0E0E0"
  52045. CELLPADDING="5"
  52046. ><TR
  52047. ><TD
  52048. ><PRE
  52049. CLASS="php"
  52050. >Array
  52051. (
  52052.     [0] => 1
  52053.     [1] => 1
  52054.     [2] => 1
  52055.     [3] => 13
  52056.     [4] => 1
  52057.     [8] => 1
  52058.     [9] => 19
  52059. )</PRE
  52060. ></TD
  52061. ></TR
  52062. ></TABLE
  52063. ></DIV
  52064. ></TD
  52065. ></TR
  52066. ></TABLE
  52067. >
  52068.     </P
  52069. ><P
  52070. >      Beachten Sie, dass Index '3' doppelt definiert ist, und den letzten
  52071.      definierten Wert 13 behΣlt. Index 4 wurde nach dem Index 8 definiert,
  52072.      und der nΣchste generierte Index (Wert 19) ist 9, da der gr÷▀te Index
  52073.      8 war.
  52074.     </P
  52075. ><P
  52076. >      Dieses Beispiel erstellt ein auf dem Index 1 basierendes Array.
  52077.      <TABLE
  52078. WIDTH="100%"
  52079. BORDER="0"
  52080. CELLPADDING="0"
  52081. CELLSPACING="0"
  52082. CLASS="EXAMPLE"
  52083. ><TR
  52084. ><TD
  52085. ><DIV
  52086. CLASS="example"
  52087. ><A
  52088. NAME="AEN9226"
  52089. ></A
  52090. ><P
  52091. ><B
  52092. >Beispiel 3. 1-basierter Index mit <B
  52093. CLASS="function"
  52094. >array()</B
  52095. ></B
  52096. ></P
  52097. ><TABLE
  52098. BORDER="0"
  52099. BGCOLOR="#E0E0E0"
  52100. CELLPADDING="5"
  52101. ><TR
  52102. ><TD
  52103. ><PRE
  52104. CLASS="php"
  52105. ><?php
  52106. $erstesquartal  = array(1 => 'Januar', 'Februar', 'MΣrz');
  52107. print_r($erstesquartal);
  52108. ?></PRE
  52109. ></TD
  52110. ></TR
  52111. ></TABLE
  52112. ><P
  52113. >        wird folgendes ausgeben:
  52114.       </P
  52115. ><TABLE
  52116. BORDER="0"
  52117. BGCOLOR="#E0E0E0"
  52118. CELLPADDING="5"
  52119. ><TR
  52120. ><TD
  52121. ><PRE
  52122. CLASS="screen"
  52123. >Array
  52124. (
  52125.     [1] => Januar
  52126.     [2] => Februar
  52127.     [3] => MΣrz
  52128. )</PRE
  52129. ></TD
  52130. ></TR
  52131. ></TABLE
  52132. ></DIV
  52133. ></TD
  52134. ></TR
  52135. ></TABLE
  52136. >
  52137.     </P
  52138. ><P
  52139. >      Siehe auch <A
  52140. HREF="#function.array-pad"
  52141. ><B
  52142. CLASS="function"
  52143. >array_pad()</B
  52144. ></A
  52145. >,
  52146.      <A
  52147. HREF="#function.list"
  52148. ><B
  52149. CLASS="function"
  52150. >list()</B
  52151. ></A
  52152. >,
  52153.  
  52154.        <A
  52155. HREF="#control-structures.foreach"
  52156. >foreach</A
  52157. > und
  52158.  
  52159.        <A
  52160. HREF="#function.range"
  52161. ><B
  52162. CLASS="function"
  52163. >range()</B
  52164. ></A
  52165. >.
  52166.     </P
  52167. ></DIV
  52168. ><H1
  52169. ><A
  52170. NAME="function.arsort"
  52171. ></A
  52172. >arsort</H1
  52173. ><DIV
  52174. CLASS="refnamediv"
  52175. ><A
  52176. NAME="AEN9238"
  52177. ></A
  52178. ><P
  52179. >    (PHP 3, PHP 4 , PHP 5)</P
  52180. >arsort -- 
  52181.      Sortiert ein Array in umgekehrter Reihenfolge und behΣlt die
  52182.      Verbindung zum Index
  52183.     </DIV
  52184. ><DIV
  52185. CLASS="refsect1"
  52186. ><A
  52187. NAME="AEN9241"
  52188. ></A
  52189. ><H2
  52190. >Beschreibung</H2
  52191. >void <B
  52192. CLASS="methodname"
  52193. >arsort</B
  52194. > ( array array [, int sort_flags])<BR
  52195. ></BR
  52196. ><P
  52197. >      Diese Funktion sortiert ein Array so, dass der Zusammenhang zwischen
  52198.      den Indizes und den entsprechenden Arrayelementen erhalten bleibt.
  52199.      Dies wird hauptsΣchlich bei assoziativen Arrays verwendet, bei denen
  52200.      die aktuelle Reihenfolge der Elemente bedeutend ist.
  52201.     </P
  52202. ><TABLE
  52203. WIDTH="100%"
  52204. BORDER="0"
  52205. CELLPADDING="0"
  52206. CELLSPACING="0"
  52207. CLASS="EXAMPLE"
  52208. ><TR
  52209. ><TD
  52210. ><DIV
  52211. CLASS="example"
  52212. ><A
  52213. NAME="AEN9253"
  52214. ></A
  52215. ><P
  52216. ><B
  52217. >Beispiel 1. <B
  52218. CLASS="function"
  52219. >arsort()</B
  52220. ></B
  52221. ></P
  52222. ><TABLE
  52223. BORDER="0"
  52224. BGCOLOR="#E0E0E0"
  52225. CELLPADDING="5"
  52226. ><TR
  52227. ><TD
  52228. ><PRE
  52229. CLASS="php"
  52230. ><?php
  52231. $fruits = array ("d"=>"Zitrone", "a"=>"Orange", "b"=>"Banane", "c"=>"Apfel");
  52232. arsort ($fruits);
  52233. reset ($fruits);
  52234. while (list ($key, $val) = each ($fruits)) {
  52235.     echo "$key = $val\n";
  52236. }
  52237. ?></PRE
  52238. ></TD
  52239. ></TR
  52240. ></TABLE
  52241. ><P
  52242. >       Dieses Beispiel wⁿrde folgendes ausgeben:
  52243.      </P
  52244. ><TABLE
  52245. BORDER="0"
  52246. BGCOLOR="#E0E0E0"
  52247. CELLPADDING="5"
  52248. ><TR
  52249. ><TD
  52250. ><PRE
  52251. CLASS="screen"
  52252. >d = Zitrone
  52253. a = Orange
  52254. b = Banane
  52255. c = Apfel</PRE
  52256. ></TD
  52257. ></TR
  52258. ></TABLE
  52259. ></DIV
  52260. ></TD
  52261. ></TR
  52262. ></TABLE
  52263. ><P
  52264. >      Die Frⁿchte wurden in umgekehrter alphabetischer Reihenfolge
  52265.      sortiert, und die Zuordnung zwischen Index und Element blieb
  52266.      beibehalten.
  52267.     </P
  52268. ><P
  52269. >      Sie k÷nnen das Verhalten der Sortierung mittels dem optionalen
  52270.      Parameter <VAR
  52271. CLASS="parameter"
  52272. >sort_flags</VAR
  52273. > beeinflussen, fⁿr
  52274.      Details siehe <A
  52275. HREF="#function.sort"
  52276. ><B
  52277. CLASS="function"
  52278. >sort()</B
  52279. ></A
  52280. >.
  52281.     </P
  52282. ><P
  52283. >      Siehe auch <A
  52284. HREF="#function.asort"
  52285. ><B
  52286. CLASS="function"
  52287. >asort()</B
  52288. ></A
  52289. >,
  52290.      <A
  52291. HREF="#function.rsort"
  52292. ><B
  52293. CLASS="function"
  52294. >rsort()</B
  52295. ></A
  52296. >, <A
  52297. HREF="#function.ksort"
  52298. ><B
  52299. CLASS="function"
  52300. >ksort()</B
  52301. ></A
  52302. > und
  52303.      <A
  52304. HREF="#function.sort"
  52305. ><B
  52306. CLASS="function"
  52307. >sort()</B
  52308. ></A
  52309. >.
  52310.     </P
  52311. ></DIV
  52312. ><H1
  52313. ><A
  52314. NAME="function.asort"
  52315. ></A
  52316. >asort</H1
  52317. ><DIV
  52318. CLASS="refnamediv"
  52319. ><A
  52320. NAME="AEN9269"
  52321. ></A
  52322. ><P
  52323. >    (PHP 3, PHP 4 , PHP 5)</P
  52324. >asort -- 
  52325.      Sortiert ein Array und behΣlt die Indexverbindungen
  52326.     </DIV
  52327. ><DIV
  52328. CLASS="refsect1"
  52329. ><A
  52330. NAME="AEN9272"
  52331. ></A
  52332. ><H2
  52333. >Beschreibung</H2
  52334. >void <B
  52335. CLASS="methodname"
  52336. >asort</B
  52337. > ( array array [, int sort_flags])<BR
  52338. ></BR
  52339. ><P
  52340. >      Diese Funktion sortiert ein Array so, dass der Zusammenhang
  52341.      zwischen den Indizes und den entsprechenden Arrayelementen
  52342.      erhalten bleibt.  Dies wird hauptsΣchlich bei assoziativen Arrays
  52343.      verwendet, bei denen die aktuelle Reihenfolge der Elemente
  52344.      bedeutend ist.
  52345.     </P
  52346. ><TABLE
  52347. WIDTH="100%"
  52348. BORDER="0"
  52349. CELLPADDING="0"
  52350. CELLSPACING="0"
  52351. CLASS="EXAMPLE"
  52352. ><TR
  52353. ><TD
  52354. ><DIV
  52355. CLASS="example"
  52356. ><A
  52357. NAME="AEN9284"
  52358. ></A
  52359. ><P
  52360. ><B
  52361. >Beispiel 1. <B
  52362. CLASS="function"
  52363. >asort()</B
  52364. ></B
  52365. ></P
  52366. ><TABLE
  52367. BORDER="0"
  52368. BGCOLOR="#E0E0E0"
  52369. CELLPADDING="5"
  52370. ><TR
  52371. ><TD
  52372. ><PRE
  52373. CLASS="php"
  52374. ><?php
  52375. $fruits = array ("d"=>"Zitrone", "a"=>"Orange", "b"=>"Banane", "c"=>"Apfel");
  52376. asort ($fruits);
  52377. reset ($fruits);
  52378. while (list ($key, $val) = each ($fruits)) {
  52379.     echo "$key = $val\n";
  52380. }
  52381. ?></PRE
  52382. ></TD
  52383. ></TR
  52384. ></TABLE
  52385. ><P
  52386. >       Dieses Beispiel wⁿrde folgendes ausgeben:
  52387.      </P
  52388. ><TABLE
  52389. BORDER="0"
  52390. BGCOLOR="#E0E0E0"
  52391. CELLPADDING="5"
  52392. ><TR
  52393. ><TD
  52394. ><PRE
  52395. CLASS="screen"
  52396. >c = Apfel
  52397. b = Banane
  52398. a = Orange
  52399. d = Zitrone</PRE
  52400. ></TD
  52401. ></TR
  52402. ></TABLE
  52403. ></DIV
  52404. ></TD
  52405. ></TR
  52406. ></TABLE
  52407. ><P
  52408. >      Die Frⁿchte wurden alphabetisch sortiert, und die Zuordnung
  52409.      zwischen Index und Element blieb beibehalten
  52410.     </P
  52411. ><P
  52412. >      Sie k÷nnen das Verhalten der Sortierung mittels dem optionalen
  52413.      Parameter <VAR
  52414. CLASS="parameter"
  52415. >sort_flags</VAR
  52416. > beeinflussen, fⁿr
  52417.      Details siehe <A
  52418. HREF="#function.sort"
  52419. ><B
  52420. CLASS="function"
  52421. >sort()</B
  52422. ></A
  52423. >.
  52424.     </P
  52425. ><P
  52426. >      Siehe auch <A
  52427. HREF="#function.arsort"
  52428. ><B
  52429. CLASS="function"
  52430. >arsort()</B
  52431. ></A
  52432. >,
  52433.      <A
  52434. HREF="#function.rsort"
  52435. ><B
  52436. CLASS="function"
  52437. >rsort()</B
  52438. ></A
  52439. >, <A
  52440. HREF="#function.ksort"
  52441. ><B
  52442. CLASS="function"
  52443. >ksort()</B
  52444. ></A
  52445. > und
  52446.      <A
  52447. HREF="#function.sort"
  52448. ><B
  52449. CLASS="function"
  52450. >sort()</B
  52451. ></A
  52452. >.
  52453.     </P
  52454. ></DIV
  52455. ><H1
  52456. ><A
  52457. NAME="function.compact"
  52458. ></A
  52459. >compact</H1
  52460. ><DIV
  52461. CLASS="refnamediv"
  52462. ><A
  52463. NAME="AEN9300"
  52464. ></A
  52465. ><P
  52466. >    (PHP 4 , PHP 5)</P
  52467. >compact -- 
  52468.      Erstellt ein Array mit Variablen und deren Werten
  52469.     </DIV
  52470. ><DIV
  52471. CLASS="refsect1"
  52472. ><A
  52473. NAME="AEN9303"
  52474. ></A
  52475. ><H2
  52476. >Beschreibung</H2
  52477. >array <B
  52478. CLASS="methodname"
  52479. >compact</B
  52480. > ( mixed varname [, mixed ...])<BR
  52481. ></BR
  52482. ><P
  52483. >      <B
  52484. CLASS="function"
  52485. >compact()</B
  52486. > ⁿbernimmt eine variable Anzahl von
  52487.      Parametern. Jeder Parameter kann entweder ein String mit einem
  52488.      Variablennamen, oder ein Array mit Variablennamen sein. Dieses
  52489.      Array kann auch andere Arrays mit Variablennamen enthalten;
  52490.      <B
  52491. CLASS="function"
  52492. >compact()</B
  52493. > behandelt sie rekursiv.
  52494.     </P
  52495. ><P
  52496. >      Fⁿr alle diese sucht <B
  52497. CLASS="function"
  52498. >compact()</B
  52499. > nach einer
  52500.      Variablen in der aktuellen Symboltabelle, und fⁿgt diese dem
  52501.      zurⁿckzugebenden Array hinzu, wobei der Variablenname als
  52502.      Schlⁿssel, und der Inhalt der Variablen als Wert gespeichert
  52503.      wird. Kurz, diese Funktion tut das Gegenteil von
  52504.      <A
  52505. HREF="#function.extract"
  52506. ><B
  52507. CLASS="function"
  52508. >extract()</B
  52509. ></A
  52510. >. Sie gibt ein Array mit allen
  52511.      Variablen zurⁿck.
  52512.     </P
  52513. ><P
  52514. >      Strings, welche nicht gesetzt sind, werden einfach ignoriert.
  52515.     </P
  52516. ><P
  52517. >      <TABLE
  52518. WIDTH="100%"
  52519. BORDER="0"
  52520. CELLPADDING="0"
  52521. CELLSPACING="0"
  52522. CLASS="EXAMPLE"
  52523. ><TR
  52524. ><TD
  52525. ><DIV
  52526. CLASS="example"
  52527. ><A
  52528. NAME="AEN9322"
  52529. ></A
  52530. ><P
  52531. ><B
  52532. >Beispiel 1. <B
  52533. CLASS="function"
  52534. >compact()</B
  52535. ></B
  52536. ></P
  52537. ><TABLE
  52538. BORDER="0"
  52539. BGCOLOR="#E0E0E0"
  52540. CELLPADDING="5"
  52541. ><TR
  52542. ><TD
  52543. ><PRE
  52544. CLASS="php"
  52545. ><?php
  52546. $city = "San Francisco";
  52547. $state = "CA";
  52548. $event = "SIGGRAPH";
  52549.  
  52550. $location_vars = array ("city", "state");
  52551.  
  52552. $result = compact ("event", "nothing_here", $location_vars);
  52553. ?></PRE
  52554. ></TD
  52555. ></TR
  52556. ></TABLE
  52557. ><P
  52558. >        Danach wird <VAR
  52559. CLASS="varname"
  52560. >$result</VAR
  52561. >:
  52562.       </P
  52563. ><TABLE
  52564. BORDER="0"
  52565. BGCOLOR="#E0E0E0"
  52566. CELLPADDING="5"
  52567. ><TR
  52568. ><TD
  52569. ><PRE
  52570. CLASS="php"
  52571. >Array
  52572. (
  52573.     [event] => SIGGRAPH
  52574.     [city] => San Francisco
  52575.     [state] => CA
  52576. )</PRE
  52577. ></TD
  52578. ></TR
  52579. ></TABLE
  52580. ></DIV
  52581. ></TD
  52582. ></TR
  52583. ></TABLE
  52584. >
  52585.     </P
  52586. ><P
  52587. >      Siehe auch <A
  52588. HREF="#function.extract"
  52589. ><B
  52590. CLASS="function"
  52591. >extract()</B
  52592. ></A
  52593. >.
  52594.     </P
  52595. ></DIV
  52596. ><H1
  52597. ><A
  52598. NAME="function.count"
  52599. ></A
  52600. >count</H1
  52601. ><DIV
  52602. CLASS="refnamediv"
  52603. ><A
  52604. NAME="AEN9332"
  52605. ></A
  52606. ><P
  52607. >    (PHP 3, PHP 4 , PHP 5)</P
  52608. >count -- ZΣhlt die Elemente einer Variable</DIV
  52609. ><DIV
  52610. CLASS="refsect1"
  52611. ><A
  52612. NAME="AEN9335"
  52613. ></A
  52614. ><H2
  52615. >Beschreibung</H2
  52616. >int <B
  52617. CLASS="methodname"
  52618. >count</B
  52619. > ( mixed var)<BR
  52620. ></BR
  52621. ><P
  52622. >      Liefert die Anzahl von Elementen in <VAR
  52623. CLASS="parameter"
  52624. >var</VAR
  52625. >,
  52626.      welche typischerweise ein Array ist (da alles andere
  52627.      ein Element enthΣlt).
  52628.     </P
  52629. ><P
  52630. >      Ist <VAR
  52631. CLASS="parameter"
  52632. >var</VAR
  52633. > kein Array, wird <VAR
  52634. CLASS="literal"
  52635. >1</VAR
  52636. >
  52637.      zurⁿckgegeben (Ausnahme: <VAR
  52638. CLASS="literal"
  52639. >count(<TT
  52640. CLASS="constant"
  52641. ><B
  52642. >NULL</B
  52643. ></TT
  52644. >)</VAR
  52645. > ist gleich
  52646.      <VAR
  52647. CLASS="literal"
  52648. >0</VAR
  52649. >).
  52650.     </P
  52651. ><DIV
  52652. CLASS="warning"
  52653. ><P
  52654. ></P
  52655. ><TABLE
  52656. CLASS="warning"
  52657. BORDER="1"
  52658. WIDTH="100%"
  52659. ><TR
  52660. ><TD
  52661. ALIGN="CENTER"
  52662. ><B
  52663. >Warnung</B
  52664. ></TD
  52665. ></TR
  52666. ><TR
  52667. ><TD
  52668. ALIGN="LEFT"
  52669. ><P
  52670. >       <B
  52671. CLASS="function"
  52672. >count()</B
  52673. > kann 0 zurⁿckgeben wenn die Variable
  52674.       nicht gesetzt ist, aber sie k÷nnte ebenfalls 0 zurⁿckgeben, wenn
  52675.       eine Variable als leeres Array initialisiert wurde. Verwenden Sie
  52676.       <A
  52677. HREF="#function.isset"
  52678. ><B
  52679. CLASS="function"
  52680. >isset()</B
  52681. ></A
  52682. > um zu testen, ob eine Variable gesetzt
  52683.       ist.
  52684.      </P
  52685. ></TD
  52686. ></TR
  52687. ></TABLE
  52688. ></DIV
  52689. ><P
  52690. >      In der Sektion <A
  52691. HREF="#language.types.array"
  52692. >Arrays</A
  52693. >
  52694.      finden Sie eine detaillierte ErklΣrung, wie Arrays in PHP
  52695.      implementiert sind und wie sie benutzt werden.
  52696.     </P
  52697. ><P
  52698. >      <TABLE
  52699. WIDTH="100%"
  52700. BORDER="0"
  52701. CELLPADDING="0"
  52702. CELLSPACING="0"
  52703. CLASS="EXAMPLE"
  52704. ><TR
  52705. ><TD
  52706. ><DIV
  52707. CLASS="example"
  52708. ><A
  52709. NAME="AEN9359"
  52710. ></A
  52711. ><P
  52712. ><B
  52713. >Beispiel 1. <B
  52714. CLASS="function"
  52715. >count()</B
  52716. ></B
  52717. ></P
  52718. ><TABLE
  52719. BORDER="0"
  52720. BGCOLOR="#E0E0E0"
  52721. CELLPADDING="5"
  52722. ><TR
  52723. ><TD
  52724. ><PRE
  52725. CLASS="php"
  52726. ><?php
  52727. $a[0] = 1;
  52728. $a[1] = 3;
  52729. $a[2] = 5;
  52730. $result = count ($a);
  52731. //$result == 3
  52732.  
  52733. $b[0] = 7;
  52734. $b[5] = 9;
  52735. $b[10] = 11;
  52736. $result = count ($b);
  52737. // $result == 3;
  52738. ?></PRE
  52739. ></TD
  52740. ></TR
  52741. ></TABLE
  52742. ></DIV
  52743. ></TD
  52744. ></TR
  52745. ></TABLE
  52746. >
  52747.     </P
  52748. ><DIV
  52749. CLASS="note"
  52750. ><BLOCKQUOTE
  52751. CLASS="note"
  52752. ><P
  52753. ><B
  52754. >Anmerkung: </B
  52755. >
  52756.      Die Funktion <A
  52757. HREF="#function.sizeof"
  52758. ><B
  52759. CLASS="function"
  52760. >sizeof()</B
  52761. ></A
  52762. > ist ein
  52763.      <A
  52764. HREF="#aliases"
  52765. >Alias</A
  52766. > fⁿr <B
  52767. CLASS="function"
  52768. >count()</B
  52769. >.
  52770.      </P
  52771. ></BLOCKQUOTE
  52772. ></DIV
  52773. ><P
  52774. >      Siehe auch <A
  52775. HREF="#function.is-array"
  52776. ><B
  52777. CLASS="function"
  52778. >is_array()</B
  52779. ></A
  52780. >,
  52781.      <A
  52782. HREF="#function.isset"
  52783. ><B
  52784. CLASS="function"
  52785. >isset()</B
  52786. ></A
  52787. > und
  52788.      <A
  52789. HREF="#function.strlen"
  52790. ><B
  52791. CLASS="function"
  52792. >strlen()</B
  52793. ></A
  52794. >.
  52795.     </P
  52796. ></DIV
  52797. ><H1
  52798. ><A
  52799. NAME="function.current"
  52800. ></A
  52801. >current</H1
  52802. ><DIV
  52803. CLASS="refnamediv"
  52804. ><A
  52805. NAME="AEN9373"
  52806. ></A
  52807. ><P
  52808. >    (PHP 3, PHP 4 , PHP 5)</P
  52809. >current -- Liefert das aktuelle Element eines Arrays</DIV
  52810. ><DIV
  52811. CLASS="refsect1"
  52812. ><A
  52813. NAME="AEN9376"
  52814. ></A
  52815. ><H2
  52816. >Beschreibung</H2
  52817. >mixed <B
  52818. CLASS="methodname"
  52819. >current</B
  52820. > ( array array)<BR
  52821. ></BR
  52822. ><P
  52823. >      Jedes Array hat einen internen Zeiger auf sein "aktuelles"
  52824.      Element, welcher auf das erste in das Array eingefⁿgte Element
  52825.      initialisiert wird.
  52826.     </P
  52827. ><P
  52828. >      Die Funktion <B
  52829. CLASS="function"
  52830. >current()</B
  52831. > liefert das Array
  52832.      Element, auf das gerade vom internen Zeiger gezeigt wird. Sie
  52833.      bewegt den Zeiger in keinster Weise. Zeigt der interne Zeiger
  52834.      hinter das Ende der Elementenliste, gibt
  52835.      <B
  52836. CLASS="function"
  52837. >current()</B
  52838. > <TT
  52839. CLASS="constant"
  52840. ><B
  52841. >FALSE</B
  52842. ></TT
  52843. > zurⁿck.
  52844.      <DIV
  52845. CLASS="warning"
  52846. ><P
  52847. ></P
  52848. ><TABLE
  52849. CLASS="warning"
  52850. BORDER="1"
  52851. WIDTH="100%"
  52852. ><TR
  52853. ><TD
  52854. ALIGN="CENTER"
  52855. ><B
  52856. >Warnung</B
  52857. ></TD
  52858. ></TR
  52859. ><TR
  52860. ><TD
  52861. ALIGN="LEFT"
  52862. ><P
  52863. >        EnthΣlt das Array leere Elemente (0 oder "", den leeren
  52864.        String), gibt diese Funktion auch fⁿr diese Elemente <TT
  52865. CLASS="constant"
  52866. ><B
  52867. >FALSE</B
  52868. ></TT
  52869. >
  52870.        zurⁿck. Das macht es unm÷glich, unter Verwendung von
  52871.        <B
  52872. CLASS="function"
  52873. >current()</B
  52874. > herauszufinden, ob das wirklich am
  52875.        Ende der Liste sind. Um ein Array, das leere Elemente enthalten
  52876.        k÷nnte richtig durchzugehen, verwenden Sie die Funktion
  52877.        <A
  52878. HREF="#function.each"
  52879. ><B
  52880. CLASS="function"
  52881. >each()</B
  52882. ></A
  52883. >.
  52884.       </P
  52885. ></TD
  52886. ></TR
  52887. ></TABLE
  52888. ></DIV
  52889. >
  52890.     </P
  52891. ><P
  52892. >      Siehe auch <A
  52893. HREF="#function.end"
  52894. ><B
  52895. CLASS="function"
  52896. >end()</B
  52897. ></A
  52898. >, <A
  52899. HREF="#function.key"
  52900. ><B
  52901. CLASS="function"
  52902. >key()</B
  52903. ></A
  52904. >,
  52905.      <A
  52906. HREF="#function.next"
  52907. ><B
  52908. CLASS="function"
  52909. >next()</B
  52910. ></A
  52911. >, <A
  52912. HREF="#function.prev"
  52913. ><B
  52914. CLASS="function"
  52915. >prev()</B
  52916. ></A
  52917. > und
  52918.      <A
  52919. HREF="#function.reset"
  52920. ><B
  52921. CLASS="function"
  52922. >reset()</B
  52923. ></A
  52924. >.
  52925.     </P
  52926. ></DIV
  52927. ><H1
  52928. ><A
  52929. NAME="function.each"
  52930. ></A
  52931. >each</H1
  52932. ><DIV
  52933. CLASS="refnamediv"
  52934. ><A
  52935. NAME="AEN9401"
  52936. ></A
  52937. ><P
  52938. >    (PHP 3, PHP 4 , PHP 5)</P
  52939. >each -- 
  52940.      Liefert das aktuelle Paar (Schlⁿssel und Wert) eines Arrays und
  52941.      rⁿckt den Array Cursor vor.
  52942.     </DIV
  52943. ><DIV
  52944. CLASS="refsect1"
  52945. ><A
  52946. NAME="AEN9404"
  52947. ></A
  52948. ><H2
  52949. >Beschreibung</H2
  52950. >array <B
  52951. CLASS="methodname"
  52952. >each</B
  52953. > ( array array)<BR
  52954. ></BR
  52955. ><P
  52956. >      Liefert das aktuelle Schlⁿssel- Wertepaar des Arrays
  52957.      <VAR
  52958. CLASS="parameter"
  52959. >array</VAR
  52960. >, und erh÷ht den Array Cursor. Dieses
  52961.      Paar wird als Array mit 4 Elementen zurⁿckgegeben, und zwar mit
  52962.      den Schlⁿsseln <SPAN
  52963. CLASS="emphasis"
  52964. ><I
  52965. CLASS="emphasis"
  52966. >0</I
  52967. ></SPAN
  52968. >, <SPAN
  52969. CLASS="emphasis"
  52970. ><I
  52971. CLASS="emphasis"
  52972. >1</I
  52973. ></SPAN
  52974. >,
  52975.      <SPAN
  52976. CLASS="emphasis"
  52977. ><I
  52978. CLASS="emphasis"
  52979. >key</I
  52980. ></SPAN
  52981. >, und <SPAN
  52982. CLASS="emphasis"
  52983. ><I
  52984. CLASS="emphasis"
  52985. >value</I
  52986. ></SPAN
  52987. >. Die
  52988.      Elemente <SPAN
  52989. CLASS="emphasis"
  52990. ><I
  52991. CLASS="emphasis"
  52992. >0</I
  52993. ></SPAN
  52994. > und <SPAN
  52995. CLASS="emphasis"
  52996. ><I
  52997. CLASS="emphasis"
  52998. >key</I
  52999. ></SPAN
  53000. >
  53001.      enthalten den Namen des Schlⁿssels, <SPAN
  53002. CLASS="emphasis"
  53003. ><I
  53004. CLASS="emphasis"
  53005. >1</I
  53006. ></SPAN
  53007. > und
  53008.      <SPAN
  53009. CLASS="emphasis"
  53010. ><I
  53011. CLASS="emphasis"
  53012. >value</I
  53013. ></SPAN
  53014. > den Wert.
  53015.     </P
  53016. ><P
  53017. >      Zeigt der interne Zeiger hinter das Ende der Array-Inhalte, gibt
  53018.      <B
  53019. CLASS="function"
  53020. >each()</B
  53021. > <TT
  53022. CLASS="constant"
  53023. ><B
  53024. >FALSE</B
  53025. ></TT
  53026. > zurⁿck.
  53027.     </P
  53028. ><P
  53029. >      <TABLE
  53030. WIDTH="100%"
  53031. BORDER="0"
  53032. CELLPADDING="0"
  53033. CELLSPACING="0"
  53034. CLASS="EXAMPLE"
  53035. ><TR
  53036. ><TD
  53037. ><DIV
  53038. CLASS="example"
  53039. ><A
  53040. NAME="AEN9426"
  53041. ></A
  53042. ><P
  53043. ><B
  53044. >Beispiel 1. <B
  53045. CLASS="function"
  53046. >each()</B
  53047. > Beispiele</B
  53048. ></P
  53049. ><TABLE
  53050. BORDER="0"
  53051. BGCOLOR="#E0E0E0"
  53052. CELLPADDING="5"
  53053. ><TR
  53054. ><TD
  53055. ><PRE
  53056. CLASS="php"
  53057. ><?php
  53058. $foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
  53059. $bar = each ($foo);
  53060. print_r($bar);
  53061. ?></PRE
  53062. ></TD
  53063. ></TR
  53064. ></TABLE
  53065. ><P
  53066. >        <VAR
  53067. CLASS="varname"
  53068. >$bar</VAR
  53069. > enthΣlt nun die folgenden Schlⁿssel/Wert
  53070.        Paare:
  53071.       </P
  53072. ><TABLE
  53073. BORDER="0"
  53074. BGCOLOR="#E0E0E0"
  53075. CELLPADDING="5"
  53076. ><TR
  53077. ><TD
  53078. ><PRE
  53079. CLASS="screen"
  53080. >Array
  53081. (
  53082.     [1] => bob
  53083.     [value] => bob
  53084.     [0] => 0
  53085.     [key] => 0
  53086. )</PRE
  53087. ></TD
  53088. ></TR
  53089. ></TABLE
  53090. ></DIV
  53091. ></TD
  53092. ></TR
  53093. ></TABLE
  53094. >
  53095.     </P
  53096. ><P
  53097. >      <DIV
  53098. CLASS="informalexample"
  53099. ><P
  53100. ></P
  53101. ><A
  53102. NAME="AEN9434"
  53103. ></A
  53104. ><TABLE
  53105. BORDER="0"
  53106. BGCOLOR="#E0E0E0"
  53107. CELLPADDING="5"
  53108. ><TR
  53109. ><TD
  53110. ><PRE
  53111. CLASS="php"
  53112. ><?php
  53113. $foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
  53114. $bar = each ($foo);
  53115. print_r($bar);
  53116. ?></PRE
  53117. ></TD
  53118. ></TR
  53119. ></TABLE
  53120. ><P
  53121. >        <VAR
  53122. CLASS="varname"
  53123. >$bar</VAR
  53124. > enthΣlt nun die folgenden Schlⁿssel/Wert
  53125.        Paare:
  53126.       </P
  53127. ><TABLE
  53128. BORDER="0"
  53129. BGCOLOR="#E0E0E0"
  53130. CELLPADDING="5"
  53131. ><TR
  53132. ><TD
  53133. ><PRE
  53134. CLASS="screen"
  53135. >Array
  53136. (
  53137.     [1] => Bob
  53138.     [value] => Bob
  53139.     [0] => Robert
  53140.     [key] => Robert
  53141. )</PRE
  53142. ></TD
  53143. ></TR
  53144. ></TABLE
  53145. ><P
  53146. ></P
  53147. ></DIV
  53148. >
  53149.     </P
  53150. ><P
  53151. >      <B
  53152. CLASS="function"
  53153. >each()</B
  53154. > wird typischerweise in Verbindung mit
  53155.      <A
  53156. HREF="#function.list"
  53157. ><B
  53158. CLASS="function"
  53159. >list()</B
  53160. ></A
  53161. > verwendet, um ein Array durchzugehen:
  53162.      <TABLE
  53163. WIDTH="100%"
  53164. BORDER="0"
  53165. CELLPADDING="0"
  53166. CELLSPACING="0"
  53167. CLASS="EXAMPLE"
  53168. ><TR
  53169. ><TD
  53170. ><DIV
  53171. CLASS="example"
  53172. ><A
  53173. NAME="AEN9442"
  53174. ></A
  53175. ><P
  53176. ><B
  53177. >Beispiel 2. Durchgehen eines Arrays mit <B
  53178. CLASS="function"
  53179. >each()</B
  53180. ></B
  53181. ></P
  53182. ><TABLE
  53183. BORDER="0"
  53184. BGCOLOR="#E0E0E0"
  53185. CELLPADDING="5"
  53186. ><TR
  53187. ><TD
  53188. ><PRE
  53189. CLASS="php"
  53190. ><?php
  53191. $fruit = array('a' => 'Apfel', 'b' => 'Banane', 'c' => 'Preiselbeere');
  53192.  
  53193. reset ($fruit);
  53194. while (list ($key, $val) = each ($fruit)) {
  53195.     echo "$key => $val\n";
  53196. }
  53197.  
  53198. /* Ausgabe:
  53199.  
  53200. a => Apfel
  53201. b => Banane
  53202. c => Preiselbeere
  53203.  
  53204. */
  53205. ?></PRE
  53206. ></TD
  53207. ></TR
  53208. ></TABLE
  53209. ></DIV
  53210. ></TD
  53211. ></TR
  53212. ></TABLE
  53213. >
  53214.     </P
  53215. ><P
  53216. >      Nachdem <B
  53217. CLASS="function"
  53218. >each()</B
  53219. > ausgefⁿhrt wurde, bleibt der
  53220.      Array Cursor beim nΣchsten Element des Arrays, oder wenn am Ende
  53221.      des Arrays angelangt, nach dem letzten Element. Sie mⁿssen
  53222.      <A
  53223. HREF="#function.reset"
  53224. ><B
  53225. CLASS="function"
  53226. >reset()</B
  53227. ></A
  53228. > verwenden, wenn Sie das Array erneut
  53229.      mittels each durchgehen wollen.
  53230.     </P
  53231. ><DIV
  53232. CLASS="caution"
  53233. ><P
  53234. ></P
  53235. ><TABLE
  53236. CLASS="caution"
  53237. BORDER="1"
  53238. WIDTH="100%"
  53239. ><TR
  53240. ><TD
  53241. ALIGN="CENTER"
  53242. ><B
  53243. >Achtung</B
  53244. ></TD
  53245. ></TR
  53246. ><TR
  53247. ><TD
  53248. ALIGN="LEFT"
  53249. ><P
  53250. >       Da die Zuweisung eines Arrays zu einer anderen Variable den originalen
  53251.       Arrayzeiger zurⁿcksetzt, wⁿrde unser obiges Beispiel in eine Endlosschleife
  53252.       geraten, hΣtten wir <VAR
  53253. CLASS="varname"
  53254. >$fruit</VAR
  53255. > innerhalb der Schleife
  53256.       einer anderen Variable zugeordnet.
  53257.      </P
  53258. ></TD
  53259. ></TR
  53260. ></TABLE
  53261. ></DIV
  53262. ><P
  53263. >      Siehe auch <A
  53264. HREF="#function.key"
  53265. ><B
  53266. CLASS="function"
  53267. >key()</B
  53268. ></A
  53269. >, <A
  53270. HREF="#function.list"
  53271. ><B
  53272. CLASS="function"
  53273. >list()</B
  53274. ></A
  53275. >,
  53276.      <A
  53277. HREF="#function.current"
  53278. ><B
  53279. CLASS="function"
  53280. >current()</B
  53281. ></A
  53282. >, <A
  53283. HREF="#function.reset"
  53284. ><B
  53285. CLASS="function"
  53286. >reset()</B
  53287. ></A
  53288. >,
  53289.      <A
  53290. HREF="#function.next"
  53291. ><B
  53292. CLASS="function"
  53293. >next()</B
  53294. ></A
  53295. >, <A
  53296. HREF="#function.prev"
  53297. ><B
  53298. CLASS="function"
  53299. >prev()</B
  53300. ></A
  53301. > und
  53302.      <A
  53303. HREF="#control-structures.foreach"
  53304. >foreach</A
  53305. >.
  53306.     </P
  53307. ></DIV
  53308. ><H1
  53309. ><A
  53310. NAME="function.end"
  53311. ></A
  53312. >end</H1
  53313. ><DIV
  53314. CLASS="refnamediv"
  53315. ><A
  53316. NAME="AEN9461"
  53317. ></A
  53318. ><P
  53319. >    (PHP 3, PHP 4 , PHP 5)</P
  53320. >end -- 
  53321.      Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
  53322.     </DIV
  53323. ><DIV
  53324. CLASS="refsect1"
  53325. ><A
  53326. NAME="AEN9464"
  53327. ></A
  53328. ><H2
  53329. >Beschreibung</H2
  53330. >mixed <B
  53331. CLASS="methodname"
  53332. >end</B
  53333. > ( array array)<BR
  53334. ></BR
  53335. ><P
  53336. >      <B
  53337. CLASS="function"
  53338. >end()</B
  53339. > rⁿckt den internen Zeiger von
  53340.      <VAR
  53341. CLASS="parameter"
  53342. >array</VAR
  53343. > bis zum letzten Element vor, und gibt
  53344.      dieses Element zurⁿck.
  53345.     </P
  53346. ><P
  53347. >      <TABLE
  53348. WIDTH="100%"
  53349. BORDER="0"
  53350. CELLPADDING="0"
  53351. CELLSPACING="0"
  53352. CLASS="EXAMPLE"
  53353. ><TR
  53354. ><TD
  53355. ><DIV
  53356. CLASS="example"
  53357. ><A
  53358. NAME="AEN9476"
  53359. ></A
  53360. ><P
  53361. ><B
  53362. >Beispiel 1. Ein einfaches <B
  53363. CLASS="function"
  53364. >end()</B
  53365. > Beispiel</B
  53366. ></P
  53367. ><TABLE
  53368. BORDER="0"
  53369. BGCOLOR="#E0E0E0"
  53370. CELLPADDING="5"
  53371. ><TR
  53372. ><TD
  53373. ><PRE
  53374. CLASS="php"
  53375. ><?php
  53376.  
  53377.   $fruits = array('apple','banana','cranberry');
  53378.     
  53379.   print end($fruits); // cranberry
  53380.       
  53381. ?></PRE
  53382. ></TD
  53383. ></TR
  53384. ></TABLE
  53385. ></DIV
  53386. ></TD
  53387. ></TR
  53388. ></TABLE
  53389. >
  53390.     </P
  53391. ><P
  53392. >      Siehe auch <A
  53393. HREF="#function.current"
  53394. ><B
  53395. CLASS="function"
  53396. >current()</B
  53397. ></A
  53398. >,
  53399.      <A
  53400. HREF="#function.each"
  53401. ><B
  53402. CLASS="function"
  53403. >each()</B
  53404. ></A
  53405. >,
  53406.      <A
  53407. HREF="#function.next"
  53408. ><B
  53409. CLASS="function"
  53410. >next()</B
  53411. ></A
  53412. > und <A
  53413. HREF="#function.reset"
  53414. ><B
  53415. CLASS="function"
  53416. >reset()</B
  53417. ></A
  53418. >.
  53419.     </P
  53420. ></DIV
  53421. ><H1
  53422. ><A
  53423. NAME="function.extract"
  53424. ></A
  53425. >extract</H1
  53426. ><DIV
  53427. CLASS="refnamediv"
  53428. ><A
  53429. NAME="AEN9486"
  53430. ></A
  53431. ><P
  53432. >    (PHP 3>= 3.0.7, PHP 4 , PHP 5)</P
  53433. >extract -- 
  53434.      Importiert Variablen eines Arrays in die aktuelle Symboltabelle 
  53435.     </DIV
  53436. ><DIV
  53437. CLASS="refsect1"
  53438. ><A
  53439. NAME="AEN9489"
  53440. ></A
  53441. ><H2
  53442. >Beschreibung</H2
  53443. >int <B
  53444. CLASS="methodname"
  53445. >extract</B
  53446. > ( array var_array [, int extract_type [, string prefix]])<BR
  53447. ></BR
  53448. ><P
  53449. >      Diese Funktion wird verwendet, um Variablen eines Arrays in die
  53450.      aktuelle Symboltabelle zu importieren. Es behandelt die Schlⁿssel
  53451.      des assoziativen Arrays <VAR
  53452. CLASS="parameter"
  53453. >var_array</VAR
  53454. > als
  53455.      Variablennamen, und die Werte als Variablenwerte. Fⁿr jedes Paar
  53456.      Schlⁿssel/Wert wird - abhΣngig von den Parametern
  53457.      <VAR
  53458. CLASS="parameter"
  53459. >extract_type</VAR
  53460. > und
  53461.      <VAR
  53462. CLASS="parameter"
  53463. >prefix</VAR
  53464. > - eine Variable in der aktuellen
  53465.      Symboltabelle eingetragen.
  53466.     </P
  53467. ><DIV
  53468. CLASS="note"
  53469. ><BLOCKQUOTE
  53470. CLASS="note"
  53471. ><P
  53472. ><B
  53473. >Anmerkung: </B
  53474. >
  53475.       Seit Version 4.0.5 gibt diese Funktion die Anzahl der
  53476.       extrahierten Variablen zurⁿck.
  53477.      </P
  53478. ></BLOCKQUOTE
  53479. ></DIV
  53480. ><DIV
  53481. CLASS="note"
  53482. ><BLOCKQUOTE
  53483. CLASS="note"
  53484. ><P
  53485. ><B
  53486. >Anmerkung: </B
  53487. >
  53488.       <TT
  53489. CLASS="constant"
  53490. ><B
  53491. >EXTR_IF_EXISTS</B
  53492. ></TT
  53493. > und <TT
  53494. CLASS="constant"
  53495. ><B
  53496. >EXTR_PREFIX_IF_EXISTS</B
  53497. ></TT
  53498. >
  53499.       wurden in Version 4.2.0. eingefⁿhrt.
  53500.      </P
  53501. ></BLOCKQUOTE
  53502. ></DIV
  53503. ><DIV
  53504. CLASS="note"
  53505. ><BLOCKQUOTE
  53506. CLASS="note"
  53507. ><P
  53508. ><B
  53509. >Anmerkung: </B
  53510. >
  53511.       <TT
  53512. CLASS="constant"
  53513. ><B
  53514. >EXTR_REFS</B
  53515. ></TT
  53516. > wurde in Version 4.3.0 eingefⁿhrt.
  53517.      </P
  53518. ></BLOCKQUOTE
  53519. ></DIV
  53520. ><P
  53521. >      <B
  53522. CLASS="function"
  53523. >extract()</B
  53524. > prⁿft jeden Schlⁿssel, ob dieser
  53525.      einen gⁿltigen Variablennamen ergibt, und auch auf eventuelle
  53526.      Kollisionen mit existierenden Variablen in der Symboltabelle. Die
  53527.      Art, wie ungⁿltige/numerische Schlⁿssel und Kollisionen behandelt
  53528.      werden, wird mit <VAR
  53529. CLASS="parameter"
  53530. >extract_type</VAR
  53531. >
  53532.      spezifiziert. Es kann einen der folgenden Werte annehmen:
  53533.      <P
  53534. ></P
  53535. ><DIV
  53536. CLASS="variablelist"
  53537. ><DL
  53538. ><DT
  53539. ><TT
  53540. CLASS="constant"
  53541. ><B
  53542. >EXTR_OVERWRITE</B
  53543. ></TT
  53544. ></DT
  53545. ><DD
  53546. ><P
  53547. >          Im Falle einer Kollision wird die existierende Variable
  53548.          ⁿberschrieben.
  53549.         </P
  53550. ></DD
  53551. ><DT
  53552. ><TT
  53553. CLASS="constant"
  53554. ><B
  53555. >EXTR_SKIP</B
  53556. ></TT
  53557. ></DT
  53558. ><DD
  53559. ><P
  53560. >          Im Falle einer Kollision wird die existierende Variable
  53561.          nicht ⁿberschrieben.
  53562.         </P
  53563. ></DD
  53564. ><DT
  53565. ><TT
  53566. CLASS="constant"
  53567. ><B
  53568. >EXTR_PREFIX_SAME</B
  53569. ></TT
  53570. ></DT
  53571. ><DD
  53572. ><P
  53573. >Im Falle einer Kollision wird dem Variablennamen
  53574.         <VAR
  53575. CLASS="parameter"
  53576. >prefix</VAR
  53577. > vorangestellt.
  53578.         </P
  53579. ></DD
  53580. ><DT
  53581. ><TT
  53582. CLASS="constant"
  53583. ><B
  53584. >EXTR_PREFIX_ALL</B
  53585. ></TT
  53586. ></DT
  53587. ><DD
  53588. ><P
  53589. >          Allen Variablennamen wird <VAR
  53590. CLASS="parameter"
  53591. >prefix</VAR
  53592. >
  53593.          vorangestellt. Seit PHP 4.0.5 gilt dies auch fⁿr numerische
  53594.          Variablen.
  53595.         </P
  53596. ></DD
  53597. ><DT
  53598. ><TT
  53599. CLASS="constant"
  53600. ><B
  53601. >EXTR_PREFIX_INVALID</B
  53602. ></TT
  53603. ></DT
  53604. ><DD
  53605. ><P
  53606. >          Nur ungⁿltigen/numerischen Variablennamen wird
  53607.          <VAR
  53608. CLASS="parameter"
  53609. >prefix</VAR
  53610. > vorangestellt. Dieser Flag
  53611.          wurde mit PHP 4.0.5 eingefⁿhrt.
  53612.         </P
  53613. ></DD
  53614. ><DT
  53615. ><TT
  53616. CLASS="constant"
  53617. ><B
  53618. >EXTR_IF_EXISTS</B
  53619. ></TT
  53620. ></DT
  53621. ><DD
  53622. ><P
  53623. >          ▄berschreibt die Variable nur, wenn sie bereits in der aktuellen
  53624.          Symboltabelle existiert, sonst geschieht nichts. Dies ist dann
  53625.          hilfreich, wenn Sie eine Liste mit gⁿltigen Variablen definieren,
  53626.          und dann z.B. nur jene Variablen extrahieren, welche Sie aus
  53627.          $_REQUEST definiert haben. Dieser Flag wurde in PHP 4.2.0
  53628.          eingefⁿhrt.
  53629.         </P
  53630. ></DD
  53631. ><DT
  53632. ><TT
  53633. CLASS="constant"
  53634. ><B
  53635. >EXTR_PREFIX_IF_EXISTS</B
  53636. ></TT
  53637. ></DT
  53638. ><DD
  53639. ><P
  53640. >          Erstellt nur Variablennamen mit PrΣfix, wenn die Version ohne
  53641.          PrΣfix der selben Variable in der aktuellen Symboltabelle
  53642.          existiert. Dieser Flag wurde in PHP 4.2.0 eingefⁿhrt.
  53643.         </P
  53644. ></DD
  53645. ><DT
  53646. ><TT
  53647. CLASS="constant"
  53648. ><B
  53649. >EXTR_REFS</B
  53650. ></TT
  53651. ></DT
  53652. ><DD
  53653. ><P
  53654. >          Extrahiert Variablen als Referenzen. Das hei▀t, dass die Werte der
  53655.          importierten Variablen noch immer auf die Werte des Parameters
  53656.          <VAR
  53657. CLASS="parameter"
  53658. >var_array</VAR
  53659. > referenzieren. Sie k÷nnen diesen
  53660.          Flag alleine oder auch in Kombination mit einem anderen Flag verwenden,
  53661.          indem Sie Oder-Verknⁿpfungen im <VAR
  53662. CLASS="parameter"
  53663. >extract_type</VAR
  53664. >
  53665.          erstellen. Dieser Flag wurde in PHP 4.3.0 eingefⁿhrt.
  53666.         </P
  53667. ></DD
  53668. ></DL
  53669. ></DIV
  53670. >
  53671.     </P
  53672. ><P
  53673. >      Ist <VAR
  53674. CLASS="parameter"
  53675. >extract_type</VAR
  53676. > nicht spezifiziert, so wird
  53677.      <TT
  53678. CLASS="constant"
  53679. ><B
  53680. >EXTR_OVERWRITE</B
  53681. ></TT
  53682. > angenommen.
  53683.     </P
  53684. ><P
  53685. >      Beachten Sie, dass <VAR
  53686. CLASS="parameter"
  53687. >prefix</VAR
  53688. > nur dann n÷tig ist,
  53689.      wenn <VAR
  53690. CLASS="parameter"
  53691. >extract_type</VAR
  53692. > <TT
  53693. CLASS="constant"
  53694. ><B
  53695. >EXTR_PREFIX_SAME</B
  53696. ></TT
  53697. >,
  53698.      <TT
  53699. CLASS="constant"
  53700. ><B
  53701. >EXTR_PREFIX_ALL</B
  53702. ></TT
  53703. >, <TT
  53704. CLASS="constant"
  53705. ><B
  53706. >EXTR_PREFIX_INVALID</B
  53707. ></TT
  53708. > 
  53709.      or <TT
  53710. CLASS="constant"
  53711. ><B
  53712. >EXTR_PREFIX_IF_EXISTS</B
  53713. ></TT
  53714. > ist. Ist das Resultat trotz
  53715.      PrΣfix kein gⁿltiger Variablenname, wird es nicht in die Symboltabelle
  53716.      importiert.
  53717.     </P
  53718. ><P
  53719. >      <B
  53720. CLASS="function"
  53721. >extract()</B
  53722. > gibt die Anzahl erfolgreich in die
  53723.      Symboltabelle importierter Variablen zurⁿck.
  53724.     </P
  53725. ><P
  53726. >      Eine m÷gliche Verwendung fⁿr <B
  53727. CLASS="function"
  53728. >extract()</B
  53729. > ist der Import
  53730.      der Variablen in einem von <A
  53731. HREF="#function.wddx-deserialize"
  53732. ><B
  53733. CLASS="function"
  53734. >wddx_deserialize()</B
  53735. ></A
  53736. > gelieferten
  53737.      assoziativen Array in die Symboltabelle.
  53738.     </P
  53739. ><P
  53740. >      <TABLE
  53741. WIDTH="100%"
  53742. BORDER="0"
  53743. CELLPADDING="0"
  53744. CELLSPACING="0"
  53745. CLASS="EXAMPLE"
  53746. ><TR
  53747. ><TD
  53748. ><DIV
  53749. CLASS="example"
  53750. ><A
  53751. NAME="AEN9581"
  53752. ></A
  53753. ><P
  53754. ><B
  53755. >Beispiel 1. <B
  53756. CLASS="function"
  53757. >extract()</B
  53758. ></B
  53759. ></P
  53760. ><TABLE
  53761. BORDER="0"
  53762. BGCOLOR="#E0E0E0"
  53763. CELLPADDING="5"
  53764. ><TR
  53765. ><TD
  53766. ><PRE
  53767. CLASS="php"
  53768. ><?php
  53769.  
  53770. /* Annahme: $var_array ist ein von wddx_deserialize
  53771.    zurⁿckgegebenes Array */
  53772.  
  53773. $groesse = "gro▀";
  53774. $var_array = array ("farbe"   => "blau",
  53775.                     "groesse" => "mittel",
  53776.                     "form"    => "Kugel");
  53777. extract ($var_array, EXTR_PREFIX_SAME, "wddx");
  53778.  
  53779. print "$farbe, $groesse, $form, $wddx_groesse\n";
  53780.  
  53781. ?></PRE
  53782. ></TD
  53783. ></TR
  53784. ></TABLE
  53785. ><P
  53786. >        Das obige Beispiel wird folgendes ausgeben:
  53787.       </P
  53788. ><TABLE
  53789. BORDER="0"
  53790. BGCOLOR="#E0E0E0"
  53791. CELLPADDING="5"
  53792. ><TR
  53793. ><TD
  53794. ><PRE
  53795. CLASS="programlisting"
  53796. >blau, gro▀, Kugel, mittel</PRE
  53797. ></TD
  53798. ></TR
  53799. ></TABLE
  53800. ></DIV
  53801. ></TD
  53802. ></TR
  53803. ></TABLE
  53804. >
  53805.     </P
  53806. ><P
  53807. >      <VAR
  53808. CLASS="varname"
  53809. >$size</VAR
  53810. > wurde nicht ⁿberschrieben, da wir
  53811.      <TT
  53812. CLASS="constant"
  53813. ><B
  53814. >EXTR_PREFIX_SAME</B
  53815. ></TT
  53816. > spezifiziert haben, was im Anlegen
  53817.      von <VAR
  53818. CLASS="varname"
  53819. >$wddx_size</VAR
  53820. > endete. WΣre <TT
  53821. CLASS="constant"
  53822. ><B
  53823. >EXTR_SKIP</B
  53824. ></TT
  53825. >
  53826.      spezifiziert worden, dann wΣre $wddx_size nicht angelegt worden.
  53827.      <TT
  53828. CLASS="constant"
  53829. ><B
  53830. >EXTR_OVERWRITE</B
  53831. ></TT
  53832. > hΣtte <VAR
  53833. CLASS="varname"
  53834. >$size</VAR
  53835. > mit dem
  53836.      Wert "medium" ⁿberschrieben, und <TT
  53837. CLASS="constant"
  53838. ><B
  53839. >EXTR_PREFIX_ALL</B
  53840. ></TT
  53841. > hΣtte
  53842.      die neuen Variablen <VAR
  53843. CLASS="varname"
  53844. >$wddx_color</VAR
  53845. >,
  53846.      <VAR
  53847. CLASS="varname"
  53848. >$wddx_size</VAR
  53849. >, und <VAR
  53850. CLASS="varname"
  53851. >$wddx_shape</VAR
  53852. > angelegt.
  53853.     </P
  53854. ><P
  53855. >      Sie mⁿssen assoziative Arrays benutzen, numerisch indizierte
  53856.      Arrays liefern keine Resultate, au▀er Sie verwenden
  53857.      <TT
  53858. CLASS="constant"
  53859. ><B
  53860. >EXTR_PREFIX_ALL</B
  53861. ></TT
  53862. > oder
  53863.      <TT
  53864. CLASS="constant"
  53865. ><B
  53866. >EXTR_PREFIX_INVALID</B
  53867. ></TT
  53868. >.
  53869.     </P
  53870. ><P
  53871. >      Siehe auch <A
  53872. HREF="#function.compact"
  53873. ><B
  53874. CLASS="function"
  53875. >compact()</B
  53876. ></A
  53877. >.
  53878.     </P
  53879. ></DIV
  53880. ><H1
  53881. ><A
  53882. NAME="function.in-array"
  53883. ></A
  53884. >in_array</H1
  53885. ><DIV
  53886. CLASS="refnamediv"
  53887. ><A
  53888. NAME="AEN9604"
  53889. ></A
  53890. ><P
  53891. >    (PHP 4 , PHP 5)</P
  53892. >in_array -- Prⁿft, ob ein Wert in einem Array existiert</DIV
  53893. ><DIV
  53894. CLASS="refsect1"
  53895. ><A
  53896. NAME="AEN9607"
  53897. ></A
  53898. ><H2
  53899. >Beschreibung</H2
  53900. >bool <B
  53901. CLASS="methodname"
  53902. >in_array</B
  53903. > ( mixed needle, array haystack [, bool strict])<BR
  53904. ></BR
  53905. ><P
  53906. >      Diese Funktion sucht in <VAR
  53907. CLASS="parameter"
  53908. >haystack</VAR
  53909. > nach
  53910.      <VAR
  53911. CLASS="parameter"
  53912. >needle</VAR
  53913. > und gibt bei Erfolg <TT
  53914. CLASS="constant"
  53915. ><B
  53916. >TRUE</B
  53917. ></TT
  53918. > zurⁿck,
  53919.      andernfalls <TT
  53920. CLASS="constant"
  53921. ><B
  53922. >FALSE</B
  53923. ></TT
  53924. >.
  53925.     </P
  53926. ><P
  53927. >      Ist der dritte Parameter <VAR
  53928. CLASS="parameter"
  53929. >strict</VAR
  53930. > auf <TT
  53931. CLASS="constant"
  53932. ><B
  53933. >TRUE</B
  53934. ></TT
  53935. >
  53936.      gesetzt, prⁿft <B
  53937. CLASS="function"
  53938. >in_array()</B
  53939. > auch die
  53940.      <A
  53941. HREF="#language.types"
  53942. >Typen</A
  53943. > von
  53944.      <VAR
  53945. CLASS="parameter"
  53946. >needle</VAR
  53947. > in <VAR
  53948. CLASS="parameter"
  53949. >haystack</VAR
  53950. >.
  53951.     </P
  53952. ><DIV
  53953. CLASS="note"
  53954. ><BLOCKQUOTE
  53955. CLASS="note"
  53956. ><P
  53957. ><B
  53958. >Anmerkung: </B
  53959. >
  53960.       Ist <VAR
  53961. CLASS="parameter"
  53962. >needle</VAR
  53963. > ein String, erfolgt der Vergleich
  53964.       unter Berⁿcksichtigung der Gro▀- und Kleinschreibung.
  53965.      </P
  53966. ></BLOCKQUOTE
  53967. ></DIV
  53968. ><DIV
  53969. CLASS="note"
  53970. ><BLOCKQUOTE
  53971. CLASS="note"
  53972. ><P
  53973. ><B
  53974. >Anmerkung: </B
  53975. >
  53976.       In den PHP Versionen vor 4.2.0 durfte <VAR
  53977. CLASS="parameter"
  53978. >needle</VAR
  53979. >
  53980.       kein Array sein
  53981.      </P
  53982. ></BLOCKQUOTE
  53983. ></DIV
  53984. ><P
  53985. >      <TABLE
  53986. WIDTH="100%"
  53987. BORDER="0"
  53988. CELLPADDING="0"
  53989. CELLSPACING="0"
  53990. CLASS="EXAMPLE"
  53991. ><TR
  53992. ><TD
  53993. ><DIV
  53994. CLASS="example"
  53995. ><A
  53996. NAME="AEN9640"
  53997. ></A
  53998. ><P
  53999. ><B
  54000. >Beispiel 1. <B
  54001. CLASS="function"
  54002. >in_array()</B
  54003. ></B
  54004. ></P
  54005. ><TABLE
  54006. BORDER="0"
  54007. BGCOLOR="#E0E0E0"
  54008. CELLPADDING="5"
  54009. ><TR
  54010. ><TD
  54011. ><PRE
  54012. CLASS="php"
  54013. ><?php
  54014. $os = array ("Mac", "NT", "Irix", "Linux");
  54015. if (in_array ("Irix", $os)) {
  54016.     print "Got Irix";
  54017. }
  54018. if (in_array ("mac", $os)) {
  54019.     print "Got mac";
  54020. }
  54021. ?></PRE
  54022. ></TD
  54023. ></TR
  54024. ></TABLE
  54025. ><P
  54026. >        Die zweite Bedingung schlΣgt fehl, da <B
  54027. CLASS="function"
  54028. >in_array()</B
  54029. >
  54030.        die Gro▀-/Kleinschreibung berⁿcksichtigt, daher wird das obige
  54031.        Programm folgendes ausgeben:
  54032.       </P
  54033. ><TABLE
  54034. BORDER="0"
  54035. BGCOLOR="#E0E0E0"
  54036. CELLPADDING="5"
  54037. ><TR
  54038. ><TD
  54039. ><PRE
  54040. CLASS="php"
  54041. >Got Irix</PRE
  54042. ></TD
  54043. ></TR
  54044. ></TABLE
  54045. ></DIV
  54046. ></TD
  54047. ></TR
  54048. ></TABLE
  54049. >
  54050.     </P
  54051. ><P
  54052. >      <TABLE
  54053. WIDTH="100%"
  54054. BORDER="0"
  54055. CELLPADDING="0"
  54056. CELLSPACING="0"
  54057. CLASS="EXAMPLE"
  54058. ><TR
  54059. ><TD
  54060. ><DIV
  54061. CLASS="example"
  54062. ><A
  54063. NAME="AEN9648"
  54064. ></A
  54065. ><P
  54066. ><B
  54067. >Beispiel 2. <B
  54068. CLASS="function"
  54069. >in_array()</B
  54070. > mit strict</B
  54071. ></P
  54072. ><TABLE
  54073. BORDER="0"
  54074. BGCOLOR="#E0E0E0"
  54075. CELLPADDING="5"
  54076. ><TR
  54077. ><TD
  54078. ><PRE
  54079. CLASS="php"
  54080. ><?php
  54081. $a = array('1.10', 12.4, 1.13);
  54082.  
  54083. if (in_array('12.4', $a, TRUE)) {
  54084.     echo "'12.4' gefunden mit strict check\n";
  54085. }
  54086. if (in_array(1.13, $a, TRUE)) {
  54087.     echo "1.13 gefunden mit strict check\n";
  54088. }
  54089. ?></PRE
  54090. ></TD
  54091. ></TR
  54092. ></TABLE
  54093. ><P
  54094. >        Dies wird folgendes anzeigen:
  54095.       </P
  54096. ><TABLE
  54097. BORDER="0"
  54098. BGCOLOR="#E0E0E0"
  54099. CELLPADDING="5"
  54100. ><TR
  54101. ><TD
  54102. ><PRE
  54103. CLASS="screen"
  54104. >1.13 gefunden mit strict check</PRE
  54105. ></TD
  54106. ></TR
  54107. ></TABLE
  54108. ></DIV
  54109. ></TD
  54110. ></TR
  54111. ></TABLE
  54112. >
  54113.     </P
  54114. ><P
  54115. >      <TABLE
  54116. WIDTH="100%"
  54117. BORDER="0"
  54118. CELLPADDING="0"
  54119. CELLSPACING="0"
  54120. CLASS="EXAMPLE"
  54121. ><TR
  54122. ><TD
  54123. ><DIV
  54124. CLASS="example"
  54125. ><A
  54126. NAME="AEN9655"
  54127. ></A
  54128. ><P
  54129. ><B
  54130. >Beispiel 3. <B
  54131. CLASS="function"
  54132. >in_array()</B
  54133. > mit einem Array als needle</B
  54134. ></P
  54135. ><TABLE
  54136. BORDER="0"
  54137. BGCOLOR="#E0E0E0"
  54138. CELLPADDING="5"
  54139. ><TR
  54140. ><TD
  54141. ><PRE
  54142. CLASS="php"
  54143. ><?php
  54144. $a = array(array('p', 'h'), array('p', 'r'), 'o');
  54145.  
  54146. if (in_array(array ('p', 'h'), $a)) {
  54147.     echo "'ph' wurde gefunden\n";
  54148. }
  54149. if (in_array(array ('f', 'i'), $a)) {
  54150.     echo "'fi' wurde nicht gefunden\n";
  54151. }
  54152. if (in_array('o', $a)) {
  54153.     echo "'o' wurde gefunden\n";
  54154. }
  54155. ?>
  54156.  
  54157. /* Ausgabe:
  54158.  
  54159.   'ph' wurde gefunden
  54160.   'o' wurde gefunden
  54161. */</PRE
  54162. ></TD
  54163. ></TR
  54164. ></TABLE
  54165. ></DIV
  54166. ></TD
  54167. ></TR
  54168. ></TABLE
  54169. >
  54170.     </P
  54171. ><P
  54172. >      Siehe auch <A
  54173. HREF="#function.array-search"
  54174. ><B
  54175. CLASS="function"
  54176. >array_search()</B
  54177. ></A
  54178. >.
  54179.     </P
  54180. ></DIV
  54181. ><H1
  54182. ><A
  54183. NAME="function.key"
  54184. ></A
  54185. >key</H1
  54186. ><DIV
  54187. CLASS="refnamediv"
  54188. ><A
  54189. NAME="AEN9662"
  54190. ></A
  54191. ><P
  54192. >    (PHP 3, PHP 4 , PHP 5)</P
  54193. >key -- 
  54194.      Liefert einen Schlⁿssel eines assoziativen Arrays
  54195.     </DIV
  54196. ><DIV
  54197. CLASS="refsect1"
  54198. ><A
  54199. NAME="AEN9665"
  54200. ></A
  54201. ><H2
  54202. >Beschreibung</H2
  54203. >mixed <B
  54204. CLASS="methodname"
  54205. >key</B
  54206. > ( array array)<BR
  54207. ></BR
  54208. ><P
  54209. >      <B
  54210. CLASS="function"
  54211. >key()</B
  54212. > liefert das Index Element der aktuellen
  54213.      Position im Array.
  54214.     </P
  54215. ><P
  54216. >      Siehe auch <A
  54217. HREF="#function.current"
  54218. ><B
  54219. CLASS="function"
  54220. >current()</B
  54221. ></A
  54222. > und <A
  54223. HREF="#function.next"
  54224. ><B
  54225. CLASS="function"
  54226. >next()</B
  54227. ></A
  54228. >.
  54229.     </P
  54230. ></DIV
  54231. ><H1
  54232. ><A
  54233. NAME="function.krsort"
  54234. ></A
  54235. >krsort</H1
  54236. ><DIV
  54237. CLASS="refnamediv"
  54238. ><A
  54239. NAME="AEN9679"
  54240. ></A
  54241. ><P
  54242. >    (PHP 3>= 3.0.13, PHP 4 , PHP 5)</P
  54243. >krsort -- 
  54244.      Sortiert ein Array nach Schlⁿsseln in umgekehrter Reihenfolge
  54245.     </DIV
  54246. ><DIV
  54247. CLASS="refsect1"
  54248. ><A
  54249. NAME="AEN9682"
  54250. ></A
  54251. ><H2
  54252. >Beschreibung</H2
  54253. >int <B
  54254. CLASS="methodname"
  54255. >krsort</B
  54256. > ( array array [, int sort_flags])<BR
  54257. ></BR
  54258. ><P
  54259. >      Sortiert ein Array nach Schlⁿsseln in umgekehrter Reihenfolge,
  54260.      wobei die Zuordnungen zwischen Schlⁿssel und Wert erhalten
  54261.      bleiben. Dies ist hauptsΣchlich bei assoziativen Arrays
  54262.      hilfreich.
  54263.     </P
  54264. ><P
  54265. >      <TABLE
  54266. WIDTH="100%"
  54267. BORDER="0"
  54268. CELLPADDING="0"
  54269. CELLSPACING="0"
  54270. CLASS="EXAMPLE"
  54271. ><TR
  54272. ><TD
  54273. ><DIV
  54274. CLASS="example"
  54275. ><A
  54276. NAME="AEN9695"
  54277. ></A
  54278. ><P
  54279. ><B
  54280. >Beispiel 1. <B
  54281. CLASS="function"
  54282. >krsort()</B
  54283. ></B
  54284. ></P
  54285. ><TABLE
  54286. BORDER="0"
  54287. BGCOLOR="#E0E0E0"
  54288. CELLPADDING="5"
  54289. ><TR
  54290. ><TD
  54291. ><PRE
  54292. CLASS="php"
  54293. ><?php
  54294. $fruits = array ("d"=>"Zitrone", "a"=>"Orange", "b"=>"Banane", "c"=>"Apfel");
  54295. krsort ($fruits);
  54296. reset ($fruits);
  54297. while (list ($key, $val) = each ($fruits)) {
  54298.     echo "$key = $val\n";
  54299. }
  54300. ?></PRE
  54301. ></TD
  54302. ></TR
  54303. ></TABLE
  54304. ><P
  54305. >        Dieses Beispiel wⁿrde folgendes ausgeben:
  54306.       </P
  54307. ><TABLE
  54308. BORDER="0"
  54309. BGCOLOR="#E0E0E0"
  54310. CELLPADDING="5"
  54311. ><TR
  54312. ><TD
  54313. ><PRE
  54314. CLASS="screen"
  54315. >d = Zitrone
  54316. c = Apfel
  54317. b = Banane
  54318. a = Orange</PRE
  54319. ></TD
  54320. ></TR
  54321. ></TABLE
  54322. ></DIV
  54323. ></TD
  54324. ></TR
  54325. ></TABLE
  54326. >
  54327.     </P
  54328. ><P
  54329. >      Sie k÷nnen das Verhalten der Sortierung mittels dem optionalen
  54330.      Parameter <VAR
  54331. CLASS="parameter"
  54332. >sort_flags</VAR
  54333. > beeinflussen, fⁿr
  54334.      Details siehe <A
  54335. HREF="#function.sort"
  54336. ><B
  54337. CLASS="function"
  54338. >sort()</B
  54339. ></A
  54340. >.
  54341.     </P
  54342. ><P
  54343. >      Siehe auch <A
  54344. HREF="#function.asort"
  54345. ><B
  54346. CLASS="function"
  54347. >asort()</B
  54348. ></A
  54349. >, <A
  54350. HREF="#function.arsort"
  54351. ><B
  54352. CLASS="function"
  54353. >arsort()</B
  54354. ></A
  54355. >,
  54356.      <A
  54357. HREF="#function.ksort"
  54358. ><B
  54359. CLASS="function"
  54360. >ksort()</B
  54361. ></A
  54362. >, <A
  54363. HREF="#function.sort"
  54364. ><B
  54365. CLASS="function"
  54366. >sort()</B
  54367. ></A
  54368. >,
  54369.      <A
  54370. HREF="#function.natsort"
  54371. ><B
  54372. CLASS="function"
  54373. >natsort()</B
  54374. ></A
  54375. > und <A
  54376. HREF="#function.rsort"
  54377. ><B
  54378. CLASS="function"
  54379. >rsort()</B
  54380. ></A
  54381. >.
  54382.     </P
  54383. ></DIV
  54384. ><H1
  54385. ><A
  54386. NAME="function.ksort"
  54387. ></A
  54388. >ksort</H1
  54389. ><DIV
  54390. CLASS="refnamediv"
  54391. ><A
  54392. NAME="AEN9712"
  54393. ></A
  54394. ><P
  54395. >    (PHP 3, PHP 4 , PHP 5)</P
  54396. >ksort -- Sortiert ein Array nach Schlⁿsseln</DIV
  54397. ><DIV
  54398. CLASS="refsect1"
  54399. ><A
  54400. NAME="AEN9715"
  54401. ></A
  54402. ><H2
  54403. >Beschreibung</H2
  54404. >int <B
  54405. CLASS="methodname"
  54406. >ksort</B
  54407. > ( array array [, int sort_flags])<BR
  54408. ></BR
  54409. ><P
  54410. >      Sortiert ein Array nach Schlⁿsseln, wobei die Zuordnungen
  54411.      zwischen Schlⁿssel und Wert erhalten bleiben. Dies ist
  54412.      hauptsΣchlich bei assoziativen Arrays hilfreich.
  54413.     </P
  54414. ><P
  54415. >      <TABLE
  54416. WIDTH="100%"
  54417. BORDER="0"
  54418. CELLPADDING="0"
  54419. CELLSPACING="0"
  54420. CLASS="EXAMPLE"
  54421. ><TR
  54422. ><TD
  54423. ><DIV
  54424. CLASS="example"
  54425. ><A
  54426. NAME="AEN9728"
  54427. ></A
  54428. ><P
  54429. ><B
  54430. >Beispiel 1. <B
  54431. CLASS="function"
  54432. >ksort()</B
  54433. ></B
  54434. ></P
  54435. ><TABLE
  54436. BORDER="0"
  54437. BGCOLOR="#E0E0E0"
  54438. CELLPADDING="5"
  54439. ><TR
  54440. ><TD
  54441. ><PRE
  54442. CLASS="php"
  54443. ><?php
  54444. $fruits = array ("d"=>"Zitrone", "a"=>"Orange", "b"=>"Banane", "c"=>"Apfel");
  54445. ksort ($fruits);
  54446. reset ($fruits);
  54447. while (list ($key, $val) = each ($fruits)) {
  54448.     echo "$key = $val\n";
  54449. }
  54450. ?></PRE
  54451. ></TD
  54452. ></TR
  54453. ></TABLE
  54454. ><P
  54455. >        Dieses Beispiel wⁿrde folgendes ausgeben:
  54456.       </P
  54457. ><TABLE
  54458. BORDER="0"
  54459. BGCOLOR="#E0E0E0"
  54460. CELLPADDING="5"
  54461. ><TR
  54462. ><TD
  54463. ><PRE
  54464. CLASS="screen"
  54465. >a = Orange
  54466. b = Banane
  54467. c = Apfel
  54468. d = Zitrone</PRE
  54469. ></TD
  54470. ></TR
  54471. ></TABLE
  54472. ></DIV
  54473. ></TD
  54474. ></TR
  54475. ></TABLE
  54476. >
  54477.     </P
  54478. ><P
  54479. >      Sie k÷nnen das Verhalten der Sortierung mittels dem optionalen
  54480.      Parameter <VAR
  54481. CLASS="parameter"
  54482. >sort_flags</VAR
  54483. > beeinflussen, fⁿr
  54484.      Details siehe <A
  54485. HREF="#function.sort"
  54486. ><B
  54487. CLASS="function"
  54488. >sort()</B
  54489. ></A
  54490. >.
  54491.     </P
  54492. ><P
  54493. >      Siehe auch <A
  54494. HREF="#function.asort"
  54495. ><B
  54496. CLASS="function"
  54497. >asort()</B
  54498. ></A
  54499. >, <A
  54500. HREF="#function.arsort"
  54501. ><B
  54502. CLASS="function"
  54503. >arsort()</B
  54504. ></A
  54505. >,
  54506.      <A
  54507. HREF="#function.krsort"
  54508. ><B
  54509. CLASS="function"
  54510. >krsort()</B
  54511. ></A
  54512. >, <A
  54513. HREF="#function.uksort"
  54514. ><B
  54515. CLASS="function"
  54516. >uksort()</B
  54517. ></A
  54518. >,
  54519.      <A
  54520. HREF="#function.sort"
  54521. ><B
  54522. CLASS="function"
  54523. >sort()</B
  54524. ></A
  54525. >, <A
  54526. HREF="#function.natsort"
  54527. ><B
  54528. CLASS="function"
  54529. >natsort()</B
  54530. ></A
  54531. > und
  54532.      <A
  54533. HREF="#function.rsort"
  54534. ><B
  54535. CLASS="function"
  54536. >rsort()</B
  54537. ></A
  54538. >.
  54539.     </P
  54540. ><DIV
  54541. CLASS="note"
  54542. ><BLOCKQUOTE
  54543. CLASS="note"
  54544. ><P
  54545. ><B
  54546. >Anmerkung: </B
  54547. >
  54548.       Der zweite Parameter wurde mit PHP 4 eingefⁿhrt.
  54549.      </P
  54550. ></BLOCKQUOTE
  54551. ></DIV
  54552. ></DIV
  54553. ><H1
  54554. ><A
  54555. NAME="function.list"
  54556. ></A
  54557. >list</H1
  54558. ><DIV
  54559. CLASS="refnamediv"
  54560. ><A
  54561. NAME="AEN9748"
  54562. ></A
  54563. ><P
  54564. >    (PHP 3, PHP 4, PHP 5 )</P
  54565. >list -- 
  54566.      Weist Variablen zu, als wΣren sie ein Array
  54567.     </DIV
  54568. ><DIV
  54569. CLASS="refsect1"
  54570. ><A
  54571. NAME="AEN9751"
  54572. ></A
  54573. ><H2
  54574. >Beschreibung</H2
  54575. >void <B
  54576. CLASS="methodname"
  54577. >list</B
  54578. > ( mixed ...)<BR
  54579. ></BR
  54580. ><P
  54581. >      Wie <A
  54582. HREF="#function.array"
  54583. ><B
  54584. CLASS="function"
  54585. >array()</B
  54586. ></A
  54587. > ist auch dies keine wirkliche
  54588.      Funktion, sondern ein Sprachkonstrukt. <B
  54589. CLASS="function"
  54590. >list()</B
  54591. >
  54592.      wird verwendet, um eine Liste von Variablen innerhalb einer
  54593.      Operation zuzuweisen.
  54594.     </P
  54595. ><DIV
  54596. CLASS="note"
  54597. ><BLOCKQUOTE
  54598. CLASS="note"
  54599. ><P
  54600. ><B
  54601. >Anmerkung: </B
  54602. >
  54603.       <B
  54604. CLASS="function"
  54605. >list()</B
  54606. > funktioniert nur bei numerischen Arrays und
  54607.       basiert auf der Annahme, dass die numerischen Indizes bei 0 beginnen.
  54608.      </P
  54609. ></BLOCKQUOTE
  54610. ></DIV
  54611. ><P
  54612. >      <TABLE
  54613. WIDTH="100%"
  54614. BORDER="0"
  54615. CELLPADDING="0"
  54616. CELLSPACING="0"
  54617. CLASS="EXAMPLE"
  54618. ><TR
  54619. ><TD
  54620. ><DIV
  54621. CLASS="example"
  54622. ><A
  54623. NAME="AEN9766"
  54624. ></A
  54625. ><P
  54626. ><B
  54627. >Beispiel 1. <B
  54628. CLASS="function"
  54629. >list()</B
  54630. ></B
  54631. ></P
  54632. ><TABLE
  54633. BORDER="0"
  54634. BGCOLOR="#E0E0E0"
  54635. CELLPADDING="5"
  54636. ><TR
  54637. ><TD
  54638. ><PRE
  54639. CLASS="php"
  54640. ><?php
  54641.  
  54642. $info = array('coffee', 'brown', 'caffeine');
  54643.  
  54644. // Auflisten aller Variablen
  54645. list($drink, $color, $power) = $info;
  54646. print "$drink is $color and $power makes it special.\n";
  54647.  
  54648. // Ein paar davon auflisten
  54649. list($drink, , $power) = $info;
  54650. print "$drink has $power.\n";
  54651.  
  54652. // Oder nur die dritte ausgeben
  54653. list( , , $power) = $info;
  54654. print "I need $power!\n";
  54655.  
  54656. ?></PRE
  54657. ></TD
  54658. ></TR
  54659. ></TABLE
  54660. ></DIV
  54661. ></TD
  54662. ></TR
  54663. ></TABLE
  54664. >
  54665.     </P
  54666. ><P
  54667. >      <TABLE
  54668. WIDTH="100%"
  54669. BORDER="0"
  54670. CELLPADDING="0"
  54671. CELLSPACING="0"
  54672. CLASS="EXAMPLE"
  54673. ><TR
  54674. ><TD
  54675. ><DIV
  54676. CLASS="example"
  54677. ><A
  54678. NAME="AEN9771"
  54679. ></A
  54680. ><P
  54681. ><B
  54682. >Beispiel 2. <B
  54683. CLASS="function"
  54684. >list()</B
  54685. ></B
  54686. ></P
  54687. ><TABLE
  54688. BORDER="0"
  54689. BGCOLOR="#E0E0E0"
  54690. CELLPADDING="5"
  54691. ><TR
  54692. ><TD
  54693. ><PRE
  54694. CLASS="php"
  54695. ><table>
  54696.  <tr>
  54697.   <th>Mitarbeitername</th>
  54698.   <th>Gehalt</th>
  54699.  </tr>
  54700.  
  54701. <?php
  54702.  
  54703. $result = mysql_query ("SELECT id, name, salary FROM employees",$conn);
  54704. while (list ($id, $name, $salary) = mysql_fetch_row ($result)) {
  54705.     print (" <tr>\n".
  54706.            "  <td><a href=\"info.php?id=$id\">$name</a></td>\n".
  54707.            "  <td>$salary</td>\n".
  54708.            " </tr>\n");
  54709. }
  54710.  
  54711. ?>
  54712.  
  54713. </table></PRE
  54714. ></TD
  54715. ></TR
  54716. ></TABLE
  54717. ></DIV
  54718. ></TD
  54719. ></TR
  54720. ></TABLE
  54721. >
  54722.     </P
  54723. ><DIV
  54724. CLASS="warning"
  54725. ><P
  54726. ></P
  54727. ><TABLE
  54728. CLASS="warning"
  54729. BORDER="1"
  54730. WIDTH="100%"
  54731. ><TR
  54732. ><TD
  54733. ALIGN="CENTER"
  54734. ><B
  54735. >Warnung</B
  54736. ></TD
  54737. ></TR
  54738. ><TR
  54739. ><TD
  54740. ALIGN="LEFT"
  54741. ><P
  54742. >       <B
  54743. CLASS="function"
  54744. >list()</B
  54745. > weist die Werte von rechts beginnend zu.
  54746.       Wenn Sie einfache Variablen benutzen, brauchen Sie sich nicht darum
  54747.       zu kⁿmmern. Wenn Sie jedoch Arrays mit Indizes verwenden, erwarten Sie
  54748.       gew÷hnlich die Reihenfolge der Indizes in dem Array genau so, wie Sie
  54749.       sie in <B
  54750. CLASS="function"
  54751. >list()</B
  54752. > geschrieben haben (von links nach
  54753.       rechts), was jedoch nicht der Fall ist. Es wird in der umgekehrten
  54754.       Reihenfolge zugewiesen.
  54755.      </P
  54756. ></TD
  54757. ></TR
  54758. ></TABLE
  54759. ></DIV
  54760. ><P
  54761. >      <TABLE
  54762. WIDTH="100%"
  54763. BORDER="0"
  54764. CELLPADDING="0"
  54765. CELLSPACING="0"
  54766. CLASS="EXAMPLE"
  54767. ><TR
  54768. ><TD
  54769. ><DIV
  54770. CLASS="example"
  54771. ><A
  54772. NAME="AEN9780"
  54773. ></A
  54774. ><P
  54775. ><B
  54776. >Beispiel 3. <B
  54777. CLASS="function"
  54778. >list()</B
  54779. > mit Array Indizes verwenden</B
  54780. ></P
  54781. ><TABLE
  54782. BORDER="0"
  54783. BGCOLOR="#E0E0E0"
  54784. CELLPADDING="5"
  54785. ><TR
  54786. ><TD
  54787. ><PRE
  54788. CLASS="php"
  54789. ><?php
  54790.  
  54791. $info = array('coffee', 'brown', 'caffeine');
  54792.  
  54793. list($a[0], $a[1], $a[2]) = $info;
  54794.  
  54795. var_dump($a);
  54796.  
  54797. ?></PRE
  54798. ></TD
  54799. ></TR
  54800. ></TABLE
  54801. ><P
  54802. >        Die Ausgabe (Beachten Sie die Reihenfolge der Elemente, verglichen mit
  54803.        der in <B
  54804. CLASS="function"
  54805. >list()</B
  54806. > eingetragenen Reihenfolge):
  54807.       </P
  54808. ><TABLE
  54809. BORDER="0"
  54810. BGCOLOR="#E0E0E0"
  54811. CELLPADDING="5"
  54812. ><TR
  54813. ><TD
  54814. ><PRE
  54815. CLASS="screen"
  54816. >array(3) {
  54817.   [2]=>
  54818.   string(8) "caffeine"
  54819.   [1]=>
  54820.   string(5) "brown"
  54821.   [0]=>
  54822.   string(6) "coffee"
  54823. }</PRE
  54824. ></TD
  54825. ></TR
  54826. ></TABLE
  54827. ></DIV
  54828. ></TD
  54829. ></TR
  54830. ></TABLE
  54831. >
  54832.     </P
  54833. ><P
  54834. >      Siehe auch <A
  54835. HREF="#function.each"
  54836. ><B
  54837. CLASS="function"
  54838. >each()</B
  54839. ></A
  54840. >, <A
  54841. HREF="#function.array"
  54842. ><B
  54843. CLASS="function"
  54844. >array()</B
  54845. ></A
  54846. >
  54847.      und <A
  54848. HREF="#function.extract"
  54849. ><B
  54850. CLASS="function"
  54851. >extract()</B
  54852. ></A
  54853. >.
  54854.     </P
  54855. ></DIV
  54856. ><H1
  54857. ><A
  54858. NAME="function.natcasesort"
  54859. ></A
  54860. >natcasesort</H1
  54861. ><DIV
  54862. CLASS="refnamediv"
  54863. ><A
  54864. NAME="AEN9792"
  54865. ></A
  54866. ><P
  54867. >    (PHP 4 , PHP 5)</P
  54868. >natcasesort -- 
  54869.      Sortiert ein Array in "natⁿrlicher Reihenfolge",
  54870.      Gro▀/Kleinschreibung wird ignoriert
  54871.     </DIV
  54872. ><DIV
  54873. CLASS="refsect1"
  54874. ><A
  54875. NAME="AEN9795"
  54876. ></A
  54877. ><H2
  54878. >Beschreibung</H2
  54879. >void <B
  54880. CLASS="methodname"
  54881. >natcasesort</B
  54882. > ( array array)<BR
  54883. ></BR
  54884. ><P
  54885. >      Diese Funktion implementiert einen Sortieralgorithmus, welcher
  54886.      alphanumerische Zeichenketten reiht, wie es auch ein Mensch tun
  54887.      wⁿrde. Das wird als "natⁿrliche Reihenfolge" bezeichnet.
  54888.     </P
  54889. ><P
  54890. >      <B
  54891. CLASS="function"
  54892. >natcasesort()</B
  54893. > arbeitet wie
  54894.      <A
  54895. HREF="#function.natsort"
  54896. ><B
  54897. CLASS="function"
  54898. >natsort()</B
  54899. ></A
  54900. >, nur dass es die
  54901.      Gro▀/Kleinschreibung ignoriert. Ein Beispiel fⁿr den Unterschied
  54902.      zwischen diesem und dem normalen Sortieralgorithmus fⁿr Strings
  54903.      eines Computers finden Sie in <A
  54904. HREF="#function.natsort"
  54905. ><B
  54906. CLASS="function"
  54907. >natsort()</B
  54908. ></A
  54909. >.
  54910.     </P
  54911. ><P
  54912. >      Detailliertere Informationen finden Sie auf Martin Pool's <A
  54913. HREF="http://sourcefrog.net/projects/natsort/"
  54914. TARGET="_top"
  54915. >Natural Order String Comparison</A
  54916. >
  54917.      Seite.
  54918.     </P
  54919. ><P
  54920. >      Siehe auch <A
  54921. HREF="#function.sort"
  54922. ><B
  54923. CLASS="function"
  54924. >sort()</B
  54925. ></A
  54926. >,
  54927.      <A
  54928. HREF="#function.natsort"
  54929. ><B
  54930. CLASS="function"
  54931. >natsort()</B
  54932. ></A
  54933. >,
  54934.      <A
  54935. HREF="#function.strnatcmp"
  54936. ><B
  54937. CLASS="function"
  54938. >strnatcmp()</B
  54939. ></A
  54940. > und
  54941.      <A
  54942. HREF="#function.strnatcasecmp"
  54943. ><B
  54944. CLASS="function"
  54945. >strnatcasecmp()</B
  54946. ></A
  54947. >.
  54948.     </P
  54949. ></DIV
  54950. ><H1
  54951. ><A
  54952. NAME="function.natsort"
  54953. ></A
  54954. >natsort</H1
  54955. ><DIV
  54956. CLASS="refnamediv"
  54957. ><A
  54958. NAME="AEN9816"
  54959. ></A
  54960. ><P
  54961. >    (PHP 4 , PHP 5)</P
  54962. >natsort -- 
  54963.      Sortiert ein Array in "natⁿrlicher Reihenfolge"
  54964.     </DIV
  54965. ><DIV
  54966. CLASS="refsect1"
  54967. ><A
  54968. NAME="AEN9819"
  54969. ></A
  54970. ><H2
  54971. >Beschreibung</H2
  54972. >void <B
  54973. CLASS="methodname"
  54974. >natsort</B
  54975. > ( array array)<BR
  54976. ></BR
  54977. ><P
  54978. >      Diese Funktion implementiert einen Sortieralgorithmus, welcher
  54979.      alphanumerische Zeichenketten reiht, wie es auch ein Mensch tun
  54980.      wⁿrde. Hier ein Beispiel fⁿr den Unterschied zwischen diesem und
  54981.      dem normalen Sortieralgorithmus fⁿr Strings eines Computers
  54982.      (verwendet in <A
  54983. HREF="#function.sort"
  54984. ><B
  54985. CLASS="function"
  54986. >sort()</B
  54987. ></A
  54988. >):
  54989.     </P
  54990. ><P
  54991. >      <TABLE
  54992. WIDTH="100%"
  54993. BORDER="0"
  54994. CELLPADDING="0"
  54995. CELLSPACING="0"
  54996. CLASS="EXAMPLE"
  54997. ><TR
  54998. ><TD
  54999. ><DIV
  55000. CLASS="example"
  55001. ><A
  55002. NAME="AEN9830"
  55003. ></A
  55004. ><P
  55005. ><B
  55006. >Beispiel 1. <B
  55007. CLASS="function"
  55008. >natsort()</B
  55009. ></B
  55010. ></P
  55011. ><TABLE
  55012. BORDER="0"
  55013. BGCOLOR="#E0E0E0"
  55014. CELLPADDING="5"
  55015. ><TR
  55016. ><TD
  55017. ><PRE
  55018. CLASS="php"
  55019. ><?php
  55020. $array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png");
  55021. sort ($array1);
  55022. echo "Standardsortierung\n";
  55023. print_r ($array1);
  55024.  
  55025. natsort ($array2);
  55026. echo "\nSortieren mit natⁿrlicher Reihenfolge\n";
  55027. print_r ($array2);
  55028. ?></PRE
  55029. ></TD
  55030. ></TR
  55031. ></TABLE
  55032. ><P
  55033. >        Der obige Code wird folgendes anzeigen:
  55034.       </P
  55035. ><TABLE
  55036. BORDER="0"
  55037. BGCOLOR="#E0E0E0"
  55038. CELLPADDING="5"
  55039. ><TR
  55040. ><TD
  55041. ><PRE
  55042. CLASS="screen"
  55043. >Standardsortierung
  55044. Array
  55045. (
  55046.     [0] => img1.png
  55047.     [1] => img10.png
  55048.     [2] => img12.png
  55049.     [3] => img2.png
  55050. )
  55051.  
  55052. Sortieren mit natⁿrlicher Reihenfolge
  55053. Array
  55054. (
  55055.     [3] => img1.png
  55056.     [2] => img2.png
  55057.     [1] => img10.png
  55058.     [0] => img12.png
  55059. )</PRE
  55060. ></TD
  55061. ></TR
  55062. ></TABLE
  55063. ><P
  55064. >        Detailliertere Informationen finden Sie auf Martin Pool's <A
  55065. HREF="http://sourcefrog.net/projects/natsort/"
  55066. TARGET="_top"
  55067. >Natural Order String Comparison</A
  55068. >
  55069.        Seite.
  55070.       </P
  55071. ></DIV
  55072. ></TD
  55073. ></TR
  55074. ></TABLE
  55075. >
  55076.     </P
  55077. ><DIV
  55078. CLASS="note"
  55079. ><BLOCKQUOTE
  55080. CLASS="note"
  55081. ><P
  55082. ><B
  55083. >Anmerkung: </B
  55084. >
  55085.       Wenn Sie die Index/Wert Assoziationen beibehalten wollen, denken Sie
  55086.       an die Verwendung von <VAR
  55087. CLASS="literal"
  55088. >uasort($arr, 'strnatcmp')</VAR
  55089. >.
  55090.      </P
  55091. ></BLOCKQUOTE
  55092. ></DIV
  55093. ><P
  55094. >      Siehe auch <A
  55095. HREF="#function.natcasesort"
  55096. ><B
  55097. CLASS="function"
  55098. >natcasesort()</B
  55099. ></A
  55100. >,
  55101.      <A
  55102. HREF="#function.strnatcmp"
  55103. ><B
  55104. CLASS="function"
  55105. >strnatcmp()</B
  55106. ></A
  55107. > und
  55108.      <A
  55109. HREF="#function.strnatcasecmp"
  55110. ><B
  55111. CLASS="function"
  55112. >strnatcasecmp()</B
  55113. ></A
  55114. >.
  55115.     </P
  55116. ></DIV
  55117. ><H1
  55118. ><A
  55119. NAME="function.next"
  55120. ></A
  55121. >next</H1
  55122. ><DIV
  55123. CLASS="refnamediv"
  55124. ><A
  55125. NAME="AEN9846"
  55126. ></A
  55127. ><P
  55128. >    (PHP 3, PHP 4 , PHP 5)</P
  55129. >next -- 
  55130.      Rⁿckt den internen Zeiger eines Arrays vor
  55131.     </DIV
  55132. ><DIV
  55133. CLASS="refsect1"
  55134. ><A
  55135. NAME="AEN9849"
  55136. ></A
  55137. ><H2
  55138. >Beschreibung</H2
  55139. >mixed <B
  55140. CLASS="methodname"
  55141. >next</B
  55142. > ( array array)<BR
  55143. ></BR
  55144. ><P
  55145. >      Diese Funktion gibt das nΣchste Element des Arrays zurⁿck, auf
  55146.      das der interne Zeiger des Arrays gerade zeigt. Sind keine
  55147.      Elemente mehr vorhanden, wird <TT
  55148. CLASS="constant"
  55149. ><B
  55150. >FALSE</B
  55151. ></TT
  55152. > zurⁿckgegeben.
  55153.     </P
  55154. ><P
  55155. >      <B
  55156. CLASS="function"
  55157. >next()</B
  55158. > verhΣlt sich Σhnlich wie
  55159.      <A
  55160. HREF="#function.current"
  55161. ><B
  55162. CLASS="function"
  55163. >current()</B
  55164. ></A
  55165. >, mit einem Unterschied. Der interne
  55166.      Zeiger wird um ein Element vorgerⁿckt, bevor das Element
  55167.      zurⁿckgegeben wird, d.h. es wird das nΣchste Element
  55168.      zurⁿckgegeben, und der interne Zeiger um eins erh÷ht. Zeigt der
  55169.      interne Zeiger hinter das Ende der Elementliste, wird <TT
  55170. CLASS="constant"
  55171. ><B
  55172. >FALSE</B
  55173. ></TT
  55174. >
  55175.      zurⁿckgegeben.
  55176.      <DIV
  55177. CLASS="warning"
  55178. ><P
  55179. ></P
  55180. ><TABLE
  55181. CLASS="warning"
  55182. BORDER="1"
  55183. WIDTH="100%"
  55184. ><TR
  55185. ><TD
  55186. ALIGN="CENTER"
  55187. ><B
  55188. >Warnung</B
  55189. ></TD
  55190. ></TR
  55191. ><TR
  55192. ><TD
  55193. ALIGN="LEFT"
  55194. ><P
  55195. >        EnthΣlt das Array leere Elemente oder Elemente mit dem
  55196.        Schlⁿssel 0, wird fⁿr diese Elemente ebenfalls <TT
  55197. CLASS="constant"
  55198. ><B
  55199. >FALSE</B
  55200. ></TT
  55201. >
  55202.        zurⁿckgegeben. Um ein Array, das leere Elemente oder Elemente
  55203.        mit dem Schlⁿssel 0 enthalten k÷nnte richtig durchzugehen,
  55204.        verwenden Sie die Funktion <A
  55205. HREF="#function.each"
  55206. ><B
  55207. CLASS="function"
  55208. >each()</B
  55209. ></A
  55210. >.
  55211.       </P
  55212. ></TD
  55213. ></TR
  55214. ></TABLE
  55215. ></DIV
  55216. >
  55217.     </P
  55218. ><P
  55219. >      Siehe auch <A
  55220. HREF="#function.current"
  55221. ><B
  55222. CLASS="function"
  55223. >current()</B
  55224. ></A
  55225. >,
  55226.      <A
  55227. HREF="#function.end"
  55228. ><B
  55229. CLASS="function"
  55230. >end()</B
  55231. ></A
  55232. >, <A
  55233. HREF="#function.prev"
  55234. ><B
  55235. CLASS="function"
  55236. >prev()</B
  55237. ></A
  55238. > und
  55239.      <A
  55240. HREF="#function.reset"
  55241. ><B
  55242. CLASS="function"
  55243. >reset()</B
  55244. ></A
  55245. >.
  55246.     </P
  55247. ></DIV
  55248. ><H1
  55249. ><A
  55250. NAME="function.pos"
  55251. ></A
  55252. >pos</H1
  55253. ><DIV
  55254. CLASS="refnamediv"
  55255. ><A
  55256. NAME="AEN9873"
  55257. ></A
  55258. ><P
  55259. >    (PHP 3, PHP 4 , PHP 5)</P
  55260. >pos -- Liefert das aktuelle Element eines Arrays</DIV
  55261. ><DIV
  55262. CLASS="refsect1"
  55263. ><A
  55264. NAME="AEN9876"
  55265. ></A
  55266. ><H2
  55267. >Beschreibung</H2
  55268. >mixed <B
  55269. CLASS="methodname"
  55270. >pos</B
  55271. > ( array array)<BR
  55272. ></BR
  55273. ><P
  55274. >      Dies ist nur ein <A
  55275. HREF="#aliases"
  55276. >Alias</A
  55277. >
  55278.      fⁿr die Funktion <A
  55279. HREF="#function.current"
  55280. ><B
  55281. CLASS="function"
  55282. >current()</B
  55283. ></A
  55284. >.
  55285.     </P
  55286. ><P
  55287. >      Siehe auch
  55288.      <A
  55289. HREF="#function.end"
  55290. ><B
  55291. CLASS="function"
  55292. >end()</B
  55293. ></A
  55294. >, <A
  55295. HREF="#function.next"
  55296. ><B
  55297. CLASS="function"
  55298. >next()</B
  55299. ></A
  55300. >,
  55301.      <A
  55302. HREF="#function.prev"
  55303. ><B
  55304. CLASS="function"
  55305. >prev()</B
  55306. ></A
  55307. > und <A
  55308. HREF="#function.reset"
  55309. ><B
  55310. CLASS="function"
  55311. >reset()</B
  55312. ></A
  55313. >.
  55314.     </P
  55315. ></DIV
  55316. ><H1
  55317. ><A
  55318. NAME="function.prev"
  55319. ></A
  55320. >prev</H1
  55321. ><DIV
  55322. CLASS="refnamediv"
  55323. ><A
  55324. NAME="AEN9893"
  55325. ></A
  55326. ><P
  55327. >    (PHP 3, PHP 4 , PHP 5)</P
  55328. >prev -- 
  55329.      Verkleinert den internen Zeiger eines Arrays
  55330.     </DIV
  55331. ><DIV
  55332. CLASS="refsect1"
  55333. ><A
  55334. NAME="AEN9896"
  55335. ></A
  55336. ><H2
  55337. >Beschreibung</H2
  55338. >mixed <B
  55339. CLASS="methodname"
  55340. >prev</B
  55341. > ( array array)<BR
  55342. ></BR
  55343. ><P
  55344. >      Liefert das Element vor der Position des Arrays, auf die der
  55345.      interne Zeiger gerade zeigt. Sind keine Elemente mehr vorhanden,
  55346.      wird <TT
  55347. CLASS="constant"
  55348. ><B
  55349. >FALSE</B
  55350. ></TT
  55351. > zurⁿckgegeben.
  55352.      <DIV
  55353. CLASS="warning"
  55354. ><P
  55355. ></P
  55356. ><TABLE
  55357. CLASS="warning"
  55358. BORDER="1"
  55359. WIDTH="100%"
  55360. ><TR
  55361. ><TD
  55362. ALIGN="CENTER"
  55363. ><B
  55364. >Warnung</B
  55365. ></TD
  55366. ></TR
  55367. ><TR
  55368. ><TD
  55369. ALIGN="LEFT"
  55370. ><P
  55371. >        EnthΣlt das Array leere Elemente, wird fⁿr diese ebenfalls
  55372.        <TT
  55373. CLASS="constant"
  55374. ><B
  55375. >FALSE</B
  55376. ></TT
  55377. > zurⁿckgegeben. Um ein Array mit leeren Elementen
  55378.        richtig durchzugehen, verwenden Sie die Funktion
  55379.        <A
  55380. HREF="#function.each"
  55381. ><B
  55382. CLASS="function"
  55383. >each()</B
  55384. ></A
  55385. >.
  55386.       </P
  55387. ></TD
  55388. ></TR
  55389. ></TABLE
  55390. ></DIV
  55391. >
  55392.     </P
  55393. ><P
  55394. >      <B
  55395. CLASS="function"
  55396. >prev()</B
  55397. > verhΣlt sich wie
  55398.      <A
  55399. HREF="#function.next"
  55400. ><B
  55401. CLASS="function"
  55402. >next()</B
  55403. ></A
  55404. >, nur dass hier der interne Zeiger um
  55405.      eine Position zurⁿck, und nicht nach vorne gerⁿckt wird.
  55406.     </P
  55407. ><P
  55408. >      Siehe auch <A
  55409. HREF="#function.current"
  55410. ><B
  55411. CLASS="function"
  55412. >current()</B
  55413. ></A
  55414. >,
  55415.      <A
  55416. HREF="#function.end"
  55417. ><B
  55418. CLASS="function"
  55419. >end()</B
  55420. ></A
  55421. >, <A
  55422. HREF="#function.next"
  55423. ><B
  55424. CLASS="function"
  55425. >next()</B
  55426. ></A
  55427. > und
  55428.      <A
  55429. HREF="#function.reset"
  55430. ><B
  55431. CLASS="function"
  55432. >reset()</B
  55433. ></A
  55434. >.
  55435.     </P
  55436. ></DIV
  55437. ><H1
  55438. ><A
  55439. NAME="function.range"
  55440. ></A
  55441. >range</H1
  55442. ><DIV
  55443. CLASS="refnamediv"
  55444. ><A
  55445. NAME="AEN9919"
  55446. ></A
  55447. ><P
  55448. >    (PHP 3>= 3.0.8, PHP 4 , PHP 5)</P
  55449. >range -- 
  55450.      Erstellt ein Array mit einem Bereich von Elementen
  55451.     </DIV
  55452. ><DIV
  55453. CLASS="refsect1"
  55454. ><A
  55455. NAME="AEN9922"
  55456. ></A
  55457. ><H2
  55458. >Beschreibung</H2
  55459. >array <B
  55460. CLASS="methodname"
  55461. >range</B
  55462. > ( int low, int high [, int step])<BR
  55463. ></BR
  55464. ><P
  55465. >      <B
  55466. CLASS="function"
  55467. >range()</B
  55468. > gibt ein Array mit Elementen im
  55469.      Bereich von <VAR
  55470. CLASS="parameter"
  55471. >low</VAR
  55472. > bis
  55473.      <VAR
  55474. CLASS="parameter"
  55475. >high</VAR
  55476. > zurⁿck. Wenn low > high, wird die
  55477.      Sequenz von high nach low sein.
  55478.     </P
  55479. ><DIV
  55480. CLASS="note"
  55481. ><BLOCKQUOTE
  55482. CLASS="note"
  55483. ><P
  55484. ><B
  55485. >Neuer Parameter: </B
  55486. >
  55487.       Der optionale Parameter <VAR
  55488. CLASS="parameter"
  55489. >step</VAR
  55490. > wurde in 5.0.0 eingefⁿhrt.
  55491.      </P
  55492. ></BLOCKQUOTE
  55493. ></DIV
  55494. ><P
  55495. >      Ist ein <VAR
  55496. CLASS="parameter"
  55497. >step</VAR
  55498. > Wert angegeben, wird es Schrittweite
  55499.      zwischen den Elementen in der Sequenz verwendet. <VAR
  55500. CLASS="parameter"
  55501. >step</VAR
  55502. >
  55503.      sollte als positive Zahl angegeben werden. Ist <VAR
  55504. CLASS="parameter"
  55505. >step</VAR
  55506. >
  55507.      nicht angegeben, wird automatisch der Wert 1 angenommen.
  55508.     </P
  55509. ><P
  55510. >      <TABLE
  55511. WIDTH="100%"
  55512. BORDER="0"
  55513. CELLPADDING="0"
  55514. CELLSPACING="0"
  55515. CLASS="EXAMPLE"
  55516. ><TR
  55517. ><TD
  55518. ><DIV
  55519. CLASS="example"
  55520. ><A
  55521. NAME="AEN9949"
  55522. ></A
  55523. ><P
  55524. ><B
  55525. >Beispiel 1. <B
  55526. CLASS="function"
  55527. >range()</B
  55528. ></B
  55529. ></P
  55530. ><TABLE
  55531. BORDER="0"
  55532. BGCOLOR="#E0E0E0"
  55533. CELLPADDING="5"
  55534. ><TR
  55535. ><TD
  55536. ><PRE
  55537. CLASS="php"
  55538. ><?php
  55539. // array(0,1,2,3,4,5,6,7,8,9,10,11,12)
  55540. foreach(range(0, 12) as $number) {
  55541.     echo $number;
  55542. }
  55543.  
  55544. // Der Parameter step wurde in PHP 5.0.0 eingefⁿhrt
  55545. // array(0,10,20,30,40,50,60,70,80,90,100)
  55546. foreach(range(0, 100, 10) as $number) {
  55547.     echo $number;
  55548. }
  55549.  
  55550. // Die Verwendung von Zeichenfolgen wurde in 4.1.0 eingefⁿhrt
  55551. // array('a','b','c','d','e','f','g','h','i');
  55552. foreach(range('a', 'i') as $letter) {
  55553.     echo $letter;
  55554. }
  55555. // array('c','b','a');
  55556. foreach(range('c', 'a') as $letter) {
  55557.     echo $letter;
  55558. }
  55559. ?></PRE
  55560. ></TD
  55561. ></TR
  55562. ></TABLE
  55563. ></DIV
  55564. ></TD
  55565. ></TR
  55566. ></TABLE
  55567. >
  55568.     </P
  55569. ><DIV
  55570. CLASS="note"
  55571. ><BLOCKQUOTE
  55572. CLASS="note"
  55573. ><P
  55574. ><B
  55575. >Anmerkung: </B
  55576. >
  55577.       Vor der Version 4.1.0 hat die Funktion <B
  55578. CLASS="function"
  55579. >range()</B
  55580. > nur
  55581.       aufsteigende Integer Arrays erstellt. Die Unterstⁿtzung fⁿr Zeichenfolgen
  55582.       und Arrays in absteigender Reihenfolge wurde in 4.1.0 hinzugefⁿgt. Werte
  55583.       mit Zeichenfolgen sind auf eine LΣnge von 1 limitiert. Wird eine LΣnge
  55584.       gr÷▀er als 1 eingegeben, wird nur das erste Zeichen verwendet.
  55585.      </P
  55586. ></BLOCKQUOTE
  55587. ></DIV
  55588. ><DIV
  55589. CLASS="caution"
  55590. ><P
  55591. ></P
  55592. ><TABLE
  55593. CLASS="caution"
  55594. BORDER="1"
  55595. WIDTH="100%"
  55596. ><TR
  55597. ><TD
  55598. ALIGN="CENTER"
  55599. ><B
  55600. >Achtung</B
  55601. ></TD
  55602. ></TR
  55603. ><TR
  55604. ><TD
  55605. ALIGN="LEFT"
  55606. ><P
  55607. >       In den PHP Versionen 4.1.0 bis 4.3.2 werden numerische Zeichenfolgen von
  55608.       <B
  55609. CLASS="function"
  55610. >range()</B
  55611. > als Strings, und nicht als integer gesehen.
  55612.       Stattdessen werden diese fⁿr Zeichenfolgen genutzt, z.B. wird
  55613.       <VAR
  55614. CLASS="literal"
  55615. >"4242"</VAR
  55616. > als <VAR
  55617. CLASS="literal"
  55618. >"4"</VAR
  55619. > betrachtet.
  55620.      </P
  55621. ></TD
  55622. ></TR
  55623. ></TABLE
  55624. ></DIV
  55625. ><P
  55626. >      Siehe auch <A
  55627. HREF="#function.shuffle"
  55628. ><B
  55629. CLASS="function"
  55630. >shuffle()</B
  55631. ></A
  55632. > und
  55633.      <A
  55634. HREF="#control-structures.foreach"
  55635. >foreach</A
  55636. >.
  55637.     </P
  55638. ></DIV
  55639. ><H1
  55640. ><A
  55641. NAME="function.reset"
  55642. ></A
  55643. >reset</H1
  55644. ><DIV
  55645. CLASS="refnamediv"
  55646. ><A
  55647. NAME="AEN9965"
  55648. ></A
  55649. ><P
  55650. >    (PHP 3, PHP 4 , PHP 5)</P
  55651. >reset -- 
  55652.      Setzt den internen Zeiger eines Arrays auf sein erstes Element
  55653.     </DIV
  55654. ><DIV
  55655. CLASS="refsect1"
  55656. ><A
  55657. NAME="AEN9968"
  55658. ></A
  55659. ><H2
  55660. >Beschreibung</H2
  55661. >mixed <B
  55662. CLASS="methodname"
  55663. >reset</B
  55664. > ( array array)<BR
  55665. ></BR
  55666. ><P
  55667. >      <B
  55668. CLASS="function"
  55669. >reset()</B
  55670. > setzt den internen Zeiger von
  55671.      <VAR
  55672. CLASS="parameter"
  55673. >array</VAR
  55674. > auf das erste Element, und gibt den Wert
  55675.      des ersten Arrayelements zurⁿck.
  55676.     </P
  55677. ><P
  55678. >      Siehe auch <A
  55679. HREF="#function.current"
  55680. ><B
  55681. CLASS="function"
  55682. >current()</B
  55683. ></A
  55684. >,
  55685.      <A
  55686. HREF="#function.each"
  55687. ><B
  55688. CLASS="function"
  55689. >each()</B
  55690. ></A
  55691. >, <A
  55692. HREF="#function.next"
  55693. ><B
  55694. CLASS="function"
  55695. >next()</B
  55696. ></A
  55697. > und
  55698.      <A
  55699. HREF="#function.prev"
  55700. ><B
  55701. CLASS="function"
  55702. >prev()</B
  55703. ></A
  55704. >.
  55705.     </P
  55706. ></DIV
  55707. ><H1
  55708. ><A
  55709. NAME="function.rsort"
  55710. ></A
  55711. >rsort</H1
  55712. ><DIV
  55713. CLASS="refnamediv"
  55714. ><A
  55715. NAME="AEN9985"
  55716. ></A
  55717. ><P
  55718. >    (PHP 3, PHP 4 , PHP 5)</P
  55719. >rsort -- 
  55720.      Sortiert ein Array in umgekehrter Reihenfolge
  55721.     </DIV
  55722. ><DIV
  55723. CLASS="refsect1"
  55724. ><A
  55725. NAME="AEN9988"
  55726. ></A
  55727. ><H2
  55728. >Beschreibung</H2
  55729. >void <B
  55730. CLASS="methodname"
  55731. >rsort</B
  55732. > ( array array [, int sort_flags])<BR
  55733. ></BR
  55734. ><P
  55735. >      Diese Funktion sortiert ein Array in umgekehrter Reihenfolge (vom
  55736.      h÷chsten zum niedrigsten Wert).
  55737.     </P
  55738. ><P
  55739. >      <TABLE
  55740. WIDTH="100%"
  55741. BORDER="0"
  55742. CELLPADDING="0"
  55743. CELLSPACING="0"
  55744. CLASS="EXAMPLE"
  55745. ><TR
  55746. ><TD
  55747. ><DIV
  55748. CLASS="example"
  55749. ><A
  55750. NAME="AEN10001"
  55751. ></A
  55752. ><P
  55753. ><B
  55754. >Beispiel 1. <B
  55755. CLASS="function"
  55756. >rsort()</B
  55757. ></B
  55758. ></P
  55759. ><TABLE
  55760. BORDER="0"
  55761. BGCOLOR="#E0E0E0"
  55762. CELLPADDING="5"
  55763. ><TR
  55764. ><TD
  55765. ><PRE
  55766. CLASS="php"
  55767. ><?php
  55768. $fruits = array ("Zitrone", "Orange", "Banane", "Apfel");
  55769. rsort ($fruits);
  55770. reset ($fruits);
  55771. while (list ($key, $val) = each ($fruits)) {
  55772.     echo "$key = $val\n";
  55773. }
  55774. ?></PRE
  55775. ></TD
  55776. ></TR
  55777. ></TABLE
  55778. ><P
  55779. >        Dieses Beispiel wⁿrde folgendes ausgeben:
  55780.       </P
  55781. ><TABLE
  55782. BORDER="0"
  55783. BGCOLOR="#E0E0E0"
  55784. CELLPADDING="5"
  55785. ><TR
  55786. ><TD
  55787. ><PRE
  55788. CLASS="screen"
  55789. >0 = Zitrone
  55790. 1 = Orange
  55791. 2 = Banane
  55792. 3 = Apfel</PRE
  55793. ></TD
  55794. ></TR
  55795. ></TABLE
  55796. ></DIV
  55797. ></TD
  55798. ></TR
  55799. ></TABLE
  55800. >
  55801.     </P
  55802. ><P
  55803. >      Die Frⁿchte wurden in umgekehrter alphabetischer Reihenfolge
  55804.      sortiert.
  55805.     </P
  55806. ><P
  55807. >      Sie k÷nnen das Verhalten der Sortierung mittels dem optionalen
  55808.      Parameter <VAR
  55809. CLASS="parameter"
  55810. >sort_flags</VAR
  55811. > beeinflussen, fⁿr
  55812.      Details siehe <A
  55813. HREF="#function.sort"
  55814. ><B
  55815. CLASS="function"
  55816. >sort()</B
  55817. ></A
  55818. >.
  55819.     </P
  55820. ><P
  55821. >      Siehe auch <A
  55822. HREF="#function.arsort"
  55823. ><B
  55824. CLASS="function"
  55825. >arsort()</B
  55826. ></A
  55827. >,
  55828.      <A
  55829. HREF="#function.asort"
  55830. ><B
  55831. CLASS="function"
  55832. >asort()</B
  55833. ></A
  55834. >, <A
  55835. HREF="#function.ksort"
  55836. ><B
  55837. CLASS="function"
  55838. >ksort()</B
  55839. ></A
  55840. >,
  55841.      <A
  55842. HREF="#function.sort"
  55843. ><B
  55844. CLASS="function"
  55845. >sort()</B
  55846. ></A
  55847. > und <A
  55848. HREF="#function.usort"
  55849. ><B
  55850. CLASS="function"
  55851. >usort()</B
  55852. ></A
  55853. >.
  55854.     </P
  55855. ></DIV
  55856. ><H1
  55857. ><A
  55858. NAME="function.shuffle"
  55859. ></A
  55860. >shuffle</H1
  55861. ><DIV
  55862. CLASS="refnamediv"
  55863. ><A
  55864. NAME="AEN10018"
  55865. ></A
  55866. ><P
  55867. >    (PHP 3>= 3.0.8, PHP 4 , PHP 5)</P
  55868. >shuffle -- Mischt die Elemente eines Arrays</DIV
  55869. ><DIV
  55870. CLASS="refsect1"
  55871. ><A
  55872. NAME="AEN10021"
  55873. ></A
  55874. ><H2
  55875. >Beschreibung</H2
  55876. >void <B
  55877. CLASS="methodname"
  55878. >shuffle</B
  55879. > ( array array)<BR
  55880. ></BR
  55881. ><P
  55882. >      Diese Funktion mischt die Reihenfolge der Elemente eines Arrays
  55883.      zufΣllig (shuffle). Benutzen Sie <A
  55884. HREF="#function.srand"
  55885. ><B
  55886. CLASS="function"
  55887. >srand()</B
  55888. ></A
  55889. >, um
  55890.      den Startwert fⁿr den Zufallsgenerator festzulegen.
  55891.      <TABLE
  55892. WIDTH="100%"
  55893. BORDER="0"
  55894. CELLPADDING="0"
  55895. CELLSPACING="0"
  55896. CLASS="EXAMPLE"
  55897. ><TR
  55898. ><TD
  55899. ><DIV
  55900. CLASS="example"
  55901. ><A
  55902. NAME="AEN10031"
  55903. ></A
  55904. ><P
  55905. ><B
  55906. >Beispiel 1. <B
  55907. CLASS="function"
  55908. >shuffle()</B
  55909. ></B
  55910. ></P
  55911. ><TABLE
  55912. BORDER="0"
  55913. BGCOLOR="#E0E0E0"
  55914. CELLPADDING="5"
  55915. ><TR
  55916. ><TD
  55917. ><PRE
  55918. CLASS="php"
  55919. ><?php
  55920. $numbers = range (1,20);
  55921. srand ((float)microtime()*1000000);
  55922. shuffle ($numbers);
  55923. while (list (, $number) = each ($numbers)) {
  55924.     echo "$number ";
  55925. }
  55926. ?></PRE
  55927. ></TD
  55928. ></TR
  55929. ></TABLE
  55930. ></DIV
  55931. ></TD
  55932. ></TR
  55933. ></TABLE
  55934. >
  55935.     </P
  55936. ><DIV
  55937. CLASS="note"
  55938. ><BLOCKQUOTE
  55939. CLASS="note"
  55940. ><P
  55941. ><B
  55942. >Anmerkung: </B
  55943. >Seit PHP 4.2.0 besteht keine
  55944. Notwendigkeit mehr, den Zufallsgenerator fⁿr Zahlen mit
  55945. <A
  55946. HREF="#function.srand"
  55947. ><B
  55948. CLASS="function"
  55949. >srand()</B
  55950. ></A
  55951. > oder <A
  55952. HREF="#function.mt-srand"
  55953. ><B
  55954. CLASS="function"
  55955. >mt_srand()</B
  55956. ></A
  55957. > zu fⁿttern, das
  55958. geschieht nun automatisch.</P
  55959. ></BLOCKQUOTE
  55960. ></DIV
  55961. ><P
  55962. >      Siehe auch <A
  55963. HREF="#function.arsort"
  55964. ><B
  55965. CLASS="function"
  55966. >arsort()</B
  55967. ></A
  55968. >,
  55969.      <A
  55970. HREF="#function.asort"
  55971. ><B
  55972. CLASS="function"
  55973. >asort()</B
  55974. ></A
  55975. >, <A
  55976. HREF="#function.ksort"
  55977. ><B
  55978. CLASS="function"
  55979. >ksort()</B
  55980. ></A
  55981. >,
  55982.      <A
  55983. HREF="#function.rsort"
  55984. ><B
  55985. CLASS="function"
  55986. >rsort()</B
  55987. ></A
  55988. >, <A
  55989. HREF="#function.sort"
  55990. ><B
  55991. CLASS="function"
  55992. >sort()</B
  55993. ></A
  55994. > und
  55995.      <A
  55996. HREF="#function.usort"
  55997. ><B
  55998. CLASS="function"
  55999. >usort()</B
  56000. ></A
  56001. >.
  56002.     </P
  56003. ></DIV
  56004. ><H1
  56005. ><A
  56006. NAME="function.sizeof"
  56007. ></A
  56008. >sizeof</H1
  56009. ><DIV
  56010. CLASS="refnamediv"
  56011. ><A
  56012. NAME="AEN10047"
  56013. ></A
  56014. >sizeof -- Alias fⁿr <A
  56015. HREF="#function.count"
  56016. ><B
  56017. CLASS="function"
  56018. >count()</B
  56019. ></A
  56020. ></DIV
  56021. ><DIV
  56022. CLASS="refsect1"
  56023. ><A
  56024. NAME="AEN10051"
  56025. ></A
  56026. ><H2
  56027. >Beschreibung</H2
  56028. ><P
  56029. >      Diese Funktion ist ein Alias fⁿr <A
  56030. HREF="#function.count"
  56031. ><B
  56032. CLASS="function"
  56033. >count()</B
  56034. ></A
  56035. >.
  56036.     </P
  56037. ></DIV
  56038. ><H1
  56039. ><A
  56040. NAME="function.sort"
  56041. ></A
  56042. >sort</H1
  56043. ><DIV
  56044. CLASS="refnamediv"
  56045. ><A
  56046. NAME="AEN10056"
  56047. ></A
  56048. ><P
  56049. >    (PHP 3, PHP 4 , PHP 5)</P
  56050. >sort -- Sortiert ein Array</DIV
  56051. ><DIV
  56052. CLASS="refsect1"
  56053. ><A
  56054. NAME="AEN10059"
  56055. ></A
  56056. ><H2
  56057. >Beschreibung</H2
  56058. >void <B
  56059. CLASS="methodname"
  56060. >sort</B
  56061. > ( array array [, int sort_flags])<BR
  56062. ></BR
  56063. ><P
  56064. >      Diese Funktion sortiert ein Array. Die Elemente werden
  56065.      aufsteigend vom niedrigsten zum h÷chsten Wert sortiert.
  56066.     </P
  56067. ><P
  56068. >      <TABLE
  56069. WIDTH="100%"
  56070. BORDER="0"
  56071. CELLPADDING="0"
  56072. CELLSPACING="0"
  56073. CLASS="EXAMPLE"
  56074. ><TR
  56075. ><TD
  56076. ><DIV
  56077. CLASS="example"
  56078. ><A
  56079. NAME="AEN10072"
  56080. ></A
  56081. ><P
  56082. ><B
  56083. >Beispiel 1. <B
  56084. CLASS="function"
  56085. >sort()</B
  56086. ></B
  56087. ></P
  56088. ><TABLE
  56089. BORDER="0"
  56090. BGCOLOR="#E0E0E0"
  56091. CELLPADDING="5"
  56092. ><TR
  56093. ><TD
  56094. ><PRE
  56095. CLASS="php"
  56096. ><?php
  56097.  
  56098. $fruits = array ("Zitrone", "Orange", "Banane", "Apfel");
  56099. sort ($fruits);
  56100. reset ($fruits);
  56101. while (list ($key, $val) = each ($fruits)) {
  56102.     echo "fruits[".$key."] = ".$val."\n";
  56103. }
  56104.  
  56105. ?></PRE
  56106. ></TD
  56107. ></TR
  56108. ></TABLE
  56109. ><P
  56110. >        Dieses Beispiel wⁿrde folgendes anzeigen:
  56111.       </P
  56112. ><TABLE
  56113. BORDER="0"
  56114. BGCOLOR="#E0E0E0"
  56115. CELLPADDING="5"
  56116. ><TR
  56117. ><TD
  56118. ><PRE
  56119. CLASS="screen"
  56120. >fruits[0] = Apfel
  56121. fruits[1] = Banane
  56122. fruits[2] = Orange
  56123. fruits[3] = Zitrone</PRE
  56124. ></TD
  56125. ></TR
  56126. ></TABLE
  56127. ></DIV
  56128. ></TD
  56129. ></TR
  56130. ></TABLE
  56131. >
  56132.     </P
  56133. ><P
  56134. >      Die Frⁿchte wurden in alphabetischer Reihenfolge sortiert.
  56135.     </P
  56136. ><P
  56137. >      Der optionale zweite Parameter <VAR
  56138. CLASS="parameter"
  56139. >sort_flags</VAR
  56140. >
  56141.      kann benutzt werden, um das Sortierverhalten mit den folgenden
  56142.      Flags zu beeinflussen.
  56143.     </P
  56144. ><P
  56145. >      Flags fⁿr Sortiertypen:
  56146.      <P
  56147. ></P
  56148. ><UL
  56149. ><LI
  56150. ><P
  56151. >SORT_REGULAR - Vergleiche EintrΣge normal</P
  56152. ></LI
  56153. ><LI
  56154. ><P
  56155. >SORT_NUMERIC - Vergleiche EintrΣge numerisch</P
  56156. ></LI
  56157. ><LI
  56158. ><P
  56159. >SORT_STRING - Vergleiche EintrΣge als Strings</P
  56160. ></LI
  56161. ></UL
  56162. >
  56163.     </P
  56164. ><DIV
  56165. CLASS="note"
  56166. ><BLOCKQUOTE
  56167. CLASS="note"
  56168. ><P
  56169. ><B
  56170. >Anmerkung: </B
  56171. >
  56172.       Der zweite Parameter wurde in PHP 4 eingefⁿhrt.
  56173.      </P
  56174. ></BLOCKQUOTE
  56175. ></DIV
  56176. ><P
  56177. >      Siehe auch <A
  56178. HREF="#function.arsort"
  56179. ><B
  56180. CLASS="function"
  56181. >arsort()</B
  56182. ></A
  56183. >,
  56184.      <A
  56185. HREF="#function.asort"
  56186. ><B
  56187. CLASS="function"
  56188. >asort()</B
  56189. ></A
  56190. >, <A
  56191. HREF="#function.ksort"
  56192. ><B
  56193. CLASS="function"
  56194. >ksort()</B
  56195. ></A
  56196. >,
  56197.      <A
  56198. HREF="#function.natsort"
  56199. ><B
  56200. CLASS="function"
  56201. >natsort()</B
  56202. ></A
  56203. >, <A
  56204. HREF="#function.natcasesort"
  56205. ><B
  56206. CLASS="function"
  56207. >natcasesort()</B
  56208. ></A
  56209. >,
  56210.      <A
  56211. HREF="#function.rsort"
  56212. ><B
  56213. CLASS="function"
  56214. >rsort()</B
  56215. ></A
  56216. >, <A
  56217. HREF="#function.usort"
  56218. ><B
  56219. CLASS="function"
  56220. >usort()</B
  56221. ></A
  56222. >,
  56223.      <A
  56224. HREF="#function.array-multisort"
  56225. ><B
  56226. CLASS="function"
  56227. >array_multisort()</B
  56228. ></A
  56229. > und
  56230.      <A
  56231. HREF="#function.uksort"
  56232. ><B
  56233. CLASS="function"
  56234. >uksort()</B
  56235. ></A
  56236. >.
  56237.     </P
  56238. ></DIV
  56239. ><H1
  56240. ><A
  56241. NAME="function.uasort"
  56242. ></A
  56243. >uasort</H1
  56244. ><DIV
  56245. CLASS="refnamediv"
  56246. ><A
  56247. NAME="AEN10102"
  56248. ></A
  56249. ><P
  56250. >    (PHP 3>= 3.0.4, PHP 4 , PHP 5)</P
  56251. >uasort -- 
  56252.      Sortiert ein Array mittels einer benutzerdefinierten
  56253.      Vergleichsfunktion und behΣlt Indexassoziationen bei.
  56254.     </DIV
  56255. ><DIV
  56256. CLASS="refsect1"
  56257. ><A
  56258. NAME="AEN10105"
  56259. ></A
  56260. ><H2
  56261. >Beschreibung</H2
  56262. >void <B
  56263. CLASS="methodname"
  56264. >uasort</B
  56265. > ( array array, callback cmp_function)<BR
  56266. ></BR
  56267. ><P
  56268. >      Diese Funktion sortiert ein Array so, dass die Beziehung der
  56269.      Indices zu den Arrayelementen beibehalten bleibt. Dies wird
  56270.      hauptsΣchlich bei assoziativen Arrays angewandt, wenn die
  56271.      aktuelle Reihenfolge der Arrayelemente signifikant ist. Die
  56272.      Vergleichsfunktion wird vom Benutzer definiert.
  56273.     </P
  56274. ><DIV
  56275. CLASS="note"
  56276. ><BLOCKQUOTE
  56277. CLASS="note"
  56278. ><P
  56279. ><B
  56280. >Anmerkung: </B
  56281. >
  56282.       Siehe <A
  56283. HREF="#function.usort"
  56284. ><B
  56285. CLASS="function"
  56286. >usort()</B
  56287. ></A
  56288. > und <A
  56289. HREF="#function.uksort"
  56290. ><B
  56291. CLASS="function"
  56292. >uksort()</B
  56293. ></A
  56294. >
  56295.       fⁿr Beispiele von benutzerdefinierten Vergleichsfunktionen
  56296.      </P
  56297. ></BLOCKQUOTE
  56298. ></DIV
  56299. ><P
  56300. >      Siehe auch <A
  56301. HREF="#function.usort"
  56302. ><B
  56303. CLASS="function"
  56304. >usort()</B
  56305. ></A
  56306. >, <A
  56307. HREF="#function.uksort"
  56308. ><B
  56309. CLASS="function"
  56310. >uksort()</B
  56311. ></A
  56312. >,
  56313.      <A
  56314. HREF="#function.sort"
  56315. ><B
  56316. CLASS="function"
  56317. >sort()</B
  56318. ></A
  56319. >, <A
  56320. HREF="#function.asort"
  56321. ><B
  56322. CLASS="function"
  56323. >asort()</B
  56324. ></A
  56325. >,
  56326.      <A
  56327. HREF="#function.arsort"
  56328. ><B
  56329. CLASS="function"
  56330. >arsort()</B
  56331. ></A
  56332. >, <A
  56333. HREF="#function.ksort"
  56334. ><B
  56335. CLASS="function"
  56336. >ksort()</B
  56337. ></A
  56338. >,
  56339.      und <A
  56340. HREF="#function.rsort"
  56341. ><B
  56342. CLASS="function"
  56343. >rsort()</B
  56344. ></A
  56345. >.
  56346.     </P
  56347. ></DIV
  56348. ><H1
  56349. ><A
  56350. NAME="function.uksort"
  56351. ></A
  56352. >uksort</H1
  56353. ><DIV
  56354. CLASS="refnamediv"
  56355. ><A
  56356. NAME="AEN10130"
  56357. ></A
  56358. ><P
  56359. >    (PHP 3>= 3.0.4, PHP 4 , PHP 5)</P
  56360. >uksort -- 
  56361.      Sortiert ein Array nach Schlⁿsseln mittels einer
  56362.      benutzerdefinierten Vergleichsfunktion.
  56363.     </DIV
  56364. ><DIV
  56365. CLASS="refsect1"
  56366. ><A
  56367. NAME="AEN10133"
  56368. ></A
  56369. ><H2
  56370. >Beschreibung</H2
  56371. >void <B
  56372. CLASS="methodname"
  56373. >uksort</B
  56374. > ( array array, callback cmp_function)<BR
  56375. ></BR
  56376. ><P
  56377. >      Diese Funktion sortiert die Schlⁿssel eines Arrays mittels einer
  56378.      benutzerdefinierten Vergleichsfunktion. Soll das Array nach nicht
  56379.      trivialen Kriterien sortiert werden, sollten Sie diese Funktion
  56380.      verwenden.
  56381.     </P
  56382. ><P
  56383. >      <TABLE
  56384. WIDTH="100%"
  56385. BORDER="0"
  56386. CELLPADDING="0"
  56387. CELLSPACING="0"
  56388. CLASS="EXAMPLE"
  56389. ><TR
  56390. ><TD
  56391. ><DIV
  56392. CLASS="example"
  56393. ><A
  56394. NAME="AEN10146"
  56395. ></A
  56396. ><P
  56397. ><B
  56398. >Beispiel 1. <B
  56399. CLASS="function"
  56400. >uksort()</B
  56401. ></B
  56402. ></P
  56403. ><TABLE
  56404. BORDER="0"
  56405. BGCOLOR="#E0E0E0"
  56406. CELLPADDING="5"
  56407. ><TR
  56408. ><TD
  56409. ><PRE
  56410. CLASS="php"
  56411. >function cmp ($a, $b) {
  56412.     if ($a == $b) return 0;
  56413.     return ($a > $b) ? -1 : 1;
  56414. }
  56415.  
  56416. $a = array (4 => "vier", 3 => "drei", 20 => "zwanzig", 10 => "zehn");
  56417.  
  56418. uksort ($a, "cmp");
  56419.  
  56420. while (list ($key, $value) = each ($a)) {
  56421.     echo "$key: $value\n";
  56422. }</PRE
  56423. ></TD
  56424. ></TR
  56425. ></TABLE
  56426. ><P
  56427. >        Dieses Beispiel wⁿrde folgendes ausgeben:
  56428.       </P
  56429. ><TABLE
  56430. BORDER="0"
  56431. BGCOLOR="#E0E0E0"
  56432. CELLPADDING="5"
  56433. ><TR
  56434. ><TD
  56435. ><PRE
  56436. CLASS="screen"
  56437. >20: zwanzig
  56438. 10: zehn
  56439. 4: vier
  56440. 3: drei</PRE
  56441. ></TD
  56442. ></TR
  56443. ></TABLE
  56444. ></DIV
  56445. ></TD
  56446. ></TR
  56447. ></TABLE
  56448. >
  56449.     </P
  56450. ><P
  56451. >      Siehe auch <A
  56452. HREF="#function.usort"
  56453. ><B
  56454. CLASS="function"
  56455. >usort()</B
  56456. ></A
  56457. >, <A
  56458. HREF="#function.uasort"
  56459. ><B
  56460. CLASS="function"
  56461. >uasort()</B
  56462. ></A
  56463. >,
  56464.      <A
  56465. HREF="#function.sort"
  56466. ><B
  56467. CLASS="function"
  56468. >sort()</B
  56469. ></A
  56470. >, <A
  56471. HREF="#function.asort"
  56472. ><B
  56473. CLASS="function"
  56474. >asort()</B
  56475. ></A
  56476. >,
  56477.      <A
  56478. HREF="#function.arsort"
  56479. ><B
  56480. CLASS="function"
  56481. >arsort()</B
  56482. ></A
  56483. >, <A
  56484. HREF="#function.ksort"
  56485. ><B
  56486. CLASS="function"
  56487. >ksort()</B
  56488. ></A
  56489. >,
  56490.      <A
  56491. HREF="#function.natsort"
  56492. ><B
  56493. CLASS="function"
  56494. >natsort()</B
  56495. ></A
  56496. > und <A
  56497. HREF="#function.rsort"
  56498. ><B
  56499. CLASS="function"
  56500. >rsort()</B
  56501. ></A
  56502. >.
  56503.     </P
  56504. ></DIV
  56505. ><H1
  56506. ><A
  56507. NAME="function.usort"
  56508. ></A
  56509. >usort</H1
  56510. ><DIV
  56511. CLASS="refnamediv"
  56512. ><A
  56513. NAME="AEN10162"
  56514. ></A
  56515. ><P
  56516. >    (PHP 3>= 3.0.3, PHP 4 , PHP 5)</P
  56517. >usort -- 
  56518.      Sortiert ein Array nach Werten mittels einer benutzerdefinierten
  56519.      Vergleichsfunktion.
  56520.     </DIV
  56521. ><DIV
  56522. CLASS="refsect1"
  56523. ><A
  56524. NAME="AEN10165"
  56525. ></A
  56526. ><H2
  56527. >Beschreibung</H2
  56528. >void <B
  56529. CLASS="methodname"
  56530. >usort</B
  56531. > ( array array, callback cmp_function)<BR
  56532. ></BR
  56533. ><P
  56534. >      Diese Funktion sortiert ein Array nach seinen Werten mittels
  56535.      einer benutzerdefinierten Vergleichsfunktion. Soll das Array nach
  56536.      nicht trivialen Kriterien sortiert werden, sollten Sie diese
  56537.      Funktion verwenden.
  56538.     </P
  56539. ><P
  56540. >      Die Vergleichsfunktion muss einen Integer zurⁿckgeben, der
  56541.      kleiner, gleich, oder gr÷▀er ist als <TT
  56542. CLASS="constant"
  56543. ><B
  56544. >NULL</B
  56545. ></TT
  56546. >, wenn fⁿr das erste
  56547.      Argument auch angenommen wird, dass es kleiner, gleich, oder
  56548.      gr÷▀er ist als das zweite. 
  56549.     </P
  56550. ><P
  56551. >      <DIV
  56552. CLASS="note"
  56553. ><BLOCKQUOTE
  56554. CLASS="note"
  56555. ><P
  56556. ><B
  56557. >Anmerkung: </B
  56558. >
  56559.        Sind zwei Elemente gleich, ist deren Reihenfolge nicht definiert. Bis zu
  56560.        PHP 4.0.6 wⁿrde die benutzerdefinierte Funktion die originΣre Reihenfolge
  56561.        beibehalten, doch seit der Einfⁿhrung des neuen Sortieralgorhythmus mit
  56562.        4.1.0 ist dies nicht mehr der Fall, da es keine effiziente L÷sung dafⁿr
  56563.        gibt.
  56564.       </P
  56565. ></BLOCKQUOTE
  56566. ></DIV
  56567. >
  56568.     </P
  56569. ><P
  56570. >      <TABLE
  56571. WIDTH="100%"
  56572. BORDER="0"
  56573. CELLPADDING="0"
  56574. CELLSPACING="0"
  56575. CLASS="EXAMPLE"
  56576. ><TR
  56577. ><TD
  56578. ><DIV
  56579. CLASS="example"
  56580. ><A
  56581. NAME="AEN10183"
  56582. ></A
  56583. ><P
  56584. ><B
  56585. >Beispiel 1. <B
  56586. CLASS="function"
  56587. >usort()</B
  56588. ></B
  56589. ></P
  56590. ><TABLE
  56591. BORDER="0"
  56592. BGCOLOR="#E0E0E0"
  56593. CELLPADDING="5"
  56594. ><TR
  56595. ><TD
  56596. ><PRE
  56597. CLASS="php"
  56598. ><?php
  56599. function cmp ($a, $b) {
  56600.     if ($a == $b) return 0;
  56601.     return ($a < $b) ? -1 : 1;
  56602. }
  56603.  
  56604. $a = array (3, 2, 5, 6, 1);
  56605.  
  56606. usort ($a, "cmp");
  56607.  
  56608. while (list ($key, $value) = each ($a)) {
  56609.     echo "$key: $value\n";
  56610. }
  56611. ?></PRE
  56612. ></TD
  56613. ></TR
  56614. ></TABLE
  56615. ><P
  56616. >        Dieses Beispiel wⁿrde folgendes anzeigen:
  56617.       </P
  56618. ><TABLE
  56619. BORDER="0"
  56620. BGCOLOR="#E0E0E0"
  56621. CELLPADDING="5"
  56622. ><TR
  56623. ><TD
  56624. ><PRE
  56625. CLASS="screen"
  56626. >0: 1
  56627. 1: 2
  56628. 2: 3
  56629. 3: 5
  56630. 4: 6</PRE
  56631. ></TD
  56632. ></TR
  56633. ></TABLE
  56634. ></DIV
  56635. ></TD
  56636. ></TR
  56637. ></TABLE
  56638. >
  56639.     </P
  56640. ><DIV
  56641. CLASS="note"
  56642. ><BLOCKQUOTE
  56643. CLASS="note"
  56644. ><P
  56645. ><B
  56646. >Anmerkung: </B
  56647. >
  56648.       Offensichtlich wⁿrde <A
  56649. HREF="#function.sort"
  56650. ><B
  56651. CLASS="function"
  56652. >sort()</B
  56653. ></A
  56654. > fⁿr diesen
  56655.       einfachen Fall besser passen.
  56656.      </P
  56657. ></BLOCKQUOTE
  56658. ></DIV
  56659. ><P
  56660. >      <TABLE
  56661. WIDTH="100%"
  56662. BORDER="0"
  56663. CELLPADDING="0"
  56664. CELLSPACING="0"
  56665. CLASS="EXAMPLE"
  56666. ><TR
  56667. ><TD
  56668. ><DIV
  56669. CLASS="example"
  56670. ><A
  56671. NAME="AEN10193"
  56672. ></A
  56673. ><P
  56674. ><B
  56675. >Beispiel 2. 
  56676.        <B
  56677. CLASS="function"
  56678. >usort()</B
  56679. > mit einem mehrdimensionalen Array
  56680.       </B
  56681. ></P
  56682. ><TABLE
  56683. BORDER="0"
  56684. BGCOLOR="#E0E0E0"
  56685. CELLPADDING="5"
  56686. ><TR
  56687. ><TD
  56688. ><PRE
  56689. CLASS="php"
  56690. ><?php
  56691. function cmp ($a, $b) {
  56692.     return strcmp($a["fruit"], $b["fruit"]);
  56693. }
  56694.  
  56695. $fruits[0]["fruit"] = "Zitronen";
  56696. $fruits[1]["fruit"] = "─pfel";
  56697. $fruits[2]["fruit"] = "Trauben";
  56698.  
  56699. usort($fruits, "cmp");
  56700.  
  56701. while (list ($key, $value) = each ($fruits)) {
  56702.     echo "\$fruits[$key]: " . $value["fruit"] . "\n";
  56703. }
  56704. ?></PRE
  56705. ></TD
  56706. ></TR
  56707. ></TABLE
  56708. ><P
  56709. >        Wird ein mehrdimensionales Array sortiert, enthalten $a und $b
  56710.        Referenzen zu dem ersten Index des Arrays.
  56711.       </P
  56712. ><P
  56713. >        Dieses Beispiel wⁿrde folgendes anzeigen:
  56714.       </P
  56715. ><TABLE
  56716. BORDER="0"
  56717. BGCOLOR="#E0E0E0"
  56718. CELLPADDING="5"
  56719. ><TR
  56720. ><TD
  56721. ><PRE
  56722. CLASS="screen"
  56723. >$fruits[0]: ─pfel
  56724. $fruits[1]: Trauben
  56725. $fruits[2]: Zitronen</PRE
  56726. ></TD
  56727. ></TR
  56728. ></TABLE
  56729. ></DIV
  56730. ></TD
  56731. ></TR
  56732. ></TABLE
  56733. >
  56734.     </P
  56735. ><P
  56736. >      <TABLE
  56737. WIDTH="100%"
  56738. BORDER="0"
  56739. CELLPADDING="0"
  56740. CELLSPACING="0"
  56741. CLASS="EXAMPLE"
  56742. ><TR
  56743. ><TD
  56744. ><DIV
  56745. CLASS="example"
  56746. ><A
  56747. NAME="AEN10201"
  56748. ></A
  56749. ><P
  56750. ><B
  56751. >Beispiel 3. 
  56752.        <B
  56753. CLASS="function"
  56754. >usort()</B
  56755. > mit Verwendung einer Member Funktion eines Objektes
  56756.       </B
  56757. ></P
  56758. ><TABLE
  56759. BORDER="0"
  56760. BGCOLOR="#E0E0E0"
  56761. CELLPADDING="5"
  56762. ><TR
  56763. ><TD
  56764. ><PRE
  56765. CLASS="php"
  56766. ><?php
  56767. class TestObj {
  56768.     var $name;
  56769.  
  56770.     function TestObj($name)
  56771.     {
  56772.         $this->name = $name;
  56773.     }
  56774.  
  56775.     /* Dies ist die statische Vergleichsfunktion: */
  56776.     function cmp_obj($a, $b)
  56777.     {
  56778.         $al = strtolower($a->name);
  56779.         $bl = strtolower($b->name);
  56780.         if ($al == $bl) return 0;
  56781.         return ($al > $bl) ? +1 : -1;
  56782.     }
  56783. }
  56784.  
  56785. $a[] = new TestObj("c");
  56786. $a[] = new TestObj("b");
  56787. $a[] = new TestObj("d");
  56788.  
  56789. uasort($a, array ("TestObj", "cmp_obj"));
  56790.  
  56791. foreach ($a as $item) {
  56792.     print $item->name."\n";
  56793. }
  56794. ?></PRE
  56795. ></TD
  56796. ></TR
  56797. ></TABLE
  56798. ><P
  56799. >        Dieses Beispiel wⁿrde folgendes anzeigen:
  56800.       </P
  56801. ><TABLE
  56802. BORDER="0"
  56803. BGCOLOR="#E0E0E0"
  56804. CELLPADDING="5"
  56805. ><TR
  56806. ><TD
  56807. ><PRE
  56808. CLASS="screen"
  56809. >b
  56810. c
  56811. d</PRE
  56812. ></TD
  56813. ></TR
  56814. ></TABLE
  56815. ></DIV
  56816. ></TD
  56817. ></TR
  56818. ></TABLE
  56819. >
  56820.     </P
  56821. ><P
  56822. >      Siehe auch <A
  56823. HREF="#function.uasort"
  56824. ><B
  56825. CLASS="function"
  56826. >uasort()</B
  56827. ></A
  56828. >,
  56829.      <A
  56830. HREF="#function.uksort"
  56831. ><B
  56832. CLASS="function"
  56833. >uksort()</B
  56834. ></A
  56835. >, <A
  56836. HREF="#function.sort"
  56837. ><B
  56838. CLASS="function"
  56839. >sort()</B
  56840. ></A
  56841. >,
  56842.      <A
  56843. HREF="#function.asort"
  56844. ><B
  56845. CLASS="function"
  56846. >asort()</B
  56847. ></A
  56848. >,
  56849.      <A
  56850. HREF="#function.arsort"
  56851. ><B
  56852. CLASS="function"
  56853. >arsort()</B
  56854. ></A
  56855. >,<A
  56856. HREF="#function.ksort"
  56857. ><B
  56858. CLASS="function"
  56859. >ksort()</B
  56860. ></A
  56861. >,
  56862.      <A
  56863. HREF="#function.natsort"
  56864. ><B
  56865. CLASS="function"
  56866. >natsort()</B
  56867. ></A
  56868. > und <A
  56869. HREF="#function.rsort"
  56870. ><B
  56871. CLASS="function"
  56872. >rsort()</B
  56873. ></A
  56874. >.
  56875.     </P
  56876. ></DIV
  56877. ></DIV
  56878. ><DIV
  56879. CLASS="reference"
  56880. ><A
  56881. NAME="ref.aspell"
  56882. ></A
  56883. ><DIV
  56884. CLASS="TITLEPAGE"
  56885. ><H1
  56886. CLASS="title"
  56887. >III. Aspell Funktionen [veraltet]</H1
  56888. ><DIV
  56889. CLASS="PARTINTRO"
  56890. ><A
  56891. NAME="AEN10219"
  56892. ></A
  56893. ><DIV
  56894. CLASS="section"
  56895. ><H2
  56896. CLASS="section"
  56897. ><A
  56898. NAME="aspell.intro"
  56899. >Einfⁿhrung</A
  56900. ></H2
  56901. ><P
  56902. >     Die <B
  56903. CLASS="function"
  56904. >aspell()</B
  56905. > Funktionen erlauben es ein Wort
  56906.     auf korrekte Rechtschreibung zu prⁿfen und Alternativen
  56907.     anzubieten.
  56908.    </P
  56909. ><DIV
  56910. CLASS="note"
  56911. ><BLOCKQUOTE
  56912. CLASS="note"
  56913. ><P
  56914. ><B
  56915. >Anmerkung: </B
  56916. >
  56917.      Diese Erweiterung wurde aus <VAR
  56918. CLASS="literal"
  56919. >PHP</VAR
  56920. > entfernt und steht seit
  56921.      der Version 4.3.0 nicht mehr zur Verfⁿgung. Falls Sie eine
  56922.      Rechtschreibprⁿfung mit PHP benutzen wollen, verwenden Sie statt dessen die
  56923.      <A
  56924. HREF="#ref.pspell"
  56925. >Pspell Funktionen</A
  56926. >. Diese nutzen die Pspell
  56927.      Bibliothek und arbeiten mit neueren Versionen von Aspell zusammen.
  56928.     </P
  56929. ></BLOCKQUOTE
  56930. ></DIV
  56931. ></DIV
  56932. ><DIV
  56933. CLASS="section"
  56934. ><HR><H2
  56935. CLASS="section"
  56936. ><A
  56937. NAME="aspell.requirements"
  56938. >Anforderungen</A
  56939. ></H2
  56940. ><P
  56941. >      Aspell arbeitet nur mit ziemlich alten (bis .27.* oder so) Versionen der
  56942.      Aspell Bibliothek zusammen. Weder dieses Modul noch jene Versionen der
  56943.      Aspell Bibliothek werden nicht mehr lΣnger unterstⁿtzt.Sie ben÷tigen die
  56944.      aspell-Bibliothek von: <A
  56945. HREF="http://aspell.sourceforge.net/"
  56946. TARGET="_top"
  56947. >http://aspell.sourceforge.net/</A
  56948. >.
  56949.     </P
  56950. ></DIV
  56951. ><DIV
  56952. CLASS="section"
  56953. ><HR><H2
  56954. CLASS="section"
  56955. ><A
  56956. NAME="aspell.installation"
  56957. >Installation</A
  56958. ></H2
  56959. ><P
  56960. >   Diese Funktionen stehen nur zur Verfⁿgung, wenn Sie <VAR
  56961. CLASS="literal"
  56962. >PHP</VAR
  56963. >
  56964.   mit der Option <VAR
  56965. CLASS="option"
  56966. >--with-aspell=[DIR]</VAR
  56967. >
  56968.   konfiguriert haben.
  56969.  </P
  56970. ></DIV
  56971. ><DIV
  56972. CLASS="section"
  56973. ><HR><H2
  56974. CLASS="section"
  56975. ><A
  56976. NAME="aspell.seealso"
  56977. >Siehe auch</A
  56978. ></H2
  56979. ><P
  56980. >      Siehe auch <A
  56981. HREF="#ref.pspell"
  56982. >pspell</A
  56983. >.
  56984.     </P
  56985. ></DIV
  56986. ></DIV
  56987. ><DIV
  56988. CLASS="TOC"
  56989. ><DL
  56990. ><DT
  56991. ><B
  56992. >Inhaltsverzeichnis</B
  56993. ></DT
  56994. ><DT
  56995. ><A
  56996. HREF="#function.aspell-check-raw"
  56997. >aspell_check-raw</A
  56998. > -- 
  56999.      ▄berprⁿft ein Wort genauso wie es ⁿbergeben wird [veraltet]
  57000.     </DT
  57001. ><DT
  57002. ><A
  57003. HREF="#function.aspell-check"
  57004. >aspell_check</A
  57005. > -- ▄berprⁿft ein Wort [veraltet]</DT
  57006. ><DT
  57007. ><A
  57008. HREF="#function.aspell-new"
  57009. >aspell_new</A
  57010. > -- LΣdt ein neues W÷rterbuch [veraltet]</DT
  57011. ><DT
  57012. ><A
  57013. HREF="#function.aspell-suggest"
  57014. >aspell_suggest</A
  57015. > -- SchlΣgt m÷gliche Schreibweisen vor [veraltet]</DT
  57016. ></DL
  57017. ></DIV
  57018. ></DIV
  57019. ><H1
  57020. ><A
  57021. NAME="function.aspell-check-raw"
  57022. ></A
  57023. >aspell_check-raw</H1
  57024. ><DIV
  57025. CLASS="refnamediv"
  57026. ><A
  57027. NAME="AEN10242"
  57028. ></A
  57029. ><P
  57030. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  57031. >aspell_check-raw -- 
  57032.      ▄berprⁿft ein Wort genauso wie es ⁿbergeben wird [veraltet]
  57033.     </DIV
  57034. ><DIV
  57035. CLASS="refsect1"
  57036. ><A
  57037. NAME="AEN10245"
  57038. ></A
  57039. ><H2
  57040. >Beschreibung</H2
  57041. >boolean <B
  57042. CLASS="methodname"
  57043. >aspell_check_raw</B
  57044. > ( int W÷rterbuchkennung, string Wort)<BR
  57045. ></BR
  57046. ><P
  57047. >      <A
  57048. HREF="#function.aspell-check-raw"
  57049. ><B
  57050. CLASS="function"
  57051. >aspell_check_raw()</B
  57052. ></A
  57053. > ⁿberprⁿft die
  57054.      Rechtschreibung eines Wortes ohne die Gro▀/Kleinschreibung zu
  57055.      variieren oder das Wort in irgendeiner Weise zu kⁿrzen. Liefert
  57056.      <TT
  57057. CLASS="constant"
  57058. ><B
  57059. >TRUE</B
  57060. ></TT
  57061. >, wenn das Wort korrekt ist und sonst <TT
  57062. CLASS="constant"
  57063. ><B
  57064. >FALSE</B
  57065. ></TT
  57066. >.
  57067.     </P
  57068. ><P
  57069. >      <TABLE
  57070. WIDTH="100%"
  57071. BORDER="0"
  57072. CELLPADDING="0"
  57073. CELLSPACING="0"
  57074. CLASS="EXAMPLE"
  57075. ><TR
  57076. ><TD
  57077. ><DIV
  57078. CLASS="example"
  57079. ><A
  57080. NAME="AEN10261"
  57081. ></A
  57082. ><P
  57083. ><B
  57084. >Beispiel 1. <A
  57085. HREF="#function.aspell-check-raw"
  57086. ><B
  57087. CLASS="function"
  57088. >aspell_check_raw()</B
  57089. ></A
  57090. ></B
  57091. ></P
  57092. ><TABLE
  57093. BORDER="0"
  57094. BGCOLOR="#E0E0E0"
  57095. CELLPADDING="5"
  57096. ><TR
  57097. ><TD
  57098. ><PRE
  57099. CLASS="php"
  57100. ><?php
  57101. $aspell_link = aspell_new("english");
  57102.  
  57103. if (aspell_check_raw($aspell_link, "test")) {
  57104.     echo "Gⁿltige Schreibweise";
  57105. } else {
  57106.     echo "Bedaure, falsche Schreibweise";
  57107. }
  57108. ?></PRE
  57109. ></TD
  57110. ></TR
  57111. ></TABLE
  57112. ></DIV
  57113. ></TD
  57114. ></TR
  57115. ></TABLE
  57116. >
  57117.     </P
  57118. ></DIV
  57119. ><H1
  57120. ><A
  57121. NAME="function.aspell-check"
  57122. ></A
  57123. >aspell_check</H1
  57124. ><DIV
  57125. CLASS="refnamediv"
  57126. ><A
  57127. NAME="AEN10266"
  57128. ></A
  57129. ><P
  57130. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  57131. >aspell_check -- ▄berprⁿft ein Wort [veraltet]</DIV
  57132. ><DIV
  57133. CLASS="refsect1"
  57134. ><A
  57135. NAME="AEN10269"
  57136. ></A
  57137. ><H2
  57138. >Beschreibung</H2
  57139. >boolean <B
  57140. CLASS="methodname"
  57141. >aspell_check</B
  57142. > ( int W÷rterbuchkennung, string Wort)<BR
  57143. ></BR
  57144. ><P
  57145. >      <B
  57146. CLASS="function"
  57147. >aspell_check()</B
  57148. > ⁿberprⁿft die Rechtschreibung
  57149.      eines Wortes und liefert <TT
  57150. CLASS="constant"
  57151. ><B
  57152. >TRUE</B
  57153. ></TT
  57154. >, wenn das Wort korrekt ist,
  57155.      ansonsten <TT
  57156. CLASS="constant"
  57157. ><B
  57158. >FALSE</B
  57159. ></TT
  57160. >.
  57161.     </P
  57162. ><P
  57163. >      <TABLE
  57164. WIDTH="100%"
  57165. BORDER="0"
  57166. CELLPADDING="0"
  57167. CELLSPACING="0"
  57168. CLASS="EXAMPLE"
  57169. ><TR
  57170. ><TD
  57171. ><DIV
  57172. CLASS="example"
  57173. ><A
  57174. NAME="AEN10285"
  57175. ></A
  57176. ><P
  57177. ><B
  57178. >Beispiel 1. aspell_check</B
  57179. ></P
  57180. ><TABLE
  57181. BORDER="0"
  57182. BGCOLOR="#E0E0E0"
  57183. CELLPADDING="5"
  57184. ><TR
  57185. ><TD
  57186. ><PRE
  57187. CLASS="php"
  57188. ><?php
  57189. $aspell_link = aspell_new("english");
  57190.  
  57191. if (aspell_check($aspell_link, "testt")) {
  57192.     echo "Gⁿltige Schreibweise";
  57193. } else {
  57194.     echo "Bedaure, falsche Schreibweise";
  57195. }
  57196. ?></PRE
  57197. ></TD
  57198. ></TR
  57199. ></TABLE
  57200. ></DIV
  57201. ></TD
  57202. ></TR
  57203. ></TABLE
  57204. >
  57205.     </P
  57206. ></DIV
  57207. ><H1
  57208. ><A
  57209. NAME="function.aspell-new"
  57210. ></A
  57211. >aspell_new</H1
  57212. ><DIV
  57213. CLASS="refnamediv"
  57214. ><A
  57215. NAME="AEN10289"
  57216. ></A
  57217. ><P
  57218. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  57219. >aspell_new -- LΣdt ein neues W÷rterbuch [veraltet]</DIV
  57220. ><DIV
  57221. CLASS="refsect1"
  57222. ><A
  57223. NAME="AEN10292"
  57224. ></A
  57225. ><H2
  57226. >Beschreibung</H2
  57227. >int <B
  57228. CLASS="methodname"
  57229. >aspell_new</B
  57230. > ( string master, string personal)<BR
  57231. ></BR
  57232. ><P
  57233. >      <B
  57234. CLASS="function"
  57235. >aspell_new()</B
  57236. > ÷ffnet ein neues W÷rterbuch und
  57237.      liefert eine W÷rterbuchkennung zurⁿck, die von anderen
  57238.      aspell-Funktionen gebraucht wird. Liefert <TT
  57239. CLASS="constant"
  57240. ><B
  57241. >FALSE</B
  57242. ></TT
  57243. > bei einem Fehler.
  57244.     </P
  57245. ><P
  57246. >      <TABLE
  57247. WIDTH="100%"
  57248. BORDER="0"
  57249. CELLPADDING="0"
  57250. CELLSPACING="0"
  57251. CLASS="EXAMPLE"
  57252. ><TR
  57253. ><TD
  57254. ><DIV
  57255. CLASS="example"
  57256. ><A
  57257. NAME="AEN10307"
  57258. ></A
  57259. ><P
  57260. ><B
  57261. >Beispiel 1. aspell_new</B
  57262. ></P
  57263. ><TABLE
  57264. BORDER="0"
  57265. BGCOLOR="#E0E0E0"
  57266. CELLPADDING="5"
  57267. ><TR
  57268. ><TD
  57269. ><PRE
  57270. CLASS="php"
  57271. ><?php
  57272. $aspell_link = aspell_new("english");
  57273. ?></PRE
  57274. ></TD
  57275. ></TR
  57276. ></TABLE
  57277. ></DIV
  57278. ></TD
  57279. ></TR
  57280. ></TABLE
  57281. >
  57282.     </P
  57283. ></DIV
  57284. ><H1
  57285. ><A
  57286. NAME="function.aspell-suggest"
  57287. ></A
  57288. >aspell_suggest</H1
  57289. ><DIV
  57290. CLASS="refnamediv"
  57291. ><A
  57292. NAME="AEN10311"
  57293. ></A
  57294. ><P
  57295. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  57296. >aspell_suggest -- SchlΣgt m÷gliche Schreibweisen vor [veraltet]</DIV
  57297. ><DIV
  57298. CLASS="refsect1"
  57299. ><A
  57300. NAME="AEN10314"
  57301. ></A
  57302. ><H2
  57303. >Beschreibung</H2
  57304. >array <B
  57305. CLASS="methodname"
  57306. >aspell_suggest</B
  57307. > ( int W÷rterbuchkennung, string Wort)<BR
  57308. ></BR
  57309. ><P
  57310. >      <B
  57311. CLASS="function"
  57312. >aspell_suggest()</B
  57313. > liefert ein Array mit
  57314.      m÷glichen Schreibweisen eines ⁿbergebenen Wortes.
  57315.     </P
  57316. ><P
  57317. >      <TABLE
  57318. WIDTH="100%"
  57319. BORDER="0"
  57320. CELLPADDING="0"
  57321. CELLSPACING="0"
  57322. CLASS="EXAMPLE"
  57323. ><TR
  57324. ><TD
  57325. ><DIV
  57326. CLASS="example"
  57327. ><A
  57328. NAME="AEN10328"
  57329. ></A
  57330. ><P
  57331. ><B
  57332. >Beispiel 1. <B
  57333. CLASS="function"
  57334. >aspell_suggest()</B
  57335. ></B
  57336. ></P
  57337. ><TABLE
  57338. BORDER="0"
  57339. BGCOLOR="#E0E0E0"
  57340. CELLPADDING="5"
  57341. ><TR
  57342. ><TD
  57343. ><PRE
  57344. CLASS="php"
  57345. ><?php
  57346. $aspell_link = aspell_new("english");
  57347.  
  57348. if (!aspell_check($aspell_link, "test")) {
  57349.     $suggestions = aspell_suggest($aspell_link, "test");
  57350.  
  57351.     foreach ($suggestions as $suggestion) {
  57352.         echo "M÷gliche Schreibweisen: $suggestion<br />\n";
  57353.     }
  57354. }
  57355. ?></PRE
  57356. ></TD
  57357. ></TR
  57358. ></TABLE
  57359. ></DIV
  57360. ></TD
  57361. ></TR
  57362. ></TABLE
  57363. >
  57364.     </P
  57365. ></DIV
  57366. ></DIV
  57367. ><DIV
  57368. CLASS="reference"
  57369. ><A
  57370. NAME="ref.bc"
  57371. ></A
  57372. ><DIV
  57373. CLASS="TITLEPAGE"
  57374. ><H1
  57375. CLASS="title"
  57376. >IV. Mathematische Funktionen mit beliebiger Genauigkeit</H1
  57377. ><DIV
  57378. CLASS="PARTINTRO"
  57379. ><A
  57380. NAME="AEN10335"
  57381. ></A
  57382. ><DIV
  57383. CLASS="section"
  57384. ><H2
  57385. CLASS="section"
  57386. ><A
  57387. NAME="bc.intro"
  57388. >Einfⁿhrung</A
  57389. ></H2
  57390. ><P
  57391. >     Fⁿr beliebig genaue mathematische Operationen bietet PHP den Binary Calculator.
  57392.     Unterstⁿtzt werden Zahlen beliebiger LΣnge und Genauigkeit, die als String vorliegen.
  57393.    </P
  57394. ></DIV
  57395. ><DIV
  57396. CLASS="section"
  57397. ><HR><H2
  57398. CLASS="section"
  57399. ><A
  57400. NAME="bc.requirements"
  57401. >Anforderungen</A
  57402. ></H2
  57403. ><P
  57404. >      Seit PHP 4.0.4 ist libbcmath in PHP enthalten. Sie brauchen keine
  57405.      externen Bibliotheken fⁿr diese Erweiterung.
  57406.     </P
  57407. ></DIV
  57408. ><DIV
  57409. CLASS="section"
  57410. ><HR><H2
  57411. CLASS="section"
  57412. ><A
  57413. NAME="bc.installation"
  57414. >Installation</A
  57415. ></H2
  57416. ><P
  57417. >   In PHP 4 sind diese Funktionen nur verfⁿgbar, wenn <VAR
  57418. CLASS="literal"
  57419. >PHP</VAR
  57420. >
  57421.   mit <VAR
  57422. CLASS="option"
  57423. >--enable-bcmath</VAR
  57424. > konfiguriert wurde.
  57425.   In PHP 3 sind diese Funktionen nur verfⁿgbar, wenn <VAR
  57426. CLASS="literal"
  57427. >PHP</VAR
  57428. >
  57429.   nicht mit <VAR
  57430. CLASS="option"
  57431. >--disable-bcmath</VAR
  57432. > konfiguriert
  57433.   wurde.
  57434.  </P
  57435. ><P
  57436. >Die Windowsversion von PHP enthΣlt diese
  57437. Erweiterung. Um diese Funktionen zu verwenden, mⁿssen Sie keine zusΣtzlichen
  57438. Erweiterungen aktivieren.</P
  57439. ></DIV
  57440. ><DIV
  57441. CLASS="section"
  57442. ><HR><H2
  57443. CLASS="section"
  57444. ><A
  57445. NAME="bc.configuration"
  57446. >Laufzeit Konfiguration</A
  57447. ></H2
  57448. ><P
  57449. > Das Verhalten dieser Funktionen wird
  57450. durch Einstellungen in der <TT
  57451. CLASS="filename"
  57452. >php.ini</TT
  57453. > beeinflusst.</P
  57454. ><P
  57455. >  <DIV
  57456. CLASS="table"
  57457. ><A
  57458. NAME="AEN10355"
  57459. ></A
  57460. ><P
  57461. ><B
  57462. >Tabelle 1. BC math Konfigurations-Optionen</B
  57463. ></P
  57464. ><TABLE
  57465. BORDER="1"
  57466. CLASS="CALSTABLE"
  57467. ><COL><COL><COL><THEAD
  57468. ><TR
  57469. ><TH
  57470. >Name</TH
  57471. ><TH
  57472. >Standard</TH
  57473. ><TH
  57474. >VerΣnderbar</TH
  57475. ></TR
  57476. ></THEAD
  57477. ><TBODY
  57478. ><TR
  57479. ><TD
  57480. >bcmath.scale</TD
  57481. ><TD
  57482. >0</TD
  57483. ><TD
  57484. >PHP_INI_ALL</TD
  57485. ></TR
  57486. ></TBODY
  57487. ></TABLE
  57488. ></DIV
  57489. >
  57490.   Weitere Details und die Definition der PHP_INI_* Konstanten sind unter
  57491.   <A
  57492. HREF="#function.ini-set"
  57493. ><B
  57494. CLASS="function"
  57495. >ini_set()</B
  57496. ></A
  57497. > zu finden.
  57498.  </P
  57499. ><P
  57500. >Hier eine kurze ErklΣrung der
  57501. Konfigurationsoptionen:</P
  57502. ><P
  57503. >   <P
  57504. ></P
  57505. ><DIV
  57506. CLASS="variablelist"
  57507. ><DL
  57508. ><DT
  57509. ><A
  57510. NAME="ini.bcmath.scale"
  57511. ></A
  57512. ><VAR
  57513. CLASS="parameter"
  57514. >bcmath.scale</VAR
  57515. >
  57516.      <A
  57517. HREF="#language.types.integer"
  57518. ><B
  57519. CLASS="type"
  57520. >integer</B
  57521. ></A
  57522. ></DT
  57523. ><DD
  57524. ><P
  57525. >       Anzahl der Dezimalstellen fⁿr alle bcmath Funktionen. Siehe auch
  57526.       <A
  57527. HREF="#function.bcscale"
  57528. ><B
  57529. CLASS="function"
  57530. >bcscale()</B
  57531. ></A
  57532. >.
  57533.      </P
  57534. ></DD
  57535. ></DL
  57536. ></DIV
  57537. >
  57538.  </P
  57539. ></DIV
  57540. ><DIV
  57541. CLASS="section"
  57542. ><HR><H2
  57543. CLASS="section"
  57544. ><A
  57545. NAME="bc.resources"
  57546. >Resource Typen</A
  57547. ></H2
  57548. ><P
  57549. >Diese Erweiterung definiert keine Resource-Typen.</P
  57550. ></DIV
  57551. ><DIV
  57552. CLASS="section"
  57553. ><HR><H2
  57554. CLASS="section"
  57555. ><A
  57556. NAME="bc.constants"
  57557. >Vordefinierte Konstanten</A
  57558. ></H2
  57559. ><P
  57560. >Diese Erweiterung definiert keine Konstanten.</P
  57561. ></DIV
  57562. ></DIV
  57563. ><DIV
  57564. CLASS="TOC"
  57565. ><DL
  57566. ><DT
  57567. ><B
  57568. >Inhaltsverzeichnis</B
  57569. ></DT
  57570. ><DT
  57571. ><A
  57572. HREF="#function.bcadd"
  57573. >bcadd</A
  57574. > -- Addition zweier Zahlen beliebiger Genauigkeit.</DT
  57575. ><DT
  57576. ><A
  57577. HREF="#function.bccomp"
  57578. >bccomp</A
  57579. > -- 
  57580.      Vergleich zweier Zahlen beliebiger Genauigkeit.
  57581.     </DT
  57582. ><DT
  57583. ><A
  57584. HREF="#function.bcdiv"
  57585. >bcdiv</A
  57586. > -- Division zweier Zahlen beliebiger Genauigkeit.</DT
  57587. ><DT
  57588. ><A
  57589. HREF="#function.bcmod"
  57590. >bcmod</A
  57591. > -- 
  57592.      Modulo zweier Zahlen mit beliebiger Genauigkeit.
  57593.     </DT
  57594. ><DT
  57595. ><A
  57596. HREF="#function.bcmul"
  57597. >bcmul</A
  57598. > -- 
  57599.      Multiplikation zweier Zahlen beliebiger Genauigkeit.
  57600.     </DT
  57601. ><DT
  57602. ><A
  57603. HREF="#function.bcpow"
  57604. >bcpow</A
  57605. > -- 
  57606.      Potenz mit beliebiger Genauigkeit.
  57607.     </DT
  57608. ><DT
  57609. ><A
  57610. HREF="#function.bcpowmod"
  57611. >bcpowmod</A
  57612. > -- 
  57613.      Raise an arbitrary precision number to another, reduced by a specified modulus.
  57614.     </DT
  57615. ><DT
  57616. ><A
  57617. HREF="#function.bcscale"
  57618. >bcscale</A
  57619. > -- 
  57620.      Setzt die Genauigkeit aller BC math-Funktionen.
  57621.     </DT
  57622. ><DT
  57623. ><A
  57624. HREF="#function.bcsqrt"
  57625. >bcsqrt</A
  57626. > -- 
  57627.      Quadratwurzel mit beliebiger Genauigkeit.
  57628.     </DT
  57629. ><DT
  57630. ><A
  57631. HREF="#function.bcsub"
  57632. >bcsub</A
  57633. > -- 
  57634.      Subtrahiert zwei Zahlen mit beliebiger Genauigkeit.
  57635.     </DT
  57636. ></DL
  57637. ></DIV
  57638. ></DIV
  57639. ><H1
  57640. ><A
  57641. NAME="function.bcadd"
  57642. ></A
  57643. >bcadd</H1
  57644. ><DIV
  57645. CLASS="refnamediv"
  57646. ><A
  57647. NAME="AEN10386"
  57648. ></A
  57649. ><P
  57650. >    (PHP 3, PHP 4 , PHP 5)</P
  57651. >bcadd -- Addition zweier Zahlen beliebiger Genauigkeit.</DIV
  57652. ><DIV
  57653. CLASS="refsect1"
  57654. ><A
  57655. NAME="AEN10389"
  57656. ></A
  57657. ><H2
  57658. >Beschreibung</H2
  57659. >string <B
  57660. CLASS="methodname"
  57661. >bcadd</B
  57662. > ( string linker Operand, string rechter Operand [, int Genauigkeit])<BR
  57663. ></BR
  57664. ><P
  57665. >      Addiert den <VAR
  57666. CLASS="parameter"
  57667. >linken Operanden</VAR
  57668. > zu dem
  57669.      <VAR
  57670. CLASS="parameter"
  57671. >rechten Operanden</VAR
  57672. > und liefert die Summe
  57673.      als Zeichenkette. Der optionale Parameter
  57674.      <VAR
  57675. CLASS="parameter"
  57676. >Genauigkeit</VAR
  57677. > kann angegeben werden, um die Anzahl
  57678.      der Nachkommastellen im Ergebnis zu bestimmen.
  57679.     </P
  57680. ><P
  57681. >      <TABLE
  57682. WIDTH="100%"
  57683. BORDER="0"
  57684. CELLPADDING="0"
  57685. CELLSPACING="0"
  57686. CLASS="EXAMPLE"
  57687. ><TR
  57688. ><TD
  57689. ><DIV
  57690. CLASS="example"
  57691. ><A
  57692. NAME="AEN10408"
  57693. ></A
  57694. ><P
  57695. ><B
  57696. >Beispiel 1. <B
  57697. CLASS="function"
  57698. >bcadd()</B
  57699. > Beispiel</B
  57700. ></P
  57701. ><TABLE
  57702. BORDER="0"
  57703. BGCOLOR="#E0E0E0"
  57704. CELLPADDING="5"
  57705. ><TR
  57706. ><TD
  57707. ><PRE
  57708. CLASS="php"
  57709. ><?php
  57710.  
  57711. $a = 1.234;
  57712. $b = 5;
  57713.  
  57714. echo bcadd($a, $b);     // 6
  57715. echo bcadd($a, $b, 4);  // 6.2340
  57716.  
  57717. ?></PRE
  57718. ></TD
  57719. ></TR
  57720. ></TABLE
  57721. ></DIV
  57722. ></TD
  57723. ></TR
  57724. ></TABLE
  57725. >
  57726.     </P
  57727. ><P
  57728. >      Siehe auch <A
  57729. HREF="#function.bcsub"
  57730. ><B
  57731. CLASS="function"
  57732. >bcsub()</B
  57733. ></A
  57734. >.
  57735.     </P
  57736. ></DIV
  57737. ><H1
  57738. ><A
  57739. NAME="function.bccomp"
  57740. ></A
  57741. >bccomp</H1
  57742. ><DIV
  57743. CLASS="refnamediv"
  57744. ><A
  57745. NAME="AEN10415"
  57746. ></A
  57747. ><P
  57748. >    (PHP 3, PHP 4 , PHP 5)</P
  57749. >bccomp -- 
  57750.      Vergleich zweier Zahlen beliebiger Genauigkeit.
  57751.     </DIV
  57752. ><DIV
  57753. CLASS="refsect1"
  57754. ><A
  57755. NAME="AEN10418"
  57756. ></A
  57757. ><H2
  57758. >Beschreibung</H2
  57759. >int <B
  57760. CLASS="methodname"
  57761. >bccomp</B
  57762. > ( string linker Operand, string rechter Operand [, int Genauigkeit])<BR
  57763. ></BR
  57764. ><P
  57765. >      Vergleicht den <VAR
  57766. CLASS="parameter"
  57767. >linken Operanden</VAR
  57768. > mit dem
  57769.      <VAR
  57770. CLASS="parameter"
  57771. >rechten Operanden</VAR
  57772. > und liefert das Ergebnis
  57773.      als Integer-Wert. Der optionale Parameter <VAR
  57774. CLASS="parameter"
  57775. >Genauigkeit</VAR
  57776. >
  57777.      bestimmt die Anzahl der Nachkommastellen, die fⁿr den Vergleich
  57778.      ausgewertet werden. Der Rⁿckgabewert ist 0, wenn die beiden Operanden
  57779.      gleich sind. Wenn der <VAR
  57780. CLASS="parameter"
  57781. >linke Operand</VAR
  57782. > gr÷▀er ist
  57783.      als der <VAR
  57784. CLASS="parameter"
  57785. >rechte Operand</VAR
  57786. >, wird +1 zurⁿckgeliefert;
  57787.      wenn der <VAR
  57788. CLASS="parameter"
  57789. >linke Operand</VAR
  57790. >
  57791.      kleiner ist als der <VAR
  57792. CLASS="parameter"
  57793. >rechte Operand</VAR
  57794. > wird
  57795.      -1 zurⁿckgeliefert.
  57796.     </P
  57797. ><P
  57798. >      <TABLE
  57799. WIDTH="100%"
  57800. BORDER="0"
  57801. CELLPADDING="0"
  57802. CELLSPACING="0"
  57803. CLASS="EXAMPLE"
  57804. ><TR
  57805. ><TD
  57806. ><DIV
  57807. CLASS="example"
  57808. ><A
  57809. NAME="AEN10441"
  57810. ></A
  57811. ><P
  57812. ><B
  57813. >Beispiel 1. <B
  57814. CLASS="function"
  57815. >bccomp()</B
  57816. > Beispiel</B
  57817. ></P
  57818. ><TABLE
  57819. BORDER="0"
  57820. BGCOLOR="#E0E0E0"
  57821. CELLPADDING="5"
  57822. ><TR
  57823. ><TD
  57824. ><PRE
  57825. CLASS="php"
  57826. ><?php
  57827. echo bccomp('1', '2') . "\n";
  57828.  
  57829. echo bccomp('1.00001', '1', 3) . "\n";
  57830. echo bccomp('1.00001', '1', 5);
  57831. ?></PRE
  57832. ></TD
  57833. ></TR
  57834. ></TABLE
  57835. ><P
  57836. >        Das obige Beispiel gibt folgendes aus:
  57837.       </P
  57838. ><TABLE
  57839. BORDER="0"
  57840. BGCOLOR="#E0E0E0"
  57841. CELLPADDING="5"
  57842. ><TR
  57843. ><TD
  57844. ><PRE
  57845. CLASS="screen"
  57846. >-1
  57847. 0
  57848. 1</PRE
  57849. ></TD
  57850. ></TR
  57851. ></TABLE
  57852. ></DIV
  57853. ></TD
  57854. ></TR
  57855. ></TABLE
  57856. >
  57857.     </P
  57858. ></DIV
  57859. ><H1
  57860. ><A
  57861. NAME="function.bcdiv"
  57862. ></A
  57863. >bcdiv</H1
  57864. ><DIV
  57865. CLASS="refnamediv"
  57866. ><A
  57867. NAME="AEN10448"
  57868. ></A
  57869. ><P
  57870. >    (PHP 3, PHP 4 , PHP 5)</P
  57871. >bcdiv -- Division zweier Zahlen beliebiger Genauigkeit.</DIV
  57872. ><DIV
  57873. CLASS="refsect1"
  57874. ><A
  57875. NAME="AEN10451"
  57876. ></A
  57877. ><H2
  57878. >Beschreibung</H2
  57879. >string <B
  57880. CLASS="methodname"
  57881. >bcdiv</B
  57882. > ( string linker Operand, string rechter Operand [, int Genauigkeit])<BR
  57883. ></BR
  57884. ><P
  57885. >      Dividiert den <VAR
  57886. CLASS="parameter"
  57887. >linken Operanden</VAR
  57888. > durch den
  57889.      <VAR
  57890. CLASS="parameter"
  57891. >rechten Operanden</VAR
  57892. >. Der optionale Parameter
  57893.      <VAR
  57894. CLASS="parameter"
  57895. >Genauigkeit</VAR
  57896. > legt die Anzahl der
  57897.      Nachkommastellen im Ergebnis fest.
  57898.     </P
  57899. ><P
  57900. >      <TABLE
  57901. WIDTH="100%"
  57902. BORDER="0"
  57903. CELLPADDING="0"
  57904. CELLSPACING="0"
  57905. CLASS="EXAMPLE"
  57906. ><TR
  57907. ><TD
  57908. ><DIV
  57909. CLASS="example"
  57910. ><A
  57911. NAME="AEN10470"
  57912. ></A
  57913. ><P
  57914. ><B
  57915. >Beispiel 1. <B
  57916. CLASS="function"
  57917. >bcdiv()</B
  57918. > Beispiel</B
  57919. ></P
  57920. ><TABLE
  57921. BORDER="0"
  57922. BGCOLOR="#E0E0E0"
  57923. CELLPADDING="5"
  57924. ><TR
  57925. ><TD
  57926. ><PRE
  57927. CLASS="php"
  57928. ><?php
  57929.  
  57930. echo bcdiv(105, 6.55957, 3);  // 16.007
  57931.  
  57932. ?></PRE
  57933. ></TD
  57934. ></TR
  57935. ></TABLE
  57936. ></DIV
  57937. ></TD
  57938. ></TR
  57939. ></TABLE
  57940. >
  57941.     </P
  57942. ><P
  57943. >      Siehe auch <A
  57944. HREF="#function.bcmul"
  57945. ><B
  57946. CLASS="function"
  57947. >bcmul()</B
  57948. ></A
  57949. >.
  57950.     </P
  57951. ></DIV
  57952. ><H1
  57953. ><A
  57954. NAME="function.bcmod"
  57955. ></A
  57956. >bcmod</H1
  57957. ><DIV
  57958. CLASS="refnamediv"
  57959. ><A
  57960. NAME="AEN10477"
  57961. ></A
  57962. ><P
  57963. >    (PHP 3, PHP 4 , PHP 5)</P
  57964. >bcmod -- 
  57965.      Modulo zweier Zahlen mit beliebiger Genauigkeit.
  57966.     </DIV
  57967. ><DIV
  57968. CLASS="refsect1"
  57969. ><A
  57970. NAME="AEN10480"
  57971. ></A
  57972. ><H2
  57973. >Beschreibung</H2
  57974. >string <B
  57975. CLASS="methodname"
  57976. >bcmod</B
  57977. > ( string linker Operand, string Modulus)<BR
  57978. ></BR
  57979. ><P
  57980. >      Liefert den <VAR
  57981. CLASS="parameter"
  57982. >linken Operanden</VAR
  57983. > modulo
  57984.      <VAR
  57985. CLASS="parameter"
  57986. >Modulus</VAR
  57987. >.
  57988.     </P
  57989. ><P
  57990. >      <TABLE
  57991. WIDTH="100%"
  57992. BORDER="0"
  57993. CELLPADDING="0"
  57994. CELLSPACING="0"
  57995. CLASS="EXAMPLE"
  57996. ><TR
  57997. ><TD
  57998. ><DIV
  57999. CLASS="example"
  58000. ><A
  58001. NAME="AEN10495"
  58002. ></A
  58003. ><P
  58004. ><B
  58005. >Beispiel 1. <B
  58006. CLASS="function"
  58007. >bcmod()</B
  58008. > Beispiel</B
  58009. ></P
  58010. ><TABLE
  58011. BORDER="0"
  58012. BGCOLOR="#E0E0E0"
  58013. CELLPADDING="5"
  58014. ><TR
  58015. ><TD
  58016. ><PRE
  58017. CLASS="php"
  58018. ><?php
  58019. echo bcmod(4, 2) . "\n";
  58020. echo bcmod(2, 4);
  58021. ?></PRE
  58022. ></TD
  58023. ></TR
  58024. ></TABLE
  58025. ><P
  58026. >        Das obige Beispiel gibt folgendes aus:
  58027.       </P
  58028. ><TABLE
  58029. BORDER="0"
  58030. BGCOLOR="#E0E0E0"
  58031. CELLPADDING="5"
  58032. ><TR
  58033. ><TD
  58034. ><PRE
  58035. CLASS="screen"
  58036. >0
  58037. 2</PRE
  58038. ></TD
  58039. ></TR
  58040. ></TABLE
  58041. ></DIV
  58042. ></TD
  58043. ></TR
  58044. ></TABLE
  58045. >
  58046.     </P
  58047. ><P
  58048. >      Siehe auch <A
  58049. HREF="#function.bcdiv"
  58050. ><B
  58051. CLASS="function"
  58052. >bcdiv()</B
  58053. ></A
  58054. >.
  58055.     </P
  58056. ></DIV
  58057. ><H1
  58058. ><A
  58059. NAME="function.bcmul"
  58060. ></A
  58061. >bcmul</H1
  58062. ><DIV
  58063. CLASS="refnamediv"
  58064. ><A
  58065. NAME="AEN10504"
  58066. ></A
  58067. ><P
  58068. >    (PHP 3, PHP 4 , PHP 5)</P
  58069. >bcmul -- 
  58070.      Multiplikation zweier Zahlen beliebiger Genauigkeit.
  58071.     </DIV
  58072. ><DIV
  58073. CLASS="refsect1"
  58074. ><A
  58075. NAME="AEN10507"
  58076. ></A
  58077. ><H2
  58078. >Beschreibung</H2
  58079. >string <B
  58080. CLASS="methodname"
  58081. >bcmul</B
  58082. > ( string linker Operand, string rechter Operand [, int Genauigkeit])<BR
  58083. ></BR
  58084. ><P
  58085. >      Multipliziert den <VAR
  58086. CLASS="parameter"
  58087. >linken Operanden</VAR
  58088. > mit dem
  58089.      <VAR
  58090. CLASS="parameter"
  58091. >rechten Operanden</VAR
  58092. >. Der optionale Parameter
  58093.      <VAR
  58094. CLASS="parameter"
  58095. >Genauigkeit</VAR
  58096. > legt die Anzahl der
  58097.      Nachkommastellen im Ergebnis fest.
  58098.     </P
  58099. ><P
  58100. >      <TABLE
  58101. WIDTH="100%"
  58102. BORDER="0"
  58103. CELLPADDING="0"
  58104. CELLSPACING="0"
  58105. CLASS="EXAMPLE"
  58106. ><TR
  58107. ><TD
  58108. ><DIV
  58109. CLASS="example"
  58110. ><A
  58111. NAME="AEN10526"
  58112. ></A
  58113. ><P
  58114. ><B
  58115. >Beispiel 1. <B
  58116. CLASS="function"
  58117. >bcmul()</B
  58118. > Beispiel</B
  58119. ></P
  58120. ><TABLE
  58121. BORDER="0"
  58122. BGCOLOR="#E0E0E0"
  58123. CELLPADDING="5"
  58124. ><TR
  58125. ><TD
  58126. ><PRE
  58127. CLASS="php"
  58128. ><?php
  58129. echo bcmul(1.34747474747, 35, 3) . "\n";
  58130. echo bcmul(2, 4);
  58131. ?></PRE
  58132. ></TD
  58133. ></TR
  58134. ></TABLE
  58135. ><P
  58136. >        Das obige Beispiel gibt folgendes aus:
  58137.       </P
  58138. ><TABLE
  58139. BORDER="0"
  58140. BGCOLOR="#E0E0E0"
  58141. CELLPADDING="5"
  58142. ><TR
  58143. ><TD
  58144. ><PRE
  58145. CLASS="screen"
  58146. >47.162
  58147. 8</PRE
  58148. ></TD
  58149. ></TR
  58150. ></TABLE
  58151. ></DIV
  58152. ></TD
  58153. ></TR
  58154. ></TABLE
  58155. >
  58156.     </P
  58157. ><P
  58158. >      Siehe auch <A
  58159. HREF="#function.bcdiv"
  58160. ><B
  58161. CLASS="function"
  58162. >bcdiv()</B
  58163. ></A
  58164. >.
  58165.     </P
  58166. ></DIV
  58167. ><H1
  58168. ><A
  58169. NAME="function.bcpow"
  58170. ></A
  58171. >bcpow</H1
  58172. ><DIV
  58173. CLASS="refnamediv"
  58174. ><A
  58175. NAME="AEN10535"
  58176. ></A
  58177. ><P
  58178. >    (PHP 3, PHP 4 , PHP 5)</P
  58179. >bcpow -- 
  58180.      Potenz mit beliebiger Genauigkeit.
  58181.     </DIV
  58182. ><DIV
  58183. CLASS="refsect1"
  58184. ><A
  58185. NAME="AEN10538"
  58186. ></A
  58187. ><H2
  58188. >Beschreibung</H2
  58189. >string <B
  58190. CLASS="methodname"
  58191. >bcpow</B
  58192. > ( string x, string y [, int Genauigkeit])<BR
  58193. ></BR
  58194. ><P
  58195. >      Potenziert <VAR
  58196. CLASS="parameter"
  58197. >x</VAR
  58198. > mit <VAR
  58199. CLASS="parameter"
  58200. >y</VAR
  58201. >.
  58202.      Der optionale Parameter <VAR
  58203. CLASS="parameter"
  58204. >Genauigkeit</VAR
  58205. > legt
  58206.      die Anzahl der Nachkommastellen im Ergebnis fest.
  58207.     </P
  58208. ><P
  58209. >      <TABLE
  58210. WIDTH="100%"
  58211. BORDER="0"
  58212. CELLPADDING="0"
  58213. CELLSPACING="0"
  58214. CLASS="EXAMPLE"
  58215. ><TR
  58216. ><TD
  58217. ><DIV
  58218. CLASS="example"
  58219. ><A
  58220. NAME="AEN10557"
  58221. ></A
  58222. ><P
  58223. ><B
  58224. >Beispiel 1. <B
  58225. CLASS="function"
  58226. >bcpow()</B
  58227. > Beispiel</B
  58228. ></P
  58229. ><TABLE
  58230. BORDER="0"
  58231. BGCOLOR="#E0E0E0"
  58232. CELLPADDING="5"
  58233. ><TR
  58234. ><TD
  58235. ><PRE
  58236. CLASS="php"
  58237. ><?php
  58238.  
  58239. echo bcpow(4.2, 3, 2); // 74.08
  58240.  
  58241. ?></PRE
  58242. ></TD
  58243. ></TR
  58244. ></TABLE
  58245. ></DIV
  58246. ></TD
  58247. ></TR
  58248. ></TABLE
  58249. >
  58250.     </P
  58251. ><P
  58252. >      Siehe auch <A
  58253. HREF="#function.bcpowmod"
  58254. ><B
  58255. CLASS="function"
  58256. >bcpowmod()</B
  58257. ></A
  58258. > und <A
  58259. HREF="#function.bcsqrt"
  58260. ><B
  58261. CLASS="function"
  58262. >bcsqrt()</B
  58263. ></A
  58264. >.
  58265.     </P
  58266. ></DIV
  58267. ><H1
  58268. ><A
  58269. NAME="function.bcpowmod"
  58270. ></A
  58271. >bcpowmod</H1
  58272. ><DIV
  58273. CLASS="refnamediv"
  58274. ><A
  58275. NAME="AEN10565"
  58276. ></A
  58277. ><P
  58278. >    (PHP 5)</P
  58279. >bcpowmod -- 
  58280.      Raise an arbitrary precision number to another, reduced by a specified modulus.
  58281.     </DIV
  58282. ><DIV
  58283. CLASS="refsect1"
  58284. ><A
  58285. NAME="AEN10568"
  58286. ></A
  58287. ><H2
  58288. >Beschreibung</H2
  58289. >string <B
  58290. CLASS="methodname"
  58291. >bcpowmod</B
  58292. > ( string x, string y, string modulus [, int scale])<BR
  58293. ></BR
  58294. ><P
  58295. >      Benutzen Sie diese schnelle Exponentialmethode um
  58296.      <VAR
  58297. CLASS="parameter"
  58298. >x</VAR
  58299. > mit <VAR
  58300. CLASS="parameter"
  58301. >y</VAR
  58302. > unter
  58303.      Berⁿcksichtigung des Modulo <VAR
  58304. CLASS="parameter"
  58305. >modulus</VAR
  58306. > zu potenzieren.
  58307.      Der optionale Parameter <VAR
  58308. CLASS="parameter"
  58309. >scale</VAR
  58310. > legt die Anzahl der
  58311.      Nachkommastellen im Ergebnis fest.
  58312.     </P
  58313. ><P
  58314. >      Die folgenden zwei Anweisungen sind funktional identisch.
  58315.      Die Variante mit <B
  58316. CLASS="function"
  58317. >bcpowmod()</B
  58318. > ist schneller und
  58319.      akzeptiert gr÷▀ere Parameter.
  58320.      <DIV
  58321. CLASS="informalexample"
  58322. ><P
  58323. ></P
  58324. ><A
  58325. NAME="AEN10592"
  58326. ></A
  58327. ><TABLE
  58328. BORDER="0"
  58329. BGCOLOR="#E0E0E0"
  58330. CELLPADDING="5"
  58331. ><TR
  58332. ><TD
  58333. ><PRE
  58334. CLASS="php"
  58335. ><?php
  58336. $a = bcpowmod($x, $y, $mod);
  58337.  
  58338. $b = bcmod(bcpow($x, $y), $mod);
  58339.  
  58340. // $a und $b sind genau gleich.
  58341.  
  58342. ?></PRE
  58343. ></TD
  58344. ></TR
  58345. ></TABLE
  58346. ><P
  58347. ></P
  58348. ></DIV
  58349. >
  58350.     </P
  58351. ><P
  58352. >      <DIV
  58353. CLASS="note"
  58354. ><BLOCKQUOTE
  58355. CLASS="note"
  58356. ><P
  58357. ><B
  58358. >Anmerkung: </B
  58359. >
  58360.        Die Verwendung von nicht-natⁿrlichen Zahlen kann zu unerwarteten
  58361.        Ergebnissen fⁿhren, weil diese Funktion die Modulodivision verwendet.
  58362.        Eine natⁿrliche Zahl ist jede ganzzahlige positive Zahl die ungleich
  58363.        Null ist.
  58364.       </P
  58365. ></BLOCKQUOTE
  58366. ></DIV
  58367. >
  58368.     </P
  58369. ><P
  58370. >      Siehe auch <A
  58371. HREF="#function.bcpow"
  58372. ><B
  58373. CLASS="function"
  58374. >bcpow()</B
  58375. ></A
  58376. > und
  58377.      <A
  58378. HREF="#function.bcmod"
  58379. ><B
  58380. CLASS="function"
  58381. >bcmod()</B
  58382. ></A
  58383. >.
  58384.     </P
  58385. ></DIV
  58386. ><H1
  58387. ><A
  58388. NAME="function.bcscale"
  58389. ></A
  58390. >bcscale</H1
  58391. ><DIV
  58392. CLASS="refnamediv"
  58393. ><A
  58394. NAME="AEN10601"
  58395. ></A
  58396. ><P
  58397. >    (PHP 3, PHP 4 , PHP 5)</P
  58398. >bcscale -- 
  58399.      Setzt die Genauigkeit aller BC math-Funktionen.
  58400.     </DIV
  58401. ><DIV
  58402. CLASS="refsect1"
  58403. ><A
  58404. NAME="AEN10604"
  58405. ></A
  58406. ><H2
  58407. >Beschreibung</H2
  58408. >bool <B
  58409. CLASS="methodname"
  58410. >bcscale</B
  58411. > ( int Genauigkeit)<BR
  58412. ></BR
  58413. ><P
  58414. >      Diese Funktionen legt die Standard-Genauigkeit aller in der Folge
  58415.      aufgerufenden BC math-Funktionen fest, die nicht explizit die
  58416.      Genauigkeit durch den optionalen Parameter setzen. Gibt bei Erfolg <TT
  58417. CLASS="constant"
  58418. ><B
  58419. >TRUE</B
  58420. ></TT
  58421. > zurⁿck, im Fehlerfall <TT
  58422. CLASS="constant"
  58423. ><B
  58424. >FALSE</B
  58425. ></TT
  58426. >.
  58427.     </P
  58428. ><P
  58429. >      <TABLE
  58430. WIDTH="100%"
  58431. BORDER="0"
  58432. CELLPADDING="0"
  58433. CELLSPACING="0"
  58434. CLASS="EXAMPLE"
  58435. ><TR
  58436. ><TD
  58437. ><DIV
  58438. CLASS="example"
  58439. ><A
  58440. NAME="AEN10616"
  58441. ></A
  58442. ><P
  58443. ><B
  58444. >Beispiel 1. <B
  58445. CLASS="function"
  58446. >bcscale()</B
  58447. > Beispiel</B
  58448. ></P
  58449. ><TABLE
  58450. BORDER="0"
  58451. BGCOLOR="#E0E0E0"
  58452. CELLPADDING="5"
  58453. ><TR
  58454. ><TD
  58455. ><PRE
  58456. CLASS="php"
  58457. ><?php
  58458.  
  58459. // Genauigkeit festlegen : 3
  58460. bcscale(3);
  58461. echo bcdiv(105, 6.55957); // 16.007
  58462.  
  58463. // Das gleiche Ergebnis ohne bcscale()
  58464. echo bcdiv(105, 6.55957, 3); // 16.007
  58465.  
  58466. ?></PRE
  58467. ></TD
  58468. ></TR
  58469. ></TABLE
  58470. ></DIV
  58471. ></TD
  58472. ></TR
  58473. ></TABLE
  58474. >
  58475.     </P
  58476. ></DIV
  58477. ><H1
  58478. ><A
  58479. NAME="function.bcsqrt"
  58480. ></A
  58481. >bcsqrt</H1
  58482. ><DIV
  58483. CLASS="refnamediv"
  58484. ><A
  58485. NAME="AEN10621"
  58486. ></A
  58487. ><P
  58488. >    (PHP 3, PHP 4 , PHP 5)</P
  58489. >bcsqrt -- 
  58490.