home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 April / PCWorld_2005-04_cd.bin / akce / web / phpmanual / phpmanual.exe / php_manual_cs.html.htm < prev    next >
Encoding:
Extensible Markup Language  |  2005-01-13  |  7.5 MB  |  515,016 lines
Text Truncated. Only the first 1MB is shown below. Download the file for the complete contents.
  1. <HTML
  2. ><HEAD
  3. ><TITLE
  4. >Manußl PHP</TITLE
  5. ><META
  6. NAME="GENERATOR"
  7. CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><META
  8. HTTP-EQUIV="Content-type"
  9. CONTENT="text/html; charset=ISO-8859-2"></HEAD
  10. ><BODY
  11. CLASS="book"
  12. BGCOLOR="#FFFFFF"
  13. TEXT="#000000"
  14. LINK="#0000FF"
  15. VLINK="#840084"
  16. ALINK="#0000FF"
  17. ><DIV
  18. CLASS="BOOK"
  19. ><A
  20. NAME="manual"
  21. ></A
  22. ><DIV
  23. CLASS="TITLEPAGE"
  24. ><H1
  25. CLASS="title"
  26. ><A
  27. NAME="manual"
  28. ></A
  29. >Manußl PHP</H1
  30. ><DIV
  31. CLASS="author"
  32. >Stig Sæther Bakken</DIV
  33. ><DIV
  34. CLASS="author"
  35. >Alexander Aulbach</DIV
  36. ><DIV
  37. CLASS="author"
  38. >Egon Schmid</DIV
  39. ><DIV
  40. CLASS="author"
  41. >Jim Winstead</DIV
  42. ><DIV
  43. CLASS="author"
  44. >Lars Torben Wilson</DIV
  45. ><DIV
  46. CLASS="author"
  47. >Rasmus Lerdorf</DIV
  48. ><DIV
  49. CLASS="author"
  50. >Andrei Zmievski</DIV
  51. ><DIV
  52. CLASS="author"
  53. >Jouni Ahto</DIV
  54. ><H2
  55. CLASS="EDITEDBY"
  56. >Sestavil</H2
  57. ><DIV
  58. CLASS="editor"
  59. >Lukß╣ Jelφnek</DIV
  60. ><DIV
  61. CLASS="editor"
  62. >Jakub Vrßna</DIV
  63. ><P
  64. CLASS="pubdate"
  65. >03-01-2004<BR></P
  66. ><P
  67. CLASS="copyright"
  68. >Copyright © 1997, 1998, 1999, 2000, 2001, 2002 the PHP Documentation Group</P
  69. ><DIV
  70. CLASS="legalnotice"
  71. ><A
  72. NAME="copyright"
  73. ></A
  74. ><P
  75. ><B
  76. >Copyright</B
  77. ></P
  78. ><P
  79. >     Tento manußl je © Copyright 1997, 1998, 1999, 2000, 2001, 2002 PHP
  80.     Documentation Group.  Seznam Φlen∙ tΘto skupiny je na titulnφ stran∞
  81.     tohoto manußlu.
  82.    </P
  83. ><P
  84. >     Tento manußl lze redistribuovat podle podmφnek GNU General Public License
  85.     publikovanΘ Free Software Foundation; bu∩ verzφ 2 tΘto Licence, nebo (dle
  86.     va╣eho uvß╛enφ) kterΘkoliv pozd∞j╣φ verze.
  87.    </P
  88. ><P
  89. >     Sekce tohoto manußlu "Roz╣φ°enφ PHP 4.0" je © 2000 Zend Technologies,
  90.     Ltd. Tento materißl smφ b²t redistribuovßn pouze za podmφnek
  91.     specifikovan²ch v Open Publication License v1.0 nebo pozd∞j╣φ (nejnov∞j╣φ
  92.     verze je v souΦasnosti k dispozici na
  93.     <A
  94. HREF="http://www.opencontent.org/openpub/"
  95. TARGET="_top"
  96. >http://www.opencontent.org/openpub/</A
  97. >).
  98.    </P
  99. ></DIV
  100. ><HR></DIV
  101. ><DIV
  102. CLASS="TOC"
  103. ><DL
  104. ><DT
  105. ><B
  106. >Obsah</B
  107. ></DT
  108. ><DT
  109. ><A
  110. HREF="#preface"
  111. >P°edmluva</A
  112. ></DT
  113. ><DT
  114. >I. <A
  115. HREF="#getting-started"
  116. >ZaΦφnßme</A
  117. ></DT
  118. ><DD
  119. ><DL
  120. ><DT
  121. >1. <A
  122. HREF="#introduction"
  123. >Introduction</A
  124. ></DT
  125. ><DT
  126. >2. <A
  127. HREF="#tutorial"
  128. >A simple tutorial</A
  129. ></DT
  130. ><DT
  131. >3. <A
  132. HREF="#installation"
  133. >Instalace</A
  134. ></DT
  135. ><DT
  136. >4. <A
  137. HREF="#configuration"
  138. >Runtime Configuration</A
  139. ></DT
  140. ></DL
  141. ></DD
  142. ><DT
  143. >II. <A
  144. HREF="#langref"
  145. >Reference jazyka</A
  146. ></DT
  147. ><DD
  148. ><DL
  149. ><DT
  150. >5. <A
  151. HREF="#language.basic-syntax"
  152. >Zßkladnφ syntaxe</A
  153. ></DT
  154. ><DT
  155. >6. <A
  156. HREF="#language.types"
  157. >Types</A
  158. ></DT
  159. ><DT
  160. >7. <A
  161. HREF="#language.variables"
  162. >Prom∞nnΘ</A
  163. ></DT
  164. ><DT
  165. >8. <A
  166. HREF="#language.constants"
  167. >Konstanty</A
  168. ></DT
  169. ><DT
  170. >9. <A
  171. HREF="#language.expressions"
  172. >V²razy</A
  173. ></DT
  174. ><DT
  175. >10. <A
  176. HREF="#language.operators"
  177. >Operßtory</A
  178. ></DT
  179. ><DT
  180. >11. <A
  181. HREF="#control-structures"
  182. >╪φdicφ struktury</A
  183. ></DT
  184. ><DT
  185. >12. <A
  186. HREF="#functions"
  187. >Funkce</A
  188. ></DT
  189. ><DT
  190. >13. <A
  191. HREF="#language.oop"
  192. >Classes and Objects</A
  193. ></DT
  194. ><DT
  195. >14. <A
  196. HREF="#language.references"
  197. >Vysv∞tlenφ referencφ (odkaz∙)</A
  198. ></DT
  199. ></DL
  200. ></DD
  201. ><DT
  202. >III. <A
  203. HREF="#security"
  204. >Security</A
  205. ></DT
  206. ><DD
  207. ><DL
  208. ><DT
  209. >15. <A
  210. HREF="#security.index"
  211. >Security</A
  212. ></DT
  213. ></DL
  214. ></DD
  215. ><DT
  216. >IV. <A
  217. HREF="#features"
  218. >Vlastnosti</A
  219. ></DT
  220. ><DD
  221. ><DL
  222. ><DT
  223. >16. <A
  224. HREF="#features.http-auth"
  225. >HTTP autentikace a PHP</A
  226. ></DT
  227. ><DT
  228. >17. <A
  229. HREF="#features.cookies"
  230. >Cookies</A
  231. ></DT
  232. ><DT
  233. >18. <A
  234. HREF="#features.file-upload"
  235. >Zpracovßnφ uploadu soubor∙</A
  236. ></DT
  237. ><DT
  238. >19. <A
  239. HREF="#features.remote-files"
  240. >Pou╛itφ vzdßlen²ch soubor∙</A
  241. ></DT
  242. ><DT
  243. >20. <A
  244. HREF="#features.connection-handling"
  245. >Obsluha spojenφ</A
  246. ></DT
  247. ><DT
  248. >21. <A
  249. HREF="#features.persistent-connections"
  250. >Persistentnφ databßzovß spojenφ</A
  251. ></DT
  252. ><DT
  253. >22. <A
  254. HREF="#features.safe-mode"
  255. >BezpeΦn² re╛im</A
  256. ></DT
  257. ><DT
  258. >23. <A
  259. HREF="#features.commandline"
  260. >Pou╛itφ PHP z p°φkazovΘ °ßdky</A
  261. ></DT
  262. ></DL
  263. ></DD
  264. ><DT
  265. >V. <A
  266. HREF="#funcref"
  267. >Reference funkcφ</A
  268. ></DT
  269. ><DD
  270. ><DL
  271. ><DT
  272. >I. <A
  273. HREF="#ref.apache"
  274. >Funkce specifickΘ pro Apache</A
  275. ></DT
  276. ><DT
  277. >II. <A
  278. HREF="#ref.array"
  279. >Funkce pro prßci s poli</A
  280. ></DT
  281. ><DT
  282. >III. <A
  283. HREF="#ref.aspell"
  284. >Aspell funkce [zastaralΘ]</A
  285. ></DT
  286. ><DT
  287. >IV. <A
  288. HREF="#ref.bc"
  289. >BCMath funkce pro v²poΦty s libovolnou p°esnostφ</A
  290. ></DT
  291. ><DT
  292. >V. <A
  293. HREF="#ref.bzip2"
  294. >Kompresnφ funkce bzip2</A
  295. ></DT
  296. ><DT
  297. >VI. <A
  298. HREF="#ref.calendar"
  299. >Kalendß°ovΘ funkce</A
  300. ></DT
  301. ><DT
  302. >VII. <A
  303. HREF="#ref.ccvs"
  304. >CCVS API Functions</A
  305. ></DT
  306. ><DT
  307. >VIII. <A
  308. HREF="#ref.com"
  309. >Funkce na podporu COM ve Windows</A
  310. ></DT
  311. ><DT
  312. >IX. <A
  313. HREF="#ref.classobj"
  314. >Funkce pro prßci s t°φdami/objekty</A
  315. ></DT
  316. ><DT
  317. >X. <A
  318. HREF="#ref.cpdf"
  319. >ClibPDF functions</A
  320. ></DT
  321. ><DT
  322. >XI. <A
  323. HREF="#ref.crack"
  324. >Crack functions</A
  325. ></DT
  326. ><DT
  327. >XII. <A
  328. HREF="#ref.curl"
  329. >Funkce pro prßci s CURL, Client URL Library</A
  330. ></DT
  331. ><DT
  332. >XIII. <A
  333. HREF="#ref.cybercash"
  334. >Cybercash platebnφ funkce</A
  335. ></DT
  336. ><DT
  337. >XIV. <A
  338. HREF="#ref.cyrus"
  339. >Cyrus IMAP administration functions</A
  340. ></DT
  341. ><DT
  342. >XV. <A
  343. HREF="#ref.ctype"
  344. >Character type functions</A
  345. ></DT
  346. ><DT
  347. >XVI. <A
  348. HREF="#ref.dba"
  349. >Database (dbm-style) abstraction layer functions</A
  350. ></DT
  351. ><DT
  352. >XVII. <A
  353. HREF="#ref.datetime"
  354. >Funkce pro datum a Φas</A
  355. ></DT
  356. ><DT
  357. >XVIII. <A
  358. HREF="#ref.dbase"
  359. >dBase functions</A
  360. ></DT
  361. ><DT
  362. >XIX. <A
  363. HREF="#ref.dbm"
  364. >DBM Funkce [zastaralΘ]</A
  365. ></DT
  366. ><DT
  367. >XX. <A
  368. HREF="#ref.dbx"
  369. >dbx functions</A
  370. ></DT
  371. ><DT
  372. >XXI. <A
  373. HREF="#ref.dbplus"
  374. >DB++ Functions</A
  375. ></DT
  376. ><DT
  377. >XXII. <A
  378. HREF="#ref.dio"
  379. >Direct IO functions</A
  380. ></DT
  381. ><DT
  382. >XXIII. <A
  383. HREF="#ref.dir"
  384. >Adresß°ovΘ funkce</A
  385. ></DT
  386. ><DT
  387. >XXIV. <A
  388. HREF="#ref.domxml"
  389. >DOM XML functions</A
  390. ></DT
  391. ><DT
  392. >XXV. <A
  393. HREF="#ref.dotnet"
  394. >.NET functions</A
  395. ></DT
  396. ><DT
  397. >XXVI. <A
  398. HREF="#ref.errorfunc"
  399. >Error Handling and Logging Functions</A
  400. ></DT
  401. ><DT
  402. >XXVII. <A
  403. HREF="#ref.fam"
  404. >File alteration monitor functions</A
  405. ></DT
  406. ><DT
  407. >XXVIII. <A
  408. HREF="#ref.fbsql"
  409. >FrontBase Functions</A
  410. ></DT
  411. ><DT
  412. >XXIX. <A
  413. HREF="#ref.filepro"
  414. >filePro funkce</A
  415. ></DT
  416. ><DT
  417. >XXX. <A
  418. HREF="#ref.filesystem"
  419. >Funkce filesystΘmu</A
  420. ></DT
  421. ><DT
  422. >XXXI. <A
  423. HREF="#ref.fdf"
  424. >Forms Data Format functions</A
  425. ></DT
  426. ><DT
  427. >XXXII. <A
  428. HREF="#ref.fribidi"
  429. >FriBiDi functions</A
  430. ></DT
  431. ><DT
  432. >XXXIII. <A
  433. HREF="#ref.ftp"
  434. >FTP functions</A
  435. ></DT
  436. ><DT
  437. >XXXIV. <A
  438. HREF="#ref.funchand"
  439. >Funkce pro prßci s funkcemi</A
  440. ></DT
  441. ><DT
  442. >XXXV. <A
  443. HREF="#ref.gettext"
  444. >Gettext</A
  445. ></DT
  446. ><DT
  447. >XXXVI. <A
  448. HREF="#ref.gmp"
  449. >GMP functions</A
  450. ></DT
  451. ><DT
  452. >XXXVII. <A
  453. HREF="#ref.http"
  454. >HTTP funkce</A
  455. ></DT
  456. ><DT
  457. >XXXVIII. <A
  458. HREF="#ref.hyperwave"
  459. >Hyperwave functions</A
  460. ></DT
  461. ><DT
  462. >XXXIX. <A
  463. HREF="#ref.hwapi"
  464. >Hyperwave API functions</A
  465. ></DT
  466. ><DT
  467. >XL. <A
  468. HREF="#ref.iconv"
  469. >iconv functions</A
  470. ></DT
  471. ><DT
  472. >XLI. <A
  473. HREF="#ref.image"
  474. >Image functions</A
  475. ></DT
  476. ><DT
  477. >XLII. <A
  478. HREF="#ref.imap"
  479. >IMAP, POP3 and NNTP functions</A
  480. ></DT
  481. ><DT
  482. >XLIII. <A
  483. HREF="#ref.ifx"
  484. >Informix functions</A
  485. ></DT
  486. ><DT
  487. >XLIV. <A
  488. HREF="#ref.ibase"
  489. >InterBase functions</A
  490. ></DT
  491. ><DT
  492. >XLV. <A
  493. HREF="#ref.ingres"
  494. >Ingres II functions</A
  495. ></DT
  496. ><DT
  497. >XLVI. <A
  498. HREF="#ref.ircg"
  499. >IRC Gateway Functions</A
  500. ></DT
  501. ><DT
  502. >XLVII. <A
  503. HREF="#ref.java"
  504. >PHP / Java Integration</A
  505. ></DT
  506. ><DT
  507. >XLVIII. <A
  508. HREF="#ref.ldap"
  509. >LDAP functions</A
  510. ></DT
  511. ><DT
  512. >XLIX. <A
  513. HREF="#ref.mail"
  514. >MailovΘ funkce</A
  515. ></DT
  516. ><DT
  517. >L. <A
  518. HREF="#ref.mailparse"
  519. >mailparse functions</A
  520. ></DT
  521. ><DT
  522. >LI. <A
  523. HREF="#ref.math"
  524. >MatematickΘ funkce</A
  525. ></DT
  526. ><DT
  527. >LII. <A
  528. HREF="#ref.mbstring"
  529. >Multi-Byte String Functions</A
  530. ></DT
  531. ><DT
  532. >LIII. <A
  533. HREF="#ref.mcal"
  534. >MCAL functions</A
  535. ></DT
  536. ><DT
  537. >LIV. <A
  538. HREF="#ref.mcrypt"
  539. >Mcrypt Encryption Functions</A
  540. ></DT
  541. ><DT
  542. >LV. <A
  543. HREF="#ref.mcve"
  544. >MCVE Payment Functions</A
  545. ></DT
  546. ><DT
  547. >LVI. <A
  548. HREF="#ref.mhash"
  549. >Mhash funkce</A
  550. ></DT
  551. ><DT
  552. >LVII. <A
  553. HREF="#ref.mime-magic"
  554. >Mimetype Functions</A
  555. ></DT
  556. ><DT
  557. >LVIII. <A
  558. HREF="#ref.mssql"
  559. >Microsoft SQL Server functions</A
  560. ></DT
  561. ><DT
  562. >LIX. <A
  563. HREF="#ref.ming"
  564. >Ming functions for Flash</A
  565. ></DT
  566. ><DT
  567. >LX. <A
  568. HREF="#ref.misc"
  569. >R∙znΘ funkce</A
  570. ></DT
  571. ><DT
  572. >LXI. <A
  573. HREF="#ref.mnogo"
  574. >mnoGoSearch Functions</A
  575. ></DT
  576. ><DT
  577. >LXII. <A
  578. HREF="#ref.msql"
  579. >mSQL functions</A
  580. ></DT
  581. ><DT
  582. >LXIII. <A
  583. HREF="#ref.mysql"
  584. >MySQL funkce</A
  585. ></DT
  586. ><DT
  587. >LXIV. <A
  588. HREF="#ref.mysqli"
  589. >Improved MySQL Extension</A
  590. ></DT
  591. ><DT
  592. >LXV. <A
  593. HREF="#ref.msession"
  594. >Mohawk Software session handler functions</A
  595. ></DT
  596. ><DT
  597. >LXVI. <A
  598. HREF="#ref.muscat"
  599. >muscat functions</A
  600. ></DT
  601. ><DT
  602. >LXVII. <A
  603. HREF="#ref.network"
  604. >Sφ╗ovΘ funkce</A
  605. ></DT
  606. ><DT
  607. >LXVIII. <A
  608. HREF="#ref.ncurses"
  609. >Ncurses terminal screen control functions</A
  610. ></DT
  611. ><DT
  612. >LXIX. <A
  613. HREF="#ref.notes"
  614. >Lotus Notes functions</A
  615. ></DT
  616. ><DT
  617. >LXX. <A
  618. HREF="#ref.nsapi"
  619. >NSAPI-specific Functions</A
  620. ></DT
  621. ><DT
  622. >LXXI. <A
  623. HREF="#ref.odbc"
  624. >Unified ODBC functions</A
  625. ></DT
  626. ><DT
  627. >LXXII. <A
  628. HREF="#ref.objaggregation"
  629. >Object Aggregation/Composition Functions</A
  630. ></DT
  631. ><DT
  632. >LXXIII. <A
  633. HREF="#ref.oci8"
  634. >Oracle 8 functions</A
  635. ></DT
  636. ><DT
  637. >LXXIV. <A
  638. HREF="#ref.openssl"
  639. >OpenSSL funkce</A
  640. ></DT
  641. ><DT
  642. >LXXV. <A
  643. HREF="#ref.oracle"
  644. >Oracle functions</A
  645. ></DT
  646. ><DT
  647. >LXXVI. <A
  648. HREF="#ref.ovrimos"
  649. >Ovrimos SQL functions</A
  650. ></DT
  651. ><DT
  652. >LXXVII. <A
  653. HREF="#ref.outcontrol"
  654. >Funkce pro °φzenφ v²stupu</A
  655. ></DT
  656. ><DT
  657. >LXXVIII. <A
  658. HREF="#ref.overload"
  659. >Object property and method call overloading</A
  660. ></DT
  661. ><DT
  662. >LXXIX. <A
  663. HREF="#ref.pdf"
  664. >PDF funkce</A
  665. ></DT
  666. ><DT
  667. >LXXX. <A
  668. HREF="#ref.pfpro"
  669. >Funkce pro prßci s Verisign Payflow Pro</A
  670. ></DT
  671. ><DT
  672. >LXXXI. <A
  673. HREF="#ref.info"
  674. >PHP volby a informace</A
  675. ></DT
  676. ><DT
  677. >LXXXII. <A
  678. HREF="#ref.posix"
  679. >POSIX functions</A
  680. ></DT
  681. ><DT
  682. >LXXXIII. <A
  683. HREF="#ref.pgsql"
  684. >PostgreSQL functions</A
  685. ></DT
  686. ><DT
  687. >LXXXIV. <A
  688. HREF="#ref.pcntl"
  689. >Process Control Functions</A
  690. ></DT
  691. ><DT
  692. >LXXXV. <A
  693. HREF="#ref.exec"
  694. >Funkce spou╣t∞nφ program∙</A
  695. ></DT
  696. ><DT
  697. >LXXXVI. <A
  698. HREF="#ref.printer"
  699. >Printer functions</A
  700. ></DT
  701. ><DT
  702. >LXXXVII. <A
  703. HREF="#ref.pspell"
  704. >Pspell Functions</A
  705. ></DT
  706. ><DT
  707. >LXXXVIII. <A
  708. HREF="#ref.readline"
  709. >GNU Readline</A
  710. ></DT
  711. ><DT
  712. >LXXXIX. <A
  713. HREF="#ref.recode"
  714. >GNU Recode funkce</A
  715. ></DT
  716. ><DT
  717. >XC. <A
  718. HREF="#ref.pcre"
  719. >Regular Expression Functions (Perl-Compatible)</A
  720. ></DT
  721. ><DT
  722. >XCI. <A
  723. HREF="#ref.qtdom"
  724. >qtdom functions</A
  725. ></DT
  726. ><DT
  727. >XCII. <A
  728. HREF="#ref.regex"
  729. >Regular Expression Functions (POSIX Extended)</A
  730. ></DT
  731. ><DT
  732. >XCIII. <A
  733. HREF="#ref.sem"
  734. >Semaphore, Shared Memory and IPC Functions</A
  735. ></DT
  736. ><DT
  737. >XCIV. <A
  738. HREF="#ref.sesam"
  739. >SESAM database functions</A
  740. ></DT
  741. ><DT
  742. >XCV. <A
  743. HREF="#ref.session"
  744. >Session handling functions</A
  745. ></DT
  746. ><DT
  747. >XCVI. <A
  748. HREF="#ref.shmop"
  749. >Funkce pro prßci se sdφlenou pam∞tφ</A
  750. ></DT
  751. ><DT
  752. >XCVII. <A
  753. HREF="#ref.sqlite"
  754. >SQLite</A
  755. ></DT
  756. ><DT
  757. >XCVIII. <A
  758. HREF="#ref.swf"
  759. >Shockwave Flash functions</A
  760. ></DT
  761. ><DT
  762. >XCIX. <A
  763. HREF="#ref.snmp"
  764. >SNMP functions</A
  765. ></DT
  766. ><DT
  767. >C. <A
  768. HREF="#ref.sockets"
  769. >Socket functions</A
  770. ></DT
  771. ><DT
  772. >CI. <A
  773. HREF="#ref.stream"
  774. >Stream functions</A
  775. ></DT
  776. ><DT
  777. >CII. <A
  778. HREF="#ref.strings"
  779. >Funkce pro prßci s °et∞zci</A
  780. ></DT
  781. ><DT
  782. >CIII. <A
  783. HREF="#ref.sybase"
  784. >Sybase functions</A
  785. ></DT
  786. ><DT
  787. >CIV. <A
  788. HREF="#ref.tidy"
  789. >tidy Functions</A
  790. ></DT
  791. ><DT
  792. >CV. <A
  793. HREF="#ref.tokenizer"
  794. >Tokenizer functions</A
  795. ></DT
  796. ><DT
  797. >CVI. <A
  798. HREF="#ref.url"
  799. >URL funkce</A
  800. ></DT
  801. ><DT
  802. >CVII. <A
  803. HREF="#ref.variables"
  804. >Variable Functions</A
  805. ></DT
  806. ><DT
  807. >CVIII. <A
  808. HREF="#ref.vpopmail"
  809. >vpopmail functions</A
  810. ></DT
  811. ><DT
  812. >CIX. <A
  813. HREF="#ref.w32api"
  814. >W32api functions</A
  815. ></DT
  816. ><DT
  817. >CX. <A
  818. HREF="#ref.wddx"
  819. >WDDX funkce</A
  820. ></DT
  821. ><DT
  822. >CXI. <A
  823. HREF="#ref.xml"
  824. >XML parser functions</A
  825. ></DT
  826. ><DT
  827. >CXII. <A
  828. HREF="#ref.xmlrpc"
  829. >XML-RPC functions</A
  830. ></DT
  831. ><DT
  832. >CXIII. <A
  833. HREF="#ref.xslt"
  834. >XSLT funkce</A
  835. ></DT
  836. ><DT
  837. >CXIV. <A
  838. HREF="#ref.yaz"
  839. >YAZ functions</A
  840. ></DT
  841. ><DT
  842. >CXV. <A
  843. HREF="#ref.nis"
  844. >Funkce pro prßci s YP/NIS</A
  845. ></DT
  846. ><DT
  847. >CXVI. <A
  848. HREF="#ref.zip"
  849. >Zip File Functions (Read Only Access)</A
  850. ></DT
  851. ><DT
  852. >CXVII. <A
  853. HREF="#ref.zlib"
  854. >Zlib Compression Functions</A
  855. ></DT
  856. ></DL
  857. ></DD
  858. ><DT
  859. >VI. <A
  860. HREF="#zend"
  861. >Zend API</A
  862. ></DT
  863. ><DD
  864. ><DL
  865. ><DT
  866. >24. <A
  867. HREF="#zend.overview"
  868. >Overview</A
  869. ></DT
  870. ><DT
  871. >25. <A
  872. HREF="#zend.possibilities"
  873. >Extension Possibilities</A
  874. ></DT
  875. ><DT
  876. >26. <A
  877. HREF="#zend.layout"
  878. >Source Layout</A
  879. ></DT
  880. ><DT
  881. >27. <A
  882. HREF="#zend.build"
  883. >PHP's Automatic Build System</A
  884. ></DT
  885. ><DT
  886. >28. <A
  887. HREF="#zend.creating"
  888. >Creating Extensions</A
  889. ></DT
  890. ><DT
  891. >29. <A
  892. HREF="#zend.using"
  893. >Using Extensions</A
  894. ></DT
  895. ><DT
  896. >30. <A
  897. HREF="#zend.troubleshooting"
  898. >Troubleshooting</A
  899. ></DT
  900. ><DT
  901. >31. <A
  902. HREF="#zend.structure"
  903. >Source Discussion</A
  904. ></DT
  905. ><DT
  906. >32. <A
  907. HREF="#zend.arguments"
  908. >Accepting Arguments</A
  909. ></DT
  910. ><DT
  911. >33. <A
  912. HREF="#zend.variables"
  913. >Creating Variables</A
  914. ></DT
  915. ><DT
  916. >34. <A
  917. HREF="#zend.copy-constructor"
  918. >Duplicating Variable Contents: The Copy Constructor</A
  919. ></DT
  920. ><DT
  921. >35. <A
  922. HREF="#zend.returning"
  923. >Returning Values</A
  924. ></DT
  925. ><DT
  926. >36. <A
  927. HREF="#zend.printing"
  928. >Printing Information</A
  929. ></DT
  930. ><DT
  931. >37. <A
  932. HREF="#zend.startup-and-shutdown"
  933. >Startup and Shutdown Functions</A
  934. ></DT
  935. ><DT
  936. >38. <A
  937. HREF="#zend.calling-user-functions"
  938. >Calling User Functions</A
  939. ></DT
  940. ><DT
  941. >39. <A
  942. HREF="#zend.ini-file-support"
  943. >Initialization File Support</A
  944. ></DT
  945. ><DT
  946. >40. <A
  947. HREF="#zend.where-to-go"
  948. >Where to Go from Here</A
  949. ></DT
  950. ><DT
  951. >41. <A
  952. HREF="#zend.configuration-macros"
  953. >Reference: Some Configuration Macros</A
  954. ></DT
  955. ><DT
  956. >42. <A
  957. HREF="#zend.api-macros"
  958. >API Macros</A
  959. ></DT
  960. ></DL
  961. ></DD
  962. ><DT
  963. >VII. <A
  964. HREF="#api"
  965. >PHP API: Interfaces for extension writers</A
  966. ></DT
  967. ><DD
  968. ><DL
  969. ><DT
  970. >43. <A
  971. HREF="#streams"
  972. >Streams API for PHP Extension Authors</A
  973. ></DT
  974. ></DL
  975. ></DD
  976. ><DT
  977. >VIII. <A
  978. HREF="#faq"
  979. >FAQ: ╚asto zodpovφdanΘ otßzky</A
  980. ></DT
  981. ><DD
  982. ><DL
  983. ><DT
  984. >44. <A
  985. HREF="#faq.general"
  986. >ObecnΘ informace</A
  987. ></DT
  988. ><DT
  989. >45. <A
  990. HREF="#faq.mailinglist"
  991. >E-mailovΘ konference (mailing lists)</A
  992. ></DT
  993. ><DT
  994. >46. <A
  995. HREF="#faq.obtaining"
  996. >Zφskßnφ PHP</A
  997. ></DT
  998. ><DT
  999. >47. <A
  1000. HREF="#faq.databases"
  1001. >Zßle╛itosti databßzφ</A
  1002. ></DT
  1003. ><DT
  1004. >48. <A
  1005. HREF="#faq.installation"
  1006. >Instalace</A
  1007. ></DT
  1008. ><DT
  1009. >49. <A
  1010. HREF="#faq.build"
  1011. >Sestavovacφ (kompilaΦnφ) problΘmy</A
  1012. ></DT
  1013. ><DT
  1014. >50. <A
  1015. HREF="#faq.using"
  1016. >Pou╛φvßnφ PHP</A
  1017. ></DT
  1018. ><DT
  1019. >51. <A
  1020. HREF="#faq.html"
  1021. >PHP a HTML</A
  1022. ></DT
  1023. ><DT
  1024. >52. <A
  1025. HREF="#faq.com"
  1026. >PHP a COM</A
  1027. ></DT
  1028. ><DT
  1029. >53. <A
  1030. HREF="#faq.languages"
  1031. >PHP a jinΘ jazyky</A
  1032. ></DT
  1033. ><DT
  1034. >54. <A
  1035. HREF="#faq.migration"
  1036. >P°echod z PHP 2 na PHP 3</A
  1037. ></DT
  1038. ><DT
  1039. >55. <A
  1040. HREF="#faq.migration4"
  1041. >P°echod z PHP 3 na PHP 4</A
  1042. ></DT
  1043. ><DT
  1044. >56. <A
  1045. HREF="#faq.misc"
  1046. >Ostatnφ otßzky</A
  1047. ></DT
  1048. ></DL
  1049. ></DD
  1050. ><DT
  1051. >IX. <A
  1052. HREF="#appendixes"
  1053. >Dodatky</A
  1054. ></DT
  1055. ><DD
  1056. ><DL
  1057. ><DT
  1058. >A. <A
  1059. HREF="#history"
  1060. >Historie PHP a souvisejφcφch projekt∙</A
  1061. ></DT
  1062. ><DT
  1063. >B. <A
  1064. HREF="#migration4"
  1065. >P°echod z PHP 3 na PHP 4</A
  1066. ></DT
  1067. ><DT
  1068. >C. <A
  1069. HREF="#migration"
  1070. >P°echod z PHP/FI 2 na PHP 3</A
  1071. ></DT
  1072. ><DT
  1073. >D. <A
  1074. HREF="#debugger"
  1075. >Lad∞nφ (debugging) PHP</A
  1076. ></DT
  1077. ><DT
  1078. >E. <A
  1079. HREF="#phpdevel"
  1080. >Extending PHP 3</A
  1081. ></DT
  1082. ><DT
  1083. >F. <A
  1084. HREF="#aliases"
  1085. >Seznam alias∙ funkcφ</A
  1086. ></DT
  1087. ><DT
  1088. >G. <A
  1089. HREF="#reserved"
  1090. >Seznam vyhrazen²ch slov</A
  1091. ></DT
  1092. ><DT
  1093. >H. <A
  1094. HREF="#resource"
  1095. >List of Resource Types</A
  1096. ></DT
  1097. ><DT
  1098. >I. <A
  1099. HREF="#wrappers"
  1100. >List of Supported Protocols/Wrappers</A
  1101. ></DT
  1102. ><DT
  1103. >J. <A
  1104. HREF="#transports"
  1105. >List of Supported Socket Transports</A
  1106. ></DT
  1107. ><DT
  1108. >K. <A
  1109. HREF="#types.comparisons"
  1110. >PHP type comparison tables</A
  1111. ></DT
  1112. ><DT
  1113. >L. <A
  1114. HREF="#tokens"
  1115. >List of Parser Tokens</A
  1116. ></DT
  1117. ><DT
  1118. >M. <A
  1119. HREF="#about"
  1120. >O tomto manußlu</A
  1121. ></DT
  1122. ><DT
  1123. >N. <A
  1124. HREF="#opl.license"
  1125. >Open Publication License</A
  1126. ></DT
  1127. ><DT
  1128. >O. <A
  1129. HREF="#indexes"
  1130. >Rejst°φk funkcφ</A
  1131. ></DT
  1132. ><DT
  1133. >P. <A
  1134. HREF="#missing-stuff"
  1135. >Co zde chybφ</A
  1136. ></DT
  1137. ></DL
  1138. ></DD
  1139. ></DL
  1140. ></DIV
  1141. ><DIV
  1142. CLASS="preface"
  1143. ><HR><H1
  1144. ><A
  1145. NAME="preface"
  1146. >P°edmluva</A
  1147. ></H1
  1148. ><BLOCKQUOTE
  1149. CLASS="ABSTRACT"
  1150. ><DIV
  1151. CLASS="abstract"
  1152. ><A
  1153. NAME="AEN53"
  1154. ></A
  1155. ><P
  1156. ></P
  1157. ><P
  1158. >     <SPAN
  1159. CLASS="acronym"
  1160. >PHP</SPAN
  1161. >, co╛ znamenß "PHP: Hypertext
  1162.     Preprocessor", je ╣iroce pou╛φvan² mnoho·Φelov² skriptovacφ jazyk,
  1163.     ╣φ°en² pod Open Source licencφ, zvlß╣╗ vhodn² pro v²voj WWW aplikacφ a
  1164.     zp∙sobil² pro vklßdßnφ do HTML. Velkß Φßst jeho syntaxe je vyp∙jΦenß z C,
  1165.     Javy a Perlu. Cφlem tohoto jazyka je je umo╛nit webov²m v²vojß°um rychle
  1166.     psßt dynamicky generovanΘ strßnky - ale s PHP m∙╛ete d∞lat mnohem vφc!
  1167.    </P
  1168. ><P
  1169. ></P
  1170. ></DIV
  1171. ></BLOCKQUOTE
  1172. ><P
  1173. >    Tento manußl je tvo°en p°edev╣φm referenΦnφ p°φruΦkou funkcφ, ale obsahuje
  1174.    takΘ refereΦnφ p°φruΦku jazyka, vysv∞tlenφ hlavnφch vlastnostφ a mo╛nostφ
  1175.    PHP a r∙znΘ dopl≥kovΘ informace.
  1176.   </P
  1177. ><P
  1178. >    Manußl si m∙╛ete stßhnout v r∙zn²ch formßtech na
  1179.    <A
  1180. HREF="http://www.php.net/docs.php"
  1181. TARGET="_top"
  1182. >http://www.php.net/docs.php</A
  1183. >. Soubory ke sta╛enφ
  1184.    se aktualizujφ v╛dy p°i zm∞n∞ obsahu. Vφce informacφ o tom, jak je tento
  1185.    manußl vytvß°en, najdete v dodatku
  1186.    <A
  1187. HREF="#about"
  1188. >'O manußlu'</A
  1189. >.
  1190.   </P
  1191. ></DIV
  1192. ><DIV
  1193. CLASS="PART"
  1194. ><A
  1195. NAME="getting-started"
  1196. ></A
  1197. ><DIV
  1198. CLASS="TITLEPAGE"
  1199. ><H1
  1200. CLASS="title"
  1201. >I. ZaΦφnßme</H1
  1202. ><DIV
  1203. CLASS="TOC"
  1204. ><DL
  1205. ><DT
  1206. ><B
  1207. >Obsah</B
  1208. ></DT
  1209. ><DT
  1210. >1. <A
  1211. HREF="#introduction"
  1212. >Introduction</A
  1213. ></DT
  1214. ><DT
  1215. >2. <A
  1216. HREF="#tutorial"
  1217. >A simple tutorial</A
  1218. ></DT
  1219. ><DT
  1220. >3. <A
  1221. HREF="#installation"
  1222. >Instalace</A
  1223. ></DT
  1224. ><DT
  1225. >4. <A
  1226. HREF="#configuration"
  1227. >Runtime Configuration</A
  1228. ></DT
  1229. ></DL
  1230. ></DIV
  1231. ></DIV
  1232. ><DIV
  1233. CLASS="chapter"
  1234. ><HR><H1
  1235. ><A
  1236. NAME="introduction"
  1237. >Kapitola 1. Introduction</A
  1238. ></H1
  1239. ><DIV
  1240. CLASS="sect1"
  1241. ><H2
  1242. CLASS="sect1"
  1243. ><A
  1244. NAME="intro-whatis"
  1245. ></A
  1246. >What is PHP?</H2
  1247. ><P
  1248. >     <SPAN
  1249. CLASS="acronym"
  1250. >PHP</SPAN
  1251. > (recursive acronym for "PHP: Hypertext
  1252.     Preprocessor") is a widely-used Open Source general-purpose
  1253.     scripting language that is especially suited for Web
  1254.     development and can be embedded into HTML.
  1255.    </P
  1256. ><P
  1257. >     Simple answer, but what does that mean? An example:
  1258.    </P
  1259. ><P
  1260. >     <TABLE
  1261. WIDTH="100%"
  1262. BORDER="0"
  1263. CELLPADDING="0"
  1264. CELLSPACING="0"
  1265. CLASS="EXAMPLE"
  1266. ><TR
  1267. ><TD
  1268. ><DIV
  1269. CLASS="example"
  1270. ><A
  1271. NAME="AEN70"
  1272. ></A
  1273. ><P
  1274. ><B
  1275. >P°φklad 1-1. An introductory example</B
  1276. ></P
  1277. ><TABLE
  1278. BORDER="0"
  1279. BGCOLOR="#E0E0E0"
  1280. CELLPADDING="5"
  1281. ><TR
  1282. ><TD
  1283. ><PRE
  1284. CLASS="php"
  1285. ><html>
  1286.     <head>
  1287.         <title>Example</title>
  1288.     </head>
  1289.     <body>
  1290.  
  1291.         <?php 
  1292.         echo "Hi, I'm a PHP script!"; 
  1293.         ?>
  1294.  
  1295.     </body>
  1296. </html></PRE
  1297. ></TD
  1298. ></TR
  1299. ></TABLE
  1300. ></DIV
  1301. ></TD
  1302. ></TR
  1303. ></TABLE
  1304. >
  1305.    </P
  1306. ><P
  1307. >     Notice how this is different from a script written in other
  1308.     languages like Perl or C -- instead of writing a program with lots
  1309.     of commands to output HTML, you write an HTML script with some
  1310.     embedded code to do something (in this case, output some
  1311.     text). The PHP code is enclosed in special <A
  1312. HREF="#language.basic-syntax.phpmode"
  1313. >start and end tags</A
  1314. >
  1315.     that allow you to jump into and out of "PHP mode".
  1316.    </P
  1317. ><P
  1318. >     What distinguishes PHP from something like client-side JavaScript
  1319.     is that the code is executed on the server. If you were to have a
  1320.     script similar to the above on your server, the client would receive
  1321.     the results of running that script, with no way of determining what
  1322.     the underlying code may be. You can even configure your web server
  1323.     to process all your HTML files with PHP, and then there's really no
  1324.     way that users can tell what you have up your sleeve.
  1325.    </P
  1326. ><P
  1327. >     The best things in using PHP are that it is extremely simple
  1328.     for a newcomer, but offers many advanced features for
  1329.     a professional programmer. Don't be afraid reading the long
  1330.     list of PHP's features. You can jump in, in a short time, and
  1331.     start writing simple scripts in a few hours.
  1332.    </P
  1333. ><P
  1334. >     Although PHP's development is focused on server-side scripting,
  1335.     you can do much more with it. Read on, and see more in the
  1336.     <A
  1337. HREF="#intro-whatcando"
  1338. >What can PHP do?</A
  1339. > section.
  1340.    </P
  1341. ></DIV
  1342. ><DIV
  1343. CLASS="sect1"
  1344. ><HR><H2
  1345. CLASS="sect1"
  1346. ><A
  1347. NAME="intro-whatcando"
  1348. ></A
  1349. >What can PHP do?</H2
  1350. ><P
  1351. >     Anything. PHP is mainly focused on server-side scripting,
  1352.     so you can do anything any other CGI program can do, such
  1353.     as collect form data, generate dynamic page content, or
  1354.     send and receive cookies. But PHP can do much more.
  1355.    </P
  1356. ><P
  1357. >     There are three main fields where PHP scripts are used.
  1358.     <P
  1359. ></P
  1360. ><UL
  1361. ><LI
  1362. ><P
  1363. >        Server-side scripting. This is the most traditional
  1364.        and main target field for PHP. You need three things
  1365.        to make this work. The PHP parser (CGI or server
  1366.        module), a webserver and a web browser. You need to
  1367.        run the webserver, with a connected PHP installation.
  1368.        You can access the PHP program output with a web browser,
  1369.        viewing the PHP page through the server. See the
  1370.        <A
  1371. HREF="#installation"
  1372. >installation instructions</A
  1373. >
  1374.        section for more information.
  1375.       </P
  1376. ></LI
  1377. ><LI
  1378. ><P
  1379. >        Command line scripting. You can make a PHP script
  1380.        to run it without any server or browser.
  1381.        You only need the PHP parser to use it this way.
  1382.        This type of usage is ideal for scripts regularly
  1383.        executed using cron (on *nix or Linux) or Task Scheduler (on
  1384.        Windows). These scripts can also be used for simple text
  1385.        processing tasks. See the section about 
  1386.        <A
  1387. HREF="#features.commandline"
  1388. >Command line usage of PHP</A
  1389. >
  1390.        for more information.
  1391.       </P
  1392. ></LI
  1393. ><LI
  1394. ><P
  1395. >        Writing client-side GUI applications. PHP is probably
  1396.        not the very best language to write windowing
  1397.        applications, but if you know PHP very well, and
  1398.        would like to use some advanced PHP features in
  1399.        your client-side applications you can also use
  1400.        PHP-GTK to write such programs. You also have the
  1401.        ability to write cross-platform applications this way.
  1402.        PHP-GTK is an extension to PHP, not available in
  1403.        the main distribution. If you are interested
  1404.        in PHP-GTK, visit <A
  1405. HREF="http://gtk.php.net/"
  1406. TARGET="_top"
  1407. >its
  1408.        own website</A
  1409. >.
  1410.       </P
  1411. ></LI
  1412. ></UL
  1413. >
  1414.    </P
  1415. ><P
  1416. >     PHP can be used on all major operating systems, including
  1417.     Linux, many Unix variants (including HP-UX, Solaris and OpenBSD),
  1418.     Microsoft Windows, Mac OS X, RISC OS, and probably others.
  1419.     PHP has also support for most of the web servers today. This
  1420.     includes Apache, Microsoft Internet Information Server,
  1421.     Personal Web Server, Netscape and iPlanet servers, Oreilly
  1422.     Website Pro server, Caudium, Xitami, OmniHTTPd, and many
  1423.     others. For the majority of the servers PHP has a module,
  1424.     for the others supporting the CGI standard, PHP can work
  1425.     as a CGI processor.
  1426.    </P
  1427. ><P
  1428. >     So with PHP, you have the freedom of choosing an operating
  1429.     system and a web server. Furthermore, you also have the choice
  1430.     of using procedural programming or object oriented
  1431.     programming, or a mixture of them. Although not every
  1432.     standard OOP feature is realized in the current version
  1433.     of PHP, many code libraries and large applications (including the
  1434.     PEAR library) are written only using OOP code.
  1435.    </P
  1436. ><P
  1437. >     With PHP you are not limited to output HTML. PHP's abilities
  1438.     includes outputting images, PDF files and even Flash movies
  1439.     (using libswf and Ming) generated on the fly. You can also
  1440.     output easily any text, such as XHTML and any other XML file.
  1441.     PHP can autogenerate these files, and save them in the file
  1442.     system, instead of printing it out, forming a server-side
  1443.     cache for your dynamic content.
  1444.    </P
  1445. ><P
  1446. >     One of the strongest and most significant feature in PHP is its
  1447.     support for a wide range of databases. Writing a database-enabled
  1448.     web page is incredibly simple. The following databases are currently
  1449.     supported:
  1450.     <A
  1451. NAME="AEN97"
  1452. ></A
  1453. ><BLOCKQUOTE
  1454. CLASS="BLOCKQUOTE"
  1455. ><P
  1456. ></P
  1457. ><TABLE
  1458. BORDER="0"
  1459. ><TBODY
  1460. ><TR
  1461. ><TD
  1462. >Adabas D</TD
  1463. ><TD
  1464. >Ingres</TD
  1465. ><TD
  1466. >Oracle (OCI7 and OCI8)</TD
  1467. ></TR
  1468. ><TR
  1469. ><TD
  1470. >dBase</TD
  1471. ><TD
  1472. >InterBase</TD
  1473. ><TD
  1474. >Ovrimos</TD
  1475. ></TR
  1476. ><TR
  1477. ><TD
  1478. >Empress</TD
  1479. ><TD
  1480. >FrontBase</TD
  1481. ><TD
  1482. >PostgreSQL</TD
  1483. ></TR
  1484. ><TR
  1485. ><TD
  1486. >FilePro (read-only)</TD
  1487. ><TD
  1488. >mSQL</TD
  1489. ><TD
  1490. >Solid</TD
  1491. ></TR
  1492. ><TR
  1493. ><TD
  1494. >Hyperwave</TD
  1495. ><TD
  1496. >Direct MS-SQL</TD
  1497. ><TD
  1498. >Sybase</TD
  1499. ></TR
  1500. ><TR
  1501. ><TD
  1502. >IBM DB2</TD
  1503. ><TD
  1504. >MySQL</TD
  1505. ><TD
  1506. >Velocis</TD
  1507. ></TR
  1508. ><TR
  1509. ><TD
  1510. >Informix</TD
  1511. ><TD
  1512. >ODBC</TD
  1513. ><TD
  1514. >Unix dbm</TD
  1515. ></TR
  1516. ></TBODY
  1517. ></TABLE
  1518. ><P
  1519. ></P
  1520. ></BLOCKQUOTE
  1521. >
  1522.     We also have a DBX database abstraction extension allowing you
  1523.     to transparently use any database supported by that extension.
  1524.     Additionally PHP supports ODBC, the Open Database Connection
  1525.     standard, so you can connect to any other database supporting
  1526.     this world standard.
  1527.    </P
  1528. ><P
  1529. >     PHP also has support for talking to other services using protocols
  1530.     such as LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (on Windows) and
  1531.     countless others. You can also open raw network sockets and
  1532.     interact using any other protocol. PHP has support for the WDDX
  1533.     complex data exchange between virtually all Web programming
  1534.     languages. Talking about interconnection, PHP has support for
  1535.     instantiation of Java objects and using them transparently
  1536.     as PHP objects. You can also use our CORBA extension to
  1537.     access remote objects.
  1538.    </P
  1539. ><P
  1540. >     PHP has extremely useful text processing features, from the
  1541.     POSIX Extended or Perl regular expressions to parsing XML
  1542.     documents. For parsing and accessing XML documents, we
  1543.     support the SAX and DOM standards. You can use our XSLT
  1544.     extension to transform XML documents.
  1545.    </P
  1546. ><P
  1547. >     While using PHP in the e-commerce field, you'll find
  1548.     the Cybercash payment, CyberMUT, VeriSign Payflow
  1549.     Pro and CCVS functions useful for your online payment
  1550.     programs.
  1551.    </P
  1552. ><P
  1553. >     At last but not least, we have many other interesting
  1554.     extensions, the mnoGoSearch search engine functions,
  1555.     the IRC Gateway functions, many compression utilities
  1556.     (gzip, bz2), calendar conversion, translation...
  1557.    </P
  1558. ><P
  1559. >     As you can see this page is not enough to list all
  1560.     the features and benefits PHP can offer. Read on in
  1561.     the sections about <A
  1562. HREF="#installation"
  1563. >installing
  1564.     PHP</A
  1565. >, and see the <A
  1566. HREF="#funcref"
  1567. >function
  1568.     reference</A
  1569. > part for explanation of the extensions
  1570.     mentioned here.
  1571.    </P
  1572. ></DIV
  1573. ></DIV
  1574. ><DIV
  1575. CLASS="chapter"
  1576. ><HR><H1
  1577. ><A
  1578. NAME="tutorial"
  1579. >Kapitola 2. A simple tutorial</A
  1580. ></H1
  1581. ><P
  1582. >    Here we would like to show the very basics of PHP in a short, simple
  1583.    tutorial. This text only deals with dynamic webpage creation with
  1584.    PHP, though PHP is not only capable of creating webpages. See
  1585.    the section titled <A
  1586. HREF="#intro-whatcando"
  1587. >What can PHP
  1588.    do</A
  1589. > for more information.
  1590.   </P
  1591. ><P
  1592. >    PHP-enabled web pages are treated just like regular HTML pages and
  1593.    you can create and edit them the same way you normally create
  1594.    regular HTML pages.
  1595.   </P
  1596. ><DIV
  1597. CLASS="sect1"
  1598. ><HR><H2
  1599. CLASS="sect1"
  1600. ><A
  1601. NAME="tutorial.requirements"
  1602. ></A
  1603. >What do I need?</H2
  1604. ><P
  1605. >     In this tutorial we assume that your server has activated support 
  1606.     for PHP and that all files ending in <TT
  1607. CLASS="filename"
  1608. >.php</TT
  1609. >
  1610.     are handled by PHP. On most servers, this is the default extension
  1611.     for PHP files, but ask your server administrator to be sure. If
  1612.     your server supports PHP, then you do not need to do anything. Just
  1613.     create your <TT
  1614. CLASS="filename"
  1615. >.php</TT
  1616. > files, put them in your
  1617.     web directory and the server will automatically parse them for you.
  1618.     There is no need to compile anything nor do you need to install
  1619.     any extra tools. Think of these PHP-enabled files as simple HTML
  1620.     files with a whole new family of magical tags that let you do all
  1621.     sorts of things.  Most web hosts offer PHP support, but if your
  1622.     host does not consider reading the <A
  1623. HREF="http://www.php.net/links.php"
  1624. TARGET="_top"
  1625. >     PHP Links</A
  1626. > section for resources on finding PHP enabled
  1627.     web hosts.
  1628.    </P
  1629. ><P
  1630. >     Let us say you want to save precious bandwidth and develop locally.  
  1631.     In this case, you will want to install a web server, such as 
  1632.     <A
  1633. HREF="#install.apache"
  1634. >Apache</A
  1635. >, and of course 
  1636.     <A
  1637. HREF="http://www.php.net/downloads.php"
  1638. TARGET="_top"
  1639. >PHP</A
  1640. >.  You will most likely 
  1641.     want to install a database as well, such as 
  1642.     <A
  1643. HREF="http://www.mysql.com/documentation/"
  1644. TARGET="_top"
  1645. >MySQL</A
  1646. >.  You can either install 
  1647.     these individually or choose a simpler way. <A
  1648. HREF="http://www.hotscripts.com/PHP/Software_and_Servers/Installation_Kits/"
  1649. TARGET="_top"
  1650. >Locate a pre-configured package</A
  1651. > 
  1652.     which automatically installs all of these with just a few mouse
  1653.     clicks.  It is easy to setup a web server with PHP support on
  1654.     any operating system, including Linux and Windows.  On Linux,
  1655.     you may find <A
  1656. HREF="http://www.rpmfind.net/"
  1657. TARGET="_top"
  1658. >rpmfind</A
  1659. > and
  1660.     <A
  1661. HREF="http://rpm.pbone.net/"
  1662. TARGET="_top"
  1663. >PBone</A
  1664. > helpful for
  1665.     locating RPMs.
  1666.    </P
  1667. ></DIV
  1668. ><DIV
  1669. CLASS="sect1"
  1670. ><HR><H2
  1671. CLASS="sect1"
  1672. ><A
  1673. NAME="tutorial.firstpage"
  1674. ></A
  1675. >Your first PHP-enabled page</H2
  1676. ><P
  1677. >     Create a file named <TT
  1678. CLASS="filename"
  1679. >hello.php</TT
  1680. > and put it
  1681.     in your web servers root directory (<TT
  1682. CLASS="varname"
  1683. >DOCUMENT_ROOT</TT
  1684. >) 
  1685.     with the following content:
  1686.    </P
  1687. ><P
  1688. >     <TABLE
  1689. WIDTH="100%"
  1690. BORDER="0"
  1691. CELLPADDING="0"
  1692. CELLSPACING="0"
  1693. CLASS="EXAMPLE"
  1694. ><TR
  1695. ><TD
  1696. ><DIV
  1697. CLASS="example"
  1698. ><A
  1699. NAME="AEN151"
  1700. ></A
  1701. ><P
  1702. ><B
  1703. >P°φklad 2-1. Our first PHP script: <TT
  1704. CLASS="filename"
  1705. >hello.php</TT
  1706. ></B
  1707. ></P
  1708. ><TABLE
  1709. BORDER="0"
  1710. BGCOLOR="#E0E0E0"
  1711. CELLPADDING="5"
  1712. ><TR
  1713. ><TD
  1714. ><PRE
  1715. CLASS="php"
  1716. ><html>
  1717.  <head>
  1718.   <title>PHP Test</title>
  1719.  </head>
  1720.  <body>
  1721.  <?php echo "<p>Hello World</p>"; ?>
  1722.  </body>
  1723. </html></PRE
  1724. ></TD
  1725. ></TR
  1726. ></TABLE
  1727. ><P
  1728. >       Use your browser to access the file with your web access URL, ending
  1729.       with the "/hello.php" file reference.  When developing locally this
  1730.       url will be something like <TT
  1731. CLASS="literal"
  1732. >http://localhost/hello.php</TT
  1733. > 
  1734.       or <TT
  1735. CLASS="literal"
  1736. >http://127.0.0.1/hello.php</TT
  1737. > but this depends on the
  1738.       web servers configuration.  Although this is outside the scope of this
  1739.       tutorial, see also the <TT
  1740. CLASS="varname"
  1741. >DocumentRoot</TT
  1742. > and
  1743.       <TT
  1744. CLASS="varname"
  1745. >ServerName</TT
  1746. > directives in your web server's
  1747.       configuration file (for Apache, this is <TT
  1748. CLASS="filename"
  1749. >httpd.conf</TT
  1750. >).
  1751.       If everything is configured correctly, this file will be parsed by PHP 
  1752.       and the following output will be sent to your browser:
  1753.      </P
  1754. ><TABLE
  1755. BORDER="0"
  1756. BGCOLOR="#E0E0E0"
  1757. CELLPADDING="5"
  1758. ><TR
  1759. ><TD
  1760. ><PRE
  1761. CLASS="html"
  1762. ><html>
  1763.  <head>
  1764.   <title>PHP Test</title>
  1765.  </head>
  1766.  <body>
  1767.  <p>Hello World</p>
  1768.  </body>
  1769. </html></PRE
  1770. ></TD
  1771. ></TR
  1772. ></TABLE
  1773. ></DIV
  1774. ></TD
  1775. ></TR
  1776. ></TABLE
  1777. >
  1778.    </P
  1779. ><P
  1780. >     Note that this is not like a CGI script. The file does not need to be
  1781.     executable or special in any way. Think of it as a normal HTML
  1782.     file which happens to have a set of special tags available to you
  1783.     that do a lot of interesting things.
  1784.    </P
  1785. ><P
  1786. >     This program is extremely simple and you really did not need to use
  1787.     PHP to create a page like this. All it does is display:
  1788.     <TT
  1789. CLASS="literal"
  1790. >Hello World</TT
  1791. > using the PHP <A
  1792. HREF="#function.echo"
  1793. ><B
  1794. CLASS="function"
  1795. >echo()</B
  1796. ></A
  1797. >
  1798.     statement.
  1799.    </P
  1800. ><P
  1801. >     If you tried this example and it did not output anything, or it prompted 
  1802.     for download, or you see the whole file as text, chances are that the 
  1803.     server you are on does not have PHP enabled. Ask your administrator 
  1804.     to enable it for you using the
  1805.     <A
  1806. HREF="#installation"
  1807. >Installation</A
  1808. > chapter 
  1809.     of the manual.  If you are developing locally, also read the
  1810.     installation chapter to make sure everything is configured
  1811.     properly.  If problems continue to persist, do not hesitate to use one of
  1812.     the many <A
  1813. HREF="http://www.php.net/support.php"
  1814. TARGET="_top"
  1815. >PHP support</A
  1816. > options.
  1817.    </P
  1818. ><P
  1819. >     The point of the example is to show the special PHP tag format.
  1820.     In this example we used <TT
  1821. CLASS="literal"
  1822. ><?php</TT
  1823. > to indicate the
  1824.     start of a PHP tag. Then we put the PHP statement and left PHP mode by
  1825.     adding the closing tag, <TT
  1826. CLASS="literal"
  1827. >?></TT
  1828. >. You may jump in
  1829.     and out of PHP mode in an HTML file like this all you want.  For more
  1830.     details, read the manual section on <A
  1831. HREF="#language.basic-syntax"
  1832. >     basic PHP syntax</A
  1833. >.
  1834.    </P
  1835. ><DIV
  1836. CLASS="note"
  1837. ><BLOCKQUOTE
  1838. CLASS="note"
  1839. ><P
  1840. ><B
  1841. >A Note on Text Editors: </B
  1842. >
  1843.      There are many text editors and Integrated Development Environments (IDEs)
  1844.      that you can use to create, edit and manage PHP files. A partial list of 
  1845.      these tools is maintained at <A
  1846. HREF="http://phpeditors.linuxbackup.co.uk/"
  1847. TARGET="_top"
  1848. >PHP Editor's
  1849.      List</A
  1850. >. If you wish to recommend an editor, please visit the above
  1851.      page and ask the page maintainer to add the editor to the list.  Having
  1852.      an editor with syntax highlighting can be helpful.
  1853.     </P
  1854. ></BLOCKQUOTE
  1855. ></DIV
  1856. ><DIV
  1857. CLASS="note"
  1858. ><BLOCKQUOTE
  1859. CLASS="note"
  1860. ><P
  1861. ><B
  1862. >A Note on Word Processors: </B
  1863. >
  1864.      Word processors such as StarOffice Writer, Microsoft Word and Abiword are
  1865.      not optimal for editing PHP files.  If you wish to use one for this 
  1866.      test script, you must ensure that you save the file as PLAIN TEXT or PHP 
  1867.      will not be able to read and execute the script.
  1868.     </P
  1869. ></BLOCKQUOTE
  1870. ></DIV
  1871. ><DIV
  1872. CLASS="note"
  1873. ><BLOCKQUOTE
  1874. CLASS="note"
  1875. ><P
  1876. ><B
  1877. >A Note on Windows Notepad: </B
  1878. >    
  1879.      If you are writing your PHP scripts using Windows Notepad, you will need
  1880.      to ensure that your files are saved with the .php extension. (Notepad adds
  1881.      a .txt extension to files automatically unless you take one of the
  1882.      following steps to prevent it.)  When you save the file and are prompted
  1883.      to provide a name for the file, place the filename in quotes 
  1884.      (i.e. "<TT
  1885. CLASS="filename"
  1886. >hello.php</TT
  1887. >").  Alternately, you can click on the 
  1888.      'Text Documents' drop-down menu in the save dialog box and change the setting 
  1889.      to "All Files". You can then enter your filename without quotes.
  1890.     </P
  1891. ></BLOCKQUOTE
  1892. ></DIV
  1893. ><P
  1894. >    Now that you have successfully created a working PHP script, it is
  1895.    time to create the most famous PHP script!  Make a call to the
  1896.    <A
  1897. HREF="#function.phpinfo"
  1898. ><B
  1899. CLASS="function"
  1900. >phpinfo()</B
  1901. ></A
  1902. > function and you will see a lot of useful
  1903.    information about your system and setup such as available
  1904.    <A
  1905. HREF="#language.variables.predefined"
  1906. >predefined variables</A
  1907. >, 
  1908.    loaded PHP modules, and <A
  1909. HREF="#configuration"
  1910. >configuration</A
  1911. >
  1912.    settings.  Take some time and review this important information.
  1913.   </P
  1914. ></DIV
  1915. ><DIV
  1916. CLASS="sect1"
  1917. ><HR><H2
  1918. CLASS="sect1"
  1919. ><A
  1920. NAME="tutorial.useful"
  1921. ></A
  1922. >Something Useful</H2
  1923. ><P
  1924. >     Let us do something more useful now. We are going to check
  1925.     what sort of browser the visitor is using.
  1926.     For that, we check the user agent string the browser
  1927.     sends as part of the HTTP request. This information is stored in a <A
  1928. HREF="#language.variables"
  1929. >variable</A
  1930. >. Variables always start
  1931.     with a dollar-sign in PHP. The variable we are interested in right now 
  1932.     is <TT
  1933. CLASS="varname"
  1934. >$_SERVER["HTTP_USER_AGENT"]</TT
  1935. >.
  1936.    </P
  1937. ><DIV
  1938. CLASS="note"
  1939. ><BLOCKQUOTE
  1940. CLASS="note"
  1941. ><P
  1942. ><B
  1943. >Poznßmka: </B
  1944. >
  1945.      <A
  1946. HREF="#reserved.variables.server"
  1947. >$_SERVER</A
  1948. > is a 
  1949.      special reserved PHP variable that contains all web server information.
  1950.      It is known as an autoglobal (or superglobal).  See the related manual page on
  1951.      <A
  1952. HREF="#language.variables.superglobals"
  1953. >autoglobals</A
  1954. >
  1955.      for more information.  These special variables were introduced in PHP 
  1956.      <A
  1957. HREF="http://www.php.net/release_4_1_0.php"
  1958. TARGET="_top"
  1959. >4.1.0</A
  1960. >.  Before this time, we used
  1961.      the older <TT
  1962. CLASS="varname"
  1963. >$HTTP_*_VARS</TT
  1964. > arrays instead,
  1965.      such as <TT
  1966. CLASS="varname"
  1967. >$HTTP_SERVER_VARS</TT
  1968. >.  Although deprecated, 
  1969.      these older variables still exist.  (See also the note on
  1970.      <A
  1971. HREF="#tutorial.oldcode"
  1972. >old code</A
  1973. >.)
  1974.     </P
  1975. ></BLOCKQUOTE
  1976. ></DIV
  1977. ><P
  1978. >     To display this variable, you can simply do:
  1979.    </P
  1980. ><P
  1981. >     <TABLE
  1982. WIDTH="100%"
  1983. BORDER="0"
  1984. CELLPADDING="0"
  1985. CELLSPACING="0"
  1986. CLASS="EXAMPLE"
  1987. ><TR
  1988. ><TD
  1989. ><DIV
  1990. CLASS="example"
  1991. ><A
  1992. NAME="AEN203"
  1993. ></A
  1994. ><P
  1995. ><B
  1996. >P°φklad 2-2. Printing a variable (Array element)</B
  1997. ></P
  1998. ><TABLE
  1999. BORDER="0"
  2000. BGCOLOR="#E0E0E0"
  2001. CELLPADDING="5"
  2002. ><TR
  2003. ><TD
  2004. ><PRE
  2005. CLASS="php"
  2006. ><?php echo $_SERVER["HTTP_USER_AGENT"]; ?></PRE
  2007. ></TD
  2008. ></TR
  2009. ></TABLE
  2010. ><P
  2011. >      A sample output of this script may be:
  2012.     </P
  2013. ><TABLE
  2014. BORDER="0"
  2015. BGCOLOR="#E0E0E0"
  2016. CELLPADDING="5"
  2017. ><TR
  2018. ><TD
  2019. ><PRE
  2020. CLASS="html"
  2021. >Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)</PRE
  2022. ></TD
  2023. ></TR
  2024. ></TABLE
  2025. ></DIV
  2026. ></TD
  2027. ></TR
  2028. ></TABLE
  2029. >
  2030.    </P
  2031. ><P
  2032. >     There are many <A
  2033. HREF="#language.types"
  2034. >types</A
  2035. > of 
  2036.     variables available in PHP.  In the above example we printed 
  2037.     an <A
  2038. HREF="#language.types.array"
  2039. >Array</A
  2040. > element.
  2041.     Arrays can be very useful.
  2042.    </P
  2043. ><P
  2044. >     <TT
  2045. CLASS="varname"
  2046. >$_SERVER</TT
  2047. > is just one variable that is automatically 
  2048.     made available to you by PHP.  A list can be seen in the 
  2049.     <A
  2050. HREF="#reserved.variables"
  2051. >Reserved Variables</A
  2052. > section 
  2053.     of the manual or you can get a complete list of them by creating
  2054.     a file that looks like this:
  2055.    </P
  2056. ><P
  2057. >     <TABLE
  2058. WIDTH="100%"
  2059. BORDER="0"
  2060. CELLPADDING="0"
  2061. CELLSPACING="0"
  2062. CLASS="EXAMPLE"
  2063. ><TR
  2064. ><TD
  2065. ><DIV
  2066. CLASS="example"
  2067. ><A
  2068. NAME="AEN215"
  2069. ></A
  2070. ><P
  2071. ><B
  2072. >P°φklad 2-3. Show all predefined variables with <A
  2073. HREF="#function.phpinfo"
  2074. ><B
  2075. CLASS="function"
  2076. >phpinfo()</B
  2077. ></A
  2078. ></B
  2079. ></P
  2080. ><TABLE
  2081. BORDER="0"
  2082. BGCOLOR="#E0E0E0"
  2083. CELLPADDING="5"
  2084. ><TR
  2085. ><TD
  2086. ><PRE
  2087. CLASS="php"
  2088. ><?php phpinfo(); ?></PRE
  2089. ></TD
  2090. ></TR
  2091. ></TABLE
  2092. ></DIV
  2093. ></TD
  2094. ></TR
  2095. ></TABLE
  2096. >
  2097.    </P
  2098. ><P
  2099. >     When you load up this file in your browser, you will see a page
  2100.     full of information about PHP along with a list of all the
  2101.     variables available to you.
  2102.    </P
  2103. ><P
  2104. >     You can put multiple PHP statements inside a PHP tag and create
  2105.     little blocks of code that do more than just a single echo.
  2106.     For example, if you want to check for Internet Explorer you
  2107.     can do this:
  2108.    </P
  2109. ><P
  2110. >     <TABLE
  2111. WIDTH="100%"
  2112. BORDER="0"
  2113. CELLPADDING="0"
  2114. CELLSPACING="0"
  2115. CLASS="EXAMPLE"
  2116. ><TR
  2117. ><TD
  2118. ><DIV
  2119. CLASS="example"
  2120. ><A
  2121. NAME="AEN222"
  2122. ></A
  2123. ><P
  2124. ><B
  2125. >P°φklad 2-4. Example using <A
  2126. HREF="#control-structures"
  2127. >control 
  2128.      structures</A
  2129. > and <A
  2130. HREF="#functions"
  2131. >functions</A
  2132. ></B
  2133. ></P
  2134. ><TABLE
  2135. BORDER="0"
  2136. BGCOLOR="#E0E0E0"
  2137. CELLPADDING="5"
  2138. ><TR
  2139. ><TD
  2140. ><PRE
  2141. CLASS="php"
  2142. ><?php
  2143. if (strpos($_SERVER["HTTP_USER_AGENT"], "MSIE") !== false) {
  2144.     echo "You are using Internet Explorer<br />";
  2145. }
  2146. ?></PRE
  2147. ></TD
  2148. ></TR
  2149. ></TABLE
  2150. ><P
  2151. >       A sample output of this script may be:
  2152.      </P
  2153. ><TABLE
  2154. BORDER="0"
  2155. BGCOLOR="#E0E0E0"
  2156. CELLPADDING="5"
  2157. ><TR
  2158. ><TD
  2159. ><PRE
  2160. CLASS="html"
  2161. >You are using Internet Explorer<br /></PRE
  2162. ></TD
  2163. ></TR
  2164. ></TABLE
  2165. ></DIV
  2166. ></TD
  2167. ></TR
  2168. ></TABLE
  2169. >
  2170.    </P
  2171. ><P
  2172. >     Here we introduce a couple of new concepts. We have an 
  2173.     <A
  2174. HREF="#control-structures.if"
  2175. >if</A
  2176. > statement.
  2177.     If you are familiar with the basic syntax used by the C
  2178.     language, this should look logical to you. Otherwise, you
  2179.     should probably pick up any introductory PHP book and read the first
  2180.     couple of chapters, or read the <A
  2181. HREF="#langref"
  2182. >Language
  2183.     Reference</A
  2184. > part of the manual. You can find a list of PHP books
  2185.     at <A
  2186. HREF="http://www.php.net/books.php"
  2187. TARGET="_top"
  2188. >http://www.php.net/books.php</A
  2189. >.
  2190.    </P
  2191. ><P
  2192. >     The second concept we introduced was the <A
  2193. HREF="#function.strpos"
  2194. ><B
  2195. CLASS="function"
  2196. >strpos()</B
  2197. ></A
  2198. >
  2199.     function call. <A
  2200. HREF="#function.strpos"
  2201. ><B
  2202. CLASS="function"
  2203. >strpos()</B
  2204. ></A
  2205. > is a function built into
  2206.     PHP which searches a string for another string. In this case we are
  2207.     looking for <TT
  2208. CLASS="literal"
  2209. >"MSIE"</TT
  2210. > (so-called needle) inside
  2211.     <TT
  2212. CLASS="varname"
  2213. >$_SERVER["HTTP_USER_AGENT"]</TT
  2214. > (so-called haystack).  If
  2215.     the needle is found inside the haystack, the function returns the position
  2216.     of the needle relative to the start of the haystack.  Otherwise, it
  2217.     returns <TT
  2218. CLASS="constant"
  2219. ><B
  2220. >FALSE</B
  2221. ></TT
  2222. >.  If it does not return <TT
  2223. CLASS="constant"
  2224. ><B
  2225. >FALSE</B
  2226. ></TT
  2227. >, the <A
  2228. HREF="#control-structures.if"
  2229. >if</A
  2230. > expression evaluates to <TT
  2231. CLASS="constant"
  2232. ><B
  2233. >TRUE</B
  2234. ></TT
  2235. >
  2236.     and the code within its {braces} is executed. Otherwise, the code is not
  2237.     run. Feel free to create similar examples, 
  2238.     with <A
  2239. HREF="#control-structures.if"
  2240. >if</A
  2241. >, 
  2242.     <A
  2243. HREF="#control-structures.else"
  2244. >else</A
  2245. >, and other 
  2246.     functions such as <A
  2247. HREF="#function.strtoupper"
  2248. ><B
  2249. CLASS="function"
  2250. >strtoupper()</B
  2251. ></A
  2252. > and 
  2253.     <A
  2254. HREF="#function.strlen"
  2255. ><B
  2256. CLASS="function"
  2257. >strlen()</B
  2258. ></A
  2259. >.  Each related manual page contains examples 
  2260.     too.  If you are unsure how to use functions, you will want to read both
  2261.     the manual page on <A
  2262. HREF="#about.prototypes"
  2263. >how to read a
  2264.     function definition</A
  2265. > and the section about  
  2266.     <A
  2267. HREF="#functions"
  2268. >PHP functions</A
  2269. >.
  2270.    </P
  2271. ><P
  2272. >     We can take this a step further and show how you can jump in and out
  2273.     of PHP mode even in the middle of a PHP block:
  2274.    </P
  2275. ><P
  2276. >     <TABLE
  2277. WIDTH="100%"
  2278. BORDER="0"
  2279. CELLPADDING="0"
  2280. CELLSPACING="0"
  2281. CLASS="EXAMPLE"
  2282. ><TR
  2283. ><TD
  2284. ><DIV
  2285. CLASS="example"
  2286. ><A
  2287. NAME="AEN250"
  2288. ></A
  2289. ><P
  2290. ><B
  2291. >P°φklad 2-5. Mixing both HTML and PHP modes</B
  2292. ></P
  2293. ><TABLE
  2294. BORDER="0"
  2295. BGCOLOR="#E0E0E0"
  2296. CELLPADDING="5"
  2297. ><TR
  2298. ><TD
  2299. ><PRE
  2300. CLASS="php"
  2301. ><?php
  2302. if (strpos($_SERVER["HTTP_USER_AGENT"], "MSIE") !== false) {
  2303. ?>
  2304. <h3>strpos must have returned non-false</h3>
  2305. <center><b>You are using Internet Explorer</b></center>
  2306. <?php
  2307. } else {
  2308. ?>
  2309. <h3>strpos must have returned false</h3>
  2310. <center><b>You are not using Internet Explorer</b></center>
  2311. <?php
  2312. }
  2313. ?></PRE
  2314. ></TD
  2315. ></TR
  2316. ></TABLE
  2317. ><P
  2318. >       A sample output of this script may be:
  2319.      </P
  2320. ><TABLE
  2321. BORDER="0"
  2322. BGCOLOR="#E0E0E0"
  2323. CELLPADDING="5"
  2324. ><TR
  2325. ><TD
  2326. ><PRE
  2327. CLASS="html"
  2328. ><h3>strpos must have returned non-false</h3>
  2329. <center><b>You are using Internet Explorer</b></center></PRE
  2330. ></TD
  2331. ></TR
  2332. ></TABLE
  2333. ></DIV
  2334. ></TD
  2335. ></TR
  2336. ></TABLE
  2337. >
  2338.    </P
  2339. ><P
  2340. >     Instead of using a PHP echo statement to output something, we jumped out
  2341.     of PHP mode and just sent straight HTML. The important and powerful point
  2342.     to note here is that the logical flow of the script remains intact. Only
  2343.     one of the HTML blocks will end up getting sent to the viewer depending on
  2344.     the result of <A
  2345. HREF="#function.strpos"
  2346. ><B
  2347. CLASS="function"
  2348. >strpos()</B
  2349. ></A
  2350. >.  In other words, it depends on
  2351.     whether the string <TT
  2352. CLASS="literal"
  2353. >MSIE</TT
  2354. > was found or not.
  2355.    </P
  2356. ></DIV
  2357. ><DIV
  2358. CLASS="sect1"
  2359. ><HR><H2
  2360. CLASS="sect1"
  2361. ><A
  2362. NAME="tutorial.forms"
  2363. ></A
  2364. >Dealing with Forms</H2
  2365. ><P
  2366. >     One of the most powerful features of PHP is the way it handles HTML
  2367.     forms. The basic concept that is important to understand is that any
  2368.     form element in a form will automatically be available to your PHP 
  2369.     scripts.  Please read the manual section on
  2370.     <A
  2371. HREF="#language.variables.external"
  2372. >Variables from outside 
  2373.     of PHP</A
  2374. > for more information and examples on using forms 
  2375.     with PHP.  Here is an example HTML form:
  2376.    </P
  2377. ><P
  2378. >     <TABLE
  2379. WIDTH="100%"
  2380. BORDER="0"
  2381. CELLPADDING="0"
  2382. CELLSPACING="0"
  2383. CLASS="EXAMPLE"
  2384. ><TR
  2385. ><TD
  2386. ><DIV
  2387. CLASS="example"
  2388. ><A
  2389. NAME="AEN263"
  2390. ></A
  2391. ><P
  2392. ><B
  2393. >P°φklad 2-6. A simple HTML form</B
  2394. ></P
  2395. ><TABLE
  2396. BORDER="0"
  2397. BGCOLOR="#E0E0E0"
  2398. CELLPADDING="5"
  2399. ><TR
  2400. ><TD
  2401. ><PRE
  2402. CLASS="html"
  2403. ><form action="action.php" method="POST">
  2404.  Your name: <input type="text" name="name" />
  2405.  Your age: <input type="text" name="age" />
  2406.  <input type="submit">
  2407. </form></PRE
  2408. ></TD
  2409. ></TR
  2410. ></TABLE
  2411. ></DIV
  2412. ></TD
  2413. ></TR
  2414. ></TABLE
  2415. >
  2416.    </P
  2417. ><P
  2418. >     There is nothing special about this form. It is a straight HTML form
  2419.     with no special tags of any kind. When the user fills in this form
  2420.     and hits the submit button, the <TT
  2421. CLASS="filename"
  2422. >action.php</TT
  2423. > page
  2424.     is called. In this file you would have something like this:
  2425.    </P
  2426. ><P
  2427. >     <TABLE
  2428. WIDTH="100%"
  2429. BORDER="0"
  2430. CELLPADDING="0"
  2431. CELLSPACING="0"
  2432. CLASS="EXAMPLE"
  2433. ><TR
  2434. ><TD
  2435. ><DIV
  2436. CLASS="example"
  2437. ><A
  2438. NAME="AEN269"
  2439. ></A
  2440. ><P
  2441. ><B
  2442. >P°φklad 2-7. Printing data from our form</B
  2443. ></P
  2444. ><TABLE
  2445. BORDER="0"
  2446. BGCOLOR="#E0E0E0"
  2447. CELLPADDING="5"
  2448. ><TR
  2449. ><TD
  2450. ><PRE
  2451. CLASS="php"
  2452. >Hi <?php echo $_POST["name"]; ?>.
  2453. You are <?php echo $_POST["age"]; ?> years old.</PRE
  2454. ></TD
  2455. ></TR
  2456. ></TABLE
  2457. ><P
  2458. >       A sample output of this script may be:
  2459.      </P
  2460. ><TABLE
  2461. BORDER="0"
  2462. BGCOLOR="#E0E0E0"
  2463. CELLPADDING="5"
  2464. ><TR
  2465. ><TD
  2466. ><PRE
  2467. CLASS="html"
  2468. >Hi Joe.
  2469. You are 22 years old.</PRE
  2470. ></TD
  2471. ></TR
  2472. ></TABLE
  2473. ></DIV
  2474. ></TD
  2475. ></TR
  2476. ></TABLE
  2477. >
  2478.    </P
  2479. ><P
  2480. >     It should be obvious what this does. There is nothing more to it.
  2481.     The <TT
  2482. CLASS="varname"
  2483. >$_POST["name"]</TT
  2484. > and <TT
  2485. CLASS="varname"
  2486. >$_POST["age"]</TT
  2487. >
  2488.     variables are automatically set for you by PHP.  Earlier we
  2489.     used the <TT
  2490. CLASS="varname"
  2491. >$_SERVER</TT
  2492. > autoglobal, now above we just 
  2493.     introduced the <A
  2494. HREF="#reserved.variables.post"
  2495. >$_POST</A
  2496. >
  2497.     autoglobal which contains all POST data.  Notice how the
  2498.     <SPAN
  2499. CLASS="emphasis"
  2500. ><I
  2501. CLASS="emphasis"
  2502. >method</I
  2503. ></SPAN
  2504. > of our form is POST.  If we used the 
  2505.     method <SPAN
  2506. CLASS="emphasis"
  2507. ><I
  2508. CLASS="emphasis"
  2509. >GET</I
  2510. ></SPAN
  2511. > then our form information would live in 
  2512.     the <A
  2513. HREF="#reserved.variables.get"
  2514. >$_GET</A
  2515. > autoglobal instead.
  2516.     You may also use the <A
  2517. HREF="#reserved.variables.request"
  2518. >$_REQUEST</A
  2519. >
  2520.     autoglobal, if you do not care about the source of your request data. It 
  2521.     contains the merged information of GET, POST and COOKIE data.  Also see the 
  2522.     <A
  2523. HREF="#function.import-request-variables"
  2524. ><B
  2525. CLASS="function"
  2526. >import_request_variables()</B
  2527. ></A
  2528. > function.
  2529.    </P
  2530. ></DIV
  2531. ><DIV
  2532. CLASS="sect1"
  2533. ><HR><H2
  2534. CLASS="sect1"
  2535. ><A
  2536. NAME="tutorial.oldcode"
  2537. ></A
  2538. >Using old code with new versions of PHP</H2
  2539. ><P
  2540. >     Now that PHP has grown to be a popular scripting language, there are
  2541.     a lot of public repositories/libraries containing code you can reuse.
  2542.     The PHP developers have largely tried to preserve backwards compatibility, 
  2543.     so a script written for an older version will run (ideally) without changes
  2544.     in a newer version of PHP. In practice, some changes will usually be needed.
  2545.    </P
  2546. ><P
  2547. >     Two of the most important recent changes that affect old code are:
  2548.     <P
  2549. ></P
  2550. ><UL
  2551. ><LI
  2552. ><P
  2553. >        The deprecation of the old <TT
  2554. CLASS="varname"
  2555. >$HTTP_*_VARS</TT
  2556. > arrays
  2557.        (which need to be indicated as global when used inside a function or
  2558.        method).  The following 
  2559.        <A
  2560. HREF="#language.variables.superglobals"
  2561. >autoglobal arrays</A
  2562. >
  2563.        were introduced in PHP <A
  2564. HREF="http://www.php.net/release_4_1_0.php"
  2565. TARGET="_top"
  2566. >4.1.0</A
  2567. >. 
  2568.        They are: <TT
  2569. CLASS="varname"
  2570. >$_GET</TT
  2571. >, <TT
  2572. CLASS="varname"
  2573. >$_POST</TT
  2574. >, 
  2575.        <TT
  2576. CLASS="varname"
  2577. >$_COOKIE</TT
  2578. >, <TT
  2579. CLASS="varname"
  2580. >$_SERVER</TT
  2581. >, 
  2582.        <TT
  2583. CLASS="varname"
  2584. >$_FILES</TT
  2585. >, <TT
  2586. CLASS="varname"
  2587. >$_ENV</TT
  2588. >,
  2589.        <TT
  2590. CLASS="varname"
  2591. >$_REQUEST</TT
  2592. >, and <TT
  2593. CLASS="varname"
  2594. >$_SESSION</TT
  2595. >.  The
  2596.        older <TT
  2597. CLASS="varname"
  2598. >$HTTP_*_VARS</TT
  2599. > arrays, such as
  2600.        <TT
  2601. CLASS="varname"
  2602. >$HTTP_POST_VARS</TT
  2603. >, still exist and have since PHP 3. 
  2604.        
  2605.        Od PHP 5.0.0 mohou b²t dlouhΘ
  2606. <A
  2607. HREF="#language.variables.predefined"
  2608. >p°eddefinovanΘ pole</A
  2609. >
  2610. zakßzanΘ direktivou
  2611. <A
  2612. HREF="#ini.register-long-arrays"
  2613. >register_long_arrays</A
  2614. >.
  2615.       </P
  2616. ></LI
  2617. ><LI
  2618. ><P
  2619. >        External variables are no longer registered in the global scope by
  2620.        default.  In other words, as of PHP
  2621.        <A
  2622. HREF="http://www.php.net/release_4_2_0.php"
  2623. TARGET="_top"
  2624. >4.2.0</A
  2625. > the PHP directive 
  2626.        <A
  2627. HREF="#ini.register-globals"
  2628. >register_globals</A
  2629. > is 
  2630.        <SPAN
  2631. CLASS="emphasis"
  2632. ><I
  2633. CLASS="emphasis"
  2634. >off</I
  2635. ></SPAN
  2636. > by default in <TT
  2637. CLASS="filename"
  2638. >php.ini</TT
  2639. >. The preferred 
  2640.        method of accessing these values is via the autoglobal arrays mentioned
  2641.        above.  Older scripts, books, and tutorials may rely on this 
  2642.        directive being on.  If on, for example, one could use 
  2643.        <TT
  2644. CLASS="varname"
  2645. >$id</TT
  2646. > from the URL 
  2647.        <TT
  2648. CLASS="literal"
  2649. >http://www.example.com/foo.php?id=42</TT
  2650. >.  Whether on 
  2651.        or off, <TT
  2652. CLASS="varname"
  2653. >$_GET['id']</TT
  2654. > is available.
  2655.       </P
  2656. ></LI
  2657. ></UL
  2658. >
  2659.     For more details on these changes, see the section on 
  2660.     <A
  2661. HREF="#language.variables.predefined"
  2662. >predefined variables</A
  2663. >
  2664.     and links therein.
  2665.    </P
  2666. ></DIV
  2667. ><DIV
  2668. CLASS="sect1"
  2669. ><HR><H2
  2670. CLASS="sect1"
  2671. ><A
  2672. NAME="tutorial.whatsnext"
  2673. ></A
  2674. >What's next?</H2
  2675. ><P
  2676. >     With your new knowledge you should be able to understand most of 
  2677.     the manual and also the various example scripts available in the
  2678.     example archives. You can also find other examples on the php.net
  2679.     websites in the links section:
  2680.     <A
  2681. HREF="http://www.php.net/links.php"
  2682. TARGET="_top"
  2683. >http://www.php.net/links.php</A
  2684. >.
  2685.    </P
  2686. ><P
  2687. >     To view various slide presentations that show more of what PHP can do, 
  2688.     see the PHP Conference Material Sites: <A
  2689. HREF="http://conf.php.net/"
  2690. TARGET="_top"
  2691. >     http://conf.php.net/</A
  2692. > and <A
  2693. HREF="http://talks.php.net/"
  2694. TARGET="_top"
  2695. >http://talks.php.net/
  2696.     </A
  2697. >
  2698.    </P
  2699. ></DIV
  2700. ></DIV
  2701. ><DIV
  2702. CLASS="chapter"
  2703. ><HR><H1
  2704. ><A
  2705. NAME="installation"
  2706. >Kapitola 3. Instalace</A
  2707. ></H1
  2708. ><DIV
  2709. CLASS="sect1"
  2710. ><HR><H2
  2711. CLASS="sect1"
  2712. ><A
  2713. NAME="install.general"
  2714. ></A
  2715. >General Installation Considerations</H2
  2716. ><P
  2717. >     Before installing first, you need to know what do you
  2718.     want to use PHP for. There are three main fields you
  2719.     can use PHP, as described in the
  2720.     <A
  2721. HREF="#intro-whatcando"
  2722. >What can PHP do?</A
  2723. >
  2724.     section:
  2725.     <P
  2726. ></P
  2727. ><UL
  2728. ><LI
  2729. ><P
  2730. >Server-side scripting</P
  2731. ></LI
  2732. ><LI
  2733. ><P
  2734. >Command line scripting</P
  2735. ></LI
  2736. ><LI
  2737. ><P
  2738. >Client-side GUI applications</P
  2739. ></LI
  2740. ></UL
  2741. >
  2742.    </P
  2743. ><P
  2744. >     For the first and most common form, you need three things:
  2745.     PHP itself, a web server and a web browser. You
  2746.     probably already have a web browser, and depending on
  2747.     your operating system setup, you may also have a web
  2748.     server (e.g. Apache on Linux or IIS on Windows).
  2749.     You may also rent webspace at a company. This way, you
  2750.     don't need to set up anything on your own, only write
  2751.     your PHP scripts, upload it to the server you rent, and
  2752.     see the results in your browser. 
  2753.    </P
  2754. ><P
  2755. >     While setting up the server and PHP on your own, you have
  2756.     two choices for the method of connecting PHP to the
  2757.     server. For many servers PHP has a direct module
  2758.     interface (also called SAPI). These servers include
  2759.     Apache, Microsoft Internet Information Server,
  2760.     Netscape and iPlanet servers. Many other servers
  2761.     have support for ISAPI, the Microsoft module
  2762.     interface (OmniHTTPd for example). If PHP has no
  2763.     module support for your web server, you can always
  2764.     use it as a CGI processor. This means you set up
  2765.     your server to use the command line executable of
  2766.     PHP (<TT
  2767. CLASS="filename"
  2768. >php.exe</TT
  2769. > on Windows) to
  2770.     process all PHP file requests on the server.
  2771.    </P
  2772. ><P
  2773. >     If you are also interested to use PHP for command line
  2774.     scripting (e.g. write scripts autogenerating some images
  2775.     for you offline, or processing text files depending
  2776.     on some arguments you pass to them), you always need
  2777.     the command line executable. For more information, read
  2778.     the section about <A
  2779. HREF="#features.commandline"
  2780. >writing
  2781.     command line PHP applications</A
  2782. >. In this case,
  2783.     you need no server and no browser.
  2784.    </P
  2785. ><P
  2786. >     With PHP you can also write client side GUI applications
  2787.     using the PHP-GTK extension. This is a completely
  2788.     different approach than writing web pages, as you
  2789.     do not output any HTML, but manage windows and objects
  2790.     within them. For more information about PHP-GTK, please
  2791.     <A
  2792. HREF="http://gtk.php.net/"
  2793. TARGET="_top"
  2794. >visit the site dedicated to
  2795.     this extension</A
  2796. >. PHP-GTK is not included in the
  2797.     official PHP distribution.
  2798.    </P
  2799. ><P
  2800. >     From now on, this section deals with setting up PHP
  2801.     for web servers on Unix and Windows with server module
  2802.     interfaces and CGI executables.
  2803.    </P
  2804. ><P
  2805. >     Downloading PHP, the source code, and binary
  2806.     distributions for Windows can be found at
  2807.     <A
  2808. HREF="http://www.php.net/downloads.php"
  2809. TARGET="_top"
  2810. >http://www.php.net/downloads.php</A
  2811. >.
  2812.     We recommend you to choose a
  2813.     <A
  2814. HREF="http://www.php.net/mirrors.php"
  2815. TARGET="_top"
  2816. >mirror</A
  2817. > nearest
  2818.     to you for downloading the distributions.
  2819.    </P
  2820. ></DIV
  2821. ><DIV
  2822. CLASS="sect1"
  2823. ><HR><H2
  2824. CLASS="sect1"
  2825. ><A
  2826. NAME="install.hpux"
  2827. ></A
  2828. >Unix/HP-UX installs</H2
  2829. ><P
  2830. >     This section contains notes and hints specific to installing PHP
  2831.     on HP-UX systems. (Contributed by paul_mckay at clearwater-it dot co dot
  2832.     uk).
  2833.    </P
  2834. ><DIV
  2835. CLASS="note"
  2836. ><BLOCKQUOTE
  2837. CLASS="note"
  2838. ><P
  2839. ><B
  2840. >Poznßmka: </B
  2841. >
  2842.      These tips were written for PHP 4.0.4 and Apache 1.3.9.
  2843.     </P
  2844. ></BLOCKQUOTE
  2845. ></DIV
  2846. ><P
  2847. >     <P
  2848. ></P
  2849. ><OL
  2850. TYPE="1"
  2851. ><LI
  2852. ><P
  2853. >        You need gzip, download a binary distribution from
  2854.        <TT
  2855. CLASS="filename"
  2856. >http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z</TT
  2857. >
  2858.        uncompress the file and install using swinstall.
  2859.       </P
  2860. ></LI
  2861. ><LI
  2862. ><P
  2863. >        You need gcc, download a binary distribution from
  2864.        <TT
  2865. CLASS="filename"
  2866. >http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz</TT
  2867. >.
  2868.        uncompress this file and install gcc using swinstall.
  2869.       </P
  2870. ></LI
  2871. ><LI
  2872. ><P
  2873. >        You need the GNU binutils, you can download a binary distribution from
  2874.        <TT
  2875. CLASS="filename"
  2876. >http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz</TT
  2877. >.
  2878.        uncompress this file and install binutils using swinstall.
  2879.       </P
  2880. ></LI
  2881. ><LI
  2882. ><P
  2883. >        You now need bison, you can download a binary distribution from
  2884.        <TT
  2885. CLASS="filename"
  2886. >http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz</TT
  2887. >,
  2888.        install as above.
  2889.       </P
  2890. ></LI
  2891. ><LI
  2892. ><P
  2893. >        You now need flex, you need to download the source from one of the
  2894.        http://www.gnu.org mirrors. It is in the non-gnu directory of the ftp
  2895.        site.  Download the file, <B
  2896. CLASS="command"
  2897. >gunzip</B
  2898. >, then
  2899.        <B
  2900. CLASS="command"
  2901. >tar -xvf</B
  2902. > it. Go into the newly created flex directory
  2903.        and run <B
  2904. CLASS="command"
  2905. >./configure</B
  2906. >, followed by 
  2907.        <B
  2908. CLASS="command"
  2909. >make</B
  2910. >, and then <B
  2911. CLASS="command"
  2912. >make install</B
  2913. >.
  2914.       </P
  2915. ><P
  2916. >        If you have errors here, it's probably because gcc etc. are not in your
  2917.        PATH so add them to your PATH. 
  2918.       </P
  2919. ></LI
  2920. ><LI
  2921. ><P
  2922. >        Download the PHP and apache sources. 
  2923.       </P
  2924. ></LI
  2925. ><LI
  2926. ><P
  2927. >        <B
  2928. CLASS="command"
  2929. >gunzip</B
  2930. > and <B
  2931. CLASS="command"
  2932. >tar -xvf</B
  2933. > them. We
  2934.        need to hack a couple of files so that they can compile OK.
  2935.       </P
  2936. ></LI
  2937. ><LI
  2938. ><P
  2939. >        Firstly the configure file needs to be hacked because it seems to lose
  2940.        track of the fact that you are a hpux machine, there will be a better
  2941.        way of doing this but a cheap and cheerful hack is to put
  2942.        <TT
  2943. CLASS="literal"
  2944. >lt_target=hpux10.20</TT
  2945. > on line 47286 of the configure
  2946.        script.
  2947.       </P
  2948. ></LI
  2949. ><LI
  2950. ><P
  2951. >        Next, the Apache GuessOS file needs to be hacked. Under
  2952.        <TT
  2953. CLASS="filename"
  2954. >apache_1.3.9/src/helpers</TT
  2955. > change line 89 from <TT
  2956. CLASS="literal"
  2957. >echo
  2958.        "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0</TT
  2959. > to: <TT
  2960. CLASS="literal"
  2961. >echo
  2962.        "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0</TT
  2963. >
  2964.       </P
  2965. ></LI
  2966. ><LI
  2967. ><P
  2968. >        You cannot install PHP as a shared object under HP-UX so you must
  2969.        compile it as a static, just follow the instructions at the Apache
  2970.        page. 
  2971.       </P
  2972. ></LI
  2973. ><LI
  2974. ><P
  2975. >        PHP and Apache should have compiled OK, but Apache won't start. you
  2976.        need to create a new user for Apache, e.g. www, or apache. You then
  2977.        change lines 252 and 253 of the <TT
  2978. CLASS="filename"
  2979. >conf/httpd.conf</TT
  2980. > in
  2981.        Apache so that instead of
  2982.       </P
  2983. ><TABLE
  2984. BORDER="0"
  2985. BGCOLOR="#E0E0E0"
  2986. CELLPADDING="5"
  2987. ><TR
  2988. ><TD
  2989. ><PRE
  2990. CLASS="screen"
  2991. >User nobody 
  2992. Group nogroup</PRE
  2993. ></TD
  2994. ></TR
  2995. ></TABLE
  2996. ><P
  2997. >        you have something like 
  2998.       </P
  2999. ><TABLE
  3000. BORDER="0"
  3001. BGCOLOR="#E0E0E0"
  3002. CELLPADDING="5"
  3003. ><TR
  3004. ><TD
  3005. ><PRE
  3006. CLASS="screen"
  3007. >User www 
  3008. Group sys</PRE
  3009. ></TD
  3010. ></TR
  3011. ></TABLE
  3012. ><P
  3013. >        This is because you can't run Apache as nobody under hp-ux. Apache and
  3014.        PHP should then work. 
  3015.       </P
  3016. ></LI
  3017. ></OL
  3018. >
  3019.  </P
  3020. ></DIV
  3021. ><DIV
  3022. CLASS="sect1"
  3023. ><HR><H2
  3024. CLASS="sect1"
  3025. ><A
  3026. NAME="install.linux"
  3027. ></A
  3028. >Unix/Linux installs</H2
  3029. ><P
  3030. >     This section contains notes and hints specific to installing
  3031.     PHP on Linux distributions.
  3032.    </P
  3033. ><DIV
  3034. CLASS="sect2"
  3035. ><HR><H3
  3036. CLASS="sect2"
  3037. ><A
  3038. NAME="install.linux.packages"
  3039. ></A
  3040. >Using Packages</H3
  3041. ><P
  3042. >      Many Linux distributions have some sort of package installation
  3043.      system, such as RPM. This can assist in setting up a standard
  3044.      configuration, but if you need to have a different set of features
  3045.      (such as a secure server, or a different database driver), you may
  3046.      need to build PHP and/or your webserver. If you are unfamiliar
  3047.      with building and compiling your own software, it is worth
  3048.      checking to see whether somebody has already built a packaged
  3049.      version of PHP with the features you need.
  3050.     </P
  3051. ></DIV
  3052. ></DIV
  3053. ><DIV
  3054. CLASS="sect1"
  3055. ><HR><H2
  3056. CLASS="sect1"
  3057. ><A
  3058. NAME="install.macosx"
  3059. ></A
  3060. >Unix/Mac OS X installs</H2
  3061. ><P
  3062. >   This section contains notes and hints specific to installing
  3063.   PHP on Mac OS X Server.
  3064.  </P
  3065. ><DIV
  3066. CLASS="sect2"
  3067. ><HR><H3
  3068. CLASS="sect2"
  3069. ><A
  3070. NAME="install.macosx.packages"
  3071. ></A
  3072. >Using Packages</H3
  3073. ><P
  3074. >    There are a few pre-packaged and pre-compiled versions of PHP for
  3075.    Mac OS X. This can help in setting up a standard
  3076.    configuration, but if you need to have a different set of features
  3077.    (such as a secure server, or a different database driver), you may
  3078.    need to build PHP and/or your web server yourself. If you are unfamiliar
  3079.    with building and compiling your own software, it's worth
  3080.    checking whether somebody has already built a packaged
  3081.    version of PHP with the features you need.
  3082.   </P
  3083. ></DIV
  3084. ><DIV
  3085. CLASS="sect2"
  3086. ><HR><H3
  3087. CLASS="sect2"
  3088. ><A
  3089. NAME="install.macosx.compile"
  3090. ></A
  3091. >Compiling for OS X server</H3
  3092. ><P
  3093. >    There are two slightly different versions of Mac OS X, client and
  3094.    server. The following is for OS X Server.
  3095.   </P
  3096. ><DIV
  3097. CLASS="formalpara"
  3098. ><P
  3099. ><A
  3100. NAME="install.macosx.compile.example"
  3101. ></A
  3102. ><B
  3103. >Mac OS X server install. </B
  3104. >
  3105.     <P
  3106. ></P
  3107. ><OL
  3108. TYPE="1"
  3109. ><LI
  3110. ><P
  3111. >Get the latest distributions of Apache and PHP.</P
  3112. ></LI
  3113. ><LI
  3114. ><P
  3115. >        Untar them, and run the <B
  3116. CLASS="command"
  3117. >configure</B
  3118. > program on Apache
  3119.        like so.
  3120.        <TABLE
  3121. BORDER="0"
  3122. BGCOLOR="#E0E0E0"
  3123. CELLPADDING="5"
  3124. ><TR
  3125. ><TD
  3126. ><PRE
  3127. CLASS="shell"
  3128. >./configure --exec-prefix=/usr \
  3129. --localstatedir=/var \
  3130. --mandir=/usr/share/man \
  3131. --libexecdir=/System/Library/Apache/Modules \
  3132. --iconsdir=/System/Library/Apache/Icons \
  3133. --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \
  3134. --enable-shared=max \
  3135. --enable-module=most \
  3136. --target=apache</PRE
  3137. ></TD
  3138. ></TR
  3139. ></TABLE
  3140. >
  3141.       </P
  3142. ></LI
  3143. ><LI
  3144. ><P
  3145. >        If you want the compiler to do some optimization., you may also want to
  3146.        add this line:
  3147.        <TABLE
  3148. BORDER="0"
  3149. BGCOLOR="#E0E0E0"
  3150. CELLPADDING="5"
  3151. ><TR
  3152. ><TD
  3153. ><PRE
  3154. CLASS="shell"
  3155. >setenv OPTIM=-O2</PRE
  3156. ></TD
  3157. ></TR
  3158. ></TABLE
  3159. >
  3160.       </P
  3161. ></LI
  3162. ><LI
  3163. ><P
  3164. >        Next, go to the PHP 4 source directory and configure it.
  3165.        <TABLE
  3166. BORDER="0"
  3167. BGCOLOR="#E0E0E0"
  3168. CELLPADDING="5"
  3169. ><TR
  3170. ><TD
  3171. ><PRE
  3172. CLASS="shell"
  3173. >./configure --prefix=/usr \
  3174.     --sysconfdir=/etc \
  3175.     --localstatedir=/var \
  3176.     --mandir=/usr/share/man \
  3177.     --with-xml \
  3178.     --with-apache=/src/apache_1.3.12</PRE
  3179. ></TD
  3180. ></TR
  3181. ></TABLE
  3182. >
  3183.        If you have any other additions (MySQL, GD, etc.), be sure to add them
  3184.        here. For the <TT
  3185. CLASS="option"
  3186. >--with-apache</TT
  3187. > string, put
  3188.        in the path to your apache source directory, for example
  3189.        <TT
  3190. CLASS="filename"
  3191. >/src/apache_1.3.12</TT
  3192. >.
  3193.       </P
  3194. ></LI
  3195. ><LI
  3196. ><P
  3197. >        Type <B
  3198. CLASS="command"
  3199. >make</B
  3200. > and <B
  3201. CLASS="command"
  3202. >make install</B
  3203. >. This
  3204.        will add a directory to your Apache source directory under
  3205.        <TT
  3206. CLASS="filename"
  3207. >src/modules/php4</TT
  3208. >.
  3209.       </P
  3210. ></LI
  3211. ><LI
  3212. ><P
  3213. >        Now, reconfigure Apache to build in PHP 4.
  3214.        <TABLE
  3215. BORDER="0"
  3216. BGCOLOR="#E0E0E0"
  3217. CELLPADDING="5"
  3218. ><TR
  3219. ><TD
  3220. ><PRE
  3221. CLASS="shell"
  3222. >./configure --exec-prefix=/usr \
  3223. --localstatedir=/var \
  3224. --mandir=/usr/share/man \
  3225. --libexecdir=/System/Library/Apache/Modules \
  3226. --iconsdir=/System/Library/Apache/Icons \
  3227. --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \
  3228. --enable-shared=max \
  3229. --enable-module=most \
  3230. --target=apache \
  3231. --activate-module=src/modules/php4/libphp4.a</PRE
  3232. ></TD
  3233. ></TR
  3234. ></TABLE
  3235. >
  3236.        You may get a message telling you that libmodphp4.a is out of date. If
  3237.        so, go to the <TT
  3238. CLASS="filename"
  3239. >src/modules/php4</TT
  3240. >
  3241.        directory inside your apache source directory and run this command: 
  3242.        <B
  3243. CLASS="command"
  3244. >ranlib libmodphp4.a</B
  3245. >. Then go back to the root of the
  3246.        apache source directory and run the above <B
  3247. CLASS="command"
  3248. >configure</B
  3249. >
  3250.        command again. That'll bring the link table up to date. Run
  3251.        <B
  3252. CLASS="command"
  3253. >make</B
  3254. > and <B
  3255. CLASS="command"
  3256. >make install</B
  3257. > again.
  3258.       </P
  3259. ></LI
  3260. ><LI
  3261. ><P
  3262. >        Copy and rename the <TT
  3263. CLASS="filename"
  3264. >php.ini-dist</TT
  3265. > file to your
  3266.        <TT
  3267. CLASS="filename"
  3268. >bin</TT
  3269. > directory from your PHP 4
  3270.        source directory: 
  3271.        <TT
  3272. CLASS="userinput"
  3273. ><B
  3274. >cp php.ini-dist /usr/local/bin/php.ini</B
  3275. ></TT
  3276. >
  3277.        or (if your don't have a local directory)
  3278.        <TT
  3279. CLASS="userinput"
  3280. ><B
  3281. >cp php.ini-dist /usr/bin/php.ini</B
  3282. ></TT
  3283. >.
  3284.       </P
  3285. ></LI
  3286. ></OL
  3287. >
  3288.    </P
  3289. ></DIV
  3290. ></DIV
  3291. ><DIV
  3292. CLASS="sect2"
  3293. ><HR><H3
  3294. CLASS="sect2"
  3295. ><A
  3296. NAME="install.macosx.client"
  3297. ></A
  3298. >Compiling for MacOS X client</H3
  3299. ><P
  3300. >    Those tips are graciously provided by <A
  3301. HREF="http://www.entropy.ch/software/macosx/"
  3302. TARGET="_top"
  3303. >Marc Liyanage</A
  3304. >.
  3305.   </P
  3306. ><P
  3307. >    The PHP module for the Apache web server included in Mac OS X.
  3308.    This version includes support for the MySQL and PostgreSQL databases.
  3309.   </P
  3310. ><P
  3311. >    NOTE: Be careful when you do this, you could screw up your Apache web server!
  3312.   </P
  3313. ><P
  3314. >    Do this to install:
  3315.    <P
  3316. ></P
  3317. ><OL
  3318. TYPE="1"
  3319. ><LI
  3320. ><P
  3321. >       Open a terminal window.
  3322.      </P
  3323. ></LI
  3324. ><LI
  3325. ><P
  3326. >       Type
  3327.       <TT
  3328. CLASS="userinput"
  3329. ><B
  3330. >wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz</B
  3331. ></TT
  3332. >,
  3333.       wait for the download to finish.
  3334.      </P
  3335. ></LI
  3336. ><LI
  3337. ><P
  3338. >       Type <TT
  3339. CLASS="userinput"
  3340. ><B
  3341. >gunzip libphp4.so.gz</B
  3342. ></TT
  3343. >.
  3344.      </P
  3345. ></LI
  3346. ><LI
  3347. ><P
  3348. >       Type <TT
  3349. CLASS="userinput"
  3350. ><B
  3351. >sudo apxs -i -a -n php4 libphp4.so</B
  3352. ></TT
  3353. >
  3354.      </P
  3355. ></LI
  3356. ><LI
  3357. ><P
  3358. >       Now type <TT
  3359. CLASS="userinput"
  3360. ><B
  3361. >sudo open -a TextEdit /etc/httpd/httpd.conf</B
  3362. ></TT
  3363. >.
  3364.       TextEdit will open with the web server configuration file. Locate these 
  3365.       two lines towards the end of the file: (Use the Find command)
  3366.       <TABLE
  3367. BORDER="0"
  3368. BGCOLOR="#E0E0E0"
  3369. CELLPADDING="5"
  3370. ><TR
  3371. ><TD
  3372. ><PRE
  3373. CLASS="apache"
  3374. >#AddType application/x-httpd-php .php 
  3375. #AddType application/x-httpd-php-source .phps</PRE
  3376. ></TD
  3377. ></TR
  3378. ></TABLE
  3379. >
  3380.        Remove the two hash marks (<TT
  3381. CLASS="literal"
  3382. >#</TT
  3383. >), then save the file and
  3384.        quit TextEdit.
  3385.       </P
  3386. ></LI
  3387. ><LI
  3388. ><P
  3389. >       Finally, type <TT
  3390. CLASS="userinput"
  3391. ><B
  3392. >sudo apachectl graceful</B
  3393. ></TT
  3394. > to restart
  3395.       the web server.
  3396.      </P
  3397. ></LI
  3398. ></OL
  3399. >
  3400.   </P
  3401. ><P
  3402. >    PHP should now be up and running. You can test it by dropping a file into 
  3403.    your <TT
  3404. CLASS="filename"
  3405. >Sites</TT
  3406. > folder which is called
  3407.    <TT
  3408. CLASS="filename"
  3409. >test.php</TT
  3410. >. Into that file, write this line:
  3411.    <TT
  3412. CLASS="literal"
  3413. ><?php phpinfo() ?></TT
  3414. >.
  3415.   </P
  3416. ><P
  3417. >    Now open up <TT
  3418. CLASS="literal"
  3419. >127.0.0.1/~your_username/test.php</TT
  3420. > in your web
  3421.    browser. You should see a status table with information about the PHP module.
  3422.   </P
  3423. ></DIV
  3424. ></DIV
  3425. ><DIV
  3426. CLASS="sect1"
  3427. ><HR><H2
  3428. CLASS="sect1"
  3429. ><A
  3430. NAME="install.openbsd"
  3431. ></A
  3432. >Unix/OpenBSD installs</H2
  3433. ><P
  3434. >  This section contains notes and hints specific to installing
  3435.  PHP on <A
  3436. HREF="http://www.openbsd.org/"
  3437. TARGET="_top"
  3438. >OpenBSD 3.4</A
  3439. >.
  3440.  </P
  3441. ><DIV
  3442. CLASS="sect2"
  3443. ><HR><H3
  3444. CLASS="sect2"
  3445. ><A
  3446. NAME="install.openbsd.packages"
  3447. ></A
  3448. >Using Binary Packages</H3
  3449. ><P
  3450. >     Using binary packages to install PHP on OpenBSD is the recommended
  3451.     and simplest method.  The core package has been separated from the various
  3452.     modules, and each can be installed and removed independently from the others.
  3453.     The files you need can be found on your OpenBSD CD or on the FTP site.
  3454.    </P
  3455. ><P
  3456. >     The main package you need to install is <TT
  3457. CLASS="filename"
  3458. >php4-core-4.3.3.tgz</TT
  3459. >,
  3460.     which contains the basic engine (plus gettext and iconv).  Next, take a look
  3461.     at the module packages, such as <TT
  3462. CLASS="filename"
  3463. >php4-mysql-4.3.3.tgz</TT
  3464. >
  3465.     or <TT
  3466. CLASS="filename"
  3467. >php4-imap-4.3.3.tgz</TT
  3468. >.  You need to use the <B
  3469. CLASS="command"
  3470. >phpxs</B
  3471. >
  3472.     command to activate and deactivate these modules in your <TT
  3473. CLASS="filename"
  3474. >php.ini</TT
  3475. >.
  3476.    </P
  3477. ><TABLE
  3478. WIDTH="100%"
  3479. BORDER="0"
  3480. CELLPADDING="0"
  3481. CELLSPACING="0"
  3482. CLASS="EXAMPLE"
  3483. ><TR
  3484. ><TD
  3485. ><DIV
  3486. CLASS="example"
  3487. ><A
  3488. NAME="install.openbsd.ports.example"
  3489. ></A
  3490. ><P
  3491. ><B
  3492. >P°φklad 3-1. OpenBSD Package Install Example</B
  3493. ></P
  3494. ><TABLE
  3495. BORDER="0"
  3496. BGCOLOR="#E0E0E0"
  3497. CELLPADDING="5"
  3498. ><TR
  3499. ><TD
  3500. ><PRE
  3501. CLASS="programlisting"
  3502. ># pkg_add php4-core-4.3.3.tgz
  3503. # /usr/local/sbin/phpxs -s
  3504. # cp /usr/local/share/doc/php4/php.ini-recommended /var/www/conf/php.ini
  3505.   (add in mysql)
  3506. # pkg_add php4-mysql-4.3.3.tgz
  3507. # /usr/local/sbin/phpxs -a mysql
  3508.   (add in imap)
  3509. # pkg_add php4-imap-4.3.3.tgz
  3510. # /usr/local/sbin/phpxs -a imap
  3511.   (remove mysql as a test)
  3512. # pkg_delete php4-mysql-4.3.3
  3513. # /usr/local/sbin/phpxs -r mysql
  3514.   (install the PEAR libraries)
  3515. # pkg_add php4-pear-4.3.3.tgz</PRE
  3516. ></TD
  3517. ></TR
  3518. ></TABLE
  3519. ></DIV
  3520. ></TD
  3521. ></TR
  3522. ></TABLE
  3523. ><P
  3524. >    Read the <A
  3525. HREF="http://www.openbsd.org/cgi-bin/man.cgi?query=packages"
  3526. TARGET="_top"
  3527. >packages(7)</A
  3528. >
  3529.    manual page for more information about binary packages on OpenBSD.
  3530.    </P
  3531. ></DIV
  3532. ><DIV
  3533. CLASS="sect2"
  3534. ><HR><H3
  3535. CLASS="sect2"
  3536. ><A
  3537. NAME="install.openbsd.ports"
  3538. ></A
  3539. >Using Ports</H3
  3540. ><P
  3541. >    You can also compile up PHP from source using the <A
  3542. HREF="http://www.openbsd.org/ports.html"
  3543. TARGET="_top"
  3544. >ports tree</A
  3545. >.
  3546.    However, this is only recommended for users familiar with OpenBSD.  The PHP 4 port
  3547.    is split into two sub-directories: core and extensions.  The
  3548.    extensions directory generates sub-packages for all of the supported
  3549.    PHP modules.  If you find you do not want to create some of these modules,
  3550.    use the <B
  3551. CLASS="command"
  3552. >no_*</B
  3553. > FLAVOR.  For example, to skip building
  3554.    the imap module, set the FLAVOR to <B
  3555. CLASS="command"
  3556. >no_imap</B
  3557. >.
  3558.   </P
  3559. ></DIV
  3560. ><DIV
  3561. CLASS="sect2"
  3562. ><HR><H3
  3563. CLASS="sect2"
  3564. ><A
  3565. NAME="install.openbsd.faq"
  3566. ></A
  3567. >Common Problems</H3
  3568. ><P
  3569. ></P
  3570. ><UL
  3571. ><LI
  3572. ><P
  3573. >The default install of Apache runs inside a
  3574.     <A
  3575. HREF="http://www.openbsd.org/cgi-bin/man.cgi?query=chroot"
  3576. TARGET="_top"
  3577. >chroot(2) jail</A
  3578. >, which will restrict PHP scripts to
  3579.     accessing files under <TT
  3580. CLASS="filename"
  3581. >/var/www</TT
  3582. >.  You will therefore need to create a
  3583.     <TT
  3584. CLASS="filename"
  3585. >/var/www/tmp</TT
  3586. > directory for PHP session files to be stored, or use an
  3587.     alternative session backend.  In addition, database sockets need to be placed inside the
  3588.     jail or listen on the <TT
  3589. CLASS="filename"
  3590. >localhost</TT
  3591. > interface.  If you use network functions,
  3592.     some files from <TT
  3593. CLASS="filename"
  3594. >/etc</TT
  3595. > such as <TT
  3596. CLASS="filename"
  3597. >/etc/resolv.conf</TT
  3598. > and
  3599.     <TT
  3600. CLASS="filename"
  3601. >/etc/services</TT
  3602. > will need to be moved into <TT
  3603. CLASS="filename"
  3604. >/var/www/etc</TT
  3605. >.
  3606.     The OpenBSD PEAR package automatically installs into the correct chroot directories, so 
  3607.     no special modification is needed there.  More information on the OpenBSD Apache is available
  3608.     in the <A
  3609. HREF="http://www.openbsd.org/faq/faq10.html#httpdchroot"
  3610. TARGET="_top"
  3611. >OpenBSD FAQ</A
  3612. >.
  3613.     </P
  3614. ></LI
  3615. ><LI
  3616. ><P
  3617. >     The OpenBSD 3.4 package for the <A
  3618. HREF="http://www.boutell.com/gd/"
  3619. TARGET="_top"
  3620. >gd</A
  3621. > extension requires
  3622.     XFree86 to be installed.  If you do not wish to use some of the font features that
  3623.     require X11, install the <TT
  3624. CLASS="filename"
  3625. >php4-gd-4.3.3-no_x11.tgz</TT
  3626. > package instead.
  3627.     </P
  3628. ></LI
  3629. ></UL
  3630. ></DIV
  3631. ><DIV
  3632. CLASS="sect2"
  3633. ><HR><H3
  3634. CLASS="sect2"
  3635. ><A
  3636. NAME="install.openbsd.older"
  3637. ></A
  3638. >Older Releases</H3
  3639. ><P
  3640. >    Older releases of OpenBSD used the FLAVORS system to compile up
  3641.    a statically linked PHP.  Since it is hard to generate binary packages using
  3642.    this method, it is now deprecated.  You can still use the old stable
  3643.    ports trees if you wish, but they are unsupported by the OpenBSD team.
  3644.    If you have any comments about this, the current maintainer for the port
  3645.    is Anil Madhavapeddy (avsm at openbsd dot org).
  3646.   </P
  3647. ></DIV
  3648. ></DIV
  3649. ><DIV
  3650. CLASS="sect1"
  3651. ><HR><H2
  3652. CLASS="sect1"
  3653. ><A
  3654. NAME="install.solaris"
  3655. ></A
  3656. >Unix/Solaris installs</H2
  3657. ><P
  3658. >   This section contains notes and hints specific to installing
  3659.   PHP on Solaris systems.
  3660.  </P
  3661. ><DIV
  3662. CLASS="sect2"
  3663. ><HR><H3
  3664. CLASS="sect2"
  3665. ><A
  3666. NAME="install.solaris.required"
  3667. ></A
  3668. >Required software</H3
  3669. ><P
  3670. >    Solaris installs often lack C compilers and their related tools.
  3671.    Read <A
  3672. HREF="#faq.installation.needgnu"
  3673. >this FAQ</A
  3674. > 
  3675.    for information on why using GNU versions for some of these
  3676.    tools is necessary.  The required software is as follows:
  3677.    <P
  3678. ></P
  3679. ><UL
  3680. ><LI
  3681. ><P
  3682. >       gcc (recommended, other C compilers may work)
  3683.      </P
  3684. ></LI
  3685. ><LI
  3686. ><P
  3687. >       make
  3688.      </P
  3689. ></LI
  3690. ><LI
  3691. ><P
  3692. >       flex
  3693.      </P
  3694. ></LI
  3695. ><LI
  3696. ><P
  3697. >       bison
  3698.      </P
  3699. ></LI
  3700. ><LI
  3701. ><P
  3702. >       m4
  3703.      </P
  3704. ></LI
  3705. ><LI
  3706. ><P
  3707. >       autoconf
  3708.      </P
  3709. ></LI
  3710. ><LI
  3711. ><P
  3712. >       automake
  3713.      </P
  3714. ></LI
  3715. ><LI
  3716. ><P
  3717. >       perl
  3718.      </P
  3719. ></LI
  3720. ><LI
  3721. ><P
  3722. >       gzip
  3723.      </P
  3724. ></LI
  3725. ><LI
  3726. ><P
  3727. >       tar
  3728.      </P
  3729. ></LI
  3730. ><LI
  3731. ><P
  3732. >       GNU sed
  3733.      </P
  3734. ></LI
  3735. ></UL
  3736. >
  3737.     In addition, you will need to install (and possibly compile) any
  3738.     additional software specific to your configuration, such as Oracle
  3739.     or MySQL.
  3740.   </P
  3741. ></DIV
  3742. ><DIV
  3743. CLASS="sect2"
  3744. ><HR><H3
  3745. CLASS="sect2"
  3746. ><A
  3747. NAME="install.solaris.packages"
  3748. ></A
  3749. >Using Packages</H3
  3750. ><P
  3751. >    You can simplify the Solaris install process by using pkgadd to
  3752.    install most of your needed components. 
  3753.   </P
  3754. ></DIV
  3755. ></DIV
  3756. ><DIV
  3757. CLASS="sect1"
  3758. ><HR><H2
  3759. CLASS="sect1"
  3760. ><A
  3761. NAME="install.unix"
  3762. ></A
  3763. >Installation on Unix systems</H2
  3764. ><P
  3765. >     This section will guide you through the general configuration and
  3766.     installation of PHP on Unix systems. Be sure to investigate any
  3767.     sections specific to your platform or web server before you begin
  3768.     the process.
  3769.    </P
  3770. ><P
  3771. >     Prerequisite knowledge and software:
  3772.     <P
  3773. ></P
  3774. ><UL
  3775. ><LI
  3776. ><P
  3777. >        Basic Unix skills (being able to operate "make" and a C
  3778.        compiler, if compiling)
  3779.       </P
  3780. ></LI
  3781. ><LI
  3782. ><P
  3783. >        An ANSI C compiler (if compiling)
  3784.       </P
  3785. ></LI
  3786. ><LI
  3787. ><P
  3788. >        flex (for compiling)
  3789.       </P
  3790. ></LI
  3791. ><LI
  3792. ><P
  3793. >        bison (for compiling)
  3794.       </P
  3795. ></LI
  3796. ><LI
  3797. ><P
  3798. >        A web server
  3799.       </P
  3800. ></LI
  3801. ><LI
  3802. ><P
  3803. >        Any module specific components (such as gd, pdf libs, etc.)
  3804.       </P
  3805. ></LI
  3806. ></UL
  3807. >
  3808.    </P
  3809. ><P
  3810. >     There are several ways to install PHP for the Unix platform, either
  3811.     with a compile and configure process, or through various
  3812.     pre-packaged methods. This documentation is mainly focused around
  3813.     the process of compiling and configuring PHP.
  3814.    </P
  3815. ><P
  3816. >     The initial PHP setup and configuration process is controlled by the
  3817.     use of the commandline options of the <TT
  3818. CLASS="filename"
  3819. >configure</TT
  3820. >
  3821.     script. This page outlines the usage of the most common options,
  3822.     but there are many others to play with. Check out the <A
  3823. HREF="#install.configure"
  3824. >Complete list of configure
  3825.      options</A
  3826. > for an exhaustive rundown. There are several ways
  3827.      to install PHP:
  3828.     <P
  3829. ></P
  3830. ><UL
  3831. ><LI
  3832. ><P
  3833. >        As an <A
  3834. HREF="#install.apache"
  3835. >Apache 1.x  module</A
  3836. > or
  3837.        an <A
  3838. HREF="#install.apache2"
  3839. >Apache 2.x  module</A
  3840. >.
  3841.       </P
  3842. ></LI
  3843. ><LI
  3844. ><P
  3845. >        As an <A
  3846. HREF="#install.caudium"
  3847. >Pike module for Caudium</A
  3848. >
  3849.       </P
  3850. ></LI
  3851. ><LI
  3852. ><P
  3853. >        For use with <A
  3854. HREF="#install.otherhttpd"
  3855. >AOLServer, NSAPI,
  3856.        phttpd, Pi3Web, Roxen, thttpd, or Zeus.</A
  3857. >
  3858.       </P
  3859. ></LI
  3860. ><LI
  3861. ><P
  3862. >        As a <A
  3863. HREF="#install.commandline"
  3864. >CGI executable</A
  3865. >
  3866.       </P
  3867. ></LI
  3868. ></UL
  3869. >
  3870.    </P
  3871. ><DIV
  3872. CLASS="sect2"
  3873. ><HR><H3
  3874. CLASS="sect2"
  3875. ><A
  3876. NAME="install.unix.apache-module"
  3877. ></A
  3878. >Apache Module Quick Reference</H3
  3879. ><P
  3880. >      PHP can be compiled in a number of different ways, but one of
  3881.      the most popular is as an Apache module. The following is a quick
  3882.      installation overview.
  3883.     </P
  3884. ><TABLE
  3885. WIDTH="100%"
  3886. BORDER="0"
  3887. CELLPADDING="0"
  3888. CELLSPACING="0"
  3889. CLASS="EXAMPLE"
  3890. ><TR
  3891. ><TD
  3892. ><DIV
  3893. CLASS="example"
  3894. ><A
  3895. NAME="install.unix.apache-module.quick"
  3896. ></A
  3897. ><P
  3898. ><B
  3899. >P°φklad 3-2. 
  3900.       Quick Installation Instructions for PHP 4 (Apache Module Version)
  3901.      </B
  3902. ></P
  3903. ><TABLE
  3904. BORDER="0"
  3905. BGCOLOR="#E0E0E0"
  3906. CELLPADDING="5"
  3907. ><TR
  3908. ><TD
  3909. ><PRE
  3910. CLASS="shell"
  3911. >1.  gunzip apache_1.3.x.tar.gz
  3912. 2.  tar xvf apache_1.3.x.tar
  3913. 3.  gunzip php-x.x.x.tar.gz
  3914. 4.  tar xvf php-x.x.x.tar
  3915. 5.  cd apache_1.3.x
  3916. 6.  ./configure --prefix=/www
  3917. 7.  cd ../php-x.x.x
  3918. 8.  ./configure --with-mysql --with-apache=../apache_1.3.x --enable-ftp
  3919. 9.  make
  3920. 10. make install
  3921. 11. cd ../apache_1.3.x
  3922. 12. ./configure --activate-module=src/modules/php4/libphp4.a
  3923. 13. make
  3924. 14. make install
  3925. 15. cd ../php-x.x.x
  3926. 16. cp php.ini-dist /usr/local/lib/php.ini
  3927. 17. Edit your httpd.conf or srm.conf file and add: 
  3928.       AddType application/x-httpd-php .php
  3929.  
  3930. 18. Use your normal procedure for restarting the Apache server. (You must
  3931.     stop and restart the server, not just cause the server to reload by
  3932.     use a HUP or USR1 signal.)</PRE
  3933. ></TD
  3934. ></TR
  3935. ></TABLE
  3936. ></DIV
  3937. ></TD
  3938. ></TR
  3939. ></TABLE
  3940. ></DIV
  3941. ><DIV
  3942. CLASS="sect2"
  3943. ><HR><H3
  3944. CLASS="sect2"
  3945. ><A
  3946. NAME="install.building"
  3947. ></A
  3948. >Building</H3
  3949. ><P
  3950. >      When PHP is configured, you are ready to build the CGI executable.
  3951.      The command <B
  3952. CLASS="command"
  3953. >make</B
  3954. > should
  3955.      take care of this.  If it fails and you can't figure out why, see
  3956.      the <A
  3957. HREF="#install.problems"
  3958. >Problems section</A
  3959. >.
  3960.     </P
  3961. ></DIV
  3962. ></DIV
  3963. ><DIV
  3964. CLASS="sect1"
  3965. ><HR><H2
  3966. CLASS="sect1"
  3967. ><A
  3968. NAME="install.windows"
  3969. ></A
  3970. >Installation on Windows systems</H2
  3971. ><P
  3972. >     This section applies to Windows 98/Me and Windows NT/2000/XP.  PHP 
  3973.     will not work on 16 bit platforms such as Windows 3.1 and sometimes 
  3974.     we refer to the supported Windows platforms as Win32. Windows 95
  3975.     is no longer supported as of PHP 4.3.0.
  3976.    </P
  3977. ><P
  3978. >     There are two main ways to install PHP for Windows: either
  3979.     <A
  3980. HREF="#install.windows.manual"
  3981. >manually</A
  3982. >
  3983.     or by using the <A
  3984. HREF="#install.windows.installer"
  3985. >InstallShield</A
  3986. >
  3987.     installer.
  3988.    </P
  3989. ><P
  3990. >     If you have Microsoft Visual Studio, you can also 
  3991.     <A
  3992. HREF="#install.windows.build"
  3993. >build</A
  3994. >
  3995.     PHP from the original source code.
  3996.    </P
  3997. ><P
  3998. >     Once you have PHP installed on your Windows system, you may also
  3999.     want to <A
  4000. HREF="#install.windows.extensions"
  4001. >load various extensions</A
  4002. >
  4003.     for added functionality.
  4004.    </P
  4005. ><DIV
  4006. CLASS="sect2"
  4007. ><HR><H3
  4008. CLASS="sect2"
  4009. ><A
  4010. NAME="install.windows.installer"
  4011. ></A
  4012. >Windows InstallShield</H3
  4013. ><P
  4014. >      The Windows PHP installer is  available from the downloads page at
  4015.      <A
  4016. HREF="http://www.php.net/downloads.php"
  4017. TARGET="_top"
  4018. >http://www.php.net/downloads.php</A
  4019. >. This
  4020.      installs the <SPAN
  4021. CLASS="emphasis"
  4022. ><I
  4023. CLASS="emphasis"
  4024. >CGI version</I
  4025. ></SPAN
  4026. > of <TT
  4027. CLASS="literal"
  4028. >PHP</TT
  4029. >
  4030.      and, for IIS, PWS, and Xitami, configures the web server as well.
  4031.     </P
  4032. ><DIV
  4033. CLASS="note"
  4034. ><BLOCKQUOTE
  4035. CLASS="note"
  4036. ><P
  4037. ><B
  4038. >Poznßmka: </B
  4039. >
  4040.       While the InstallShield installer is an easy way to make
  4041.       <TT
  4042. CLASS="literal"
  4043. >PHP</TT
  4044. > work, it is restricted in many aspects, as
  4045.       automatic setup of extensions for example is not supported. The whole set
  4046.       of supported extensions is only available by downloading the zip binary
  4047.       distribution.
  4048.      </P
  4049. ></BLOCKQUOTE
  4050. ></DIV
  4051. ><P
  4052. >      Install your selected <SPAN
  4053. CLASS="acronym"
  4054. >HTTP</SPAN
  4055. > server on your system and
  4056.      make sure that it works.
  4057.     </P
  4058. ><P
  4059. >      Run the executable installer and follow the instructions provided by the
  4060.      installation wizard. Two types of installation are supported - standard,
  4061.      which provides sensible defaults for all the settings it can, and advanced,
  4062.      which asks questions as it goes along.
  4063.     </P
  4064. ><P
  4065. >      The installation wizard gathers enough information to set up the <TT
  4066. CLASS="filename"
  4067. >php.ini</TT
  4068. >
  4069.      file and configure the web server to use PHP. For IIS and also PWS on NT
  4070.      Workstation, a list of all the nodes on the server with script map settings
  4071.      is displayed, and you can choose those nodes to which you wish to add the
  4072.      PHP script mappings.
  4073.     </P
  4074. ><P
  4075. >      Once the installation has completed the installer will inform you if you
  4076.      need to restart your system, restart the server, or just start using PHP.
  4077.     </P
  4078. ><DIV
  4079. CLASS="warning"
  4080. ><P
  4081. ></P
  4082. ><TABLE
  4083. CLASS="warning"
  4084. BORDER="1"
  4085. WIDTH="100%"
  4086. ><TR
  4087. ><TD
  4088. ALIGN="CENTER"
  4089. ><B
  4090. >Varovßnφ</B
  4091. ></TD
  4092. ></TR
  4093. ><TR
  4094. ><TD
  4095. ALIGN="LEFT"
  4096. ><P
  4097. >       Be aware, that this setup of PHP is not secure. If you would like to have
  4098.       a secure PHP setup, you'd better go on the manual way, and set every
  4099.       option carefully. This automatically working setup gives you an instantly
  4100.       working PHP installation, but it is not meant to be used on online servers.
  4101.      </P
  4102. ></TD
  4103. ></TR
  4104. ></TABLE
  4105. ></DIV
  4106. ></DIV
  4107. ><DIV
  4108. CLASS="sect2"
  4109. ><HR><H3
  4110. CLASS="sect2"
  4111. ><A
  4112. NAME="install.windows.manual"
  4113. ></A
  4114. >Manual Installation Steps</H3
  4115. ><P
  4116. >      This install guide will help you manually install and configure PHP on your
  4117.      Windows webserver. The original version of this guide was compiled by
  4118.      <A
  4119. HREF="mailto:bob_silva@mail.umesd.k12.or.us"
  4120. TARGET="_top"
  4121. >Bob Silva</A
  4122. >, and can be found at
  4123.      <A
  4124. HREF="http://www.umesd.k12.or.us/php/win32install.html"
  4125. TARGET="_top"
  4126. >http://www.umesd.k12.or.us/php/win32install.html</A
  4127. >.
  4128.      You need to download the zip binary distribution from the downloads page at 
  4129.      <A
  4130. HREF="http://www.php.net/downloads.php"
  4131. TARGET="_top"
  4132. >http://www.php.net/downloads.php</A
  4133. >. 
  4134.     </P
  4135. ><P
  4136. >      PHP 4 for Windows comes in three flavours - a CGI executable (php.exe), a
  4137.      CLI executable (sapi/php.exe) and some other SAPI modules:
  4138.      <P
  4139. ></P
  4140. ><TABLE
  4141. BORDER="0"
  4142. ><TBODY
  4143. ><TR
  4144. ><TD
  4145. >        <TT
  4146. CLASS="filename"
  4147. >php4apache.dll</TT
  4148. > - Apache 1.3.x module
  4149.       </TD
  4150. ></TR
  4151. ><TR
  4152. ><TD
  4153. >        <TT
  4154. CLASS="filename"
  4155. >php4apache2.dll</TT
  4156. > - Apache 2.0.x module
  4157.       </TD
  4158. ></TR
  4159. ><TR
  4160. ><TD
  4161. >        <TT
  4162. CLASS="filename"
  4163. >php4isapi.dll</TT
  4164. > - ISAPI Module for ISAPI compliant
  4165.        webservers like IIS 4.0/PWS 4.0 or newer.
  4166.       </TD
  4167. ></TR
  4168. ><TR
  4169. ><TD
  4170. >        <TT
  4171. CLASS="filename"
  4172. >php4nsapi.dll</TT
  4173. > - Netscape/iPlanet module
  4174.       </TD
  4175. ></TR
  4176. ></TBODY
  4177. ></TABLE
  4178. ><P
  4179. ></P
  4180. >
  4181.      The latter form is new to PHP 4, and provides significantly improved
  4182.      performance and some new functionality. The CLI version is designed to use
  4183.      PHP for command line scripting. More information about CLI is available in
  4184.      the chapter about
  4185.      <A
  4186. HREF="#features.commandline"
  4187. >using PHP from the command line</A
  4188. >
  4189.     </P
  4190. ><DIV
  4191. CLASS="warning"
  4192. ><P
  4193. ></P
  4194. ><TABLE
  4195. CLASS="warning"
  4196. BORDER="1"
  4197. WIDTH="100%"
  4198. ><TR
  4199. ><TD
  4200. ALIGN="CENTER"
  4201. ><B
  4202. >Varovßnφ</B
  4203. ></TD
  4204. ></TR
  4205. ><TR
  4206. ><TD
  4207. ALIGN="LEFT"
  4208. ><P
  4209. >       The SAPI modules have been significantly improved in the 4.1 release, 
  4210.       however, you may find that you encounter possible server errors or 
  4211.       other server modules such as ASP failing, in older systems.
  4212.      </P
  4213. ></TD
  4214. ></TR
  4215. ></TABLE
  4216. ></DIV
  4217. ><DIV
  4218. CLASS="note"
  4219. ><BLOCKQUOTE
  4220. CLASS="note"
  4221. ><P
  4222. ><B
  4223. >DCOM and MDAC requirements: </B
  4224. >
  4225.        If you choose one of the SAPI modules and use
  4226.        <SPAN
  4227. CLASS="emphasis"
  4228. ><I
  4229. CLASS="emphasis"
  4230. >Windows 95</I
  4231. ></SPAN
  4232. >, be sure to download and install the DCOM
  4233.        update from the <A
  4234. HREF="http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe"
  4235. TARGET="_top"
  4236. >Microsoft DCOM pages</A
  4237. >.
  4238.        If you use Microsoft <SPAN
  4239. CLASS="emphasis"
  4240. ><I
  4241. CLASS="emphasis"
  4242. >Windows 9x/NT4</I
  4243. ></SPAN
  4244. > download the
  4245.        latest version of the Microsoft Data Access Components (MDAC) for your
  4246.        platform. MDAC is available at <A
  4247. HREF="http://www.microsoft.com/data/"
  4248. TARGET="_top"
  4249. >http://www.microsoft.com/data/</A
  4250. >.
  4251.      </P
  4252. ></BLOCKQUOTE
  4253. ></DIV
  4254. ><P
  4255. >      The following steps should be performed on all installations before any
  4256.      server specific instructions.
  4257.      <P
  4258. ></P
  4259. ><UL
  4260. ><LI
  4261. ><P
  4262. >         Extract the distribution file to a directory of your choice,
  4263.         <TT
  4264. CLASS="filename"
  4265. >c:\</TT
  4266. > is a good start. The zip package expands to a
  4267.         foldername like <TT
  4268. CLASS="filename"
  4269. >php-4.3.1-Win32</TT
  4270. > which is assumed to
  4271.         be renamed to <TT
  4272. CLASS="filename"
  4273. >php</TT
  4274. >. For the sake of convenience and
  4275.         to be version independent the following steps assume your extracted
  4276.         version of PHP lives in <TT
  4277. CLASS="filename"
  4278. >c:\php</TT
  4279. >. You might choose
  4280.         any other location but you probably do not want to use a path in which
  4281.         spaces are included (for example:
  4282.         <TT
  4283. CLASS="filename"
  4284. >C:\Program Files\PHP</TT
  4285. > is not a good idea). Some web
  4286.         servers will crash if you do. The structure of your directory you
  4287.         extracted the zip file will look like:
  4288.        </P
  4289. ></LI
  4290. ></UL
  4291. >
  4292.      <DIV
  4293. CLASS="informalexample"
  4294. ><A
  4295. NAME="AEN668"
  4296. ></A
  4297. ><P
  4298. ></P
  4299. ><TABLE
  4300. BORDER="0"
  4301. BGCOLOR="#E0E0E0"
  4302. CELLPADDING="5"
  4303. ><TR
  4304. ><TD
  4305. ><PRE
  4306. CLASS="programlisting"
  4307. >c:\php
  4308.    |
  4309.    +--cli
  4310.    |  |
  4311.    |  |-php.exe           -- CLI executable - ONLY for commandline scripting
  4312.    |
  4313.    |
  4314.    +--dlls                -- support dlls for extensions --> Windows system directory
  4315.    |  |
  4316.    |  |-expat.dll
  4317.    |  |
  4318.    |  |-fdftk.dll
  4319.    |  |
  4320.    |  |-...
  4321.    |
  4322.    +--extensions          -- extension dlls for PHP
  4323.    |  |
  4324.    |  |-php_bz2.dll
  4325.    |  |
  4326.    |  |-php_cpdf.dll
  4327.    |  |
  4328.    |  |-..
  4329.    |
  4330.    +--mibs                -- support files for SNMP
  4331.    |
  4332.    |
  4333.    +--openssl             -- support files for Openssl
  4334.    |
  4335.    |
  4336.    +--pdf-related         -- support files for PDF
  4337.    |
  4338.    |
  4339.    +--sapi                -- SAPI dlls
  4340.    |  |
  4341.    |  |-php4apache.dll
  4342.    |  |
  4343.    |  |-php4apache2.dll
  4344.    |  |
  4345.    |  |-php4isapi.dll
  4346.    |  |
  4347.    |  |-..
  4348.    |
  4349.    |-install.txt
  4350.    |
  4351.    |-..
  4352.    |
  4353.    |-php.exe              -- CGI executable
  4354.    |
  4355.    |-..
  4356.    |
  4357.    |-php.ini-dist
  4358.    |
  4359.    |-php.ini-recommended
  4360.    | 
  4361.    |-php4ts.dll           -- main dll --> Windows system directory
  4362.    | 
  4363.    |-...</PRE
  4364. ></TD
  4365. ></TR
  4366. ></TABLE
  4367. ><P
  4368. ></P
  4369. ></DIV
  4370. > 
  4371.     </P
  4372. ><P
  4373. >      The  CGI binary - <TT
  4374. CLASS="filename"
  4375. >c:\php\php.exe</TT
  4376. > -, the CLI binary
  4377.      - <TT
  4378. CLASS="filename"
  4379. >c:\php\cli\php.exe</TT
  4380. > -, and the SAPI modules
  4381.      - <TT
  4382. CLASS="filename"
  4383. >c:\php\sapi\*.dll</TT
  4384. > -  rely on the main dll
  4385.      <TT
  4386. CLASS="filename"
  4387. >c:\php\php4ts.dll</TT
  4388. >. You have to make sure, that this
  4389.      dll can be found by your PHP installation. The search order for this dll
  4390.      is as follows:
  4391.      <P
  4392. ></P
  4393. ><TABLE
  4394. BORDER="0"
  4395. ><TBODY
  4396. ><TR
  4397. ><TD
  4398. >        The same directory from where <TT
  4399. CLASS="filename"
  4400. >php.exe</TT
  4401. > is called.
  4402.        In case you use a SAPI module the same directory from where your 
  4403.        webserver loads the dll (e.g. <TT
  4404. CLASS="filename"
  4405. >php4apache.dll</TT
  4406. >).
  4407.       </TD
  4408. ></TR
  4409. ><TR
  4410. ><TD
  4411. >        Any directory in your Windows PATH environment variable.
  4412.       </TD
  4413. ></TR
  4414. ></TBODY
  4415. ></TABLE
  4416. ><P
  4417. ></P
  4418. >
  4419.      <P
  4420. ></P
  4421. ><UL
  4422. ><LI
  4423. ><P
  4424. >         The best bet is to make <TT
  4425. CLASS="filename"
  4426. >php4ts.dll</TT
  4427. > available,
  4428.         regardless which interface (CGI or SAPI module) you plan to use. To do so,
  4429.         you have to copy this dll to a directory on your Windows path. The best
  4430.         place is your Windows system directory:
  4431.         <P
  4432. ></P
  4433. ><TABLE
  4434. BORDER="0"
  4435. ><TBODY
  4436. ><TR
  4437. ><TD
  4438. >           <TT
  4439. CLASS="filename"
  4440. >C:\Windows\System</TT
  4441. > for Windows 9x/ME
  4442.          </TD
  4443. ></TR
  4444. ><TR
  4445. ><TD
  4446. >           <TT
  4447. CLASS="filename"
  4448. >C:\WINNT\System32</TT
  4449. > for Windows NT/2000 or
  4450.           <TT
  4451. CLASS="filename"
  4452. >C:\WINNT40\System32</TT
  4453. > for NT/2000 server
  4454.          </TD
  4455. ></TR
  4456. ><TR
  4457. ><TD
  4458. >           <TT
  4459. CLASS="filename"
  4460. >C:\Windows\System32</TT
  4461. > for Windows XP
  4462.          </TD
  4463. ></TR
  4464. ></TBODY
  4465. ></TABLE
  4466. ><P
  4467. ></P
  4468. >
  4469.         If you plan to use a SAPI module from <TT
  4470. CLASS="filename"
  4471. >c:\php\sapi</TT
  4472. >
  4473.         and do not like to copy dlls to your Windows system directory, you have
  4474.         the alternative choice to simply copy <TT
  4475. CLASS="filename"
  4476. >php4ts.dll</TT
  4477. > to
  4478.         the sapi folder of your extracted zip package,
  4479.         <TT
  4480. CLASS="filename"
  4481. >c:\php\sapi</TT
  4482. >.
  4483.        </P
  4484. ></LI
  4485. ><LI
  4486. ><P
  4487. >         The next step is to set up a valid configuration file for PHP, <TT
  4488. CLASS="filename"
  4489. >php.ini</TT
  4490. >.
  4491.         There are two ini files distributed in the zip file,
  4492.         <TT
  4493. CLASS="filename"
  4494. >php.ini-dist</TT
  4495. > and
  4496.         <TT
  4497. CLASS="filename"
  4498. >php.ini-recommended</TT
  4499. >. We advise you to use
  4500.         <TT
  4501. CLASS="filename"
  4502. >php.ini-recommended</TT
  4503. >, because we optimized the
  4504.         default settings in this file for performance, and security. Read this
  4505.         well documented file carefully and in addition study the
  4506.         <A
  4507. HREF="#configuration.file"
  4508. >ini settings</A
  4509. > and set every
  4510.         element manually yourself. If you would like to achieve the best
  4511.         security, then this is the way for you, although PHP works fine with
  4512.         these default ini files. Copy your chosen ini-file to a directory where
  4513.         PHP is able to find and rename it to <TT
  4514. CLASS="filename"
  4515. >php.ini</TT
  4516. >. By default PHP searches
  4517.         <TT
  4518. CLASS="filename"
  4519. >php.ini</TT
  4520. > in your Windows directory:
  4521.         <P
  4522. ></P
  4523. ><TABLE
  4524. BORDER="0"
  4525. ><TBODY
  4526. ><TR
  4527. ><TD
  4528. >           On Windows 9x/ME/XP copy your chosen ini file to your
  4529.          <TT
  4530. CLASS="filename"
  4531. > %WINDIR%</TT
  4532. >, which is typically
  4533.          <TT
  4534. CLASS="filename"
  4535. >C:\Windows</TT
  4536. >.
  4537.          </TD
  4538. ></TR
  4539. ><TR
  4540. ><TD
  4541. >           On Windows NT/2000 copy your chosen ini file to your
  4542.           <TT
  4543. CLASS="filename"
  4544. >%WINDIR%</TT
  4545. > or <TT
  4546. CLASS="filename"
  4547. >%SYSTEMROOT%</TT
  4548. >,
  4549.           which is typically <TT
  4550. CLASS="filename"
  4551. >C:\WINNT</TT
  4552. > or
  4553.          <TT
  4554. CLASS="filename"
  4555. >C:\WINNT40</TT
  4556. > for NT/2000 servers.
  4557.          </TD
  4558. ></TR
  4559. ></TBODY
  4560. ></TABLE
  4561. ><P
  4562. ></P
  4563. >   
  4564.        </P
  4565. ></LI
  4566. ><LI
  4567. ><P
  4568. >         If you're using NTFS on Windows NT, 2000 or XP, make sure that
  4569.         the user running the webserver has read permissions to your
  4570.         <TT
  4571. CLASS="filename"
  4572. >php.ini</TT
  4573. > (e.g. make it readable by Everyone).
  4574.        </P
  4575. ></LI
  4576. ></UL
  4577. >
  4578.     </P
  4579. ><P
  4580. >      The following steps are optional.
  4581.      <P
  4582. ></P
  4583. ><UL
  4584. ><LI
  4585. ><P
  4586. >         Edit your new <TT
  4587. CLASS="filename"
  4588. >php.ini</TT
  4589. > file.       
  4590.         If you plan to use <A
  4591. HREF="#install.omnihttpd"
  4592. >OmniHTTPd</A
  4593. >,
  4594.         do not follow the next step. Set the
  4595.         <A
  4596. HREF="#ini.doc-root"
  4597. >doc_root</A
  4598. > to point to your webservers
  4599.         document_root. For example:
  4600.         <DIV
  4601. CLASS="informalexample"
  4602. ><A
  4603. NAME="AEN723"
  4604. ></A
  4605. ><P
  4606. ></P
  4607. ><TABLE
  4608. BORDER="0"
  4609. BGCOLOR="#E0E0E0"
  4610. CELLPADDING="5"
  4611. ><TR
  4612. ><TD
  4613. ><PRE
  4614. CLASS="ini"
  4615. >doc_root = c:\inetpub        // for IIS/PWS
  4616.  
  4617. doc_root = c:\apache\htdocs // for Apache</PRE
  4618. ></TD
  4619. ></TR
  4620. ></TABLE
  4621. ><P
  4622. ></P
  4623. ></DIV
  4624. >
  4625.        </P
  4626. ></LI
  4627. ><LI
  4628. ><P
  4629. >         Choose which extensions you would like to load when PHP starts. See
  4630.         the section about
  4631.         <A
  4632. HREF="#install.windows.extensions"
  4633. >Windows extensions</A
  4634. >,
  4635.         about how to set up one, and what is already built in. Note that on
  4636.         a new installation it is advisable to first get PHP working and tested
  4637.         without any extensions before enabling them in <TT
  4638. CLASS="filename"
  4639. >php.ini</TT
  4640. >.
  4641.        </P
  4642. ></LI
  4643. ><LI
  4644. ><P
  4645. >         On PWS and IIS, you can set the
  4646.         <A
  4647. HREF="#ini.browscap"
  4648. >browscap</A
  4649. > configuration setting
  4650.         to point to:
  4651.         <TT
  4652. CLASS="filename"
  4653. >c:\windows\system\inetsrv\browscap.ini</TT
  4654. > on
  4655.         Windows 9x/Me,
  4656.         <TT
  4657. CLASS="filename"
  4658. >c:\winnt\system32\inetsrv\browscap.ini</TT
  4659. > on
  4660.         NT/2000, and
  4661.         <TT
  4662. CLASS="filename"
  4663. >c:\windows\system32\inetsrv\browscap.ini</TT
  4664. >
  4665.         on XP.
  4666.        </P
  4667. ></LI
  4668. ></UL
  4669. >
  4670.     </P
  4671. ><P
  4672. >      Following this instructions you are done with the basic steps to setup PHP
  4673.      on Windows. The next step is to choose a webserver and enable it to run
  4674.      PHP. Installation instructions for the following webservers are available:
  4675.      <P
  4676. ></P
  4677. ><UL
  4678. ><LI
  4679. ><P
  4680. >         .. the <A
  4681. HREF="#install.iis"
  4682. >Windows server family</A
  4683. >, Personal
  4684.         Web server (PWS) 3 and 4 or newer;  Internet Information Server (IIS) 3
  4685.         and 4 or newer.
  4686.        </P
  4687. ></LI
  4688. ><LI
  4689. ><P
  4690. >         .. the Apache servers
  4691.         <A
  4692. HREF="#install.apache.windows"
  4693. >Apache 1.3.x</A
  4694. >, and
  4695.         <A
  4696. HREF="#install.apache2.windows"
  4697. >Apache 2.x</A
  4698. >.        
  4699.        </P
  4700. ></LI
  4701. ><LI
  4702. ><P
  4703. >         .. the
  4704.         <A
  4705. HREF="#install.netscape.windows"
  4706. >Netscape/iPlanet</A
  4707. > servers.      
  4708.        </P
  4709. ></LI
  4710. ><LI
  4711. ><P
  4712. >         .. the <A
  4713. HREF="#install.omnihttpd"
  4714. >OmniHTTPd</A
  4715. > server.
  4716.        </P
  4717. ></LI
  4718. ><LI
  4719. ><P
  4720. >         .. the <A
  4721. HREF="#install.oreilly"
  4722. >Oreilly Website Pro</A
  4723. > server.
  4724.        </P
  4725. ></LI
  4726. ><LI
  4727. ><P
  4728. >         .. the <A
  4729. HREF="#install.sambar"
  4730. >Sambar</A
  4731. > server.
  4732.        </P
  4733. ></LI
  4734. ><LI
  4735. ><P
  4736. >         .. the <A
  4737. HREF="#install.xitami"
  4738. >Xitami</A
  4739. > server.
  4740.        </P
  4741. ></LI
  4742. ></UL
  4743. >
  4744.    </P
  4745. ></DIV
  4746. ><DIV
  4747. CLASS="sect2"
  4748. ><HR><H3
  4749. CLASS="sect2"
  4750. ><A
  4751. NAME="install.windows.build"
  4752. ></A
  4753. >Building from source</H3
  4754. ><P
  4755. >      Before getting started, it is worthwhile answering the question:
  4756.      "Why is building on Windows so hard?" Two reasons come to mind:
  4757.     </P
  4758. ><P
  4759. ></P
  4760. ><OL
  4761. TYPE="1"
  4762. ><LI
  4763. ><P
  4764. >        Windows does not (yet) enjoy a large community of developers
  4765.        who are willing to freely share their source. As a direct
  4766.        result, the necessary investment in infrastructure required
  4767.        to support such development hasn't been made. By and large,
  4768.        what is available has been made possible by the porting of
  4769.        necessary utilities from Unix. Don't be surprised if some of
  4770.        this heritage shows through from time to time.
  4771.       </P
  4772. ></LI
  4773. ><LI
  4774. ><P
  4775. >        Pretty much all of the instructions that follow are of the
  4776.        "set and forget" variety. So sit back and try follow the
  4777.        instructions below as faithfully as you can.
  4778.       </P
  4779. ></LI
  4780. ></OL
  4781. ><DIV
  4782. CLASS="sect3"
  4783. ><HR><H4
  4784. CLASS="sect3"
  4785. ><A
  4786. NAME="install.windows.build.requirement"
  4787. ></A
  4788. >Po╛adavky</H4
  4789. ><P
  4790. >       To compile and build <TT
  4791. CLASS="literal"
  4792. >PHP</TT
  4793. > you need a Microsoft
  4794.       Development Environment. Microsoft Visual C++ 6.0 is recommended.
  4795.       To extract the downloaded files you need a extraction utility
  4796.       (e.g.: Winzip). If you don't already have an unzip utility, you
  4797.       can get a free version from <A
  4798. HREF="http://www.info-zip.org/pub/infozip/"
  4799. TARGET="_top"
  4800. >InfoZip</A
  4801. >.
  4802.      </P
  4803. ><P
  4804. >       Before you get started, you have to download...
  4805.      </P
  4806. ><P
  4807. ></P
  4808. ><UL
  4809. ><LI
  4810. ><P
  4811. >         ..the win32 buildtools from the <TT
  4812. CLASS="literal"
  4813. >PHP</TT
  4814. > site
  4815.         at <A
  4816. HREF="http://www.php.net/extra/win32build.zip"
  4817. TARGET="_top"
  4818. >http://www.php.net/extra/win32build.zip</A
  4819. >.
  4820.        </P
  4821. ></LI
  4822. ><LI
  4823. ><P
  4824. >         ..the source code for the DNS name resolver used by <TT
  4825. CLASS="literal"
  4826. >PHP
  4827.         </TT
  4828. > from <A
  4829. HREF="http://www.php.net/extra/bindlib_w32.zip"
  4830. TARGET="_top"
  4831. >         http://www.php.net/extra/bindlib_w32.zip</A
  4832. >. This is a replacement for the 
  4833.         <TT
  4834. CLASS="filename"
  4835. >resolv.lib</TT
  4836. > library included in <TT
  4837. CLASS="filename"
  4838. >         win32build.zip</TT
  4839. >.
  4840.        </P
  4841. ></LI
  4842. ><LI
  4843. ><P
  4844. >         If you plan to compile <TT
  4845. CLASS="literal"
  4846. >PHP</TT
  4847. > as a Apache
  4848.         module you will also need the <A
  4849. HREF="http://www.apache.org/dist/httpd/"
  4850. TARGET="_top"
  4851. >Apache
  4852.         sources</A
  4853. >.
  4854.        </P
  4855. ></LI
  4856. ></UL
  4857. ><P
  4858. >       Finally, you are going to need the source to PHP 4 itself. You can get
  4859.       the latest development version using <A
  4860. HREF="http://www.php.net/anoncvs.php"
  4861. TARGET="_top"
  4862. >       anonymous CVS</A
  4863. >, a <A
  4864. HREF="http://snaps.php.net/"
  4865. TARGET="_top"
  4866. >       snapshot</A
  4867. > or the most recent released <A
  4868. HREF="http://www.php.net/downloads.php"
  4869. TARGET="_top"
  4870. >       source</A
  4871. > tarball.
  4872.      </P
  4873. ></DIV
  4874. ><DIV
  4875. CLASS="sect3"
  4876. ><HR><H4
  4877. CLASS="sect3"
  4878. ><A
  4879. NAME="install.windows.build.install"
  4880. ></A
  4881. >Putting it all together</H4
  4882. ><P
  4883. >       After downloading the required packages you have to extract them in a
  4884.       proper place.
  4885.       <P
  4886. ></P
  4887. ><UL
  4888. ><LI
  4889. ><P
  4890. >          Create a working directory where all files end up after extracting, e.g:
  4891.          <TT
  4892. CLASS="filename"
  4893. >C:\work</TT
  4894. >.
  4895.         </P
  4896. ></LI
  4897. ><LI
  4898. ><P
  4899. >          Create the directory <TT
  4900. CLASS="filename"
  4901. >win32build</TT
  4902. > under your
  4903.          working directory (<TT
  4904. CLASS="filename"
  4905. >C:\work</TT
  4906. >) and unzip <TT
  4907. CLASS="filename"
  4908. >          win32build.zip</TT
  4909. > into it.
  4910.         </P
  4911. ></LI
  4912. ><LI
  4913. ><P
  4914. >          Create the directory <TT
  4915. CLASS="filename"
  4916. >bindlib_w32</TT
  4917. > under your
  4918.          working directory (<TT
  4919. CLASS="filename"
  4920. >C:\work</TT
  4921. >) and unzip <TT
  4922. CLASS="filename"
  4923. >          bindlib_w32.zip</TT
  4924. > into it.
  4925.         </P
  4926. ></LI
  4927. ><LI
  4928. ><P
  4929. >          Extract the downloaded PHP source code into your working directory
  4930.          (<TT
  4931. CLASS="filename"
  4932. >C:\work</TT
  4933. >).
  4934.         </P
  4935. ></LI
  4936. ></UL
  4937. >
  4938.       Following this steps your directory structure looks like this:
  4939.       <DIV
  4940. CLASS="informalexample"
  4941. ><A
  4942. NAME="AEN812"
  4943. ></A
  4944. ><P
  4945. ></P
  4946. ><TABLE
  4947. BORDER="0"
  4948. BGCOLOR="#E0E0E0"
  4949. CELLPADDING="5"
  4950. ><TR
  4951. ><TD
  4952. ><PRE
  4953. CLASS="programlisting"
  4954. >+--c:\work
  4955. |  |
  4956. |  +--bindlib_w32
  4957. |  |  |
  4958. |  |  +--arpa
  4959. |  |  |
  4960. |  |  +--conf
  4961. |  |  |
  4962. |  |  +--...
  4963. |  |
  4964. |  +--php-4.x.x
  4965. |  |  |
  4966. |  |  +--build
  4967. |  |  |
  4968. |  |  +--...
  4969. |  |  |
  4970. |  |  +--win32
  4971. |  |  |
  4972. |  |  +--...
  4973. |  |
  4974. |  +--win32build
  4975. |  |  |
  4976. |  |  +--bin
  4977. |  |  |
  4978. |  |  +--include
  4979. |  |  |
  4980. |  |  +--lib</PRE
  4981. ></TD
  4982. ></TR
  4983. ></TABLE
  4984. ><P
  4985. ></P
  4986. ></DIV
  4987. >
  4988.       Create the directories <TT
  4989. CLASS="filename"
  4990. >c:\usr\local\lib</TT
  4991. >. Copy
  4992.       <TT
  4993. CLASS="filename"
  4994. >bison.simple</TT
  4995. > from <TT
  4996. CLASS="filename"
  4997. >c:\work\win32build\bin
  4998.       </TT
  4999. > to <TT
  5000. CLASS="filename"
  5001. >c:\usr\local\lib</TT
  5002. >.
  5003.      </P
  5004. ><DIV
  5005. CLASS="note"
  5006. ><BLOCKQUOTE
  5007. CLASS="note"
  5008. ><P
  5009. ><B
  5010. >Poznßmka: </B
  5011. >
  5012.        <A
  5013. HREF="http://www.cygwin.com/"
  5014. TARGET="_top"
  5015. >Cygwin</A
  5016. > users may omit the last
  5017.        step. A properly installed Cygwin environment provides the mandatory
  5018.        files <TT
  5019. CLASS="filename"
  5020. >bison.simple</TT
  5021. > and
  5022.        <TT
  5023. CLASS="filename"
  5024. >bison.exe</TT
  5025. >.
  5026.       </P
  5027. ></BLOCKQUOTE
  5028. ></DIV
  5029. ></DIV
  5030. ><DIV
  5031. CLASS="sect3"
  5032. ><HR><H4
  5033. CLASS="sect3"
  5034. ><A
  5035. NAME="install.windows.build.configure"
  5036. ></A
  5037. >Configure MVC ++</H4
  5038. ><P
  5039. >        The next step is to configure MVC ++ to prepare for compiling.
  5040.        Launch Microsoft Visual C++, and from the menu select
  5041.        Tools => Options. In the dialog, select the
  5042.        directories tab. Sequentially change the dropdown
  5043.        to Executables, Includes, and Library files. Your entries should look
  5044.        like this:
  5045.        <P
  5046. ></P
  5047. ><UL
  5048. ><LI
  5049. ><P
  5050. >           Executable files: <TT
  5051. CLASS="filename"
  5052. >c:\work\win32build\bin</TT
  5053. >,
  5054.           Cygwin users: <TT
  5055. CLASS="filename"
  5056. >cygwin\bin</TT
  5057. >
  5058.          </P
  5059. ></LI
  5060. ><LI
  5061. ><P
  5062. >           Include files: <TT
  5063. CLASS="filename"
  5064. >c:\work\win32build\include</TT
  5065. >
  5066.          </P
  5067. ></LI
  5068. ><LI
  5069. ><P
  5070. >           Library files: <TT
  5071. CLASS="filename"
  5072. >c:\work\win32build\lib</TT
  5073. >
  5074.          </P
  5075. ></LI
  5076. ></UL
  5077. >
  5078.       </P
  5079. ></DIV
  5080. ><DIV
  5081. CLASS="sect3"
  5082. ><HR><H4
  5083. CLASS="sect3"
  5084. ><A
  5085. NAME="install.windows.build.resolvlib"
  5086. ></A
  5087. >Build resolv.lib</H4
  5088. ><P
  5089. >        You must build the <TT
  5090. CLASS="filename"
  5091. >resolv.lib</TT
  5092. > library.
  5093.        Decide whether you want to have debug symbols available
  5094.        (bindlib - Win32 Debug) or not (bindlib - Win32 Release).
  5095.        Build the appropriate configuration: 
  5096.        <P
  5097. ></P
  5098. ><UL
  5099. ><LI
  5100. ><P
  5101. >           For GUI users, launch VC++, and then select File => Open
  5102.           Workspace, navigate to <TT
  5103. CLASS="filename"
  5104. >c:\work\bindlib_w32</TT
  5105. > and
  5106.           select <TT
  5107. CLASS="filename"
  5108. >bindlib.dsw</TT
  5109. >. Then select Build=>Set
  5110.           Active Configuration and select the desired configuration.
  5111.           Finally select Build=>Rebuild All.
  5112.          </P
  5113. ></LI
  5114. ><LI
  5115. ><P
  5116. >           For command line users, make sure that you either have the C++
  5117.           environment variables registered, or have run
  5118.           <B
  5119. CLASS="command"
  5120. >vcvars.bat</B
  5121. >, and then execute one of the following
  5122.           commands:
  5123.          </P
  5124. ><P
  5125. ></P
  5126. ><UL
  5127. ><LI
  5128. ><P
  5129. >             <TT
  5130. CLASS="userinput"
  5131. ><B
  5132. >msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"</B
  5133. ></TT
  5134. >
  5135.            </P
  5136. ></LI
  5137. ><LI
  5138. ><P
  5139. >             <TT
  5140. CLASS="userinput"
  5141. ><B
  5142. >msdev bindlib.dsp /MAKE "bindlib - Win32 Release"</B
  5143. ></TT
  5144. >
  5145.            </P
  5146. ></LI
  5147. ></UL
  5148. ></LI
  5149. ></UL
  5150. >
  5151.        At this point, you should have a usable <TT
  5152. CLASS="filename"
  5153. >resolv.lib</TT
  5154. >
  5155.        in either your <TT
  5156. CLASS="filename"
  5157. >c:\work\bindlib_w32\Debug</TT
  5158. > or
  5159.        <TT
  5160. CLASS="filename"
  5161. >Release</TT
  5162. > subdirectories. Copy this file into your
  5163.        <TT
  5164. CLASS="filename"
  5165. >c:\work\win32build\lib</TT
  5166. > directory over the file
  5167.        by the same name found in there.
  5168.       </P
  5169. ></DIV
  5170. ><DIV
  5171. CLASS="sect3"
  5172. ><HR><H4
  5173. CLASS="sect3"
  5174. ><A
  5175. NAME="install.windows.build.compile"
  5176. ></A
  5177. >Compiling</H4
  5178. ><P
  5179. >       The best way to get started is to build the CGI version.
  5180.      </P
  5181. ><P
  5182. ></P
  5183. ><UL
  5184. ><LI
  5185. ><P
  5186. >         For GUI users, launch VC++, and then select File => Open
  5187.         Workspace and select <TT
  5188. CLASS="filename"
  5189. >c:\work\php-4.x.x\win32\php4ts.dsw
  5190.         </TT
  5191. >. Then select Build=>Set Active
  5192.         Configuration and select the desired configuration, either
  5193.         <TT
  5194. CLASS="literal"
  5195. >php4ts - Win32 Debug_TS</TT
  5196. > or
  5197.         <TT
  5198. CLASS="literal"
  5199. >php4ts - Win32 Release_TS</TT
  5200. >. Finally select
  5201.         Build=>Rebuild All.
  5202.        </P
  5203. ></LI
  5204. ><LI
  5205. ><P
  5206. >         For command line users, make sure that you either have
  5207.         the C++ environment variables registered, or have run
  5208.         <B
  5209. CLASS="command"
  5210. >vcvars.bat</B
  5211. >, and then execute one of the
  5212.         following commands from the <TT
  5213. CLASS="filename"
  5214. >c:\work\php-4.x.x\win32
  5215.         </TT
  5216. > directory:
  5217.        </P
  5218. ><P
  5219. ></P
  5220. ><UL
  5221. ><LI
  5222. ><P
  5223. >           <TT
  5224. CLASS="userinput"
  5225. ><B
  5226. >msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"</B
  5227. ></TT
  5228. >
  5229.          </P
  5230. ></LI
  5231. ><LI
  5232. ><P
  5233. >           <TT
  5234. CLASS="userinput"
  5235. ><B
  5236. >msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"</B
  5237. ></TT
  5238. >
  5239.          </P
  5240. ></LI
  5241. ><LI
  5242. ><P
  5243. >           At this point, you should have a usable <TT
  5244. CLASS="filename"
  5245. >php.exe</TT
  5246. >
  5247.           in either your <TT
  5248. CLASS="filename"
  5249. >c:\work\php-4.x.x.\Debug_TS</TT
  5250. > or
  5251.           <TT
  5252. CLASS="filename"
  5253. >Release_TS</TT
  5254. > subdirectories.
  5255.          </P
  5256. ></LI
  5257. ></UL
  5258. ></LI
  5259. ></UL
  5260. ><P
  5261. >       It is possible to do minor customization to the build process by editing
  5262.       the <TT
  5263. CLASS="filename"
  5264. >main/config.win32.h</TT
  5265. > file. For example you can
  5266.       change the default location of <TT
  5267. CLASS="filename"
  5268. >php.ini</TT
  5269. >, the built-in extensions, and the
  5270.       default location for your extensions.
  5271.      </P
  5272. ><P
  5273. >       Next you may want to build the CLI version which is designed to use
  5274.       <A
  5275. HREF="#features.commandline"
  5276. >PHP from the command line</A
  5277. >.
  5278.       The steps are the same as for building the CGI version, except you have
  5279.       to select the <TT
  5280. CLASS="literal"
  5281. >php4ts_cli - Win32 Debug_TS</TT
  5282. > or
  5283.       <TT
  5284. CLASS="literal"
  5285. >php4ts_cli - Win32 Release_TS</TT
  5286. > project file. After a
  5287.       successful compiling run you will find the <TT
  5288. CLASS="filename"
  5289. >php.exe</TT
  5290. >
  5291.       in either the directory <TT
  5292. CLASS="filename"
  5293. >Release_TS\cli\</TT
  5294. > or
  5295.       <TT
  5296. CLASS="filename"
  5297. >Debug_TS\cli\</TT
  5298. >.
  5299.      </P
  5300. ><DIV
  5301. CLASS="note"
  5302. ><BLOCKQUOTE
  5303. CLASS="note"
  5304. ><P
  5305. ><B
  5306. >Poznßmka: </B
  5307. >
  5308.        If you want to use PEAR and the comfortable command line installer,
  5309.        the CLI-SAPI is mandatory. For more information about PEAR and the
  5310.        installer read the documentation at the <A
  5311. HREF="http://pear.php.net/manual/"
  5312. TARGET="_top"
  5313. >        PEAR</A
  5314. > website.
  5315.       </P
  5316. ></BLOCKQUOTE
  5317. ></DIV
  5318. ><P
  5319. >       In order to build the SAPI module (<TT
  5320. CLASS="filename"
  5321. >php4isapi.dll</TT
  5322. >)
  5323.       for integrating PHP with Microsoft IIS, set your active configuration to
  5324.       <TT
  5325. CLASS="filename"
  5326. >php4isapi-whatever-config</TT
  5327. > and build the desired dll.
  5328.      </P
  5329. ></DIV
  5330. ></DIV
  5331. ><DIV
  5332. CLASS="sect2"
  5333. ><HR><H3
  5334. CLASS="sect2"
  5335. ><A
  5336. NAME="install.windows.extensions"
  5337. ></A
  5338. >Installation of Windows extensions</H3
  5339. ><P
  5340. >      After installing PHP and a webserver on Windows, you will probably want to
  5341.      install some extensions for added functionality. You can choose which
  5342.      extensions you would like to load when PHP starts by modifying your
  5343.      <TT
  5344. CLASS="filename"
  5345. >php.ini</TT
  5346. >. You can also load a module dynamically in your script using
  5347.      <A
  5348. HREF="#function.dl"
  5349. ><B
  5350. CLASS="function"
  5351. >dl()</B
  5352. ></A
  5353. >.
  5354.     </P
  5355. ><P
  5356. >      The DLLs for PHP extensions are prefixed with 'php_' in PHP 4 (and 
  5357.      'php3_' in PHP 3). This prevents confusion between PHP extensions 
  5358.      and their supporting libraries. 
  5359.     </P
  5360. ><DIV
  5361. CLASS="note"
  5362. ><BLOCKQUOTE
  5363. CLASS="note"
  5364. ><P
  5365. ><B
  5366. >Poznßmka: </B
  5367. >
  5368.       In PHP 4.3.1 BCMath, Calendar, COM, Ctype, FTP, MySQL, ODBC, Overload,
  5369.       PCRE, Session, Tokenizer, WDDX, XML and Zlib support is
  5370.       <SPAN
  5371. CLASS="emphasis"
  5372. ><I
  5373. CLASS="emphasis"
  5374. >built in</I
  5375. ></SPAN
  5376. >. You don't need to load any additional
  5377.       extensions in order to use these functions. See your distributions
  5378.       <TT
  5379. CLASS="filename"
  5380. >README.txt</TT
  5381. > or <TT
  5382. CLASS="filename"
  5383. >install.txt</TT
  5384. >
  5385.       or <A
  5386. HREF="#install.extensions.overview"
  5387. >this table</A
  5388. >
  5389.       for a list of built in modules.
  5390.      </P
  5391. ></BLOCKQUOTE
  5392. ></DIV
  5393. ><P
  5394. >      The default location <TT
  5395. CLASS="literal"
  5396. >PHP</TT
  5397. > searches for extensions is
  5398.      <TT
  5399. CLASS="filename"
  5400. >c:\php4\extensions</TT
  5401. >. To change this setting to reflect
  5402.      your setup of <TT
  5403. CLASS="literal"
  5404. >PHP</TT
  5405. > edit your <TT
  5406. CLASS="filename"
  5407. >php.ini</TT
  5408. > file:
  5409.      <P
  5410. ></P
  5411. ><UL
  5412. ><LI
  5413. ><P
  5414. >         You will need to change the
  5415.         <A
  5416. HREF="#ini.extension-dir"
  5417. >extension_dir</A
  5418. > setting to
  5419.         point to the directory where your extensions lives, or where you have
  5420.         placed your <TT
  5421. CLASS="filename"
  5422. >php_*.dll</TT
  5423. > files. Please do not
  5424.         forget the last backslash. For example:
  5425.         <DIV
  5426. CLASS="informalexample"
  5427. ><A
  5428. NAME="AEN923"
  5429. ></A
  5430. ><P
  5431. ></P
  5432. ><TABLE
  5433. BORDER="0"
  5434. BGCOLOR="#E0E0E0"
  5435. CELLPADDING="5"
  5436. ><TR
  5437. ><TD
  5438. ><PRE
  5439. CLASS="ini"
  5440. >extension_dir = c:/php/extensions/</PRE
  5441. ></TD
  5442. ></TR
  5443. ></TABLE
  5444. ><P
  5445. ></P
  5446. ></DIV
  5447. >
  5448.        </P
  5449. ></LI
  5450. ><LI
  5451. ><P
  5452. >        Enable the extension(s) in <TT
  5453. CLASS="filename"
  5454. >php.ini</TT
  5455. > you want to use by uncommenting the
  5456.        <TT
  5457. CLASS="literal"
  5458. >extension=php_*.dll</TT
  5459. > lines in <TT
  5460. CLASS="filename"
  5461. >php.ini</TT
  5462. >. This is done
  5463.        by deleting the leading ; form the extension you want to load. 
  5464.        <TABLE
  5465. WIDTH="100%"
  5466. BORDER="0"
  5467. CELLPADDING="0"
  5468. CELLSPACING="0"
  5469. CLASS="EXAMPLE"
  5470. ><TR
  5471. ><TD
  5472. ><DIV
  5473. CLASS="example"
  5474. ><A
  5475. NAME="AEN930"
  5476. ></A
  5477. ><P
  5478. ><B
  5479. >P°φklad 3-3. Enable <A
  5480. HREF="#ref.bzip2"
  5481. >Bzip2</A
  5482. > extension for PHP-Windows</B
  5483. ></P
  5484. ><TABLE
  5485. BORDER="0"
  5486. BGCOLOR="#E0E0E0"
  5487. CELLPADDING="5"
  5488. ><TR
  5489. ><TD
  5490. ><PRE
  5491. CLASS="ini"
  5492. >// change the following line from ...
  5493. ;extension=php_bz2.dll
  5494.  
  5495. // ... to
  5496. extension=php_bz2.dll</PRE
  5497. ></TD
  5498. ></TR
  5499. ></TABLE
  5500. ></DIV
  5501. ></TD
  5502. ></TR
  5503. ></TABLE
  5504. >      
  5505.        </P
  5506. ></LI
  5507. ><LI
  5508. ><P
  5509. >         Some of the extensions need extra DLLs to work. Couple of them can be
  5510.         found in the distribution package, in the
  5511.         <TT
  5512. CLASS="filename"
  5513. >c:\php\dlls\</TT
  5514. > folder but some, for example Oracle
  5515.         (<TT
  5516. CLASS="filename"
  5517. >php_oci8.dll</TT
  5518. >) require DLLs which are not bundled
  5519.         with the distribution package. Copy the bundled DLLs from
  5520.         <TT
  5521. CLASS="filename"
  5522. >c:\php\dlls</TT
  5523. > folder to your Windows PATH, safe
  5524.         places are:
  5525.         <P
  5526. ></P
  5527. ><TABLE
  5528. BORDER="0"
  5529. ><TBODY
  5530. ><TR
  5531. ><TD
  5532. >c:\windows\system for Windows 9x/Me</TD
  5533. ></TR
  5534. ><TR
  5535. ><TD
  5536. >c:\winnt\system32 for Windows NT/2000</TD
  5537. ></TR
  5538. ><TR
  5539. ><TD
  5540. >c:\windows\system32 for Windows XP</TD
  5541. ></TR
  5542. ></TBODY
  5543. ></TABLE
  5544. ><P
  5545. ></P
  5546. >       
  5547.         If you have them already installed on your system, overwrite them only
  5548.         if something doesn't work correctly (Before overwriting them, it is a
  5549.         good idea to make a backup of them, or move them to another folder -
  5550.         just in case something goes wrong).
  5551.        </P
  5552. ></LI
  5553. ></UL
  5554. >
  5555.    <DIV
  5556. CLASS="note"
  5557. ><BLOCKQUOTE
  5558. CLASS="note"
  5559. ><P
  5560. ><B
  5561. >Poznßmka: </B
  5562. >
  5563.      If you are running a server module version of <TT
  5564. CLASS="literal"
  5565. >PHP</TT
  5566. >
  5567.      remember to restart your webserver to reflect your changes to <TT
  5568. CLASS="filename"
  5569. >php.ini</TT
  5570. >.
  5571.     </P
  5572. ></BLOCKQUOTE
  5573. ></DIV
  5574. >
  5575.    </P
  5576. ><P
  5577. >     The following table describes some of the extensions available and required
  5578.     additional dlls.   
  5579.     <DIV
  5580. CLASS="table"
  5581. ><A
  5582. NAME="install.extensions.overview"
  5583. ></A
  5584. ><P
  5585. ><B
  5586. >Tabulka 3-1. PHP Extensions</B
  5587. ></P
  5588. ><TABLE
  5589. BORDER="1"
  5590. CLASS="CALSTABLE"
  5591. ><THEAD
  5592. ><TR
  5593. ><TH
  5594. ALIGN="LEFT"
  5595. VALIGN="MIDDLE"
  5596. >Extension</TH
  5597. ><TH
  5598. ALIGN="LEFT"
  5599. VALIGN="MIDDLE"
  5600. >Description</TH
  5601. ><TH
  5602. ALIGN="LEFT"
  5603. VALIGN="MIDDLE"
  5604. >Notes</TH
  5605. ></TR
  5606. ></THEAD
  5607. ><TBODY
  5608. ><TR
  5609. ><TD
  5610. ALIGN="LEFT"
  5611. VALIGN="MIDDLE"
  5612. >php_bz2.dll</TD
  5613. ><TD
  5614. ALIGN="LEFT"
  5615. VALIGN="MIDDLE"
  5616. ><A
  5617. HREF="#ref.bzip2"
  5618. >bzip2</A
  5619. > compression functions</TD
  5620. ><TD
  5621. ALIGN="LEFT"
  5622. VALIGN="MIDDLE"
  5623. >None</TD
  5624. ></TR
  5625. ><TR
  5626. ><TD
  5627. ALIGN="LEFT"
  5628. VALIGN="MIDDLE"
  5629. >php_calendar.dll</TD
  5630. ><TD
  5631. ALIGN="LEFT"
  5632. VALIGN="MIDDLE"
  5633. ><A
  5634. HREF="#ref.calendar"
  5635. >Calendar</A
  5636. > conversion functions</TD
  5637. ><TD
  5638. ALIGN="LEFT"
  5639. VALIGN="MIDDLE"
  5640. >Built in since PHP 4.0.3</TD
  5641. ></TR
  5642. ><TR
  5643. ><TD
  5644. ALIGN="LEFT"
  5645. VALIGN="MIDDLE"
  5646. >php_cpdf.dll</TD
  5647. ><TD
  5648. ALIGN="LEFT"
  5649. VALIGN="MIDDLE"
  5650. ><A
  5651. HREF="#ref.cpdf"
  5652. >ClibPDF</A
  5653. > functions</TD
  5654. ><TD
  5655. ALIGN="LEFT"
  5656. VALIGN="MIDDLE"
  5657. >None</TD
  5658. ></TR
  5659. ><TR
  5660. ><TD
  5661. ALIGN="LEFT"
  5662. VALIGN="MIDDLE"
  5663. >php_crack.dll</TD
  5664. ><TD
  5665. ALIGN="LEFT"
  5666. VALIGN="MIDDLE"
  5667. ><A
  5668. HREF="#ref.crack"
  5669. >Crack</A
  5670. > functions</TD
  5671. ><TD
  5672. ALIGN="LEFT"
  5673. VALIGN="MIDDLE"
  5674. >None</TD
  5675. ></TR
  5676. ><TR
  5677. ><TD
  5678. ALIGN="LEFT"
  5679. VALIGN="MIDDLE"
  5680. >php3_crypt.dll</TD
  5681. ><TD
  5682. ALIGN="LEFT"
  5683. VALIGN="MIDDLE"
  5684. >Crypt functions</TD
  5685. ><TD
  5686. ALIGN="LEFT"
  5687. VALIGN="MIDDLE"
  5688. >unknown</TD
  5689. ></TR
  5690. ><TR
  5691. ><TD
  5692. ALIGN="LEFT"
  5693. VALIGN="MIDDLE"
  5694. >php_ctype.dll</TD
  5695. ><TD
  5696. ALIGN="LEFT"
  5697. VALIGN="MIDDLE"
  5698. ><A
  5699. HREF="#ref.ctype"
  5700. >ctype</A
  5701. > family functions</TD
  5702. ><TD
  5703. ALIGN="LEFT"
  5704. VALIGN="MIDDLE"
  5705. >Built in since PHP 4.3.0</TD
  5706. ></TR
  5707. ><TR
  5708. ><TD
  5709. ALIGN="LEFT"
  5710. VALIGN="MIDDLE"
  5711. >php_curl.dll</TD
  5712. ><TD
  5713. ALIGN="LEFT"
  5714. VALIGN="MIDDLE"
  5715. ><A
  5716. HREF="#ref.curl"
  5717. >CURL</A
  5718. >, Client URL library functions</TD
  5719. ><TD
  5720. ALIGN="LEFT"
  5721. VALIGN="MIDDLE"
  5722. >Requires: <TT
  5723. CLASS="filename"
  5724. >libeay32.dll</TT
  5725. >, 
  5726.    <TT
  5727. CLASS="filename"
  5728. >ssleay32.dll</TT
  5729. > (bundled)</TD
  5730. ></TR
  5731. ><TR
  5732. ><TD
  5733. ALIGN="LEFT"
  5734. VALIGN="MIDDLE"
  5735. >php_cybercash.dll</TD
  5736. ><TD
  5737. ALIGN="LEFT"
  5738. VALIGN="MIDDLE"
  5739. ><A
  5740. HREF="#ref.cybercash"
  5741. >Cybercash</A
  5742. > payment functions</TD
  5743. ><TD
  5744. ALIGN="LEFT"
  5745. VALIGN="MIDDLE"
  5746. >PHP <= 4.2.0</TD
  5747. ></TR
  5748. ><TR
  5749. ><TD
  5750. ALIGN="LEFT"
  5751. VALIGN="MIDDLE"
  5752. >php_db.dll</TD
  5753. ><TD
  5754. ALIGN="LEFT"
  5755. VALIGN="MIDDLE"
  5756. ><A
  5757. HREF="#ref.dbm"
  5758. >DBM</A
  5759. > functions</TD
  5760. ><TD
  5761. ALIGN="LEFT"
  5762. VALIGN="MIDDLE"
  5763. >Deprecated. Use DBA instead (<TT
  5764. CLASS="filename"
  5765. >php_dba.dll</TT
  5766. >)</TD
  5767. ></TR
  5768. ><TR
  5769. ><TD
  5770. ALIGN="LEFT"
  5771. VALIGN="MIDDLE"
  5772. >php_dba.dll</TD
  5773. ><TD
  5774. ALIGN="LEFT"
  5775. VALIGN="MIDDLE"
  5776. ><A
  5777. HREF="#ref.dba"
  5778. >DBA</A
  5779. >: DataBase (dbm-style) 
  5780.    Abstraction layer functions</TD
  5781. ><TD
  5782. ALIGN="LEFT"
  5783. VALIGN="MIDDLE"
  5784. >None</TD
  5785. ></TR
  5786. ><TR
  5787. ><TD
  5788. ALIGN="LEFT"
  5789. VALIGN="MIDDLE"
  5790. >php_dbase.dll</TD
  5791. ><TD
  5792. ALIGN="LEFT"
  5793. VALIGN="MIDDLE"
  5794. ><A
  5795. HREF="#ref.dbase"
  5796. >dBase</A
  5797. > functions</TD
  5798. ><TD
  5799. ALIGN="LEFT"
  5800. VALIGN="MIDDLE"
  5801. >None</TD
  5802. ></TR
  5803. ><TR
  5804. ><TD
  5805. ALIGN="LEFT"
  5806. VALIGN="MIDDLE"
  5807. >php3_dbm.dll</TD
  5808. ><TD
  5809. ALIGN="LEFT"
  5810. VALIGN="MIDDLE"
  5811. >Berkeley DB2 library</TD
  5812. ><TD
  5813. ALIGN="LEFT"
  5814. VALIGN="MIDDLE"
  5815. >unknown</TD
  5816. ></TR
  5817. ><TR
  5818. ><TD
  5819. ALIGN="LEFT"
  5820. VALIGN="MIDDLE"
  5821. >php_dbx.dll</TD
  5822. ><TD
  5823. ALIGN="LEFT"
  5824. VALIGN="MIDDLE"
  5825. ><A
  5826. HREF="#ref.dbx"
  5827. >dbx</A
  5828. > functions</TD
  5829. ><TD
  5830. ALIGN="LEFT"
  5831. VALIGN="MIDDLE"
  5832. > </TD
  5833. ></TR
  5834. ><TR
  5835. ><TD
  5836. ALIGN="LEFT"
  5837. VALIGN="MIDDLE"
  5838. >php_domxml.dll</TD
  5839. ><TD
  5840. ALIGN="LEFT"
  5841. VALIGN="MIDDLE"
  5842. ><A
  5843. HREF="#ref.domxml"
  5844. >DOM XML</A
  5845. > functions</TD
  5846. ><TD
  5847. ALIGN="LEFT"
  5848. VALIGN="MIDDLE"
  5849. >     PHP <= 4.2.0 requires: <TT
  5850. CLASS="filename"
  5851. >libxml2.dll</TT
  5852. > (bundled)
  5853.     PHP >= 4.3.0 requires: <TT
  5854. CLASS="filename"
  5855. >iconv.dll</TT
  5856. > (bundled)
  5857.    </TD
  5858. ></TR
  5859. ><TR
  5860. ><TD
  5861. ALIGN="LEFT"
  5862. VALIGN="MIDDLE"
  5863. >php_dotnet.dll</TD
  5864. ><TD
  5865. ALIGN="LEFT"
  5866. VALIGN="MIDDLE"
  5867. ><A
  5868. HREF="#ref.dotnet"
  5869. >.NET</A
  5870. > functions</TD
  5871. ><TD
  5872. ALIGN="LEFT"
  5873. VALIGN="MIDDLE"
  5874. >PHP <= 4.1.1</TD
  5875. ></TR
  5876. ><TR
  5877. ><TD
  5878. ALIGN="LEFT"
  5879. VALIGN="MIDDLE"
  5880. >php_exif.dll</TD
  5881. ><TD
  5882. ALIGN="LEFT"
  5883. VALIGN="MIDDLE"
  5884. ><A
  5885. HREF="#function.read-exif-data"
  5886. >Read EXIF</A
  5887. > headers from JPEG</TD
  5888. ><TD
  5889. ALIGN="LEFT"
  5890. VALIGN="MIDDLE"
  5891. >None</TD
  5892. ></TR
  5893. ><TR
  5894. ><TD
  5895. ALIGN="LEFT"
  5896. VALIGN="MIDDLE"
  5897. >php_fbsql.dll</TD
  5898. ><TD
  5899. ALIGN="LEFT"
  5900. VALIGN="MIDDLE"
  5901. ><A
  5902. HREF="#ref.fbsql"
  5903. >FrontBase</A
  5904. > functions</TD
  5905. ><TD
  5906. ALIGN="LEFT"
  5907. VALIGN="MIDDLE"
  5908. >PHP <= 4.2.0</TD
  5909. ></TR
  5910. ><TR
  5911. ><TD
  5912. ALIGN="LEFT"
  5913. VALIGN="MIDDLE"
  5914. >php_fdf.dll</TD
  5915. ><TD
  5916. ALIGN="LEFT"
  5917. VALIGN="MIDDLE"
  5918. ><A
  5919. HREF="#ref.fdf"
  5920. >FDF</A
  5921. >: Forms Data Format functions.</TD
  5922. ><TD
  5923. ALIGN="LEFT"
  5924. VALIGN="MIDDLE"
  5925. >Requires: <TT
  5926. CLASS="filename"
  5927. >fdftk.dll</TT
  5928. > (bundled)</TD
  5929. ></TR
  5930. ><TR
  5931. ><TD
  5932. ALIGN="LEFT"
  5933. VALIGN="MIDDLE"
  5934. >php_filepro.dll</TD
  5935. ><TD
  5936. ALIGN="LEFT"
  5937. VALIGN="MIDDLE"
  5938. ><A
  5939. HREF="#ref.filepro"
  5940. >filePro</A
  5941. > functions</TD
  5942. ><TD
  5943. ALIGN="LEFT"
  5944. VALIGN="MIDDLE"
  5945. >Read-only access</TD
  5946. ></TR
  5947. ><TR
  5948. ><TD
  5949. ALIGN="LEFT"
  5950. VALIGN="MIDDLE"
  5951. >php_ftp.dll</TD
  5952. ><TD
  5953. ALIGN="LEFT"
  5954. VALIGN="MIDDLE"
  5955. ><A
  5956. HREF="#ref.ftp"
  5957. >FTP</A
  5958. > functions</TD
  5959. ><TD
  5960. ALIGN="LEFT"
  5961. VALIGN="MIDDLE"
  5962. >Built-in since PHP 4.0.3</TD
  5963. ></TR
  5964. ><TR
  5965. ><TD
  5966. ALIGN="LEFT"
  5967. VALIGN="MIDDLE"
  5968. >php_gd.dll</TD
  5969. ><TD
  5970. ALIGN="LEFT"
  5971. VALIGN="MIDDLE"
  5972. ><A
  5973. HREF="#ref.image"
  5974. >GD</A
  5975. > library image functions</TD
  5976. ><TD
  5977. ALIGN="LEFT"
  5978. VALIGN="MIDDLE"
  5979. >     Removed in PHP 4.3.2.  Also note that truecolor functions are not
  5980.     available in GD1, instead, use <TT
  5981. CLASS="filename"
  5982. >php_gd2.dll</TT
  5983. >.
  5984.    </TD
  5985. ></TR
  5986. ><TR
  5987. ><TD
  5988. ALIGN="LEFT"
  5989. VALIGN="MIDDLE"
  5990. >php_gd2.dll</TD
  5991. ><TD
  5992. ALIGN="LEFT"
  5993. VALIGN="MIDDLE"
  5994. ><A
  5995. HREF="#ref.image"
  5996. >GD</A
  5997. > library image functions</TD
  5998. ><TD
  5999. ALIGN="LEFT"
  6000. VALIGN="MIDDLE"
  6001. >GD2</TD
  6002. ></TR
  6003. ><TR
  6004. ><TD
  6005. ALIGN="LEFT"
  6006. VALIGN="MIDDLE"
  6007. >php_gettext.dll</TD
  6008. ><TD
  6009. ALIGN="LEFT"
  6010. VALIGN="MIDDLE"
  6011. ><A
  6012. HREF="#ref.gettext"
  6013. >Gettext</A
  6014. > functions</TD
  6015. ><TD
  6016. ALIGN="LEFT"
  6017. VALIGN="MIDDLE"
  6018. >     PHP <= 4.2.0 requires <TT
  6019. CLASS="filename"
  6020. >gnu_gettext.dll</TT
  6021. > (bundled), 
  6022.     PHP >= 4.2.3 requires <TT
  6023. CLASS="filename"
  6024. >libintl-1.dll</TT
  6025. >,
  6026.     <TT
  6027. CLASS="filename"
  6028. >iconv.dll</TT
  6029. > (bundled).
  6030.    </TD
  6031. ></TR
  6032. ><TR
  6033. ><TD
  6034. ALIGN="LEFT"
  6035. VALIGN="MIDDLE"
  6036. >php_hyperwave.dll</TD
  6037. ><TD
  6038. ALIGN="LEFT"
  6039. VALIGN="MIDDLE"
  6040. ><A
  6041. HREF="#ref.hyperwave"
  6042. >HyperWave</A
  6043. > functions</TD
  6044. ><TD
  6045. ALIGN="LEFT"
  6046. VALIGN="MIDDLE"
  6047. >None</TD
  6048. ></TR
  6049. ><TR
  6050. ><TD
  6051. ALIGN="LEFT"
  6052. VALIGN="MIDDLE"
  6053. >php_iconv.dll</TD
  6054. ><TD
  6055. ALIGN="LEFT"
  6056. VALIGN="MIDDLE"
  6057. ><A
  6058. HREF="#ref.iconv"
  6059. >ICONV</A
  6060. > characterset conversion</TD
  6061. ><TD
  6062. ALIGN="LEFT"
  6063. VALIGN="MIDDLE"
  6064. >Requires: <TT
  6065. CLASS="filename"
  6066. >iconv-1.3.dll</TT
  6067. > (bundled), 
  6068.    PHP >=4.2.1 <TT
  6069. CLASS="filename"
  6070. >iconv.dll</TT
  6071. ></TD
  6072. ></TR
  6073. ><TR
  6074. ><TD
  6075. ALIGN="LEFT"
  6076. VALIGN="MIDDLE"
  6077. >php_ifx.dll</TD
  6078. ><TD
  6079. ALIGN="LEFT"
  6080. VALIGN="MIDDLE"
  6081. ><A
  6082. HREF="#ref.ifx"
  6083. >Informix</A
  6084. > functions</TD
  6085. ><TD
  6086. ALIGN="LEFT"
  6087. VALIGN="MIDDLE"
  6088. >Requires: Informix libraries</TD
  6089. ></TR
  6090. ><TR
  6091. ><TD
  6092. ALIGN="LEFT"
  6093. VALIGN="MIDDLE"
  6094. >php_iisfunc.dll</TD
  6095. ><TD
  6096. ALIGN="LEFT"
  6097. VALIGN="MIDDLE"
  6098. >IIS management functions</TD
  6099. ><TD
  6100. ALIGN="LEFT"
  6101. VALIGN="MIDDLE"
  6102. >None</TD
  6103. ></TR
  6104. ><TR
  6105. ><TD
  6106. ALIGN="LEFT"
  6107. VALIGN="MIDDLE"
  6108. >php_imap.dll</TD
  6109. ><TD
  6110. ALIGN="LEFT"
  6111. VALIGN="MIDDLE"
  6112. ><A
  6113. HREF="#ref.imap"
  6114. >IMAP</A
  6115. > POP3 and NNTP functions</TD
  6116. ><TD
  6117. ALIGN="LEFT"
  6118. VALIGN="MIDDLE"
  6119. >PHP 3: <TT
  6120. CLASS="filename"
  6121. >php3_imap4r1.dll</TT
  6122. ></TD
  6123. ></TR
  6124. ><TR
  6125. ><TD
  6126. ALIGN="LEFT"
  6127. VALIGN="MIDDLE"
  6128. >php_ingres.dll</TD
  6129. ><TD
  6130. ALIGN="LEFT"
  6131. VALIGN="MIDDLE"
  6132. ><A
  6133. HREF="#ref.ingres"
  6134. >Ingres II</A
  6135. > functions</TD
  6136. ><TD
  6137. ALIGN="LEFT"
  6138. VALIGN="MIDDLE"
  6139. >Requires: Ingres II libraries</TD
  6140. ></TR
  6141. ><TR
  6142. ><TD
  6143. ALIGN="LEFT"
  6144. VALIGN="MIDDLE"
  6145. >php_interbase.dll</TD
  6146. ><TD
  6147. ALIGN="LEFT"
  6148. VALIGN="MIDDLE"
  6149. ><A
  6150. HREF="#ref.ibase"
  6151. >InterBase</A
  6152. > functions</TD
  6153. ><TD
  6154. ALIGN="LEFT"
  6155. VALIGN="MIDDLE"
  6156. >Requires: <TT
  6157. CLASS="filename"
  6158. >gds32.dll</TT
  6159. > (bundled)</TD
  6160. ></TR
  6161. ><TR
  6162. ><TD
  6163. ALIGN="LEFT"
  6164. VALIGN="MIDDLE"
  6165. >php_java.dll</TD
  6166. ><TD
  6167. ALIGN="LEFT"
  6168. VALIGN="MIDDLE"
  6169. ><A
  6170. HREF="#ref.java"
  6171. >Java</A
  6172. > functions</TD
  6173. ><TD
  6174. ALIGN="LEFT"
  6175. VALIGN="MIDDLE"
  6176. >PHP <= 4.0.6 requires: <TT
  6177. CLASS="filename"
  6178. >jvm.dll</TT
  6179. > (bundled)</TD
  6180. ></TR
  6181. ><TR
  6182. ><TD
  6183. ALIGN="LEFT"
  6184. VALIGN="MIDDLE"
  6185. >php_ldap.dll</TD
  6186. ><TD
  6187. ALIGN="LEFT"
  6188. VALIGN="MIDDLE"
  6189. ><A
  6190. HREF="#ref.ldap"
  6191. >LDAP</A
  6192. > functions</TD
  6193. ><TD
  6194. ALIGN="LEFT"
  6195. VALIGN="MIDDLE"
  6196. >     PHP <= 4.2.0 requires <TT
  6197. CLASS="filename"
  6198. >libsasl.dll</TT
  6199. > (bundled), 
  6200.     PHP >= 4.3.0 requires <TT
  6201. CLASS="filename"
  6202. >libeay32.dll</TT
  6203. >, 
  6204.     <TT
  6205. CLASS="filename"
  6206. >ssleay32.dll</TT
  6207. > (bundled)
  6208.    </TD
  6209. ></TR
  6210. ><TR
  6211. ><TD
  6212. ALIGN="LEFT"
  6213. VALIGN="MIDDLE"
  6214. >php_mbstring.dll</TD
  6215. ><TD
  6216. ALIGN="LEFT"
  6217. VALIGN="MIDDLE"
  6218. ><A
  6219. HREF="#ref.mbstring"
  6220. >Multi-Byte String</A
  6221. > functions</TD
  6222. ><TD
  6223. ALIGN="LEFT"
  6224. VALIGN="MIDDLE"
  6225. >None</TD
  6226. ></TR
  6227. ><TR
  6228. ><TD
  6229. ALIGN="LEFT"
  6230. VALIGN="MIDDLE"
  6231. >php_mcrypt.dll</TD
  6232. ><TD
  6233. ALIGN="LEFT"
  6234. VALIGN="MIDDLE"
  6235. ><A
  6236. HREF="#ref.mcrypt"
  6237. >Mcrypt Encryption</A
  6238. > functions</TD
  6239. ><TD
  6240. ALIGN="LEFT"
  6241. VALIGN="MIDDLE"
  6242. >Requires: <TT
  6243. CLASS="filename"
  6244. >libmcrypt.dll</TT
  6245. ></TD
  6246. ></TR
  6247. ><TR
  6248. ><TD
  6249. ALIGN="LEFT"
  6250. VALIGN="MIDDLE"
  6251. >php_mhash.dll</TD
  6252. ><TD
  6253. ALIGN="LEFT"
  6254. VALIGN="MIDDLE"
  6255. ><A
  6256. HREF="#ref.mhash"
  6257. >Mhash</A
  6258. > functions</TD
  6259. ><TD
  6260. ALIGN="LEFT"
  6261. VALIGN="MIDDLE"
  6262. >PHP >= 4.3.0 requires: <TT
  6263. CLASS="filename"
  6264. >libmhash.dll</TT
  6265. > (bundled)</TD
  6266. ></TR
  6267. ><TR
  6268. ><TD
  6269. ALIGN="LEFT"
  6270. VALIGN="MIDDLE"
  6271. >php_mime_magic.dll</TD
  6272. ><TD
  6273. ALIGN="LEFT"
  6274. VALIGN="MIDDLE"
  6275. ><A
  6276. HREF="#ref.mime-magic"
  6277. >Mimetype</A
  6278. > functions</TD
  6279. ><TD
  6280. ALIGN="LEFT"
  6281. VALIGN="MIDDLE"
  6282. >Requires: <TT
  6283. CLASS="filename"
  6284. >magic.mime</TT
  6285. > (bundled)</TD
  6286. ></TR
  6287. ><TR
  6288. ><TD
  6289. ALIGN="LEFT"
  6290. VALIGN="MIDDLE"
  6291. >php_ming.dll</TD
  6292. ><TD
  6293. ALIGN="LEFT"
  6294. VALIGN="MIDDLE"
  6295. ><A
  6296. HREF="#ref.ming"
  6297. >Ming</A
  6298. > functions for Flash</TD
  6299. ><TD
  6300. ALIGN="LEFT"
  6301. VALIGN="MIDDLE"
  6302. >None</TD
  6303. ></TR
  6304. ><TR
  6305. ><TD
  6306. ALIGN="LEFT"
  6307. VALIGN="MIDDLE"
  6308. >php_msql.dll</TD
  6309. ><TD
  6310. ALIGN="LEFT"
  6311. VALIGN="MIDDLE"
  6312. ><A
  6313. HREF="#ref.msql"
  6314. >mSQL</A
  6315. > functions</TD
  6316. ><TD
  6317. ALIGN="LEFT"
  6318. VALIGN="MIDDLE"
  6319. >Requires: <TT
  6320. CLASS="filename"
  6321. >msql.dll</TT
  6322. > (bundled)</TD
  6323. ></TR
  6324. ><TR
  6325. ><TD
  6326. ALIGN="LEFT"
  6327. VALIGN="MIDDLE"
  6328. >php3_msql1.dll</TD
  6329. ><TD
  6330. ALIGN="LEFT"
  6331. VALIGN="MIDDLE"
  6332. >mSQL 1 client</TD
  6333. ><TD
  6334. ALIGN="LEFT"
  6335. VALIGN="MIDDLE"
  6336. >unknown</TD
  6337. ></TR
  6338. ><TR
  6339. ><TD
  6340. ALIGN="LEFT"
  6341. VALIGN="MIDDLE"
  6342. >php3_msql2.dll</TD
  6343. ><TD
  6344. ALIGN="LEFT"
  6345. VALIGN="MIDDLE"
  6346. >mSQL 2 client</TD
  6347. ><TD
  6348. ALIGN="LEFT"
  6349. VALIGN="MIDDLE"
  6350. >unknown</TD
  6351. ></TR
  6352. ><TR
  6353. ><TD
  6354. ALIGN="LEFT"
  6355. VALIGN="MIDDLE"
  6356. >php_mssql.dll</TD
  6357. ><TD
  6358. ALIGN="LEFT"
  6359. VALIGN="MIDDLE"
  6360. ><A
  6361. HREF="#ref.mssql"
  6362. >MSSQL</A
  6363. > functions</TD
  6364. ><TD
  6365. ALIGN="LEFT"
  6366. VALIGN="MIDDLE"
  6367. >Requires: <TT
  6368. CLASS="filename"
  6369. >ntwdblib.dll</TT
  6370. > (bundled)</TD
  6371. ></TR
  6372. ><TR
  6373. ><TD
  6374. ALIGN="LEFT"
  6375. VALIGN="MIDDLE"
  6376. >php3_mysql.dll</TD
  6377. ><TD
  6378. ALIGN="LEFT"
  6379. VALIGN="MIDDLE"
  6380. ><A
  6381. HREF="#ref.mysql"
  6382. >MySQL</A
  6383. > functions</TD
  6384. ><TD
  6385. ALIGN="LEFT"
  6386. VALIGN="MIDDLE"
  6387. >Built-in in PHP 4</TD
  6388. ></TR
  6389. ><TR
  6390. ><TD
  6391. ALIGN="LEFT"
  6392. VALIGN="MIDDLE"
  6393. >php3_nsmail.dll</TD
  6394. ><TD
  6395. ALIGN="LEFT"
  6396. VALIGN="MIDDLE"
  6397. >Netscape mail functions</TD
  6398. ><TD
  6399. ALIGN="LEFT"
  6400. VALIGN="MIDDLE"
  6401. >unknown</TD
  6402. ></TR
  6403. ><TR
  6404. ><TD
  6405. ALIGN="LEFT"
  6406. VALIGN="MIDDLE"
  6407. >php3_oci73.dll</TD
  6408. ><TD
  6409. ALIGN="LEFT"
  6410. VALIGN="MIDDLE"
  6411. >Oracle functions</TD
  6412. ><TD
  6413. ALIGN="LEFT"
  6414. VALIGN="MIDDLE"
  6415. >unknown</TD
  6416. ></TR
  6417. ><TR
  6418. ><TD
  6419. ALIGN="LEFT"
  6420. VALIGN="MIDDLE"
  6421. >php_oci8.dll</TD
  6422. ><TD
  6423. ALIGN="LEFT"
  6424. VALIGN="MIDDLE"
  6425. ><A
  6426. HREF="#ref.oci8"
  6427. >Oracle 8</A
  6428. > functions</TD
  6429. ><TD
  6430. ALIGN="LEFT"
  6431. VALIGN="MIDDLE"
  6432. >Requires: Oracle 8.1+ client libraries</TD
  6433. ></TR
  6434. ><TR
  6435. ><TD
  6436. ALIGN="LEFT"
  6437. VALIGN="MIDDLE"
  6438. >php_openssl.dll</TD
  6439. ><TD
  6440. ALIGN="LEFT"
  6441. VALIGN="MIDDLE"
  6442. ><A
  6443. HREF="#ref.openssl"
  6444. >OpenSSL</A
  6445. > functions</TD
  6446. ><TD
  6447. ALIGN="LEFT"
  6448. VALIGN="MIDDLE"
  6449. >Requires: <TT
  6450. CLASS="filename"
  6451. >libeay32.dll</TT
  6452. > (bundled)</TD
  6453. ></TR
  6454. ><TR
  6455. ><TD
  6456. ALIGN="LEFT"
  6457. VALIGN="MIDDLE"
  6458. >php_oracle.dll</TD
  6459. ><TD
  6460. ALIGN="LEFT"
  6461. VALIGN="MIDDLE"
  6462. ><A
  6463. HREF="#ref.oracle"
  6464. >Oracle</A
  6465. > functions</TD
  6466. ><TD
  6467. ALIGN="LEFT"
  6468. VALIGN="MIDDLE"
  6469. >Requires: Oracle 7 client libraries</TD
  6470. ></TR
  6471. ><TR
  6472. ><TD
  6473. ALIGN="LEFT"
  6474. VALIGN="MIDDLE"
  6475. >php_overload.dll</TD
  6476. ><TD
  6477. ALIGN="LEFT"
  6478. VALIGN="MIDDLE"
  6479. ><A
  6480. HREF="#ref.overload"
  6481. >Object overloading</A
  6482. > functions</TD
  6483. ><TD
  6484. ALIGN="LEFT"
  6485. VALIGN="MIDDLE"
  6486. >Built in since PHP 4.3.0</TD
  6487. ></TR
  6488. ><TR
  6489. ><TD
  6490. ALIGN="LEFT"
  6491. VALIGN="MIDDLE"
  6492. >php_pdf.dll</TD
  6493. ><TD
  6494. ALIGN="LEFT"
  6495. VALIGN="MIDDLE"
  6496. ><A
  6497. HREF="#ref.pdf"
  6498. >PDF</A
  6499. > functions</TD
  6500. ><TD
  6501. ALIGN="LEFT"
  6502. VALIGN="MIDDLE"
  6503. >None</TD
  6504. ></TR
  6505. ><TR
  6506. ><TD
  6507. ALIGN="LEFT"
  6508. VALIGN="MIDDLE"
  6509. >php_pgsql.dll</TD
  6510. ><TD
  6511. ALIGN="LEFT"
  6512. VALIGN="MIDDLE"
  6513. ><A
  6514. HREF="#ref.pgsql"
  6515. >PostgreSQL</A
  6516. > functions</TD
  6517. ><TD
  6518. ALIGN="LEFT"
  6519. VALIGN="MIDDLE"
  6520. >None</TD
  6521. ></TR
  6522. ><TR
  6523. ><TD
  6524. ALIGN="LEFT"
  6525. VALIGN="MIDDLE"
  6526. >php_printer.dll</TD
  6527. ><TD
  6528. ALIGN="LEFT"
  6529. VALIGN="MIDDLE"
  6530. ><A
  6531. HREF="#ref.printer"
  6532. >Printer</A
  6533. > functions</TD
  6534. ><TD
  6535. ALIGN="LEFT"
  6536. VALIGN="MIDDLE"
  6537. >None</TD
  6538. ></TR
  6539. ><TR
  6540. ><TD
  6541. ALIGN="LEFT"
  6542. VALIGN="MIDDLE"
  6543. >php_shmop.dll</TD
  6544. ><TD
  6545. ALIGN="LEFT"
  6546. VALIGN="MIDDLE"
  6547. ><A
  6548. HREF="#ref.shmop"
  6549. >Shared Memory</A
  6550. > functions</TD
  6551. ><TD
  6552. ALIGN="LEFT"
  6553. VALIGN="MIDDLE"
  6554. >None</TD
  6555. ></TR
  6556. ><TR
  6557. ><TD
  6558. ALIGN="LEFT"
  6559. VALIGN="MIDDLE"
  6560. >php_snmp.dll</TD
  6561. ><TD
  6562. ALIGN="LEFT"
  6563. VALIGN="MIDDLE"
  6564. ><A
  6565. HREF="#ref.snmp"
  6566. >SNMP</A
  6567. > get and walk functions</TD
  6568. ><TD
  6569. ALIGN="LEFT"
  6570. VALIGN="MIDDLE"
  6571. >NT only!</TD
  6572. ></TR
  6573. ><TR
  6574. ><TD
  6575. ALIGN="LEFT"
  6576. VALIGN="MIDDLE"
  6577. >php_sockets.dll</TD
  6578. ><TD
  6579. ALIGN="LEFT"
  6580. VALIGN="MIDDLE"
  6581. ><A
  6582. HREF="#ref.sockets"
  6583. >Socket</A
  6584. > functions</TD
  6585. ><TD
  6586. ALIGN="LEFT"
  6587. VALIGN="MIDDLE"
  6588. >None</TD
  6589. ></TR
  6590. ><TR
  6591. ><TD
  6592. ALIGN="LEFT"
  6593. VALIGN="MIDDLE"
  6594. >php_sybase_ct.dll</TD
  6595. ><TD
  6596. ALIGN="LEFT"
  6597. VALIGN="MIDDLE"
  6598. ><A
  6599. HREF="#ref.sybase"
  6600. >Sybase</A
  6601. > functions</TD
  6602. ><TD
  6603. ALIGN="LEFT"
  6604. VALIGN="MIDDLE"
  6605. >Requires: Sybase client libraries</TD
  6606. ></TR
  6607. ><TR
  6608. ><TD
  6609. ALIGN="LEFT"
  6610. VALIGN="MIDDLE"
  6611. >php_tokenizer.dll</TD
  6612. ><TD
  6613. ALIGN="LEFT"
  6614. VALIGN="MIDDLE"
  6615. ><A
  6616. HREF="#ref.tokenizer"
  6617. >Tokenizer</A
  6618. > functions</TD
  6619. ><TD
  6620. ALIGN="LEFT"
  6621. VALIGN="MIDDLE"
  6622. >Built in since PHP 4.3.0</TD
  6623. ></TR
  6624. ><TR
  6625. ><TD
  6626. ALIGN="LEFT"
  6627. VALIGN="MIDDLE"
  6628. >php_w32api.dll</TD
  6629. ><TD
  6630. ALIGN="LEFT"
  6631. VALIGN="MIDDLE"
  6632. ><A
  6633. HREF="#ref.w32api"
  6634. >W32api</A
  6635. > functions</TD
  6636. ><TD
  6637. ALIGN="LEFT"
  6638. VALIGN="MIDDLE"
  6639. >None</TD
  6640. ></TR
  6641. ><TR
  6642. ><TD
  6643. ALIGN="LEFT"
  6644. VALIGN="MIDDLE"
  6645. >php_xmlrpc.dll</TD
  6646. ><TD
  6647. ALIGN="LEFT"
  6648. VALIGN="MIDDLE"
  6649. ><A
  6650. HREF="#ref.xmlrpc"
  6651. >XML-RPC</A
  6652. > functions</TD
  6653. ><TD
  6654. ALIGN="LEFT"
  6655. VALIGN="MIDDLE"
  6656. >PHP >= 4.2.1 requires: <TT
  6657. CLASS="filename"
  6658. >iconv.dll</TT
  6659. > (bundled)</TD
  6660. ></TR
  6661. ><TR
  6662. ><TD
  6663. ALIGN="LEFT"
  6664. VALIGN="MIDDLE"
  6665. >php_xslt.dll</TD
  6666. ><TD
  6667. ALIGN="LEFT"
  6668. VALIGN="MIDDLE"
  6669. ><A
  6670. HREF="#ref.xslt"
  6671. >XSLT</A
  6672. > functions</TD
  6673. ><TD
  6674. ALIGN="LEFT"
  6675. VALIGN="MIDDLE"
  6676. >     PHP <= 4.2.0 requires <TT
  6677. CLASS="filename"
  6678. >sablot.dll</TT
  6679. >,
  6680.     <TT
  6681. CLASS="filename"
  6682. >expat.dll</TT
  6683. > (bundled). PHP >= 4.2.1 requires
  6684.     <TT
  6685. CLASS="filename"
  6686. >sablot.dll</TT
  6687. >, <TT
  6688. CLASS="filename"
  6689. >expat.dll</TT
  6690. >,
  6691.     <TT
  6692. CLASS="filename"
  6693. >iconv.dll</TT
  6694. > (bundled).
  6695.    </TD
  6696. ></TR
  6697. ><TR
  6698. ><TD
  6699. ALIGN="LEFT"
  6700. VALIGN="MIDDLE"
  6701. >php_yaz.dll</TD
  6702. ><TD
  6703. ALIGN="LEFT"
  6704. VALIGN="MIDDLE"
  6705. ><A
  6706. HREF="#ref.yaz"
  6707. >YAZ</A
  6708. > functions</TD
  6709. ><TD
  6710. ALIGN="LEFT"
  6711. VALIGN="MIDDLE"
  6712. >Requires: <TT
  6713. CLASS="filename"
  6714. >yaz.dll</TT
  6715. > (bundled)</TD
  6716. ></TR
  6717. ><TR
  6718. ><TD
  6719. ALIGN="LEFT"
  6720. VALIGN="MIDDLE"
  6721. >php_zib.dll</TD
  6722. ><TD
  6723. ALIGN="LEFT"
  6724. VALIGN="MIDDLE"
  6725. ><A
  6726. HREF="#ref.zip"
  6727. >Zip File</A
  6728. > functions</TD
  6729. ><TD
  6730. ALIGN="LEFT"
  6731. VALIGN="MIDDLE"
  6732. >Read only access</TD
  6733. ></TR
  6734. ><TR
  6735. ><TD
  6736. ALIGN="LEFT"
  6737. VALIGN="MIDDLE"
  6738. >php_zlib.dll</TD
  6739. ><TD
  6740. ALIGN="LEFT"
  6741. VALIGN="MIDDLE"
  6742. ><A
  6743. HREF="#ref.zlib"
  6744. >ZLib</A
  6745. > compression functions</TD
  6746. ><TD
  6747. ALIGN="LEFT"
  6748. VALIGN="MIDDLE"
  6749. >Built in since PHP 4.3.0</TD
  6750. ></TR
  6751. ></TBODY
  6752. ></TABLE
  6753. ></DIV
  6754. >
  6755.     </P
  6756. ></DIV
  6757. ></DIV
  6758. ><DIV
  6759. CLASS="sect1"
  6760. ><HR><H2
  6761. CLASS="sect1"
  6762. ><A
  6763. NAME="install.commandline"
  6764. ></A
  6765. >Servers-CGI/Commandline</H2
  6766. ><P
  6767. >     The default is to build PHP as a CGI program.  This creates a
  6768.     commandline interpreter, which can be used for CGI processing, or
  6769.     for non-web-related PHP scripting.  If you are running a web
  6770.     server PHP has module support for, you should generally go for
  6771.     that solution for performance reasons.  However, the CGI version
  6772.     enables Apache users to run different PHP-enabled pages under
  6773.     different user-ids.  Please make sure you read through the <A
  6774. HREF="#security.index"
  6775. >Security chapter</A
  6776. > if you are going to
  6777.     run PHP as a CGI.
  6778.    </P
  6779. ><P
  6780. >     As of PHP 4.3.0, some important additions have happened to PHP.  A new
  6781.     SAPI named CLI also exists and it has the same name as the CGI binary.
  6782.     What is installed at <TT
  6783. CLASS="literal"
  6784. >{PREFIX}/bin/php</TT
  6785. > depends on your
  6786.     configure line and this is described in detail in the manual section
  6787.     named <A
  6788. HREF="#features.commandline"
  6789. >Using PHP from the command
  6790.     line</A
  6791. >. For further details please read that section of the manual.
  6792.    </P
  6793. ><DIV
  6794. CLASS="sect2"
  6795. ><HR><H3
  6796. CLASS="sect2"
  6797. ><A
  6798. NAME="install.commandline.testing"
  6799. ></A
  6800. >Testing</H3
  6801. ><P
  6802. >      If you have built PHP as a CGI program, you may test your build
  6803.      by typing <B
  6804. CLASS="command"
  6805. >make test</B
  6806. >.  It is always a good idea
  6807.      to test your build.  This way you may catch a problem with PHP on
  6808.      your platform early instead of having to struggle with it later.
  6809.     </P
  6810. ></DIV
  6811. ><DIV
  6812. CLASS="sect2"
  6813. ><HR><H3
  6814. CLASS="sect2"
  6815. ><A
  6816. NAME="install.commandline.benchmarking"
  6817. ></A
  6818. >Benchmarking</H3
  6819. ><P
  6820. >      If you have built PHP 3 as a CGI program, you may benchmark your
  6821.      build by typing <B
  6822. CLASS="command"
  6823. >make bench</B
  6824. >. Note that if 
  6825.      <A
  6826. HREF="#ini.safe-mode"
  6827. >bezpeΦn² re╛im</A
  6828. > is on by default, the benchmark may not be able to finish if
  6829.      it takes longer then the 30 seconds allowed. This is because the
  6830.      <A
  6831. HREF="#function.set-time-limit"
  6832. ><B
  6833. CLASS="function"
  6834. >set_time_limit()</B
  6835. ></A
  6836. > can not be used in 
  6837.      <A
  6838. HREF="#ini.safe-mode"
  6839. >bezpeΦn² re╛im</A
  6840. >. Use the <A
  6841. HREF="#ini.max-execution-time"
  6842. >max_execution_time</A
  6843. >
  6844.      configuration setting to control this time for your own
  6845.      scripts. <B
  6846. CLASS="command"
  6847. >make bench</B
  6848. > ignores the <A
  6849. HREF="#configuration.file"
  6850. >configuration file</A
  6851. >.
  6852.     </P
  6853. ><DIV
  6854. CLASS="note"
  6855. ><BLOCKQUOTE
  6856. CLASS="note"
  6857. ><P
  6858. ><B
  6859. >Poznßmka: </B
  6860. >
  6861.         <B
  6862. CLASS="command"
  6863. >make bench</B
  6864. > is only available for PHP 3.
  6865.      </P
  6866. ></BLOCKQUOTE
  6867. ></DIV
  6868. ></DIV
  6869. ><DIV
  6870. CLASS="sect2"
  6871. ><HR><H3
  6872. CLASS="sect2"
  6873. ><A
  6874. NAME="install.commandline.using-variables"
  6875. ></A
  6876. >Using Variables</H3
  6877. ><P
  6878. >       Some server supplied environment variables are not defined in the
  6879.       current <A
  6880. HREF="http://hoohoo.ncsa.uiuc.edu/cgi/env.html"
  6881. TARGET="_top"
  6882. >CGI/1.1 specification</A
  6883. >.
  6884.       Only the following variables are defined there; everything else 
  6885.       should be treated as 'vendor extensions': AUTH_TYPE, CONTENT_LENGTH, CONTENT_TYPE,
  6886.       GATEWAY_INTERFACE, PATH_INFO, PATH_TRANSLATED, QUERY_STRING,
  6887.       REMOTE_ADDR, REMOTE_HOST, REMOTE_IDENT, REMOTE_USER,
  6888.       REQUEST_METHOD, SCRIPT_NAME, SERVER_NAME, SERVER_PORT,
  6889.       SERVER_PROTOCOL and SERVER_SOFTWARE
  6890.     </P
  6891. ></DIV
  6892. ></DIV
  6893. ><DIV
  6894. CLASS="sect1"
  6895. ><HR><H2
  6896. CLASS="sect1"
  6897. ><A
  6898. NAME="install.apache"
  6899. ></A
  6900. >Servers-Apache</H2
  6901. ><P
  6902. >     This section contains notes and hints specific to Apache installs
  6903.     of PHP, both for <A
  6904. HREF="#install.apache.unix"
  6905. >Unix</A
  6906. > and
  6907.     <A
  6908. HREF="#install.apache.windows"
  6909. >Windows</A
  6910. > versions. We also
  6911.     have <A
  6912. HREF="#install.apache2"
  6913. >instructions and notes for Apache 2
  6914.     on a separate page</A
  6915. >.
  6916.    </P
  6917. ><DIV
  6918. CLASS="sect2"
  6919. ><HR><H3
  6920. CLASS="sect2"
  6921. ><A
  6922. NAME="install.apache.unix"
  6923. ></A
  6924. >Details of installing PHP with Apache on Unix</H3
  6925. ><P
  6926. >      You can select arguments to add to the
  6927.      <B
  6928. CLASS="command"
  6929. >configure</B
  6930. > on line 10 below from the <A
  6931. HREF="#install.configure"
  6932. >Complete list of configure
  6933.      options</A
  6934. >. The version numbers have been omitted here, to
  6935.      ensure the instructions are not incorrect. You will need to replace
  6936.      the 'xxx' here with the correct values from your files.
  6937.     </P
  6938. ><TABLE
  6939. WIDTH="100%"
  6940. BORDER="0"
  6941. CELLPADDING="0"
  6942. CELLSPACING="0"
  6943. CLASS="EXAMPLE"
  6944. ><TR
  6945. ><TD
  6946. ><DIV
  6947. CLASS="example"
  6948. ><A
  6949. NAME="install.apache.unix.longer"
  6950. ></A
  6951. ><P
  6952. ><B
  6953. >P°φklad 3-4. 
  6954.       Installation Instructions (Apache Shared Module Version) for PHP
  6955.      </B
  6956. ></P
  6957. ><TABLE
  6958. BORDER="0"
  6959. BGCOLOR="#E0E0E0"
  6960. CELLPADDING="5"
  6961. ><TR
  6962. ><TD
  6963. ><PRE
  6964. CLASS="screen"
  6965. >1.  gunzip apache_xxx.tar.gz
  6966. 2.  tar -xvf apache_xxx.tar
  6967. 3.  gunzip php-xxx.tar.gz
  6968. 4.  tar -xvf php-xxx.tar
  6969. 5.  cd apache_xxx
  6970. 6.  ./configure --prefix=/www --enable-module=so
  6971. 7.  make
  6972. 8.  make install
  6973. 9.  cd ../php-xxx
  6974.  
  6975. 10. Now, configure your PHP.  This is where you customize your PHP
  6976.     with various options, like which extensions will be enabled.  Do a
  6977.     ./configure --help for a list of available options.  In our example
  6978.     we'll do a simple configure with Apache 1 and MySQL support.  Your
  6979.     path to apxs may differ from our example.
  6980.  
  6981.       ./configure --with-mysql --with-apxs=/www/bin/apxs
  6982.  
  6983. 11. make
  6984. 12. make install
  6985.  
  6986.     If you decide to change your configure options after installation,
  6987.     you only need to repeat the last three steps. You only need to 
  6988.     restart apache for the new module to take effect. A recompile of
  6989.     Apache is not needed.
  6990.   
  6991.     Note that unless told otherwise, 'make install' will also install PEAR,
  6992.     various PHP tools such as phpize, install the PHP CLI, and more.
  6993.  
  6994. 13. Setup your php.ini file:
  6995.  
  6996.       cp php.ini-dist /usr/local/lib/php.ini
  6997.  
  6998.     You may edit your .ini file to set PHP options.  If you prefer your
  6999.     php.ini in another location, use --with-config-file-path=/some/path in
  7000.     step 10. 
  7001.     
  7002.     If you instead choose php.ini-recommended, be certain to read the list
  7003.     of changes within, as they affect how PHP behaves.
  7004.  
  7005. 14. Edit your httpd.conf to load the PHP module.  The path on the right hand
  7006.     side of the LoadModule statement must point to the path of the PHP
  7007.     module on your system.  The make install from above may have already
  7008.     added this for you, but be sure to check.
  7009.         
  7010.     For PHP 4:
  7011.             
  7012.       LoadModule php4_module libexec/libphp4.so
  7013.  
  7014.     For PHP 5:
  7015.                       
  7016.       LoadModule php5_module libexec/libphp5.so
  7017.       
  7018. 15. And in the AddModule section of httpd.conf, somewhere under the
  7019.     ClearModuleList, add this:
  7020.     
  7021.     For PHP 4:
  7022.     
  7023.       AddModule mod_php4.c
  7024.       
  7025.     For PHP 5:
  7026.     
  7027.       AddModule mod_php5.c
  7028.  
  7029. 16. Tell Apache to parse certain extensions as PHP.  For example,
  7030.     let's have Apache parse the .php extension as PHP.  You could
  7031.     have any extension(s) parse as PHP by simply adding more, with
  7032.     each separated by a space.  We'll add .phtml to demonstrate.
  7033.  
  7034.       AddType application/x-httpd-php .php .phtml
  7035.  
  7036.     It's also common to setup the .phps extension to show highlighted PHP
  7037.     source, this can be done with:
  7038.     
  7039.       AddType application/x-httpd-php-source .phps
  7040.  
  7041. 17. Use your normal procedure for starting the Apache server. (You must
  7042.     stop and restart the server, not just cause the server to reload by
  7043.     use a HUP or USR1 signal.)</PRE
  7044. ></TD
  7045. ></TR
  7046. ></TABLE
  7047. ></DIV
  7048. ></TD
  7049. ></TR
  7050. ></TABLE
  7051. ><P
  7052. >       Depending on your Apache install and Unix variant, there are many
  7053.       possible ways to stop and restart the server. Below are some typical
  7054.       lines used in restarting the server, for different apache/unix
  7055.       installations. You should replace <TT
  7056. CLASS="literal"
  7057. >/path/to/</TT
  7058. > with
  7059.       the path to these applications on your systems.
  7060.      </P
  7061. ><P
  7062. >       <TABLE
  7063. WIDTH="100%"
  7064. BORDER="0"
  7065. CELLPADDING="0"
  7066. CELLSPACING="0"
  7067. CLASS="EXAMPLE"
  7068. ><TR
  7069. ><TD
  7070. ><DIV
  7071. CLASS="example"
  7072. ><A
  7073. NAME="AEN1336"
  7074. ></A
  7075. ><P
  7076. ><B
  7077. >P°φklad 3-5. Example commands for restarting Apache</B
  7078. ></P
  7079. ><TABLE
  7080. BORDER="0"
  7081. BGCOLOR="#E0E0E0"
  7082. CELLPADDING="5"
  7083. ><TR
  7084. ><TD
  7085. ><PRE
  7086. CLASS="shell"
  7087. >1. Several Linux and SysV variants:
  7088. /etc/rc.d/init.d/httpd restart
  7089.  
  7090. 2. Using apachectl scripts:
  7091. /path/to/apachectl stop
  7092. /path/to/apachectl start
  7093.  
  7094. 3. httpdctl and httpsdctl (Using OpenSSL), similar to apachectl:
  7095. /path/to/httpsdctl stop
  7096. /path/to/httpsdctl start
  7097.  
  7098. 4. Using mod_ssl, or another SSL server, you may want to manually
  7099. stop and start:
  7100. /path/to/apachectl stop
  7101. /path/to/apachectl startssl</PRE
  7102. ></TD
  7103. ></TR
  7104. ></TABLE
  7105. ></DIV
  7106. ></TD
  7107. ></TR
  7108. ></TABLE
  7109. >
  7110.      </P
  7111. ><P
  7112. >       The locations of the apachectl and http(s)dctl binaries often
  7113.       vary. If your system has <TT
  7114. CLASS="literal"
  7115. >locate</TT
  7116. > or
  7117.       <TT
  7118. CLASS="literal"
  7119. >whereis</TT
  7120. > or <TT
  7121. CLASS="literal"
  7122. >which</TT
  7123. > commands,
  7124.       these can assist you in finding your server control programs.
  7125.      </P
  7126. ><P
  7127. >       Different examples of compiling PHP for apache are as follows:
  7128.       <DIV
  7129. CLASS="informalexample"
  7130. ><A
  7131. NAME="AEN1344"
  7132. ></A
  7133. ><P
  7134. ></P
  7135. ><TABLE
  7136. BORDER="0"
  7137. BGCOLOR="#E0E0E0"
  7138. CELLPADDING="5"
  7139. ><TR
  7140. ><TD
  7141. ><PRE
  7142. CLASS="shell"
  7143. >./configure --with-apxs --with-pgsql</PRE
  7144. ></TD
  7145. ></TR
  7146. ></TABLE
  7147. ><P
  7148. ></P
  7149. ></DIV
  7150. >
  7151.      </P
  7152. ><P
  7153. >       This will create a <TT
  7154. CLASS="filename"
  7155. >libphp4.so</TT
  7156. > shared
  7157.       library that is loaded into Apache using a LoadModule line in
  7158.       Apache's <TT
  7159. CLASS="filename"
  7160. >httpd.conf</TT
  7161. > file. The PostgreSQL
  7162.       support is embedded into this <TT
  7163. CLASS="filename"
  7164. >libphp4.so</TT
  7165. >
  7166.       library.
  7167.      </P
  7168. ><P
  7169. >       <DIV
  7170. CLASS="informalexample"
  7171. ><A
  7172. NAME="AEN1351"
  7173. ></A
  7174. ><P
  7175. ></P
  7176. ><TABLE
  7177. BORDER="0"
  7178. BGCOLOR="#E0E0E0"
  7179. CELLPADDING="5"
  7180. ><TR
  7181. ><TD
  7182. ><PRE
  7183. CLASS="programlisting"
  7184. >./configure --with-apxs --with-pgsql=shared</PRE
  7185. ></TD
  7186. ></TR
  7187. ></TABLE
  7188. ><P
  7189. ></P
  7190. ></DIV
  7191. >
  7192.      </P
  7193. ><P
  7194. >       This will create a <TT
  7195. CLASS="filename"
  7196. >libphp4.so</TT
  7197. > shared
  7198.       library for Apache, but it will also create a
  7199.       <TT
  7200. CLASS="filename"
  7201. >pgsql.so</TT
  7202. > shared library that is loaded into
  7203.       PHP either by using the extension directive in
  7204.       <TT
  7205. CLASS="filename"
  7206. >php.ini</TT
  7207. > file or by loading it explicitly in
  7208.       a script using the <A
  7209. HREF="#function.dl"
  7210. ><B
  7211. CLASS="function"
  7212. >dl()</B
  7213. ></A
  7214. > function.
  7215.      </P
  7216. ><P
  7217. >       <DIV
  7218. CLASS="informalexample"
  7219. ><A
  7220. NAME="AEN1359"
  7221. ></A
  7222. ><P
  7223. ></P
  7224. ><TABLE
  7225. BORDER="0"
  7226. BGCOLOR="#E0E0E0"
  7227. CELLPADDING="5"
  7228. ><TR
  7229. ><TD
  7230. ><PRE
  7231. CLASS="programlisting"
  7232. >./configure --with-apache=/path/to/apache_source --with-pgsql</PRE
  7233. ></TD
  7234. ></TR
  7235. ></TABLE
  7236. ><P
  7237. ></P
  7238. ></DIV
  7239. >
  7240.      </P
  7241. ><P
  7242. >       This will create a <TT
  7243. CLASS="filename"
  7244. >libmodphp4.a</TT
  7245. > library, a
  7246.       <TT
  7247. CLASS="filename"
  7248. >mod_php4.c</TT
  7249. > and some accompanying files and
  7250.       copy this into the <TT
  7251. CLASS="literal"
  7252. >src/modules/php4</TT
  7253. > directory
  7254.       in the Apache source tree. Then you compile Apache using
  7255.       <TT
  7256. CLASS="literal"
  7257. >--activate-module=src/modules/php4/libphp4.a</TT
  7258. >
  7259.       and the Apache build system will create
  7260.       <TT
  7261. CLASS="filename"
  7262. >libphp4.a</TT
  7263. > and link it statically into the
  7264.       <TT
  7265. CLASS="filename"
  7266. >httpd</TT
  7267. > binary. The PostgreSQL support is
  7268.       included directly into this <TT
  7269. CLASS="filename"
  7270. >httpd</TT
  7271. > binary,
  7272.       so the final result here is a single <TT
  7273. CLASS="filename"
  7274. >httpd</TT
  7275. >
  7276.       binary that includes all of Apache and all of PHP.
  7277.      </P
  7278. ><P
  7279. >       <DIV
  7280. CLASS="informalexample"
  7281. ><A
  7282. NAME="AEN1371"
  7283. ></A
  7284. ><P
  7285. ></P
  7286. ><TABLE
  7287. BORDER="0"
  7288. BGCOLOR="#E0E0E0"
  7289. CELLPADDING="5"
  7290. ><TR
  7291. ><TD
  7292. ><PRE
  7293. CLASS="programlisting"
  7294. >./configure --with-apache=/path/to/apache_source --with-pgsql=shared</PRE
  7295. ></TD
  7296. ></TR
  7297. ></TABLE
  7298. ><P
  7299. ></P
  7300. ></DIV
  7301. >
  7302.      </P
  7303. ><P
  7304. >       Same as before, except instead of including PostgreSQL support
  7305.       directly into the final <TT
  7306. CLASS="filename"
  7307. >httpd</TT
  7308. > you will get
  7309.       a <TT
  7310. CLASS="filename"
  7311. >pgsql.so</TT
  7312. > shared library that you can load
  7313.       into PHP from either the <TT
  7314. CLASS="filename"
  7315. >php.ini</TT
  7316. > file or
  7317.       directly using <A
  7318. HREF="#function.dl"
  7319. ><B
  7320. CLASS="function"
  7321. >dl()</B
  7322. ></A
  7323. >.
  7324.      </P
  7325. ><P
  7326. >       When choosing to build PHP in different ways, you should consider
  7327.       the advantages and drawbacks of each method. Building as a shared
  7328.       object will mean that you can compile apache separately, and don't
  7329.       have to recompile everything as you add to, or change, PHP.
  7330.       Building PHP into apache (static method) means that PHP will
  7331.       load and run faster. For more information, see the Apache
  7332.       <A
  7333. HREF="http://httpd.apache.org/docs/dso.html"
  7334. TARGET="_top"
  7335. >webpage on DSO support</A
  7336. >.
  7337.      </P
  7338. ><DIV
  7339. CLASS="note"
  7340. ><BLOCKQUOTE
  7341. CLASS="note"
  7342. ><P
  7343. ><B
  7344. >Poznßmka: </B
  7345. >
  7346.       Apache's default <TT
  7347. CLASS="filename"
  7348. >httpd.conf</TT
  7349. > currently ships with a section that looks
  7350.       like this:
  7351.       <DIV
  7352. CLASS="informalexample"
  7353. ><A
  7354. NAME="AEN1383"
  7355. ></A
  7356. ><P
  7357. ></P
  7358. ><TABLE
  7359. BORDER="0"
  7360. BGCOLOR="#E0E0E0"
  7361. CELLPADDING="5"
  7362. ><TR
  7363. ><TD
  7364. ><PRE
  7365. CLASS="programlisting"
  7366. >User nobody
  7367. Group "#-1"</PRE
  7368. ></TD
  7369. ></TR
  7370. ></TABLE
  7371. ><P
  7372. ></P
  7373. ></DIV
  7374. >
  7375.       Unless you change that to "Group nogroup" or something like that ("Group daemon" is
  7376.       also very common) PHP will not be able to open files.
  7377.      </P
  7378. ></BLOCKQUOTE
  7379. ></DIV
  7380. ><DIV
  7381. CLASS="note"
  7382. ><BLOCKQUOTE
  7383. CLASS="note"
  7384. ><P
  7385. ><B
  7386. >Poznßmka: </B
  7387. >
  7388.      Make sure you specify the installed version of apxs when using
  7389.      <TT
  7390. CLASS="option"
  7391. >--with-apxs=/path/to/apxs</TT
  7392. >.
  7393.      You must NOT use the apxs version that is in the apache sources but the one
  7394.      that is actually installed on your system.
  7395.      </P
  7396. ></BLOCKQUOTE
  7397. ></DIV
  7398. ></DIV
  7399. ><DIV
  7400. CLASS="sect2"
  7401. ><HR><H3
  7402. CLASS="sect2"
  7403. ><A
  7404. NAME="install.apache.windows"
  7405. ></A
  7406. >Installing PHP on Windows with Apache 1.3.x</H3
  7407. ><P
  7408. >      There are two ways to set up PHP to work with Apache 1.3.x
  7409.      on Windows. One is to use the CGI binary (php.exe),
  7410.      the other is to use the Apache module DLL. In either case
  7411.      you need to stop the Apache server, and edit your
  7412.      <TT
  7413. CLASS="filename"
  7414. >httpd.conf</TT
  7415. > to configure Apache to work with PHP.
  7416.     </P
  7417. ><P
  7418. >      It is worth noting here that now the SAPI module has been 
  7419.      made more stable under Windows, we recommend it's use above
  7420.      the CGI binary, since it is more transparent and secure.
  7421.     </P
  7422. ><P
  7423. >      Although there can be a few variations of configuring PHP
  7424.      under Apache, these are simple enough to be used by the
  7425.      newcomer. Please consult the Apache Docs for further
  7426.      configuration directives.
  7427.     </P
  7428. ><P
  7429. >      If you unziped the PHP package to <TT
  7430. CLASS="filename"
  7431. >c:\php\</TT
  7432. > as described
  7433.      in the <A
  7434. HREF="#install.windows.manual"
  7435. >Manual
  7436.      Installation Steps</A
  7437. > section, you need to insert
  7438.      these lines to your Apache configuration file to set
  7439.      up the CGI binary:
  7440.      <P
  7441. ></P
  7442. ><UL
  7443. ><LI
  7444. ><P
  7445. >         <TT
  7446. CLASS="literal"
  7447. >          ScriptAlias /php/ "c:/php/"
  7448.         </TT
  7449. >
  7450.        </P
  7451. ></LI
  7452. ><LI
  7453. ><P
  7454. >         <TT
  7455. CLASS="literal"
  7456. >          AddType application/x-httpd-php .php .phtml
  7457.         </TT
  7458. >
  7459.        </P
  7460. ></LI
  7461. ><LI
  7462. ><P
  7463. >         <TT
  7464. CLASS="literal"
  7465. >          Action application/x-httpd-php "/php/php.exe"
  7466.         </TT
  7467. >
  7468.        </P
  7469. ></LI
  7470. ></UL
  7471. >
  7472.      Note that the second line in the list above can be found
  7473.      in the actual versions of <TT
  7474. CLASS="filename"
  7475. >httpd.conf</TT
  7476. >, but it is commented out. Remember
  7477.      also to substitute the <TT
  7478. CLASS="filename"
  7479. >c:/php/</TT
  7480. > for your actual path to
  7481.      PHP.
  7482.      </P
  7483. ><DIV
  7484. CLASS="warning"
  7485. ><P
  7486. ></P
  7487. ><TABLE
  7488. CLASS="warning"
  7489. BORDER="1"
  7490. WIDTH="100%"
  7491. ><TR
  7492. ><TD
  7493. ALIGN="CENTER"
  7494. ><B
  7495. >Varovßnφ</B
  7496. ></TD
  7497. ></TR
  7498. ><TR
  7499. ><TD
  7500. ALIGN="LEFT"
  7501. ><P
  7502. >       By using the CGI setup, your server is open
  7503.       to several possible attacks. Please read
  7504.       our <A
  7505. HREF="#security.cgi-bin"
  7506. >CGI security 
  7507.       section</A
  7508. > to learn how to defend yourself from attacks.
  7509.      </P
  7510. ></TD
  7511. ></TR
  7512. ></TABLE
  7513. ></DIV
  7514. ><P
  7515. >      If you would like to use PHP as a module in Apache, be sure to copy
  7516.      <TT
  7517. CLASS="filename"
  7518. >php4ts.dll</TT
  7519. > to the <TT
  7520. CLASS="filename"
  7521. >windows/system</TT
  7522. >
  7523.      (for Windows 9x/Me), <TT
  7524. CLASS="filename"
  7525. >winnt/system32</TT
  7526. > (for Windows
  7527.      NT/2000) or <TT
  7528. CLASS="filename"
  7529. >windows/system32</TT
  7530. > (for Windows XP)
  7531.      directory, overwriting any older file. Then you should add the following
  7532.      lines to your Apache <TT
  7533. CLASS="filename"
  7534. >httpd.conf</TT
  7535. > file:
  7536.      <P
  7537. ></P
  7538. ><UL
  7539. ><LI
  7540. ><P
  7541. >         Open <TT
  7542. CLASS="filename"
  7543. >httpd.conf</TT
  7544. > with your favorite editor and locate the
  7545.         <TT
  7546. CLASS="literal"
  7547. >LoadModule</TT
  7548. > directive and add the following line
  7549.         <SPAN
  7550. CLASS="emphasis"
  7551. ><I
  7552. CLASS="emphasis"
  7553. >at the end</I
  7554. ></SPAN
  7555. > of the list for PHP 4:
  7556.         <TT
  7557. CLASS="literal"
  7558. >LoadModule php4_module "c:/php/sapi/php4apache.dll"</TT
  7559. >
  7560.         or the following for PHP 5:
  7561.         <TT
  7562. CLASS="literal"
  7563. >LoadModule php5_module "c:/php/sapi/php5apache.dll"</TT
  7564. >
  7565.        </P
  7566. ></LI
  7567. ><LI
  7568. ><P
  7569. >         You may find after using the Windows installer for Apache that you need
  7570.         to define the <TT
  7571. CLASS="literal"
  7572. >AddModule</TT
  7573. > directive for
  7574.         <TT
  7575. CLASS="filename"
  7576. >mod_php4.c</TT
  7577. >. This is especially important if the
  7578.         <TT
  7579. CLASS="literal"
  7580. >ClearModuleList</TT
  7581. > directive is defined, which you will
  7582.         find by scrolling down a few lines. You will see a list of
  7583.         <TT
  7584. CLASS="literal"
  7585. >AddModule</TT
  7586. > entries, add the following line
  7587.         <SPAN
  7588. CLASS="emphasis"
  7589. ><I
  7590. CLASS="emphasis"
  7591. >at the end</I
  7592. ></SPAN
  7593. > of the list:      
  7594.         <TT
  7595. CLASS="literal"
  7596. >AddModule mod_php4.c</TT
  7597. >  For PHP 5, instead use
  7598.         <TT
  7599. CLASS="literal"
  7600. >AddModule mod_php5.c</TT
  7601. >
  7602.        </P
  7603. ></LI
  7604. ><LI
  7605. ><P
  7606. >          Search for a phrase similar to
  7607.          <TT
  7608. CLASS="literal"
  7609. ># AddType allows you to tweak mime.types</TT
  7610. >. You will
  7611.          see some <TT
  7612. CLASS="literal"
  7613. >AddType</TT
  7614. > entries, add the following line
  7615.          <SPAN
  7616. CLASS="emphasis"
  7617. ><I
  7618. CLASS="emphasis"
  7619. >at the end</I
  7620. ></SPAN
  7621. > of the list: 
  7622.          <TT
  7623. CLASS="literal"
  7624. >AddType application/x-httpd-php .php</TT
  7625. >.
  7626.          You can choose any extension you want to parse through PHP here. .php
  7627.          is simply the one we suggest. You can even include .html, and .php3
  7628.          can be added for backwards compatibility.
  7629.        </P
  7630. ></LI
  7631. ></UL
  7632. >
  7633.     </P
  7634. ><P
  7635. >      After changing the configuration file, remember to restart the server, for
  7636.      example, <B
  7637. CLASS="command"
  7638. >NET STOP APACHE</B
  7639. > followed by
  7640.      <B
  7641. CLASS="command"
  7642. >NET START APACHE</B
  7643. >, if you run Apache as a Windows
  7644.      Service, or use your regular shortcuts.
  7645.     </P
  7646. ><P
  7647. >      There are two ways you can use the source code highlighting feature,
  7648.      however their ability to work depends on your installation. If you have
  7649.      configured Apache to use PHP as an SAPI module, then by adding the
  7650.      following line to your <TT
  7651. CLASS="filename"
  7652. >httpd.conf</TT
  7653. > (at the same place you inserted
  7654.      <TT
  7655. CLASS="literal"
  7656. >AddType application/x-httpd-php .php</TT
  7657. >, see above) you can
  7658.      use this feature:
  7659.      <TT
  7660. CLASS="literal"
  7661. >AddType application/x-httpd-php-source .phps</TT
  7662. >.
  7663.     </P
  7664. ><P
  7665. >      If you chose to configure Apache to use PHP as a CGI binary, you
  7666.      will need to use the <A
  7667. HREF="#function.show-source"
  7668. ><B
  7669. CLASS="function"
  7670. >show_source()</B
  7671. ></A
  7672. > function. To
  7673.      do this simply create a PHP script file and add this code: 
  7674.      <TT
  7675. CLASS="literal"
  7676. ><?php show_source ("original_php_script.php"); ?></TT
  7677. >. 
  7678.      Substitute <TT
  7679. CLASS="literal"
  7680. >original_php_script.php</TT
  7681. > with 
  7682.      the name of the file you wish to show the source of. 
  7683.     </P
  7684. ><DIV
  7685. CLASS="note"
  7686. ><BLOCKQUOTE
  7687. CLASS="note"
  7688. ><P
  7689. ><B
  7690. >Poznßmka: </B
  7691. >
  7692.       On Win-Apache all backslashes in a path statement such
  7693.       as "c:\directory\file.ext", must be converted to
  7694.       forward slashes, as "c:/directory/file.ext".
  7695.      </P
  7696. ></BLOCKQUOTE
  7697. ></DIV
  7698. ></DIV
  7699. ></DIV
  7700. ><DIV
  7701. CLASS="sect1"
  7702. ><HR><H2
  7703. CLASS="sect1"
  7704. ><A
  7705. NAME="install.apache2"
  7706. ></A
  7707. >Servers-Apache 2.0</H2
  7708. ><P
  7709. >     This section contains notes and hints specific to Apache 2.0 installs
  7710.     of <TT
  7711. CLASS="literal"
  7712. >PHP</TT
  7713. >, both for
  7714.     <A
  7715. HREF="#install.apache2.unix"
  7716. >Unix</A
  7717. >
  7718.     and <A
  7719. HREF="#install.apache2.windows"
  7720. >Windows</A
  7721. > versions.
  7722.    </P
  7723. ><DIV
  7724. CLASS="warning"
  7725. ><P
  7726. ></P
  7727. ><TABLE
  7728. CLASS="warning"
  7729. BORDER="1"
  7730. WIDTH="100%"
  7731. ><TR
  7732. ><TD
  7733. ALIGN="CENTER"
  7734. ><B
  7735. >Varovßnφ</B
  7736. ></TD
  7737. ></TR
  7738. ><TR
  7739. ><TD
  7740. ALIGN="LEFT"
  7741. ><P
  7742. >      Do not use Apache 2.0 and <TT
  7743. CLASS="literal"
  7744. >PHP</TT
  7745. > in a production
  7746.      environment neither on Unix nor on Windows.
  7747.     </P
  7748. ></TD
  7749. ></TR
  7750. ></TABLE
  7751. ></DIV
  7752. ><P
  7753. >      You are highly encouraged to take a look at the
  7754.      <A
  7755. HREF="http://httpd.apache.org/docs-2.0/"
  7756. TARGET="_top"
  7757. >Apache Documentation</A
  7758. > to get
  7759.      a basic understanding of the Apache 2.0 Server.
  7760.     </P
  7761. ><DIV
  7762. CLASS="sect2"
  7763. ><HR><H3
  7764. CLASS="sect2"
  7765. ><A
  7766. NAME="compat.apache2"
  7767. ></A
  7768. >PHP and Apache 2.0 compatibility notes</H3
  7769. ><P
  7770. >      The following versions of PHP are known to work with the most recent
  7771.      version of Apache 2.0:
  7772.      <P
  7773. ></P
  7774. ><UL
  7775. COMPACT="COMPACT"
  7776. ><LI
  7777. ><SPAN
  7778. >         PHP 4.3.0 or later available at
  7779.         <A
  7780. HREF="http://www.php.net/downloads.php"
  7781. TARGET="_top"
  7782. >http://www.php.net/downloads.php</A
  7783. >.
  7784.        </SPAN
  7785. ></LI
  7786. ><LI
  7787. ><SPAN
  7788. >         the latest stable development version.
  7789.         Get the source code <A
  7790. HREF="http://snaps.php.net/php4-latest.tar.gz"
  7791. TARGET="_top"
  7792. >         http://snaps.php.net/php4-latest.tar.gz</A
  7793. > or download binaries
  7794.         for Windows <A
  7795. HREF="http://snaps.php.net/win32/php4-win32-latest.zip"
  7796. TARGET="_top"
  7797. >         http://snaps.php.net/win32/php4-win32-latest.zip</A
  7798. >.
  7799.        </SPAN
  7800. ></LI
  7801. ><LI
  7802. ><SPAN
  7803. >         a prerelease version downloadable from
  7804.         <A
  7805. HREF="http://qa.php.net/"
  7806. TARGET="_top"
  7807. >http://qa.php.net/</A
  7808. >.
  7809.        </SPAN
  7810. ></LI
  7811. ><LI
  7812. ><SPAN
  7813. >         you have always the option to obtain <TT
  7814. CLASS="literal"
  7815. >PHP</TT
  7816. > through
  7817.         <A
  7818. HREF="http://www.php.net/anoncvs.php"
  7819. TARGET="_top"
  7820. >anonymous CVS</A
  7821. >.
  7822.        </SPAN
  7823. ></LI
  7824. ></UL
  7825. >
  7826.       These versions of <TT
  7827. CLASS="literal"
  7828. >PHP</TT
  7829. > are compatible to Apache 2.0.40 and later.
  7830.     </P
  7831. ><DIV
  7832. CLASS="note"
  7833. ><BLOCKQUOTE
  7834. CLASS="note"
  7835. ><P
  7836. ><B
  7837. >Poznßmka: </B
  7838. >
  7839.       Apache 2.0 <TT
  7840. CLASS="literal"
  7841. >SAPI</TT
  7842. >-support started with PHP 4.2.0.
  7843.       PHP 4.2.3 works with Apache 2.0.39, don't use any other version of Apache with
  7844.       PHP 4.2.3. However, the recommended setup is to use PHP 4.3.0 or later with
  7845.       the most recent version of Apache2.
  7846.      </P
  7847. ><P
  7848. >       All mentioned versions of <TT
  7849. CLASS="literal"
  7850. >PHP</TT
  7851. > will work still with
  7852.       Apache 1.3.x.
  7853.      </P
  7854. ></BLOCKQUOTE
  7855. ></DIV
  7856. ></DIV
  7857. ><DIV
  7858. CLASS="sect2"
  7859. ><HR><H3
  7860. CLASS="sect2"
  7861. ><A
  7862. NAME="install.apache2.unix"
  7863. ></A
  7864. >PHP and Apache 2 on Linux</H3
  7865. ><P
  7866. >      Download the most recent version of <A
  7867. HREF="http://www.apache.org/"
  7868. TARGET="_top"
  7869. >      Apache 2.0</A
  7870. > and a fitting PHP version from the above mentioned places.
  7871.      This quick guide covers only the basics to get started with Apache 2.0
  7872.      and <TT
  7873. CLASS="literal"
  7874. >PHP</TT
  7875. >. For more information read the
  7876.      <A
  7877. HREF="http://httpd.apache.org/docs-2.0/"
  7878. TARGET="_top"
  7879. >Apache Documentation</A
  7880. >.
  7881.      The version numbers have been omitted here, to ensure the
  7882.      instructions are not incorrect. You will need to replace the 'NN' here with the
  7883.      correct values from your files.
  7884.     </P
  7885. ><TABLE
  7886. WIDTH="100%"
  7887. BORDER="0"
  7888. CELLPADDING="0"
  7889. CELLSPACING="0"
  7890. CLASS="EXAMPLE"
  7891. ><TR
  7892. ><TD
  7893. ><DIV
  7894. CLASS="example"
  7895. ><A
  7896. NAME="AEN1495"
  7897. ></A
  7898. ><P
  7899. ><B
  7900. >P°φklad 3-6. 
  7901.       Installation Instructions (Apache 2 Shared Module Version)
  7902.      </B
  7903. ></P
  7904. ><TABLE
  7905. BORDER="0"
  7906. BGCOLOR="#E0E0E0"
  7907. CELLPADDING="5"
  7908. ><TR
  7909. ><TD
  7910. ><PRE
  7911. CLASS="screen"
  7912. >1.  gzip -d httpd-2_0_NN.tar.gz
  7913. 2.  tar xvf httpd-2_0_NN.tar
  7914. 3.  gunzip php-NN.tar.gz
  7915. 4.  tar -xvf php-NN.tar
  7916. 5.  cd httpd-2_0_NN
  7917. 6.  ./configure --enable-so
  7918. 7.  make
  7919. 8.  make install
  7920.  
  7921.     Now you have Apache 2.0.NN available under /usr/local/apache2,
  7922.     configured with loadable module support and the standard MPM prefork.
  7923.     To test the installation use your normal procedure for starting
  7924.     the Apache server, e.g.:
  7925.     /usr/local/apache2/bin/apachectl start
  7926.     and stop the server to go on with the configuration for PHP:
  7927.     /usr/local/apache2/bin/apachectl stop.
  7928.  
  7929. 9.  cd ../php-NN
  7930.  
  7931. 10. Now, configure your PHP.  This is where you customize your PHP
  7932.     with various options, like which extensions will be enabled.  Do a
  7933.     ./configure --help for a list of available options.  In our example
  7934.     we'll do a simple configure with Apache 2 and MySQL support.  Your
  7935.     path to apxs may differ, in fact, the binary may even be named apxs2 on
  7936.     your system. 
  7937.     
  7938.       ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
  7939.  
  7940. 11. make
  7941. 12. make install
  7942.  
  7943.     If you decide to change your configure options after installation,
  7944.     you only need to repeat the last three steps. You only need to
  7945.     restart apache for the new module to take effect. A recompile of
  7946.     Apache is not needed.
  7947.                 
  7948.     Note that unless told otherwise, 'make install' will also install PEAR,
  7949.     various PHP tools such as phpize, install the PHP CLI, and more.
  7950.     
  7951. 13. Setup your php.ini 
  7952.     
  7953.     cp php.ini-dist /usr/local/lib/php.ini
  7954.           
  7955.     You may edit your .ini file to set PHP options.  If you prefer having
  7956.     php.ini in another location, use --with-config-file-path=/some/path in
  7957.     step 10.
  7958.     
  7959.     If you instead choose php.ini-recommended, be certain to read the list
  7960.     of changes within, as they affect how PHP behaves.
  7961.  
  7962. 14. Edit your httpd.conf to load the PHP module.  The path on the right hand
  7963.     side of the LoadModule statement must point to the path of the PHP
  7964.     module on your system.  The make install from above may have already
  7965.     added this for you, but be sure to check.
  7966.  
  7967.     For PHP 4:
  7968.   
  7969.       LoadModule php4_module libexec/libphp4.so
  7970.       
  7971.     For PHP 5:
  7972.     
  7973.       LoadModule php5_module libexec/libphp5.so
  7974.  
  7975. 15. Tell Apache to parse certain extensions as PHP.  For example,
  7976.     let's have Apache parse the .php extension as PHP.  You could
  7977.     have any extension(s) parse as PHP by simply adding more, with
  7978.     each separated by a space.  We'll add .phtml to demonstrate.
  7979.             
  7980.       AddType application/x-httpd-php .php .phtml
  7981.                   
  7982.     It's also common to setup the .phps extension to show highlighted PHP
  7983.     source, this can be done with:
  7984.     
  7985.       AddType application/x-httpd-php-source .phps
  7986.  
  7987. 16. Use your normal procedure for starting the Apache server, e.g.:
  7988.    
  7989.       /usr/local/apache2/bin/apachectl start</PRE
  7990. ></TD
  7991. ></TR
  7992. ></TABLE
  7993. ></DIV
  7994. ></TD
  7995. ></TR
  7996. ></TABLE
  7997. ><P
  7998. >      Following the steps above you will have a running Apache 2.0 with
  7999.      support for <TT
  8000. CLASS="literal"
  8001. >PHP</TT
  8002. > as <TT
  8003. CLASS="literal"
  8004. >SAPI</TT
  8005. > module.
  8006.      Of course there are many more configuration options available for both,
  8007.      Apache and <TT
  8008. CLASS="literal"
  8009. >PHP</TT
  8010. >. For more information use
  8011.      <B
  8012. CLASS="command"
  8013. >./configure --help</B
  8014. > in the corresponding source
  8015.      tree. In case you wish to build a multithreaded version of Apache 2.0
  8016.      you must overwrite the standard MPM-Module <TT
  8017. CLASS="filename"
  8018. >prefork</TT
  8019. >
  8020.      either with <TT
  8021. CLASS="filename"
  8022. >worker</TT
  8023. > or <TT
  8024. CLASS="filename"
  8025. >perchild</TT
  8026. >.
  8027.      To do so append to your configure line in step 6 above either the option
  8028.      <TT
  8029. CLASS="option"
  8030. >--with-mpm=worker</TT
  8031. > or
  8032.      <TT
  8033. CLASS="option"
  8034. >--with-mpm=perchild</TT
  8035. >. Take care about
  8036.      the consequences and understand what you are doing. For more information
  8037.      read the Apache documentation about the <A
  8038. HREF="http://httpd.apache.org/docs-2.0/mpm.html"
  8039. TARGET="_top"
  8040. >      MPM-Modules</A
  8041. >.
  8042.     </P
  8043. ><DIV
  8044. CLASS="note"
  8045. ><BLOCKQUOTE
  8046. CLASS="note"
  8047. ><P
  8048. ><B
  8049. >Poznßmka: </B
  8050. >
  8051.       To build a multithreaded version of Apache your system must support threads.
  8052.       This also implies to build <TT
  8053. CLASS="literal"
  8054. >PHP</TT
  8055. > with experimental
  8056.       Zend Thread Safety (ZTS). Therefore not all extensions might be available.
  8057.       The recommended setup is to build Apache with the standard
  8058.       <TT
  8059. CLASS="filename"
  8060. >prefork</TT
  8061. > MPM-Module.
  8062.      </P
  8063. ></BLOCKQUOTE
  8064. ></DIV
  8065. ></DIV
  8066. ><DIV
  8067. CLASS="sect2"
  8068. ><HR><H3
  8069. CLASS="sect2"
  8070. ><A
  8071. NAME="install.apache2.windows"
  8072. ></A
  8073. >PHP and Apache 2.0 on Windows</H3
  8074. ><P
  8075. >      Consider to read the <A
  8076. HREF="http://httpd.apache.org/docs-2.0/platform/windows.html"
  8077. TARGET="_top"
  8078. >      Windows specific notes</A
  8079. > for Apache 2.0.
  8080.     </P
  8081. ><DIV
  8082. CLASS="warning"
  8083. ><P
  8084. ></P
  8085. ><TABLE
  8086. CLASS="warning"
  8087. BORDER="1"
  8088. WIDTH="100%"
  8089. ><TR
  8090. ><TD
  8091. ALIGN="CENTER"
  8092. ><B
  8093. >Varovßnφ</B
  8094. ></TD
  8095. ></TR
  8096. ><TR
  8097. ><TD
  8098. ALIGN="LEFT"
  8099. ><P
  8100. >       Apache 2.0 is designed to run on Windows NT 4.0, Windows 2000 or
  8101.       Windows XP. At this time, support for Windows 9x is incomplete.
  8102.       Apache 2.0 is not expected to work on those platforms at this time.
  8103.      </P
  8104. ></TD
  8105. ></TR
  8106. ></TABLE
  8107. ></DIV
  8108. ><P
  8109. >      Download the most recent version of <A
  8110. HREF="http://www.apache.org/"
  8111. TARGET="_top"
  8112. >      Apache 2.0</A
  8113. > and a fitting PHP version from the above mentioned places.
  8114.      Follow the <A
  8115. HREF="#install.windows.manual"
  8116. >Manual Installation Steps</A
  8117. >
  8118.      and come back to go on with the integration of <TT
  8119. CLASS="literal"
  8120. >PHP</TT
  8121. >
  8122.      and Apache.
  8123.     </P
  8124. ><P
  8125. >      There are two ways to set up <TT
  8126. CLASS="literal"
  8127. >PHP</TT
  8128. > to work with
  8129.      Apache 2.0 on Windows. One is to use the CGI binary the other is to
  8130.      use the Apache module DLL. In either case you need to stop the Apache
  8131.      server, and edit your <TT
  8132. CLASS="filename"
  8133. >httpd.conf</TT
  8134. > to configure Apache
  8135.      to work with <TT
  8136. CLASS="literal"
  8137. >PHP</TT
  8138. >.
  8139.     </P
  8140. ><P
  8141. >      You need to insert these three lines to your Apache <TT
  8142. CLASS="filename"
  8143. >httpd.conf</TT
  8144. >
  8145.      configuration file to set up the <SPAN
  8146. CLASS="emphasis"
  8147. ><I
  8148. CLASS="emphasis"
  8149. >CGI binary</I
  8150. ></SPAN
  8151. >:
  8152.      <TABLE
  8153. WIDTH="100%"
  8154. BORDER="0"
  8155. CELLPADDING="0"
  8156. CELLSPACING="0"
  8157. CLASS="EXAMPLE"
  8158. ><TR
  8159. ><TD
  8160. ><DIV
  8161. CLASS="example"
  8162. ><A
  8163. NAME="AEN1530"
  8164. ></A
  8165. ><P
  8166. ><B
  8167. >P°φklad 3-7. PHP and Apache 2.0 as CGI</B
  8168. ></P
  8169. ><TABLE
  8170. BORDER="0"
  8171. BGCOLOR="#E0E0E0"
  8172. CELLPADDING="5"
  8173. ><TR
  8174. ><TD
  8175. ><PRE
  8176. CLASS="apache"
  8177. >ScriptAlias /php/ "c:/php/"
  8178. AddType application/x-httpd-php .php
  8179. Action application/x-httpd-php "/php/php.exe"</PRE
  8180. ></TD
  8181. ></TR
  8182. ></TABLE
  8183. ></DIV
  8184. ></TD
  8185. ></TR
  8186. ></TABLE
  8187. >
  8188.     </P
  8189. ><P
  8190. >      If you would like to use <TT
  8191. CLASS="literal"
  8192. >PHP</TT
  8193. > as a module in Apache 2.0,
  8194.      be sure to move <TT
  8195. CLASS="filename"
  8196. >php4ts.dll</TT
  8197. > for PHP 4, or
  8198.      <TT
  8199. CLASS="filename"
  8200. >php5ts.dll</TT
  8201. > for PHP 5, to
  8202.      <TT
  8203. CLASS="filename"
  8204. >winnt/system32</TT
  8205. > (for Windows NT/2000) or
  8206.      <TT
  8207. CLASS="filename"
  8208. >windows/system32</TT
  8209. > (for Windows XP),
  8210.      overwriting any older file. You need to insert these two lines to your
  8211.      Apache <TT
  8212. CLASS="filename"
  8213. >httpd.conf</TT
  8214. > configuration file to set up the
  8215.      <SPAN
  8216. CLASS="emphasis"
  8217. ><I
  8218. CLASS="emphasis"
  8219. >PHP-Module</I
  8220. ></SPAN
  8221. > for Apache 2.0:
  8222.      <TABLE
  8223. WIDTH="100%"
  8224. BORDER="0"
  8225. CELLPADDING="0"
  8226. CELLSPACING="0"
  8227. CLASS="EXAMPLE"
  8228. ><TR
  8229. ><TD
  8230. ><DIV
  8231. CLASS="example"
  8232. ><A
  8233. NAME="AEN1541"
  8234. ></A
  8235. ><P
  8236. ><B
  8237. >P°φklad 3-8. PHP and Apache 2.0 as Module</B
  8238. ></P
  8239. ><TABLE
  8240. BORDER="0"
  8241. BGCOLOR="#E0E0E0"
  8242. CELLPADDING="5"
  8243. ><TR
  8244. ><TD
  8245. ><PRE
  8246. CLASS="apache"
  8247. >; For PHP 4 do something like this:
  8248. LoadModule php4_module "c:/php/sapi/php4apache2.dll"
  8249. AddType application/x-httpd-php .php
  8250.  
  8251. ; For PHP 5 do something like this:
  8252. LoadModule php5_module "c:/php/sapi/php5apache2.dll"
  8253. AddType application/x-httpd-php .php</PRE
  8254. ></TD
  8255. ></TR
  8256. ></TABLE
  8257. ></DIV
  8258. ></TD
  8259. ></TR
  8260. ></TABLE
  8261. >
  8262.     </P
  8263. ><DIV
  8264. CLASS="note"
  8265. ><BLOCKQUOTE
  8266. CLASS="note"
  8267. ><P
  8268. ><B
  8269. >Poznßmka: </B
  8270. >
  8271.       Remember to substitute the <TT
  8272. CLASS="filename"
  8273. >c:/php/</TT
  8274. > for your actual
  8275.       path to <TT
  8276. CLASS="literal"
  8277. >PHP</TT
  8278. > in the above examples. Take care to use
  8279.       either <TT
  8280. CLASS="filename"
  8281. >php4apache2.dll</TT
  8282. > or 
  8283.       <TT
  8284. CLASS="filename"
  8285. >php5apache2.dll</TT
  8286. > in your LoadModule directive and
  8287.       <SPAN
  8288. CLASS="emphasis"
  8289. ><I
  8290. CLASS="emphasis"
  8291. >not</I
  8292. ></SPAN
  8293. ><TT
  8294. CLASS="filename"
  8295. >php4apache.dll</TT
  8296. > or 
  8297.       <TT
  8298. CLASS="filename"
  8299. >php5apache.dll</TT
  8300. > as the latter ones are designed to
  8301.       run with <A
  8302. HREF="#install.apache.windows"
  8303. >Apache 1.3.x</A
  8304. >.
  8305.      </P
  8306. ></BLOCKQUOTE
  8307. ></DIV
  8308. ><DIV
  8309. CLASS="warning"
  8310. ><P
  8311. ></P
  8312. ><TABLE
  8313. CLASS="warning"
  8314. BORDER="1"
  8315. WIDTH="100%"
  8316. ><TR
  8317. ><TD
  8318. ALIGN="CENTER"
  8319. ><B
  8320. >Varovßnφ</B
  8321. ></TD
  8322. ></TR
  8323. ><TR
  8324. ><TD
  8325. ALIGN="LEFT"
  8326. ><P
  8327. >       Don't mix up your installation with dll files from
  8328.       <SPAN
  8329. CLASS="emphasis"
  8330. ><I
  8331. CLASS="emphasis"
  8332. >different PHP versions </I
  8333. ></SPAN
  8334. >. You have the only choice
  8335.       to use the dll's and extensions that ship with your downloaded PHP version.
  8336.      </P
  8337. ></TD
  8338. ></TR
  8339. ></TABLE
  8340. ></DIV
  8341. ></DIV
  8342. ></DIV
  8343. ><DIV
  8344. CLASS="sect1"
  8345. ><HR><H2
  8346. CLASS="sect1"
  8347. ><A
  8348. NAME="install.caudium"
  8349. ></A
  8350. >Servers-Caudium</H2
  8351. ><P
  8352. >     PHP 4 can be built as a Pike module for the
  8353.     <A
  8354. HREF="http://caudium.net/"
  8355. TARGET="_top"
  8356. >Caudium webserver</A
  8357. >.
  8358.     Note that this is not supported with PHP 3. Follow the simple
  8359.     instructions below to install PHP 4 for Caudium.
  8360.    </P
  8361. ><TABLE
  8362. WIDTH="100%"
  8363. BORDER="0"
  8364. CELLPADDING="0"
  8365. CELLSPACING="0"
  8366. CLASS="EXAMPLE"
  8367. ><TR
  8368. ><TD
  8369. ><DIV
  8370. CLASS="example"
  8371. ><A
  8372. NAME="install.caudium.instructions"
  8373. ></A
  8374. ><P
  8375. ><B
  8376. >P°φklad 3-9. Caudium Installation Instructions</B
  8377. ></P
  8378. ><TABLE
  8379. BORDER="0"
  8380. BGCOLOR="#E0E0E0"
  8381. CELLPADDING="5"
  8382. ><TR
  8383. ><TD
  8384. ><PRE
  8385. CLASS="screen"
  8386. >1.  Make sure you have Caudium installed prior to attempting to
  8387.     install PHP 4. For PHP 4 to work correctly, you will need Pike
  8388.     7.0.268 or newer. For the sake of this example we assume that
  8389.     Caudium is installed in /opt/caudium/server/.
  8390. 2.  Change directory to php-x.y.z (where x.y.z is the version number).
  8391. 3.  ./configure --with-caudium=/opt/caudium/server
  8392. 4.  make
  8393. 5.  make install
  8394. 6.  Restart Caudium if it's currently running.
  8395. 7.  Log into the graphical configuration interface and go to the
  8396.     virtual server where you want to add PHP 4 support.
  8397. 8.  Click Add Module and locate and then add the PHP 4 Script Support module.
  8398. 9.  If the documentation says that the 'PHP 4 interpreter isn't
  8399.     available', make sure that you restarted the server. If you did
  8400.     check /opt/caudium/logs/debug/default.1 for any errors related to
  8401.     <filename>PHP4.so</filename>. Also make sure that 
  8402.     <filename>caudium/server/lib/[pike-version]/PHP4.so</filename>
  8403.     is present.
  8404. 10. Configure the PHP Script Support module if needed.</PRE
  8405. ></TD
  8406. ></TR
  8407. ></TABLE
  8408. ></DIV
  8409. ></TD
  8410. ></TR
  8411. ></TABLE
  8412. ><P
  8413. >     You can of course compile your Caudium module with support for the
  8414.     various extensions available in PHP 4. See the 
  8415.     <A
  8416. HREF="#install.configure"
  8417. >complete list of configure
  8418.     options</A
  8419. > for an exhaustive rundown. 
  8420.    </P
  8421. ><DIV
  8422. CLASS="note"
  8423. ><BLOCKQUOTE
  8424. CLASS="note"
  8425. ><P
  8426. ><B
  8427. >Poznßmka: </B
  8428. >
  8429.      When compiling PHP 4 with MySQL support you must make sure that
  8430.      the normal MySQL client code is used. Otherwise there might be
  8431.      conflicts if your Pike already has MySQL support. You do this by
  8432.      specifying a MySQL install directory the 
  8433.      <TT
  8434. CLASS="option"
  8435. > --with-mysql</TT
  8436. > option.
  8437.     </P
  8438. ></BLOCKQUOTE
  8439. ></DIV
  8440. ></DIV
  8441. ><DIV
  8442. CLASS="sect1"
  8443. ><HR><H2
  8444. CLASS="sect1"
  8445. ><A
  8446. NAME="install.fhttpd"
  8447. ></A
  8448. >Servers-fhttpd</H2
  8449. ><P
  8450. >     To build PHP as an fhttpd module, answer "yes" to "Build as an
  8451.     fhttpd module?" (the <A
  8452. HREF="#install.configure.with-fhttpd"
  8453. >     --with-fhttpd</A
  8454. >=<TT
  8455. CLASS="replaceable"
  8456. ><I
  8457. >DIR</I
  8458. ></TT
  8459. >
  8460.     option to configure) and specify the fhttpd source base
  8461.     directory.  The default directory is <TT
  8462. CLASS="filename"
  8463. >/usr/local/src/fhttpd</TT
  8464. >. If you are
  8465.     running fhttpd, building PHP as a module will give better
  8466.     performance, more control and remote execution capability.
  8467.    </P
  8468. ><DIV
  8469. CLASS="note"
  8470. ><BLOCKQUOTE
  8471. CLASS="note"
  8472. ><P
  8473. ><B
  8474. >Poznßmka: </B
  8475. >
  8476.     Support for fhttpd is no longer available as of PHP 4.3.0.
  8477.    </P
  8478. ></BLOCKQUOTE
  8479. ></DIV
  8480. ></DIV
  8481. ><DIV
  8482. CLASS="sect1"
  8483. ><HR><H2
  8484. CLASS="sect1"
  8485. ><A
  8486. NAME="install.iis"
  8487. ></A
  8488. >Servers-IIS/PWS</H2
  8489. ><P
  8490. >     This section contains notes and hints specific to IIS (Microsoft
  8491.     Internet Information Server). Installing PHP for
  8492.     <A
  8493. HREF="#install.iis.iis3"
  8494. >PWS/IIS 3</A
  8495. >,
  8496.     <A
  8497. HREF="#install.iis.pws4"
  8498. >PWS 4 or newer</A
  8499. > and
  8500.     <A
  8501. HREF="#install.iis.iis4"
  8502. >IIS 4 or newer</A
  8503. > versions.
  8504.    </P
  8505. ><DIV
  8506. CLASS="note"
  8507. ><BLOCKQUOTE
  8508. CLASS="note"
  8509. ><P
  8510. ><B
  8511. >Important for CGI users: </B
  8512. >
  8513.      Read the <A
  8514. HREF="#faq.installation.forceredirect"
  8515. >faq
  8516.      on cgi.force_redirect</A
  8517. > for important details.  This
  8518.      directive needs to be set to <TT
  8519. CLASS="literal"
  8520. >0</TT
  8521. >.
  8522.     </P
  8523. ></BLOCKQUOTE
  8524. ></DIV
  8525. ><DIV
  8526. CLASS="sect2"
  8527. ><HR><H3
  8528. CLASS="sect2"
  8529. ><A
  8530. NAME="install.iis.iis3"
  8531. ></A
  8532. >Windows and PWS/IIS 3</H3
  8533. ><P
  8534. >      The recommended method for configuring these servers is to use
  8535.      the REG file included with the distribution
  8536.      (pws-php4cgi.reg). You may want to edit this file and make sure
  8537.      the extensions and PHP install directories match your
  8538.      configuration. Or you can follow the steps below to do it
  8539.      manually.
  8540.     </P
  8541. ><DIV
  8542. CLASS="warning"
  8543. ><P
  8544. ></P
  8545. ><TABLE
  8546. CLASS="warning"
  8547. BORDER="1"
  8548. WIDTH="100%"
  8549. ><TR
  8550. ><TD
  8551. ALIGN="CENTER"
  8552. ><B
  8553. >Varovßnφ</B
  8554. ></TD
  8555. ></TR
  8556. ><TR
  8557. ><TD
  8558. ALIGN="LEFT"
  8559. ><P
  8560. >       These steps involve working directly with the Windows
  8561.       registry. One error here can leave your system in an unstable
  8562.       state. We highly recommend that you back up your registry
  8563.       first. The PHP Development team will not be held responsible if
  8564.       you damage your registry.
  8565.      </P
  8566. ></TD
  8567. ></TR
  8568. ></TABLE
  8569. ></DIV
  8570. ><P
  8571. >      <P
  8572. ></P
  8573. ><UL
  8574. ><LI
  8575. ><P
  8576. >         Run Regedit.
  8577.        </P
  8578. ></LI
  8579. ><LI
  8580. ><P
  8581. >         Navigate to: <TT
  8582. CLASS="literal"
  8583. >HKEY_LOCAL_MACHINE /System
  8584.          /CurrentControlSet /Services /W3Svc /Parameters
  8585.          /ScriptMap</TT
  8586. >.
  8587.        </P
  8588. ></LI
  8589. ><LI
  8590. ><P
  8591. >         On the edit menu select: <TT
  8592. CLASS="literal"
  8593. >New->String Value</TT
  8594. >.
  8595.        </P
  8596. ></LI
  8597. ><LI
  8598. ><P
  8599. >         Type in the extension you wish to use for your php
  8600.         scripts. For example <TT
  8601. CLASS="literal"
  8602. >.php</TT
  8603. >
  8604.        </P
  8605. ></LI
  8606. ><LI
  8607. ><P
  8608. >         Double click on the new string value and enter the path to
  8609.         <TT
  8610. CLASS="literal"
  8611. >php.exe</TT
  8612. > in the value data field. ex:
  8613.         <TT
  8614. CLASS="literal"
  8615. >c:\php\php.exe</TT
  8616. >.
  8617.        </P
  8618. ></LI
  8619. ><LI
  8620. ><P
  8621. >         Repeat these steps for each extension you wish to associate
  8622.         with PHP scripts.
  8623.        </P
  8624. ></LI
  8625. ></UL
  8626. >
  8627.     </P
  8628. ><P
  8629. >      The following steps do not affect the web server installation
  8630.      and only apply if you want your PHP scripts to be executed when
  8631.      they are run from the command line (ex. run
  8632.      <TT
  8633. CLASS="filename"
  8634. >c:\myscripts\test.php</TT
  8635. >) or by double clicking
  8636.      on them in a directory viewer window. You may wish to skip these
  8637.      steps as you might prefer the PHP files to load into a text
  8638.      editor when you double click on them.
  8639.     </P
  8640. ><P
  8641. >      <P
  8642. ></P
  8643. ><UL
  8644. ><LI
  8645. ><P
  8646. >         Navigate to: <TT
  8647. CLASS="literal"
  8648. >HKEY_CLASSES_ROOT</TT
  8649. >
  8650.        </P
  8651. ></LI
  8652. ><LI
  8653. ><P
  8654. >         On the edit menu select: <TT
  8655. CLASS="literal"
  8656. >New->Key</TT
  8657. >.
  8658.        </P
  8659. ></LI
  8660. ><LI
  8661. ><P
  8662. >         Name the key to the extension you setup in the previous
  8663.         section. ex: <TT
  8664. CLASS="literal"
  8665. >.php</TT
  8666. >
  8667.        </P
  8668. ></LI
  8669. ><LI
  8670. ><P
  8671. >         Highlight the new key and in the right side pane, double click 
  8672.         the "default value" and enter <TT
  8673. CLASS="literal"
  8674. >phpfile</TT
  8675. >.
  8676.        </P
  8677. ></LI
  8678. ><LI
  8679. ><P
  8680. >         Repeat the last step for each extension you set up in the
  8681.         previous section.
  8682.        </P
  8683. ></LI
  8684. ><LI
  8685. ><P
  8686. >         Now create another <TT
  8687. CLASS="literal"
  8688. >New->Key</TT
  8689. > under
  8690.         <TT
  8691. CLASS="literal"
  8692. >HKEY_CLASSES_ROOT</TT
  8693. > and name it
  8694.         <TT
  8695. CLASS="literal"
  8696. >phpfile</TT
  8697. >.
  8698.        </P
  8699. ></LI
  8700. ><LI
  8701. ><P
  8702. >         Highlight the new key <TT
  8703. CLASS="literal"
  8704. >phpfile</TT
  8705. > and in the
  8706.         right side pane, double click the "default value" and enter
  8707.         <TT
  8708. CLASS="literal"
  8709. >PHP Script</TT
  8710. >.
  8711.        </P
  8712. ></LI
  8713. ><LI
  8714. ><P
  8715. >         Right click on the <TT
  8716. CLASS="literal"
  8717. >phpfile</TT
  8718. > key and select
  8719.         <TT
  8720. CLASS="literal"
  8721. >New->Key</TT
  8722. >, name it <TT
  8723. CLASS="literal"
  8724. >Shell</TT
  8725. >.
  8726.        </P
  8727. ></LI
  8728. ><LI
  8729. ><P
  8730. >         Right click on the <TT
  8731. CLASS="literal"
  8732. >Shell</TT
  8733. > key and select
  8734.         <TT
  8735. CLASS="literal"
  8736. >New->Key</TT
  8737. >, name it <TT
  8738. CLASS="literal"
  8739. >open</TT
  8740. >.
  8741.        </P
  8742. ></LI
  8743. ><LI
  8744. ><P
  8745. >         Right click on the <TT
  8746. CLASS="literal"
  8747. >open</TT
  8748. > key and select
  8749.         <TT
  8750. CLASS="literal"
  8751. >New->Key</TT
  8752. >, name it
  8753.         <TT
  8754. CLASS="literal"
  8755. >command</TT
  8756. >. 
  8757.        </P
  8758. ></LI
  8759. ><LI
  8760. ><P
  8761. >         Highlight the new key <TT
  8762. CLASS="literal"
  8763. >command</TT
  8764. > and in the
  8765.         right side pane, double click the "default value" and enter
  8766.         the path to <TT
  8767. CLASS="literal"
  8768. >php.exe</TT
  8769. >. ex:
  8770.         <TT
  8771. CLASS="literal"
  8772. >c:\php\php.exe -q %1</TT
  8773. >. (don't forget the
  8774.         <TT
  8775. CLASS="literal"
  8776. >%1</TT
  8777. >). 
  8778.        </P
  8779. ></LI
  8780. ><LI
  8781. ><P
  8782. >         Exit Regedit.
  8783.        </P
  8784. ></LI
  8785. ><LI
  8786. ><P
  8787. >         If using PWS on Windows, reboot to reload the registry.
  8788.        </P
  8789. ></LI
  8790. ></UL
  8791. >
  8792.     </P
  8793. ><P
  8794. >      PWS and IIS 3 users now have a fully operational system. IIS 3
  8795.      users can use a nifty <A
  8796. HREF="http://www.genusa.com/iis/iiscfg.html"
  8797. TARGET="_top"
  8798. >tool</A
  8799. >
  8800.      from Steven Genusa to configure their script maps.
  8801.     </P
  8802. ></DIV
  8803. ><DIV
  8804. CLASS="sect2"
  8805. ><HR><H3
  8806. CLASS="sect2"
  8807. ><A
  8808. NAME="install.iis.pws4"
  8809. ></A
  8810. >Windows and PWS 4 or newer</H3
  8811. ><P
  8812. >      When installing PHP on Windows with PWS 4 or newer version,
  8813.      you have two options. One to set up the PHP CGI binary,
  8814.      the other is to use the ISAPI module DLL.
  8815.     </P
  8816. ><P
  8817. >      If you choose the CGI binary, do the following:
  8818.      <P
  8819. ></P
  8820. ><UL
  8821. ><LI
  8822. ><P
  8823. >         Edit the enclosed <TT
  8824. CLASS="filename"
  8825. >pws-php4cgi.reg</TT
  8826. >
  8827.         file (look into the SAPI dir) to reflect the location of
  8828.         your <TT
  8829. CLASS="filename"
  8830. >php.exe</TT
  8831. >.  Backslashes should be 
  8832.         escaped, for example:
  8833.         <TT
  8834. CLASS="literal"
  8835. >[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\php.exe"</TT
  8836. >
  8837.         Now merge this registery file into your system; you may do 
  8838.         this by double-clicking it.
  8839.        </P
  8840. ></LI
  8841. ><LI
  8842. ><P
  8843. >         In the PWS Manager, right click on a given directory you want
  8844.         to add PHP support to, and select Properties. Check the 'Execute'
  8845.         checkbox, and confirm.
  8846.        </P
  8847. ></LI
  8848. ></UL
  8849. >
  8850.     </P
  8851. ><P
  8852. >      If you choose the ISAPI module, do the following:
  8853.      <P
  8854. ></P
  8855. ><UL
  8856. ><LI
  8857. ><P
  8858. >         Edit the enclosed <TT
  8859. CLASS="filename"
  8860. >pws-php4isapi.reg</TT
  8861. >
  8862.         file (look into the SAPI dir) to reflect the location of
  8863.         your <TT
  8864. CLASS="filename"
  8865. >php4isapi.dll</TT
  8866. >.  Backslashes should 
  8867.         be escaped, for example:
  8868.         <TT
  8869. CLASS="literal"
  8870. >[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\sapi\\php4isapi.dll"</TT
  8871. >
  8872.         Now merge this registery file into your system; you may do 
  8873.         this by double-clicking it.
  8874.        </P
  8875. ></LI
  8876. ><LI
  8877. ><P
  8878. >         In the PWS Manager, right click on a given directory you want to
  8879.         add PHP support to, and select Properties. Check the 'Execute'
  8880.         checkbox, and confirm. 
  8881.        </P
  8882. ></LI
  8883. ></UL
  8884. >
  8885.     </P
  8886. ></DIV
  8887. ><DIV
  8888. CLASS="sect2"
  8889. ><HR><H3
  8890. CLASS="sect2"
  8891. ><A
  8892. NAME="install.iis.iis4"
  8893. ></A
  8894. >Windows NT/2000/XP and IIS 4 or newer</H3
  8895. ><P
  8896. >      To install PHP on an NT/2000/XP Server running IIS 4 or newer,
  8897.      follow these instructions. You have two options to set up
  8898.      PHP, using the CGI binary (php.exe) or with the ISAPI module.
  8899.     </P
  8900. ><P
  8901. >      In either case, you need to start the Microsoft Management
  8902.      Console (may appear as 'Internet Services Manager', either
  8903.      in your Windows NT 4.0 Option Pack branch or the Control
  8904.      Panel=>Administrative Tools under Windows 2000/XP). Then 
  8905.      right click on your Web server node (this will most probably
  8906.      appear as 'Default Web Server'), and select 'Properties'.
  8907.     </P
  8908. ><P
  8909. >      If you want to use the CGI binary, do the following:
  8910.      <P
  8911. ></P
  8912. ><UL
  8913. ><LI
  8914. ><P
  8915. >         Under 'Home Directory', 'Virtual Directory', or
  8916.         'Directory', click on the 'Configuration' button,
  8917.         and then enter the App Mappings tab.
  8918.        </P
  8919. ></LI
  8920. ><LI
  8921. ><P
  8922. >         Click Add, and in the Executable box, type:
  8923.         <TT
  8924. CLASS="literal"
  8925. >c:\php\php.exe</TT
  8926. > (assuming
  8927.         that you have unziped PHP in c:\php\).
  8928.         </P
  8929. ></LI
  8930. ><LI
  8931. ><P
  8932. >         In the Extension box, type the file name extension you want
  8933.         associated with PHP scripts. Leave 'Method exclusions'
  8934.         blank, and check the Script engine checkbox. You may also
  8935.         like to check the 'check that file exists' box - for a small
  8936.         performance penalty, IIS (or PWS) will check that the script
  8937.         file exists and sort out authentication before firing up php.
  8938.         This means that you will get sensible 404 style error messages
  8939.         instead of cgi errors complaining that PHP did not output any data.
  8940.        </P
  8941. ><P
  8942. >         You must start over from the previous step for each
  8943.         extension you want associated with PHP scripts.
  8944.         <TT
  8945. CLASS="literal"
  8946. >.php</TT
  8947. > and <TT
  8948. CLASS="literal"
  8949. >.phtml</TT
  8950. >
  8951.         are common, although <TT
  8952. CLASS="literal"
  8953. >.php3</TT
  8954. > may be
  8955.         required for legacy applications.
  8956.        </P
  8957. ></LI
  8958. ><LI
  8959. ><P
  8960. >         Set up the appropriate security. (This is done in Internet
  8961.         Service Manager), and if your NT Server uses NTFS file system,
  8962.         add execute rights for I_USR_ to the directory that contains
  8963.         <TT
  8964. CLASS="literal"
  8965. >php.exe</TT
  8966. >.
  8967.        </P
  8968. ></LI
  8969. ></UL
  8970. >
  8971.     </P
  8972. ><P
  8973. >      To use the ISAPI module, do the following:
  8974.      <P
  8975. ></P
  8976. ><UL
  8977. ><LI
  8978. ><P
  8979. >         If you don't want to perform HTTP Authentication using PHP,
  8980.         you can (and should) skip this step. Under ISAPI Filters,
  8981.         add a new ISAPI filter. Use PHP as the filter name, and
  8982.         supply a path to the php4isapi.dll.
  8983.        </P
  8984. ></LI
  8985. ><LI
  8986. ><P
  8987. >         Under 'Home Directory', click on the 'Configuration' button.
  8988.         Add a new entry to the Application Mappings. Use the path
  8989.         to the php4isapi.dll as the Executable, supply
  8990.         <TT
  8991. CLASS="literal"
  8992. >.php</TT
  8993. > as the extension, leave Method
  8994.         exclusions blank, and check the Script engine checkbox.
  8995.        </P
  8996. ></LI
  8997. ><LI
  8998. ><P
  8999. >         Stop IIS completely (NET STOP iisadmin)
  9000.        </P
  9001. ></LI
  9002. ><LI
  9003. ><P
  9004. >         Start IIS again (NET START w3svc)
  9005.        </P
  9006. ></LI
  9007. ></UL
  9008. >
  9009.     </P
  9010. ></DIV
  9011. ></DIV
  9012. ><DIV
  9013. CLASS="sect1"
  9014. ><HR><H2
  9015. CLASS="sect1"
  9016. ><A
  9017. NAME="install.netscape-enterprise"
  9018. ></A
  9019. >Servers-Netscape, iPlanet and SunONE</H2
  9020. ><P
  9021. >     This section contains notes and hints specific to Netscape, iPlanet and SunONE webserver
  9022.     installs of PHP, both for <A
  9023. HREF="#install.netscape.sun"
  9024. >Sun Solaris</A
  9025. >
  9026.     and <A
  9027. HREF="#install.netscape.windows"
  9028. >Windows</A
  9029. > versions.
  9030.    </P
  9031. ><P
  9032. >     From PHP 4.3.3 on you can use PHP scripts with the <A
  9033. HREF="#ref.nsapi"
  9034. >NSAPI module</A
  9035. > to 
  9036.     <A
  9037. HREF="#install.netscape.specialpages"
  9038. >generate custom directory listings and
  9039.     error pages</A
  9040. >. Additional functions for Apache compatibility are also available.
  9041.     For support in current webservers read the
  9042.     <A
  9043. HREF="#install.netscape.notes"
  9044. >note about subrequests</A
  9045. >.
  9046.    </P
  9047. ><P
  9048. >     You can find more information about setting up PHP for the Netscape
  9049.     Enterprise Server (NES) here:
  9050.     <A
  9051. HREF="http://benoit.noss.free.fr/php/install-php4.html"
  9052. TARGET="_top"
  9053. >http://benoit.noss.free.fr/php/install-php4.html</A
  9054. >
  9055.    </P
  9056. ><DIV
  9057. CLASS="sect2"
  9058. ><HR><H3
  9059. CLASS="sect2"
  9060. ><A
  9061. NAME="install.netscape.sun"
  9062. ></A
  9063. >Installing PHP with NES/iPlanet/SunONE Webserver on Sun Solaris</H3
  9064. ><P
  9065. >      To build PHP with NES/iPlanet/SunONE webservers, enter the proper install
  9066.      directory for the
  9067.      <A
  9068. HREF="#install.configure.with-nsapi"
  9069. >--with-nsapi=[DIR]</A
  9070. >
  9071.      option. The default directory is usually
  9072.      <TT
  9073. CLASS="filename"
  9074. >/opt/netscape/suitespot/</TT
  9075. >.
  9076.      Please also read <TT
  9077. CLASS="filename"
  9078. >/php-xxx-version/sapi/nsapi/nsapi-readme.txt</TT
  9079. >.
  9080.     </P
  9081. ><P
  9082. >      <P
  9083. ></P
  9084. ><OL
  9085. TYPE="1"
  9086. ><LI
  9087. ><P
  9088. >         Install the following packages from <A
  9089. HREF="http://www.sunfreeware.com/"
  9090. TARGET="_top"
  9091. >         http://www.sunfreeware.com/</A
  9092. > or another download site:
  9093.         <P
  9094. ></P
  9095. ><TABLE
  9096. BORDER="0"
  9097. ><TBODY
  9098. ><TR
  9099. ><TD
  9100. ><TT
  9101. CLASS="filename"
  9102. >autoconf-2.13</TT
  9103. ></TD
  9104. ></TR
  9105. ><TR
  9106. ><TD
  9107. ><TT
  9108. CLASS="filename"
  9109. >automake-1.4</TT
  9110. ></TD
  9111. ></TR
  9112. ><TR
  9113. ><TD
  9114. ><TT
  9115. CLASS="filename"
  9116. >bison-1_25-sol26-sparc-local</TT
  9117. ></TD
  9118. ></TR
  9119. ><TR
  9120. ><TD
  9121. ><TT
  9122. CLASS="filename"
  9123. >flex-2_5_4a-sol26-sparc-local</TT
  9124. ></TD
  9125. ></TR
  9126. ><TR
  9127. ><TD
  9128. ><TT
  9129. CLASS="filename"
  9130. >gcc-2_95_2-sol26-sparc-local</TT
  9131. ></TD
  9132. ></TR
  9133. ><TR
  9134. ><TD
  9135. ><TT
  9136. CLASS="filename"
  9137. >gzip-1.2.4-sol26-sparc-local</TT
  9138. ></TD
  9139. ></TR
  9140. ><TR
  9141. ><TD
  9142. ><TT
  9143. CLASS="filename"
  9144. >m4-1_4-sol26-sparc-local</TT
  9145. ></TD
  9146. ></TR
  9147. ><TR
  9148. ><TD
  9149. ><TT
  9150. CLASS="filename"
  9151. >make-3_76_1-sol26-sparc-local</TT
  9152. ></TD
  9153. ></TR
  9154. ><TR
  9155. ><TD
  9156. >           <TT
  9157. CLASS="filename"
  9158. >mysql-3.23.24-beta</TT
  9159. > (if you want mysql support)
  9160.          </TD
  9161. ></TR
  9162. ><TR
  9163. ><TD
  9164. ><TT
  9165. CLASS="filename"
  9166. >perl-5_005_03-sol26-sparc-local</TT
  9167. ></TD
  9168. ></TR
  9169. ><TR
  9170. ><TD
  9171. ><TT
  9172. CLASS="filename"
  9173. >tar-1.13</TT
  9174. > (GNU tar)</TD
  9175. ></TR
  9176. ></TBODY
  9177. ></TABLE
  9178. ><P
  9179. ></P
  9180. >
  9181.        </P
  9182. ></LI
  9183. ><LI
  9184. ><P
  9185. >         Make sure your path includes the proper directories
  9186.         <TT
  9187. CLASS="literal"
  9188. >PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin</TT
  9189. >
  9190.         and make it available to your system <TT
  9191. CLASS="userinput"
  9192. ><B
  9193. >export PATH</B
  9194. ></TT
  9195. >.
  9196.        </P
  9197. ></LI
  9198. ><LI
  9199. ><P
  9200. >         <TT
  9201. CLASS="userinput"
  9202. ><B
  9203. >gunzip php-x.x.x.tar.gz</B
  9204. ></TT
  9205. > (if you have a .gz dist,
  9206.         otherwise go to 4).
  9207.        </P
  9208. ></LI
  9209. ><LI
  9210. ><P
  9211. >         <TT
  9212. CLASS="userinput"
  9213. ><B
  9214. >tar xvf php-x.x.x.tar</B
  9215. ></TT
  9216. >
  9217.        </P
  9218. ></LI
  9219. ><LI
  9220. ><P
  9221. >         Change to your extracted PHP directory:
  9222.         <TT
  9223. CLASS="userinput"
  9224. ><B
  9225. >cd ../php-x.x.x </B
  9226. ></TT
  9227. >
  9228.        </P
  9229. ></LI
  9230. ><LI
  9231. ><P
  9232. >         For the following step, make sure
  9233.         <TT
  9234. CLASS="filename"
  9235. >/opt/netscape/suitespot/</TT
  9236. > is
  9237.         where your netscape server is installed. Otherwise, change to the
  9238.         correct path and run:
  9239.         <TABLE
  9240. BORDER="0"
  9241. BGCOLOR="#E0E0E0"
  9242. CELLPADDING="5"
  9243. ><TR
  9244. ><TD
  9245. ><PRE
  9246. CLASS="shell"
  9247. >./configure --with-mysql=/usr/local/mysql \
  9248. --with-nsapi=/opt/netscape/suitespot/ \
  9249. --enable-libgcc</PRE
  9250. ></TD
  9251. ></TR
  9252. ></TABLE
  9253. >
  9254.        </P
  9255. ></LI
  9256. ><LI
  9257. ><P
  9258. >         Run <B
  9259. CLASS="command"
  9260. >make</B
  9261. > followed by <B
  9262. CLASS="command"
  9263. >make install</B
  9264. >.
  9265.        </P
  9266. ></LI
  9267. ></OL
  9268. >
  9269.     </P
  9270. ><P
  9271. >      After performing the base install and reading the appropriate readme file,
  9272.      you may need to perform some additional configuration steps.
  9273.     </P
  9274. ><DIV
  9275. CLASS="formalpara"
  9276. ><P
  9277. ><B
  9278. >Configuration Instructions for NES/iPlanet/SunONE. </B
  9279. >
  9280.       Firstly you may need to add some paths to the LD_LIBRARY_PATH environment
  9281.       for SunONE to find all the shared libs. This can best done in the start
  9282.       script for your SunONE webserver. Windows users can probably skip this
  9283.       step. The start script is often located in: <TT
  9284. CLASS="filename"
  9285. >/path/to/server/https-servername/start</TT
  9286. >.
  9287.       You may also need to edit the configuration files that are
  9288.       located in: <TT
  9289. CLASS="filename"
  9290. >/path/to/server/https-servername/config/</TT
  9291. >.
  9292.       <P
  9293. ></P
  9294. ><OL
  9295. TYPE="1"
  9296. ><LI
  9297. ><P
  9298. >          Add the following line to <TT
  9299. CLASS="filename"
  9300. >mime.types</TT
  9301. > (you can do
  9302.          that by the administration server):
  9303.          <TABLE
  9304. BORDER="0"
  9305. BGCOLOR="#E0E0E0"
  9306. CELLPADDING="5"
  9307. ><TR
  9308. ><TD
  9309. ><PRE
  9310. CLASS="screen"
  9311. >type=magnus-internal/x-httpd-php exts=php</PRE
  9312. ></TD
  9313. ></TR
  9314. ></TABLE
  9315. >
  9316.         </P
  9317. ></LI
  9318. ><LI
  9319. ><P
  9320. >          Edit <TT
  9321. CLASS="filename"
  9322. >magnus.conf</TT
  9323. > (for servers >= 6) or
  9324.          <TT
  9325. CLASS="filename"
  9326. >obj.conf</TT
  9327. > (for servers < 6) and add the following, shlib will
  9328.          vary depending on your OS, for Unix it will be something like
  9329.          <TT
  9330. CLASS="filename"
  9331. >/opt/netscape/suitespot/bin/libphp4.so</TT
  9332. >. You should
  9333.          place the following lines after <TT
  9334. CLASS="literal"
  9335. >mime types init</TT
  9336. >.
  9337.          <TABLE
  9338. BORDER="0"
  9339. BGCOLOR="#E0E0E0"
  9340. CELLPADDING="5"
  9341. ><TR
  9342. ><TD
  9343. ><PRE
  9344. CLASS="programlisting"
  9345. >Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="/opt/netscape/suitespot/bin/libphp4.so"
  9346. Init fn="php4_init" LateInit="yes" errorString="Failed to initialize PHP!" [php_ini="/path/to/php.ini"]</PRE
  9347. ></TD
  9348. ></TR
  9349. ></TABLE
  9350. >
  9351.          (PHP >= 4.3.3) The <TT
  9352. CLASS="literal"
  9353. >php_ini</TT
  9354. > parameter is optional but with it you can place your
  9355.          <TT
  9356. CLASS="filename"
  9357. >php.ini</TT
  9358. > in your webserver config directory.
  9359.         </P
  9360. ></LI
  9361. ><LI
  9362. ><P
  9363. >          Configure the default object in <TT
  9364. CLASS="filename"
  9365. >obj.conf</TT
  9366. >
  9367.          (for virtual server classes [SunONE 6.0+] in their <TT
  9368. CLASS="filename"
  9369. >vserver.obj.conf</TT
  9370. >):
  9371.          <TABLE
  9372. BORDER="0"
  9373. BGCOLOR="#E0E0E0"
  9374. CELLPADDING="5"
  9375. ><TR
  9376. ><TD
  9377. ><PRE
  9378. CLASS="programlisting"
  9379. ><Object name="default">
  9380. .
  9381. .
  9382. .
  9383. .#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines
  9384. Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]
  9385. .
  9386. .
  9387. </Object></PRE
  9388. ></TD
  9389. ></TR
  9390. ></TABLE
  9391. >
  9392.          (PHP >= 4.3.3) As additional parameters you can add some special <TT
  9393. CLASS="filename"
  9394. >php.ini</TT
  9395. >-values, for example you
  9396.          can set a <TT
  9397. CLASS="literal"
  9398. >docroot="/path/to/docroot"</TT
  9399. > specific to the context <TT
  9400. CLASS="literal"
  9401. >php4_execute</TT
  9402. >
  9403.          is called. For boolean ini-keys please use 0/1 as value, not <TT
  9404. CLASS="literal"
  9405. >"On","Off",...</TT
  9406. >
  9407.          (this will not work correctly), e.g. <TT
  9408. CLASS="literal"
  9409. >zlib.output_compression=1</TT
  9410. > instead of
  9411.          <TT
  9412. CLASS="literal"
  9413. >zlib.output_compression="On"</TT
  9414. >
  9415.         </P
  9416. ></LI
  9417. ><LI
  9418. ><P
  9419. >          This is only needed if you want to configure a directory that only consists of
  9420.          PHP scripts (same like a <TT
  9421. CLASS="filename"
  9422. >cgi-bin</TT
  9423. > directory):
  9424.          <TABLE
  9425. BORDER="0"
  9426. BGCOLOR="#E0E0E0"
  9427. CELLPADDING="5"
  9428. ><TR
  9429. ><TD
  9430. ><PRE
  9431. CLASS="programlisting"
  9432. ><Object name="x-httpd-php">
  9433. ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
  9434. Service fn=php4_execute [inikey=value inikey=value ...]
  9435. </Object></PRE
  9436. ></TD
  9437. ></TR
  9438. ></TABLE
  9439. >
  9440.          After that you can configure a directory in the Administration server and assign it
  9441.          the style <TT
  9442. CLASS="literal"
  9443. >x-httpd-php</TT
  9444. >. All files in it will get executed as PHP.
  9445.          This is nice to hide PHP usage by renaming files to <TT
  9446. CLASS="filename"
  9447. >.html</TT
  9448. >.
  9449.         </P
  9450. ></LI
  9451. ><LI
  9452. ><P
  9453. >          Setup of authentication: PHP authentication cannot be used with any
  9454.          other authentication. ALL AUTHENTICATION IS PASSED TO YOUR PHP SCRIPT.
  9455.          To configure PHP Authentication for the entire server, add the
  9456.          following line to your default object:
  9457.          <TABLE
  9458. BORDER="0"
  9459. BGCOLOR="#E0E0E0"
  9460. CELLPADDING="5"
  9461. ><TR
  9462. ><TD
  9463. ><PRE
  9464. CLASS="programlisting"
  9465. ><Object name="default">
  9466. AuthTrans fn=php4_auth_trans
  9467. .
  9468. .
  9469. .
  9470. </Object></PRE
  9471. ></TD
  9472. ></TR
  9473. ></TABLE
  9474. >
  9475.         </P
  9476. ></LI
  9477. ><LI
  9478. ><P
  9479. >          To use PHP Authentication on a single directory, add the following:
  9480.          <TABLE
  9481. BORDER="0"
  9482. BGCOLOR="#E0E0E0"
  9483. CELLPADDING="5"
  9484. ><TR
  9485. ><TD
  9486. ><PRE
  9487. CLASS="programlisting"
  9488. ><Object ppath="d:\path\to\authenticated\dir\*">
  9489. AuthTrans fn=php4_auth_trans
  9490. </Object></PRE
  9491. ></TD
  9492. ></TR
  9493. ></TABLE
  9494. >
  9495.         </P
  9496. ></LI
  9497. ></OL
  9498. >
  9499.      </P
  9500. ></DIV
  9501. ></DIV
  9502. ><DIV
  9503. CLASS="sect2"
  9504. ><HR><H3
  9505. CLASS="sect2"
  9506. ><A
  9507. NAME="install.netscape.windows"
  9508. ></A
  9509. >Installing PHP with NES/iPlanet/SunONE on Windows</H3
  9510. ><P
  9511. >       To Install PHP as CGI (for Netscape Enterprise Server,
  9512.       iPlanet, SunONE, perhaps Fastrack), do the following:
  9513.     </P
  9514. ><P
  9515. ></P
  9516. ><UL
  9517. ><LI
  9518. ><P
  9519. >        Copy <TT
  9520. CLASS="filename"
  9521. >php4ts.dll</TT
  9522. > to your systemroot
  9523.        (the directory where you installed Windows)
  9524.       </P
  9525. ></LI
  9526. ><LI
  9527. ><P
  9528. >        Make a file association from the command line.
  9529.        Type the following two lines:
  9530.        <TABLE
  9531. BORDER="0"
  9532. BGCOLOR="#E0E0E0"
  9533. CELLPADDING="5"
  9534. ><TR
  9535. ><TD
  9536. ><PRE
  9537. CLASS="shell"
  9538. >assoc .php=PHPScript
  9539. ftype PHPScript=c:\php\php.exe %1 %*</PRE
  9540. ></TD
  9541. ></TR
  9542. ></TABLE
  9543. >
  9544.       </P
  9545. ></LI
  9546. ><LI
  9547. ><P
  9548. >        In the Netscape Enterprise Administration Server create
  9549.        a dummy shellcgi directory and remove it just after (this
  9550.        step creates 5 important lines in obj.conf and allow the
  9551.        web server to handle shellcgi scripts).
  9552.       </P
  9553. ></LI
  9554. ><LI
  9555. ><P
  9556. >        In the Netscape Enterprise Administration Server create
  9557.        a new mime type (Category: type,
  9558.        Content-Type: magnus-internal/shellcgi, File Suffix:php).
  9559.       </P
  9560. ></LI
  9561. ><LI
  9562. ><P
  9563. >        Do it for each web server instance you want PHP to run
  9564.       </P
  9565. ></LI
  9566. ></UL
  9567. ><P
  9568. >      More details about setting up
  9569.      PHP as a CGI executable can be found here:
  9570.      <A
  9571. HREF="http://benoit.noss.free.fr/php/install-php.html"
  9572. TARGET="_top"
  9573. >http://benoit.noss.free.fr/php/install-php.html</A
  9574. >
  9575.     </P
  9576. ><P
  9577. >      To Install PHP as NSAPI (for Netscape Enterprise Server,
  9578.      iPlanet, SunONE, perhaps Fastrack), do the following:
  9579.     </P
  9580. ><P
  9581. ></P
  9582. ><UL
  9583. ><LI
  9584. ><P
  9585. >        Copy <TT
  9586. CLASS="filename"
  9587. >php4ts.dll</TT
  9588. > to your systemroot
  9589.        (the directory where you installed Windows)
  9590.       </P
  9591. ></LI
  9592. ><LI
  9593. ><P
  9594. >        Make a file association from the command line.
  9595.        Type the following two lines:
  9596.        <TABLE
  9597. BORDER="0"
  9598. BGCOLOR="#E0E0E0"
  9599. CELLPADDING="5"
  9600. ><TR
  9601. ><TD
  9602. ><PRE
  9603. CLASS="shell"
  9604. >assoc .php=PHPScript
  9605. ftype PHPScript=c:\php\php.exe %1 %*</PRE
  9606. ></TD
  9607. ></TR
  9608. ></TABLE
  9609. >
  9610.       </P
  9611. ></LI
  9612. ><LI
  9613. ><P
  9614. >        In the Netscape Enterprise Administration Server create
  9615.        a new mime type (Category: type,
  9616.        Content-Type: magnus-internal/x-httpd-php, File Suffix: php).
  9617.       </P
  9618. ></LI
  9619. ><LI
  9620. ><P
  9621. >         Edit <TT
  9622. CLASS="filename"
  9623. >magnus.conf</TT
  9624. > (for servers >= 6) or
  9625.         <TT
  9626. CLASS="filename"
  9627. >obj.conf</TT
  9628. > (for servers < 6) and add the following:
  9629.         You should
  9630.         place the the lines after <TT
  9631. CLASS="literal"
  9632. >mime types init</TT
  9633. >.
  9634.        <TABLE
  9635. BORDER="0"
  9636. BGCOLOR="#E0E0E0"
  9637. CELLPADDING="5"
  9638. ><TR
  9639. ><TD
  9640. ><PRE
  9641. CLASS="programlisting"
  9642. >Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="c:/php/sapi/php4nsapi.dll"
  9643. Init fn="php4_init" LateInit="yes" errorString="Failed to initialise PHP!" [php_ini="c:/path/to/php.ini"]</PRE
  9644. ></TD
  9645. ></TR
  9646. ></TABLE
  9647. >
  9648.        (PHP >= 4.3.3) The <TT
  9649. CLASS="literal"
  9650. >php_ini</TT
  9651. > parameter is optional but with it you can place your
  9652.        <TT
  9653. CLASS="filename"
  9654. >php.ini</TT
  9655. > in your webserver config directory.
  9656.       </P
  9657. ></LI
  9658. ><LI
  9659. ><P
  9660. >        Configure the default object in <TT
  9661. CLASS="filename"
  9662. >obj.conf</TT
  9663. >
  9664.        (for virtual server classes [SunONE 6.0+] in their <TT
  9665. CLASS="filename"
  9666. >vserver.obj.conf</TT
  9667. >):
  9668.        In the <TT
  9669. CLASS="literal"
  9670. ><Object name="default"></TT
  9671. >
  9672.        section, place this line necessarily after all 'ObjectType'
  9673.        and before all 'AddLog' lines:
  9674.        <TABLE
  9675. BORDER="0"
  9676. BGCOLOR="#E0E0E0"
  9677. CELLPADDING="5"
  9678. ><TR
  9679. ><TD
  9680. ><PRE
  9681. CLASS="programlisting"
  9682. >Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]</PRE
  9683. ></TD
  9684. ></TR
  9685. ></TABLE
  9686. >
  9687.        (PHP >= 4.3.3) As additional parameters you can add some special <TT
  9688. CLASS="filename"
  9689. >php.ini</TT
  9690. >-values, for example you
  9691.        can set a <TT
  9692. CLASS="literal"
  9693. >docroot="/path/to/docroot"</TT
  9694. > specific to the context <TT
  9695. CLASS="literal"
  9696. >php4_execute</TT
  9697. >
  9698.        is called. For boolean ini-keys please use 0/1 as value, not <TT
  9699. CLASS="literal"
  9700. >"On","Off",...</TT
  9701. >
  9702.        (this will not work correctly), e.g. <TT
  9703. CLASS="literal"
  9704. >zlib.output_compression=1</TT
  9705. > instead of
  9706.        <TT
  9707. CLASS="literal"
  9708. >zlib.output_compression="On"</TT
  9709. >
  9710.       </P
  9711. ></LI
  9712. ><LI
  9713. ><P
  9714. >        This is only needed if you want to configure a directory that only consists of
  9715.        PHP scripts (same like a cgi-bin directory):
  9716.        <TABLE
  9717. BORDER="0"
  9718. BGCOLOR="#E0E0E0"
  9719. CELLPADDING="5"
  9720. ><TR
  9721. ><TD
  9722. ><PRE
  9723. CLASS="programlisting"
  9724. ><Object name="x-httpd-php">
  9725. ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
  9726. Service fn=php4_execute [inikey=value inikey=value ...]
  9727. </Object></PRE
  9728. ></TD
  9729. ></TR
  9730. ></TABLE
  9731. >
  9732.        After that you can configure a directory in the Administration server and assign it
  9733.        the style <TT
  9734. CLASS="literal"
  9735. >x-httpd-php</TT
  9736. >. All files in it will get executed as PHP.
  9737.        This is nice to hide PHP usage by renaming files to <TT
  9738. CLASS="filename"
  9739. >.html</TT
  9740. >.
  9741.       </P
  9742. ></LI
  9743. ><LI
  9744. ><P
  9745. >        Restart your web service and apply changes
  9746.       </P
  9747. ></LI
  9748. ><LI
  9749. ><P
  9750. >        Do it for each web server instance you want PHP to run
  9751.       </P
  9752. ></LI
  9753. ></UL
  9754. ><P
  9755. >      More details about setting up
  9756.      PHP as an NSAPI filter can be found here:
  9757.      <A
  9758. HREF="http://benoit.noss.free.fr/php/install-php4.html"
  9759. TARGET="_top"
  9760. >http://benoit.noss.free.fr/php/install-php4.html</A
  9761. >
  9762.     </P
  9763. ></DIV
  9764. ><DIV
  9765. CLASS="sect2"
  9766. ><HR><H3
  9767. CLASS="sect2"
  9768. ><A
  9769. NAME="install.netscape.phpini"
  9770. ></A
  9771. >CGI environment and recommended modifications in php.ini</H3
  9772. ><P
  9773. >      Important when writing PHP scripts is the fact that iPlanet/SunONE/Netscape is a multithreaded web server.
  9774.      Because of that all requests are running in the same process space (the space of the webserver itsself) and
  9775.      this space has only one environment. If you want to get CGI variables like <TT
  9776. CLASS="literal"
  9777. >PATH_INFO</TT
  9778. >,
  9779.      <TT
  9780. CLASS="literal"
  9781. >HTTP_HOST</TT
  9782. > etc. it is not the correct way to try this in the old PHP 3.x way with
  9783.      <A
  9784. HREF="#function.getenv"
  9785. ><B
  9786. CLASS="function"
  9787. >getenv()</B
  9788. ></A
  9789. > or a similar way (register globals to environment, <TT
  9790. CLASS="literal"
  9791. >$_ENV</TT
  9792. >).
  9793.      You would only get the environment of the running webserver without any valid CGI variables!
  9794.     </P
  9795. ><DIV
  9796. CLASS="note"
  9797. ><BLOCKQUOTE
  9798. CLASS="note"
  9799. ><P
  9800. ><B
  9801. >Poznßmka: </B
  9802. >
  9803.       Why are there (invalid) CGI variables in the environment?
  9804.      </P
  9805. ><P
  9806. >       Answer: This is because you started the webserver process from the admin server which runs the startup
  9807.       script of the webserver, you wanted to start, as a CGI script
  9808.       (a CGI script inside of the admin server!). This is why the environment of the started webserver
  9809.       has some CGI environment variables in it. You can test this by
  9810.       starting the webserver not from the administration server. Use the Unix command line as root user and
  9811.       start it manually - you will see there are no CGI-like environment variables.
  9812.      </P
  9813. ></BLOCKQUOTE
  9814. ></DIV
  9815. ><P
  9816. >      Simply change your scripts to get CGI variables in the correct way for PHP 4.x by using the superglobal
  9817.      <TT
  9818. CLASS="literal"
  9819. >$_SERVER</TT
  9820. >. If you have older scripts which use <TT
  9821. CLASS="literal"
  9822. >$HTTP_HOST</TT
  9823. >,...,
  9824.      you should turn on <TT
  9825. CLASS="literal"
  9826. >register_globals</TT
  9827. > in <TT
  9828. CLASS="filename"
  9829. >php.ini</TT
  9830. > and change the variable order
  9831.      to (important: remove <TT
  9832. CLASS="literal"
  9833. >"E"</TT
  9834. > from it, because you do not need the environment here):
  9835.      <TABLE
  9836. BORDER="0"
  9837. BGCOLOR="#E0E0E0"
  9838. CELLPADDING="5"
  9839. ><TR
  9840. ><TD
  9841. ><PRE
  9842. CLASS="programlisting"
  9843. >variables_order = "GPCS"
  9844. register_globals = On</PRE
  9845. ></TD
  9846. ></TR
  9847. ></TABLE
  9848. >
  9849.     </P
  9850. ></DIV
  9851. ><DIV
  9852. CLASS="sect2"
  9853. ><HR><H3
  9854. CLASS="sect2"
  9855. ><A
  9856. NAME="install.netscape.specialpages"
  9857. ></A
  9858. >Special use for error pages or self-made directory listings (PHP >= 4.3.3)</H3
  9859. ><P
  9860. >      You can use PHP to generate the error pages for "404 Not Found"
  9861.      or similar. Add the following line to the object in <TT
  9862. CLASS="filename"
  9863. >obj.conf</TT
  9864. > for
  9865.      every error page you want to overwrite:
  9866.      <TABLE
  9867. BORDER="0"
  9868. BGCOLOR="#E0E0E0"
  9869. CELLPADDING="5"
  9870. ><TR
  9871. ><TD
  9872. ><PRE
  9873. CLASS="programlisting"
  9874. >Error fn="php4_execute" code=XXX script="/path/to/script.php" [inikey=value inikey=value...]</PRE
  9875. ></TD
  9876. ></TR
  9877. ></TABLE
  9878. >
  9879.      where <TT
  9880. CLASS="literal"
  9881. >XXX</TT
  9882. > is the HTTP error code. Please delete any other <TT
  9883. CLASS="literal"
  9884. >Error</TT
  9885. >
  9886.      directives which could interfere with yours.
  9887.      If you want to place a page for all errors that could exist, leave
  9888.      the <TT
  9889. CLASS="literal"
  9890. >code</TT
  9891. > parameter out. Your script can get the HTTP status code
  9892.      with <TT
  9893. CLASS="literal"
  9894. >$_SERVER['ERROR_TYPE']</TT
  9895. >.
  9896.     </P
  9897. ><P
  9898. >      Another possibility is to generate self-made directory listings.
  9899.      Just create a PHP script which displays a directory listing and
  9900.      replace the corresponding default Service line for
  9901.      <TT
  9902. CLASS="literal"
  9903. >type="magnus-internal/directory"</TT
  9904. > in <TT
  9905. CLASS="filename"
  9906. >obj.conf</TT
  9907. > with the following:
  9908.      <TABLE
  9909. BORDER="0"
  9910. BGCOLOR="#E0E0E0"
  9911. CELLPADDING="5"
  9912. ><TR
  9913. ><TD
  9914. ><PRE
  9915. CLASS="programlisting"
  9916. >Service fn="php4_execute" type="magnus-internal/directory" script="/path/to/script.php" [inikey=value inikey=value...]</PRE
  9917. ></TD
  9918. ></TR
  9919. ></TABLE
  9920. >
  9921.      For both error and directory listing pages the original URI and
  9922.      translated URI are in the variables <TT
  9923. CLASS="literal"
  9924. >$_SERVER['PATH_INFO']</TT
  9925. > and
  9926.      <TT
  9927. CLASS="literal"
  9928. >$_SERVER['PATH_TRANSLATED']</TT
  9929. >.
  9930.     </P
  9931. ></DIV
  9932. ><DIV
  9933. CLASS="sect2"
  9934. ><HR><H3
  9935. CLASS="sect2"
  9936. ><A
  9937. NAME="install.netscape.notes"
  9938. ></A
  9939. >Note about <A
  9940. HREF="#function.nsapi-virtual"
  9941. ><B
  9942. CLASS="function"
  9943. >nsapi_virtual()</B
  9944. ></A
  9945. > and subrequests (PHP >= 4.3.3)</H3
  9946. ><P
  9947. >      The NSAPI module now supports the <A
  9948. HREF="#function.nsapi-virtual"
  9949. ><B
  9950. CLASS="function"
  9951. >nsapi_virtual()</B
  9952. ></A
  9953. > function
  9954.      (alias: <A
  9955. HREF="#function.virtual"
  9956. ><B
  9957. CLASS="function"
  9958. >virtual()</B
  9959. ></A
  9960. >)
  9961.      to make subrequests on the webserver and insert the result in the webpage.
  9962.      The problem is, that this function uses some undocumented features from
  9963.      the NSAPI library.
  9964.     </P
  9965. ><P
  9966. >      Under Unix this is not a problem, because the module automatically looks
  9967.      for the needed functions and uses them if available. If not, <A
  9968. HREF="#function.nsapi-virtual"
  9969. ><B
  9970. CLASS="function"
  9971. >nsapi_virtual()</B
  9972. ></A
  9973. >
  9974.      is disabled.
  9975.     </P
  9976. ><P
  9977. >      Under Windows limitations in the DLL handling need the use of a automatic
  9978.      detection of the most recent <TT
  9979. CLASS="filename"
  9980. >ns-httpdXX.dll</TT
  9981. > file. This is tested for servers
  9982.      till version 6.1. If a newer version of the SunONE server is used, the detection
  9983.      fails and <A
  9984. HREF="#function.nsapi-virtual"
  9985. ><B
  9986. CLASS="function"
  9987. >nsapi_virtual()</B
  9988. ></A
  9989. > is disabled.
  9990.     </P
  9991. ><P
  9992. >      If this is the case, try the following:
  9993.      Add the following parameter to <TT
  9994. CLASS="literal"
  9995. >php4_init</TT
  9996. > in
  9997.      <TT
  9998. CLASS="filename"
  9999. >magnus.conf</TT
  10000. >/<TT
  10001. CLASS="filename"
  10002. >obj.conf</TT
  10003. >:
  10004.      <TABLE
  10005. BORDER="0"
  10006. BGCOLOR="#E0E0E0"
  10007. CELLPADDING="5"
  10008. ><TR
  10009. ><TD
  10010. ><PRE
  10011. CLASS="programlisting"
  10012. >Init fn=php4_init ... server_lib="ns-httpdXX.dll"</PRE
  10013. ></TD
  10014. ></TR
  10015. ></TABLE
  10016. >
  10017.      where <TT
  10018. CLASS="literal"
  10019. >XX</TT
  10020. > is the correct DLL version number. To get it, look in the server-root
  10021.      for the correct DLL name. The DLL with the biggest filesize is the right one.
  10022.     </P
  10023. ><P
  10024. >      You can check the status by using the <A
  10025. HREF="#function.phpinfo"
  10026. ><B
  10027. CLASS="function"
  10028. >phpinfo()</B
  10029. ></A
  10030. > function.
  10031.     </P
  10032. ><DIV
  10033. CLASS="note"
  10034. ><BLOCKQUOTE
  10035. CLASS="note"
  10036. ><P
  10037. ><B
  10038. >Poznßmka: </B
  10039. >
  10040.       But be warned: Support for <A
  10041. HREF="#function.nsapi-virtual"
  10042. ><B
  10043. CLASS="function"
  10044. >nsapi_virtual()</B
  10045. ></A
  10046. > is EXPERIMENTAL!!!
  10047.      </P
  10048. ></BLOCKQUOTE
  10049. ></DIV
  10050. ></DIV
  10051. ></DIV
  10052. ><DIV
  10053. CLASS="sect1"
  10054. ><HR><H2
  10055. CLASS="sect1"
  10056. ><A
  10057. NAME="install.omnihttpd"
  10058. ></A
  10059. >Servers-OmniHTTPd Server</H2
  10060. ><P
  10061. >     This section contains notes and hints specific to
  10062.     <A
  10063. HREF="http://www.omnicron.ca/"
  10064. TARGET="_top"
  10065. >OmniHTTPd</A
  10066. >.
  10067.    </P
  10068. ><DIV
  10069. CLASS="sect2"
  10070. ><HR><H3
  10071. CLASS="sect2"
  10072. ><A
  10073. NAME="install.omnihttpd.windows"
  10074. ></A
  10075. >OmniHTTPd 2.0b1 and up for Windows</H3
  10076. ><P
  10077. >      You need to complete the following steps to make PHP
  10078.      work with OmniHTTPd. This is a CGI executable setup.
  10079.      SAPI is supported by OmniHTTPd, but some tests have shown
  10080.      that it is not so stable to use PHP as an ISAPI module.
  10081.     </P
  10082. ><DIV
  10083. CLASS="note"
  10084. ><BLOCKQUOTE
  10085. CLASS="note"
  10086. ><P
  10087. ><B
  10088. >Important for CGI users: </B
  10089. >
  10090.       Read the <A
  10091. HREF="#faq.installation.forceredirect"
  10092. >faq
  10093.       on cgi.force_redirect</A
  10094. > for important details.  This
  10095.       directive needs to be set to <TT
  10096. CLASS="literal"
  10097. >0</TT
  10098. >.
  10099.      </P
  10100. ></BLOCKQUOTE
  10101. ></DIV
  10102. ><P
  10103. >      <P
  10104. ></P
  10105. ><OL
  10106. TYPE="1"
  10107. ><LI
  10108. ><P
  10109. >         Install OmniHTTPd server.
  10110.        </P
  10111. ></LI
  10112. ><LI
  10113. ><P
  10114. >         Right click on the blue OmniHTTPd icon in the system
  10115.         tray and select <TT
  10116. CLASS="literal"
  10117. >Properties</TT
  10118. >
  10119.        </P
  10120. ></LI
  10121. ><LI
  10122. ><P
  10123. >         Click on <TT
  10124. CLASS="literal"
  10125. >Web Server Global Settings</TT
  10126. >
  10127.        </P
  10128. ></LI
  10129. ><LI
  10130. ><P
  10131. >         On the 'External' tab, enter: <TT
  10132. CLASS="literal"
  10133. >virtual = .php
  10134.          | actual = c:\path-to-php-dir\php.exe</TT
  10135. >, and use the Add
  10136.         button.
  10137.        </P
  10138. ></LI
  10139. ><LI
  10140. ><P
  10141. >         On the <TT
  10142. CLASS="literal"
  10143. >Mime</TT
  10144. > tab, enter:
  10145.         <TT
  10146. CLASS="literal"
  10147. >virtual = wwwserver/stdcgi | actual = .php</TT
  10148. >,
  10149.         and use the Add button.
  10150.        </P
  10151. ></LI
  10152. ><LI
  10153. ><P
  10154. >         Click <TT
  10155. CLASS="literal"
  10156. >OK</TT
  10157. >
  10158.        </P
  10159. ></LI
  10160. ></OL
  10161. >
  10162.     </P
  10163. ><P
  10164. >      Repeat steps 2 - 6 for each extension you want to associate with PHP.
  10165.     </P
  10166. ><DIV
  10167. CLASS="note"
  10168. ><BLOCKQUOTE
  10169. CLASS="note"
  10170. ><P
  10171. ><B
  10172. >Poznßmka: </B
  10173. >
  10174.       Some OmniHTTPd packages come with built in PHP support.
  10175.       You can choose at setup time to do a custom setup, and
  10176.       uncheck the PHP component. We recommend you to use the latest
  10177.       PHP binaries. Some OmniHTTPd servers come with PHP 4 beta
  10178.       distributions, so you should choose not to set up
  10179.       the built in support, but install your own. If the server
  10180.       is already on your machine, use the Replace button in Step
  10181.       4 and 5 to set the new, correct information.
  10182.      </P
  10183. ></BLOCKQUOTE
  10184. ></DIV
  10185. ></DIV
  10186. ></DIV
  10187. ><DIV
  10188. CLASS="sect1"
  10189. ><HR><H2
  10190. CLASS="sect1"
  10191. ><A
  10192. NAME="install.oreilly"
  10193. ></A
  10194. >Servers-Oreilly Website Pro</H2
  10195. ><P
  10196. >     This section contains notes and hints specific to Oreilly
  10197.     Website Pro.
  10198.    </P
  10199. ><DIV
  10200. CLASS="sect2"
  10201. ><HR><H3
  10202. CLASS="sect2"
  10203. ><A
  10204. NAME="install.oreilly.windows"
  10205. ></A
  10206. >Oreilly Website Pro 2.5 and up for Windows</H3
  10207. ><P
  10208. >      This list describes how to set up the PHP CGI binary
  10209.      or the ISAPI module to work with Oreilly Website Pro
  10210.      on Windows.
  10211.     </P
  10212. ><P
  10213. >      <P
  10214. ></P
  10215. ><UL
  10216. ><LI
  10217. ><P
  10218. >         Edit the Server Properties and select the tab "Mapping".
  10219.        </P
  10220. ></LI
  10221. ><LI
  10222. ><P
  10223. >         From the List select "Associations" and enter the desired
  10224.         extension (<TT
  10225. CLASS="literal"
  10226. >.php</TT
  10227. >) and the path to the CGI exe
  10228.         (ex. <TT
  10229. CLASS="filename"
  10230. >c:\php\php.exe</TT
  10231. >) or the ISAPI DLL file
  10232.         (ex. <TT
  10233. CLASS="filename"
  10234. >c:\php\sapi\php4isapi.dll</TT
  10235. >).
  10236.        </P
  10237. ></LI
  10238. ><LI
  10239. ><P
  10240. >         Select "Content Types" add the same extension
  10241.         (<TT
  10242. CLASS="literal"
  10243. >.php</TT
  10244. >) and enter the content type.
  10245.         If you choose the CGI executable file, enter
  10246.         'wwwserver/shellcgi', if you choose the ISAPI module,
  10247.         enter 'wwwserver/isapi' (both without quotes).
  10248.        </P
  10249. ></LI
  10250. ></UL
  10251. >
  10252.     </P
  10253. ></DIV
  10254. ></DIV
  10255. ><DIV
  10256. CLASS="sect1"
  10257. ><HR><H2
  10258. CLASS="sect1"
  10259. ><A
  10260. NAME="install.sambar"
  10261. ></A
  10262. >Servers-Sambar</H2
  10263. ><P
  10264. >     This section contains notes and hints specific to the
  10265.     <A
  10266. HREF="http://www.sambar.com/"
  10267. TARGET="_top"
  10268. >Sambar server</A
  10269. > for Windows.
  10270.    </P
  10271. ><DIV
  10272. CLASS="sect2"
  10273. ><HR><H3
  10274. CLASS="sect2"
  10275. ><A
  10276. NAME="install.sambar.windows"
  10277. ></A
  10278. >Sambar Windows</H3
  10279. ><P
  10280. >      This list describes how to set up the ISAPI module to
  10281.      work with the Sambar server on Windows.
  10282.     </P
  10283. ><P
  10284. >      <P
  10285. ></P
  10286. ><UL
  10287. ><LI
  10288. ><P
  10289. >         Find the file called <TT
  10290. CLASS="filename"
  10291. >mappings.ini</TT
  10292. > (in the config
  10293.         directory) in the Sambar install directory.
  10294.        </P
  10295. ></LI
  10296. ><LI
  10297. ><P
  10298. >         Open <TT
  10299. CLASS="filename"
  10300. >mappings.ini</TT
  10301. > and add the following line
  10302.         under <TT
  10303. CLASS="literal"
  10304. >[ISAPI]</TT
  10305. >:
  10306.         <DIV
  10307. CLASS="informalexample"
  10308. ><A
  10309. NAME="AEN2009"
  10310. ></A
  10311. ><P
  10312. ></P
  10313. ><TABLE
  10314. BORDER="0"
  10315. BGCOLOR="#E0E0E0"
  10316. CELLPADDING="5"
  10317. ><TR
  10318. ><TD
  10319. ><PRE
  10320. CLASS="screen"
  10321. >*.php = c:\php\php4isapi.dll</PRE
  10322. ></TD
  10323. ></TR
  10324. ></TABLE
  10325. ><P
  10326. ></P
  10327. ></DIV
  10328. >
  10329.         (This line assumes that PHP was installed in
  10330.         <TT
  10331. CLASS="literal"
  10332. >c:\php</TT
  10333. >.)
  10334.        </P
  10335. ></LI
  10336. ><LI
  10337. ><P
  10338. >         Now restart the Sambar server for the changes to take effect.
  10339.        </P
  10340. ></LI
  10341. ></UL
  10342. >
  10343.     </P
  10344. ></DIV
  10345. ></DIV
  10346. ><DIV
  10347. CLASS="sect1"
  10348. ><HR><H2
  10349. CLASS="sect1"
  10350. ><A
  10351. NAME="install.xitami"
  10352. ></A
  10353. >Servers-Xitami</H2
  10354. ><P
  10355. >     This section contains notes and hints specific to
  10356.     <A
  10357. HREF="http://www.xitami.com/"
  10358. TARGET="_top"
  10359. >Xitami</A
  10360. >.
  10361.    </P
  10362. ><DIV
  10363. CLASS="sect2"
  10364. ><HR><H3
  10365. CLASS="sect2"
  10366. ><A
  10367. NAME="install.xitami.windows"
  10368. ></A
  10369. >Xitami for Windows</H3
  10370. ><P
  10371. >      This list describes how to set up the PHP CGI binary
  10372.      to work with Xitami on Windows.
  10373.     </P
  10374. ><DIV
  10375. CLASS="note"
  10376. ><BLOCKQUOTE
  10377. CLASS="note"
  10378. ><P
  10379. ><B
  10380. >Important for CGI users: </B
  10381. >
  10382.       Read the <A
  10383. HREF="#faq.installation.forceredirect"
  10384. >faq
  10385.       on cgi.force_redirect</A
  10386. > for important details.  This
  10387.       directive needs to be set to <TT
  10388. CLASS="literal"
  10389. >0</TT
  10390. >.
  10391.      </P
  10392. ></BLOCKQUOTE
  10393. ></DIV
  10394. ><P
  10395. >      <P
  10396. ></P
  10397. ><UL
  10398. ><LI
  10399. ><P
  10400. >         Make sure the webserver is running, and point
  10401.         your browser to xitamis admin console
  10402.         (usually <TT
  10403. CLASS="literal"
  10404. >http://127.0.0.1/admin</TT
  10405. >),
  10406.         and click on Configuration.
  10407.        </P
  10408. ></LI
  10409. ><LI
  10410. ><P
  10411. >         Navigate to the Filters, and put the
  10412.         extension which PHP should parse (i.e. .php)
  10413.         into the field File extensions (.xxx).
  10414.        </P
  10415. ></LI
  10416. ><LI
  10417. ><P
  10418. >         In Filter command or script put the path and name
  10419.         of your PHP executable i.e. <TT
  10420. CLASS="literal"
  10421. >c:\php\php.exe</TT
  10422. >.
  10423.        </P
  10424. ></LI
  10425. ><LI
  10426. ><P
  10427. >         Press the 'Save' icon.
  10428.        </P
  10429. ></LI
  10430. ><LI
  10431. ><P
  10432. >         Restart the server to reflect changes.
  10433.        </P
  10434. ></LI
  10435. ></UL
  10436. >
  10437.     </P
  10438. ></DIV
  10439. ></DIV
  10440. ><DIV
  10441. CLASS="sect1"
  10442. ><HR><H2
  10443. CLASS="sect1"
  10444. ><A
  10445. NAME="install.otherhttpd"
  10446. ></A
  10447. >Servers-Other web servers</H2
  10448. ><P
  10449. >     PHP can be built to support a large number of web servers. Please
  10450.  
  10451.     see Server-related
  10452.     options for a full list of server-related configure
  10453.     options. The PHP CGI binaries are compatible with almost all
  10454.     webservers supporting the CGI standard.
  10455.    </P
  10456. ></DIV
  10457. ><DIV
  10458. CLASS="sect1"
  10459. ><HR><H2
  10460. CLASS="sect1"
  10461. ><A
  10462. NAME="install.problems"
  10463. ></A
  10464. >Problems?</H2
  10465. ><DIV
  10466. CLASS="sect2"
  10467. ><H3
  10468. CLASS="sect2"
  10469. ><A
  10470. NAME="AEN2045"
  10471. ></A
  10472. >Read the FAQ</H3
  10473. ><P
  10474. >      Some problems are more common than others. The most
  10475.      common ones are listed in the <A
  10476. HREF="#faq"
  10477. >PHP
  10478.      FAQ</A
  10479. >, part of this manual.
  10480.     </P
  10481. ></DIV
  10482. ><DIV
  10483. CLASS="sect2"
  10484. ><HR><H3
  10485. CLASS="sect2"
  10486. ><A
  10487. NAME="install.otherproblems"
  10488. ></A
  10489. >Other problems</H3
  10490. ><P
  10491. >      If you are still stuck, someone on the PHP installation mailing list may be
  10492.      able to help you. You should check out the archive first, in case
  10493.      someone already answered someone else who had the same problem as
  10494.      you. The archives are available from the support page on <A
  10495. HREF="http://www.php.net/support.php"
  10496. TARGET="_top"
  10497. >http://www.php.net/support.php</A
  10498. >. To subscribe to the PHP installation
  10499.      mailing list, send an empty mail to <A
  10500. HREF="mailto:php-install-subscribe@lists.php.net"
  10501. TARGET="_top"
  10502. >php-install-subscribe@lists.php.net</A
  10503. >.
  10504.      The mailing list address is <A
  10505. HREF="mailto:php-install@lists.php.net"
  10506. TARGET="_top"
  10507. >php-install@lists.php.net</A
  10508. >.
  10509.     </P
  10510. ><P
  10511. >      If you want to get help on the mailing list, please try to be
  10512.      precise and give the necessary details about your environment
  10513.      (which operating system, what PHP version, what web server, if
  10514.      you are running PHP as CGI or a server module, <A
  10515. HREF="#ini.safe-mode"
  10516. >bezpeΦn² re╛im</A
  10517. >, etc...), and
  10518.      preferably enough code to make others able to reproduce and test
  10519.      your problem.
  10520.     </P
  10521. ></DIV
  10522. ><DIV
  10523. CLASS="sect2"
  10524. ><HR><H3
  10525. CLASS="sect2"
  10526. ><A
  10527. NAME="install.bugreports"
  10528. ></A
  10529. >Bug reports</H3
  10530. ><P
  10531. >      If you think you have found a bug in PHP, please report it.  The
  10532.      PHP developers probably don't know about it, and unless you
  10533.      report it, chances are it won't be fixed. You can report bugs
  10534.      using the bug-tracking system at <A
  10535. HREF="http://bugs.php.net/"
  10536. TARGET="_top"
  10537. >http://bugs.php.net/</A
  10538. >. Please do not
  10539.      send bug reports in mailing list or personal letters. The
  10540.      bug system is also suitable to submit feature requests.
  10541.     </P
  10542. ><P
  10543. >      Read the <A
  10544. HREF="http://bugs.php.net/how-to-report.php"
  10545. TARGET="_top"
  10546. >How to report a bug</A
  10547. > 
  10548.      document before submitting any bug reports!
  10549.     </P
  10550. ></DIV
  10551. ></DIV
  10552. ><DIV
  10553. CLASS="sect1"
  10554. ><HR><H2
  10555. CLASS="sect1"
  10556. ><A
  10557. NAME="install.configure"
  10558. ></A
  10559. >Miscellaneous configure options</H2
  10560. ><P
  10561. >   Below is a partial list of configure options used by the PHP
  10562.   <TT
  10563. CLASS="filename"
  10564. >configure</TT
  10565. > scripts when compiling in Unix-like
  10566.   environments.  Most configure options are listed in their appropriate
  10567.   locations and not here.  For a complete up-to-date list of configure
  10568.   options, run <B
  10569. CLASS="command"
  10570. >./configure --help</B
  10571. > in your PHP source
  10572.   directory after running <B
  10573. CLASS="command"
  10574. >autoconf</B
  10575. > (see also the
  10576.   <A
  10577. HREF="#installation"
  10578. >Installation chapter</A
  10579. >).  You may also
  10580.   be interested in reading the
  10581.   <A
  10582. HREF="http://www.airs.com/ian/configure/"
  10583. TARGET="_top"
  10584. >GNU configure</A
  10585. > documentation for
  10586.   information on additional <B
  10587. CLASS="command"
  10588. >configure</B
  10589. > options such as
  10590.   <TT
  10591. CLASS="literal"
  10592. >--prefix=PREFIX</TT
  10593. >.
  10594.  </P
  10595. ><DIV
  10596. CLASS="note"
  10597. ><BLOCKQUOTE
  10598. CLASS="note"
  10599. ><P
  10600. ><B
  10601. >Poznßmka: </B
  10602. >
  10603.    These are only used at compile time. If you want to alter PHP's
  10604.    runtime configuration, please see the chapter on <A
  10605. HREF="#configuration"
  10606. >Runtime Configuration</A
  10607. >.
  10608.   </P
  10609. ></BLOCKQUOTE
  10610. ></DIV
  10611. ><P
  10612. ></P
  10613. ><UL
  10614. ><LI
  10615. ><P
  10616. >     <A
  10617. HREF="#install.configure.options.graphics"
  10618. >Graphics</A
  10619. >
  10620.    </P
  10621. ></LI
  10622. ><LI
  10623. ><P
  10624. >     <A
  10625. HREF="#install.configure.options.misc"
  10626. >Miscellaneous</A
  10627. >
  10628.    </P
  10629. ></LI
  10630. ><LI
  10631. ><P
  10632. >     <A
  10633. HREF="#install.configure.options.php"
  10634. >PHP Behaviour</A
  10635. >
  10636.    </P
  10637. ></LI
  10638. ><LI
  10639. ><P
  10640. >     <A
  10641. HREF="#install.configure.options.servers"
  10642. >Server</A
  10643. >
  10644.    </P
  10645. ></LI
  10646. ></UL
  10647. ><DIV
  10648. CLASS="sect2"
  10649. ><HR><H3
  10650. CLASS="sect2"
  10651. ><A
  10652. NAME="install.configure.options"
  10653. ></A
  10654. >Configure Options in PHP 4</H3
  10655. ><DIV
  10656. CLASS="note"
  10657. ><BLOCKQUOTE
  10658. CLASS="note"
  10659. ><P
  10660. ><B
  10661. >Poznßmka: </B
  10662. >
  10663.    These options are only used in PHP 4 as of PHP 4.1.0. 
  10664.    Some are available in older versions of PHP 4, some even in PHP 3, some only in PHP 4.1.0.
  10665.    If you want to compile an older version, some options will probably 
  10666.    not be available.
  10667.   </P
  10668. ></BLOCKQUOTE
  10669. ></DIV
  10670. ><DIV
  10671. CLASS="sect3"
  10672. ><HR><H4
  10673. CLASS="sect3"
  10674. ><A
  10675. NAME="install.configure.options.graphics"
  10676. ></A
  10677. >Graphics options</H4
  10678. ><P
  10679. ></P
  10680. ><DIV
  10681. CLASS="variablelist"
  10682. ><DL
  10683. ><DT
  10684. ><A
  10685. NAME="install.configure.with-imagick"
  10686. ></A
  10687. ><TT
  10688. CLASS="parameter"
  10689. ><I
  10690. >--with-imagick</I
  10691. ></TT
  10692. ></DT
  10693. ><DD
  10694. ><P
  10695. >       The imagick extension has been moved to PECL in PEAR and can be found 
  10696.       at <A
  10697. HREF="http://pear.php.net/imagick"
  10698. TARGET="_top"
  10699. >http://pear.php.net/imagick</A
  10700. >.  Install instructions
  10701.       for PHP 4 can be found on the PEAR site.
  10702.      </P
  10703. ><P
  10704. >       Simply doing <TT
  10705. CLASS="literal"
  10706. >--with-imagick</TT
  10707. > is only supported
  10708.       in PHP 3 unless you follow the instructions found on the PEAR site.
  10709.      </P
  10710. ></DD
  10711. ></DL
  10712. ></DIV
  10713. ></DIV
  10714. ><DIV
  10715. CLASS="sect3"
  10716. ><HR><H4
  10717. CLASS="sect3"
  10718. ><A
  10719. NAME="install.configure.options.misc"
  10720. ></A
  10721. >Misc options</H4
  10722. ><P
  10723. ></P
  10724. ><DIV
  10725. CLASS="variablelist"
  10726. ><DL
  10727. ><DT
  10728. ><A
  10729. NAME="install.configure.enable-debug"
  10730. ></A
  10731. ><TT
  10732. CLASS="parameter"
  10733. ><I
  10734. >--enable-debug</I
  10735. ></TT
  10736. ></DT
  10737. ><DD
  10738. ><P
  10739. >       Compile with debugging symbols.
  10740.      </P
  10741. ></DD
  10742. ><DT
  10743. ><A
  10744. NAME="install.configure.with-layout"
  10745. ></A
  10746. ><TT
  10747. CLASS="parameter"
  10748. ><I
  10749. >--with-layout=TYPE</I
  10750. ></TT
  10751. ></DT
  10752. ><DD
  10753. ><P
  10754. >       Sets how installed files will be laid out. Type is one of PHP (default) 
  10755. or GNU.
  10756.      </P
  10757. ></DD
  10758. ><DT
  10759. ><A
  10760. NAME="install.configure.with-pear"
  10761. ></A
  10762. ><TT
  10763. CLASS="parameter"
  10764. ><I
  10765. >--with-pear=DIR</I
  10766. ></TT
  10767. ></DT
  10768. ><DD
  10769. ><P
  10770. >       Install PEAR in DIR (default PREFIX/lib/php).
  10771.      </P
  10772. ></DD
  10773. ><DT
  10774. ><A
  10775. NAME="install.configure.without-pear"
  10776. ></A
  10777. ><TT
  10778. CLASS="parameter"
  10779. ><I
  10780. >--without-pear</I
  10781. ></TT
  10782. ></DT
  10783. ><DD
  10784. ><P
  10785. >       Do not install PEAR.
  10786.      </P
  10787. ></DD
  10788. ><DT
  10789. ><A
  10790. NAME="install.configure.enable-sigchild"
  10791. ></A
  10792. ><TT
  10793. CLASS="parameter"
  10794. ><I
  10795. >--enable-sigchild</I
  10796. ></TT
  10797. ></DT
  10798. ><DD
  10799. ><P
  10800. >       Enable PHP's own SIGCHLD handler.
  10801.      </P
  10802. ></DD
  10803. ><DT
  10804. ><A
  10805. NAME="install.configure.disable-rpath"
  10806. ></A
  10807. ><TT
  10808. CLASS="parameter"
  10809. ><I
  10810. >--disable-rpath</I
  10811. ></TT
  10812. ></DT
  10813. ><DD
  10814. ><P
  10815. >       Disable passing additional runtime library search paths.
  10816.      </P
  10817. ></DD
  10818. ><DT
  10819. ><A
  10820. NAME="install.configure.enable-libgcc"
  10821. ></A
  10822. ><TT
  10823. CLASS="parameter"
  10824. ><I
  10825. >--enable-libgcc</I
  10826. ></TT
  10827. ></DT
  10828. ><DD
  10829. ><P
  10830. >       Enable explicitly linking against libgcc.
  10831.      </P
  10832. ></DD
  10833. ><DT
  10834. ><A
  10835. NAME="install.configure.enable-php-streams"
  10836. ></A
  10837. ><TT
  10838. CLASS="parameter"
  10839. ><I
  10840. >--enable-php-streams</I
  10841. ></TT
  10842. ></DT
  10843. ><DD
  10844. ><P
  10845. >       Include experimental PHP streams. Do not use unless you are testing the 
  10846. code!
  10847.      </P
  10848. ></DD
  10849. ><DT
  10850. ><A
  10851. NAME="install.configure.with-zlib-dir"
  10852. ></A
  10853. ><TT
  10854. CLASS="parameter"
  10855. ><I
  10856. >--with-zlib-dir=<DIR></I
  10857. ></TT
  10858. ></DT
  10859. ><DD
  10860. ><P
  10861. >       Define the location of zlib install directory.
  10862.      </P
  10863. ></DD
  10864. ><DT
  10865. ><A
  10866. NAME="install.configure.enable-trans-sid"
  10867. ></A
  10868. ><TT
  10869. CLASS="parameter"
  10870. ><I
  10871. >--enable-trans-sid</I
  10872. ></TT
  10873. ></DT
  10874. ><DD
  10875. ><P
  10876. >       Enable transparent session id propagation. Only valid for PHP 4.1.2 or
  10877.       less. From PHP 4.2.0, trans-sid feature is always compiled.
  10878.      </P
  10879. ></DD
  10880. ><DT
  10881. ><A
  10882. NAME="install.configure.with-tsrm-pthreads"
  10883. ></A
  10884. ><TT
  10885. CLASS="parameter"
  10886. ><I
  10887. >--with-tsrm-pthreads</I
  10888. ></TT
  10889. ></DT
  10890. ><DD
  10891. ><P
  10892. >       Use POSIX threads (default).
  10893.      </P
  10894. ></DD
  10895. ><DT
  10896. ><A
  10897. NAME="install.configure.enable-shared"
  10898. ></A
  10899. ><TT
  10900. CLASS="parameter"
  10901. ><I
  10902. >--enable-shared[=PKGS]</I
  10903. ></TT
  10904. ></DT
  10905. ><DD
  10906. ><P
  10907. >       Build shared libraries [default=yes].
  10908.      </P
  10909. ></DD
  10910. ><DT
  10911. ><A
  10912. NAME="install.configure.enable-static"
  10913. ></A
  10914. ><TT
  10915. CLASS="parameter"
  10916. ><I
  10917. >--enable-static[=PKGS]</I
  10918. ></TT
  10919. ></DT
  10920. ><DD
  10921. ><P
  10922. >       Build static libraries [default=yes].
  10923.      </P
  10924. ></DD
  10925. ><DT
  10926. ><A
  10927. NAME="install.configure.enable-fast-install"
  10928. ></A
  10929. ><TT
  10930. CLASS="parameter"
  10931. ><I
  10932. >--enable-fast-install[=PKGS]</I
  10933. ></TT
  10934. ></DT
  10935. ><DD
  10936. ><P
  10937. >       Optimize for fast installation [default=yes].
  10938.      </P
  10939. ></DD
  10940. ><DT
  10941. ><A
  10942. NAME="install.configure.with-gnu-ld"
  10943. ></A
  10944. ><TT
  10945. CLASS="parameter"
  10946. ><I
  10947. >--with-gnu-ld</I
  10948. ></TT
  10949. ></DT
  10950. ><DD
  10951. ><P
  10952. >       Assume the C compiler uses GNU ld [default=no].
  10953.      </P
  10954. ></DD
  10955. ><DT
  10956. ><A
  10957. NAME="install.configure.disable-libtool-lock"
  10958. ></A
  10959. ><TT
  10960. CLASS="parameter"
  10961. ><I
  10962. >--disable-libtool-lock</I
  10963. ></TT
  10964. ></DT
  10965. ><DD
  10966. ><P
  10967. >       Avoid locking (might break parallel builds).
  10968.      </P
  10969. ></DD
  10970. ><DT
  10971. ><A
  10972. NAME="install.configure.with-pic"
  10973. ></A
  10974. ><TT
  10975. CLASS="parameter"
  10976. ><I
  10977. >--with-pic</I
  10978. ></TT
  10979. ></DT
  10980. ><DD
  10981. ><P
  10982. >       Try to use only PIC/non-PIC objects [default=use both].
  10983.      </P
  10984. ></DD
  10985. ><DT
  10986. ><A
  10987. NAME="install.configure.enable-memory-limit"
  10988. ></A
  10989. ><TT
  10990. CLASS="parameter"
  10991. ><I
  10992. >--enable-memory-limit</I
  10993. ></TT
  10994. ></DT
  10995. ><DD
  10996. ><P
  10997. >       Compile with memory limit support.
  10998.      </P
  10999. ></DD
  11000. ><DT
  11001. ><A
  11002. NAME="install.configure.disable-url-fopen-wrapper"
  11003. ></A
  11004. ><TT
  11005. CLASS="parameter"
  11006. ><I
  11007. >--disable-url-fopen-wrapper</I
  11008. ></TT
  11009. ></DT
  11010. ><DD
  11011. ><P
  11012. >       Disable the URL-aware fopen wrapper that allows
  11013.       accessing files via HTTP or FTP.
  11014.      </P
  11015. ></DD
  11016. ><DT
  11017. ><A
  11018. NAME="install.configure.enable-versioning.php4"
  11019. ></A
  11020. ><TT
  11021. CLASS="parameter"
  11022. ><I
  11023. >--enable-versioning</I
  11024. ></TT
  11025. ></DT
  11026. ><DD
  11027. ><P
  11028. >       Export only required symbols.
  11029.       See INSTALL for more information.
  11030.      </P
  11031. ></DD
  11032. ><DT
  11033. ><A
  11034. NAME="install.configure.with-ismp"
  11035. ></A
  11036. ><TT
  11037. CLASS="parameter"
  11038. ><I
  11039. >--with-imsp[=DIR]</I
  11040. ></TT
  11041. ></DT
  11042. ><DD
  11043. ><P
  11044. >       Include IMSp support (DIR is IMSP's include dir and libimsp.a dir).
  11045.       PHP 3 only!
  11046.      </P
  11047. ></DD
  11048. ><DT
  11049. ><A
  11050. NAME="install.configure.with-mck"
  11051. ></A
  11052. ><TT
  11053. CLASS="parameter"
  11054. ><I
  11055. >--with-mck[=DIR]</I
  11056. ></TT
  11057. ></DT
  11058. ><DD
  11059. ><P
  11060. >       Include Cybercash MCK support. DIR is the cybercash
  11061.       mck build directory, defaults to
  11062.       /usr/src/mck-3.2.0.3-linux for help look in
  11063.       extra/cyberlib. PHP 3 only!
  11064.      </P
  11065. ></DD
  11066. ><DT
  11067. ><A
  11068. NAME="install.configure.with-mod-dav"
  11069. ></A
  11070. ><TT
  11071. CLASS="parameter"
  11072. ><I
  11073. >--with-mod-dav=DIR</I
  11074. ></TT
  11075. ></DT
  11076. ><DD
  11077. ><P
  11078. >       Include DAV support through Apache's mod_dav,
  11079.       DIR is mod_dav's installation directory (Apache
  11080.       module version only!) PHP 3 only!
  11081.      </P
  11082. ></DD
  11083. ><DT
  11084. ><A
  11085. NAME="install.configure.enable-debugger"
  11086. ></A
  11087. ><TT
  11088. CLASS="parameter"
  11089. ><I
  11090. >--enable-debugger</I
  11091. ></TT
  11092. ></DT
  11093. ><DD
  11094. ><P
  11095. >       Compile with remote debugging functions. PHP 3 only!
  11096.      </P
  11097. ></DD
  11098. ><DT
  11099. ><A
  11100. NAME="install.configure.enable-versioning.php3"
  11101. ></A
  11102. ><TT
  11103. CLASS="parameter"
  11104. ><I
  11105. >--enable-versioning</I
  11106. ></TT
  11107. ></DT
  11108. ><DD
  11109. ><P
  11110. >       Take advantage of versioning and scoping
  11111.       provided by Solaris 2.x and Linux. PHP 3 only!
  11112.      </P
  11113. ></DD
  11114. ></DL
  11115. ></DIV
  11116. ></DIV
  11117. ><DIV
  11118. CLASS="sect3"
  11119. ><HR><H4
  11120. CLASS="sect3"
  11121. ><A
  11122. NAME="install.configure.options.php"
  11123. ></A
  11124. >PHP options</H4
  11125. ><P
  11126. ></P
  11127. ><DIV
  11128. CLASS="variablelist"
  11129. ><DL
  11130. ><DT
  11131. ><A
  11132. NAME="install.configure.enable-maintainer-mode"
  11133. ></A
  11134. ><TT
  11135. CLASS="parameter"
  11136. ><I
  11137. >--enable-maintainer-mode</I
  11138. ></TT
  11139. ></DT
  11140. ><DD
  11141. ><P
  11142. >       Enable make rules and dependencies not useful (and sometimes confusing) 
  11143.       to the casual installer.
  11144.      </P
  11145. ></DD
  11146. ><DT
  11147. ><A
  11148. NAME="install.configure.with-config-file-path"
  11149. ></A
  11150. ><TT
  11151. CLASS="parameter"
  11152. ><I
  11153. >--with-config-file-path=PATH</I
  11154. ></TT
  11155. ></DT
  11156. ><DD
  11157. ><P
  11158. >       Sets the path in which to look for <TT
  11159. CLASS="filename"
  11160. >php.ini</TT
  11161. >, defaults to PREFIX/lib.
  11162.      </P
  11163. ></DD
  11164. ><DT
  11165. ><A
  11166. NAME="install.configure.enable-safe-mode"
  11167. ></A
  11168. ><TT
  11169. CLASS="parameter"
  11170. ><I
  11171. >--enable-safe-mode</I
  11172. ></TT
  11173. ></DT
  11174. ><DD
  11175. ><P
  11176. >       Enable safe mode by default.
  11177.      </P
  11178. ></DD
  11179. ><DT
  11180. ><A
  11181. NAME="install.configure.with-exec-dir"
  11182. ></A
  11183. ><TT
  11184. CLASS="parameter"
  11185. ><I
  11186. >--with-exec-dir[=DIR]</I
  11187. ></TT
  11188. ></DT
  11189. ><DD
  11190. ><P
  11191. >       Only allow executables in DIR when in safe mode defaults to /usr/local/php/bin.
  11192.      </P
  11193. ></DD
  11194. ><DT
  11195. ><A
  11196. NAME="install.configure.enable-magic-quotes"
  11197. ></A
  11198. ><TT
  11199. CLASS="parameter"
  11200. ><I
  11201. >--enable-magic-quotes</I
  11202. ></TT
  11203. ></DT
  11204. ><DD
  11205. ><P
  11206. >       Enable magic quotes by default.
  11207.      </P
  11208. ></DD
  11209. ><DT
  11210. ><A
  11211. NAME="install.configure.disable-short-tags"
  11212. ></A
  11213. ><TT
  11214. CLASS="parameter"
  11215. ><I
  11216. >--disable-short-tags</I
  11217. ></TT
  11218. ></DT
  11219. ><DD
  11220. ><P
  11221. >       Disable the short-form <? start tag by default.
  11222.      </P
  11223. ></DD
  11224. ></DL
  11225. ></DIV
  11226. ></DIV
  11227. ><DIV
  11228. CLASS="sect3"
  11229. ><HR><H4
  11230. CLASS="sect3"
  11231. ><A
  11232. NAME="install.configure.options.servers"
  11233. ></A
  11234. >SAPI options</H4
  11235. ><P
  11236. >    The following list contains the available SAPI&s (<TT
  11237. CLASS="literal"
  11238. >Server
  11239.    Application Programming Interface)</TT
  11240. > for PHP.
  11241.   </P
  11242. ><P
  11243. ></P
  11244. ><DIV
  11245. CLASS="variablelist"
  11246. ><DL
  11247. ><DT
  11248. ><A
  11249. NAME="install.configure.with-aolserver"
  11250. ></A
  11251. ><TT
  11252. CLASS="parameter"
  11253. ><I
  11254. >--with-aolserver=DIR</I
  11255. ></TT
  11256. ></DT
  11257. ><DD
  11258. ><P
  11259. >       Specify path to the installed AOLserver.
  11260.      </P
  11261. ></DD
  11262. ><DT
  11263. ><A
  11264. NAME="install.configure.with-apxs"
  11265. ></A
  11266. ><TT
  11267. CLASS="parameter"
  11268. ><I
  11269. >--with-apxs[=FILE]</I
  11270. ></TT
  11271. ></DT
  11272. ><DD
  11273. ><P
  11274. >       Build shared Apache module. FILE is the optional pathname to the Apache
  11275.       apxs tool; defaults to apxs. Make sure you specify the version of apxs that
  11276.       is actually installed on your system and NOT the one that is in the apache
  11277.       source tarball.
  11278.      </P
  11279. ></DD
  11280. ><DT
  11281. ><A
  11282. NAME="install.configure.with-apache"
  11283. ></A
  11284. ><TT
  11285. CLASS="parameter"
  11286. ><I
  11287. >--with-apache[=DIR]</I
  11288. ></TT
  11289. ></DT
  11290. ><DD
  11291. ><P
  11292. >       Build a static Apache module. DIR is the top-level Apache build directory,
  11293.       defaults to <TT
  11294. CLASS="filename"
  11295. >/usr/local/apache</TT
  11296. >.
  11297.      </P
  11298. ></DD
  11299. ><DT
  11300. ><A
  11301. NAME="install.configure.with-mod_charset"
  11302. ></A
  11303. ><TT
  11304. CLASS="parameter"
  11305. ><I
  11306. >--with-mod_charset</I
  11307. ></TT
  11308. ></DT
  11309. ><DD
  11310. ><P
  11311. >       Enable transfer tables for mod_charset (Russian Apache).
  11312.      </P
  11313. ></DD
  11314. ><DT
  11315. ><A
  11316. NAME="install.configure.with-apxs2"
  11317. ></A
  11318. ><TT
  11319. CLASS="parameter"
  11320. ><I
  11321. >--with-apxs2[=FILE]</I
  11322. ></TT
  11323. ></DT
  11324. ><DD
  11325. ><P
  11326. >       Build shared Apache 2.0 module. FILE is the optional pathname to the Apache
  11327.       apxs tool; defaults to apxs.
  11328.      </P
  11329. ></DD
  11330. ><DT
  11331. ><A
  11332. NAME="install.configure.with-caudium"
  11333. ></A
  11334. ><TT
  11335. CLASS="parameter"
  11336. ><I
  11337. >--with-caudium=DIR</I
  11338. ></TT
  11339. ></DT
  11340. ><DD
  11341. ><P
  11342. >       Build PHP as a Pike module for use with Caudium. DIR is the Caudium server
  11343.       dir, with the default value <TT
  11344. CLASS="filename"
  11345. >/usr/local/caudium/server</TT
  11346. >.
  11347.      </P
  11348. ></DD
  11349. ><DT
  11350. ><A
  11351. NAME="install.configure.disable-cli"
  11352. ></A
  11353. ><TT
  11354. CLASS="parameter"
  11355. ><I
  11356. >--disable-cli</I
  11357. ></TT
  11358. ></DT
  11359. ><DD
  11360. ><P
  11361. >       Available with PHP 4.3.0. Disable building the CLI version of PHP (this
  11362.       forces <A
  11363. HREF="#install.configure.without-pear"
  11364. >--without-pear</A
  11365. >).
  11366.       More information is available in the section about
  11367.       <A
  11368. HREF="#features.commandline"
  11369. >Using PHP from the command line</A
  11370. >.
  11371.      </P
  11372. ></DD
  11373. ><DT
  11374. ><A
  11375. NAME="install.configure.enable-embed"
  11376. ></A
  11377. ><TT
  11378. CLASS="parameter"
  11379. ><I
  11380. > --enable-embed[=TYPE]</I
  11381. ></TT
  11382. ></DT
  11383. ><DD
  11384. ><P
  11385. >       Enable building of the embedded SAPI library. TYPE is either
  11386.       <TT
  11387. CLASS="literal"
  11388. >shared</TT
  11389. > or <TT
  11390. CLASS="literal"
  11391. >static</TT
  11392. >, which
  11393.       defaults to <TT
  11394. CLASS="literal"
  11395. >shared</TT
  11396. >. Available with PHP 4.3.0.
  11397.      </P
  11398. ></DD
  11399. ><DT
  11400. ><A
  11401. NAME="install.configure.with-fhttpd"
  11402. ></A
  11403. ><TT
  11404. CLASS="parameter"
  11405. ><I
  11406. >--with-fhttpd[=DIR]</I
  11407. ></TT
  11408. ></DT
  11409. ><DD
  11410. ><P
  11411. >       Build fhttpd module. DIR is the fhttpd sources directory, defaults to
  11412.       <TT
  11413. CLASS="filename"
  11414. >/usr/local/src/fhttpd</TT
  11415. >. No longer available as of PHP
  11416.       4.3.0.
  11417.      </P
  11418. ></DD
  11419. ><DT
  11420. ><A
  11421. NAME="install.configure.with-isapi"
  11422. ></A
  11423. ><TT
  11424. CLASS="parameter"
  11425. ><I
  11426. >--with-isapi=DIR</I
  11427. ></TT
  11428. ></DT
  11429. ><DD
  11430. ><P
  11431. >       Build PHP as an ISAPI module for use with Zeus.
  11432.      </P
  11433. ></DD
  11434. ><DT
  11435. ><A
  11436. NAME="install.configure.with-nsapi"
  11437. ></A
  11438. ><TT
  11439. CLASS="parameter"
  11440. ><I
  11441. >--with-nsapi=DIR</I
  11442. ></TT
  11443. ></DT
  11444. ><DD
  11445. ><P
  11446. >       Specify path to the installed Netscape/iPlanet/SunONE Webserver.
  11447.      </P
  11448. ></DD
  11449. ><DT
  11450. ><A
  11451. NAME="install.configure.with-phttpd"
  11452. ></A
  11453. ><TT
  11454. CLASS="parameter"
  11455. ><I
  11456. >--with-phttpd=DIR</I
  11457. ></TT
  11458. ></DT
  11459. ><DD
  11460. ><P
  11461. >       No information yet.
  11462.      </P
  11463. ></DD
  11464. ><DT
  11465. ><A
  11466. NAME="install.configure.with-pi3web"
  11467. ></A
  11468. ><TT
  11469. CLASS="parameter"
  11470. ><I
  11471. >--with-pi3web=DIR</I
  11472. ></TT
  11473. ></DT
  11474. ><DD
  11475. ><P
  11476. >       Build PHP as a module for use with Pi3Web.
  11477.      </P
  11478. ></DD
  11479. ><DT
  11480. ><A
  11481. NAME="install.configure.with-roxen"
  11482. ></A
  11483. ><TT
  11484. CLASS="parameter"
  11485. ><I
  11486. >--with-roxen=DIR</I
  11487. ></TT
  11488. ></DT
  11489. ><DD
  11490. ><P
  11491. >       Build PHP as a Pike module. DIR is the base Roxen directory, normally
  11492.       <TT
  11493. CLASS="filename"
  11494. >/usr/local/roxen/server</TT
  11495. >.
  11496.      </P
  11497. ></DD
  11498. ><DT
  11499. ><A
  11500. NAME="install.configure.enable-roxen-zts"
  11501. ></A
  11502. ><TT
  11503. CLASS="parameter"
  11504. ><I
  11505. >--enable-roxen-zts</I
  11506. ></TT
  11507. ></DT
  11508. ><DD
  11509. ><P
  11510. >       Build the Roxen module using Zend Thread Safety.
  11511.      </P
  11512. ></DD
  11513. ><DT
  11514. ><A
  11515. NAME="install.configure.with-servlet"
  11516. ></A
  11517. ><TT
  11518. CLASS="parameter"
  11519. ><I
  11520. >--with-servlet[=DIR]</I
  11521. ></TT
  11522. ></DT
  11523. ><DD
  11524. ><P
  11525. >       Include servlet support. DIR is the base install directory for the JSDK.
  11526.       This SAPI requires the java extension must be built as a shared dl.
  11527.      </P
  11528. ></DD
  11529. ><DT
  11530. ><A
  11531. NAME="install.configure.with-thttpd"
  11532. ></A
  11533. ><TT
  11534. CLASS="parameter"
  11535. ><I
  11536. >--with-thttpd=SRCDIR</I
  11537. ></TT
  11538. ></DT
  11539. ><DD
  11540. ><P
  11541. >       Build PHP as thttpd module.
  11542.      </P
  11543. ></DD
  11544. ><DT
  11545. ><A
  11546. NAME="install.configure.with-tux"
  11547. ></A
  11548. ><TT
  11549. CLASS="parameter"
  11550. ><I
  11551. >--with-tux=MODULEDIR</I
  11552. ></TT
  11553. ></DT
  11554. ><DD
  11555. ><P
  11556. >       Build PHP as a TUX module (Linux only).
  11557.      </P
  11558. ></DD
  11559. ><DT
  11560. ><A
  11561. NAME="install.configure.with-webjames"
  11562. ></A
  11563. ><TT
  11564. CLASS="parameter"
  11565. ><I
  11566. >--with-webjames=SRCDIR</I
  11567. ></TT
  11568. ></DT
  11569. ><DD
  11570. ><P
  11571. >       Build PHP as a WebJames module (RISC OS only)
  11572.      </P
  11573. ></DD
  11574. ><DT
  11575. ><A
  11576. NAME="install.configure.disable-cgi"
  11577. ></A
  11578. ><TT
  11579. CLASS="parameter"
  11580. ><I
  11581. > --disable-cgi</I
  11582. ></TT
  11583. ></DT
  11584. ><DD
  11585. ><P
  11586. >       Disable building CGI version of PHP. Available with PHP 4.3.0.
  11587.      </P
  11588. ></DD
  11589. ><DT
  11590. ><A
  11591. NAME="install.configure.enable-force-cgi-redirect"
  11592. ></A
  11593. ><TT
  11594. CLASS="parameter"
  11595. ><I
  11596. >--enable-force-cgi-redirect</I
  11597. ></TT
  11598. ></DT
  11599. ><DD
  11600. ><P
  11601. >       Enable the security check for internal server redirects. You should use
  11602.       this if you are running the CGI version with Apache.
  11603.      </P
  11604. ></DD
  11605. ><DT
  11606. ><A
  11607. NAME="install.configure.enable-discard-path"
  11608. ></A
  11609. ><TT
  11610. CLASS="parameter"
  11611. ><I
  11612. >--enable-discard-path</I
  11613. ></TT
  11614. ></DT
  11615. ><DD
  11616. ><P
  11617. >       If this is enabled, the PHP CGI binary can safely be placed outside of
  11618.       the web tree and people will not be able to circumvent <TT
  11619. CLASS="filename"
  11620. >.htaccess</TT
  11621. >
  11622.       security.
  11623.      </P
  11624. ></DD
  11625. ><DT
  11626. ><A
  11627. NAME="install.configure.with-fastcgi"
  11628. ></A
  11629. ><TT
  11630. CLASS="parameter"
  11631. ><I
  11632. >--with-fastcgi</I
  11633. ></TT
  11634. ></DT
  11635. ><DD
  11636. ><P
  11637. >       Build PHP as FastCGI application. No longer available as of PHP 4.3.0,
  11638.       instead you should use <TT
  11639. CLASS="parameter"
  11640. ><I
  11641. >--enable-fastcgi</I
  11642. ></TT
  11643. >.
  11644.      </P
  11645. ></DD
  11646. ><DT
  11647. ><A
  11648. NAME="install.configure.enable-fastcgi"
  11649. ></A
  11650. ><TT
  11651. CLASS="parameter"
  11652. ><I
  11653. >--enable-fastcgi</I
  11654. ></TT
  11655. ></DT
  11656. ><DD
  11657. ><P
  11658. >       If this is enabled, the CGI module will be built with support for FastCGI
  11659.       also. Available since PHP 4.3.0
  11660.      </P
  11661. ></DD
  11662. ><DT
  11663. ><A
  11664. NAME="install.configure.disable-path-info-check"
  11665. ></A
  11666. ><TT
  11667. CLASS="parameter"
  11668. ><I
  11669. >--disable-path-info-check</I
  11670. ></TT
  11671. ></DT
  11672. ><DD
  11673. ><P
  11674. >       If this is disabled, paths such as <TT
  11675. CLASS="filename"
  11676. >/info.php/test?a=b</TT
  11677. >
  11678.       will fail to work. Available since <TT
  11679. CLASS="literal"
  11680. >PHP 4.3.0</TT
  11681. >.
  11682.       For more information see the
  11683.       <A
  11684. HREF="http://httpd.apache.org/docs-2.0/en/mod/core.html#acceptpathinfo"
  11685. TARGET="_top"
  11686. >Apache Manual</A
  11687. >.
  11688.      </P
  11689. ></DD
  11690. ></DL
  11691. ></DIV
  11692. ></DIV
  11693. ></DIV
  11694. ></DIV
  11695. ></DIV
  11696. ><DIV
  11697. CLASS="chapter"
  11698. ><HR><H1
  11699. ><A
  11700. NAME="configuration"
  11701. >Kapitola 4. Runtime Configuration</A
  11702. ></H1
  11703. ><DIV
  11704. CLASS="sect1"
  11705. ><H2
  11706. CLASS="sect1"
  11707. ><A
  11708. NAME="configuration.file"
  11709. ></A
  11710. >The configuration file</H2
  11711. ><P
  11712. >     The configuration file (called <TT
  11713. CLASS="filename"
  11714. >php3.ini</TT
  11715. > in
  11716.     PHP 3.0, and simply <TT
  11717. CLASS="filename"
  11718. >php.ini</TT
  11719. > as of PHP 4.0)
  11720.     is read when PHP starts up. For the server module versions of PHP,
  11721.     this happens only once when the web server is started. For the
  11722.     <SPAN
  11723. CLASS="acronym"
  11724. >CGI</SPAN
  11725. > and <SPAN
  11726. CLASS="acronym"
  11727. >CLI</SPAN
  11728. > version, it happens on
  11729.     every invocation.
  11730.    </P
  11731. ><P
  11732. >     The default location of <TT
  11733. CLASS="filename"
  11734. >php.ini</TT
  11735. > is a compile time option (see the <A
  11736. HREF="#faq.installation.phpini"
  11737. >FAQ</A
  11738. > entry), but can be changed
  11739.     for the <SPAN
  11740. CLASS="acronym"
  11741. >CGI</SPAN
  11742. > and <SPAN
  11743. CLASS="acronym"
  11744. >CLI</SPAN
  11745. > version with the
  11746.     <TT
  11747. CLASS="literal"
  11748. >-c</TT
  11749. > command line switch, see the chapter about using
  11750.     <TT
  11751. CLASS="literal"
  11752. >PHP</TT
  11753. > from the <A
  11754. HREF="#features.commandline"
  11755. >command line</A
  11756. >. You can also use the
  11757.     environment variable <TT
  11758. CLASS="literal"
  11759. >PHPRC</TT
  11760. > for an additional path to
  11761.     search for a <TT
  11762. CLASS="filename"
  11763. >php.ini</TT
  11764. > file.
  11765.    </P
  11766. ><DIV
  11767. CLASS="note"
  11768. ><BLOCKQUOTE
  11769. CLASS="note"
  11770. ><P
  11771. ><B
  11772. >Poznßmka: </B
  11773. >
  11774.      The Apache web server changes the directory to root at startup causing
  11775.      PHP to attempt to read <TT
  11776. CLASS="filename"
  11777. >php.ini</TT
  11778. > from the root
  11779.      filesystem if it exists.
  11780.     </P
  11781. ></BLOCKQUOTE
  11782. ></DIV
  11783. ><P
  11784. >     Not every PHP directive is documented below. For a list of all directives, 
  11785.     please read your well commented <TT
  11786. CLASS="filename"
  11787. >php.ini</TT
  11788. > file. You may want to view the 
  11789.     latest <A
  11790. HREF="http://cvs.php.net/co.php/php-src/php.ini-dist"
  11791. TARGET="_top"
  11792. >php.ini here</A
  11793. > from CVS.
  11794.    </P
  11795. ><DIV
  11796. CLASS="note"
  11797. ><BLOCKQUOTE
  11798. CLASS="note"
  11799. ><P
  11800. ><B
  11801. >Poznßmka: </B
  11802. >
  11803.      The default value for the PHP directive 
  11804.      <A
  11805. HREF="#ini.register-globals"
  11806. >register_globals</A
  11807. > changed from 
  11808.      <SPAN
  11809. CLASS="emphasis"
  11810. ><I
  11811. CLASS="emphasis"
  11812. >on</I
  11813. ></SPAN
  11814. > to <SPAN
  11815. CLASS="emphasis"
  11816. ><I
  11817. CLASS="emphasis"
  11818. >off</I
  11819. ></SPAN
  11820. > in PHP 
  11821.      <A
  11822. HREF="http://www.php.net/release_4_2_0.php"
  11823. TARGET="_top"
  11824. >4.2.0</A
  11825. >.
  11826.     </P
  11827. ></BLOCKQUOTE
  11828. ></DIV
  11829. ><P
  11830. >     <TABLE
  11831. WIDTH="100%"
  11832. BORDER="0"
  11833. CELLPADDING="0"
  11834. CELLSPACING="0"
  11835. CLASS="EXAMPLE"
  11836. ><TR
  11837. ><TD
  11838. ><DIV
  11839. CLASS="example"
  11840. ><A
  11841. NAME="AEN2442"
  11842. ></A
  11843. ><P
  11844. ><B
  11845. >P°φklad 4-1. <TT
  11846. CLASS="filename"
  11847. >php.ini</TT
  11848. > example</B
  11849. ></P
  11850. ><TABLE
  11851. BORDER="0"
  11852. BGCOLOR="#E0E0E0"
  11853. CELLPADDING="5"
  11854. ><TR
  11855. ><TD
  11856. ><PRE
  11857. CLASS="ini"
  11858. >; any text on a line after an unquoted semicolon (;) is ignored
  11859. [php] ; section markers (text within square brackets) are also ignored
  11860. ; Boolean values can be set to either:
  11861. ;    true, on, yes
  11862. ; or false, off, no, none
  11863. register_globals = off
  11864. magic_quotes_gpc = yes
  11865.  
  11866. ; you can enclose strings in double-quotes
  11867. include_path = ".:/usr/local/lib/php"
  11868.  
  11869. ; backslashes are treated the same as any other character
  11870. include_path = ".;c:\php\lib"</PRE
  11871. ></TD
  11872. ></TR
  11873. ></TABLE
  11874. ></DIV
  11875. ></TD
  11876. ></TR
  11877. ></TABLE
  11878. >
  11879.    </P
  11880. ></DIV
  11881. ><DIV
  11882. CLASS="sect1"
  11883. ><HR><H2
  11884. CLASS="sect1"
  11885. ><A
  11886. NAME="configuration.changes"
  11887. ></A
  11888. >How to change configuration settings</H2
  11889. ><DIV
  11890. CLASS="sect2"
  11891. ><H3
  11892. CLASS="sect2"
  11893. ><A
  11894. NAME="configuration.changes.apache"
  11895. ></A
  11896. >Running <TT
  11897. CLASS="literal"
  11898. >PHP</TT
  11899. > as Apache module</H3
  11900. ><P
  11901. >      When using PHP as an Apache module, you can also change the
  11902.      configuration settings using directives in Apache configuration
  11903.      files (e.g. <TT
  11904. CLASS="filename"
  11905. >httpd.conf</TT
  11906. >) and
  11907.      <TT
  11908. CLASS="filename"
  11909. >.htaccess</TT
  11910. > files (You will need
  11911.      "AllowOverride Options" or "AllowOverride All" privileges)
  11912.     </P
  11913. ><P
  11914. >      With PHP 4.0, there are several Apache directives that allow you
  11915.      to change the PHP configuration from within the Apache configuration
  11916.      files.  For a listing of which directives are 
  11917.      <TT
  11918. CLASS="constant"
  11919. ><B
  11920. >PHP_INI_ALL</B
  11921. ></TT
  11922. >, <TT
  11923. CLASS="constant"
  11924. ><B
  11925. >PHP_INI_PERDIR</B
  11926. ></TT
  11927. >, 
  11928.      or <TT
  11929. CLASS="constant"
  11930. ><B
  11931. >PHP_INI_SYSTEM</B
  11932. ></TT
  11933. >, have a look at the table
  11934.      found within the <A
  11935. HREF="#function.ini-set"
  11936. ><B
  11937. CLASS="function"
  11938. >ini_set()</B
  11939. ></A
  11940. > documentation.
  11941.     </P
  11942. ><DIV
  11943. CLASS="note"
  11944. ><BLOCKQUOTE
  11945. CLASS="note"
  11946. ><P
  11947. ><B
  11948. >Poznßmka: </B
  11949. >
  11950.       With PHP 3.0, there are Apache directives that correspond to each
  11951.       configuration setting in the <TT
  11952. CLASS="filename"
  11953. >php3.ini</TT
  11954. > name,
  11955.       except the name is prefixed by "php3_".
  11956.      </P
  11957. ></BLOCKQUOTE
  11958. ></DIV
  11959. ><P
  11960. >      <P
  11961. ></P
  11962. ><DIV
  11963. CLASS="variablelist"
  11964. ><DL
  11965. ><DT
  11966. ><SPAN
  11967. CLASS="systemitem"
  11968. >php_value</SPAN
  11969. >
  11970.         <TT
  11971. CLASS="parameter"
  11972. ><I
  11973. >name</I
  11974. ></TT
  11975. >
  11976.         <TT
  11977. CLASS="parameter"
  11978. ><I
  11979. >value</I
  11980. ></TT
  11981. ></DT
  11982. ><DD
  11983. ><P
  11984. >          Sets the value of the specified directive.
  11985.          Can be used only with <TT
  11986. CLASS="constant"
  11987. ><B
  11988. >PHP_INI_ALL</B
  11989. ></TT
  11990. > and <TT
  11991. CLASS="constant"
  11992. ><B
  11993. >PHP_INI_PERDIR</B
  11994. ></TT
  11995. > type directives.
  11996.          To clear a previously set value use <TT
  11997. CLASS="literal"
  11998. >none</TT
  11999. > as the value.
  12000.         </P
  12001. ><DIV
  12002. CLASS="note"
  12003. ><BLOCKQUOTE
  12004. CLASS="note"
  12005. ><P
  12006. ><B
  12007. >Poznßmka: </B
  12008. >
  12009.           Don't use <TT
  12010. CLASS="literal"
  12011. >php_value</TT
  12012. > to set boolean values.
  12013.           <TT
  12014. CLASS="literal"
  12015. >php_flag</TT
  12016. > (see below) should be used instead.
  12017.          </P
  12018. ></BLOCKQUOTE
  12019. ></DIV
  12020. ></DD
  12021. ><DT
  12022. ><SPAN
  12023. CLASS="systemitem"
  12024. >php_flag</SPAN
  12025. >
  12026.         <TT
  12027. CLASS="parameter"
  12028. ><I
  12029. >name</I
  12030. ></TT
  12031. >
  12032.         <TT
  12033. CLASS="parameter"
  12034. ><I
  12035. >on|off</I
  12036. ></TT
  12037. ></DT
  12038. ><DD
  12039. ><P
  12040. >          Used to set a Boolean configuration directive.
  12041.          Can be used only with <TT
  12042. CLASS="constant"
  12043. ><B
  12044. >PHP_INI_ALL</B
  12045. ></TT
  12046. > and <TT
  12047. CLASS="constant"
  12048. ><B
  12049. >PHP_INI_PERDIR</B
  12050. ></TT
  12051. > type directives.
  12052.         </P
  12053. ></DD
  12054. ><DT
  12055. ><SPAN
  12056. CLASS="systemitem"
  12057. >php_admin_value</SPAN
  12058. >
  12059.         <TT
  12060. CLASS="parameter"
  12061. ><I
  12062. >name</I
  12063. ></TT
  12064. >
  12065.         <TT
  12066. CLASS="parameter"
  12067. ><I
  12068. >value</I
  12069. ></TT
  12070. ></DT
  12071. ><DD
  12072. ><P
  12073. >          Sets the value of the specified directive.
  12074.          This can NOT be used in <TT
  12075. CLASS="filename"
  12076. >.htaccess</TT
  12077. > files.
  12078.          Any directive type set with <SPAN
  12079. CLASS="systemitem"
  12080. >php_admin_value</SPAN
  12081. >
  12082.          can not be overridden by <TT
  12083. CLASS="filename"
  12084. >.htaccess</TT
  12085. > or virtualhost directives.
  12086.          To clear a previously set value use <TT
  12087. CLASS="literal"
  12088. >none</TT
  12089. > as the value.
  12090.         </P
  12091. ></DD
  12092. ><DT
  12093. ><SPAN
  12094. CLASS="systemitem"
  12095. >php_admin_flag</SPAN
  12096. >
  12097.         <TT
  12098. CLASS="parameter"
  12099. ><I
  12100. >name</I
  12101. ></TT
  12102. >
  12103.         <TT
  12104. CLASS="parameter"
  12105. ><I
  12106. >on|off</I
  12107. ></TT
  12108. ></DT
  12109. ><DD
  12110. ><P
  12111. >          Used to set a Boolean configuration directive.
  12112.          This can NOT be used in <TT
  12113. CLASS="filename"
  12114. >.htaccess</TT
  12115. > files.
  12116.          Any directive type set with <SPAN
  12117. CLASS="systemitem"
  12118. >php_admin_flag</SPAN
  12119. >
  12120.          can not be overridden by <TT
  12121. CLASS="filename"
  12122. >.htaccess</TT
  12123. > or virtualhost directives.
  12124.         </P
  12125. ></DD
  12126. ></DL
  12127. ></DIV
  12128. >
  12129.     </P
  12130. ><P
  12131. >      <TABLE
  12132. WIDTH="100%"
  12133. BORDER="0"
  12134. CELLPADDING="0"
  12135. CELLSPACING="0"
  12136. CLASS="EXAMPLE"
  12137. ><TR
  12138. ><TD
  12139. ><DIV
  12140. CLASS="example"
  12141. ><A
  12142. NAME="AEN2509"
  12143. ></A
  12144. ><P
  12145. ><B
  12146. >P°φklad 4-2. Apache configuration example</B
  12147. ></P
  12148. ><TABLE
  12149. BORDER="0"
  12150. BGCOLOR="#E0E0E0"
  12151. CELLPADDING="5"
  12152. ><TR
  12153. ><TD
  12154. ><PRE
  12155. CLASS="ini"
  12156. ><IfModule mod_php4.c>
  12157.   php_value include_path ".:/usr/local/lib/php"
  12158.   php_admin_flag safe_mode on
  12159. </IfModule>
  12160. <IfModule mod_php3.c>
  12161.   php3_include_path ".:/usr/local/lib/php"
  12162.   php3_safe_mode on
  12163. </IfModule></PRE
  12164. ></TD
  12165. ></TR
  12166. ></TABLE
  12167. ></DIV
  12168. ></TD
  12169. ></TR
  12170. ></TABLE
  12171. >
  12172.     </P
  12173. ><DIV
  12174. CLASS="caution"
  12175. ><P
  12176. ></P
  12177. ><TABLE
  12178. CLASS="caution"
  12179. BORDER="1"
  12180. WIDTH="100%"
  12181. ><TR
  12182. ><TD
  12183. ALIGN="CENTER"
  12184. ><B
  12185. >V²straha</B
  12186. ></TD
  12187. ></TR
  12188. ><TR
  12189. ><TD
  12190. ALIGN="LEFT"
  12191. ><P
  12192. >       PHP constants do not exist outside of PHP. For example, in 
  12193.       <TT
  12194. CLASS="filename"
  12195. >httpd.conf</TT
  12196. > you can not use PHP constants 
  12197.       such as <TT
  12198. CLASS="constant"
  12199. ><B
  12200. >E_ALL</B
  12201. ></TT
  12202. > or <TT
  12203. CLASS="constant"
  12204. ><B
  12205. >E_NOTICE</B
  12206. ></TT
  12207. > 
  12208.       to set the <A
  12209. HREF="#ini.error-reporting"
  12210. >error_reporting</A
  12211. > 
  12212.       directive as they will have no meaning and will evaluate to
  12213.       <SPAN
  12214. CLASS="emphasis"
  12215. ><I
  12216. CLASS="emphasis"
  12217. >0</I
  12218. ></SPAN
  12219. >. Use the associated bitmask values instead.
  12220.       These constants can be used in <TT
  12221. CLASS="filename"
  12222. >php.ini</TT
  12223. >
  12224.      </P
  12225. ></TD
  12226. ></TR
  12227. ></TABLE
  12228. ></DIV
  12229. ></DIV
  12230. ><DIV
  12231. CLASS="sect2"
  12232. ><HR><H3
  12233. CLASS="sect2"
  12234. ><A
  12235. NAME="configuration.changes.windows"
  12236. ></A
  12237. >Changing <TT
  12238. CLASS="literal"
  12239. >PHP</TT
  12240. > configuration via the Windows registry</H3
  12241. ><P
  12242. >       When running PHP on Windows, the configuration values can be
  12243.       modified on per-directory basis using the Windows registry. The
  12244.       configuration values are stored in the registry key 
  12245.       <TT
  12246. CLASS="literal"
  12247. >HKLM\SOFTWARE\PHP\Per Directory Values</TT
  12248. >, 
  12249.       in the sub-keys corresponding to the path names. For example, configuration 
  12250.       values for the directory <TT
  12251. CLASS="literal"
  12252. >c:\inetpub\wwwroot</TT
  12253. > would
  12254.       be stored in the key <TT
  12255. CLASS="literal"
  12256. >HKLM\SOFTWARE\PHP\Per Directory
  12257.       Values\c\inetpub\wwwroot</TT
  12258. >. The settings for the
  12259.       directory would be active for any script running from this
  12260.       directory or any subdirectory of it. The values under the key
  12261.       should have the name of <A
  12262. HREF="#configuration"
  12263. >PHP
  12264.       configuration directive</A
  12265. > and the string value. PHP
  12266.       constants in the values would not be parsed. 
  12267.      </P
  12268. ></DIV
  12269. ><DIV
  12270. CLASS="sect2"
  12271. ><HR><H3
  12272. CLASS="sect2"
  12273. ><A
  12274. NAME="configuration.changes.other"
  12275. ></A
  12276. >Other interfaces to <TT
  12277. CLASS="literal"
  12278. >PHP</TT
  12279. ></H3
  12280. ><P
  12281. >      Regardless of the interface to <TT
  12282. CLASS="literal"
  12283. >PHP</TT
  12284. > you can change
  12285.      certain values at runtime of your scripts through
  12286.      <A
  12287. HREF="#function.ini-set"
  12288. ><B
  12289. CLASS="function"
  12290. >ini_set()</B
  12291. ></A
  12292. >. The following table provides an overview
  12293.      at which level a directive can be set/changed.
  12294.     </P
  12295. ><P
  12296. >      <DIV
  12297. CLASS="table"
  12298. ><A
  12299. NAME="AEN2535"
  12300. ></A
  12301. ><P
  12302. ><B
  12303. >Tabulka 4-1. Definition of PHP_INI_* constants</B
  12304. ></P
  12305. ><TABLE
  12306. BORDER="1"
  12307. CLASS="CALSTABLE"
  12308. ><THEAD
  12309. ><TR
  12310. ><TH
  12311. ALIGN="LEFT"
  12312. VALIGN="MIDDLE"
  12313. >Constant</TH
  12314. ><TH
  12315. ALIGN="LEFT"
  12316. VALIGN="MIDDLE"
  12317. >Value</TH
  12318. ><TH
  12319. ALIGN="LEFT"
  12320. VALIGN="MIDDLE"
  12321. >Meaning</TH
  12322. ></TR
  12323. ></THEAD
  12324. ><TBODY
  12325. ><TR
  12326. ><TD
  12327. ALIGN="LEFT"
  12328. VALIGN="MIDDLE"
  12329. >PHP_INI_USER</TD
  12330. ><TD
  12331. ALIGN="LEFT"
  12332. VALIGN="MIDDLE"
  12333. >1</TD
  12334. ><TD
  12335. ALIGN="LEFT"
  12336. VALIGN="MIDDLE"
  12337. >Entry can be set in user scripts</TD
  12338. ></TR
  12339. ><TR
  12340. ><TD
  12341. ALIGN="LEFT"
  12342. VALIGN="MIDDLE"
  12343. >PHP_INI_PERDIR</TD
  12344. ><TD
  12345. ALIGN="LEFT"
  12346. VALIGN="MIDDLE"
  12347. >2</TD
  12348. ><TD
  12349. ALIGN="LEFT"
  12350. VALIGN="MIDDLE"
  12351. >          Entry can be set in <TT
  12352. CLASS="filename"
  12353. >php.ini</TT
  12354. >, <TT
  12355. CLASS="filename"
  12356. >.htaccess</TT
  12357. > or
  12358.          <TT
  12359. CLASS="filename"
  12360. >httpd.conf</TT
  12361. >
  12362.         </TD
  12363. ></TR
  12364. ><TR
  12365. ><TD
  12366. ALIGN="LEFT"
  12367. VALIGN="MIDDLE"
  12368. >PHP_INI_SYSTEM</TD
  12369. ><TD
  12370. ALIGN="LEFT"
  12371. VALIGN="MIDDLE"
  12372. >4</TD
  12373. ><TD
  12374. ALIGN="LEFT"
  12375. VALIGN="MIDDLE"
  12376. >          Entry can be set in <TT
  12377. CLASS="filename"
  12378. >php.ini</TT
  12379. > or <TT
  12380. CLASS="filename"
  12381. >httpd.conf</TT
  12382. >
  12383.         </TD
  12384. ></TR
  12385. ><TR
  12386. ><TD
  12387. ALIGN="LEFT"
  12388. VALIGN="MIDDLE"
  12389. >PHP_INI_ALL</TD
  12390. ><TD
  12391. ALIGN="LEFT"
  12392. VALIGN="MIDDLE"
  12393. >7</TD
  12394. ><TD
  12395. ALIGN="LEFT"
  12396. VALIGN="MIDDLE"
  12397. >Entry can be set anywhere</TD
  12398. ></TR
  12399. ></TBODY
  12400. ></TABLE
  12401. ></DIV
  12402. >
  12403.     </P
  12404. ><P
  12405. >      You can view the settings of the configuration values in
  12406.      the output of <A
  12407. HREF="#function.phpinfo"
  12408. ><B
  12409. CLASS="function"
  12410. >phpinfo()</B
  12411. ></A
  12412. >. You can also
  12413.      access the values of individual configuration directives using
  12414.      <A
  12415. HREF="#function.ini-get"
  12416. ><B
  12417. CLASS="function"
  12418. >ini_get()</B
  12419. ></A
  12420. > or <A
  12421. HREF="#function.get-cfg-var"
  12422. ><B
  12423. CLASS="function"
  12424. >get_cfg_var()</B
  12425. ></A
  12426. >.
  12427.     </P
  12428. ></DIV
  12429. ></DIV
  12430. ><DIV
  12431. CLASS="sect1"
  12432. ><HR><H2
  12433. CLASS="sect1"
  12434. ><A
  12435. NAME="configuration.directives"
  12436. ></A
  12437. >Miscellaneous configuration directives</H2
  12438. ><P
  12439. >     This is not a complete list of PHP directives.  Directives are listed 
  12440.     in their appropriate locations so for example information on session
  12441.     directives is located in the 
  12442.     <A
  12443. HREF="#ref.session"
  12444. >sessions chapter</A
  12445. >.
  12446.    </P
  12447. ><DIV
  12448. CLASS="sect2"
  12449. ><HR><H3
  12450. CLASS="sect2"
  12451. ><A
  12452. NAME="ini.sect.httpd-options"
  12453. ></A
  12454. >Httpd Options</H3
  12455. ><P
  12456. >      <DIV
  12457. CLASS="table"
  12458. ><A
  12459. NAME="AEN2576"
  12460. ></A
  12461. ><P
  12462. ><B
  12463. >Tabulka 4-2. Httpd Options</B
  12464. ></P
  12465. ><TABLE
  12466. BORDER="1"
  12467. CLASS="CALSTABLE"
  12468. ><THEAD
  12469. ><TR
  12470. ><TH
  12471. ALIGN="LEFT"
  12472. VALIGN="MIDDLE"
  12473. >Name</TH
  12474. ><TH
  12475. ALIGN="LEFT"
  12476. VALIGN="MIDDLE"
  12477. >Default</TH
  12478. ><TH
  12479. ALIGN="LEFT"
  12480. VALIGN="MIDDLE"
  12481. >Changeable</TH
  12482. ></TR
  12483. ></THEAD
  12484. ><TBODY
  12485. ><TR
  12486. ><TD
  12487. ALIGN="LEFT"
  12488. VALIGN="MIDDLE"
  12489. >async_send</TD
  12490. ><TD
  12491. ALIGN="LEFT"
  12492. VALIGN="MIDDLE"
  12493. >"0"</TD
  12494. ><TD
  12495. ALIGN="LEFT"
  12496. VALIGN="MIDDLE"
  12497. >PHP_INI_ALL</TD
  12498. ></TR
  12499. ></TBODY
  12500. ></TABLE
  12501. ></DIV
  12502. >
  12503.     </P
  12504. ><P
  12505. >     </P
  12506. ></DIV
  12507. ><DIV
  12508. CLASS="sect2"
  12509. ><HR><H3
  12510. CLASS="sect2"
  12511. ><A
  12512. NAME="ini.sect.language-options"
  12513. ></A
  12514. >Language Options</H3
  12515. ><P
  12516. >    <DIV
  12517. CLASS="table"
  12518. ><A
  12519. NAME="AEN2593"
  12520. ></A
  12521. ><P
  12522. ><B
  12523. >Tabulka 4-3. Language and Misc Configuration Options</B
  12524. ></P
  12525. ><TABLE
  12526. BORDER="1"
  12527. CLASS="CALSTABLE"
  12528. ><THEAD
  12529. ><TR
  12530. ><TH
  12531. ALIGN="LEFT"
  12532. VALIGN="MIDDLE"
  12533. >Name</TH
  12534. ><TH
  12535. ALIGN="LEFT"
  12536. VALIGN="MIDDLE"
  12537. >Default</TH
  12538. ><TH
  12539. ALIGN="LEFT"
  12540. VALIGN="MIDDLE"
  12541. >Changeable</TH
  12542. ></TR
  12543. ></THEAD
  12544. ><TBODY
  12545. ><TR
  12546. ><TD
  12547. ALIGN="LEFT"
  12548. VALIGN="MIDDLE"
  12549. >short_open_tag</TD
  12550. ><TD
  12551. ALIGN="LEFT"
  12552. VALIGN="MIDDLE"
  12553. >On</TD
  12554. ><TD
  12555. ALIGN="LEFT"
  12556. VALIGN="MIDDLE"
  12557. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  12558. ></TR
  12559. ><TR
  12560. ><TD
  12561. ALIGN="LEFT"
  12562. VALIGN="MIDDLE"
  12563. >asp_tags</TD
  12564. ><TD
  12565. ALIGN="LEFT"
  12566. VALIGN="MIDDLE"
  12567. >Off</TD
  12568. ><TD
  12569. ALIGN="LEFT"
  12570. VALIGN="MIDDLE"
  12571. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  12572. ></TR
  12573. ><TR
  12574. ><TD
  12575. ALIGN="LEFT"
  12576. VALIGN="MIDDLE"
  12577. >precision</TD
  12578. ><TD
  12579. ALIGN="LEFT"
  12580. VALIGN="MIDDLE"
  12581. >"14"</TD
  12582. ><TD
  12583. ALIGN="LEFT"
  12584. VALIGN="MIDDLE"
  12585. >PHP_INI_ALL</TD
  12586. ></TR
  12587. ><TR
  12588. ><TD
  12589. ALIGN="LEFT"
  12590. VALIGN="MIDDLE"
  12591. >y2k_compliance</TD
  12592. ><TD
  12593. ALIGN="LEFT"
  12594. VALIGN="MIDDLE"
  12595. >Off</TD
  12596. ><TD
  12597. ALIGN="LEFT"
  12598. VALIGN="MIDDLE"
  12599. >PHP_INI_ALL</TD
  12600. ></TR
  12601. ><TR
  12602. ><TD
  12603. ALIGN="LEFT"
  12604. VALIGN="MIDDLE"
  12605. >allow_call_time_pass_reference</TD
  12606. ><TD
  12607. ALIGN="LEFT"
  12608. VALIGN="MIDDLE"
  12609. >On</TD
  12610. ><TD
  12611. ALIGN="LEFT"
  12612. VALIGN="MIDDLE"
  12613. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  12614. ></TR
  12615. ><TR
  12616. ><TD
  12617. ALIGN="LEFT"
  12618. VALIGN="MIDDLE"
  12619. >expose_php</TD
  12620. ><TD
  12621. ALIGN="LEFT"
  12622. VALIGN="MIDDLE"
  12623. >On</TD
  12624. ><TD
  12625. ALIGN="LEFT"
  12626. VALIGN="MIDDLE"
  12627. >PHP_INI_SYSTEM</TD
  12628. ></TR
  12629. ></TBODY
  12630. ></TABLE
  12631. ></DIV
  12632. >
  12633.    </P
  12634. ><P
  12635. >Zde je struΦnΘ vysv∞tlenφ
  12636. konfiguraΦnφch direktiv.</P
  12637. ><P
  12638. >      <P
  12639. ></P
  12640. ><DIV
  12641. CLASS="variablelist"
  12642. ><DL
  12643. ><DT
  12644. ><A
  12645. NAME="ini.short-open-tag"
  12646. ></A
  12647. ><TT
  12648. CLASS="parameter"
  12649. ><I
  12650. >short_open_tag</I
  12651. ></TT
  12652. >
  12653.         <A
  12654. HREF="#language.types.boolean"
  12655. ><B
  12656. CLASS="type"
  12657. >boolean</B
  12658. ></A
  12659. ></DT
  12660. ><DD
  12661. ><P
  12662. >          Tells whether the short form (<TT
  12663. CLASS="userinput"
  12664. ><B
  12665. ><? ?></B
  12666. ></TT
  12667. >)
  12668.          of PHP's open tag should be allowed.  If you want to use PHP in
  12669.          combination with XML, you can disable this option in order to 
  12670.          use <TT
  12671. CLASS="userinput"
  12672. ><B
  12673. ><?xml ?></B
  12674. ></TT
  12675. > inline.  Otherwise, you 
  12676.          can print it with PHP, for example: <TT
  12677. CLASS="userinput"
  12678. ><B
  12679. ><?php echo '<?xml 
  12680.          version="1.0"'; ?></B
  12681. ></TT
  12682. >.  Also if disabled, you must use the 
  12683.          long form of the PHP open tag (<TT
  12684. CLASS="userinput"
  12685. ><B
  12686. ><?php ?></B
  12687. ></TT
  12688. >).
  12689.         </P
  12690. ><DIV
  12691. CLASS="note"
  12692. ><BLOCKQUOTE
  12693. CLASS="note"
  12694. ><P
  12695. ><B
  12696. >Poznßmka: </B
  12697. >
  12698.           This directive also affects the shorthand <TT
  12699. CLASS="userinput"
  12700. ><B
  12701. ><?=</B
  12702. ></TT
  12703. >, 
  12704.           which is identical to <TT
  12705. CLASS="userinput"
  12706. ><B
  12707. ><? echo</B
  12708. ></TT
  12709. >.  Use of this 
  12710.           shortcut requires <SPAN
  12711. CLASS="systemitem"
  12712. >short_open_tag</SPAN
  12713. >
  12714.           to be on.
  12715.          </P
  12716. ></BLOCKQUOTE
  12717. ></DIV
  12718. ></DD
  12719. ><DT
  12720. ><A
  12721. NAME="ini.asp-tags"
  12722. ></A
  12723. ><TT
  12724. CLASS="parameter"
  12725. ><I
  12726. >asp_tags</I
  12727. ></TT
  12728. >
  12729.         <A
  12730. HREF="#language.types.boolean"
  12731. ><B
  12732. CLASS="type"
  12733. >boolean</B
  12734. ></A
  12735. ></DT
  12736. ><DD
  12737. ><P
  12738. >          Enables the use of ASP-like <% %> tags in addition to
  12739.          the usual <?php ?> tags. This includes the
  12740.          variable-value printing shorthand of <%= $value %>. For 
  12741.          more information, see <A
  12742. HREF="#language.basic-syntax.phpmode"
  12743. >Escaping from HTML</A
  12744. >.
  12745.         </P
  12746. ><DIV
  12747. CLASS="note"
  12748. ><BLOCKQUOTE
  12749. CLASS="note"
  12750. ><P
  12751. ><B
  12752. >Poznßmka: </B
  12753. >
  12754.           Support for ASP-style tags was added in 3.0.4.
  12755.          </P
  12756. ></BLOCKQUOTE
  12757. ></DIV
  12758. ></DD
  12759. ><DT
  12760. ><A
  12761. NAME="ini.precision"
  12762. ></A
  12763. ><TT
  12764. CLASS="parameter"
  12765. ><I
  12766. >precision</I
  12767. ></TT
  12768. >
  12769.         <A
  12770. HREF="#language.types.integer"
  12771. ><B
  12772. CLASS="type"
  12773. >integer</B
  12774. ></A
  12775. ></DT
  12776. ><DD
  12777. ><P
  12778. >          The number of significant digits displayed in floating point numbers.
  12779.         </P
  12780. ></DD
  12781. ><DT
  12782. ><A
  12783. NAME="ini.y2k-compliance"
  12784. ></A
  12785. ><TT
  12786. CLASS="parameter"
  12787. ><I
  12788. >y2k_compliance</I
  12789. ></TT
  12790. >
  12791.         <A
  12792. HREF="#language.types.boolean"
  12793. ><B
  12794. CLASS="type"
  12795. >boolean</B
  12796. ></A
  12797. ></DT
  12798. ><DD
  12799. ><P
  12800. >          Enforce year 2000 compliance (will cause problems with non-compliant browsers)
  12801.         </P
  12802. ></DD
  12803. ><DT
  12804. ><A
  12805. NAME="ini.allow-call-time-pass-reference"
  12806. ></A
  12807. ><TT
  12808. CLASS="parameter"
  12809. ><I
  12810. >allow_call_time_pass_reference</I
  12811. ></TT
  12812. >
  12813.         <A
  12814. HREF="#language.types.boolean"
  12815. ><B
  12816. CLASS="type"
  12817. >boolean</B
  12818. ></A
  12819. ></DT
  12820. ><DD
  12821. ><P
  12822. >          Whether to enable the ability to force arguments to be passed by reference
  12823.          at function call time. This method is deprecated and is likely to be
  12824.          unsupported in future versions of PHP/Zend.  The encouraged method of
  12825.          specifying which arguments should be passed by reference is in the function
  12826.          declaration.  You're encouraged to try and turn this option Off and make
  12827.          sure your scripts work properly with it in order to ensure they will work
  12828.          with future versions of the language (you will receive a warning each time
  12829.          you use this feature, and the argument will be passed by value instead of by
  12830.          reference).
  12831.         </P
  12832. ><P
  12833. >          See also <A
  12834. HREF="#language.references"
  12835. >References Explained</A
  12836. >.
  12837.         </P
  12838. ></DD
  12839. ><DT
  12840. ><A
  12841. NAME="ini.expose-php"
  12842. ></A
  12843. ><TT
  12844. CLASS="parameter"
  12845. ><I
  12846. >expose_php</I
  12847. ></TT
  12848. >
  12849.         <A
  12850. HREF="#language.types.boolean"
  12851. ><B
  12852. CLASS="type"
  12853. >boolean</B
  12854. ></A
  12855. ></DT
  12856. ><DD
  12857. ><P
  12858. >          Decides whether PHP may expose the fact that it is installed on the server
  12859.          (e.g. by adding its signature to the Web server header). It is no security
  12860.          threat in any way, but it makes it possible to determine whether you use PHP
  12861.          on your server or not.
  12862.         </P
  12863. ></DD
  12864. ></DL
  12865. ></DIV
  12866. >
  12867.     </P
  12868. ></DIV
  12869. ><DIV
  12870. CLASS="sect2"
  12871. ><HR><H3
  12872. CLASS="sect2"
  12873. ><A
  12874. NAME="ini.sect.resource-limits"
  12875. ></A
  12876. >Resource Limits</H3
  12877. ><P
  12878. >     <DIV
  12879. CLASS="table"
  12880. ><A
  12881. NAME="AEN2682"
  12882. ></A
  12883. ><P
  12884. ><B
  12885. >Tabulka 4-4. Resource Limits</B
  12886. ></P
  12887. ><TABLE
  12888. BORDER="1"
  12889. CLASS="CALSTABLE"
  12890. ><THEAD
  12891. ><TR
  12892. ><TH
  12893. ALIGN="LEFT"
  12894. VALIGN="MIDDLE"
  12895. >Name</TH
  12896. ><TH
  12897. ALIGN="LEFT"
  12898. VALIGN="MIDDLE"
  12899. >Default</TH
  12900. ><TH
  12901. ALIGN="LEFT"
  12902. VALIGN="MIDDLE"
  12903. >Changeable</TH
  12904. ></TR
  12905. ></THEAD
  12906. ><TBODY
  12907. ><TR
  12908. ><TD
  12909. ALIGN="LEFT"
  12910. VALIGN="MIDDLE"
  12911. >memory_limit</TD
  12912. ><TD
  12913. ALIGN="LEFT"
  12914. VALIGN="MIDDLE"
  12915. >"8M"</TD
  12916. ><TD
  12917. ALIGN="LEFT"
  12918. VALIGN="MIDDLE"
  12919. >PHP_INI_ALL</TD
  12920. ></TR
  12921. ></TBODY
  12922. ></TABLE
  12923. ></DIV
  12924. >
  12925.    </P
  12926. ><P
  12927. >Zde je struΦnΘ vysv∞tlenφ
  12928. konfiguraΦnφch direktiv.</P
  12929. ><P
  12930. >     <P
  12931. ></P
  12932. ><DIV
  12933. CLASS="variablelist"
  12934. ><DL
  12935. ><DT
  12936. ><A
  12937. NAME="ini.memory-limit"
  12938. ></A
  12939. ><TT
  12940. CLASS="parameter"
  12941. ><I
  12942. >memory_limit</I
  12943. ></TT
  12944. >
  12945.        <A
  12946. HREF="#language.types.integer"
  12947. ><B
  12948. CLASS="type"
  12949. >integer</B
  12950. ></A
  12951. ></DT
  12952. ><DD
  12953. ><P
  12954. >         This sets the maximum amount of memory in bytes that a script
  12955.         is allowed to allocate.  This helps prevent poorly written
  12956.         scripts for eating up all available memory on a server.  In order to
  12957.         use this directive you must have enabled it at compile time.  So, 
  12958.         your configure line would have included:
  12959.         <TT
  12960. CLASS="literal"
  12961. >--enable-memory-limit</TT
  12962. >. Note that you have to set 
  12963.         it to -1 if you don't want any limit for your memory.
  12964.        </P
  12965. ><P
  12966. >         As of PHP 4.3.2, and when memory_limit is enabled, the PHP function 
  12967.         <A
  12968. HREF="#function.memory-get-usage"
  12969. ><B
  12970. CLASS="function"
  12971. >memory_get_usage()</B
  12972. ></A
  12973. > is made available.
  12974.        </P
  12975. ></DD
  12976. ></DL
  12977. ></DIV
  12978. >
  12979.    </P
  12980. ><P
  12981. >     See also: <A
  12982. HREF="#ini.max-execution-time"
  12983. >max_execution_time</A
  12984. >.
  12985.    </P
  12986. ></DIV
  12987. ><DIV
  12988. CLASS="sect2"
  12989. ><HR><H3
  12990. CLASS="sect2"
  12991. ><A
  12992. NAME="ini.sect.data-handling"
  12993. ></A
  12994. >Data Handling</H3
  12995. ><P
  12996. >      <DIV
  12997. CLASS="table"
  12998. ><A
  12999. NAME="AEN2712"
  13000. ></A
  13001. ><P
  13002. ><B
  13003. >Tabulka 4-5. Data Handling Configuration Options</B
  13004. ></P
  13005. ><TABLE
  13006. BORDER="1"
  13007. CLASS="CALSTABLE"
  13008. ><THEAD
  13009. ><TR
  13010. ><TH
  13011. ALIGN="LEFT"
  13012. VALIGN="MIDDLE"
  13013. >Name</TH
  13014. ><TH
  13015. ALIGN="LEFT"
  13016. VALIGN="MIDDLE"
  13017. >Default</TH
  13018. ><TH
  13019. ALIGN="LEFT"
  13020. VALIGN="MIDDLE"
  13021. >Changeable</TH
  13022. ></TR
  13023. ></THEAD
  13024. ><TBODY
  13025. ><TR
  13026. ><TD
  13027. ALIGN="LEFT"
  13028. VALIGN="MIDDLE"
  13029. >track-vars</TD
  13030. ><TD
  13031. ALIGN="LEFT"
  13032. VALIGN="MIDDLE"
  13033. >"On"</TD
  13034. ><TD
  13035. ALIGN="LEFT"
  13036. VALIGN="MIDDLE"
  13037. >PHP_INI_??</TD
  13038. ></TR
  13039. ><TR
  13040. ><TD
  13041. ALIGN="LEFT"
  13042. VALIGN="MIDDLE"
  13043. >arg_separator.output</TD
  13044. ><TD
  13045. ALIGN="LEFT"
  13046. VALIGN="MIDDLE"
  13047. >"&"</TD
  13048. ><TD
  13049. ALIGN="LEFT"
  13050. VALIGN="MIDDLE"
  13051. >PHP_INI_ALL</TD
  13052. ></TR
  13053. ><TR
  13054. ><TD
  13055. ALIGN="LEFT"
  13056. VALIGN="MIDDLE"
  13057. >arg_separator.input</TD
  13058. ><TD
  13059. ALIGN="LEFT"
  13060. VALIGN="MIDDLE"
  13061. >"&"</TD
  13062. ><TD
  13063. ALIGN="LEFT"
  13064. VALIGN="MIDDLE"
  13065. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  13066. ></TR
  13067. ><TR
  13068. ><TD
  13069. ALIGN="LEFT"
  13070. VALIGN="MIDDLE"
  13071. >variables_order</TD
  13072. ><TD
  13073. ALIGN="LEFT"
  13074. VALIGN="MIDDLE"
  13075. >"EGPCS"</TD
  13076. ><TD
  13077. ALIGN="LEFT"
  13078. VALIGN="MIDDLE"
  13079. >PHP_INI_ALL</TD
  13080. ></TR
  13081. ><TR
  13082. ><TD
  13083. ALIGN="LEFT"
  13084. VALIGN="MIDDLE"
  13085. >register_globals</TD
  13086. ><TD
  13087. ALIGN="LEFT"
  13088. VALIGN="MIDDLE"
  13089. >"Off"</TD
  13090. ><TD
  13091. ALIGN="LEFT"
  13092. VALIGN="MIDDLE"
  13093. >PHP_INI_PERDIR|PHP_INI_SYSTEM</TD
  13094. ></TR
  13095. ><TR
  13096. ><TD
  13097. ALIGN="LEFT"
  13098. VALIGN="MIDDLE"
  13099. >register_argc_argv</TD
  13100. ><TD
  13101. ALIGN="LEFT"
  13102. VALIGN="MIDDLE"
  13103. >"On"</TD
  13104. ><TD
  13105. ALIGN="LEFT"
  13106. VALIGN="MIDDLE"
  13107. >PHP_INI_PERDIR|PHP_INI_SYSTEM</TD
  13108. ></TR
  13109. ><TR
  13110. ><TD
  13111. ALIGN="LEFT"
  13112. VALIGN="MIDDLE"
  13113. >register_long_arrays</TD
  13114. ><TD
  13115. ALIGN="LEFT"
  13116. VALIGN="MIDDLE"
  13117. >"On"</TD
  13118. ><TD
  13119. ALIGN="LEFT"
  13120. VALIGN="MIDDLE"
  13121. >PHP_INI_PERDIR|PHP_INI_SYSTEM</TD
  13122. ></TR
  13123. ><TR
  13124. ><TD
  13125. ALIGN="LEFT"
  13126. VALIGN="MIDDLE"
  13127. >post_max_size</TD
  13128. ><TD
  13129. ALIGN="LEFT"
  13130. VALIGN="MIDDLE"
  13131. >"8M"</TD
  13132. ><TD
  13133. ALIGN="LEFT"
  13134. VALIGN="MIDDLE"
  13135. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  13136. ></TR
  13137. ><TR
  13138. ><TD
  13139. ALIGN="LEFT"
  13140. VALIGN="MIDDLE"
  13141. >gpc_order</TD
  13142. ><TD
  13143. ALIGN="LEFT"
  13144. VALIGN="MIDDLE"
  13145. >"GPC"</TD
  13146. ><TD
  13147. ALIGN="LEFT"
  13148. VALIGN="MIDDLE"
  13149. >PHP_INI_ALL</TD
  13150. ></TR
  13151. ><TR
  13152. ><TD
  13153. ALIGN="LEFT"
  13154. VALIGN="MIDDLE"
  13155. >auto_prepend_file</TD
  13156. ><TD
  13157. ALIGN="LEFT"
  13158. VALIGN="MIDDLE"
  13159. >""</TD
  13160. ><TD
  13161. ALIGN="LEFT"
  13162. VALIGN="MIDDLE"
  13163. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  13164. ></TR
  13165. ><TR
  13166. ><TD
  13167. ALIGN="LEFT"
  13168. VALIGN="MIDDLE"
  13169. >auto_append_file</TD
  13170. ><TD
  13171. ALIGN="LEFT"
  13172. VALIGN="MIDDLE"
  13173. >""</TD
  13174. ><TD
  13175. ALIGN="LEFT"
  13176. VALIGN="MIDDLE"
  13177. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  13178. ></TR
  13179. ><TR
  13180. ><TD
  13181. ALIGN="LEFT"
  13182. VALIGN="MIDDLE"
  13183. >default_mimetype</TD
  13184. ><TD
  13185. ALIGN="LEFT"
  13186. VALIGN="MIDDLE"
  13187. >"text/html"</TD
  13188. ><TD
  13189. ALIGN="LEFT"
  13190. VALIGN="MIDDLE"
  13191. >PHP_INI_ALL</TD
  13192. ></TR
  13193. ><TR
  13194. ><TD
  13195. ALIGN="LEFT"
  13196. VALIGN="MIDDLE"
  13197. >default_charset</TD
  13198. ><TD
  13199. ALIGN="LEFT"
  13200. VALIGN="MIDDLE"
  13201. >"iso-8859-1"</TD
  13202. ><TD
  13203. ALIGN="LEFT"
  13204. VALIGN="MIDDLE"
  13205. >PHP_INI_ALL</TD
  13206. ></TR
  13207. ><TR
  13208. ><TD
  13209. ALIGN="LEFT"
  13210. VALIGN="MIDDLE"
  13211. >always_populate_raw_post_data</TD
  13212. ><TD
  13213. ALIGN="LEFT"
  13214. VALIGN="MIDDLE"
  13215. >"0"</TD
  13216. ><TD
  13217. ALIGN="LEFT"
  13218. VALIGN="MIDDLE"
  13219. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  13220. ></TR
  13221. ><TR
  13222. ><TD
  13223. ALIGN="LEFT"
  13224. VALIGN="MIDDLE"
  13225. >allow_webdav_methods</TD
  13226. ><TD
  13227. ALIGN="LEFT"
  13228. VALIGN="MIDDLE"
  13229. >"0"</TD
  13230. ><TD
  13231. ALIGN="LEFT"
  13232. VALIGN="MIDDLE"
  13233. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  13234. ></TR
  13235. ></TBODY
  13236. ></TABLE
  13237. ></DIV
  13238. >
  13239.     </P
  13240. ><P
  13241. >Zde je struΦnΘ vysv∞tlenφ
  13242. konfiguraΦnφch direktiv.</P
  13243. ><P
  13244. >      <P
  13245. ></P
  13246. ><DIV
  13247. CLASS="variablelist"
  13248. ><DL
  13249. ><DT
  13250. ><A
  13251. NAME="ini.track-vars"
  13252. ></A
  13253. ><TT
  13254. CLASS="parameter"
  13255. ><I
  13256. >track_vars</I
  13257. ></TT
  13258. >
  13259.         <A
  13260. HREF="#language.types.boolean"
  13261. ><B
  13262. CLASS="type"
  13263. >boolean</B
  13264. ></A
  13265. ></DT
  13266. ><DD
  13267. ><P
  13268. >          If enabled, then Environment, GET, POST, Cookie, and Server
  13269.          variables can be found in the global associative arrays
  13270.          <TT
  13271. CLASS="varname"
  13272. >$_ENV</TT
  13273. >,
  13274.          <TT
  13275. CLASS="varname"
  13276. >$_GET</TT
  13277. >,
  13278.          <TT
  13279. CLASS="varname"
  13280. >$_POST</TT
  13281. >,
  13282.          <TT
  13283. CLASS="varname"
  13284. >$_COOKIE</TT
  13285. >, and
  13286.          <TT
  13287. CLASS="varname"
  13288. >$_SERVER</TT
  13289. >.
  13290.         </P
  13291. ><P
  13292. >          Note that as of PHP 4.0.3, <SPAN
  13293. CLASS="systemitem"
  13294. >track_vars</SPAN
  13295. > is always turned on.
  13296.         </P
  13297. ></DD
  13298. ><DT
  13299. ><A
  13300. NAME="ini.arg-separator.output"
  13301. ></A
  13302. ><TT
  13303. CLASS="parameter"
  13304. ><I
  13305. >arg_separator.output</I
  13306. ></TT
  13307. >
  13308.         <A
  13309. HREF="#language.types.string"
  13310. ><B
  13311. CLASS="type"
  13312. >string</B
  13313. ></A
  13314. ></DT
  13315. ><DD
  13316. ><P
  13317. >          The separator used in PHP generated URLs to separate arguments.
  13318.         </P
  13319. ></DD
  13320. ><DT
  13321. ><A
  13322. NAME="ini.arg-separator.input"
  13323. ></A
  13324. ><TT
  13325. CLASS="parameter"
  13326. ><I
  13327. >arg_separator.input</I
  13328. ></TT
  13329. >
  13330.         <A
  13331. HREF="#language.types.string"
  13332. ><B
  13333. CLASS="type"
  13334. >string</B
  13335. ></A
  13336. ></DT
  13337. ><DD
  13338. ><P
  13339. >          List of separator(s) used by PHP to parse input URLs into variables.
  13340.         </P
  13341. ><DIV
  13342. CLASS="note"
  13343. ><BLOCKQUOTE
  13344. CLASS="note"
  13345. ><P
  13346. ><B
  13347. >Poznßmka: </B
  13348. >
  13349.           Every character in this directive is considered as separator!
  13350.          </P
  13351. ></BLOCKQUOTE
  13352. ></DIV
  13353. ></DD
  13354. ><DT
  13355. ><A
  13356. NAME="ini.variables-order"
  13357. ></A
  13358. ><TT
  13359. CLASS="parameter"
  13360. ><I
  13361. >variables_order</I
  13362. ></TT
  13363. >
  13364.         <A
  13365. HREF="#language.types.string"
  13366. ><B
  13367. CLASS="type"
  13368. >string</B
  13369. ></A
  13370. ></DT
  13371. ><DD
  13372. ><P
  13373. >          Set the order of the EGPCS (Environment, GET, POST, Cookie,
  13374.          Server) variable parsing. The default setting of this
  13375.          directive is "EGPCS". Setting this to "GP", for example,
  13376.          will cause PHP to completely ignore environment variables,
  13377.          cookies and server variables, and to overwrite any GET
  13378.          method variables with POST-method variables of the same name.
  13379.         </P
  13380. ><P
  13381. >          See also <A
  13382. HREF="#ini.register-globals"
  13383. >register_globals</A
  13384. >.
  13385.         </P
  13386. ></DD
  13387. ><DT
  13388. ><A
  13389. NAME="ini.register-globals"
  13390. ></A
  13391. ><TT
  13392. CLASS="parameter"
  13393. ><I
  13394. >register_globals</I
  13395. ></TT
  13396. >
  13397.         <A
  13398. HREF="#language.types.boolean"
  13399. ><B
  13400. CLASS="type"
  13401. >boolean</B
  13402. ></A
  13403. ></DT
  13404. ><DD
  13405. ><P
  13406. >          Tells whether or not to register the EGPCS (Environment, GET,
  13407.          POST, Cookie, Server) variables as global variables. For example;
  13408.          if register_globals = on, the url 
  13409.          <TT
  13410. CLASS="literal"
  13411. >http://www.example.com/test.php?id=3</TT
  13412. > will produce
  13413.          <TT
  13414. CLASS="varname"
  13415. >$id</TT
  13416. >. Or, <TT
  13417. CLASS="varname"
  13418. >$DOCUMENT_ROOT</TT
  13419. > from
  13420.          <TT
  13421. CLASS="varname"
  13422. >$_SERVER['DOCUMENT_ROOT']</TT
  13423. >. You may want to turn
  13424.          this off if you don't want to clutter your scripts' global scope with
  13425.          user data.  As of PHP <A
  13426. HREF="http://www.php.net/release_4_2_0.php"
  13427. TARGET="_top"
  13428. >4.2.0</A
  13429. >,
  13430.          this directive defaults to <SPAN
  13431. CLASS="emphasis"
  13432. ><I
  13433. CLASS="emphasis"
  13434. >off</I
  13435. ></SPAN
  13436. >.  It's preferred to
  13437.          go through PHP <A
  13438. HREF="#reserved.variables"
  13439. >Predefined Variables
  13440.          </A
  13441. > instead, such as the 
  13442.          <A
  13443. HREF="#language.variables.superglobals"
  13444. >superglobals</A
  13445. >:
  13446.          <TT
  13447. CLASS="varname"
  13448. >$_ENV</TT
  13449. >, <TT
  13450. CLASS="varname"
  13451. >$_GET</TT
  13452. >,
  13453.          <TT
  13454. CLASS="varname"
  13455. >$_POST</TT
  13456. >, <TT
  13457. CLASS="varname"
  13458. >$_COOKIE</TT
  13459. >, and
  13460.          <TT
  13461. CLASS="varname"
  13462. >$_SERVER</TT
  13463. >. Please read the security chapter on
  13464.          <A
  13465. HREF="#security.registerglobals"
  13466. >Using register_globals</A
  13467. >
  13468.          for related information.
  13469.         </P
  13470. ><P
  13471. >          Please note that <SPAN
  13472. CLASS="systemitem"
  13473. >register_globals</SPAN
  13474. >
  13475.          cannot be set at runtime (<A
  13476. HREF="#function.ini-set"
  13477. ><B
  13478. CLASS="function"
  13479. >ini_set()</B
  13480. ></A
  13481. >). Although, you can
  13482.          use <TT
  13483. CLASS="filename"
  13484. >.htaccess</TT
  13485. > if your host allows it as described
  13486.          above. An example <TT
  13487. CLASS="filename"
  13488. >.htaccess</TT
  13489. > entry:
  13490.          <TT
  13491. CLASS="userinput"
  13492. ><B
  13493. >php_flag register_globals on</B
  13494. ></TT
  13495. >.
  13496.         </P
  13497. ><DIV
  13498. CLASS="note"
  13499. ><BLOCKQUOTE
  13500. CLASS="note"
  13501. ><P
  13502. ><B
  13503. >Poznßmka: </B
  13504. >
  13505.           <SPAN
  13506. CLASS="systemitem"
  13507. >register_globals</SPAN
  13508. > is affected 
  13509.           by the <A
  13510. HREF="#ini.variables-order"
  13511. >variables_order</A
  13512. > 
  13513.           directive.
  13514.          </P
  13515. ></BLOCKQUOTE
  13516. ></DIV
  13517. ></DD
  13518. ><DT
  13519. ><A
  13520. NAME="ini.register-argc-argv"
  13521. ></A
  13522. ><TT
  13523. CLASS="parameter"
  13524. ><I
  13525. >register_argc_argv</I
  13526. ></TT
  13527. >
  13528.         <A
  13529. HREF="#language.types.boolean"
  13530. ><B
  13531. CLASS="type"
  13532. >boolean</B
  13533. ></A
  13534. ></DT
  13535. ><DD
  13536. ><P
  13537. >          Tells PHP whether to declare the argv & argc variables 
  13538.          (that would contain the GET information).
  13539.         </P
  13540. ><P
  13541. >          See also <A
  13542. HREF="#features.commandline"
  13543. >command line</A
  13544. >.
  13545.          Also, this directive became available in PHP 4.0.0 and
  13546.          was always "on" before that.
  13547.         </P
  13548. ></DD
  13549. ><DT
  13550. ><A
  13551. NAME="ini.register-long-arrays"
  13552. ></A
  13553. ><TT
  13554. CLASS="parameter"
  13555. ><I
  13556. >register_long_arrays</I
  13557. ></TT
  13558. >
  13559.         <A
  13560. HREF="#language.types.boolean"
  13561. ><B
  13562. CLASS="type"
  13563. >boolean</B
  13564. ></A
  13565. ></DT
  13566. ><DD
  13567. ><P
  13568. >          Tells PHP whether or not to register the deprecated long 
  13569.          <TT
  13570. CLASS="varname"
  13571. >$HTTP_*_VARS</TT
  13572. > type 
  13573.          <A
  13574. HREF="#language.variables.predefined"
  13575. >predefined 
  13576.          variables</A
  13577. >.  When On (default), long predefined PHP
  13578.          variables like <TT
  13579. CLASS="varname"
  13580. >$HTTP_GET_VARS</TT
  13581. > will be defined.
  13582.          If you're not using them, it's recommended to turn them off,
  13583.          for performance reasons.  Instead, use the superglobal arrays,
  13584.          like <TT
  13585. CLASS="varname"
  13586. >$_GET</TT
  13587. >.
  13588.         </P
  13589. ><P
  13590. >          This directive became available in PHP 5.0.0.
  13591.         </P
  13592. ></DD
  13593. ><DT
  13594. ><A
  13595. NAME="ini.post-max-size"
  13596. ></A
  13597. ><TT
  13598. CLASS="parameter"
  13599. ><I
  13600. >post_max_size</I
  13601. ></TT
  13602. >
  13603.         <A
  13604. HREF="#language.types.integer"
  13605. ><B
  13606. CLASS="type"
  13607. >integer</B
  13608. ></A
  13609. ></DT
  13610. ><DD
  13611. ><P
  13612. >          Sets max size of post data allowed. This setting also affects
  13613.          file upload. To upload large files, this value must be larger
  13614.          than <A
  13615. HREF="#ini.upload-max-filesize"
  13616. >upload_max_filesize</A
  13617. >.
  13618.         </P
  13619. ><P
  13620. >          If memory limit is enabled by your configure script, <A
  13621. HREF="#ini.memory-limit"
  13622. >memory_limit</A
  13623. > also affects
  13624.          file uploading. Generally speaking,
  13625.          <A
  13626. HREF="#ini.memory-limit"
  13627. >memory_limit</A
  13628. > should be
  13629.          larger than <TT
  13630. CLASS="parameter"
  13631. ><I
  13632. >post_max_size</I
  13633. ></TT
  13634. >.
  13635.         </P
  13636. ></DD
  13637. ><DT
  13638. ><A
  13639. NAME="ini.gpc-order"
  13640. ></A
  13641. ><TT
  13642. CLASS="parameter"
  13643. ><I
  13644. >gpc_order</I
  13645. ></TT
  13646. >
  13647.         <A
  13648. HREF="#language.types.string"
  13649. ><B
  13650. CLASS="type"
  13651. >string</B
  13652. ></A
  13653. ></DT
  13654. ><DD
  13655. ><P
  13656. >          Set the order of GET/POST/COOKIE variable parsing. The
  13657.          default setting of this directive is "GPC".  Setting this to
  13658.          "GP", for example, will cause PHP to completely ignore cookies
  13659.          and to overwrite any GET method variables with POST-method
  13660.          variables of the same name.
  13661.         </P
  13662. ><DIV
  13663. CLASS="note"
  13664. ><BLOCKQUOTE
  13665. CLASS="note"
  13666. ><P
  13667. ><B
  13668. >Poznßmka: </B
  13669. >
  13670.           This option is not available in PHP 4.
  13671.           Use <A
  13672. HREF="#ini.variables-order"
  13673. >variables_order</A
  13674. >
  13675.           instead.
  13676.          </P
  13677. ></BLOCKQUOTE
  13678. ></DIV
  13679. ></DD
  13680. ><DT
  13681. ><A
  13682. NAME="ini.auto-prepend-file"
  13683. ></A
  13684. ><TT
  13685. CLASS="parameter"
  13686. ><I
  13687. >auto_prepend_file</I
  13688. ></TT
  13689. >
  13690.         <A
  13691. HREF="#language.types.string"
  13692. ><B
  13693. CLASS="type"
  13694. >string</B
  13695. ></A
  13696. ></DT
  13697. ><DD
  13698. ><P
  13699. >          Specifies the name of a file that is automatically parsed
  13700.          before the main file.  The file is included as if it was
  13701.          called with the <A
  13702. HREF="#function.include"
  13703. ><B
  13704. CLASS="function"
  13705. >include()</B
  13706. ></A
  13707. > function, so
  13708.          <A
  13709. HREF="#ini.include-path"
  13710. >include_path</A
  13711. > is used.</P
  13712. ><P
  13713. >          The special value <SPAN
  13714. CLASS="systemitem"
  13715. >none</SPAN
  13716. > 
  13717.          disables auto-prepending.
  13718.         </P
  13719. ></DD
  13720. ><DT
  13721. ><A
  13722. NAME="ini.auto-append-file"
  13723. ></A
  13724. ><TT
  13725. CLASS="parameter"
  13726. ><I
  13727. >auto_append_file</I
  13728. ></TT
  13729. >
  13730.         <A
  13731. HREF="#language.types.string"
  13732. ><B
  13733. CLASS="type"
  13734. >string</B
  13735. ></A
  13736. ></DT
  13737. ><DD
  13738. ><P
  13739. >          Specifies the name of a file that is automatically parsed
  13740.          after the main file.  The file is included as if it was
  13741.          called with the <A
  13742. HREF="#function.include"
  13743. ><B
  13744. CLASS="function"
  13745. >include()</B
  13746. ></A
  13747. > function, so
  13748.          <A
  13749. HREF="#ini.include-path"
  13750. >include_path</A
  13751. > is used.</P
  13752. ><P
  13753. >          The special value <SPAN
  13754. CLASS="systemitem"
  13755. >none</SPAN
  13756. > 
  13757.          disables auto-appending.
  13758.          <DIV
  13759. CLASS="note"
  13760. ><BLOCKQUOTE
  13761. CLASS="note"
  13762. ><P
  13763. ><B
  13764. >Poznßmka: </B
  13765. >
  13766.            If the script is terminated with <A
  13767. HREF="#function.exit"
  13768. ><B
  13769. CLASS="function"
  13770. >exit()</B
  13771. ></A
  13772. >,
  13773.            auto-append will <SPAN
  13774. CLASS="emphasis"
  13775. ><I
  13776. CLASS="emphasis"
  13777. >not</I
  13778. ></SPAN
  13779. > occur.</P
  13780. ></BLOCKQUOTE
  13781. ></DIV
  13782. >
  13783.         </P
  13784. ></DD
  13785. ><DT
  13786. ><A
  13787. NAME="ini.default-mimetype"
  13788. ></A
  13789. ><TT
  13790. CLASS="parameter"
  13791. ><I
  13792. >default_mimetype</I
  13793. ></TT
  13794. >
  13795.         <A
  13796. HREF="#language.types.string"
  13797. ><B
  13798. CLASS="type"
  13799. >string</B
  13800. ></A
  13801. ></DT
  13802. ><DD
  13803. ><P
  13804. >         </P
  13805. ></DD
  13806. ><DT
  13807. ><A
  13808. NAME="ini.default-charset"
  13809. ></A
  13810. ><TT
  13811. CLASS="parameter"
  13812. ><I
  13813. >default_charset</I
  13814. ></TT
  13815. >
  13816.         <A
  13817. HREF="#language.types.string"
  13818. ><B
  13819. CLASS="type"
  13820. >string</B
  13821. ></A
  13822. ></DT
  13823. ><DD
  13824. ><P
  13825. >          As of 4.0b4, PHP always outputs a character encoding by default in
  13826.          the Content-type: header. To disable sending of the charset, simply
  13827.          set it to be empty.
  13828.         </P
  13829. ></DD
  13830. ><DT
  13831. ><A
  13832. NAME="ini.always-populate-raw-post-data"
  13833. ></A
  13834. ><TT
  13835. CLASS="parameter"
  13836. ><I
  13837. >always_populate_raw_post_data</I
  13838. ></TT
  13839. >
  13840.         <A
  13841. HREF="#language.types.boolean"
  13842. ><B
  13843. CLASS="type"
  13844. >boolean</B
  13845. ></A
  13846. ></DT
  13847. ><DD
  13848. ><P
  13849. >          Always populate the $HTTP_RAW_POST_DATA variable.
  13850.         </P
  13851. ></DD
  13852. ><DT
  13853. ><A
  13854. NAME="ini.allow-webdav-methods"
  13855. ></A
  13856. ><TT
  13857. CLASS="parameter"
  13858. ><I
  13859. >allow_webdav_methods</I
  13860. ></TT
  13861. >
  13862.         <A
  13863. HREF="#language.types.boolean"
  13864. ><B
  13865. CLASS="type"
  13866. >boolean</B
  13867. ></A
  13868. ></DT
  13869. ><DD
  13870. ><P
  13871. >          Allow handling of WebDAV http requests within PHP scripts (eg.
  13872.          PROPFIND, PROPPATCH, MOVE, COPY, etc..)
  13873.          If you want to get the post data of those requests, you have to
  13874.          set <A
  13875. HREF="#ini.always-populate-raw-post-data"
  13876. >          always_populate_raw_post_data</A
  13877. > as well.
  13878.         </P
  13879. ></DD
  13880. ></DL
  13881. ></DIV
  13882. >
  13883.     </P
  13884. ><P
  13885. >      See also: <A
  13886. HREF="#ini.magic-quotes-gpc"
  13887. >magic_quotes_gpc</A
  13888. >,
  13889.      <A
  13890. HREF="#ini.magic-quotes-runtime"
  13891. >magic-quotes-runtime</A
  13892. >,
  13893.      and
  13894.      <A
  13895. HREF="#ini.magic-quotes-sybase"
  13896. >magic_quotes_sybase</A
  13897. >.
  13898.     </P
  13899. ></DIV
  13900. ><DIV
  13901. CLASS="sect2"
  13902. ><HR><H3
  13903. CLASS="sect2"
  13904. ><A
  13905. NAME="ini.sect.path-directory"
  13906. ></A
  13907. >Paths and Directories</H3
  13908. ><P
  13909. >      <DIV
  13910. CLASS="table"
  13911. ><A
  13912. NAME="AEN2944"
  13913. ></A
  13914. ><P
  13915. ><B
  13916. >Tabulka 4-6. Paths and Directories Configuration Options</B
  13917. ></P
  13918. ><TABLE
  13919. BORDER="1"
  13920. CLASS="CALSTABLE"
  13921. ><THEAD
  13922. ><TR
  13923. ><TH
  13924. ALIGN="LEFT"
  13925. VALIGN="MIDDLE"
  13926. >Name</TH
  13927. ><TH
  13928. ALIGN="LEFT"
  13929. VALIGN="MIDDLE"
  13930. >Default</TH
  13931. ><TH
  13932. ALIGN="LEFT"
  13933. VALIGN="MIDDLE"
  13934. >Changeable</TH
  13935. ></TR
  13936. ></THEAD
  13937. ><TBODY
  13938. ><TR
  13939. ><TD
  13940. ALIGN="LEFT"
  13941. VALIGN="MIDDLE"
  13942. >include_path</TD
  13943. ><TD
  13944. ALIGN="LEFT"
  13945. VALIGN="MIDDLE"
  13946. >PHP_INCLUDE_PATH</TD
  13947. ><TD
  13948. ALIGN="LEFT"
  13949. VALIGN="MIDDLE"
  13950. >PHP_INI_ALL</TD
  13951. ></TR
  13952. ><TR
  13953. ><TD
  13954. ALIGN="LEFT"
  13955. VALIGN="MIDDLE"
  13956. >doc_root</TD
  13957. ><TD
  13958. ALIGN="LEFT"
  13959. VALIGN="MIDDLE"
  13960. >PHP_INCLUDE_PATH</TD
  13961. ><TD
  13962. ALIGN="LEFT"
  13963. VALIGN="MIDDLE"
  13964. >PHP_INI_SYSTEM</TD
  13965. ></TR
  13966. ><TR
  13967. ><TD
  13968. ALIGN="LEFT"
  13969. VALIGN="MIDDLE"
  13970. >user_dir</TD
  13971. ><TD
  13972. ALIGN="LEFT"
  13973. VALIGN="MIDDLE"
  13974. >NULL</TD
  13975. ><TD
  13976. ALIGN="LEFT"
  13977. VALIGN="MIDDLE"
  13978. >PHP_INI_SYSTEM</TD
  13979. ></TR
  13980. ><TR
  13981. ><TD
  13982. ALIGN="LEFT"
  13983. VALIGN="MIDDLE"
  13984. >extension_dir</TD
  13985. ><TD
  13986. ALIGN="LEFT"
  13987. VALIGN="MIDDLE"
  13988. >PHP_EXTENSION_DIR</TD
  13989. ><TD
  13990. ALIGN="LEFT"
  13991. VALIGN="MIDDLE"
  13992. >PHP_INI_SYSTEM</TD
  13993. ></TR
  13994. ><TR
  13995. ><TD
  13996. ALIGN="LEFT"
  13997. VALIGN="MIDDLE"
  13998. >cgi.fix_pathinfo</TD
  13999. ><TD
  14000. ALIGN="LEFT"
  14001. VALIGN="MIDDLE"
  14002. >"0"</TD
  14003. ><TD
  14004. ALIGN="LEFT"
  14005. VALIGN="MIDDLE"
  14006. >PHP_INI_SYSTEM</TD
  14007. ></TR
  14008. ><TR
  14009. ><TD
  14010. ALIGN="LEFT"
  14011. VALIGN="MIDDLE"
  14012. >cgi.force_redirect</TD
  14013. ><TD
  14014. ALIGN="LEFT"
  14015. VALIGN="MIDDLE"
  14016. >"1"</TD
  14017. ><TD
  14018. ALIGN="LEFT"
  14019. VALIGN="MIDDLE"
  14020. >PHP_INI_SYSTEM</TD
  14021. ></TR
  14022. ><TR
  14023. ><TD
  14024. ALIGN="LEFT"
  14025. VALIGN="MIDDLE"
  14026. >cgi.redirect_status_env</TD
  14027. ><TD
  14028. ALIGN="LEFT"
  14029. VALIGN="MIDDLE"
  14030. >""</TD
  14031. ><TD
  14032. ALIGN="LEFT"
  14033. VALIGN="MIDDLE"
  14034. >PHP_INI_SYSTEM</TD
  14035. ></TR
  14036. ><TR
  14037. ><TD
  14038. ALIGN="LEFT"
  14039. VALIGN="MIDDLE"
  14040. >fastcgi.impersonate</TD
  14041. ><TD
  14042. ALIGN="LEFT"
  14043. VALIGN="MIDDLE"
  14044. >"0"</TD
  14045. ><TD
  14046. ALIGN="LEFT"
  14047. VALIGN="MIDDLE"
  14048. >PHP_INI_SYSTEM</TD
  14049. ></TR
  14050. ><TR
  14051. ><TD
  14052. ALIGN="LEFT"
  14053. VALIGN="MIDDLE"
  14054. >cgi.rfc2616_headers</TD
  14055. ><TD
  14056. ALIGN="LEFT"
  14057. VALIGN="MIDDLE"
  14058. >"0"</TD
  14059. ><TD
  14060. ALIGN="LEFT"
  14061. VALIGN="MIDDLE"
  14062. >PHP_INI_SYSTEM</TD
  14063. ></TR
  14064. ></TBODY
  14065. ></TABLE
  14066. ></DIV
  14067. >
  14068.     </P
  14069. ><P
  14070. >Zde je struΦnΘ vysv∞tlenφ
  14071. konfiguraΦnφch direktiv.</P
  14072. ><P
  14073. >      <P
  14074. ></P
  14075. ><DIV
  14076. CLASS="variablelist"
  14077. ><DL
  14078. ><DT
  14079. ><A
  14080. NAME="ini.include-path"
  14081. ></A
  14082. ><TT
  14083. CLASS="parameter"
  14084. ><I
  14085. >include_path</I
  14086. ></TT
  14087. >
  14088.         <A
  14089. HREF="#language.types.string"
  14090. ><B
  14091. CLASS="type"
  14092. >string</B
  14093. ></A
  14094. ></DT
  14095. ><DD
  14096. ><P
  14097. >          Specifies a list of directories where the
  14098.          <A
  14099. HREF="#function.require"
  14100. ><B
  14101. CLASS="function"
  14102. >require()</B
  14103. ></A
  14104. >, <A
  14105. HREF="#function.include"
  14106. ><B
  14107. CLASS="function"
  14108. >include()</B
  14109. ></A
  14110. >
  14111.          and <B
  14112. CLASS="function"
  14113. >fopen_with_path()</B
  14114. > functions look for
  14115.          files.  The format is like the system's <TT
  14116. CLASS="envar"
  14117. >PATH</TT
  14118. >
  14119.          environment variable: a list of directories separated with a
  14120.          colon in Unix or semicolon in Windows.
  14121.         </P
  14122. ><P
  14123. >          <TABLE
  14124. WIDTH="100%"
  14125. BORDER="0"
  14126. CELLPADDING="0"
  14127. CELLSPACING="0"
  14128. CLASS="EXAMPLE"
  14129. ><TR
  14130. ><TD
  14131. ><DIV
  14132. CLASS="example"
  14133. ><A
  14134. NAME="AEN3003"
  14135. ></A
  14136. ><P
  14137. ><B
  14138. >P°φklad 4-3. Unix include_path</B
  14139. ></P
  14140. ><TABLE
  14141. BORDER="0"
  14142. BGCOLOR="#E0E0E0"
  14143. CELLPADDING="5"
  14144. ><TR
  14145. ><TD
  14146. ><PRE
  14147. CLASS="php.ini"
  14148. >include_path=".:/php/includes"</PRE
  14149. ></TD
  14150. ></TR
  14151. ></TABLE
  14152. ></DIV
  14153. ></TD
  14154. ></TR
  14155. ></TABLE
  14156. >
  14157.         </P
  14158. ><P
  14159. >          <TABLE
  14160. WIDTH="100%"
  14161. BORDER="0"
  14162. CELLPADDING="0"
  14163. CELLSPACING="0"
  14164. CLASS="EXAMPLE"
  14165. ><TR
  14166. ><TD
  14167. ><DIV
  14168. CLASS="example"
  14169. ><A
  14170. NAME="AEN3007"
  14171. ></A
  14172. ><P
  14173. ><B
  14174. >P°φklad 4-4. Windows include_path</B
  14175. ></P
  14176. ><TABLE
  14177. BORDER="0"
  14178. BGCOLOR="#E0E0E0"
  14179. CELLPADDING="5"
  14180. ><TR
  14181. ><TD
  14182. ><PRE
  14183. CLASS="php.ini"
  14184. >include_path=".;c:\php\includes"</PRE
  14185. ></TD
  14186. ></TR
  14187. ></TABLE
  14188. ></DIV
  14189. ></TD
  14190. ></TR
  14191. ></TABLE
  14192. >
  14193.         </P
  14194. ><P
  14195. >          Using a <TT
  14196. CLASS="literal"
  14197. >.</TT
  14198. > in the include path allows for
  14199.          relative includes as it means the current directory.
  14200.         </P
  14201. ></DD
  14202. ><DT
  14203. ><A
  14204. NAME="ini.doc-root"
  14205. ></A
  14206. ><TT
  14207. CLASS="parameter"
  14208. ><I
  14209. >doc_root</I
  14210. ></TT
  14211. >
  14212.         <A
  14213. HREF="#language.types.string"
  14214. ><B
  14215. CLASS="type"
  14216. >string</B
  14217. ></A
  14218. ></DT
  14219. ><DD
  14220. ><P
  14221. >          PHP's "root directory" on the server. Only used if
  14222.          non-empty. If PHP is configured with <A
  14223. HREF="#ini.safe-mode"
  14224. >bezpeΦn² re╛im</A
  14225. >, no files outside
  14226.          this directory are served.
  14227.          If PHP was not compiled with FORCE_REDIRECT, you SHOULD set doc_root
  14228.          if you are running PHP as a CGI under any web server (other than IIS)
  14229.          The alternative is to use the <A
  14230. HREF="#ini.cgi.force-redirect"
  14231. >          cgi.force_redirect</A
  14232. > configuration below.
  14233.         </P
  14234. ></DD
  14235. ><DT
  14236. ><A
  14237. NAME="ini.user-dir"
  14238. ></A
  14239. ><TT
  14240. CLASS="parameter"
  14241. ><I
  14242. >user_dir</I
  14243. ></TT
  14244. >
  14245.         <A
  14246. HREF="#language.types.string"
  14247. ><B
  14248. CLASS="type"
  14249. >string</B
  14250. ></A
  14251. ></DT
  14252. ><DD
  14253. ><P
  14254. >          The base name of the directory used on a user's home
  14255.          directory for <TT
  14256. CLASS="literal"
  14257. >PHP</TT
  14258. > files, for example
  14259.          <TT
  14260. CLASS="literal"
  14261. >public_html</TT
  14262. >.
  14263.         </P
  14264. ></DD
  14265. ><DT
  14266. ><A
  14267. NAME="ini.extension-dir"
  14268. ></A
  14269. ><TT
  14270. CLASS="parameter"
  14271. ><I
  14272. >extension_dir</I
  14273. ></TT
  14274. >
  14275.         <A
  14276. HREF="#language.types.string"
  14277. ><B
  14278. CLASS="type"
  14279. >string</B
  14280. ></A
  14281. ></DT
  14282. ><DD
  14283. ><P
  14284. >          In what directory PHP should look for dynamically loadable
  14285.          extensions. See also: <A
  14286. HREF="#ini.enable-dl"
  14287. >enable_dl</A
  14288. >,
  14289.          and <A
  14290. HREF="#function.dl"
  14291. ><B
  14292. CLASS="function"
  14293. >dl()</B
  14294. ></A
  14295. >.
  14296.         </P
  14297. ></DD
  14298. ><DT
  14299. ><A
  14300. NAME="ini.extension"
  14301. ></A
  14302. ><TT
  14303. CLASS="parameter"
  14304. ><I
  14305. >extension</I
  14306. ></TT
  14307. >
  14308.         <A
  14309. HREF="#language.types.string"
  14310. ><B
  14311. CLASS="type"
  14312. >string</B
  14313. ></A
  14314. ></DT
  14315. ><DD
  14316. ><P
  14317. >          Which dynamically loadable extensions to load when PHP starts
  14318.          up.
  14319.         </P
  14320. ></DD
  14321. ><DT
  14322. ><A
  14323. NAME="ini.cgi.fix_pathinfo"
  14324. ></A
  14325. ><TT
  14326. CLASS="parameter"
  14327. ><I
  14328. >cgi.fix_pathinfo</I
  14329. ></TT
  14330. >
  14331.         <A
  14332. HREF="#language.types.boolean"
  14333. ><B
  14334. CLASS="type"
  14335. >boolean</B
  14336. ></A
  14337. ></DT
  14338. ><DD
  14339. ><P
  14340. >          Provides <SPAN
  14341. CLASS="emphasis"
  14342. ><I
  14343. CLASS="emphasis"
  14344. >real</I
  14345. ></SPAN
  14346. > PATH_INFO/PATH_TRANSLATED
  14347.          support for CGI.  PHP's previous behaviour was to set
  14348.          PATH_TRANSLATED to SCRIPT_FILENAME, and to not grok what PATH_INFO
  14349.          is.  For more information on PATH_INFO, see the cgi specs.  Setting
  14350.          this to 1 will cause PHP CGI to fix it's paths to conform to the
  14351.          spec.  A setting of zero causes PHP to behave as before.  Default
  14352.          is zero.  You should fix your scripts to use SCRIPT_FILENAME rather
  14353.          than PATH_TRANSLATED.
  14354.         </P
  14355. ></DD
  14356. ><DT
  14357. ><A
  14358. NAME="ini.cgi.force-redirect"
  14359. ></A
  14360. ><TT
  14361. CLASS="parameter"
  14362. ><I
  14363. >cgi.force_redirect</I
  14364. ></TT
  14365. >
  14366.         <A
  14367. HREF="#language.types.boolean"
  14368. ><B
  14369. CLASS="type"
  14370. >boolean</B
  14371. ></A
  14372. ></DT
  14373. ><DD
  14374. ><P
  14375. >          cgi.force_redirect is necessary to provide security running PHP as a
  14376.          CGI under most web servers. Left undefined, PHP turns this on by
  14377.          default. You can turn it off <SPAN
  14378. CLASS="emphasis"
  14379. ><I
  14380. CLASS="emphasis"
  14381. >AT YOUR OWN RISK</I
  14382. ></SPAN
  14383. >.
  14384.         </P
  14385. ><DIV
  14386. CLASS="note"
  14387. ><BLOCKQUOTE
  14388. CLASS="note"
  14389. ><P
  14390. ><B
  14391. >Poznßmka: </B
  14392. >
  14393.           Windows Users: You CAN safely turn this off for IIS, in fact, you MUST.
  14394.           To get OmniHTTPD or Xitami to work you MUST turn it off.
  14395.          </P
  14396. ></BLOCKQUOTE
  14397. ></DIV
  14398. ></DD
  14399. ><DT
  14400. ><A
  14401. NAME="ini.cgi.redirect-status-env"
  14402. ></A
  14403. ><TT
  14404. CLASS="parameter"
  14405. ><I
  14406. >cgi.redirect_status_env</I
  14407. ></TT
  14408. >
  14409.         <A
  14410. HREF="#language.types.string"
  14411. ><B
  14412. CLASS="type"
  14413. >string</B
  14414. ></A
  14415. ></DT
  14416. ><DD
  14417. ><P
  14418. >          If cgi.force_redirect is turned on, and you are not running under
  14419.          Apache or Netscape (iPlanet) web servers, you MAY need to set an
  14420.          environment variable name that PHP will look for to know it is OK
  14421.          to continue execution.
  14422.         </P
  14423. ><DIV
  14424. CLASS="note"
  14425. ><BLOCKQUOTE
  14426. CLASS="note"
  14427. ><P
  14428. ><B
  14429. >Poznßmka: </B
  14430. >
  14431.           Setting this variable MAY cause security issues,
  14432.           KNOW WHAT YOU ARE DOING FIRST.
  14433.          </P
  14434. ></BLOCKQUOTE
  14435. ></DIV
  14436. ></DD
  14437. ><DT
  14438. ><A
  14439. NAME="ini.fastcgi.impersonate"
  14440. ></A
  14441. ><TT
  14442. CLASS="parameter"
  14443. ><I
  14444. >fastcgi.impersonate</I
  14445. ></TT
  14446. >
  14447.         <A
  14448. HREF="#language.types.string"
  14449. ><B
  14450. CLASS="type"
  14451. >string</B
  14452. ></A
  14453. ></DT
  14454. ><DD
  14455. ><P
  14456. >          FastCGI under IIS (on WINNT based OS) supports the ability to impersonate
  14457.          security tokens of the calling client. This allows IIS to define the
  14458.          security context that the request runs under. mod_fastcgi under Apache
  14459.          does not currently support this feature (03/17/2002)
  14460.          Set to 1 if running under IIS. Default is zero.
  14461.         </P
  14462. ></DD
  14463. ><DT
  14464. ><A
  14465. NAME="ini.cgi.rfc2616-headers"
  14466. ></A
  14467. ><TT
  14468. CLASS="parameter"
  14469. ><I
  14470. >cgi.rfc2616_headers</I
  14471. ></TT
  14472. >
  14473.         <A
  14474. HREF="#language.types.integer"
  14475. ><B
  14476. CLASS="type"
  14477. >int</B
  14478. ></A
  14479. ></DT
  14480. ><DD
  14481. ><P
  14482. >          Tells PHP what type of headers to use when sending HTTP response
  14483.          code. If it's set 0, PHP sends a Status: header that is supported
  14484.          by Apache and other web servers. When this option is set to 1, PHP
  14485.          will send <A
  14486. HREF="http://www.faqs.org/rfcs/rfc2616"
  14487. TARGET="_top"
  14488. >RFC 2616</A
  14489. > compliant
  14490.          headers.  Leave it set to 0 unless you know what you're doing.
  14491.         </P
  14492. ></DD
  14493. ></DL
  14494. ></DIV
  14495. >
  14496.     </P
  14497. ></DIV
  14498. ><DIV
  14499. CLASS="sect2"
  14500. ><HR><H3
  14501. CLASS="sect2"
  14502. ><A
  14503. NAME="ini.sect.file_uploads"
  14504. ></A
  14505. >File Uploads</H3
  14506. ><P
  14507. >      <DIV
  14508. CLASS="table"
  14509. ><A
  14510. NAME="AEN3082"
  14511. ></A
  14512. ><P
  14513. ><B
  14514. >Tabulka 4-7. File Uploads Configuration Options</B
  14515. ></P
  14516. ><TABLE
  14517. BORDER="1"
  14518. CLASS="CALSTABLE"
  14519. ><THEAD
  14520. ><TR
  14521. ><TH
  14522. ALIGN="LEFT"
  14523. VALIGN="MIDDLE"
  14524. >Name</TH
  14525. ><TH
  14526. ALIGN="LEFT"
  14527. VALIGN="MIDDLE"
  14528. >Default</TH
  14529. ><TH
  14530. ALIGN="LEFT"
  14531. VALIGN="MIDDLE"
  14532. >Changeable</TH
  14533. ></TR
  14534. ></THEAD
  14535. ><TBODY
  14536. ><TR
  14537. ><TD
  14538. ALIGN="LEFT"
  14539. VALIGN="MIDDLE"
  14540. >file_uploads</TD
  14541. ><TD
  14542. ALIGN="LEFT"
  14543. VALIGN="MIDDLE"
  14544. >"1"</TD
  14545. ><TD
  14546. ALIGN="LEFT"
  14547. VALIGN="MIDDLE"
  14548. >PHP_INI_SYSTEM</TD
  14549. ></TR
  14550. ><TR
  14551. ><TD
  14552. ALIGN="LEFT"
  14553. VALIGN="MIDDLE"
  14554. >upload_tmp_dir</TD
  14555. ><TD
  14556. ALIGN="LEFT"
  14557. VALIGN="MIDDLE"
  14558. >NULL</TD
  14559. ><TD
  14560. ALIGN="LEFT"
  14561. VALIGN="MIDDLE"
  14562. >PHP_INI_SYSTEM</TD
  14563. ></TR
  14564. ><TR
  14565. ><TD
  14566. ALIGN="LEFT"
  14567. VALIGN="MIDDLE"
  14568. >upload_max_filesize</TD
  14569. ><TD
  14570. ALIGN="LEFT"
  14571. VALIGN="MIDDLE"
  14572. >"2M"</TD
  14573. ><TD
  14574. ALIGN="LEFT"
  14575. VALIGN="MIDDLE"
  14576. >PHP_INI_SYSTEM|PHP_INI_PERDIR</TD
  14577. ></TR
  14578. ></TBODY
  14579. ></TABLE
  14580. ></DIV
  14581. >
  14582.     </P
  14583. ><P
  14584. >Zde je struΦnΘ vysv∞tlenφ
  14585. konfiguraΦnφch direktiv.</P
  14586. ><P
  14587. >      <P
  14588. ></P
  14589. ><DIV
  14590. CLASS="variablelist"
  14591. ><DL
  14592. ><DT
  14593. ><A
  14594. NAME="ini.file-uploads"
  14595. ></A
  14596. ><TT
  14597. CLASS="parameter"
  14598. ><I
  14599. >file_uploads</I
  14600. ></TT
  14601. >
  14602.         <A
  14603. HREF="#language.types.boolean"
  14604. ><B
  14605. CLASS="type"
  14606. >boolean</B
  14607. ></A
  14608. ></DT
  14609. ><DD
  14610. ><P
  14611. >          Whether or not to allow HTTP
  14612.          <A
  14613. HREF="#features.file-upload"
  14614. >file uploads</A
  14615. >. See also 
  14616.          the 
  14617.          <A
  14618. HREF="#ini.upload-max-filesize"
  14619. >upload_max_filesize</A
  14620. >,
  14621.          <A
  14622. HREF="#ini.upload-tmp-dir"
  14623. >upload_tmp_dir</A
  14624. >, and 
  14625.          <A
  14626. HREF="#ini.post-max-size"
  14627. >post_max_size</A
  14628. > directives.
  14629.         </P
  14630. ></DD
  14631. ><DT
  14632. ><A
  14633. NAME="ini.upload-tmp-dir"
  14634. ></A
  14635. ><TT
  14636. CLASS="parameter"
  14637. ><I
  14638. >upload_tmp_dir</I
  14639. ></TT
  14640. >
  14641.         <A
  14642. HREF="#language.types.string"
  14643. ><B
  14644. CLASS="type"
  14645. >string</B
  14646. ></A
  14647. ></DT
  14648. ><DD
  14649. ><P
  14650. >          The temporary directory used for storing files when doing
  14651.          file upload. Must be writable by whatever user <TT
  14652. CLASS="literal"
  14653. >PHP</TT
  14654. >
  14655.          is running as. If not specified PHP will use the system's default.
  14656.         </P
  14657. ></DD
  14658. ><DT
  14659. ><A
  14660. NAME="ini.upload-max-filesize"
  14661. ></A
  14662. ><TT
  14663. CLASS="parameter"
  14664. ><I
  14665. >upload_max_filesize</I
  14666. ></TT
  14667. >
  14668.         <A
  14669. HREF="#language.types.integer"
  14670. ><B
  14671. CLASS="type"
  14672. >integer</B
  14673. ></A
  14674. ></DT
  14675. ><DD
  14676. ><P
  14677. >          The maximum size of an uploaded file.
  14678.         </P
  14679. ></DD
  14680. ></DL
  14681. ></DIV
  14682. >
  14683.     </P
  14684. ></DIV
  14685. ><DIV
  14686. CLASS="sect2"
  14687. ><HR><H3
  14688. CLASS="sect2"
  14689. ><A
  14690. NAME="ini.sql-general"
  14691. ></A
  14692. >General SQL</H3
  14693. ><P
  14694. >      <DIV
  14695. CLASS="table"
  14696. ><A
  14697. NAME="AEN3132"
  14698. ></A
  14699. ><P
  14700. ><B
  14701. >Tabulka 4-8. General SQL Configuration Options</B
  14702. ></P
  14703. ><TABLE
  14704. BORDER="1"
  14705. CLASS="CALSTABLE"
  14706. ><THEAD
  14707. ><TR
  14708. ><TH
  14709. ALIGN="LEFT"
  14710. VALIGN="MIDDLE"
  14711. >Name</TH
  14712. ><TH
  14713. ALIGN="LEFT"
  14714. VALIGN="MIDDLE"
  14715. >Default</TH
  14716. ><TH
  14717. ALIGN="LEFT"
  14718. VALIGN="MIDDLE"
  14719. >Changeable</TH
  14720. ></TR
  14721. ></THEAD
  14722. ><TBODY
  14723. ><TR
  14724. ><TD
  14725. ALIGN="LEFT"
  14726. VALIGN="MIDDLE"
  14727. >sql.safe_mode</TD
  14728. ><TD
  14729. ALIGN="LEFT"
  14730. VALIGN="MIDDLE"
  14731. >"0"</TD
  14732. ><TD
  14733. ALIGN="LEFT"
  14734. VALIGN="MIDDLE"
  14735. >PHP_INI_SYSTEM</TD
  14736. ></TR
  14737. ></TBODY
  14738. ></TABLE
  14739. ></DIV
  14740. >
  14741.     </P
  14742. ><P
  14743. >Zde je struΦnΘ vysv∞tlenφ
  14744. konfiguraΦnφch direktiv.</P
  14745. ><P
  14746. >      <P
  14747. ></P
  14748. ><DIV
  14749. CLASS="variablelist"
  14750. ><DL
  14751. ><DT
  14752. ><A
  14753. NAME="ini.sql.safe-mode"
  14754. ></A
  14755. ><TT
  14756. CLASS="parameter"
  14757. ><I
  14758. >sql.safe_mode</I
  14759. ></TT
  14760. >
  14761.         <A
  14762. HREF="#language.types.boolean"
  14763. ><B
  14764. CLASS="type"
  14765. >boolean</B
  14766. ></A
  14767. ></DT
  14768. ><DD
  14769. ><P
  14770. >         </P
  14771. ></DD
  14772. ></DL
  14773. ></DIV
  14774. >
  14775.     </P
  14776. ></DIV
  14777. ><DIV
  14778. CLASS="sect2"
  14779. ><HR><H3
  14780. CLASS="sect2"
  14781. ><A
  14782. NAME="ini.sect.debugger"
  14783. ></A
  14784. >Debugger Configuration Directives</H3
  14785. ><DIV
  14786. CLASS="caution"
  14787. ><P
  14788. ></P
  14789. ><TABLE
  14790. CLASS="caution"
  14791. BORDER="1"
  14792. WIDTH="100%"
  14793. ><TR
  14794. ><TD
  14795. ALIGN="CENTER"
  14796. ><B
  14797. >V²straha</B
  14798. ></TD
  14799. ></TR
  14800. ><TR
  14801. ><TD
  14802. ALIGN="LEFT"
  14803. ><P
  14804. >       Only PHP 3 implements a default debugger, for more information see <A
  14805. HREF="#debugger"
  14806. >D</A
  14807. >.
  14808.      </P
  14809. ></TD
  14810. ></TR
  14811. ></TABLE
  14812. ></DIV
  14813. ><P
  14814. ></P
  14815. ><DIV
  14816. CLASS="variablelist"
  14817. ><DL
  14818. ><DT
  14819. ><A
  14820. NAME="ini.debugger.host"
  14821. ></A
  14822. ><TT
  14823. CLASS="parameter"
  14824. ><I
  14825. >debugger.host</I
  14826. ></TT
  14827. >
  14828.        <A
  14829. HREF="#language.types.string"
  14830. ><B
  14831. CLASS="type"
  14832. >string</B
  14833. ></A
  14834. ></DT
  14835. ><DD
  14836. ><P
  14837. >         DNS name or IP address of host used by the debugger.
  14838.        </P
  14839. ></DD
  14840. ><DT
  14841. ><A
  14842. NAME="ini.debugger.port"
  14843. ></A
  14844. ><TT
  14845. CLASS="parameter"
  14846. ><I
  14847. >debugger.port</I
  14848. ></TT
  14849. >
  14850.        <A
  14851. HREF="#language.types.string"
  14852. ><B
  14853. CLASS="type"
  14854. >string</B
  14855. ></A
  14856. ></DT
  14857. ><DD
  14858. ><P
  14859. >         Port number used by the debugger.
  14860.        </P
  14861. ></DD
  14862. ><DT
  14863. ><A
  14864. NAME="ini.debugger.enabled"
  14865. ></A
  14866. ><TT
  14867. CLASS="parameter"
  14868. ><I
  14869. >debugger.enabled</I
  14870. ></TT
  14871. >
  14872.        <A
  14873. HREF="#language.types.boolean"
  14874. ><B
  14875. CLASS="type"
  14876. >boolean</B
  14877. ></A
  14878. ></DT
  14879. ><DD
  14880. ><P
  14881. >         Whether the debugger is enabled.
  14882.        </P
  14883. ></DD
  14884. ></DL
  14885. ></DIV
  14886. ></DIV
  14887. ></DIV
  14888. ></DIV
  14889. ></DIV
  14890. ><DIV
  14891. CLASS="PART"
  14892. ><A
  14893. NAME="langref"
  14894. ></A
  14895. ><DIV
  14896. CLASS="TITLEPAGE"
  14897. ><H1
  14898. CLASS="title"
  14899. >II. Reference jazyka</H1
  14900. ><DIV
  14901. CLASS="TOC"
  14902. ><DL
  14903. ><DT
  14904. ><B
  14905. >Obsah</B
  14906. ></DT
  14907. ><DT
  14908. >5. <A
  14909. HREF="#language.basic-syntax"
  14910. >Zßkladnφ syntaxe</A
  14911. ></DT
  14912. ><DT
  14913. >6. <A
  14914. HREF="#language.types"
  14915. >Types</A
  14916. ></DT
  14917. ><DT
  14918. >7. <A
  14919. HREF="#language.variables"
  14920. >Prom∞nnΘ</A
  14921. ></DT
  14922. ><DT
  14923. >8. <A
  14924. HREF="#language.constants"
  14925. >Konstanty</A
  14926. ></DT
  14927. ><DT
  14928. >9. <A
  14929. HREF="#language.expressions"
  14930. >V²razy</A
  14931. ></DT
  14932. ><DT
  14933. >10. <A
  14934. HREF="#language.operators"
  14935. >Operßtory</A
  14936. ></DT
  14937. ><DT
  14938. >11. <A
  14939. HREF="#control-structures"
  14940. >╪φdicφ struktury</A
  14941. ></DT
  14942. ><DT
  14943. >12. <A
  14944. HREF="#functions"
  14945. >Funkce</A
  14946. ></DT
  14947. ><DT
  14948. >13. <A
  14949. HREF="#language.oop"
  14950. >Classes and Objects</A
  14951. ></DT
  14952. ><DT
  14953. >14. <A
  14954. HREF="#language.references"
  14955. >Vysv∞tlenφ referencφ (odkaz∙)</A
  14956. ></DT
  14957. ></DL
  14958. ></DIV
  14959. ></DIV
  14960. ><DIV
  14961. CLASS="chapter"
  14962. ><HR><H1
  14963. ><A
  14964. NAME="language.basic-syntax"
  14965. >Kapitola 5. Zßkladnφ syntaxe</A
  14966. ></H1
  14967. ><DIV
  14968. CLASS="sect1"
  14969. ><H2
  14970. CLASS="sect1"
  14971. ><A
  14972. NAME="language.basic-syntax.phpmode"
  14973. ></A
  14974. >Opu╣t∞nφ HTML</H2
  14975. ><P
  14976. >     Jsou Φty°i zp∙soby jak opustit HTML a vstoupit to "PHP m≤du":
  14977.     </P
  14978. ><P
  14979. >      <TABLE
  14980. WIDTH="100%"
  14981. BORDER="0"
  14982. CELLPADDING="0"
  14983. CELLSPACING="0"
  14984. CLASS="EXAMPLE"
  14985. ><TR
  14986. ><TD
  14987. ><DIV
  14988. CLASS="example"
  14989. ><A
  14990. NAME="AEN3186"
  14991. ></A
  14992. ><P
  14993. ><B
  14994. >P°φklad 5-1. Zp∙soby opu╣t∞nφ HTML</B
  14995. ></P
  14996. ><TABLE
  14997. BORDER="0"
  14998. BGCOLOR="#E0E0E0"
  14999. CELLPADDING="5"
  15000. ><TR
  15001. ><TD
  15002. ><PRE
  15003. CLASS="programlisting"
  15004. >1.  <? echo ("toto je nejjednodu╣╣φ SGML zpracovatelskß instrukce\n"); ?>
  15005.  
  15006. 2.  <?php echo("pokud chcete zpracovßvat XHTML nebo XML dokumenty, pou╛φvejte toto\n"); ?>
  15007.  
  15008. 3.  <script language="php">
  15009.         echo ("n∞kterΘ editory (nap°φklad FrontPage) nemajφ zpracovatelskΘ instrukce v lßsce");
  15010.     </script>
  15011.  
  15012. 4.  <% echo ("p°φpadn∞ m∙╛ete pou╛φvat ASP tagy"); %>
  15013.     <%= $variable; # toto je zkratka za "<%echo .." %></PRE
  15014. ></TD
  15015. ></TR
  15016. ></TABLE
  15017. ></DIV
  15018. ></TD
  15019. ></TR
  15020. ></TABLE
  15021. >
  15022.     </P
  15023. ><P
  15024. >     Prvnφ zp∙sob je dostupn² pouze, pokud jsou povoleny krßtkΘ tagy. To se dß
  15025.     ud∞lat
  15026.     
  15027.     povolenφm konfiguraΦnφ direktivy
  15028.     <A
  15029. HREF="#ini.short-open-tag"
  15030. >short_open_tag</A
  15031. > v konfiguraΦnφm
  15032.     souboru PHP, nebo kompilacφ PHP s <B
  15033. CLASS="command"
  15034. >configure</B
  15035. > volbou
  15036.     --enable-short-tags.
  15037.     </P
  15038. ><P
  15039. >     Obecn∞ preferovanou metodou je druh² zp∙sob, proto╛e umo╛≥uje snadnou
  15040.     implementaci dal╣φho generovßnφ XHTML z PHP.
  15041.     </P
  15042. ><P
  15043. >     ╚tvrt² zp∙sob je dostupn², pouze pokud byly povoleny ASP tagy pomocφ
  15044.     konfiguraΦnφ direktivy <A
  15045. HREF="#ini.asp-tags"
  15046. >asp_tags</A
  15047. >.
  15048.  
  15049.     <DIV
  15050. CLASS="note"
  15051. ><BLOCKQUOTE
  15052. CLASS="note"
  15053. ><P
  15054. ><B
  15055. >Poznßmka: </B
  15056. >Podpora ASP tag∙ byla p°idßna v 3.0.4.</P
  15057. ></BLOCKQUOTE
  15058. ></DIV
  15059. ></P
  15060. ><P
  15061. >     P°φpadnß bezprost°edn∞ nßsledujφcφ sekvence konce °ßdku je souΦßstφ
  15062.     uzavφrajφcφho tagu.
  15063.     </P
  15064. ></DIV
  15065. ><DIV
  15066. CLASS="sect1"
  15067. ><HR><H2
  15068. CLASS="sect1"
  15069. ><A
  15070. NAME="language.basic-syntax.instruction-separation"
  15071. ></A
  15072. >Odd∞lovßnφ instrukcφ</H2
  15073. ><P
  15074. >     Instrukce se odd∞lujφ stejn∞ jako v C nebo Perlu - ukonΦujte ka╛d² v²raz
  15075.     st°ednφkem.
  15076.     </P
  15077. ><P
  15078. >     Uzavφrajφcφ tag (?>) takΘ implikuje konec v²razu, tak╛e nßsledujφcφ
  15079.     ukßzky jsou ekvivalentnφ:
  15080.  
  15081.      <DIV
  15082. CLASS="informalexample"
  15083. ><A
  15084. NAME="AEN3202"
  15085. ></A
  15086. ><P
  15087. ></P
  15088. ><TABLE
  15089. BORDER="0"
  15090. BGCOLOR="#E0E0E0"
  15091. CELLPADDING="5"
  15092. ><TR
  15093. ><TD
  15094. ><PRE
  15095. CLASS="programlisting"
  15096. ><?php
  15097.     echo "Toto je test";
  15098. ?>
  15099.  
  15100. <?php echo "Toto je test" ?></PRE
  15101. ></TD
  15102. ></TR
  15103. ></TABLE
  15104. ><P
  15105. ></P
  15106. ></DIV
  15107. ></P
  15108. ></DIV
  15109. ><DIV
  15110. CLASS="sect1"
  15111. ><HR><H2
  15112. CLASS="sect1"
  15113. ><A
  15114. NAME="language.basic-syntax.comments"
  15115. ></A
  15116. >Komentß°e</H2
  15117. ><P
  15118. >     PHP podporuje komentß°ovΘ notace jazyk∙ 'C', 'C++' a UnixovΘho shellu.
  15119.     Nap°φklad:
  15120.  
  15121.     <DIV
  15122. CLASS="informalexample"
  15123. ><A
  15124. NAME="AEN3207"
  15125. ></A
  15126. ><P
  15127. ></P
  15128. ><TABLE
  15129. BORDER="0"
  15130. BGCOLOR="#E0E0E0"
  15131. CELLPADDING="5"
  15132. ><TR
  15133. ><TD
  15134. ><PRE
  15135. CLASS="programlisting"
  15136. ><?php
  15137.     echo "Toto je test"; // Toto je jedno°ßdkov² komentß° typu C++
  15138.     /* Toto je vφce°ßdkov² komentß°
  15139.        a je╣t∞ jeden komentß° */
  15140.     echo "Toto je dal╣φ test";
  15141.     echo "Poslednφ Test"; # Toto je komentß° shellovΘho typu
  15142. ?></PRE
  15143. ></TD
  15144. ></TR
  15145. ></TABLE
  15146. ><P
  15147. ></P
  15148. ></DIV
  15149. ></P
  15150. ><P
  15151. >     Jedno°ßdkovΘ typy komentß°∙ ve skuteΦnosti komentujφ do konce °ßdku nebo
  15152.     souΦasnΘho bloku PHP k≤du, podle toho, co se vyskytuje d°φv.
  15153.     </P
  15154. ><DIV
  15155. CLASS="informalexample"
  15156. ><A
  15157. NAME="AEN3210"
  15158. ></A
  15159. ><P
  15160. ></P
  15161. ><TABLE
  15162. BORDER="0"
  15163. BGCOLOR="#E0E0E0"
  15164. CELLPADDING="5"
  15165. ><TR
  15166. ><TD
  15167. ><PRE
  15168. CLASS="programlisting"
  15169. ><h1>Toto je  <?php # echo "mal²";?> p°φklad.</h1>
  15170. <p>HlaviΦka na p°edchozφm °ßdku bude 'Toto je p°φklad'.</PRE
  15171. ></TD
  15172. ></TR
  15173. ></TABLE
  15174. ><P
  15175. ></P
  15176. ></DIV
  15177. ><P
  15178. >     M∞li byste si dßt pozor na vno°ovßnφ komentß°∙ typu 'C++', ke kterΘmu m∙╛e
  15179.     dojφt p°i zakomentovßnφ velk²ch blok∙.
  15180.     </P
  15181. ><DIV
  15182. CLASS="informalexample"
  15183. ><A
  15184. NAME="AEN3213"
  15185. ></A
  15186. ><P
  15187. ></P
  15188. ><TABLE
  15189. BORDER="0"
  15190. BGCOLOR="#E0E0E0"
  15191. CELLPADDING="5"
  15192. ><TR
  15193. ><TD
  15194. ><PRE
  15195. CLASS="programlisting"
  15196. ><?php
  15197.  /*
  15198.     echo "Toto je test"; /* Tento komentß° zp∙sobφ problΘm */
  15199.  */
  15200. ?></PRE
  15201. ></TD
  15202. ></TR
  15203. ></TABLE
  15204. ><P
  15205. ></P
  15206. ></DIV
  15207. ></DIV
  15208. ></DIV
  15209. ><DIV
  15210. CLASS="chapter"
  15211. ><HR><H1
  15212. ><A
  15213. NAME="language.types"
  15214. >Kapitola 6. Types</A
  15215. ></H1
  15216. ><DIV
  15217. CLASS="sect1"
  15218. ><H2
  15219. CLASS="sect1"
  15220. ><A
  15221. NAME="language.types.intro"
  15222. ></A
  15223. >Introduction</H2
  15224. ><P
  15225. >    PHP supports eight primitive types.
  15226.   </P
  15227. ><P
  15228. >    Four scalar types:
  15229.  
  15230.    <P
  15231. ></P
  15232. ><UL
  15233. ><LI
  15234. ><P
  15235. >       <A
  15236. HREF="#language.types.boolean"
  15237. ><B
  15238. CLASS="type"
  15239. >boolean</B
  15240. ></A
  15241. >
  15242.      </P
  15243. ></LI
  15244. ><LI
  15245. ><P
  15246. >       <A
  15247. HREF="#language.types.integer"
  15248. ><B
  15249. CLASS="type"
  15250. >integer</B
  15251. ></A
  15252. >
  15253.      </P
  15254. ></LI
  15255. ><LI
  15256. ><P
  15257. >       <A
  15258. HREF="#language.types.float"
  15259. ><B
  15260. CLASS="type"
  15261. >float</B
  15262. ></A
  15263. > (floating-point number, aka '<A
  15264. HREF="#language.types.float"
  15265. ><B
  15266. CLASS="type"
  15267. >double</B
  15268. ></A
  15269. >')
  15270.      </P
  15271. ></LI
  15272. ><LI
  15273. ><P
  15274. >       <A
  15275. HREF="#language.types.string"
  15276. ><B
  15277. CLASS="type"
  15278. >string</B
  15279. ></A
  15280. >
  15281.      </P
  15282. ></LI
  15283. ></UL
  15284. >
  15285.  
  15286.    Two compound types:
  15287.  
  15288.    <P
  15289. ></P
  15290. ><UL
  15291. ><LI
  15292. ><P
  15293. >       <A
  15294. HREF="#language.types.array"
  15295. ><B
  15296. CLASS="type"
  15297. >array</B
  15298. ></A
  15299. >
  15300.      </P
  15301. ></LI
  15302. ><LI
  15303. ><P
  15304. >       <A
  15305. HREF="#language.types.object"
  15306. ><B
  15307. CLASS="type"
  15308. >object</B
  15309. ></A
  15310. >
  15311.      </P
  15312. ></LI
  15313. ></UL
  15314. >
  15315.  
  15316.    And finally two special types:
  15317.  
  15318.    <P
  15319. ></P
  15320. ><UL
  15321. ><LI
  15322. ><P
  15323. >       <A
  15324. HREF="#language.types.resource"
  15325. ><B
  15326. CLASS="type"
  15327. >resource</B
  15328. ></A
  15329. >
  15330.      </P
  15331. ></LI
  15332. ><LI
  15333. ><P
  15334. >       <A
  15335. HREF="#language.types.null"
  15336. ><B
  15337. CLASS="type"
  15338. >NULL</B
  15339. ></A
  15340. >
  15341.      </P
  15342. ></LI
  15343. ></UL
  15344. >
  15345.  
  15346.    This manual also introduces some 
  15347.    <A
  15348. HREF="#language.pseudo-types"
  15349. >pseudo-types</A
  15350. > 
  15351.    for readability reasons:
  15352.  
  15353.    <P
  15354. ></P
  15355. ><UL
  15356. ><LI
  15357. ><P
  15358. >       <A
  15359. HREF="#language.types.mixed"
  15360. >mixed</A
  15361. >
  15362.      </P
  15363. ></LI
  15364. ><LI
  15365. ><P
  15366. >       <A
  15367. HREF="#language.types.number"
  15368. >number</A
  15369. >
  15370.      </P
  15371. ></LI
  15372. ><LI
  15373. ><P
  15374. >       <A
  15375. HREF="#language.types.mixed"
  15376. >callback</A
  15377. >
  15378.      </P
  15379. ></LI
  15380. ></UL
  15381. >
  15382.    You may also find some references to the type "double". Consider
  15383.    double the same as float, the two names exist only for historic
  15384.    reasons. 
  15385.   </P
  15386. ><P
  15387. >    The type of a variable is usually not set by the programmer;
  15388.    rather, it is decided at runtime by PHP depending on the context in
  15389.    which that variable is used.
  15390.   </P
  15391. ><DIV
  15392. CLASS="note"
  15393. ><BLOCKQUOTE
  15394. CLASS="note"
  15395. ><P
  15396. ><B
  15397. >Poznßmka: </B
  15398. >
  15399.     If you want to check out the type and value of a certain <A
  15400. HREF="#language.expressions"
  15401. >expression</A
  15402. >, use
  15403.     <A
  15404. HREF="#function.var-dump"
  15405. ><B
  15406. CLASS="function"
  15407. >var_dump()</B
  15408. ></A
  15409. >.
  15410.    </P
  15411. ><P
  15412. ><B
  15413. >Poznßmka: </B
  15414. >
  15415.     If you simply want a human-readable representation of the type for
  15416.     debugging, use <A
  15417. HREF="#function.gettype"
  15418. ><B
  15419. CLASS="function"
  15420. >gettype()</B
  15421. ></A
  15422. >. To check for a certain type,
  15423.     do <SPAN
  15424. CLASS="emphasis"
  15425. ><I
  15426. CLASS="emphasis"
  15427. >not</I
  15428. ></SPAN
  15429. > use <A
  15430. HREF="#function.gettype"
  15431. ><B
  15432. CLASS="function"
  15433. >gettype()</B
  15434. ></A
  15435. >, but use the
  15436.     <TT
  15437. CLASS="literal"
  15438. >is_<TT
  15439. CLASS="replaceable"
  15440. ><I
  15441. >type</I
  15442. ></TT
  15443. ></TT
  15444. > functions. Some
  15445.     examples:
  15446.     <DIV
  15447. CLASS="informalexample"
  15448. ><A
  15449. NAME="AEN3271"
  15450. ></A
  15451. ><P
  15452. ></P
  15453. ><TABLE
  15454. BORDER="0"
  15455. BGCOLOR="#E0E0E0"
  15456. CELLPADDING="5"
  15457. ><TR
  15458. ><TD
  15459. ><PRE
  15460. CLASS="php"
  15461. ><?php
  15462. $bool = TRUE;   // a boolean
  15463. $str  = "foo";  // a string
  15464. $int  = 12;     // an integer
  15465.  
  15466. echo gettype($bool); // prints out "boolean"
  15467. echo gettype($str);  // prints out "string"
  15468.  
  15469. // If this is an integer, increment it by four
  15470. if (is_int($int)) {
  15471.     $int += 4;
  15472. }
  15473.  
  15474. // If $bool is a string, print it out
  15475. // (does not print out anything)
  15476. if (is_string($bool)) {
  15477.     echo "String: $bool";
  15478. }
  15479. ?></PRE
  15480. ></TD
  15481. ></TR
  15482. ></TABLE
  15483. ><P
  15484. ></P
  15485. ></DIV
  15486. >
  15487.    </P
  15488. ></BLOCKQUOTE
  15489. ></DIV
  15490. ><P
  15491. >    If you would like to force a variable to be converted to a certain
  15492.    type, you may either <A
  15493. HREF="#language.types.typecasting"
  15494. >cast</A
  15495. > the variable or
  15496.    use the <A
  15497. HREF="#function.settype"
  15498. ><B
  15499. CLASS="function"
  15500. >settype()</B
  15501. ></A
  15502. > function on it.
  15503.   </P
  15504. ><P
  15505. >    Note that a variable may be evaluated with different values in certain
  15506.    situations, depending on what type it is at the time. For more
  15507.    information, see the section on <A
  15508. HREF="#language.types.type-juggling"
  15509. >Type Juggling</A
  15510. >.  Also, you 
  15511.    may be interested in viewing 
  15512.    <A
  15513. HREF="#types.comparisons"
  15514. >the type comparison tables</A
  15515. >,
  15516.    as they show examples of various type related comparisons.
  15517.   </P
  15518. ></DIV
  15519. ><DIV
  15520. CLASS="sect1"
  15521. ><HR><H2
  15522. CLASS="sect1"
  15523. ><A
  15524. NAME="language.types.boolean"
  15525. ></A
  15526. >Booleans</H2
  15527. ><P
  15528. >      This is the easiest type. A <A
  15529. HREF="#language.types.boolean"
  15530. ><B
  15531. CLASS="type"
  15532. >boolean</B
  15533. ></A
  15534. > expresses a 
  15535.      truth value. It can be either <TT
  15536. CLASS="constant"
  15537. ><B
  15538. >TRUE</B
  15539. ></TT
  15540. > or <TT
  15541. CLASS="constant"
  15542. ><B
  15543. >FALSE</B
  15544. ></TT
  15545. >. 
  15546.     </P
  15547. ><DIV
  15548. CLASS="note"
  15549. ><BLOCKQUOTE
  15550. CLASS="note"
  15551. ><P
  15552. ><B
  15553. >Poznßmka: </B
  15554. >
  15555.       The boolean type was introduced in PHP 4.
  15556.      </P
  15557. ></BLOCKQUOTE
  15558. ></DIV
  15559. ><DIV
  15560. CLASS="sect2"
  15561. ><HR><H3
  15562. CLASS="sect2"
  15563. ><A
  15564. NAME="language.types.boolean.syntax"
  15565. ></A
  15566. >Syntax</H3
  15567. ><P
  15568. >       To specify a boolean literal, use either the keyword <TT
  15569. CLASS="constant"
  15570. ><B
  15571. >TRUE</B
  15572. ></TT
  15573. > 
  15574.       or <TT
  15575. CLASS="constant"
  15576. ><B
  15577. >FALSE</B
  15578. ></TT
  15579. >. Both are case-insensitive.
  15580.       <DIV
  15581. CLASS="informalexample"
  15582. ><A
  15583. NAME="AEN3292"
  15584. ></A
  15585. ><P
  15586. ></P
  15587. ><TABLE
  15588. BORDER="0"
  15589. BGCOLOR="#E0E0E0"
  15590. CELLPADDING="5"
  15591. ><TR
  15592. ><TD
  15593. ><PRE
  15594. CLASS="php"
  15595. ><?php
  15596. $foo = True; // assign the value TRUE to $foo
  15597. ?></PRE
  15598. ></TD
  15599. ></TR
  15600. ></TABLE
  15601. ><P
  15602. ></P
  15603. ></DIV
  15604. >
  15605.      </P
  15606. ><P
  15607. >       Usually you 
  15608.       use some kind of <A
  15609. HREF="#language.operators"
  15610. >operator</A
  15611. >
  15612.       which returns a <A
  15613. HREF="#language.types.boolean"
  15614. ><B
  15615. CLASS="type"
  15616. >boolean</B
  15617. ></A
  15618. > value, and then pass it 
  15619.       on to a <A
  15620. HREF="#control-structures"
  15621. >control
  15622.       structure</A
  15623. >.
  15624.       <DIV
  15625. CLASS="informalexample"
  15626. ><A
  15627. NAME="AEN3298"
  15628. ></A
  15629. ><P
  15630. ></P
  15631. ><TABLE
  15632. BORDER="0"
  15633. BGCOLOR="#E0E0E0"
  15634. CELLPADDING="5"
  15635. ><TR
  15636. ><TD
  15637. ><PRE
  15638. CLASS="php"
  15639. ><?php
  15640. // == is an operator which test
  15641. // equality and returns a boolean
  15642. if ($action == "show_version") {
  15643.     echo "The version is 1.23";
  15644. }
  15645.  
  15646. // this is not necessary...
  15647. if ($show_separators == TRUE) {
  15648.     echo "<hr>\n";
  15649. }
  15650.  
  15651. // ...because you can simply type
  15652. if ($show_separators) {
  15653.     echo "<hr>\n";
  15654. }
  15655. ?></PRE
  15656. ></TD
  15657. ></TR
  15658. ></TABLE
  15659. ><P
  15660. ></P
  15661. ></DIV
  15662. >
  15663.      </P
  15664. ></DIV
  15665. ><DIV
  15666. CLASS="sect2"
  15667. ><HR><H3
  15668. CLASS="sect2"
  15669. ><A
  15670. NAME="language.types.boolean.casting"
  15671. ></A
  15672. >Converting to boolean</H3
  15673. ><P
  15674. >        To explicitly convert a value to <A
  15675. HREF="#language.types.boolean"
  15676. ><B
  15677. CLASS="type"
  15678. >boolean</B
  15679. ></A
  15680. >, use either
  15681.        the <TT
  15682. CLASS="literal"
  15683. >(bool)</TT
  15684. > or the <TT
  15685. CLASS="literal"
  15686. >(boolean)</TT
  15687. > cast.
  15688.        However, in most cases you do not need to use the cast, since a value
  15689.        will be automatically converted if an operator, function or 
  15690.        control structure requires a <A
  15691. HREF="#language.types.boolean"
  15692. ><B
  15693. CLASS="type"
  15694. >boolean</B
  15695. ></A
  15696. > argument.
  15697.       </P
  15698. ><P
  15699. >        See also <A
  15700. HREF="#language.types.type-juggling"
  15701. >Type Juggling</A
  15702. >.
  15703.       </P
  15704. ><P
  15705. >        When converting to <A
  15706. HREF="#language.types.boolean"
  15707. ><B
  15708. CLASS="type"
  15709. >boolean</B
  15710. ></A
  15711. >, the following values 
  15712.        are considered <TT
  15713. CLASS="constant"
  15714. ><B
  15715. >FALSE</B
  15716. ></TT
  15717. >:
  15718.   
  15719.        <P
  15720. ></P
  15721. ><UL
  15722. ><LI
  15723. ><P
  15724. >the <A
  15725. HREF="#language.types.boolean"
  15726. >boolean</A
  15727. > 
  15728.           <TT
  15729. CLASS="constant"
  15730. ><B
  15731. >FALSE</B
  15732. ></TT
  15733. > itself</P
  15734. ></LI
  15735. ><LI
  15736. ><P
  15737. >the <A
  15738. HREF="#language.types.integer"
  15739. >integer</A
  15740. > 0 (zero) </P
  15741. ></LI
  15742. ><LI
  15743. ><P
  15744. >the <A
  15745. HREF="#language.types.float"
  15746. >float</A
  15747. > 
  15748.          0.0 (zero) </P
  15749. ></LI
  15750. ><LI
  15751. ><P
  15752. >the empty <A
  15753. HREF="#language.types.string"
  15754. >string</A
  15755. >, and the <A
  15756. HREF="#language.types.string"
  15757. >string</A
  15758. >
  15759.            "0"</P
  15760. ></LI
  15761. ><LI
  15762. ><P
  15763. >an <A
  15764. HREF="#language.types.array"
  15765. >array</A
  15766. > 
  15767.          with zero elements</P
  15768. ></LI
  15769. ><LI
  15770. ><P
  15771. >an <A
  15772. HREF="#language.types.object"
  15773. >object</A
  15774. > 
  15775.          with zero member variables</P
  15776. ></LI
  15777. ><LI
  15778. ><P
  15779. >the special type <A
  15780. HREF="#language.types.null"
  15781. >NULL</A
  15782. > (including unset variables)
  15783.          </P
  15784. ></LI
  15785. ></UL
  15786. >
  15787.        
  15788.        Every other value is considered <TT
  15789. CLASS="constant"
  15790. ><B
  15791. >TRUE</B
  15792. ></TT
  15793. > (including any 
  15794.        <A
  15795. HREF="#language.types.resource"
  15796. >resource</A
  15797. >).
  15798.        <DIV
  15799. CLASS="warning"
  15800. ><P
  15801. ></P
  15802. ><TABLE
  15803. CLASS="warning"
  15804. BORDER="1"
  15805. WIDTH="100%"
  15806. ><TR
  15807. ><TD
  15808. ALIGN="CENTER"
  15809. ><B
  15810. >Varovßnφ</B
  15811. ></TD
  15812. ></TR
  15813. ><TR
  15814. ><TD
  15815. ALIGN="LEFT"
  15816. ><P
  15817. >          <TT
  15818. CLASS="literal"
  15819. >-1</TT
  15820. > is considered  
  15821.          <TT
  15822. CLASS="constant"
  15823. ><B
  15824. >TRUE</B
  15825. ></TT
  15826. >, like any other non-zero (whether negative
  15827.          or positive) number!
  15828.         </P
  15829. ></TD
  15830. ></TR
  15831. ></TABLE
  15832. ></DIV
  15833. >
  15834.        <DIV
  15835. CLASS="informalexample"
  15836. ><A
  15837. NAME="AEN3342"
  15838. ></A
  15839. ><P
  15840. ></P
  15841. ><TABLE
  15842. BORDER="0"
  15843. BGCOLOR="#E0E0E0"
  15844. CELLPADDING="5"
  15845. ><TR
  15846. ><TD
  15847. ><PRE
  15848. CLASS="php"
  15849. ><?php
  15850. echo gettype((bool) "");        // bool(false)
  15851. echo gettype((bool) 1);         // bool(true)
  15852. echo gettype((bool) -2);        // bool(true)
  15853. echo gettype((bool) "foo");     // bool(true)
  15854. echo gettype((bool) 2.3e5);     // bool(true)
  15855. echo gettype((bool) array(12)); // bool(true)
  15856. echo gettype((bool) array());   // bool(false)
  15857. ?></PRE
  15858. ></TD
  15859. ></TR
  15860. ></TABLE
  15861. ><P
  15862. ></P
  15863. ></DIV
  15864. >
  15865.       </P
  15866. ></DIV
  15867. ></DIV
  15868. ><DIV
  15869. CLASS="sect1"
  15870. ><HR><H2
  15871. CLASS="sect1"
  15872. ><A
  15873. NAME="language.types.integer"
  15874. ></A
  15875. >Integers</H2
  15876. ><P
  15877. >      An <A
  15878. HREF="#language.types.integer"
  15879. ><B
  15880. CLASS="type"
  15881. >integer</B
  15882. ></A
  15883. > is a number of the set 
  15884.      Z = {..., -2, -1, 0, 1, 2, ...}.
  15885.     </P
  15886. ><P
  15887. >      See also:
  15888.      <A
  15889. HREF="#ref.gmp"
  15890. >Arbitrary length integer / GMP</A
  15891. >,
  15892.      <A
  15893. HREF="#language.types.float"
  15894. >Floating point numbers</A
  15895. >, and
  15896.      <A
  15897. HREF="#ref.bc"
  15898. >Arbitrary precision / BCMath</A
  15899. >
  15900.     </P
  15901. ><DIV
  15902. CLASS="sect2"
  15903. ><HR><H3
  15904. CLASS="sect2"
  15905. ><A
  15906. NAME="language.types.integer.syntax"
  15907. ></A
  15908. >Syntax</H3
  15909. ><P
  15910. >       Integers can be specified in decimal (10-based), hexadecimal (16-based)
  15911.       or octal (8-based) notation, optionally preceded by a sign (- or +).
  15912.      </P
  15913. ><P
  15914. >       If you use the octal notation, you must precede the number with a 
  15915.       <TT
  15916. CLASS="literal"
  15917. >0</TT
  15918. > (zero), to use hexadecimal notation precede
  15919.       the number with <TT
  15920. CLASS="literal"
  15921. >0x</TT
  15922. >.
  15923.       <TABLE
  15924. WIDTH="100%"
  15925. BORDER="0"
  15926. CELLPADDING="0"
  15927. CELLSPACING="0"
  15928. CLASS="EXAMPLE"
  15929. ><TR
  15930. ><TD
  15931. ><DIV
  15932. CLASS="example"
  15933. ><A
  15934. NAME="AEN3358"
  15935. ></A
  15936. ><P
  15937. ><B
  15938. >P°φklad 6-1. Integer literals</B
  15939. ></P
  15940. ><TABLE
  15941. BORDER="0"
  15942. BGCOLOR="#E0E0E0"
  15943. CELLPADDING="5"
  15944. ><TR
  15945. ><TD
  15946. ><PRE
  15947. CLASS="php"
  15948. ><?php
  15949. $a = 1234; # decimal number
  15950. $a = -123; # a negative number
  15951. $a = 0123; # octal number (equivalent to 83 decimal)
  15952. $a = 0x1A; # hexadecimal number (equivalent to 26 decimal)
  15953. ?></PRE
  15954. ></TD
  15955. ></TR
  15956. ></TABLE
  15957. ></DIV
  15958. ></TD
  15959. ></TR
  15960. ></TABLE
  15961. >
  15962.       Formally the possible structure for integer literals is:
  15963.       <DIV
  15964. CLASS="informalexample"
  15965. ><A
  15966. NAME="AEN3361"
  15967. ></A
  15968. ><P
  15969. ></P
  15970. ><TABLE
  15971. BORDER="0"
  15972. BGCOLOR="#E0E0E0"
  15973. CELLPADDING="5"
  15974. ><TR
  15975. ><TD
  15976. ><PRE
  15977. CLASS="programlisting"
  15978. >decimal     : [1-9][0-9]*
  15979.             | 0
  15980.  
  15981. hexadecimal : 0[xX][0-9a-fA-F]+
  15982.  
  15983. octal       : 0[0-7]+
  15984.  
  15985. integer     : [+-]?decimal
  15986.             | [+-]?hexadecimal
  15987.             | [+-]?octal</PRE
  15988. ></TD
  15989. ></TR
  15990. ></TABLE
  15991. ><P
  15992. ></P
  15993. ></DIV
  15994. >
  15995.       The size of an integer is platform-dependent, although a 
  15996.       maximum value of about two billion is the usual value 
  15997.       (that's 32 bits signed). PHP does not support unsigned
  15998.       integers.
  15999.      </P
  16000. ></DIV
  16001. ><DIV
  16002. CLASS="sect2"
  16003. ><HR><H3
  16004. CLASS="sect2"
  16005. ><A
  16006. NAME="language.types.integer.overflow"
  16007. ></A
  16008. >Integer overflow</H3
  16009. ><P
  16010. >       If you specify a number beyond the bounds of the <A
  16011. HREF="#language.types.integer"
  16012. ><B
  16013. CLASS="type"
  16014. >integer</B
  16015. ></A
  16016. >
  16017.       type, it will be interpreted as a <A
  16018. HREF="#language.types.float"
  16019. ><B
  16020. CLASS="type"
  16021. >float</B
  16022. ></A
  16023. > instead. Also, if
  16024.       you perform an operation that results in a number beyond the bounds of
  16025.       the <A
  16026. HREF="#language.types.integer"
  16027. ><B
  16028. CLASS="type"
  16029. >integer</B
  16030. ></A
  16031. > type, a <A
  16032. HREF="#language.types.float"
  16033. ><B
  16034. CLASS="type"
  16035. >float</B
  16036. ></A
  16037. > will be returned
  16038.       instead.
  16039.  
  16040.       <DIV
  16041. CLASS="informalexample"
  16042. ><A
  16043. NAME="AEN3370"
  16044. ></A
  16045. ><P
  16046. ></P
  16047. ><TABLE
  16048. BORDER="0"
  16049. BGCOLOR="#E0E0E0"
  16050. CELLPADDING="5"
  16051. ><TR
  16052. ><TD
  16053. ><PRE
  16054. CLASS="php"
  16055. ><?php
  16056. $large_number =  2147483647;
  16057. var_dump($large_number);
  16058. // output: int(2147483647)
  16059.  
  16060. $large_number =  2147483648;
  16061. var_dump($large_number);
  16062. // output: float(2147483648)
  16063.  
  16064. // this goes also for hexadecimal specified integers:
  16065. var_dump( 0x80000000 );
  16066. // output: float(2147483648)
  16067.  
  16068. $million = 1000000;
  16069. $large_number =  50000 * $million;
  16070. var_dump($large_number);
  16071. // output: float(50000000000)
  16072. ?></PRE
  16073. ></TD
  16074. ></TR
  16075. ></TABLE
  16076. ><P
  16077. ></P
  16078. ></DIV
  16079. >
  16080.       <DIV
  16081. CLASS="warning"
  16082. ><P
  16083. ></P
  16084. ><TABLE
  16085. CLASS="warning"
  16086. BORDER="1"
  16087. WIDTH="100%"
  16088. ><TR
  16089. ><TD
  16090. ALIGN="CENTER"
  16091. ><B
  16092. >Varovßnφ</B
  16093. ></TD
  16094. ></TR
  16095. ><TR
  16096. ><TD
  16097. ALIGN="LEFT"
  16098. ><P
  16099. >         Unfortunately, there was a bug in PHP so that this
  16100.         does not always work correctly when there are negative numbers
  16101.         involved. For example: when you do <TT
  16102. CLASS="literal"
  16103. >-50000 *
  16104.         $million</TT
  16105. >, the result will be
  16106.         <TT
  16107. CLASS="literal"
  16108. >-429496728</TT
  16109. >. However, when both operands are
  16110.         positive there is no problem.
  16111.        </P
  16112. ><P
  16113. >         This is solved in PHP 4.1.0.
  16114.        </P
  16115. ></TD
  16116. ></TR
  16117. ></TABLE
  16118. ></DIV
  16119. >
  16120.      </P
  16121. ><P
  16122. >       There is no integer division operator in PHP.
  16123.       <TT
  16124. CLASS="literal"
  16125. >1/2</TT
  16126. > yields the <A
  16127. HREF="#language.types.float"
  16128. ><B
  16129. CLASS="type"
  16130. >float</B
  16131. ></A
  16132. >
  16133.       <TT
  16134. CLASS="literal"
  16135. >0.5</TT
  16136. >. You can cast the value to
  16137.       an integer to always round it downwards, or you can
  16138.       use the <A
  16139. HREF="#function.round"
  16140. ><B
  16141. CLASS="function"
  16142. >round()</B
  16143. ></A
  16144. > function.
  16145.       <DIV
  16146. CLASS="informalexample"
  16147. ><A
  16148. NAME="AEN3382"
  16149. ></A
  16150. ><P
  16151. ></P
  16152. ><TABLE
  16153. BORDER="0"
  16154. BGCOLOR="#E0E0E0"
  16155. CELLPADDING="5"
  16156. ><TR
  16157. ><TD
  16158. ><PRE
  16159. CLASS="php"
  16160. ><?php
  16161. var_dump(25/7);         // float(3.5714285714286) 
  16162. var_dump((int) (25/7)); // int(3)
  16163. var_dump(round(25/7));  // float(4) 
  16164. ?></PRE
  16165. ></TD
  16166. ></TR
  16167. ></TABLE
  16168. ><P
  16169. ></P
  16170. ></DIV
  16171. >
  16172.      </P
  16173. ></DIV
  16174. ><DIV
  16175. CLASS="sect2"
  16176. ><HR><H3
  16177. CLASS="sect2"
  16178. ><A
  16179. NAME="language.types.integer.casting"
  16180. ></A
  16181. >Converting to integer</H3
  16182. ><P
  16183. >        To explicitly convert a value to <A
  16184. HREF="#language.types.integer"
  16185. ><B
  16186. CLASS="type"
  16187. >integer</B
  16188. ></A
  16189. >, use either
  16190.        the <TT
  16191. CLASS="literal"
  16192. >(int)</TT
  16193. > or the <TT
  16194. CLASS="literal"
  16195. >(integer)</TT
  16196. > cast.
  16197.        However, in most cases you do not need to use the cast, since a value
  16198.        will be automatically converted if an operator, function or 
  16199.        control structure requires an <A
  16200. HREF="#language.types.integer"
  16201. ><B
  16202. CLASS="type"
  16203. >integer</B
  16204. ></A
  16205. > argument.
  16206.        You can also convert a value to integer with the function
  16207.        <A
  16208. HREF="#function.intval"
  16209. ><B
  16210. CLASS="function"
  16211. >intval()</B
  16212. ></A
  16213. >.
  16214.       </P
  16215. ><P
  16216. >        See also <A
  16217. HREF="#language.types.type-juggling"
  16218. >type-juggling</A
  16219. >.
  16220.       </P
  16221. ><DIV
  16222. CLASS="sect3"
  16223. ><HR><H4
  16224. CLASS="sect3"
  16225. ><A
  16226. NAME="language.types.integer.casting.from-boolean"
  16227. ></A
  16228. >From <A
  16229. HREF="#language.types.boolean"
  16230. >booleans</A
  16231. ></H4
  16232. ><P
  16233. >         <TT
  16234. CLASS="constant"
  16235. ><B
  16236. >FALSE</B
  16237. ></TT
  16238. > will yield 
  16239.         <TT
  16240. CLASS="literal"
  16241. >0</TT
  16242. > (zero), and <TT
  16243. CLASS="constant"
  16244. ><B
  16245. >TRUE</B
  16246. ></TT
  16247. > 
  16248.         will yield <TT
  16249. CLASS="literal"
  16250. >1</TT
  16251. > (one).
  16252.        </P
  16253. ></DIV
  16254. ><DIV
  16255. CLASS="sect3"
  16256. ><HR><H4
  16257. CLASS="sect3"
  16258. ><A
  16259. NAME="language.types.integer.casting.from-float"
  16260. ></A
  16261. >From <A
  16262. HREF="#language.types.float"
  16263. >floating point numbers</A
  16264. ></H4
  16265. ><P
  16266. >         When converting from float to integer, the number will
  16267.         be rounded <SPAN
  16268. CLASS="emphasis"
  16269. ><I
  16270. CLASS="emphasis"
  16271. >towards zero</I
  16272. ></SPAN
  16273. >.
  16274.        </P
  16275. ><P
  16276. >         If the float is beyond the boundaries of integer
  16277.         (usually <TT
  16278. CLASS="literal"
  16279. >+/- 2.15e+9 = 2^31</TT
  16280. >), 
  16281.         the result is undefined, since the float hasn't
  16282.         got enough precision to give an exact integer result.
  16283.         No warning, not even a notice will be issued in this 
  16284.         case!
  16285.        </P
  16286. ><DIV
  16287. CLASS="warning"
  16288. ><P
  16289. ></P
  16290. ><TABLE
  16291. CLASS="warning"
  16292. BORDER="1"
  16293. WIDTH="100%"
  16294. ><TR
  16295. ><TD
  16296. ALIGN="CENTER"
  16297. ><B
  16298. >Varovßnφ</B
  16299. ></TD
  16300. ></TR
  16301. ><TR
  16302. ><TD
  16303. ALIGN="LEFT"
  16304. ><P
  16305. >         Never cast an unknown fraction to <A
  16306. HREF="#language.types.integer"
  16307. ><B
  16308. CLASS="type"
  16309. >integer</B
  16310. ></A
  16311. >, as this can
  16312.         sometimes lead to unexpected results.
  16313.         <DIV
  16314. CLASS="informalexample"
  16315. ><A
  16316. NAME="AEN3412"
  16317. ></A
  16318. ><P
  16319. ></P
  16320. ><TABLE
  16321. BORDER="0"
  16322. BGCOLOR="#E0E0E0"
  16323. CELLPADDING="5"
  16324. ><TR
  16325. ><TD
  16326. ><PRE
  16327. CLASS="php"
  16328. ><?php
  16329. echo (int) ( (0.1+0.7) * 10 ); // echoes 7!
  16330. ?></PRE
  16331. ></TD
  16332. ></TR
  16333. ></TABLE
  16334. ><P
  16335. ></P
  16336. ></DIV
  16337. >
  16338.         
  16339.         See for more information the <A
  16340. HREF="#warn.float-precision"
  16341. >warning 
  16342.         about float-precision</A
  16343. >.
  16344.        </P
  16345. ></TD
  16346. ></TR
  16347. ></TABLE
  16348. ></DIV
  16349. ></DIV
  16350. ><DIV
  16351. CLASS="sect3"
  16352. ><HR><H4
  16353. CLASS="sect3"
  16354. ><A
  16355. NAME="language.types.integer.casting.from-string"
  16356. ></A
  16357. >From strings</H4
  16358. ><P
  16359. >         See <A
  16360. HREF="#language.types.string.conversion"
  16361. >String 
  16362.         conversion to numbers</A
  16363. >
  16364.        </P
  16365. ></DIV
  16366. ><DIV
  16367. CLASS="sect3"
  16368. ><HR><H4
  16369. CLASS="sect3"
  16370. ><A
  16371. NAME="language.types.integer.casting.from-other"
  16372. ></A
  16373. >From other types</H4
  16374. ><P
  16375. >         <DIV
  16376. CLASS="caution"
  16377. ><P
  16378. ></P
  16379. ><TABLE
  16380. CLASS="caution"
  16381. BORDER="1"
  16382. WIDTH="100%"
  16383. ><TR
  16384. ><TD
  16385. ALIGN="CENTER"
  16386. ><B
  16387. >V²straha</B
  16388. ></TD
  16389. ></TR
  16390. ><TR
  16391. ><TD
  16392. ALIGN="LEFT"
  16393. ><P
  16394. >           Behaviour of converting to integer is undefined for other
  16395.           types. Currently, the behaviour is the same as if the value
  16396.           was first <A
  16397. HREF="#language.types.boolean.casting"
  16398. >converted to boolean</A
  16399. >. However, do
  16400.           <SPAN
  16401. CLASS="emphasis"
  16402. ><I
  16403. CLASS="emphasis"
  16404. >not</I
  16405. ></SPAN
  16406. > rely on this behaviour, as it can
  16407.           change without notice.
  16408.          </P
  16409. ></TD
  16410. ></TR
  16411. ></TABLE
  16412. ></DIV
  16413. >
  16414.        </P
  16415. ></DIV
  16416. ></DIV
  16417. ></DIV
  16418. ><DIV
  16419. CLASS="sect1"
  16420. ><HR><H2
  16421. CLASS="sect1"
  16422. ><A
  16423. NAME="language.types.float"
  16424. ></A
  16425. >Floating point numbers</H2
  16426. ><P
  16427. >     Floating point numbers (AKA "floats", "doubles" or "real numbers") can be 
  16428.     specified using any of the following syntaxes: 
  16429.     <DIV
  16430. CLASS="informalexample"
  16431. ><A
  16432. NAME="AEN3429"
  16433. ></A
  16434. ><P
  16435. ></P
  16436. ><TABLE
  16437. BORDER="0"
  16438. BGCOLOR="#E0E0E0"
  16439. CELLPADDING="5"
  16440. ><TR
  16441. ><TD
  16442. ><PRE
  16443. CLASS="php"
  16444. ><?php
  16445. $a = 1.234; 
  16446. $b = 1.2e3; 
  16447. $c = 7E-10;
  16448. ?></PRE
  16449. ></TD
  16450. ></TR
  16451. ></TABLE
  16452. ><P
  16453. ></P
  16454. ></DIV
  16455. >
  16456.     Formally:
  16457.     <DIV
  16458. CLASS="informalexample"
  16459. ><A
  16460. NAME="AEN3431"
  16461. ></A
  16462. ><P
  16463. ></P
  16464. ><TABLE
  16465. BORDER="0"
  16466. BGCOLOR="#E0E0E0"
  16467. CELLPADDING="5"
  16468. ><TR
  16469. ><TD
  16470. ><PRE
  16471. CLASS="php"
  16472. >LNUM          [0-9]+
  16473. DNUM          ([0-9]*[\.]{LNUM}) | ({LNUM}[\.][0-9]*)
  16474. EXPONENT_DNUM ( ({LNUM} | {DNUM}) [eE][+-]? {LNUM})</PRE
  16475. ></TD
  16476. ></TR
  16477. ></TABLE
  16478. ><P
  16479. ></P
  16480. ></DIV
  16481. >
  16482.     The size of a float is platform-dependent, 
  16483.     although a maximum of ~1.8e308 with a precision of roughly 14 
  16484.     decimal digits is a common value (that's 64 bit IEEE format).
  16485.    </P
  16486. ><DIV
  16487. CLASS="warning"
  16488. ><P
  16489. ></P
  16490. ><TABLE
  16491. CLASS="warning"
  16492. BORDER="1"
  16493. WIDTH="100%"
  16494. ><TR
  16495. ><TD
  16496. ALIGN="CENTER"
  16497. ><B
  16498. ><A
  16499. NAME="warn.float-precision"
  16500. ></A
  16501. >Floating point precision</B
  16502. ></TD
  16503. ></TR
  16504. ><TR
  16505. ><TD
  16506. ALIGN="LEFT"
  16507. ><P
  16508. >      It is quite usual that simple decimal fractions like
  16509.      <TT
  16510. CLASS="literal"
  16511. >0.1</TT
  16512. > or <TT
  16513. CLASS="literal"
  16514. >0.7</TT
  16515. > cannot be
  16516.      converted into their internal binary counterparts without a
  16517.      little loss of precision. This can lead to confusing results: for
  16518.      example, <TT
  16519. CLASS="literal"
  16520. >floor((0.1+0.7)*10)</TT
  16521. > will usually
  16522.      return <TT
  16523. CLASS="literal"
  16524. >7</TT
  16525. > instead of the expected
  16526.      <TT
  16527. CLASS="literal"
  16528. >8</TT
  16529. > as the result of the internal representation
  16530.      really being something like <TT
  16531. CLASS="literal"
  16532. >7.9999999999...</TT
  16533. >.
  16534.     </P
  16535. ><P
  16536. >      This is related to the fact that it is impossible to exactly
  16537.      express some fractions in decimal notation with a finite number
  16538.      of digits. For instance, <TT
  16539. CLASS="literal"
  16540. >1/3</TT
  16541. > in decimal form
  16542.      becomes <TT
  16543. CLASS="literal"
  16544. >0.3333333. . .</TT
  16545. >.
  16546.     </P
  16547. ><P
  16548. >      So never trust floating number results to the last digit and
  16549.      never compare floating point numbers for equality. If you really
  16550.      need higher precision, you should use the <A
  16551. HREF="#ref.bc"
  16552. >arbitrary precision math functions</A
  16553. >
  16554.      or <A
  16555. HREF="#ref.gmp"
  16556. >gmp</A
  16557. > functions instead.
  16558.     </P
  16559. ></TD
  16560. ></TR
  16561. ></TABLE
  16562. ></DIV
  16563. ><DIV
  16564. CLASS="sect2"
  16565. ><HR><H3
  16566. CLASS="sect2"
  16567. ><A
  16568. NAME="language.types.float.casting"
  16569. ></A
  16570. >Converting to float</H3
  16571. ><P
  16572. >      For information on when and how strings are converted to floats,
  16573.      see the section titled <A
  16574. HREF="#language.types.string.conversion"
  16575. >String
  16576.      conversion to numbers</A
  16577. >. For values of other types, the conversion
  16578.      is the same as if the value would have been converted to integer
  16579.      and then to float. See the <A
  16580. HREF="#language.types.integer.casting"
  16581. >Converting
  16582.      to integer</A
  16583. > section for more information.
  16584.     </P
  16585. ></DIV
  16586. ></DIV
  16587. ><DIV
  16588. CLASS="sect1"
  16589. ><HR><H2
  16590. CLASS="sect1"
  16591. ><A
  16592. NAME="language.types.string"
  16593. ></A
  16594. >Strings</H2
  16595. ><P
  16596. >     A <A
  16597. HREF="#language.types.string"
  16598. ><B
  16599. CLASS="type"
  16600. >string</B
  16601. ></A
  16602. > is series of characters. In PHP,
  16603.     a character is the same as a byte, that is, there are exactly
  16604.     256 different characters possible. This also implies that PHP
  16605.     has no native support of Unicode. See <A
  16606. HREF="#function.utf8-encode"
  16607. ><B
  16608. CLASS="function"
  16609. >utf8_encode()</B
  16610. ></A
  16611. >
  16612.     and <A
  16613. HREF="#function.utf8-decode"
  16614. ><B
  16615. CLASS="function"
  16616. >utf8_decode()</B
  16617. ></A
  16618. > for some Unicode support.
  16619.    </P
  16620. ><DIV
  16621. CLASS="note"
  16622. ><BLOCKQUOTE
  16623. CLASS="note"
  16624. ><P
  16625. ><B
  16626. >Poznßmka: </B
  16627. >
  16628.      It is no problem for a string to become very large. 
  16629.      There is no practical bound to the size
  16630.      of strings imposed by PHP, so there is no reason at all
  16631.      to worry about long strings.
  16632.     </P
  16633. ></BLOCKQUOTE
  16634. ></DIV
  16635. ><DIV
  16636. CLASS="sect2"
  16637. ><HR><H3
  16638. CLASS="sect2"
  16639. ><A
  16640. NAME="language.types.string.syntax"
  16641. ></A
  16642. >Syntax</H3
  16643. ><P
  16644. >      A string literal can be specified in three different
  16645.      ways.
  16646.      <P
  16647. ></P
  16648. ><UL
  16649. ><LI
  16650. ><P
  16651. >         <A
  16652. HREF="#language.types.string.syntax.single"
  16653. >single quoted</A
  16654. >
  16655.        </P
  16656. ></LI
  16657. ><LI
  16658. ><P
  16659. >         <A
  16660. HREF="#language.types.string.syntax.double"
  16661. >double quoted</A
  16662. >
  16663.        </P
  16664. ></LI
  16665. ><LI
  16666. ><P
  16667. >         <A
  16668. HREF="#language.types.string.syntax.heredoc"
  16669. >heredoc syntax</A
  16670. >
  16671.        </P
  16672. ></LI
  16673. ></UL
  16674. >
  16675.     </P
  16676. ><DIV
  16677. CLASS="sect3"
  16678. ><HR><H4
  16679. CLASS="sect3"
  16680. ><A
  16681. NAME="language.types.string.syntax.single"
  16682. ></A
  16683. >Single quoted</H4
  16684. ><P
  16685. >       The easiest way to specify a simple string is to
  16686.       enclose it in single quotes (the character <TT
  16687. CLASS="literal"
  16688. >'</TT
  16689. >). 
  16690.      </P
  16691. ><P
  16692. >       To specify a literal single
  16693.       quote, you will need to escape it with a backslash
  16694.       (<TT
  16695. CLASS="literal"
  16696. >\</TT
  16697. >), like in many other languages.
  16698.       If a backslash needs to occur before a single quote or at 
  16699.       the end of the string, you need to double it.
  16700.       Note that if you try to escape any
  16701.       other character, the backslash will also be printed! So
  16702.       usually there is no need to escape the backslash itself.
  16703.       <DIV
  16704. CLASS="note"
  16705. ><BLOCKQUOTE
  16706. CLASS="note"
  16707. ><P
  16708. ><B
  16709. >Poznßmka: </B
  16710. >
  16711.         In PHP 3, a warning will
  16712.         be issued at the <TT
  16713. CLASS="literal"
  16714. >E_NOTICE</TT
  16715. > level when this
  16716.         happens.
  16717.        </P
  16718. ></BLOCKQUOTE
  16719. ></DIV
  16720. >
  16721.       <DIV
  16722. CLASS="note"
  16723. ><BLOCKQUOTE
  16724. CLASS="note"
  16725. ><P
  16726. ><B
  16727. >Poznßmka: </B
  16728. >
  16729.         Unlike the two other syntaxes, <A
  16730. HREF="#language.variables"
  16731. >variables</A
  16732. > and escape sequences
  16733.         for special characters will <SPAN
  16734. CLASS="emphasis"
  16735. ><I
  16736. CLASS="emphasis"
  16737. >not</I
  16738. ></SPAN
  16739. > be expanded 
  16740.         when they occur in single quoted strings.
  16741.        </P
  16742. ></BLOCKQUOTE
  16743. ></DIV
  16744. >
  16745.       <DIV
  16746. CLASS="informalexample"
  16747. ><A
  16748. NAME="AEN3487"
  16749. ></A
  16750. ><P
  16751. ></P
  16752. ><TABLE
  16753. BORDER="0"
  16754. BGCOLOR="#E0E0E0"
  16755. CELLPADDING="5"
  16756. ><TR
  16757. ><TD
  16758. ><PRE
  16759. CLASS="php"
  16760. ><?php
  16761. echo 'this is a simple string';
  16762.  
  16763. echo 'You can also have embedded newlines in 
  16764. strings this way as it is
  16765. okay to do';
  16766.  
  16767. // Outputs: Arnold once said: "I'll be back"
  16768. echo 'Arnold once said: "I\'ll be back"';
  16769.  
  16770. // Outputs: You deleted C:\*.*?
  16771. echo 'You deleted C:\\*.*?';
  16772.  
  16773. // Outputs: You deleted C:\*.*?
  16774. echo 'You deleted C:\*.*?';
  16775.  
  16776. // Outputs: This will not expand: \n a newline
  16777. echo 'This will not expand: \n a newline';
  16778.  
  16779. // Outputs: Variables do not $expand $either
  16780. echo 'Variables do not $expand $either';
  16781. ?></PRE
  16782. ></TD
  16783. ></TR
  16784. ></TABLE
  16785. ><P
  16786. ></P
  16787. ></DIV
  16788. >
  16789.      </P
  16790. ></DIV
  16791. ><DIV
  16792. CLASS="sect3"
  16793. ><HR><H4
  16794. CLASS="sect3"
  16795. ><A
  16796. NAME="language.types.string.syntax.double"
  16797. ></A
  16798. >Double quoted</H4
  16799. ><P
  16800. >       If the string is enclosed in double-quotes ("),
  16801.       PHP understands more escape sequences for special
  16802.       characters:
  16803.      </P
  16804. ><DIV
  16805. CLASS="table"
  16806. ><A
  16807. NAME="AEN3492"
  16808. ></A
  16809. ><P
  16810. ><B
  16811. >Tabulka 6-1. Escaped characters</B
  16812. ></P
  16813. ><TABLE
  16814. BORDER="1"
  16815. CLASS="CALSTABLE"
  16816. ><THEAD
  16817. ><TR
  16818. ><TH
  16819. ALIGN="LEFT"
  16820. VALIGN="MIDDLE"
  16821. >sequence</TH
  16822. ><TH
  16823. ALIGN="LEFT"
  16824. VALIGN="MIDDLE"
  16825. >meaning</TH
  16826. ></TR
  16827. ></THEAD
  16828. ><TBODY
  16829. ><TR
  16830. ><TD
  16831. ALIGN="LEFT"
  16832. VALIGN="MIDDLE"
  16833. ><TT
  16834. CLASS="literal"
  16835. >\n</TT
  16836. ></TD
  16837. ><TD
  16838. ALIGN="LEFT"
  16839. VALIGN="MIDDLE"
  16840. >linefeed (LF or 0x0A (10) in ASCII)</TD
  16841. ></TR
  16842. ><TR
  16843. ><TD
  16844. ALIGN="LEFT"
  16845. VALIGN="MIDDLE"
  16846. ><TT
  16847. CLASS="literal"
  16848. >\r</TT
  16849. ></TD
  16850. ><TD
  16851. ALIGN="LEFT"
  16852. VALIGN="MIDDLE"
  16853. >carriage return (CR or 0x0D (13) in ASCII)</TD
  16854. ></TR
  16855. ><TR
  16856. ><TD
  16857. ALIGN="LEFT"
  16858. VALIGN="MIDDLE"
  16859. ><TT
  16860. CLASS="literal"
  16861. >\t</TT
  16862. ></TD
  16863. ><TD
  16864. ALIGN="LEFT"
  16865. VALIGN="MIDDLE"
  16866. >horizontal tab (HT or 0x09 (9) in ASCII)</TD
  16867. ></TR
  16868. ><TR
  16869. ><TD
  16870. ALIGN="LEFT"
  16871. VALIGN="MIDDLE"
  16872. ><TT
  16873. CLASS="literal"
  16874. >\\</TT
  16875. ></TD
  16876. ><TD
  16877. ALIGN="LEFT"
  16878. VALIGN="MIDDLE"
  16879. >backslash</TD
  16880. ></TR
  16881. ><TR
  16882. ><TD
  16883. ALIGN="LEFT"
  16884. VALIGN="MIDDLE"
  16885. ><TT
  16886. CLASS="literal"
  16887. >\$</TT
  16888. ></TD
  16889. ><TD
  16890. ALIGN="LEFT"
  16891. VALIGN="MIDDLE"
  16892. >dollar sign</TD
  16893. ></TR
  16894. ><TR
  16895. ><TD
  16896. ALIGN="LEFT"
  16897. VALIGN="MIDDLE"
  16898. ><TT
  16899. CLASS="literal"
  16900. >\"</TT
  16901. ></TD
  16902. ><TD
  16903. ALIGN="LEFT"
  16904. VALIGN="MIDDLE"
  16905. >double-quote</TD
  16906. ></TR
  16907. ><TR
  16908. ><TD
  16909. ALIGN="LEFT"
  16910. VALIGN="MIDDLE"
  16911. ><TT
  16912. CLASS="literal"
  16913. >\[0-7]{1,3}</TT
  16914. ></TD
  16915. ><TD
  16916. ALIGN="LEFT"
  16917. VALIGN="MIDDLE"
  16918. >           the sequence of characters matching the regular
  16919.           expression is a character in octal notation
  16920.          </TD
  16921. ></TR
  16922. ><TR
  16923. ><TD
  16924. ALIGN="LEFT"
  16925. VALIGN="MIDDLE"
  16926. ><TT
  16927. CLASS="literal"
  16928. >\x[0-9A-Fa-f]{1,2}</TT
  16929. ></TD
  16930. ><TD
  16931. ALIGN="LEFT"
  16932. VALIGN="MIDDLE"
  16933. >           the sequence of characters matching the regular
  16934.           expression is a character in hexadecimal notation
  16935.          </TD
  16936. ></TR
  16937. ></TBODY
  16938. ></TABLE
  16939. ></DIV
  16940. ><P
  16941. >       Again, if you try to escape any other character, the
  16942.       backslash will be printed too!
  16943.      </P
  16944. ><P
  16945. >       But the most important feature of double-quoted strings
  16946.       is the fact that variable names will be expanded.
  16947.       See <A
  16948. HREF="#language.types.string.parsing"
  16949. >string 
  16950.       parsing</A
  16951. > for details.
  16952.      </P
  16953. ></DIV
  16954. ><DIV
  16955. CLASS="sect3"
  16956. ><HR><H4
  16957. CLASS="sect3"
  16958. ><A
  16959. NAME="language.types.string.syntax.heredoc"
  16960. ></A
  16961. >Heredoc</H4
  16962. ><P
  16963. >       Another way to delimit strings is by using heredoc syntax
  16964.       ("<<<").  One should provide an identifier after
  16965.       <TT
  16966. CLASS="literal"
  16967. ><<<</TT
  16968. >, then the string, and then the
  16969.       same identifier to close the quotation. 
  16970.      </P
  16971. ><P
  16972. >       The closing identifier <SPAN
  16973. CLASS="emphasis"
  16974. ><I
  16975. CLASS="emphasis"
  16976. >must</I
  16977. ></SPAN
  16978. > begin in the
  16979.       first column of the line. Also, the identifier used must follow
  16980.       the same naming rules as any other label in PHP: it must contain
  16981.       only alphanumeric characters and underscores, and must start with
  16982.       a non-digit character or underscore.
  16983.      </P
  16984. ><DIV
  16985. CLASS="warning"
  16986. ><P
  16987. ></P
  16988. ><TABLE
  16989. CLASS="warning"
  16990. BORDER="1"
  16991. WIDTH="100%"
  16992. ><TR
  16993. ><TD
  16994. ALIGN="CENTER"
  16995. ><B
  16996. >Varovßnφ</B
  16997. ></TD
  16998. ></TR
  16999. ><TR
  17000. ><TD
  17001. ALIGN="LEFT"
  17002. ><P
  17003. >        It is very important to note that the line with the closing
  17004.        identifier contains no other characters, except 
  17005.        <SPAN
  17006. CLASS="emphasis"
  17007. ><I
  17008. CLASS="emphasis"
  17009. >possibly</I
  17010. ></SPAN
  17011. > a semicolon (<TT
  17012. CLASS="literal"
  17013. >;</TT
  17014. >).
  17015.        That means especially that the identifier 
  17016.        <SPAN
  17017. CLASS="emphasis"
  17018. ><I
  17019. CLASS="emphasis"
  17020. >may not be indented</I
  17021. ></SPAN
  17022. >, and there
  17023.        may not be any spaces or tabs after or before the semicolon.
  17024.        It's also important to realize that the first character before
  17025.        the closing identifier must be a newline as defined by your
  17026.        operating system. This is <TT
  17027. CLASS="literal"
  17028. >\r</TT
  17029. > on Macintosh
  17030.        for example.
  17031.       </P
  17032. ><P
  17033. >        If this rule is broken and the closing identifier is not "clean"
  17034.        then it's not considered to be a closing identifier and PHP 
  17035.        will continue looking for one.  If in this case a proper closing 
  17036.        identifier is not found then a parse error will result with the 
  17037.        line number being at the end of the script.
  17038.       </P
  17039. ></TD
  17040. ></TR
  17041. ></TABLE
  17042. ></DIV
  17043. ><P
  17044. >       Heredoc text behaves just like a double-quoted string, without
  17045.       the double-quotes. This means that you do not need to escape quotes
  17046.       in your here docs, but you can still use the escape codes listed
  17047.       above. Variables are expanded, but the same care must be taken
  17048.       when expressing complex variables inside a here doc as with
  17049.       strings.
  17050.       <TABLE
  17051. WIDTH="100%"
  17052. BORDER="0"
  17053. CELLPADDING="0"
  17054. CELLSPACING="0"
  17055. CLASS="EXAMPLE"
  17056. ><TR
  17057. ><TD
  17058. ><DIV
  17059. CLASS="example"
  17060. ><A
  17061. NAME="AEN3549"
  17062. ></A
  17063. ><P
  17064. ><B
  17065. >P°φklad 6-2. Heredoc string quoting example</B
  17066. ></P
  17067. ><TABLE
  17068. BORDER="0"
  17069. BGCOLOR="#E0E0E0"
  17070. CELLPADDING="5"
  17071. ><TR
  17072. ><TD
  17073. ><PRE
  17074. CLASS="php"
  17075. ><?php
  17076. $str = <<<EOD
  17077. Example of string
  17078. spanning multiple lines
  17079. using heredoc syntax.
  17080. EOD;
  17081.  
  17082. /* More complex example, with variables. */
  17083. class foo
  17084. {
  17085.     var $foo;
  17086.     var $bar;
  17087.  
  17088.     function foo()
  17089.     {
  17090.         $this->foo = 'Foo';
  17091.         $this->bar = array('Bar1', 'Bar2', 'Bar3');
  17092.     }
  17093. }
  17094.  
  17095. $foo = new foo();
  17096. $name = 'MyName';
  17097.  
  17098. echo <<<EOT
  17099. My name is "$name". I am printing some $foo->foo.
  17100. Now, I am printing some {$foo->bar[1]}.
  17101. This should print a capital 'A': \x41
  17102. EOT;
  17103. ?></PRE
  17104. ></TD
  17105. ></TR
  17106. ></TABLE
  17107. ></DIV
  17108. ></TD
  17109. ></TR
  17110. ></TABLE
  17111. >
  17112.      </P
  17113. ><DIV
  17114. CLASS="note"
  17115. ><BLOCKQUOTE
  17116. CLASS="note"
  17117. ><P
  17118. ><B
  17119. >Poznßmka: </B
  17120. >
  17121.        Heredoc support was added in PHP 4.
  17122.       </P
  17123. ></BLOCKQUOTE
  17124. ></DIV
  17125. ></DIV
  17126. ><DIV
  17127. CLASS="sect3"
  17128. ><HR><H4
  17129. CLASS="sect3"
  17130. ><A
  17131. NAME="language.types.string.parsing"
  17132. ></A
  17133. >Variable parsing</H4
  17134. ><P
  17135. >       When a string is specified in double quotes or with
  17136.       heredoc, <A
  17137. HREF="#language.variables"
  17138. >variables</A
  17139. > are 
  17140.       parsed within it. 
  17141.      </P
  17142. ><P
  17143. >       There are two types of syntax: a 
  17144.       <A
  17145. HREF="#language.types.string.parsing.simple"
  17146. >simple</A
  17147. >
  17148.       one and a 
  17149.       <A
  17150. HREF="#language.types.string.parsing.complex"
  17151. >complex</A
  17152. >
  17153.       one.
  17154.       The simple syntax is the most common and convenient. It provides a way
  17155.       to parse a variable, an <A
  17156. HREF="#language.types.array"
  17157. ><B
  17158. CLASS="type"
  17159. >array</B
  17160. ></A
  17161. > value, or an 
  17162.       object property.
  17163.      </P
  17164. ><P
  17165. >       The complex syntax was introduced in PHP 4, and can be recognised
  17166.       by the curly braces surrounding the expression.
  17167.      </P
  17168. ><DIV
  17169. CLASS="sect4"
  17170. ><HR><H5
  17171. CLASS="sect4"
  17172. ><A
  17173. NAME="language.types.string.parsing.simple"
  17174. ></A
  17175. >Simple syntax</H5
  17176. ><P
  17177. >        If a dollar sign (<TT
  17178. CLASS="literal"
  17179. >$</TT
  17180. >) is encountered, the
  17181.        parser will greedily take as many tokens as possible to form a
  17182.        valid variable name. Enclose the variable name in curly
  17183.        braces if you want to explicitly specify the end of the name.
  17184.       </P
  17185. ><DIV
  17186. CLASS="informalexample"
  17187. ><A
  17188. NAME="AEN3568"
  17189. ></A
  17190. ><P
  17191. ></P
  17192. ><TABLE
  17193. BORDER="0"
  17194. BGCOLOR="#E0E0E0"
  17195. CELLPADDING="5"
  17196. ><TR
  17197. ><TD
  17198. ><PRE
  17199. CLASS="php"
  17200. ><?php
  17201. $beer = 'Heineken';
  17202. echo "$beer's taste is great"; // works, "'" is an invalid character for varnames
  17203. echo "He drank some $beers";   // won't work, 's' is a valid character for varnames
  17204. echo "He drank some ${beer}s"; // works
  17205. echo "He drank some {$beer}s"; // works
  17206. ?></PRE
  17207. ></TD
  17208. ></TR
  17209. ></TABLE
  17210. ><P
  17211. ></P
  17212. ></DIV
  17213. ><P
  17214. >        Similarly, you can also have an <A
  17215. HREF="#language.types.array"
  17216. ><B
  17217. CLASS="type"
  17218. >array</B
  17219. ></A
  17220. > index or an 
  17221.        object property parsed. With array indices, the closing square 
  17222.        bracket (<TT
  17223. CLASS="literal"
  17224. >]</TT
  17225. >) marks the end of the index. For
  17226.        object properties the same rules apply as to simple variables,
  17227.        though with object properties there doesn't exist a trick like
  17228.        the one with variables.
  17229.        
  17230.        
  17231.       
  17232.       </P
  17233. ><DIV
  17234. CLASS="informalexample"
  17235. ><A
  17236. NAME="AEN3574"
  17237. ></A
  17238. ><P
  17239. ></P
  17240. ><TABLE
  17241. BORDER="0"
  17242. BGCOLOR="#E0E0E0"
  17243. CELLPADDING="5"
  17244. ><TR
  17245. ><TD
  17246. ><PRE
  17247. CLASS="php"
  17248. ><?php
  17249. // These examples are specific to using arrays inside of strings.
  17250. // When outside of a string, always quote your array string keys 
  17251. // and do not use {braces} when outside of strings either.
  17252.  
  17253. // Let's show all errors
  17254. error_reporting(E_ALL);
  17255.  
  17256. $fruits = array('strawberry' => 'red', 'banana' => 'yellow');
  17257.  
  17258. // Works but note that this works differently outside string-quotes
  17259. echo "A banana is $fruits[banana].";
  17260.  
  17261. // Works
  17262. echo "A banana is {$fruits['banana']}.";
  17263.  
  17264. // Works but PHP looks for a constant named banana first
  17265. // as described below.
  17266. echo "A banana is {$fruits[banana]}.";
  17267.  
  17268. // Won't work, use braces.  This results in a parse error.
  17269. echo "A banana is $fruits['banana'].";
  17270.  
  17271. // Works
  17272. echo "A banana is " . $fruits['banana'] . ".";
  17273.  
  17274. // Works
  17275. echo "This square is $square->width meters broad.";
  17276.  
  17277. // Won't work. For a solution, see the complex syntax.
  17278. echo "This square is $square->width00 centimeters broad.";
  17279. ?></PRE
  17280. ></TD
  17281. ></TR
  17282. ></TABLE
  17283. ><P
  17284. ></P
  17285. ></DIV
  17286. ><P
  17287. >        For anything more complex, you should use the complex syntax.
  17288.       </P
  17289. ></DIV
  17290. ><DIV
  17291. CLASS="sect4"
  17292. ><HR><H5
  17293. CLASS="sect4"
  17294. ><A
  17295. NAME="language.types.string.parsing.complex"
  17296. ></A
  17297. >Complex (curly) syntax</H5
  17298. ><P
  17299. >        This isn't called complex because the syntax is complex,
  17300.        but because you can include complex expressions this way.
  17301.      </P
  17302. ><P
  17303. >       In fact, you can include any value that is in the namespace
  17304.       in strings with this syntax. You simply write the expression
  17305.       the same way as you would outside the string, and then include
  17306.       it in { and }. Since you can't escape '{', this syntax will
  17307.       only be recognised when the $ is immediately following the {.
  17308.       (Use "{\$" or "\{$" to get a literal "{$").
  17309.       Some examples to make it clear:
  17310.      </P
  17311. ><DIV
  17312. CLASS="informalexample"
  17313. ><A
  17314. NAME="AEN3581"
  17315. ></A
  17316. ><P
  17317. ></P
  17318. ><TABLE
  17319. BORDER="0"
  17320. BGCOLOR="#E0E0E0"
  17321. CELLPADDING="5"
  17322. ><TR
  17323. ><TD
  17324. ><PRE
  17325. CLASS="php"
  17326. ><?php
  17327. // Let's show all errors
  17328. error_reporting(E_ALL);
  17329.  
  17330. $great = 'fantastic';
  17331.  
  17332. // Won't work, outputs: This is { fantastic}
  17333. echo "This is { $great}";
  17334.  
  17335. // Works, outputs: This is fantastic
  17336. echo "This is {$great}";
  17337. echo "This is ${great}";
  17338.  
  17339. // Works
  17340. echo "This square is {$square->width}00 centimeters broad."; 
  17341.  
  17342. // Works
  17343. echo "This works: {$arr[4][3]}";
  17344.  
  17345. // This is wrong for the same reason as $foo[bar] is wrong 
  17346. // outside a string.  In other words, it will still work but
  17347. // because PHP first looks for a constant named foo, it will
  17348. // throw an error of level E_NOTICE (undefined constant).
  17349. echo "This is wrong: {$arr[foo][3]}"; 
  17350.  
  17351. // Works.  When using multi-dimensional arrays, always use
  17352. // braces around arrays when inside of strings
  17353. echo "This works: {$arr['foo'][3]}";
  17354.  
  17355. // Works.
  17356. echo "This works: " . $arr['foo'][3];
  17357.  
  17358. echo "You can even write {$obj->values[3]->name}";
  17359.  
  17360. echo "This is the value of the var named $name: {${$name}}";
  17361. ?></PRE
  17362. ></TD
  17363. ></TR
  17364. ></TABLE
  17365. ><P
  17366. ></P
  17367. ></DIV
  17368. ></DIV
  17369. ></DIV
  17370. ><DIV
  17371. CLASS="sect3"
  17372. ><HR><H4
  17373. CLASS="sect3"
  17374. ><A
  17375. NAME="language.types.string.substr"
  17376. ></A
  17377. >String access and modification by character</H4
  17378. ><P
  17379. >       Characters within strings may be accessed and modified by specifying the
  17380.       zero-based offset of the desired character after the string 
  17381.       in curly braces.
  17382.      </P
  17383. ><DIV
  17384. CLASS="note"
  17385. ><BLOCKQUOTE
  17386. CLASS="note"
  17387. ><P
  17388. ><B
  17389. >Poznßmka: </B
  17390. >
  17391.        For backwards compatibility, you can still use array-brackets
  17392.        for the same purpose. However, this syntax is deprecated as
  17393.        of PHP 4.
  17394.       </P
  17395. ></BLOCKQUOTE
  17396. ></DIV
  17397. ><P
  17398. >       <TABLE
  17399. WIDTH="100%"
  17400. BORDER="0"
  17401. CELLPADDING="0"
  17402. CELLSPACING="0"
  17403. CLASS="EXAMPLE"
  17404. ><TR
  17405. ><TD
  17406. ><DIV
  17407. CLASS="example"
  17408. ><A
  17409. NAME="AEN3589"
  17410. ></A
  17411. ><P
  17412. ><B
  17413. >P°φklad 6-3. Some string examples</B
  17414. ></P
  17415. ><TABLE
  17416. BORDER="0"
  17417. BGCOLOR="#E0E0E0"
  17418. CELLPADDING="5"
  17419. ><TR
  17420. ><TD
  17421. ><PRE
  17422. CLASS="php"
  17423. ><?php
  17424. // Get the first character of a string
  17425. $str = 'This is a test.';
  17426. $first = $str{0};
  17427.  
  17428. // Get the third character of a string
  17429. $third = $str{2};
  17430.  
  17431. // Get the last character of a string.
  17432. $str = 'This is still a test.';
  17433. $last = $str{strlen($str)-1}; 
  17434.  
  17435. // Modify the last character of a string
  17436. $str = 'Look at the sea';
  17437. $str{strlen($str)-1} = 'e';
  17438.           
  17439. ?></PRE
  17440. ></TD
  17441. ></TR
  17442. ></TABLE
  17443. ></DIV
  17444. ></TD
  17445. ></TR
  17446. ></TABLE
  17447. >
  17448.      </P
  17449. ></DIV
  17450. ></DIV
  17451. ><DIV
  17452. CLASS="sect2"
  17453. ><HR><H3
  17454. CLASS="sect2"
  17455. ><A
  17456. NAME="language.types.string.useful-funcs"
  17457. ></A
  17458. >Useful functions and operators</H3
  17459. ><P
  17460. >      Strings may be concatenated using the '.' (dot) operator. Note
  17461.      that the '+' (addition) operator will not work for this. Please
  17462.      see <A
  17463. HREF="#language.operators.string"
  17464. >String
  17465.      operators</A
  17466. > for more information.
  17467.     </P
  17468. ><P
  17469. >      There are a lot of useful functions for string modification.
  17470.     </P
  17471. ><P
  17472. >      See the <A
  17473. HREF="#ref.strings"
  17474. >string functions section</A
  17475. > 
  17476.      for general functions, the regular expression functions for
  17477.      advanced find&replacing (in two tastes: 
  17478.      <A
  17479. HREF="#ref.pcre"
  17480. >Perl</A
  17481. > and 
  17482.      <A
  17483. HREF="#ref.regex"
  17484. >POSIX extended</A
  17485. >).
  17486.     </P
  17487. ><P
  17488. >      There are also <A
  17489. HREF="#ref.url"
  17490. >functions for URL-strings</A
  17491. >,
  17492.      and functions to encrypt/decrypt strings 
  17493.      (<A
  17494. HREF="#ref.mcrypt"
  17495. >mcrypt</A
  17496. > and 
  17497.      <A
  17498. HREF="#ref.mhash"
  17499. >mhash</A
  17500. >).
  17501.     </P
  17502. ><P
  17503. >      Finally, if you still didn't find what you're looking for,
  17504.      see also the <A
  17505. HREF="#ref.ctype"
  17506. >character type functions</A
  17507. >.
  17508.     </P
  17509. ></DIV
  17510. ><DIV
  17511. CLASS="sect2"
  17512. ><HR><H3
  17513. CLASS="sect2"
  17514. ><A
  17515. NAME="language.types.string.casting"
  17516. ></A
  17517. >Converting to string</H3
  17518. ><P
  17519. >      You can convert a value to a string using the <TT
  17520. CLASS="literal"
  17521. >(string)</TT
  17522. >
  17523.      cast, or the <A
  17524. HREF="#function.strval"
  17525. ><B
  17526. CLASS="function"
  17527. >strval()</B
  17528. ></A
  17529. > function. String conversion
  17530.      is automatically done in the scope of an expression for you where a
  17531.      string is needed. This happens when you use the <A
  17532. HREF="#function.echo"
  17533. ><B
  17534. CLASS="function"
  17535. >echo()</B
  17536. ></A
  17537. >
  17538.      or <A
  17539. HREF="#function.print"
  17540. ><B
  17541. CLASS="function"
  17542. >print()</B
  17543. ></A
  17544. > functions, or when you compare a variable
  17545.      value to a string.  Reading the manual sections on <A
  17546. HREF="#language.types"
  17547. >Types</A
  17548. > and <A
  17549. HREF="#language.types.type-juggling"
  17550. >Type Juggling</A
  17551. > will make
  17552.      the following clearer.  See also <A
  17553. HREF="#function.settype"
  17554. ><B
  17555. CLASS="function"
  17556. >settype()</B
  17557. ></A
  17558. >.
  17559.     </P
  17560. ><P
  17561. >      A <A
  17562. HREF="#language.types.boolean"
  17563. ><B
  17564. CLASS="type"
  17565. >boolean</B
  17566. ></A
  17567. > <TT
  17568. CLASS="constant"
  17569. ><B
  17570. >TRUE</B
  17571. ></TT
  17572. > value is converted to the string <TT
  17573. CLASS="literal"
  17574. >"1"</TT
  17575. >,
  17576.      the <TT
  17577. CLASS="constant"
  17578. ><B
  17579. >FALSE</B
  17580. ></TT
  17581. > value is represented as <TT
  17582. CLASS="literal"
  17583. >""</TT
  17584. > (empty string).
  17585.      This way you can convert back and forth between boolean and string values.
  17586.     </P
  17587. ><P
  17588. > 
  17589.      An <A
  17590. HREF="#language.types.integer"
  17591. ><B
  17592. CLASS="type"
  17593. >integer</B
  17594. ></A
  17595. > or a floating point number (<A
  17596. HREF="#language.types.float"
  17597. ><B
  17598. CLASS="type"
  17599. >float</B
  17600. ></A
  17601. >) 
  17602.      is converted to a string representing the number with its digits
  17603.      (including the exponent part for floating point numbers).
  17604.     </P
  17605. ><P
  17606. >      Arrays are always converted to the string <TT
  17607. CLASS="literal"
  17608. >"Array"</TT
  17609. >,
  17610.      so you cannot dump out the contents of an <A
  17611. HREF="#language.types.array"
  17612. ><B
  17613. CLASS="type"
  17614. >array</B
  17615. ></A
  17616. > with 
  17617.      <A
  17618. HREF="#function.echo"
  17619. ><B
  17620. CLASS="function"
  17621. >echo()</B
  17622. ></A
  17623. > or <A
  17624. HREF="#function.print"
  17625. ><B
  17626. CLASS="function"
  17627. >print()</B
  17628. ></A
  17629. > to see what is inside 
  17630.      them.  To view one element, you'd do something like <TT
  17631. CLASS="literal"
  17632. >      echo $arr['foo']</TT
  17633. >.  See below for tips on dumping/viewing the 
  17634.      entire contents.
  17635.     </P
  17636. ><P
  17637. >      Objects are always converted to the string <TT
  17638. CLASS="literal"
  17639. >"Object"</TT
  17640. >.
  17641.      If you would like to print out the member variable values of an 
  17642.      <A
  17643. HREF="#language.types.object"
  17644. ><B
  17645. CLASS="type"
  17646. >object</B
  17647. ></A
  17648. > for debugging reasons, read the paragraphs 
  17649.      below. If you would like to find out the class name of which an object 
  17650.      is an instance of, use <A
  17651. HREF="#function.get-class"
  17652. ><B
  17653. CLASS="function"
  17654. >get_class()</B
  17655. ></A
  17656. >.
  17657.     </P
  17658. ><P
  17659. >      Resources are always converted to strings with the structure
  17660.      <TT
  17661. CLASS="literal"
  17662. >"Resource id #1"</TT
  17663. > where <TT
  17664. CLASS="literal"
  17665. >1</TT
  17666. > is
  17667.      the unique number of the <A
  17668. HREF="#language.types.resource"
  17669. ><B
  17670. CLASS="type"
  17671. >resource</B
  17672. ></A
  17673. > assigned by PHP during runtime.
  17674.      If you would like to get the type of the resource, use
  17675.      <A
  17676. HREF="#function.get-resource-type"
  17677. ><B
  17678. CLASS="function"
  17679. >get_resource_type()</B
  17680. ></A
  17681. >.
  17682.     </P
  17683. ><P
  17684. >      <TT
  17685. CLASS="constant"
  17686. ><B
  17687. >NULL</B
  17688. ></TT
  17689. > is always converted to an empty string.
  17690.     </P
  17691. ><P
  17692. >      As you can see above, printing out the arrays, objects or resources does not
  17693.      provide you any useful information about the values themselfs. Look at the
  17694.      functions <A
  17695. HREF="#function.print-r"
  17696. ><B
  17697. CLASS="function"
  17698. >print_r()</B
  17699. ></A
  17700. > and <A
  17701. HREF="#function.var-dump"
  17702. ><B
  17703. CLASS="function"
  17704. >var_dump()</B
  17705. ></A
  17706. >
  17707.      for better ways to print out values for debugging.
  17708.     </P
  17709. ><P
  17710. >      You can also convert PHP values to strings to store them permanently. This
  17711.      method is called serialization, and can be done with the function
  17712.      <A
  17713. HREF="#function.serialize"
  17714. ><B
  17715. CLASS="function"
  17716. >serialize()</B
  17717. ></A
  17718. >. You can also serialize PHP values to
  17719.      XML structures, if you have <A
  17720. HREF="#ref.wddx"
  17721. >WDDX</A
  17722. > support
  17723.      in your PHP setup.
  17724.     </P
  17725. ></DIV
  17726. ><DIV
  17727. CLASS="sect2"
  17728. ><HR><H3
  17729. CLASS="sect2"
  17730. ><A
  17731. NAME="language.types.string.conversion"
  17732. ></A
  17733. >String conversion to numbers</H3
  17734. ><P
  17735. >      When a string is evaluated as a numeric value, the resulting
  17736.      value and type are determined as follows.
  17737.     </P
  17738. ><P
  17739. >      The string will evaluate as a <A
  17740. HREF="#language.types.float"
  17741. ><B
  17742. CLASS="type"
  17743. >float</B
  17744. ></A
  17745. > if it contains any of the
  17746.      characters '.', 'e', or 'E'. Otherwise, it will evaluate as an
  17747.      integer.
  17748.     </P
  17749. ><P
  17750. >      The value is given by the initial portion of the string. If the
  17751.      string starts with valid numeric data, this will be the value
  17752.      used. Otherwise, the value will be 0 (zero). Valid numeric data
  17753.      is an optional sign, followed by one or more digits (optionally
  17754.      containing a decimal point), followed by an optional
  17755.      exponent. The exponent is an 'e' or 'E' followed by one or more
  17756.      digits.
  17757.     </P
  17758. ><DIV
  17759. CLASS="informalexample"
  17760. ><A
  17761. NAME="AEN3655"
  17762. ></A
  17763. ><P
  17764. ></P
  17765. ><TABLE
  17766. BORDER="0"
  17767. BGCOLOR="#E0E0E0"
  17768. CELLPADDING="5"
  17769. ><TR
  17770. ><TD
  17771. ><PRE
  17772. CLASS="php"
  17773. ><?php
  17774. $foo = 1 + "10.5";                // $foo is float (11.5)
  17775. $foo = 1 + "-1.3e3";              // $foo is float (-1299)
  17776. $foo = 1 + "bob-1.3e3";           // $foo is integer (1)
  17777. $foo = 1 + "bob3";                // $foo is integer (1)
  17778. $foo = 1 + "10 Small Pigs";       // $foo is integer (11)
  17779. $foo = 4 + "10.2 Little Piggies"; // $foo is float (14.2)
  17780. $foo = "10.0 pigs " + 1;          // $foo is float (11)
  17781. $foo = "10.0 pigs " + 1.0;        // $foo is float (11)     
  17782. ?></PRE
  17783. ></TD
  17784. ></TR
  17785. ></TABLE
  17786. ><P
  17787. ></P
  17788. ></DIV
  17789. ><P
  17790. >      For more information on this conversion, see the Unix manual page
  17791.      for strtod(3).
  17792.     </P
  17793. ><P
  17794. >      If you would like to test any of the examples in this section,
  17795.      you can cut and paste the examples and insert the following line
  17796.      to see for yourself what's going on:
  17797.      <DIV
  17798. CLASS="informalexample"
  17799. ><A
  17800. NAME="AEN3659"
  17801. ></A
  17802. ><P
  17803. ></P
  17804. ><TABLE
  17805. BORDER="0"
  17806. BGCOLOR="#E0E0E0"
  17807. CELLPADDING="5"
  17808. ><TR
  17809. ><TD
  17810. ><PRE
  17811. CLASS="php"
  17812. ><?php
  17813. echo "\$foo==$foo; type is " . gettype ($foo) . "<br />\n";
  17814. ?></PRE
  17815. ></TD
  17816. ></TR
  17817. ></TABLE
  17818. ><P
  17819. ></P
  17820. ></DIV
  17821. >
  17822.     </P
  17823. ><P
  17824. >      Do not expect to get the code of one character by converting it
  17825.      to integer (as you would do in C for example). Use the functions
  17826.      <A
  17827. HREF="#function.ord"
  17828. ><B
  17829. CLASS="function"
  17830. >ord()</B
  17831. ></A
  17832. > and <A
  17833. HREF="#function.chr"
  17834. ><B
  17835. CLASS="function"
  17836. >chr()</B
  17837. ></A
  17838. > to convert
  17839.      between charcodes and characters.
  17840.     </P
  17841. ></DIV
  17842. ></DIV
  17843. ><DIV
  17844. CLASS="sect1"
  17845. ><HR><H2
  17846. CLASS="sect1"
  17847. ><A
  17848. NAME="language.types.array"
  17849. ></A
  17850. >Arrays</H2
  17851. ><P
  17852. >     An array in PHP is actually an ordered map. A map is a type that
  17853.     maps <SPAN
  17854. CLASS="emphasis"
  17855. ><I
  17856. CLASS="emphasis"
  17857. >values</I
  17858. ></SPAN
  17859. > to <SPAN
  17860. CLASS="emphasis"
  17861. ><I
  17862. CLASS="emphasis"
  17863. >keys</I
  17864. ></SPAN
  17865. >. 
  17866.     This type is optimized in several ways,
  17867.     so you can use it as a real array, or a list (vector), 
  17868.     hashtable (which is an implementation of a map), 
  17869.     dictionary, collection,
  17870.     stack, queue and probably more. Because you can have another
  17871.     PHP array as a value, you can also quite easily simulate
  17872.     trees.
  17873.    </P
  17874. ><P
  17875. >     Explanation of those data structures is beyond the scope of this
  17876.     manual, but you'll find at least one example for each of them.
  17877.     For more information we refer you to external literature about
  17878.     this broad topic.
  17879.    </P
  17880. ><DIV
  17881. CLASS="sect2"
  17882. ><HR><H3
  17883. CLASS="sect2"
  17884. ><A
  17885. NAME="language.types.array.syntax"
  17886. ></A
  17887. >Syntax</H3
  17888. ><DIV
  17889. CLASS="sect3"
  17890. ><H4
  17891. CLASS="sect3"
  17892. ><A
  17893. NAME="language.types.array.syntax.array-func"
  17894. ></A
  17895. >Specifying with <A
  17896. HREF="#function.array"
  17897. ><B
  17898. CLASS="function"
  17899. >array()</B
  17900. ></A
  17901. ></H4
  17902. ><P
  17903. >       An <A
  17904. HREF="#language.types.array"
  17905. ><B
  17906. CLASS="type"
  17907. >array</B
  17908. ></A
  17909. > can be created by the <A
  17910. HREF="#function.array"
  17911. ><B
  17912. CLASS="function"
  17913. >array()</B
  17914. ></A
  17915. > 
  17916.       language-construct. It takes a certain number of comma-separated
  17917.       <TT
  17918. CLASS="literal"
  17919. ><TT
  17920. CLASS="replaceable"
  17921. ><I
  17922. >key</I
  17923. ></TT
  17924. > => <TT
  17925. CLASS="replaceable"
  17926. ><I
  17927. >value</I
  17928. ></TT
  17929. ></TT
  17930. >
  17931.       pairs.
  17932.      </P
  17933. ><P
  17934. >       <TABLE
  17935. BORDER="0"
  17936. BGCOLOR="#E0E0E0"
  17937. CELLPADDING="5"
  17938. ><TR
  17939. ><TD
  17940. ><PRE
  17941. CLASS="synopsis"
  17942. >array( [<TT
  17943. CLASS="replaceable"
  17944. ><I
  17945. >key</I
  17946. ></TT
  17947. > =>] <TT
  17948. CLASS="replaceable"
  17949. ><I
  17950. >value</I
  17951. ></TT
  17952. >
  17953.      , ...
  17954.      )
  17955. // <TT
  17956. CLASS="replaceable"
  17957. ><I
  17958. >key</I
  17959. ></TT
  17960. > may be an <A
  17961. HREF="#language.types.integer"
  17962. ><B
  17963. CLASS="type"
  17964. >integer</B
  17965. ></A
  17966. > or <A
  17967. HREF="#language.types.string"
  17968. ><B
  17969. CLASS="type"
  17970. >string</B
  17971. ></A
  17972. >
  17973. // <TT
  17974. CLASS="replaceable"
  17975. ><I
  17976. >value</I
  17977. ></TT
  17978. > may be any value</PRE
  17979. ></TD
  17980. ></TR
  17981. ></TABLE
  17982. >
  17983.      </P
  17984. ><P
  17985. >       <DIV
  17986. CLASS="informalexample"
  17987. ><A
  17988. NAME="AEN3691"
  17989. ></A
  17990. ><P
  17991. ></P
  17992. ><TABLE
  17993. BORDER="0"
  17994. BGCOLOR="#E0E0E0"
  17995. CELLPADDING="5"
  17996. ><TR
  17997. ><TD
  17998. ><PRE
  17999. CLASS="php"
  18000. ><?php
  18001. $arr = array("foo" => "bar", 12 => true);
  18002.  
  18003. echo $arr["foo"]; // bar
  18004. echo $arr[12];    // 1
  18005. ?></PRE
  18006. ></TD
  18007. ></TR
  18008. ></TABLE
  18009. ><P
  18010. ></P
  18011. ></DIV
  18012. >
  18013.      </P
  18014. ><P
  18015. >       A <TT
  18016. CLASS="varname"
  18017. >key</TT
  18018. > may be either an
  18019.       <TT
  18020. CLASS="literal"
  18021. >integer</TT
  18022. > or a <A
  18023. HREF="#language.types.string"
  18024. ><B
  18025. CLASS="type"
  18026. >string</B
  18027. ></A
  18028. >. If a key is
  18029.       the standard representation of an <A
  18030. HREF="#language.types.integer"
  18031. ><B
  18032. CLASS="type"
  18033. >integer</B
  18034. ></A
  18035. >, it will
  18036.       be interpreted as such (i.e.  <TT
  18037. CLASS="literal"
  18038. >"8"</TT
  18039. > will be
  18040.       interpreted as <TT
  18041. CLASS="literal"
  18042. >8</TT
  18043. >, while
  18044.       <TT
  18045. CLASS="literal"
  18046. >"08"</TT
  18047. > will be interpreted as
  18048.       <TT
  18049. CLASS="literal"
  18050. >"08"</TT
  18051. >). There are no different indexed and
  18052.       associative array types in PHP; there is only one array type,
  18053.       which can both contain integer and string indices.
  18054.      </P
  18055. ><P
  18056. >       A value can be of any PHP type.
  18057.       <DIV
  18058. CLASS="informalexample"
  18059. ><A
  18060. NAME="AEN3703"
  18061. ></A
  18062. ><P
  18063. ></P
  18064. ><TABLE
  18065. BORDER="0"
  18066. BGCOLOR="#E0E0E0"
  18067. CELLPADDING="5"
  18068. ><TR
  18069. ><TD
  18070. ><PRE
  18071. CLASS="php"
  18072. ><?php
  18073. $arr = array("somearray" => array(6 => 5, 13 => 9, "a" => 42));
  18074.  
  18075. echo $arr["somearray"][6];    // 5
  18076. echo $arr["somearray"][13];   // 9
  18077. echo $arr["somearray"]["a"];  // 42
  18078. ?></PRE
  18079. ></TD
  18080. ></TR
  18081. ></TABLE
  18082. ><P
  18083. ></P
  18084. ></DIV
  18085. >
  18086.      </P
  18087. ><P
  18088. >       If you do not specify a key for a given value, then the maximum
  18089.       of the integer indices is taken, and the new key will be that
  18090.       maximum value + 1. If you specify a key that already has a value
  18091.       assigned to it, that value will be overwritten.
  18092.       <DIV
  18093. CLASS="informalexample"
  18094. ><A
  18095. NAME="AEN3706"
  18096. ></A
  18097. ><P
  18098. ></P
  18099. ><TABLE
  18100. BORDER="0"
  18101. BGCOLOR="#E0E0E0"
  18102. CELLPADDING="5"
  18103. ><TR
  18104. ><TD
  18105. ><PRE
  18106. CLASS="php"
  18107. ><?php
  18108. // This array is the same as ...
  18109. array(5 => 43, 32, 56, "b" => 12);
  18110.  
  18111. // ...this array
  18112. array(5 => 43, 6 => 32, 7 => 56, "b" => 12);
  18113. ?></PRE
  18114. ></TD
  18115. ></TR
  18116. ></TABLE
  18117. ><P
  18118. ></P
  18119. ></DIV
  18120. >
  18121.      </P
  18122. ><DIV
  18123. CLASS="warning"
  18124. ><P
  18125. ></P
  18126. ><TABLE
  18127. CLASS="warning"
  18128. BORDER="1"
  18129. WIDTH="100%"
  18130. ><TR
  18131. ><TD
  18132. ALIGN="CENTER"
  18133. ><B
  18134. >Varovßnφ</B
  18135. ></TD
  18136. ></TR
  18137. ><TR
  18138. ><TD
  18139. ALIGN="LEFT"
  18140. ><P
  18141. >          As of PHP 4.3.0, the index generation behaviour described
  18142.          above has changed. Now, if you append to an array in which
  18143.          the current maximum key is negative, then the next key
  18144.          created will be zero (<TT
  18145. CLASS="literal"
  18146. >0</TT
  18147. >). Before, the new
  18148.          index would have been set to the largest existing key + 1,
  18149.          the same as positive indices are.
  18150.       </P
  18151. ></TD
  18152. ></TR
  18153. ></TABLE
  18154. ></DIV
  18155. ><P
  18156. >       Using <TT
  18157. CLASS="constant"
  18158. ><B
  18159. >TRUE</B
  18160. ></TT
  18161. > as a key will evaluate to <A
  18162. HREF="#language.types.integer"
  18163. ><B
  18164. CLASS="type"
  18165. >integer</B
  18166. ></A
  18167. >
  18168.       <TT
  18169. CLASS="literal"
  18170. >1</TT
  18171. > as key. Using <TT
  18172. CLASS="constant"
  18173. ><B
  18174. >FALSE</B
  18175. ></TT
  18176. > as a key will evaluate
  18177.       to <A
  18178. HREF="#language.types.integer"
  18179. ><B
  18180. CLASS="type"
  18181. >integer</B
  18182. ></A
  18183. > <TT
  18184. CLASS="literal"
  18185. >0</TT
  18186. > as key. Using
  18187.       <TT
  18188. CLASS="literal"
  18189. >NULL</TT
  18190. > as a key will evaluate to the empty
  18191.       string. Using the empty string as key will create (or overwrite)
  18192.       a key with the empty string and its value; it is not the same as
  18193.       using empty brackets.
  18194.      </P
  18195. ><P
  18196. >       You cannot use arrays or objects as keys. Doing so will result in a
  18197.       warning: <TT
  18198. CLASS="literal"
  18199. >Illegal offset type</TT
  18200. >.
  18201.      </P
  18202. ></DIV
  18203. ><DIV
  18204. CLASS="sect3"
  18205. ><HR><H4
  18206. CLASS="sect3"
  18207. ><A
  18208. NAME="language.types.array.syntax.modifying"
  18209. ></A
  18210. >Creating/modifying with square-bracket syntax</H4
  18211. ><P
  18212. >       You can also modify an existing array by explicitly setting
  18213.       values in it.
  18214.      </P
  18215. ><P
  18216. >       This is done by assigning values to the array while specifying the 
  18217.       key in brackets. You can also omit the key, add an empty pair
  18218.       of brackets ("<TT
  18219. CLASS="literal"
  18220. >[]</TT
  18221. >") to the variable name in that case.
  18222.       <TABLE
  18223. BORDER="0"
  18224. BGCOLOR="#E0E0E0"
  18225. CELLPADDING="5"
  18226. ><TR
  18227. ><TD
  18228. ><PRE
  18229. CLASS="synopsis"
  18230. >$arr[<TT
  18231. CLASS="replaceable"
  18232. ><I
  18233. >key</I
  18234. ></TT
  18235. >] = <TT
  18236. CLASS="replaceable"
  18237. ><I
  18238. >value</I
  18239. ></TT
  18240. >;
  18241. $arr[] = <TT
  18242. CLASS="replaceable"
  18243. ><I
  18244. >value</I
  18245. ></TT
  18246. >;
  18247. // <TT
  18248. CLASS="replaceable"
  18249. ><I
  18250. >key</I
  18251. ></TT
  18252. > may be an <A
  18253. HREF="#language.types.integer"
  18254. ><B
  18255. CLASS="type"
  18256. >integer</B
  18257. ></A
  18258. > or <A
  18259. HREF="#language.types.string"
  18260. ><B
  18261. CLASS="type"
  18262. >string</B
  18263. ></A
  18264. >
  18265. // <TT
  18266. CLASS="replaceable"
  18267. ><I
  18268. >value</I
  18269. ></TT
  18270. > may be any value</PRE
  18271. ></TD
  18272. ></TR
  18273. ></TABLE
  18274. >
  18275.       If <TT
  18276. CLASS="varname"
  18277. >$arr</TT
  18278. > doesn't exist yet, it will be created. 
  18279.       So this is also an alternative way to specify an array.
  18280.       To change a certain value, just assign a new value
  18281.       to an element specified with its key. If you want to
  18282.       remove a key/value pair, you need to <A
  18283. HREF="#function.unset"
  18284. ><B
  18285. CLASS="function"
  18286. >unset()</B
  18287. ></A
  18288. > it. 
  18289.       <DIV
  18290. CLASS="informalexample"
  18291. ><A
  18292. NAME="AEN3736"
  18293. ></A
  18294. ><P
  18295. ></P
  18296. ><TABLE
  18297. BORDER="0"
  18298. BGCOLOR="#E0E0E0"
  18299. CELLPADDING="5"
  18300. ><TR
  18301. ><TD
  18302. ><PRE
  18303. CLASS="php"
  18304. ><?php
  18305. $arr = array(5 => 1, 12 => 2);
  18306.  
  18307. $arr[] = 56;    // This is the same as $arr[13] = 56;
  18308.                 // at this point of the script
  18309.  
  18310. $arr["x"] = 42; // This adds a new element to
  18311.                 // the array with key "x"
  18312.                 
  18313. unset($arr[5]); // This removes the element from the array
  18314.  
  18315. unset($arr);    // This deletes the whole array
  18316. ?></PRE
  18317. ></TD
  18318. ></TR
  18319. ></TABLE
  18320. ><P
  18321. ></P
  18322. ></DIV
  18323. >
  18324.      </P
  18325. ><DIV
  18326. CLASS="note"
  18327. ><BLOCKQUOTE
  18328. CLASS="note"
  18329. ><P
  18330. ><B
  18331. >Poznßmka: </B
  18332. >
  18333.        As mentioned above, if you provide the brackets with no key
  18334.        specified, then the maximum of the existing integer indices is
  18335.        taken, and the new key will be that maximum value + 1 . If no
  18336.        integer indices exist yet, the key will be <TT
  18337. CLASS="literal"
  18338. >0</TT
  18339. >
  18340.        (zero). If you specify a key that already has a value assigned
  18341.        to it, that value will be overwritten.
  18342.       </P
  18343. ><P
  18344. >        <DIV
  18345. CLASS="warning"
  18346. ><P
  18347. ></P
  18348. ><TABLE
  18349. CLASS="warning"
  18350. BORDER="1"
  18351. WIDTH="100%"
  18352. ><TR
  18353. ><TD
  18354. ALIGN="CENTER"
  18355. ><B
  18356. >Varovßnφ</B
  18357. ></TD
  18358. ></TR
  18359. ><TR
  18360. ><TD
  18361. ALIGN="LEFT"
  18362. ><P
  18363. >          As of PHP 4.3.0, the index generation behaviour described
  18364.          above has changed. Now, if you append to an array in which
  18365.          the current maximum key is negative, then the next key
  18366.          created will be zero (<TT
  18367. CLASS="literal"
  18368. >0</TT
  18369. >). Before, the new
  18370.          index would have been set to the largest existing key + 1,
  18371.          the same as positive indices are.
  18372.         </P
  18373. ></TD
  18374. ></TR
  18375. ></TABLE
  18376. ></DIV
  18377. >
  18378.       </P
  18379. ><P
  18380. >        Note that the maximum integer key used for this <SPAN
  18381. CLASS="emphasis"
  18382. ><I
  18383. CLASS="emphasis"
  18384. >need
  18385.        not currently exist in the array</I
  18386. ></SPAN
  18387. >. It simply must
  18388.        have existed in the array at some time since the last time the
  18389.        array was re-indexed. The following example illustrates:
  18390.       </P
  18391. ><DIV
  18392. CLASS="informalexample"
  18393. ><A
  18394. NAME="AEN3747"
  18395. ></A
  18396. ><P
  18397. ></P
  18398. ><TABLE
  18399. BORDER="0"
  18400. BGCOLOR="#E0E0E0"
  18401. CELLPADDING="5"
  18402. ><TR
  18403. ><TD
  18404. ><PRE
  18405. CLASS="php"
  18406. ><?php
  18407. // Create a simple array.
  18408. $array = array(1, 2, 3, 4, 5);
  18409. print_r($array);
  18410.  
  18411. // Now delete every item, but leave the array itself intact:
  18412. foreach ($array as $i => $value) {
  18413.     unset($array[$i]);
  18414. }
  18415. print_r($array);
  18416.  
  18417. // Append an item (note that the new key is 5, instead of 0 as you
  18418. // might expect).
  18419. $array[] = 6;
  18420. print_r($array);
  18421.  
  18422. // Re-index:
  18423. $array = array_values($array);
  18424. $array[] = 7;
  18425. print_r($array);
  18426. ?></PRE
  18427. ></TD
  18428. ></TR
  18429. ></TABLE
  18430. ><P
  18431. >         The above example would produce the following output:
  18432.         <TABLE
  18433. BORDER="0"
  18434. BGCOLOR="#E0E0E0"
  18435. CELLPADDING="5"
  18436. ><TR
  18437. ><TD
  18438. ><PRE
  18439. CLASS="screen"
  18440. >Array
  18441. (
  18442.     [0] => 1
  18443.     [1] => 2
  18444.     [2] => 3
  18445.     [3] => 4
  18446.     [4] => 5
  18447. )
  18448. Array
  18449. (
  18450. )
  18451. Array
  18452. (
  18453.     [5] => 6
  18454. )
  18455. Array
  18456. (
  18457.     [0] => 6
  18458.     [1] => 7
  18459. )</PRE
  18460. ></TD
  18461. ></TR
  18462. ></TABLE
  18463. >
  18464.        </P
  18465. ><P
  18466. ></P
  18467. ></DIV
  18468. ></BLOCKQUOTE
  18469. ></DIV
  18470. ></DIV
  18471. ></DIV
  18472. ><DIV
  18473. CLASS="sect2"
  18474. ><HR><H3
  18475. CLASS="sect2"
  18476. ><A
  18477. NAME="language.types.array.useful-funcs"
  18478. ></A
  18479. >Useful functions</H3
  18480. ><P
  18481. >      There are quite a few useful functions for working with arrays.
  18482.      See the <A
  18483. HREF="#ref.array"
  18484. >array functions</A
  18485. > section.
  18486.     </P
  18487. ><DIV
  18488. CLASS="note"
  18489. ><BLOCKQUOTE
  18490. CLASS="note"
  18491. ><P
  18492. ><B
  18493. >Poznßmka: </B
  18494. >
  18495.       The <A
  18496. HREF="#function.unset"
  18497. ><B
  18498. CLASS="function"
  18499. >unset()</B
  18500. ></A
  18501. > function allows unsetting keys of an 
  18502.       array. Be aware that the array will NOT be reindexed. If you only
  18503.       use "usual integer indices" (starting from zero, increasing by one),
  18504.       you can achieve the reindex effect by using <A
  18505. HREF="#function.array-values"
  18506. ><B
  18507. CLASS="function"
  18508. >array_values()</B
  18509. ></A
  18510. >.
  18511.       <DIV
  18512. CLASS="informalexample"
  18513. ><A
  18514. NAME="AEN3759"
  18515. ></A
  18516. ><P
  18517. ></P
  18518. ><TABLE
  18519. BORDER="0"
  18520. BGCOLOR="#E0E0E0"
  18521. CELLPADDING="5"
  18522. ><TR
  18523. ><TD
  18524. ><PRE
  18525. CLASS="php"
  18526. ><?php
  18527. $a = array(1 => 'one', 2 => 'two', 3 => 'three');
  18528. unset($a[2]);
  18529. /* will produce an array that would have been defined as
  18530.    $a = array(1 => 'one', 3 => 'three');
  18531.    and NOT
  18532.    $a = array(1 => 'one', 2 =>'three');
  18533. */
  18534.  
  18535. $b = array_values($a);
  18536. // Now $b is array(0 => 'one', 1 =>'three')
  18537. ?></PRE
  18538. ></TD
  18539. ></TR
  18540. ></TABLE
  18541. ><P
  18542. ></P
  18543. ></DIV
  18544. >
  18545.      
  18546.      </P
  18547. ></BLOCKQUOTE
  18548. ></DIV
  18549. ><P
  18550. >      The <A
  18551. HREF="#control-structures.foreach"
  18552. >foreach</A
  18553. > 
  18554.      control structure exists specifically for arrays. It 
  18555.      provides an easy way to traverse an array.
  18556.     </P
  18557. ></DIV
  18558. ><DIV
  18559. CLASS="sect2"
  18560. ><HR><H3
  18561. CLASS="sect2"
  18562. ><A
  18563. NAME="language.types.array.donts"
  18564. ></A
  18565. >Array do's and don'ts</H3
  18566. ><DIV
  18567. CLASS="sect3"
  18568. ><H4
  18569. CLASS="sect3"
  18570. ><A
  18571. NAME="language.types.array.foo-bar"
  18572. ></A
  18573. >Why is <TT
  18574. CLASS="literal"
  18575. >$foo[bar]</TT
  18576. > wrong?</H4
  18577. ><P
  18578. >       You should always use quotes around a string literal
  18579.       array index.  For example, use $foo['bar'] and not
  18580.       $foo[bar]. But why is $foo[bar] wrong? You might have seen the
  18581.       following syntax in old scripts:
  18582.       <DIV
  18583. CLASS="informalexample"
  18584. ><A
  18585. NAME="AEN3769"
  18586. ></A
  18587. ><P
  18588. ></P
  18589. ><TABLE
  18590. BORDER="0"
  18591. BGCOLOR="#E0E0E0"
  18592. CELLPADDING="5"
  18593. ><TR
  18594. ><TD
  18595. ><PRE
  18596. CLASS="php"
  18597. ><?php
  18598. $foo[bar] = 'enemy';
  18599. echo $foo[bar];
  18600. // etc
  18601. ?></PRE
  18602. ></TD
  18603. ></TR
  18604. ></TABLE
  18605. ><P
  18606. ></P
  18607. ></DIV
  18608. >
  18609.       This is wrong, but it works. Then, why is it wrong? The reason
  18610.       is that this code has an undefined constant (bar) rather than a
  18611.       string ('bar' - notice the quotes), and PHP may in future define
  18612.       constants which, unfortunately for your code, have the same
  18613.       name.  It works because PHP automatically converts a
  18614.       <SPAN
  18615. CLASS="emphasis"
  18616. ><I
  18617. CLASS="emphasis"
  18618. >bare string</I
  18619. ></SPAN
  18620. > (an unquoted string which does
  18621.       not correspond to any known symbol) into a string which contains
  18622.       the bare string. For instance, if there is no defined constant
  18623.       named <TT
  18624. CLASS="constant"
  18625. ><B
  18626. >bar</B
  18627. ></TT
  18628. >, then PHP will substitute in the
  18629.       string <TT
  18630. CLASS="literal"
  18631. >'bar'</TT
  18632. > and use that.
  18633.      </P
  18634. ><DIV
  18635. CLASS="note"
  18636. ><BLOCKQUOTE
  18637. CLASS="note"
  18638. ><P
  18639. ><B
  18640. >Poznßmka: </B
  18641. >
  18642.        This does not mean to <SPAN
  18643. CLASS="emphasis"
  18644. ><I
  18645. CLASS="emphasis"
  18646. >always</I
  18647. ></SPAN
  18648. > quote the
  18649.        key. You do not want to quote keys which are <A
  18650. HREF="#language.constants"
  18651. >constants</A
  18652. > or <A
  18653. HREF="#language.variables"
  18654. >variables</A
  18655. >, as this will
  18656.        prevent PHP from interpreting them.
  18657.       </P
  18658. ><DIV
  18659. CLASS="informalexample"
  18660. ><A
  18661. NAME="AEN3779"
  18662. ></A
  18663. ><P
  18664. ></P
  18665. ><TABLE
  18666. BORDER="0"
  18667. BGCOLOR="#E0E0E0"
  18668. CELLPADDING="5"
  18669. ><TR
  18670. ><TD
  18671. ><PRE
  18672. CLASS="php"
  18673. ><?php
  18674. error_reporting(E_ALL);
  18675. ini_set('display_errors', true);
  18676. ini_set('html_errors', false);
  18677. // Simple array:
  18678. $array = array(1, 2);
  18679. $count = count($array);
  18680. for ($i = 0; $i < $count; $i++) {
  18681.     echo "\nChecking $i: \n";
  18682.     echo "Bad: " . $array['$i'] . "\n";
  18683.     echo "Good: " . $array[$i] . "\n";
  18684.     echo "Bad: {$array['$i']}\n";
  18685.     echo "Good: {$array[$i]}\n";
  18686. }
  18687. ?></PRE
  18688. ></TD
  18689. ></TR
  18690. ></TABLE
  18691. ><P
  18692. ></P
  18693. ></DIV
  18694. ><P
  18695. ><B
  18696. >Poznßmka: </B
  18697. >
  18698.        The output from the above is:
  18699.        <TABLE
  18700. BORDER="0"
  18701. BGCOLOR="#E0E0E0"
  18702. CELLPADDING="5"
  18703. ><TR
  18704. ><TD
  18705. ><PRE
  18706. CLASS="screen"
  18707. >Checking 0: 
  18708. Notice: Undefined index:  $i in /path/to/script.html on line 9
  18709. Bad: 
  18710. Good: 1
  18711. Notice: Undefined index:  $i in /path/to/script.html on line 11
  18712. Bad: 
  18713. Good: 1
  18714.  
  18715. Checking 1: 
  18716. Notice: Undefined index:  $i in /path/to/script.html on line 9
  18717. Bad: 
  18718. Good: 2
  18719. Notice: Undefined index:  $i in /path/to/script.html on line 11
  18720. Bad: 
  18721. Good: 2</PRE
  18722. ></TD
  18723. ></TR
  18724. ></TABLE
  18725. >
  18726.       </P
  18727. ></BLOCKQUOTE
  18728. ></DIV
  18729. ><P
  18730. >       More examples to demonstrate this fact:
  18731.       <DIV
  18732. CLASS="informalexample"
  18733. ><A
  18734. NAME="AEN3784"
  18735. ></A
  18736. ><P
  18737. ></P
  18738. ><TABLE
  18739. BORDER="0"
  18740. BGCOLOR="#E0E0E0"
  18741. CELLPADDING="5"
  18742. ><TR
  18743. ><TD
  18744. ><PRE
  18745. CLASS="php"
  18746. ><?php
  18747. // Let's show all errors
  18748. error_reporting(E_ALL);
  18749.  
  18750. $arr = array('fruit' => 'apple', 'veggie' => 'carrot');
  18751.  
  18752. // Correct
  18753. print $arr['fruit'];  // apple
  18754. print $arr['veggie']; // carrot
  18755.  
  18756. // Incorrect.  This works but also throws a PHP error of
  18757. // level E_NOTICE because of an undefined constant named fruit
  18758. // 
  18759. // Notice: Use of undefined constant fruit - assumed 'fruit' in...
  18760. print $arr[fruit];    // apple
  18761.  
  18762. // Let's define a constant to demonstrate what's going on.  We
  18763. // will assign value 'veggie' to a constant named fruit.
  18764. define('fruit', 'veggie');
  18765.  
  18766. // Notice the difference now
  18767. print $arr['fruit'];  // apple
  18768. print $arr[fruit];    // carrot
  18769.  
  18770. // The following is okay as it's inside a string.  Constants are not
  18771. // looked for within strings so no E_NOTICE error here
  18772. print "Hello $arr[fruit]";      // Hello apple
  18773.  
  18774. // With one exception, braces surrounding arrays within strings
  18775. // allows constants to be looked for
  18776. print "Hello {$arr[fruit]}";    // Hello carrot
  18777. print "Hello {$arr['fruit']}";  // Hello apple
  18778.  
  18779. // This will not work, results in a parse error such as:
  18780. // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING'
  18781. // This of course applies to using autoglobals in strings as well
  18782. print "Hello $arr['fruit']";
  18783. print "Hello $_GET['foo']";
  18784.  
  18785. // Concatenation is another option
  18786. print "Hello " . $arr['fruit']; // Hello apple
  18787. ?></PRE
  18788. ></TD
  18789. ></TR
  18790. ></TABLE
  18791. ><P
  18792. ></P
  18793. ></DIV
  18794. >
  18795.      </P
  18796. ><P
  18797. >       When you turn <A
  18798. HREF="#function.error-reporting"
  18799. ><B
  18800. CLASS="function"
  18801. >error_reporting()</B
  18802. ></A
  18803. > up to show
  18804.       <TT
  18805. CLASS="constant"
  18806. ><B
  18807. >E_NOTICE</B
  18808. ></TT
  18809. > level errors (such as setting
  18810.       it to <TT
  18811. CLASS="constant"
  18812. ><B
  18813. >E_ALL</B
  18814. ></TT
  18815. >) then you will see these
  18816.       errors.  By default, <A
  18817. HREF="#ini.error-reporting"
  18818. >       error_reporting</A
  18819. > is turned down to not show them.
  18820.      </P
  18821. ><P
  18822. >       As stated in the <A
  18823. HREF="#language.types.array.syntax"
  18824. >syntax</A
  18825. > section,
  18826.       there must be an expression between the square brackets
  18827.       ('<TT
  18828. CLASS="literal"
  18829. >[</TT
  18830. >' and '<TT
  18831. CLASS="literal"
  18832. >]</TT
  18833. >').  That means
  18834.       that you can write things like this:
  18835.       <DIV
  18836. CLASS="informalexample"
  18837. ><A
  18838. NAME="AEN3795"
  18839. ></A
  18840. ><P
  18841. ></P
  18842. ><TABLE
  18843. BORDER="0"
  18844. BGCOLOR="#E0E0E0"
  18845. CELLPADDING="5"
  18846. ><TR
  18847. ><TD
  18848. ><PRE
  18849. CLASS="php"
  18850. ><?php
  18851. echo $arr[somefunc($bar)];
  18852. ?></PRE
  18853. ></TD
  18854. ></TR
  18855. ></TABLE
  18856. ><P
  18857. ></P
  18858. ></DIV
  18859. >
  18860.       This is an example of using a function return value
  18861.       as the array index. PHP also knows about constants,
  18862.       as you may have seen the <TT
  18863. CLASS="literal"
  18864. >E_*</TT
  18865. > ones
  18866.       before.      
  18867.  
  18868.       <DIV
  18869. CLASS="informalexample"
  18870. ><A
  18871. NAME="AEN3798"
  18872. ></A
  18873. ><P
  18874. ></P
  18875. ><TABLE
  18876. BORDER="0"
  18877. BGCOLOR="#E0E0E0"
  18878. CELLPADDING="5"
  18879. ><TR
  18880. ><TD
  18881. ><PRE
  18882. CLASS="php"
  18883. ><?php
  18884. $error_descriptions[E_ERROR]   = "A fatal error has occured";
  18885. $error_descriptions[E_WARNING] = "PHP issued a warning";
  18886. $error_descriptions[E_NOTICE]  = "This is just an informal notice";
  18887. ?></PRE
  18888. ></TD
  18889. ></TR
  18890. ></TABLE
  18891. ><P
  18892. ></P
  18893. ></DIV
  18894. >
  18895.       Note that <TT
  18896. CLASS="literal"
  18897. >E_ERROR</TT
  18898. > is also a valid identifier, 
  18899.       just like <TT
  18900. CLASS="literal"
  18901. >bar</TT
  18902. > in the first example. But the last
  18903.       example is in fact the same as writing:
  18904.       <DIV
  18905. CLASS="informalexample"
  18906. ><A
  18907. NAME="AEN3802"
  18908. ></A
  18909. ><P
  18910. ></P
  18911. ><TABLE
  18912. BORDER="0"
  18913. BGCOLOR="#E0E0E0"
  18914. CELLPADDING="5"
  18915. ><TR
  18916. ><TD
  18917. ><PRE
  18918. CLASS="php"
  18919. ><?php
  18920. $error_descriptions[1] = "A fatal error has occured";
  18921. $error_descriptions[2] = "PHP issued a warning";
  18922. $error_descriptions[8] = "This is just an informal notice";
  18923. ?></PRE
  18924. ></TD
  18925. ></TR
  18926. ></TABLE
  18927. ><P
  18928. ></P
  18929. ></DIV
  18930. >
  18931.       because <TT
  18932. CLASS="literal"
  18933. >E_ERROR</TT
  18934. > equals <TT
  18935. CLASS="literal"
  18936. >1</TT
  18937. >, etc.
  18938.      </P
  18939. ><P
  18940. >       As we already explained in the above examples, 
  18941.       <TT
  18942. CLASS="literal"
  18943. >$foo[bar]</TT
  18944. > still works but is wrong.
  18945.       It works, because <TT
  18946. CLASS="literal"
  18947. >bar</TT
  18948. > is due to its syntax
  18949.       expected to be a constant expression. However, in this case no 
  18950.       constant with the name <TT
  18951. CLASS="literal"
  18952. >bar</TT
  18953. > exists. PHP now
  18954.       assumes that you meant <TT
  18955. CLASS="literal"
  18956. >bar</TT
  18957. > literally, 
  18958.       as the string <TT
  18959. CLASS="literal"
  18960. >"bar"</TT
  18961. >, but that you forgot
  18962.       to write the quotes.
  18963.      </P
  18964. ><DIV
  18965. CLASS="sect4"
  18966. ><HR><H5
  18967. CLASS="sect4"
  18968. ><A
  18969. NAME="AEN3812"
  18970. ></A
  18971. >So why is it bad then?</H5
  18972. ><P
  18973. >        At some point in the future, the PHP team might want to add another
  18974.        constant or keyword, or you may introduce another constant into your
  18975.        application, and then you get in trouble. For example,
  18976.        you already cannot use the words <TT
  18977. CLASS="literal"
  18978. >empty</TT
  18979. > and 
  18980.        <TT
  18981. CLASS="literal"
  18982. >default</TT
  18983. > this way, since they are special 
  18984.        <A
  18985. HREF="#reserved"
  18986. >reserved keywords</A
  18987. >.
  18988.       </P
  18989. ><DIV
  18990. CLASS="note"
  18991. ><BLOCKQUOTE
  18992. CLASS="note"
  18993. ><P
  18994. ><B
  18995. >Poznßmka: </B
  18996. >
  18997.         To reiterate, inside a double-quoted <A
  18998. HREF="#language.types.string"
  18999. ><B
  19000. CLASS="type"
  19001. >string</B
  19002. ></A
  19003. >, it's
  19004.         valid to not surround array indexes with quotes so
  19005.         <TT
  19006. CLASS="literal"
  19007. >"$foo[bar]"</TT
  19008. > is valid.  See the above 
  19009.         examples for details on why as well as the section on
  19010.         <A
  19011. HREF="#language.types.string.parsing"
  19012. >variable parsing 
  19013.         in strings</A
  19014. >.
  19015.        </P
  19016. ></BLOCKQUOTE
  19017. ></DIV
  19018. ></DIV
  19019. ></DIV
  19020. ></DIV
  19021. ><DIV
  19022. CLASS="sect2"
  19023. ><HR><H3
  19024. CLASS="sect2"
  19025. ><A
  19026. NAME="language.types.array.casting"
  19027. ></A
  19028. >Converting to array</H3
  19029. ><P
  19030. >      For any of the types: <A
  19031. HREF="#language.types.integer"
  19032. ><B
  19033. CLASS="type"
  19034. >integer</B
  19035. ></A
  19036. >, <A
  19037. HREF="#language.types.float"
  19038. ><B
  19039. CLASS="type"
  19040. >float</B
  19041. ></A
  19042. >,
  19043.      <A
  19044. HREF="#language.types.string"
  19045. ><B
  19046. CLASS="type"
  19047. >string</B
  19048. ></A
  19049. >, <A
  19050. HREF="#language.types.boolean"
  19051. ><B
  19052. CLASS="type"
  19053. >boolean</B
  19054. ></A
  19055. > and <A
  19056. HREF="#language.types.resource"
  19057. ><B
  19058. CLASS="type"
  19059. >resource</B
  19060. ></A
  19061. >,
  19062.      if you convert a value to an <A
  19063. HREF="#language.types.array"
  19064. ><B
  19065. CLASS="type"
  19066. >array</B
  19067. ></A
  19068. >, you get an array 
  19069.      with one element (with index 0), which is the scalar value you 
  19070.      started with.
  19071.     </P
  19072. ><P
  19073. >      If you convert an <A
  19074. HREF="#language.types.object"
  19075. ><B
  19076. CLASS="type"
  19077. >object</B
  19078. ></A
  19079. > to an array, you get the
  19080.      properties (member variables) of that object as the array's elements. 
  19081.      The keys are the member variable names.
  19082.     </P
  19083. ><P
  19084. >      If you convert a <TT
  19085. CLASS="constant"
  19086. ><B
  19087. >NULL</B
  19088. ></TT
  19089. > value to an array, you get an empty array.
  19090.     </P
  19091. ></DIV
  19092. ><DIV
  19093. CLASS="sect2"
  19094. ><HR><H3
  19095. CLASS="sect2"
  19096. ><A
  19097. NAME="language.types.array.examples"
  19098. ></A
  19099. >Examples</H3
  19100. ><P
  19101. >      The array type in PHP is very versatile, so here will be some 
  19102.      examples to show you the full power of arrays.
  19103.     </P
  19104. ><P
  19105. >       <DIV
  19106. CLASS="informalexample"
  19107. ><A
  19108. NAME="AEN3840"
  19109. ></A
  19110. ><P
  19111. ></P
  19112. ><TABLE
  19113. BORDER="0"
  19114. BGCOLOR="#E0E0E0"
  19115. CELLPADDING="5"
  19116. ><TR
  19117. ><TD
  19118. ><PRE
  19119. CLASS="php"
  19120. ><?php
  19121. // this
  19122. $a = array( 'color' => 'red',
  19123.             'taste' => 'sweet',
  19124.             'shape' => 'round',
  19125.             'name'  => 'apple',
  19126.                        4        // key will be 0
  19127.           );
  19128.  
  19129. // is completely equivalent with
  19130. $a['color'] = 'red';
  19131. $a['taste'] = 'sweet';
  19132. $a['shape'] = 'round';
  19133. $a['name']  = 'apple';
  19134. $a[]        = 4;        // key will be 0
  19135.  
  19136. $b[] = 'a';
  19137. $b[] = 'b';
  19138. $b[] = 'c';
  19139. // will result in the array array(0 => 'a' , 1 => 'b' , 2 => 'c'),
  19140. // or simply array('a', 'b', 'c')
  19141. ?></PRE
  19142. ></TD
  19143. ></TR
  19144. ></TABLE
  19145. ><P
  19146. ></P
  19147. ></DIV
  19148. >
  19149.      </P
  19150. ><TABLE
  19151. WIDTH="100%"
  19152. BORDER="0"
  19153. CELLPADDING="0"
  19154. CELLSPACING="0"
  19155. CLASS="EXAMPLE"
  19156. ><TR
  19157. ><TD
  19158. ><DIV
  19159. CLASS="example"
  19160. ><A
  19161. NAME="AEN3842"
  19162. ></A
  19163. ><P
  19164. ><B
  19165. >P°φklad 6-4. Using array()</B
  19166. ></P
  19167. ><TABLE
  19168. BORDER="0"
  19169. BGCOLOR="#E0E0E0"
  19170. CELLPADDING="5"
  19171. ><TR
  19172. ><TD
  19173. ><PRE
  19174. CLASS="php"
  19175. ><?php
  19176. // Array as (property-)map
  19177. $map = array( 'version'    => 4,
  19178.               'OS'         => 'Linux',
  19179.               'lang'       => 'english',
  19180.               'short_tags' => true
  19181.             );
  19182.             
  19183. // strictly numerical keys
  19184. $array = array( 7,
  19185.                 8,
  19186.                 0,
  19187.                 156,
  19188.                 -10
  19189.               );
  19190. // this is the same as array(0 => 7, 1 => 8, ...)
  19191.  
  19192. $switching = array(         10, // key = 0
  19193.                     5    =>  6,
  19194.                     3    =>  7, 
  19195.                     'a'  =>  4,
  19196.                             11, // key = 6 (maximum of integer-indices was 5)
  19197.                     '8'  =>  2, // key = 8 (integer!)
  19198.                     '02' => 77, // key = '02'
  19199.                     0    => 12  // the value 10 will be overwritten by 12
  19200.                   );
  19201.                   
  19202. // empty array
  19203. $empty = array();         
  19204. ?></PRE
  19205. ></TD
  19206. ></TR
  19207. ></TABLE
  19208. ></DIV
  19209. ></TD
  19210. ></TR
  19211. ></TABLE
  19212. ><TABLE
  19213. WIDTH="100%"
  19214. BORDER="0"
  19215. CELLPADDING="0"
  19216. CELLSPACING="0"
  19217. CLASS="EXAMPLE"
  19218. ><TR
  19219. ><TD
  19220. ><DIV
  19221. CLASS="example"
  19222. ><A
  19223. NAME="language.types.array.examples.loop"
  19224. ></A
  19225. ><P
  19226. ><B
  19227. >P°φklad 6-5. Collection</B
  19228. ></P
  19229. ><TABLE
  19230. BORDER="0"
  19231. BGCOLOR="#E0E0E0"
  19232. CELLPADDING="5"
  19233. ><TR
  19234. ><TD
  19235. ><PRE
  19236. CLASS="php"
  19237. ><?php
  19238. $colors = array('red', 'blue', 'green', 'yellow');
  19239.  
  19240. foreach ($colors as $color) {
  19241.     echo "Do you like $color?\n";
  19242. }
  19243.  
  19244. /* output:
  19245. Do you like red?
  19246. Do you like blue?
  19247. Do you like green?
  19248. Do you like yellow?
  19249. */
  19250. ?></PRE
  19251. ></TD
  19252. ></TR
  19253. ></TABLE
  19254. ></DIV
  19255. ></TD
  19256. ></TR
  19257. ></TABLE
  19258. ><P
  19259. >      Note that it is currently not possible to change the values of the array
  19260.      directly in such a loop. 
  19261.       
  19262.      A workaround is the following: 
  19263.      <TABLE
  19264. WIDTH="100%"
  19265. BORDER="0"
  19266. CELLPADDING="0"
  19267. CELLSPACING="0"
  19268. CLASS="EXAMPLE"
  19269. ><TR
  19270. ><TD
  19271. ><DIV
  19272. CLASS="example"
  19273. ><A
  19274. NAME="language.types.array.examples.changeloop"
  19275. ></A
  19276. ><P
  19277. ><B
  19278. >P°φklad 6-6. Collection</B
  19279. ></P
  19280. ><TABLE
  19281. BORDER="0"
  19282. BGCOLOR="#E0E0E0"
  19283. CELLPADDING="5"
  19284. ><TR
  19285. ><TD
  19286. ><PRE
  19287. CLASS="php"
  19288. ><?php
  19289. foreach ($colors as $key => $color) {
  19290.     // won't work:
  19291.     //$color = strtoupper($color);
  19292.     
  19293.     // works:
  19294.     $colors[$key] = strtoupper($color);
  19295. }
  19296. print_r($colors);
  19297.  
  19298. /* output:
  19299. Array
  19300. (
  19301.     [0] => RED
  19302.     [1] => BLUE
  19303.     [2] => GREEN
  19304.     [3] => YELLOW
  19305. )
  19306. */
  19307. ?></PRE
  19308. ></TD
  19309. ></TR
  19310. ></TABLE
  19311. ></DIV
  19312. ></TD
  19313. ></TR
  19314. ></TABLE
  19315. >
  19316.     </P
  19317. ><P
  19318. >      This example creates a one-based array.
  19319.      <TABLE
  19320. WIDTH="100%"
  19321. BORDER="0"
  19322. CELLPADDING="0"
  19323. CELLSPACING="0"
  19324. CLASS="EXAMPLE"
  19325. ><TR
  19326. ><TD
  19327. ><DIV
  19328. CLASS="example"
  19329. ><A
  19330. NAME="AEN3853"
  19331. ></A
  19332. ><P
  19333. ><B
  19334. >P°φklad 6-7. One-based index</B
  19335. ></P
  19336. ><TABLE
  19337. BORDER="0"
  19338. BGCOLOR="#E0E0E0"
  19339. CELLPADDING="5"
  19340. ><TR
  19341. ><TD
  19342. ><PRE
  19343. CLASS="php"
  19344. ><?php
  19345. $firstquarter  = array(1 => 'January', 'February', 'March');
  19346. print_r($firstquarter);
  19347.  
  19348. /* output:
  19349. Array 
  19350. (
  19351.     [1] => 'January'
  19352.     [2] => 'February'
  19353.     [3] => 'March'
  19354. )
  19355. */
  19356. ?></PRE
  19357. ></TD
  19358. ></TR
  19359. ></TABLE
  19360. ></DIV
  19361. ></TD
  19362. ></TR
  19363. ></TABLE
  19364. >
  19365.     </P
  19366. ><TABLE
  19367. WIDTH="100%"
  19368. BORDER="0"
  19369. CELLPADDING="0"
  19370. CELLSPACING="0"
  19371. CLASS="EXAMPLE"
  19372. ><TR
  19373. ><TD
  19374. ><DIV
  19375. CLASS="example"
  19376. ><A
  19377. NAME="AEN3856"
  19378. ></A
  19379. ><P
  19380. ><B
  19381. >P°φklad 6-8. Filling an array</B
  19382. ></P
  19383. ><TABLE
  19384. BORDER="0"
  19385. BGCOLOR="#E0E0E0"
  19386. CELLPADDING="5"
  19387. ><TR
  19388. ><TD
  19389. ><PRE
  19390. CLASS="php"
  19391. ><?php
  19392. // fill an array with all items from a directory
  19393. $handle = opendir('.');
  19394. while (false !== ($file = readdir($handle))) {
  19395.     $files[] = $file;
  19396. }
  19397. closedir($handle); 
  19398. ?></PRE
  19399. ></TD
  19400. ></TR
  19401. ></TABLE
  19402. ></DIV
  19403. ></TD
  19404. ></TR
  19405. ></TABLE
  19406. ><P
  19407. >      Arrays are ordered. You can also change the order using various
  19408.      sorting functions. See the <A
  19409. HREF="#ref.array"
  19410. >array
  19411.      functions</A
  19412. > section for more information. You can count
  19413.      the number of items in an array using the
  19414.      <A
  19415. HREF="#function.count"
  19416. ><B
  19417. CLASS="function"
  19418. >count()</B
  19419. ></A
  19420. > function.
  19421.     </P
  19422. ><TABLE
  19423. WIDTH="100%"
  19424. BORDER="0"
  19425. CELLPADDING="0"
  19426. CELLSPACING="0"
  19427. CLASS="EXAMPLE"
  19428. ><TR
  19429. ><TD
  19430. ><DIV
  19431. CLASS="example"
  19432. ><A
  19433. NAME="AEN3862"
  19434. ></A
  19435. ><P
  19436. ><B
  19437. >P°φklad 6-9. Sorting an array</B
  19438. ></P
  19439. ><TABLE
  19440. BORDER="0"
  19441. BGCOLOR="#E0E0E0"
  19442. CELLPADDING="5"
  19443. ><TR
  19444. ><TD
  19445. ><PRE
  19446. CLASS="php"
  19447. ><?php
  19448. sort($files);
  19449. print_r($files);
  19450. ?></PRE
  19451. ></TD
  19452. ></TR
  19453. ></TABLE
  19454. ></DIV
  19455. ></TD
  19456. ></TR
  19457. ></TABLE
  19458. ><P
  19459. >      Because the value of an array can be anything, it can also be
  19460.      another array. This way you can make recursive and
  19461.      multi-dimensional arrays.
  19462.     </P
  19463. ><TABLE
  19464. WIDTH="100%"
  19465. BORDER="0"
  19466. CELLPADDING="0"
  19467. CELLSPACING="0"
  19468. CLASS="EXAMPLE"
  19469. ><TR
  19470. ><TD
  19471. ><DIV
  19472. CLASS="example"
  19473. ><A
  19474. NAME="AEN3866"
  19475. ></A
  19476. ><P
  19477. ><B
  19478. >P°φklad 6-10. Recursive and multi-dimensional arrays</B
  19479. ></P
  19480. ><TABLE
  19481. BORDER="0"
  19482. BGCOLOR="#E0E0E0"
  19483. CELLPADDING="5"
  19484. ><TR
  19485. ><TD
  19486. ><PRE
  19487. CLASS="php"
  19488. ><?php
  19489. $fruits = array ( "fruits"  => array ( "a" => "orange",
  19490.                                        "b" => "banana",
  19491.                                        "c" => "apple"
  19492.                                      ),
  19493.                   "numbers" => array ( 1,
  19494.                                        2,
  19495.                                        3,
  19496.                                        4,
  19497.                                        5,
  19498.                                        6
  19499.                                      ),
  19500.                   "holes"   => array (      "first",
  19501.                                        5 => "second",
  19502.                                             "third"
  19503.                                      )
  19504.                 );
  19505.  
  19506. // Some examples to address values in the array above 
  19507. echo $fruits["holes"][5];    // prints "second"
  19508. echo $fruits["fruits"]["a"]; // prints "orange"
  19509. unset($fruits["holes"][0]);  // remove "first"
  19510.  
  19511. // Create a new multi-dimensional array
  19512. $juices["apple"]["green"] = "good"; 
  19513. ?></PRE
  19514. ></TD
  19515. ></TR
  19516. ></TABLE
  19517. ></DIV
  19518. ></TD
  19519. ></TR
  19520. ></TABLE
  19521. ><P
  19522. >      You should be aware that array assignment always involves
  19523.      value copying. You need to use the reference operator to copy
  19524.      an array by reference.
  19525.      <DIV
  19526. CLASS="informalexample"
  19527. ><A
  19528. NAME="AEN3870"
  19529. ></A
  19530. ><P
  19531. ></P
  19532. ><TABLE
  19533. BORDER="0"
  19534. BGCOLOR="#E0E0E0"
  19535. CELLPADDING="5"
  19536. ><TR
  19537. ><TD
  19538. ><PRE
  19539. CLASS="php"
  19540. ><?php
  19541. $arr1 = array(2, 3);
  19542. $arr2 = $arr1;
  19543. $arr2[] = 4; // $arr2 is changed,
  19544.              // $arr1 is still array(2, 3)
  19545.              
  19546. $arr3 = &$arr1;
  19547. $arr3[] = 4; // now $arr1 and $arr3 are the same
  19548. ?></PRE
  19549. ></TD
  19550. ></TR
  19551. ></TABLE
  19552. ><P
  19553. ></P
  19554. ></DIV
  19555. >
  19556.     </P
  19557. ></DIV
  19558. ></DIV
  19559. ><DIV
  19560. CLASS="sect1"
  19561. ><HR><H2
  19562. CLASS="sect1"
  19563. ><A
  19564. NAME="language.types.object"
  19565. ></A
  19566. >Objects</H2
  19567. ><DIV
  19568. CLASS="sect2"
  19569. ><H3
  19570. CLASS="sect2"
  19571. ><A
  19572. NAME="language.types.object.init"
  19573. ></A
  19574. >Object Initialization</H3
  19575. ><P
  19576. >      To initialize an object, you use the <TT
  19577. CLASS="literal"
  19578. >new</TT
  19579. >
  19580.      statement to instantiate the object to a variable.
  19581.  
  19582.      <DIV
  19583. CLASS="informalexample"
  19584. ><A
  19585. NAME="AEN3878"
  19586. ></A
  19587. ><P
  19588. ></P
  19589. ><TABLE
  19590. BORDER="0"
  19591. BGCOLOR="#E0E0E0"
  19592. CELLPADDING="5"
  19593. ><TR
  19594. ><TD
  19595. ><PRE
  19596. CLASS="php"
  19597. ><?php
  19598. class foo
  19599. {
  19600.     function do_foo()
  19601.     {
  19602.         echo "Doing foo."; 
  19603.     }
  19604. }
  19605.  
  19606. $bar = new foo;
  19607. $bar->do_foo();
  19608. ?></PRE
  19609. ></TD
  19610. ></TR
  19611. ></TABLE
  19612. ><P
  19613. ></P
  19614. ></DIV
  19615. >
  19616.     </P
  19617. ><P
  19618. >      For a full discussion, please read the section <A
  19619. HREF="#language.oop"
  19620. >Classes and Objects</A
  19621. >.
  19622.     </P
  19623. ></DIV
  19624. ><DIV
  19625. CLASS="sect2"
  19626. ><HR><H3
  19627. CLASS="sect2"
  19628. ><A
  19629. NAME="language.types.object.casting"
  19630. ></A
  19631. >Converting to object</H3
  19632. ><P
  19633. >      If an object is converted to an object, it is not modified. If a value
  19634.      of any other type is converted to an object, a new instance of the
  19635.      <TT
  19636. CLASS="literal"
  19637. >stdClass</TT
  19638. > built in class is created. If the value
  19639.      was null, the new instance will be empty. For any other value, a
  19640.      member variable named <TT
  19641. CLASS="literal"
  19642. >scalar</TT
  19643. > will contain the
  19644.      value.
  19645.      <DIV
  19646. CLASS="informalexample"
  19647. ><A
  19648. NAME="AEN3887"
  19649. ></A
  19650. ><P
  19651. ></P
  19652. ><TABLE
  19653. BORDER="0"
  19654. BGCOLOR="#E0E0E0"
  19655. CELLPADDING="5"
  19656. ><TR
  19657. ><TD
  19658. ><PRE
  19659. CLASS="php"
  19660. ><?php
  19661. $obj = (object) 'ciao';
  19662. echo $obj->scalar;  // outputs 'ciao'
  19663. ?></PRE
  19664. ></TD
  19665. ></TR
  19666. ></TABLE
  19667. ><P
  19668. ></P
  19669. ></DIV
  19670. >
  19671.     </P
  19672. ></DIV
  19673. ></DIV
  19674. ><DIV
  19675. CLASS="sect1"
  19676. ><HR><H2
  19677. CLASS="sect1"
  19678. ><A
  19679. NAME="language.types.resource"
  19680. ></A
  19681. >Resource</H2
  19682. ><P
  19683. >      A resource is a special variable, holding
  19684.      a reference to an external resource. Resources
  19685.      are created and used by special functions.
  19686.      See the <A
  19687. HREF="#resource"
  19688. >appendix</A
  19689. > 
  19690.      for a listing of all these
  19691.      functions and the corresponding resource types.
  19692.     </P
  19693. ><DIV
  19694. CLASS="note"
  19695. ><BLOCKQUOTE
  19696. CLASS="note"
  19697. ><P
  19698. ><B
  19699. >Poznßmka: </B
  19700. >
  19701.       The resource type was introduced in PHP 4
  19702.      </P
  19703. ></BLOCKQUOTE
  19704. ></DIV
  19705. ><DIV
  19706. CLASS="sect2"
  19707. ><HR><H3
  19708. CLASS="sect2"
  19709. ><A
  19710. NAME="language.types.resource.casting"
  19711. ></A
  19712. >Converting to resource</H3
  19713. ><P
  19714. >      As resource types hold special handlers to opened
  19715.      files, database connections, image canvas areas and
  19716.      the like, you cannot convert any value to a resource.
  19717.     </P
  19718. ></DIV
  19719. ><DIV
  19720. CLASS="sect2"
  19721. ><HR><H3
  19722. CLASS="sect2"
  19723. ><A
  19724. NAME="language.types.resource.self-destruct"
  19725. ></A
  19726. >Freeing resources</H3
  19727. ><P
  19728. >      Due to the reference-counting system introduced
  19729.      with PHP 4's Zend-engine, it is automatically detected
  19730.      when a resource is no longer referred to (just
  19731.      like Java). When this is
  19732.      the case, all resources that were in use for this 
  19733.      resource are made free by the garbage collector.
  19734.      For this reason, it is rarely ever necessary to
  19735.      free the memory manually by using some free_result
  19736.      function.
  19737.      <DIV
  19738. CLASS="note"
  19739. ><BLOCKQUOTE
  19740. CLASS="note"
  19741. ><P
  19742. ><B
  19743. >Poznßmka: </B
  19744. >
  19745.        Persistent database links are special, they 
  19746.        are <SPAN
  19747. CLASS="emphasis"
  19748. ><I
  19749. CLASS="emphasis"
  19750. >not</I
  19751. ></SPAN
  19752. > destroyed by the 
  19753.        garbage collector. See also the section about <A
  19754. HREF="#features.persistent-connections"
  19755. >persistent 
  19756.        connections</A
  19757. >.
  19758.       </P
  19759. ></BLOCKQUOTE
  19760. ></DIV
  19761. >
  19762.     </P
  19763. ></DIV
  19764. ></DIV
  19765. ><DIV
  19766. CLASS="sect1"
  19767. ><HR><H2
  19768. CLASS="sect1"
  19769. ><A
  19770. NAME="language.types.null"
  19771. ></A
  19772. >NULL</H2
  19773. ><P
  19774. >     The special <TT
  19775. CLASS="constant"
  19776. ><B
  19777. >NULL</B
  19778. ></TT
  19779. > value represents 
  19780.     that a variable has no value. <TT
  19781. CLASS="constant"
  19782. ><B
  19783. >NULL</B
  19784. ></TT
  19785. > is the only possible value of type
  19786.     <A
  19787. HREF="#language.types.null"
  19788. ><B
  19789. CLASS="type"
  19790. >NULL</B
  19791. ></A
  19792. >.
  19793.    </P
  19794. ><DIV
  19795. CLASS="note"
  19796. ><BLOCKQUOTE
  19797. CLASS="note"
  19798. ><P
  19799. ><B
  19800. >Poznßmka: </B
  19801. >
  19802.       The null type was introduced in PHP 4
  19803.      </P
  19804. ></BLOCKQUOTE
  19805. ></DIV
  19806. ><P
  19807. >      A variable is considered to be <TT
  19808. CLASS="constant"
  19809. ><B
  19810. >NULL</B
  19811. ></TT
  19812. > if
  19813.      <P
  19814. ></P
  19815. ><UL
  19816. ><LI
  19817. ><P
  19818. >         it has been assigned the constant <TT
  19819. CLASS="constant"
  19820. ><B
  19821. >NULL</B
  19822. ></TT
  19823. >.
  19824.        </P
  19825. ></LI
  19826. ><LI
  19827. ><P
  19828. >         it has not been set to any value yet.
  19829.        </P
  19830. ></LI
  19831. ><LI
  19832. ><P
  19833. >         it has been <A
  19834. HREF="#function.unset"
  19835. ><B
  19836. CLASS="function"
  19837. >unset()</B
  19838. ></A
  19839. >.
  19840.        </P
  19841. ></LI
  19842. ></UL
  19843. >
  19844.     </P
  19845. ><DIV
  19846. CLASS="sect2"
  19847. ><HR><H3
  19848. CLASS="sect2"
  19849. ><A
  19850. NAME="language.types.null.syntax"
  19851. ></A
  19852. >Syntax</H3
  19853. ><P
  19854. >      There is only one value of type <TT
  19855. CLASS="constant"
  19856. ><B
  19857. >NULL</B
  19858. ></TT
  19859. >, and that is 
  19860.      the case-insensitive keyword <TT
  19861. CLASS="constant"
  19862. ><B
  19863. >NULL</B
  19864. ></TT
  19865. >.
  19866.      <DIV
  19867. CLASS="informalexample"
  19868. ><A
  19869. NAME="AEN3929"
  19870. ></A
  19871. ><P
  19872. ></P
  19873. ><TABLE
  19874. BORDER="0"
  19875. BGCOLOR="#E0E0E0"
  19876. CELLPADDING="5"
  19877. ><TR
  19878. ><TD
  19879. ><PRE
  19880. CLASS="php"
  19881. ><?php
  19882. $var = NULL;       
  19883. ?></PRE
  19884. ></TD
  19885. ></TR
  19886. ></TABLE
  19887. ><P
  19888. ></P
  19889. ></DIV
  19890. >
  19891.     </P
  19892. ><P
  19893. >      See also <A
  19894. HREF="#function.is-null"
  19895. ><B
  19896. CLASS="function"
  19897. >is_null()</B
  19898. ></A
  19899. > and <A
  19900. HREF="#function.unset"
  19901. ><B
  19902. CLASS="function"
  19903. >unset()</B
  19904. ></A
  19905. >.
  19906.     </P
  19907. ></DIV
  19908. ></DIV
  19909. ><DIV
  19910. CLASS="sect1"
  19911. ><HR><H2
  19912. CLASS="sect1"
  19913. ><A
  19914. NAME="language.pseudo-types"
  19915. ></A
  19916. >Pseudo-types used in this documentation</H2
  19917. ><DIV
  19918. CLASS="sect2"
  19919. ><H3
  19920. CLASS="sect2"
  19921. ><A
  19922. NAME="language.types.mixed"
  19923. ></A
  19924. >mixed</H3
  19925. ><P
  19926. >      <TT
  19927. CLASS="literal"
  19928. >mixed</TT
  19929. > indicates that a parameter may accept multiple (but not
  19930.      necessarily all) types.
  19931.     </P
  19932. ><P
  19933. >      <A
  19934. HREF="#function.gettype"
  19935. ><B
  19936. CLASS="function"
  19937. >gettype()</B
  19938. ></A
  19939. > for example will accept all PHP types,
  19940.      while <A
  19941. HREF="#function.str-replace"
  19942. ><B
  19943. CLASS="function"
  19944. >str_replace()</B
  19945. ></A
  19946. > will accept strings and arrays.
  19947.     </P
  19948. ></DIV
  19949. ><DIV
  19950. CLASS="sect2"
  19951. ><HR><H3
  19952. CLASS="sect2"
  19953. ><A
  19954. NAME="language.types.number"
  19955. ></A
  19956. >number</H3
  19957. ><P
  19958. >      <TT
  19959. CLASS="literal"
  19960. >number</TT
  19961. > indicates that a parameter can be either
  19962.      <A
  19963. HREF="#language.types.integer"
  19964. ><B
  19965. CLASS="type"
  19966. >integer</B
  19967. ></A
  19968. > or <A
  19969. HREF="#language.types.float"
  19970. ><B
  19971. CLASS="type"
  19972. >float</B
  19973. ></A
  19974. >.
  19975.     </P
  19976. ></DIV
  19977. ><DIV
  19978. CLASS="sect2"
  19979. ><HR><H3
  19980. CLASS="sect2"
  19981. ><A
  19982. NAME="language.types.callback"
  19983. ></A
  19984. >callback</H3
  19985. ><P
  19986. >      Some functions like <A
  19987. HREF="#function.call-user-func"
  19988. ><B
  19989. CLASS="function"
  19990. >call_user_func()</B
  19991. ></A
  19992. > 
  19993.      or <A
  19994. HREF="#function.usort"
  19995. ><B
  19996. CLASS="function"
  19997. >usort()</B
  19998. ></A
  19999. > accept user defined 
  20000.      callback functions as a parameter. Callback functions can not only
  20001.      be simple functions but also object methods including static class
  20002.      methods. 
  20003.     </P
  20004. ><P
  20005. >      A PHP function is simply passed by its name as a string. You can
  20006.      pass any builtin or user defined function with the exception of 
  20007.      <A
  20008. HREF="#function.array"
  20009. ><B
  20010. CLASS="function"
  20011. >array()</B
  20012. ></A
  20013. >, 
  20014.      <A
  20015. HREF="#function.echo"
  20016. ><B
  20017. CLASS="function"
  20018. >echo()</B
  20019. ></A
  20020. >, 
  20021.      <A
  20022. HREF="#function.empty"
  20023. ><B
  20024. CLASS="function"
  20025. >empty()</B
  20026. ></A
  20027. >, 
  20028.      <A
  20029. HREF="#function.eval"
  20030. ><B
  20031. CLASS="function"
  20032. >eval()</B
  20033. ></A
  20034. >, 
  20035.      <A
  20036. HREF="#function.exit"
  20037. ><B
  20038. CLASS="function"
  20039. >exit()</B
  20040. ></A
  20041. >, 
  20042.      <A
  20043. HREF="#function.isset"
  20044. ><B
  20045. CLASS="function"
  20046. >isset()</B
  20047. ></A
  20048. >, 
  20049.      <A
  20050. HREF="#function.list"
  20051. ><B
  20052. CLASS="function"
  20053. >list()</B
  20054. ></A
  20055. >, 
  20056.      <A
  20057. HREF="#function.print"
  20058. ><B
  20059. CLASS="function"
  20060. >print()</B
  20061. ></A
  20062. > and 
  20063.      <A
  20064. HREF="#function.unset"
  20065. ><B
  20066. CLASS="function"
  20067. >unset()</B
  20068. ></A
  20069. >.
  20070.     </P
  20071. ><P
  20072. >      A method of an instantiated object is passed as an array containing
  20073.      an object as the element with index 0 and a method name as the 
  20074.      element with index 1.
  20075.     </P
  20076. ><P
  20077. >      Static class methods can also be passed without instantiating an
  20078.      object of that class by passing the class name instead of an 
  20079.      object as the element with index 0.
  20080.     </P
  20081. ><P
  20082. >      <TABLE
  20083. WIDTH="100%"
  20084. BORDER="0"
  20085. CELLPADDING="0"
  20086. CELLSPACING="0"
  20087. CLASS="EXAMPLE"
  20088. ><TR
  20089. ><TD
  20090. ><DIV
  20091. CLASS="example"
  20092. ><A
  20093. NAME="AEN3967"
  20094. ></A
  20095. ><P
  20096. ><B
  20097. >P°φklad 6-11. 
  20098.        Callback function examples
  20099.       </B
  20100. ></P
  20101. ><TABLE
  20102. BORDER="0"
  20103. BGCOLOR="#E0E0E0"
  20104. CELLPADDING="5"
  20105. ><TR
  20106. ><TD
  20107. ><PRE
  20108. CLASS="php"
  20109. ><?php 
  20110.  
  20111. // simple callback example
  20112. function my_callback_function() {
  20113.     echo 'hello world!';
  20114. }
  20115. call_user_func('my_callback_function'); 
  20116.  
  20117. // method callback examples
  20118. class MyClass {
  20119.     function myCallbackMethod() {
  20120.         echo 'Hello World!';
  20121.     }
  20122. }
  20123.  
  20124. // static class method call without instantiating an object
  20125. call_user_func(array('MyClass', 'myCallbackMethod')); 
  20126.  
  20127. // object method call
  20128. $obj = new MyClass();
  20129. call_user_func(array(&$obj, 'myCallbackMethod'));
  20130. ?></PRE
  20131. ></TD
  20132. ></TR
  20133. ></TABLE
  20134. ></DIV
  20135. ></TD
  20136. ></TR
  20137. ></TABLE
  20138. >
  20139.     </P
  20140. ></DIV
  20141. ></DIV
  20142. ><DIV
  20143. CLASS="sect1"
  20144. ><HR><H2
  20145. CLASS="sect1"
  20146. ><A
  20147. NAME="language.types.type-juggling"
  20148. ></A
  20149. >Type Juggling</H2
  20150. ><P
  20151. >     PHP does not require (or support) explicit type definition in
  20152.     variable declaration; a variable's type is determined by the
  20153.     context in which that variable is used. That is to say, if you
  20154.     assign a string value to variable <TT
  20155. CLASS="parameter"
  20156. ><I
  20157. >$var</I
  20158. ></TT
  20159. >,
  20160.     <TT
  20161. CLASS="parameter"
  20162. ><I
  20163. >$var</I
  20164. ></TT
  20165. > becomes a string. If you then assign an
  20166.     integer value to <TT
  20167. CLASS="parameter"
  20168. ><I
  20169. >$var</I
  20170. ></TT
  20171. >, it becomes an
  20172.     integer.
  20173.    </P
  20174. ><P
  20175. >     An example of PHP's automatic type conversion is the addition
  20176.     operator '+'. If any of the operands is a float, then all
  20177.     operands are evaluated as floats, and the result will be a
  20178.     float. Otherwise, the operands will be interpreted as integers,
  20179.     and the result will also be an integer. Note that this does NOT
  20180.     change the types of the operands themselves; the only change is in
  20181.     how the operands are evaluated.
  20182.     <DIV
  20183. CLASS="informalexample"
  20184. ><A
  20185. NAME="AEN3977"
  20186. ></A
  20187. ><P
  20188. ></P
  20189. ><TABLE
  20190. BORDER="0"
  20191. BGCOLOR="#E0E0E0"
  20192. CELLPADDING="5"
  20193. ><TR
  20194. ><TD
  20195. ><PRE
  20196. CLASS="php"
  20197. ><?php
  20198. $foo = "0";  // $foo is string (ASCII 48)
  20199. $foo += 2;   // $foo is now an integer (2)
  20200. $foo = $foo + 1.3;  // $foo is now a float (3.3)
  20201. $foo = 5 + "10 Little Piggies"; // $foo is integer (15)
  20202. $foo = 5 + "10 Small Pigs";     // $foo is integer (15)
  20203. ?></PRE
  20204. ></TD
  20205. ></TR
  20206. ></TABLE
  20207. ><P
  20208. ></P
  20209. ></DIV
  20210. >
  20211.    </P
  20212. ><P
  20213. >     If the last two examples above seem odd, see <A
  20214. HREF="#language.types.string.conversion"
  20215. >String
  20216.     conversion to numbers</A
  20217. >.
  20218.    </P
  20219. ><P
  20220. >     If you wish to force a variable to be evaluated as a certain type,
  20221.     see the section on <A
  20222. HREF="#language.types.typecasting"
  20223. >Type
  20224.     casting</A
  20225. >. If you wish to change the type of a variable, see
  20226.     <A
  20227. HREF="#function.settype"
  20228. ><B
  20229. CLASS="function"
  20230. >settype()</B
  20231. ></A
  20232. >.
  20233.    </P
  20234. ><P
  20235. >     If you would like to test any of the examples in this section, you
  20236.     can use the <A
  20237. HREF="#function.var-dump"
  20238. ><B
  20239. CLASS="function"
  20240. >var_dump()</B
  20241. ></A
  20242. > function.
  20243.    </P
  20244. ><DIV
  20245. CLASS="note"
  20246. ><BLOCKQUOTE
  20247. CLASS="note"
  20248. ><P
  20249. ><B
  20250. >Poznßmka: </B
  20251. >
  20252.      The behaviour of an automatic conversion to array is currently
  20253.      undefined.
  20254.     </P
  20255. ><P
  20256. >      <DIV
  20257. CLASS="informalexample"
  20258. ><A
  20259. NAME="AEN3989"
  20260. ></A
  20261. ><P
  20262. ></P
  20263. ><TABLE
  20264. BORDER="0"
  20265. BGCOLOR="#E0E0E0"
  20266. CELLPADDING="5"
  20267. ><TR
  20268. ><TD
  20269. ><PRE
  20270. CLASS="php"
  20271. ><?php
  20272. $a = "1";     // $a is a string
  20273. $a[0] = "f";  // What about string offsets? What happens?
  20274. ?></PRE
  20275. ></TD
  20276. ></TR
  20277. ></TABLE
  20278. ><P
  20279. ></P
  20280. ></DIV
  20281. >
  20282.     </P
  20283. ><P
  20284. >      Since PHP (for historical reasons) supports indexing into strings
  20285.      via offsets using the same syntax as array indexing, the example
  20286.      above leads to a problem: should $a become an array with its first
  20287.      element being "f", or should "f" become the first character of the
  20288.      string $a?
  20289.     </P
  20290. ><P
  20291. >      The current versions of PHP interpret the second assignment as
  20292.      a string offset identification, so $a becomes "f", the result
  20293.      of this automatic conversion however should be considered
  20294.      undefined. PHP 4 introduced the new curly bracket syntax to access
  20295.      characters in string, use this syntax instead of the one presented
  20296.      above: 
  20297.      <DIV
  20298. CLASS="informalexample"
  20299. ><A
  20300. NAME="AEN3993"
  20301. ></A
  20302. ><P
  20303. ></P
  20304. ><TABLE
  20305. BORDER="0"
  20306. BGCOLOR="#E0E0E0"
  20307. CELLPADDING="5"
  20308. ><TR
  20309. ><TD
  20310. ><PRE
  20311. CLASS="php"
  20312. ><?php
  20313. $a    = "abc"; // $a is a string
  20314. $a{1} = "f";   // $a is now "afc"
  20315. ?></PRE
  20316. ></TD
  20317. ></TR
  20318. ></TABLE
  20319. ><P
  20320. ></P
  20321. ></DIV
  20322. >
  20323.      See the section titled <A
  20324. HREF="#language.types.string.substr"
  20325. >String
  20326.      access by character</A
  20327. > for more information.
  20328.     </P
  20329. ></BLOCKQUOTE
  20330. ></DIV
  20331. ><DIV
  20332. CLASS="sect2"
  20333. ><HR><H3
  20334. CLASS="sect2"
  20335. ><A
  20336. NAME="language.types.typecasting"
  20337. ></A
  20338. >Type Casting</H3
  20339. ><P
  20340. >      Type casting in PHP works much as it does in C: the name of the
  20341.      desired type is written in parentheses before the variable which
  20342.      is to be cast.
  20343.      <DIV
  20344. CLASS="informalexample"
  20345. ><A
  20346. NAME="AEN3999"
  20347. ></A
  20348. ><P
  20349. ></P
  20350. ><TABLE
  20351. BORDER="0"
  20352. BGCOLOR="#E0E0E0"
  20353. CELLPADDING="5"
  20354. ><TR
  20355. ><TD
  20356. ><PRE
  20357. CLASS="php"
  20358. ><?php
  20359. $foo = 10;   // $foo is an integer
  20360. $bar = (boolean) $foo;   // $bar is a boolean
  20361. ?></PRE
  20362. ></TD
  20363. ></TR
  20364. ></TABLE
  20365. ><P
  20366. ></P
  20367. ></DIV
  20368. >
  20369.     </P
  20370. ><P
  20371. >      The casts allowed are:
  20372.      <P
  20373. ></P
  20374. ><UL
  20375. ><LI
  20376. ><P
  20377. >(int), (integer) - cast to integer</P
  20378. ></LI
  20379. ><LI
  20380. ><P
  20381. >(bool), (boolean) - cast to boolean</P
  20382. ></LI
  20383. ><LI
  20384. ><P
  20385. >(float), (double), (real) - cast to float</P
  20386. ></LI
  20387. ><LI
  20388. ><P
  20389. >(string) - cast to string</P
  20390. ></LI
  20391. ><LI
  20392. ><P
  20393. >(array) - cast to array</P
  20394. ></LI
  20395. ><LI
  20396. ><P
  20397. >(object) - cast to object</P
  20398. ></LI
  20399. ></UL
  20400. >
  20401.     </P
  20402. ><P
  20403. >      Note that tabs and spaces are allowed inside the parentheses, so
  20404.      the following are functionally equivalent:
  20405.      <DIV
  20406. CLASS="informalexample"
  20407. ><A
  20408. NAME="AEN4016"
  20409. ></A
  20410. ><P
  20411. ></P
  20412. ><TABLE
  20413. BORDER="0"
  20414. BGCOLOR="#E0E0E0"
  20415. CELLPADDING="5"
  20416. ><TR
  20417. ><TD
  20418. ><PRE
  20419. CLASS="php"
  20420. ><?php
  20421. $foo = (int) $bar;
  20422. $foo = ( int ) $bar;
  20423. ?></PRE
  20424. ></TD
  20425. ></TR
  20426. ></TABLE
  20427. ><P
  20428. ></P
  20429. ></DIV
  20430. >
  20431.     </P
  20432. ><DIV
  20433. CLASS="note"
  20434. ><BLOCKQUOTE
  20435. CLASS="note"
  20436. ><P
  20437. ><B
  20438. >Poznßmka: </B
  20439. >
  20440.       Instead of casting a variable to string, you can also enclose
  20441.       the variable in double quotes.
  20442.      <DIV
  20443. CLASS="informalexample"
  20444. ><A
  20445. NAME="AEN4020"
  20446. ></A
  20447. ><P
  20448. ></P
  20449. ><TABLE
  20450. BORDER="0"
  20451. BGCOLOR="#E0E0E0"
  20452. CELLPADDING="5"
  20453. ><TR
  20454. ><TD
  20455. ><PRE
  20456. CLASS="php"
  20457. ><?php
  20458. $foo = 10;            // $foo is an integer
  20459. $str = "$foo";        // $str is a string
  20460. $fst = (string) $foo; // $fst is also a string
  20461.  
  20462. // This prints out that "they are the same"
  20463. if ($fst === $str) {
  20464.     echo "they are the same";
  20465. }
  20466. ?></PRE
  20467. ></TD
  20468. ></TR
  20469. ></TABLE
  20470. ><P
  20471. ></P
  20472. ></DIV
  20473. >
  20474.      </P
  20475. ></BLOCKQUOTE
  20476. ></DIV
  20477. ><P
  20478. >      It may not be obvious exactly what will happen when casting
  20479.      between certain types. For more info, see these sections:
  20480.     
  20481.      <P
  20482. ></P
  20483. ><UL
  20484. ><LI
  20485. ><P
  20486. ><A
  20487. HREF="#language.types.boolean.casting"
  20488. >Converting to 
  20489.         boolean</A
  20490. ></P
  20491. ></LI
  20492. ><LI
  20493. ><P
  20494. ><A
  20495. HREF="#language.types.integer.casting"
  20496. >Converting to 
  20497.         integer</A
  20498. ></P
  20499. ></LI
  20500. ><LI
  20501. ><P
  20502. ><A
  20503. HREF="#language.types.float.casting"
  20504. >Converting to 
  20505.         float</A
  20506. ></P
  20507. ></LI
  20508. ><LI
  20509. ><P
  20510. ><A
  20511. HREF="#language.types.string.casting"
  20512. >Converting to 
  20513.         string</A
  20514. ></P
  20515. ></LI
  20516. ><LI
  20517. ><P
  20518. ><A
  20519. HREF="#language.types.array.casting"
  20520. >Converting to 
  20521.         array</A
  20522. ></P
  20523. ></LI
  20524. ><LI
  20525. ><P
  20526. ><A
  20527. HREF="#language.types.object.casting"
  20528. >Converting to 
  20529.         object</A
  20530. ></P
  20531. ></LI
  20532. ><LI
  20533. ><P
  20534. ><A
  20535. HREF="#language.types.resource.casting"
  20536. >Converting to 
  20537.         resource</A
  20538. ></P
  20539. ></LI
  20540. ><LI
  20541. ><P
  20542. >         <A
  20543. HREF="#types.comparisons"
  20544. >The type comparison tables</A
  20545. >
  20546.        </P
  20547. ></LI
  20548. ></UL
  20549. >
  20550.     </P
  20551. ></DIV
  20552. ></DIV
  20553. ></DIV
  20554. ><DIV
  20555. CLASS="chapter"
  20556. ><HR><H1
  20557. ><A
  20558. NAME="language.variables"
  20559. >Kapitola 7. Prom∞nnΘ</A
  20560. ></H1
  20561. ><DIV
  20562. CLASS="sect1"
  20563. ><H2
  20564. CLASS="sect1"
  20565. ><A
  20566. NAME="language.variables.basics"
  20567. ></A
  20568. >Zßklady</H2
  20569. ><P
  20570. >     Prom∞nnΘ jsou v PHP reprezentovßny znakem dolaru, nßsledovan²m nßzvem
  20571.     p°φslu╣nΘ prom∞nnΘ. V nßzvech prom∞nn²ch se rozli╣uje velikost pφsmen.
  20572.    </P
  20573. ><P
  20574. >     Nßzvy prom∞nn²ch jsou pod°φzeny stejn²m pravidl∙m jako jinß nßv∞╣tφ
  20575.     v PHP. Platn² nßzev prom∞nnΘ zaΦφnß pφsmenem nebo podtr╛φtkem,
  20576.     nßsledovan²m libovoln²m poΦtem pφsmen, Φφslic nebo potr╛φtek. Jako
  20577.     regulßrnφ v²raz to lze zapsat takto:
  20578.     '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*'
  20579.    </P
  20580. ><DIV
  20581. CLASS="note"
  20582. ><BLOCKQUOTE
  20583. CLASS="note"
  20584. ><P
  20585. ><B
  20586. >Poznßmka: </B
  20587. >
  20588.      Pro na╣e ·Φely zde budeme za pφsmena pova╛ovat znaky a-z, A-Z
  20589.      a ASCII znaky od 127 do 255 (0x7f-0xff).
  20590.     </P
  20591. ></BLOCKQUOTE
  20592. ></DIV
  20593. ><P
  20594. >     <DIV
  20595. CLASS="informalexample"
  20596. ><A
  20597. NAME="AEN4057"
  20598. ></A
  20599. ><P
  20600. ></P
  20601. ><TABLE
  20602. BORDER="0"
  20603. BGCOLOR="#E0E0E0"
  20604. CELLPADDING="5"
  20605. ><TR
  20606. ><TD
  20607. ><PRE
  20608. CLASS="php"
  20609. >$var = "Bob";
  20610. $Var = "Joe";
  20611. echo "$var, $Var";      // vypφ╣e "Bob, Joe"
  20612.  
  20613. $4site = 'not yet';     // neplatnΘ; zaΦφnß Φφslicφ
  20614. $_4site = 'not yet';    // platnΘ; zaΦφnß podtr╛φtkem
  20615. $tΣyte = 'mansikka';    // platnΘ; 'Σ' je ASCII 228.</PRE
  20616. ></TD
  20617. ></TR
  20618. ></TABLE
  20619. ><P
  20620. ></P
  20621. ></DIV
  20622. >
  20623.    </P
  20624. ><P
  20625. >     V PHP 3 majφ prom∞nnΘ v╛dy p°i°azenu hodnotu. To znamenß, ╛e kdy╛
  20626.     p°i°adφte v²raz do prom∞nnΘ, celß hodnota p∙vodnφho v²razu se
  20627.     zkopφruje do cφlovΘ prom∞nnΘ. Tedy, nap°φklad, po p°i°azenφ hodnoty
  20628.     jednΘ prom∞nnΘ do druhΘ, zm∞na jednΘ z nich se na druhΘ neprojevφ.
  20629.     Vφce informacφ o tomto zp∙sobu p°i°azenφ viz
  20630.     <A
  20631. HREF="#language.expressions"
  20632. >V²razy</A
  20633. >.
  20634.    </P
  20635. ><P
  20636. >     PHP nabφzφ jin² zp∙sob p°i°azenφ hodnot prom∞nn²m:
  20637.     <SPAN
  20638. CLASS="emphasis"
  20639. ><I
  20640. CLASS="emphasis"
  20641. >p°i°azenφ odkazu</I
  20642. ></SPAN
  20643. >. To znamenß, ╛e novß prom∞nnß
  20644.     jednodu╣e odkazuje (jin²mi slovy, "stßvß se aliasem" nebo "ukazuje na")
  20645.     na p∙vodnφ prom∞nnou. Zm∞ny na novΘ prom∞nnΘ se projevφ na tΘ p∙vodnφ
  20646.     a naopak. To takΘ znamenß, ╛e se nic nekopφruje; proto je p°i°azenφ
  20647.     rychlej╣φ. Av╣ak toto zrychlenφ bude zjistitelnΘ pouze v t∞sn²ch cyklech
  20648.     nebo p°i p°i°azovßnφ velk²ch polφ Φi objekt∙.
  20649.    </P
  20650. ><P
  20651. >     Pro p°i°azenφ odkazu staΦφ jednodu╣e p°ed prom∞nnou, kterß bude
  20652.     p°i°azovßna (zdrojovß prom∞nnß), p°ed°adit ampersand (&). Nap°φklad
  20653.     nßsledujφcφ kus k≤du vypφ╣e dvakrßt 'Jmenuji se Bob':
  20654.  
  20655.     <DIV
  20656. CLASS="informalexample"
  20657. ><A
  20658. NAME="AEN4064"
  20659. ></A
  20660. ><P
  20661. ></P
  20662. ><TABLE
  20663. BORDER="0"
  20664. BGCOLOR="#E0E0E0"
  20665. CELLPADDING="5"
  20666. ><TR
  20667. ><TD
  20668. ><PRE
  20669. CLASS="php"
  20670. ><?php
  20671. $foo = 'Bob';              // P°i°adφ hodnotu 'Bob' do $foo
  20672. $bar = &$foo;              // Odkaz $foo p°es $bar.
  20673. $bar = "Jmenuji se $bar";  // Zm∞na $bar...
  20674. echo $bar;
  20675. echo $foo;                 // $foo je takΘ zm∞n∞no.
  20676. ?></PRE
  20677. ></TD
  20678. ></TR
  20679. ></TABLE
  20680. ><P
  20681. ></P
  20682. ></DIV
  20683. >
  20684.    </P
  20685. ><P
  20686. >     Jednou z d∙le╛it²ch v∞cφ, kterΘ je t°eba si uv∞domit, je to, ╛e p°es
  20687.     odkazy lze p°i°azovat pouze pojmenovanΘ prom∞nnΘ.
  20688.     <DIV
  20689. CLASS="informalexample"
  20690. ><A
  20691. NAME="AEN4067"
  20692. ></A
  20693. ><P
  20694. ></P
  20695. ><TABLE
  20696. BORDER="0"
  20697. BGCOLOR="#E0E0E0"
  20698. CELLPADDING="5"
  20699. ><TR
  20700. ><TD
  20701. ><PRE
  20702. CLASS="php"
  20703. ><?php
  20704. $foo = 25;
  20705. $bar = &$foo;      // Toto je platnΘ p°i°azenφ.
  20706. $bar = &(24 * 7);  // NeplatnΘ; odkazuje se nepojmenovan² v²raz.
  20707.  
  20708. function test()
  20709. {
  20710.    return 25;
  20711. }
  20712.  
  20713. $bar = &test();    // NeplatnΘ.
  20714. ?></PRE
  20715. ></TD
  20716. ></TR
  20717. ></TABLE
  20718. ><P
  20719. ></P
  20720. ></DIV
  20721. >
  20722.    </P
  20723. ></DIV
  20724. ><DIV
  20725. CLASS="sect1"
  20726. ><HR><H2
  20727. CLASS="sect1"
  20728. ><A
  20729. NAME="language.variables.predefined"
  20730. ></A
  20731. >P°eddefinovanΘ prom∞nnΘ</H2
  20732. ><P
  20733. >     PHP poskytuje velkΘ mno╛stvφ p°eddefinovan²ch prom∞nn²ch jakΘmukoli
  20734.     skriptu, kter² provßdφ. Mnoho t∞chto prom∞nn²ch, bohu╛el, nem∙╛e b²t
  20735.     pln∞ zdokumentovßno, proto╛e zßvisejφ na tom, na kterΘm serveru skript
  20736.     b∞╛φ, na verzi a nastavenφ serveru a dal╣φch faktorech. N∞kterΘ z t∞chto
  20737.     prom∞nn²ch nebudou dostupnΘ, kdy╛ PHP pob∞╛φ z p°φkazovΘ °ßdky. Seznam
  20738.     prom∞nn²ch - viz sekce 
  20739.     <A
  20740. HREF="#reserved.variables"
  20741. >P°eddefinovanΘ prom∞nnΘ</A
  20742. >.
  20743.    </P
  20744. ><DIV
  20745. CLASS="warning"
  20746. ><P
  20747. ></P
  20748. ><TABLE
  20749. CLASS="warning"
  20750. BORDER="1"
  20751. WIDTH="100%"
  20752. ><TR
  20753. ><TD
  20754. ALIGN="CENTER"
  20755. ><B
  20756. >Varovßnφ</B
  20757. ></TD
  20758. ></TR
  20759. ><TR
  20760. ><TD
  20761. ALIGN="LEFT"
  20762. ><P
  20763. >      V PHP 4.2.0 a pozd∞j╣φch se zm∞nila implicitnφ sada p°eddefinovan²ch
  20764.      prom∞nn²ch, kterΘ jsou globßln∞ dostupnΘ. Individußlnφ vstupnφ a
  20765.      serverovΘ prom∞nnΘ se <SPAN
  20766. CLASS="emphasis"
  20767. ><I
  20768. CLASS="emphasis"
  20769. >implicitn∞</I
  20770. ></SPAN
  20771. > neumφs╗ujφ do
  20772.      globßlnφho kontextu; namφsto toho jsou v nßsledujφcφch
  20773.      <A
  20774. HREF="#language.variables.superglobals"
  20775. >superglobßlnφch
  20776.      polφch</A
  20777. >.
  20778.     </P
  20779. ><P
  20780. >      M∙╛ete v╣ak stßle vynutit starΘ chovßnφ nastavenφm
  20781.      <A
  20782. HREF="#ini.register-globals"
  20783. >register_globals</A
  20784. > v souboru
  20785.      <TT
  20786. CLASS="filename"
  20787. >php.ini</TT
  20788. > na 'On'.
  20789.     </P
  20790. ><P
  20791. >      Pro vφce informacφ a pozadφ t∞chto zm∞n prosφm nahlΘdn∞te do
  20792.      <A
  20793. HREF="http://www.php.net/release_4_1_0.php"
  20794. TARGET="_top"
  20795. >PHP 4.1.0 Release Announcement</A
  20796. >.
  20797.     </P
  20798. ></TD
  20799. ></TR
  20800. ></TABLE
  20801. ></DIV
  20802. ><P
  20803. >     Od verze 4.1.0 poskytuje PHP sadu p°eddefinovan²ch polφ, obsahujφcφch
  20804.     prom∞nnΘ WWW serveru (pokud to jde), prost°edφ a u╛ivatelskΘho vstupu.
  20805.     Tato novß pole majφ tu zvlß╣tnost, ╛e jsou automaticky globßlnφ -- tedy
  20806.     nap°. automaticky dostupnΘ v ka╛dΘm kontextu. Z tohoto d∙vodu jsou
  20807.     Φasto znßma jako "autoglobßlnφ" nebo "superglobßlnφ". (V PHP neexistuje
  20808.     mechanismus pro u╛ivatelskou definici superglobßlnφch prom∞nn²ch).
  20809.     Superglobßlnφ prom∞nnΘ jsou vypsßny nφ╛e; pro seznam jejich obsah∙ a
  20810.     dal╣φ diskusi o p°eddefinovan²ch prom∞nn²ch v PHP a jejich charakteru
  20811.     v╣ak musφte nahlΘdnout do Φßsti 
  20812.     <A
  20813. HREF="#reserved.variables"
  20814. >P°eddefinovanΘ prom∞nnΘ</A
  20815. >.
  20816.    </P
  20817. ><P
  20818. ></P
  20819. ><DIV
  20820. CLASS="variablelist"
  20821. ><P
  20822. ><B
  20823. >PHP superglobals (superglobßlnφ prom∞nnΘ)</B
  20824. ></P
  20825. ><DL
  20826. ><DT
  20827. ><A
  20828. HREF="#reserved.variables.globals"
  20829. >$GLOBALS</A
  20830. ></DT
  20831. ><DD
  20832. ><P
  20833. >        Obsahuje odkaz na ka╛dou prom∞nnou, kterß je momentßln∞ dostupnß
  20834.        v globßlnφm kontextu skriptu. KlφΦi tohoto pole jsou nßzvy globßlnφch
  20835.        prom∞nn²ch.
  20836.       </P
  20837. ></DD
  20838. ><DT
  20839. ><A
  20840. HREF="#reserved.variables.server"
  20841. >$_SERVER</A
  20842. ></DT
  20843. ><DD
  20844. ><P
  20845. >        Prom∞nnΘ nastavovanΘ WWW serveru nebo jinak p°φmo spjatΘ s provßd∞cφm
  20846.        prost°edφm aktußlnφho skriptu. AnalogickΘ starΘmu poli
  20847.        <TT
  20848. CLASS="varname"
  20849. >$HTTP_SERVER_VARS</TT
  20850. > (kterΘ je stßle dostupnΘ, ale
  20851.        zavr╛enΘ).
  20852.       </P
  20853. ></DD
  20854. ><DT
  20855. ><A
  20856. HREF="#reserved.variables.get"
  20857. >$_GET</A
  20858. ></DT
  20859. ><DD
  20860. ><P
  20861. >        Prom∞nnΘ poskytovanΘ skriptu p°es HTTP GET. AnalogickΘ starΘmu poli
  20862.        <TT
  20863. CLASS="varname"
  20864. >$HTTP_GET_VARS</TT
  20865. > (kterΘ je stßle dostupnΘ, ale
  20866.        zavr╛enΘ).
  20867.       </P
  20868. ></DD
  20869. ><DT
  20870. ><A
  20871. HREF="#reserved.variables.post"
  20872. >$_POST</A
  20873. ></DT
  20874. ><DD
  20875. ><P
  20876. >        Prom∞nnΘ poskytovanΘ skriptu p°es HTTP POST. AnalogickΘ starΘmu poli
  20877.        <TT
  20878. CLASS="varname"
  20879. >$HTTP_POST_VARS</TT
  20880. > (kterΘ je stßle dostupnΘ, ale
  20881.        zavr╛enΘ).
  20882.       </P
  20883. ></DD
  20884. ><DT
  20885. ><A
  20886. HREF="#reserved.variables.cookies"
  20887. >$_COOKIE</A
  20888. ></DT
  20889. ><DD
  20890. ><P
  20891. >        Prom∞nnΘ poskytovanΘ skriptu p°es HTTP cookies. AnalogickΘ starΘmu poli
  20892.        <TT
  20893. CLASS="varname"
  20894. >$HTTP_COOKIE_VARS</TT
  20895. > (kterΘ je stßle dostupnΘ, ale
  20896.        zavr╛enΘ).
  20897.       </P
  20898. ></DD
  20899. ><DT
  20900. ><A
  20901. HREF="#reserved.variables.files"
  20902. >$_FILES</A
  20903. ></DT
  20904. ><DD
  20905. ><P
  20906. >        Prom∞nnΘ poskytovanΘ skriptu p°es HTTP post uploady soubor∙. AnalogickΘ
  20907.        uploads. AnalogickΘ starΘmu poli
  20908.        <TT
  20909. CLASS="varname"
  20910. >$HTTP_POST_FILES</TT
  20911. > (kterΘ je stßle dostupnΘ, ale
  20912.        zavr╛enΘ). Vφce informacφ - viz
  20913.        <A
  20914. HREF="#features.file-upload.post-method"
  20915. >Upload metodou
  20916.        POST</A
  20917. >.
  20918.       </P
  20919. ></DD
  20920. ><DT
  20921. ><A
  20922. HREF="#reserved.variables.environment"
  20923. >$_ENV</A
  20924. ></DT
  20925. ><DD
  20926. ><P
  20927. >Prom∞nnΘ poskytovanΘ skriptu z prost°edφ. AnalogickΘ starΘmu
  20928.       poli <TT
  20929. CLASS="varname"
  20930. >$HTTP_ENV_VARS</TT
  20931. > (kterΘ je stßle dostupnΘ, ale
  20932.        zavr╛enΘ).
  20933.       </P
  20934. ></DD
  20935. ><DT
  20936. ><A
  20937. HREF="#reserved.variables.request"
  20938. >$_REQUEST</A
  20939. ></DT
  20940. ><DD
  20941. ><P
  20942. >        Prom∞nnΘ poskytovanΘ skriptu p°es libovoln² vstupnφ mechanismus a
  20943.        kter²m proto nelze d∙v∞°ovat. Pozn.: p°i b∞hu z p°φkazovΘ °ßdky zde
  20944.        <SPAN
  20945. CLASS="emphasis"
  20946. ><I
  20947. CLASS="emphasis"
  20948. >nebudou</I
  20949. ></SPAN
  20950. > p°φtomny polo╛ky <TT
  20951. CLASS="varname"
  20952. >argv</TT
  20953. >
  20954.        a <TT
  20955. CLASS="varname"
  20956. >argc</TT
  20957. >; nachßzejφ se v poli
  20958.        <TT
  20959. CLASS="varname"
  20960. >$_SERVER</TT
  20961. >. P°φtomnost a po°adφ prom∞nn²ch v tomto
  20962.        poli se definuje podle konfiguraΦnφ direktivy
  20963.        <A
  20964. HREF="#ini.variables-order"
  20965. >variables_order</A
  20966. >. Toto pole
  20967.        nemß p°φmou analogii ve verzφch PHP p°ed 4.1.0.
  20968.       </P
  20969. ></DD
  20970. ><DT
  20971. ><A
  20972. HREF="#reserved.variables.session"
  20973. >$_SESSION</A
  20974. ></DT
  20975. ><DD
  20976. ><P
  20977. >        Prom∞nnΘ, kterΘ jsou momentßln∞ registrovßny v aktußlnφ relaci skriptu.
  20978.        AnalogickΘ starΘmu poli
  20979.        <TT
  20980. CLASS="varname"
  20981. >$HTTP_SESSION_VARS</TT
  20982. > (kterΘ je stßle dostupnΘ, ale
  20983.        zavr╛enΘ). Vφce informacφ - viz <A
  20984. HREF="#ref.session"
  20985. >Funkce pro obsluhu sessions</A
  20986. >.
  20987.       </P
  20988. ></DD
  20989. ></DL
  20990. ></DIV
  20991. ></DIV
  20992. ><DIV
  20993. CLASS="sect1"
  20994. ><HR><H2
  20995. CLASS="sect1"
  20996. ><A
  20997. NAME="language.variables.scope"
  20998. ></A
  20999. >Kontext ("scope") prom∞nnΘ</H2
  21000. ><P
  21001. >     Kontext prom∞nnΘ je oblast, ve kterΘ je definovßna. V∞t╣ina prom∞nn²ch
  21002.     v PHP mß pouze jedin² kontext. Ten zahrnuje i soubory vlo╛enΘ pomocφ
  21003.     "include" nebo "require". Nap°φklad:
  21004.    </P
  21005. ><DIV
  21006. CLASS="informalexample"
  21007. ><A
  21008. NAME="AEN4148"
  21009. ></A
  21010. ><P
  21011. ></P
  21012. ><TABLE
  21013. BORDER="0"
  21014. BGCOLOR="#E0E0E0"
  21015. CELLPADDING="5"
  21016. ><TR
  21017. ><TD
  21018. ><PRE
  21019. CLASS="php"
  21020. >$a = 1;
  21021. include "b.inc";</PRE
  21022. ></TD
  21023. ></TR
  21024. ></TABLE
  21025. ><P
  21026. ></P
  21027. ></DIV
  21028. ><P
  21029. >     Zde bude prom∞nnß <TT
  21030. CLASS="varname"
  21031. >$a</TT
  21032. > dostupnß ve vlo╛enΘm skriptu
  21033.     <TT
  21034. CLASS="filename"
  21035. >b.inc</TT
  21036. >. Av╣ak uvnit° u╛ivatelsky definovan²ch funkcφ
  21037.     se zaklßdß jejich lokßlnφ kontext. Jakßkoli prom∞nnß pou╛itß uvnit°
  21038.     funkce je implicitn∞ omezena na tento mφstnφ kontext. Nap°φklad:
  21039.    </P
  21040. ><DIV
  21041. CLASS="informalexample"
  21042. ><A
  21043. NAME="AEN4153"
  21044. ></A
  21045. ><P
  21046. ></P
  21047. ><TABLE
  21048. BORDER="0"
  21049. BGCOLOR="#E0E0E0"
  21050. CELLPADDING="5"
  21051. ><TR
  21052. ><TD
  21053. ><PRE
  21054. CLASS="php"
  21055. >$a = 1; /* globßlnφ kontext */ 
  21056.  
  21057. function Test()
  21058. { 
  21059.     echo $a; /* odkaz na prom∞nnou v lokßlnφm kontextu */ 
  21060. } 
  21061.  
  21062. Test();</PRE
  21063. ></TD
  21064. ></TR
  21065. ></TABLE
  21066. ><P
  21067. ></P
  21068. ></DIV
  21069. ><P
  21070. >     Tento skript nevyprodukuje ╛ßdn² v²stup, proto╛e konstrukt "echo"
  21071.     odkazuje na lokßlnφ verzi prom∞nnΘ <TT
  21072. CLASS="varname"
  21073. >$a</TT
  21074. >, a ta nemß
  21075.     v tomto kontextu p°i°azenu ╛ßdnou hodnotu. M∙╛ete si v╣imnout, ╛e to je
  21076.     trochu jinΘ ne╛ v jazyce C, kde jsou globßlnφ funkce automaticky
  21077.     dostupnΘ ve funkcφch, pokud nejsou specificky zastφn∞ny lokßlnφ definicφ.
  21078.     To m∙╛e zp∙sobit problΘmy tφm, ╛e Φlov∞k m∙╛e necht∞n∞ zm∞nit globßlnφ
  21079.     prom∞nnou. V PHP musφ b²t globßlnφ prom∞nnΘ deklarovßny uvnit° funkce
  21080.     jako globßlnφ, pokud se v nφ majφ pou╛φvat. P°φklad:
  21081.    </P
  21082. ><DIV
  21083. CLASS="informalexample"
  21084. ><A
  21085. NAME="AEN4157"
  21086. ></A
  21087. ><P
  21088. ></P
  21089. ><TABLE
  21090. BORDER="0"
  21091. BGCOLOR="#E0E0E0"
  21092. CELLPADDING="5"
  21093. ><TR
  21094. ><TD
  21095. ><PRE
  21096. CLASS="php"
  21097. >$a = 1;
  21098. $b = 2;
  21099.  
  21100. function Sum()
  21101. {
  21102.     global $a, $b;
  21103.  
  21104.     $b = $a + $b;
  21105. } 
  21106.  
  21107. Sum();
  21108. echo $b;</PRE
  21109. ></TD
  21110. ></TR
  21111. ></TABLE
  21112. ><P
  21113. ></P
  21114. ></DIV
  21115. ><P
  21116. >     V²╣e uveden² skript vytiskne "3". Deklaracφ
  21117.     <TT
  21118. CLASS="varname"
  21119. >$a</TT
  21120. > a <TT
  21121. CLASS="varname"
  21122. >$b</TT
  21123. > ve funkci jako globßlnφch
  21124.     prom∞nn²ch se dosßhne toho, ╛e p°i odkazovßnφ na prom∞nnΘ se pracuje
  21125.     s jejich globßlnφ verzφ. PoΦet globßlnφch prom∞nn²ch, se kter²mi lze ve
  21126.     funkci manipulovat, nenφ omezen.
  21127.    </P
  21128. ><P
  21129. >     Druh²m zp∙sobem, jak p°istupovat k prom∞nn²m z globßlnφho kontextu, je
  21130.     pou╛itφ specißlnφho pole <TT
  21131. CLASS="varname"
  21132. >$GLOBALS</TT
  21133. >, definovanΘho
  21134.     v PHP. P°edchozφ p°φklad lze p°epsat:
  21135.    </P
  21136. ><DIV
  21137. CLASS="informalexample"
  21138. ><A
  21139. NAME="AEN4164"
  21140. ></A
  21141. ><P
  21142. ></P
  21143. ><TABLE
  21144. BORDER="0"
  21145. BGCOLOR="#E0E0E0"
  21146. CELLPADDING="5"
  21147. ><TR
  21148. ><TD
  21149. ><PRE
  21150. CLASS="php"
  21151. >$a = 1;
  21152. $b = 2;
  21153.  
  21154. function Sum()
  21155. {
  21156.     $GLOBALS["b"] = $GLOBALS["a"] + $GLOBALS["b"];
  21157. } 
  21158.  
  21159. Sum();
  21160. echo $b;</PRE
  21161. ></TD
  21162. ></TR
  21163. ></TABLE
  21164. ><P
  21165. ></P
  21166. ></DIV
  21167. ><P
  21168. >     Pole <TT
  21169. CLASS="varname"
  21170. >$GLOBALS</TT
  21171. > je asociativnφ pole s nßzvem globßlnφ
  21172.     prom∞nnΘ jako klφΦem a obsahem p°φslu╣nΘ prom∞nnΘ jako obsahem elementu
  21173.     pole.
  21174.    </P
  21175. ><P
  21176. >     Jinou d∙le╛itou vlastnostφ rozli╣ovßnφ kontext∙ prom∞nn²ch je mo╛nost
  21177.     pou╛φvßnφ <SPAN
  21178. CLASS="emphasis"
  21179. ><I
  21180. CLASS="emphasis"
  21181. >static</I
  21182. ></SPAN
  21183. > prom∞nn²ch. Statickß prom∞nnß
  21184.     existuje pouze v lokßlnφm kontextu funkce, ale neztrßcφ svoji hodnotu,
  21185.     pokud provßd∞nφ programu tento kontext opustφ. Uva╛ujme nßsledujφcφ
  21186.     p°φklad:
  21187.    </P
  21188. ><DIV
  21189. CLASS="informalexample"
  21190. ><A
  21191. NAME="AEN4170"
  21192. ></A
  21193. ><P
  21194. ></P
  21195. ><TABLE
  21196. BORDER="0"
  21197. BGCOLOR="#E0E0E0"
  21198. CELLPADDING="5"
  21199. ><TR
  21200. ><TD
  21201. ><PRE
  21202. CLASS="php"
  21203. >function Test ()
  21204. {
  21205.     $a = 0;
  21206.     echo $a;
  21207.     $a++;
  21208. }</PRE
  21209. ></TD
  21210. ></TR
  21211. ></TABLE
  21212. ><P
  21213. ></P
  21214. ></DIV
  21215. ><P
  21216. >     Tato funkce je pon∞kud neu╛iteΦnß, nebo╗ p°i ka╛dΘm volßnφ nastavuje
  21217.     <TT
  21218. CLASS="varname"
  21219. >$a</TT
  21220. > na <TT
  21221. CLASS="literal"
  21222. >0</TT
  21223. > a tiskne "0".
  21224.     Konstrukt <TT
  21225. CLASS="varname"
  21226. >$a</TT
  21227. >++, kter² inkrementuje prom∞nnou, nemß
  21228.     ╛ßdn² v²znam, proto╛e p°i skonΦenφ vykonßvßnφ funkce se obsah prom∞nnΘ    
  21229.     <TT
  21230. CLASS="varname"
  21231. >$a</TT
  21232. > ztrßcφ. Aby m∞la funkce skuteΦn² v²znam ΦφtaΦe a
  21233.     hodnota se neztrßcela, deklaruje se prom∞nnß <TT
  21234. CLASS="varname"
  21235. >$a</TT
  21236. >
  21237.     jako statickß:
  21238.    </P
  21239. ><DIV
  21240. CLASS="informalexample"
  21241. ><A
  21242. NAME="AEN4178"
  21243. ></A
  21244. ><P
  21245. ></P
  21246. ><TABLE
  21247. BORDER="0"
  21248. BGCOLOR="#E0E0E0"
  21249. CELLPADDING="5"
  21250. ><TR
  21251. ><TD
  21252. ><PRE
  21253. CLASS="php"
  21254. >function Test()
  21255. {
  21256.     static $a = 0;
  21257.     echo $a;
  21258.     $a++;
  21259. }</PRE
  21260. ></TD
  21261. ></TR
  21262. ></TABLE
  21263. ><P
  21264. ></P
  21265. ></DIV
  21266. ><P
  21267. >     Nynφ se p°i ka╛dΘm volßnφ funkce Test() vytiskne hodnota prom∞nnΘ
  21268.     <TT
  21269. CLASS="varname"
  21270. >$a</TT
  21271. > a inkrementuje se.
  21272.    </P
  21273. ><P
  21274. >     StatickΘ prom∞nnΘ takΘ poskytujφ zp∙sob, jak °e╣it rekurzφvnφ funkce.
  21275.     Rekurzφvnφ funkce je takovß funkce, kterß volß sama sebe. Psanφ
  21276.     rekurzφvnφch funkcφ je t°eba v∞novat zvlß╣tnφ pΘΦi, proto╛e m∙╛e vzniknout
  21277.     nekoneΦn² cyklus volßnφ. Musφte se ujistit, ╛e mßte rekurzi adekvßtn∞
  21278.     ukonΦenu. Nßsledujφcφ jednoduchß funkce rekurzφvn∞ poΦφtß do 10 za pou╛itφ
  21279.     statickΘ prom∞nnΘ <TT
  21280. CLASS="varname"
  21281. >$count</TT
  21282. > ke zji╣t∞nφ okam╛iku pro
  21283.     ukonΦenφ:
  21284.    </P
  21285. ><DIV
  21286. CLASS="informalexample"
  21287. ><A
  21288. NAME="AEN4184"
  21289. ></A
  21290. ><P
  21291. ></P
  21292. ><TABLE
  21293. BORDER="0"
  21294. BGCOLOR="#E0E0E0"
  21295. CELLPADDING="5"
  21296. ><TR
  21297. ><TD
  21298. ><PRE
  21299. CLASS="php"
  21300. >function Test()
  21301. {
  21302.     static $count = 0;
  21303.  
  21304.     $count++;
  21305.     echo $count;
  21306.     if ($count < 10) {
  21307.         Test ();
  21308.     }
  21309.     $count--;
  21310. }</PRE
  21311. ></TD
  21312. ></TR
  21313. ></TABLE
  21314. ><P
  21315. ></P
  21316. ></DIV
  21317. ></DIV
  21318. ><DIV
  21319. CLASS="sect1"
  21320. ><HR><H2
  21321. CLASS="sect1"
  21322. ><A
  21323. NAME="language.variables.variable"
  21324. ></A
  21325. >Prom∞nnΘ s prom∞nn²mi nßzvy</H2
  21326. ><P
  21327. >     N∞kdy je vhodnΘ, aby se nßzvy prom∞nn²ch mohly m∞nit, tj. aby mohly b²t
  21328.     dynamicky nastavovßny a pou╛φvßny. Normßlnφ prom∞nnß se nastavuje
  21329.     takov²mto konstruktem:
  21330.    </P
  21331. ><DIV
  21332. CLASS="informalexample"
  21333. ><A
  21334. NAME="AEN4189"
  21335. ></A
  21336. ><P
  21337. ></P
  21338. ><TABLE
  21339. BORDER="0"
  21340. BGCOLOR="#E0E0E0"
  21341. CELLPADDING="5"
  21342. ><TR
  21343. ><TD
  21344. ><PRE
  21345. CLASS="php"
  21346. >$a = "ahoj";</PRE
  21347. ></TD
  21348. ></TR
  21349. ></TABLE
  21350. ><P
  21351. ></P
  21352. ></DIV
  21353. ><P
  21354. >     Prom∞nnß s prom∞nn²m nßzvem vezme hodnotu prom∞nnΘ a pou╛ije ji jako
  21355.     nßzev prom∞nnΘ. Ve v²╣e uvedenΘm p°φkladu,
  21356.     <SPAN
  21357. CLASS="emphasis"
  21358. ><I
  21359. CLASS="emphasis"
  21360. >ahoj</I
  21361. ></SPAN
  21362. > lze pou╛φt jako nßzev prom∞nnΘ uvedenφm dvou
  21363.     symbol∙ dolaru:
  21364.    </P
  21365. ><DIV
  21366. CLASS="informalexample"
  21367. ><A
  21368. NAME="AEN4193"
  21369. ></A
  21370. ><P
  21371. ></P
  21372. ><TABLE
  21373. BORDER="0"
  21374. BGCOLOR="#E0E0E0"
  21375. CELLPADDING="5"
  21376. ><TR
  21377. ><TD
  21378. ><PRE
  21379. CLASS="php"
  21380. >$$a = "sv∞te";</PRE
  21381. ></TD
  21382. ></TR
  21383. ></TABLE
  21384. ><P
  21385. ></P
  21386. ></DIV
  21387. ><P
  21388. >     V tΘto chvφli byly definovßny dv∞ prom∞nnΘ a byly ulo╛eny do stromu
  21389.     symbol∙ PHP: <TT
  21390. CLASS="varname"
  21391. >$a</TT
  21392. > s obsahem "ahoj" a
  21393.     <TT
  21394. CLASS="varname"
  21395. >$ahoj</TT
  21396. > s obsahem "sv∞te". Proto konstrukt:
  21397.    </P
  21398. ><DIV
  21399. CLASS="informalexample"
  21400. ><A
  21401. NAME="AEN4198"
  21402. ></A
  21403. ><P
  21404. ></P
  21405. ><TABLE
  21406. BORDER="0"
  21407. BGCOLOR="#E0E0E0"
  21408. CELLPADDING="5"
  21409. ><TR
  21410. ><TD
  21411. ><PRE
  21412. CLASS="php"
  21413. >echo "$a ${$a}";</PRE
  21414. ></TD
  21415. ></TR
  21416. ></TABLE
  21417. ><P
  21418. ></P
  21419. ></DIV
  21420. ><P
  21421. >     provede p°esn∞ totΘ╛ jako:
  21422.    </P
  21423. ><DIV
  21424. CLASS="informalexample"
  21425. ><A
  21426. NAME="AEN4201"
  21427. ></A
  21428. ><P
  21429. ></P
  21430. ><TABLE
  21431. BORDER="0"
  21432. BGCOLOR="#E0E0E0"
  21433. CELLPADDING="5"
  21434. ><TR
  21435. ><TD
  21436. ><PRE
  21437. CLASS="php"
  21438. >echo "$a $ahoj";</PRE
  21439. ></TD
  21440. ></TR
  21441. ></TABLE
  21442. ><P
  21443. ></P
  21444. ></DIV
  21445. ><P
  21446. >     tedy oba vyprodukujφ: <TT
  21447. CLASS="computeroutput"
  21448. >ahoj sv∞te</TT
  21449. >.
  21450.    </P
  21451. ><P
  21452. >     P°i pou╛itφ prom∞nn²ch s prom∞nn²mi nßzvy s poli musφte vy°e╣it problΘm
  21453.     vφceznaΦnosti. Tj. kdy╛ napφ╣ete
  21454.     <TT
  21455. CLASS="varname"
  21456. >$$a[1]</TT
  21457. >, parser pot°ebuje v∞d∞t, mßte-li na mysli pou╛itφ
  21458.     <TT
  21459. CLASS="varname"
  21460. >$a[1]</TT
  21461. > jako prom∞nnΘ nebo chcete <TT
  21462. CLASS="varname"
  21463. >$$a</TT
  21464. >
  21465.     jako prom∞nnou a potom index [1] v tΘto prom∞nnΘ. Syntaxe pro °e╣enφ
  21466.     tΘto vφceznaΦnosti je <TT
  21467. CLASS="varname"
  21468. >${$a[1]}</TT
  21469. > pro prvnφ p°φpad a
  21470.     <TT
  21471. CLASS="varname"
  21472. >${$a}[1]</TT
  21473. > pro druh².
  21474.    </P
  21475. ></DIV
  21476. ><DIV
  21477. CLASS="sect1"
  21478. ><HR><H2
  21479. CLASS="sect1"
  21480. ><A
  21481. NAME="language.variables.external"
  21482. ></A
  21483. >Promm∞nΘ zvenΦφ PHP</H2
  21484. ><DIV
  21485. CLASS="sect2"
  21486. ><H3
  21487. CLASS="sect2"
  21488. ><A
  21489. NAME="language.variables.external.form"
  21490. ></A
  21491. >HTML formulß°e (GET a POST)</H3
  21492. ><P
  21493. >      Kdy╛ se ode╣le formulß° do PHP skriptu, jakΘkoli prom∞nnΘ z tohoto
  21494.      formulß°e budou automaticky dostupnΘ v tomto skriptu.
  21495.      Je-li zapnuta konfiguraΦnφ volba
  21496.      <A
  21497. HREF="#ini.track-vars"
  21498. >track_vars</A
  21499. >, budou tyto prom∞nnΘ
  21500.      umφst∞ny v asociativnφch polφch
  21501.      <TT
  21502. CLASS="varname"
  21503. >$HTTP_POST_VARS</TT
  21504. >,
  21505.      <TT
  21506. CLASS="varname"
  21507. >$HTTP_GET_VARS</TT
  21508. >, a/nebo
  21509.      <TT
  21510. CLASS="varname"
  21511. >$HTTP_POST_FILES</TT
  21512. > v zßvislosti na zdroji prom∞nn²ch.
  21513.     </P
  21514. ><P
  21515. >      Pro vφce informacφ o t∞chto prom∞nn²ch si laskav∞ p°eΦt∞te <A
  21516. HREF="#language.variables.predefined"
  21517. >P°eddefinovanΘ prom∞nnΘ</A
  21518. >.
  21519.     </P
  21520. ><P
  21521. >      <TABLE
  21522. WIDTH="100%"
  21523. BORDER="0"
  21524. CELLPADDING="0"
  21525. CELLSPACING="0"
  21526. CLASS="EXAMPLE"
  21527. ><TR
  21528. ><TD
  21529. ><DIV
  21530. CLASS="example"
  21531. ><A
  21532. NAME="AEN4223"
  21533. ></A
  21534. ><P
  21535. ><B
  21536. >P°φklad 7-1. Jednoduchß prom∞nnß formulß°e</B
  21537. ></P
  21538. ><TABLE
  21539. BORDER="0"
  21540. BGCOLOR="#E0E0E0"
  21541. CELLPADDING="5"
  21542. ><TR
  21543. ><TD
  21544. ><PRE
  21545. CLASS="php"
  21546. ><form action="foo.php" method="post">
  21547.     Name: <input type="text" name="username"><br>
  21548.     <input type="submit">
  21549. </form></PRE
  21550. ></TD
  21551. ></TR
  21552. ></TABLE
  21553. ></DIV
  21554. ></TD
  21555. ></TR
  21556. ></TABLE
  21557. >
  21558.     </P
  21559. ><P
  21560. >      Kdy╛ se v²╣e uveden² formulß° ode╣le, hodnota vstupnφho textu bude
  21561.      dostupnß v <TT
  21562. CLASS="varname"
  21563. >$HTTP_POST_VARS['username']</TT
  21564. >. Je-li
  21565.      zapnuta konfiguraΦnφ direktiva
  21566.      <A
  21567. HREF="#ini.register-globals"
  21568. >register_globals</A
  21569. >,
  21570.      prom∞nnß bude dostupnß i jako <TT
  21571. CLASS="varname"
  21572. >$username</TT
  21573. > v globßlnφm
  21574.      kontextu.
  21575.     </P
  21576. ><DIV
  21577. CLASS="note"
  21578. ><BLOCKQUOTE
  21579. CLASS="note"
  21580. ><P
  21581. ><B
  21582. >Poznßmka: </B
  21583. >
  21584.       The <A
  21585. HREF="#ini.magic-quotes-gpc"
  21586. >magic_quotes_gpc</A
  21587. > 
  21588.       configuration directive affects Get, Post and Cookie values.  If 
  21589.       turned on, value (It's "PHP!") will automagically become (It\'s \"PHP!\").
  21590.       Escaping is needed for DB insertion.  Also see
  21591.       <A
  21592. HREF="#function.addslashes"
  21593. ><B
  21594. CLASS="function"
  21595. >addslashes()</B
  21596. ></A
  21597. >, <A
  21598. HREF="#function.stripslashes"
  21599. ><B
  21600. CLASS="function"
  21601. >stripslashes()</B
  21602. ></A
  21603. > and 
  21604.       <A
  21605. HREF="#ini.magic-quotes-sybase"
  21606. >magic_quotes_sybase</A
  21607. >.
  21608.      </P
  21609. ></BLOCKQUOTE
  21610. ></DIV
  21611. ><P
  21612. >      PHP also understands arrays in the context of form variables 
  21613.      (see the <A
  21614. HREF="#faq.html"
  21615. >related faq</A
  21616. >).  You may, 
  21617.      for example, group related variables together, or use this 
  21618.      feature to retrieve values from a multiple select input:
  21619.     </P
  21620. ><P
  21621. >      <TABLE
  21622. WIDTH="100%"
  21623. BORDER="0"
  21624. CELLPADDING="0"
  21625. CELLSPACING="0"
  21626. CLASS="EXAMPLE"
  21627. ><TR
  21628. ><TD
  21629. ><DIV
  21630. CLASS="example"
  21631. ><A
  21632. NAME="AEN4239"
  21633. ></A
  21634. ><P
  21635. ><B
  21636. >P°φklad 7-2. More complex form variables</B
  21637. ></P
  21638. ><TABLE
  21639. BORDER="0"
  21640. BGCOLOR="#E0E0E0"
  21641. CELLPADDING="5"
  21642. ><TR
  21643. ><TD
  21644. ><PRE
  21645. CLASS="php"
  21646. ><form action="array.php" method="post">
  21647.     Name: <input type="text" name="personal[name]"><br>
  21648.     Email: <input type="text" name="personal[email]"><br>
  21649.     Beer: <br>
  21650.     <select multiple name="beer[]">
  21651.         <option value="warthog">Warthog
  21652.         <option value="guinness">Guinness
  21653.         <option value="stuttgarter">Stuttgarter SchwabenbrΣu
  21654.         </select>
  21655.     <input type="submit">
  21656. </form></PRE
  21657. ></TD
  21658. ></TR
  21659. ></TABLE
  21660. ></DIV
  21661. ></TD
  21662. ></TR
  21663. ></TABLE
  21664. >
  21665.     </P
  21666. ><P
  21667. >      In PHP 3, the array form variable usage is limited to
  21668.      single-dimensional arrays. In PHP 4, no such restriction applies.
  21669.     </P
  21670. ><DIV
  21671. CLASS="sect3"
  21672. ><HR><H4
  21673. CLASS="sect3"
  21674. ><A
  21675. NAME="language.variables.external.form.submit"
  21676. ></A
  21677. >IMAGE SUBMIT variable names</H4
  21678. ><P
  21679. >       When submitting a form, it is possible to use an image instead
  21680.       of the standard submit button with a tag like:</P
  21681. ><DIV
  21682. CLASS="informalexample"
  21683. ><A
  21684. NAME="AEN4246"
  21685. ></A
  21686. ><P
  21687. ></P
  21688. ><TABLE
  21689. BORDER="0"
  21690. BGCOLOR="#E0E0E0"
  21691. CELLPADDING="5"
  21692. ><TR
  21693. ><TD
  21694. ><PRE
  21695. CLASS="php"
  21696. ><input type="image" src="image.gif" name="sub"></PRE
  21697. ></TD
  21698. ></TR
  21699. ></TABLE
  21700. ><P
  21701. ></P
  21702. ></DIV
  21703. ><P
  21704. >       When the user clicks somewhere on the image, the accompanying
  21705.       form will be transmitted to the server with two additional
  21706.       variables, sub_x and sub_y. These contain the coordinates of the
  21707.       user click within the image.  The experienced may note that the
  21708.       actual variable names sent by the browser contains a period
  21709.       rather than an underscore, but PHP converts the period to an
  21710.       underscore automatically.
  21711.      </P
  21712. ></DIV
  21713. ></DIV
  21714. ><DIV
  21715. CLASS="sect2"
  21716. ><HR><H3
  21717. CLASS="sect2"
  21718. ><A
  21719. NAME="language.variables.external.cookies"
  21720. ></A
  21721. >HTTP Cookies</H3
  21722. ><P
  21723. >      PHP transparently supports HTTP cookies as defined by <A
  21724. HREF="http://www.netscape.com/newsref/std/cookie_spec.html"
  21725. TARGET="_top"
  21726. >Netscape's Spec</A
  21727. >.  Cookies are a
  21728.      mechanism for storing data in the remote browser and thus
  21729.      tracking or identifying return users.  You can set cookies using
  21730.      the <A
  21731. HREF="#function.setcookie"
  21732. ><B
  21733. CLASS="function"
  21734. >setcookie()</B
  21735. ></A
  21736. > function.  Cookies are part of
  21737.      the HTTP header, so the SetCookie function must be called before
  21738.      any output is sent to the browser.  This is the same restriction
  21739.      as for the <A
  21740. HREF="#function.header"
  21741. ><B
  21742. CLASS="function"
  21743. >header()</B
  21744. ></A
  21745. > function.  Any cookies
  21746.      sent to you from the client will automatically be turned into a
  21747.      PHP variable just like GET and POST method data.</P
  21748. ><P
  21749. >      If you wish to assign multiple values to a single cookie, just
  21750.      add <SPAN
  21751. CLASS="emphasis"
  21752. ><I
  21753. CLASS="emphasis"
  21754. >[]</I
  21755. ></SPAN
  21756. > to the cookie name.  For
  21757.      example:
  21758.     </P
  21759. ><DIV
  21760. CLASS="informalexample"
  21761. ><A
  21762. NAME="AEN4257"
  21763. ></A
  21764. ><P
  21765. ></P
  21766. ><TABLE
  21767. BORDER="0"
  21768. BGCOLOR="#E0E0E0"
  21769. CELLPADDING="5"
  21770. ><TR
  21771. ><TD
  21772. ><PRE
  21773. CLASS="php"
  21774. >setcookie("MyCookie[]", "Testing", time()+3600);</PRE
  21775. ></TD
  21776. ></TR
  21777. ></TABLE
  21778. ><P
  21779. ></P
  21780. ></DIV
  21781. ><P
  21782. >      Note that a cookie will replace a previous cookie by the same
  21783.      name in your browser unless the path or domain is different.  So,
  21784.      for a shopping cart application you may want to keep a counter
  21785.      and pass this along.  i.e.
  21786.     </P
  21787. ><TABLE
  21788. WIDTH="100%"
  21789. BORDER="0"
  21790. CELLPADDING="0"
  21791. CELLSPACING="0"
  21792. CLASS="EXAMPLE"
  21793. ><TR
  21794. ><TD
  21795. ><DIV
  21796. CLASS="example"
  21797. ><A
  21798. NAME="AEN4260"
  21799. ></A
  21800. ><P
  21801. ><B
  21802. >P°φklad 7-3. SetCookie Example</B
  21803. ></P
  21804. ><TABLE
  21805. BORDER="0"
  21806. BGCOLOR="#E0E0E0"
  21807. CELLPADDING="5"
  21808. ><TR
  21809. ><TD
  21810. ><PRE
  21811. CLASS="php"
  21812. >$Count++;
  21813. setcookie("Count", $Count, time()+3600);
  21814. setcookie("Cart[$Count]", $item, time()+3600);</PRE
  21815. ></TD
  21816. ></TR
  21817. ></TABLE
  21818. ></DIV
  21819. ></TD
  21820. ></TR
  21821. ></TABLE
  21822. ></DIV
  21823. ><DIV
  21824. CLASS="sect2"
  21825. ><HR><H3
  21826. CLASS="sect2"
  21827. ><A
  21828. NAME="language.variables.external.environment"
  21829. ></A
  21830. >Environment variables</H3
  21831. ><P
  21832. >      PHP automatically makes environment variables available as normal
  21833.      PHP variables.
  21834.      
  21835.      <DIV
  21836. CLASS="informalexample"
  21837. ><A
  21838. NAME="AEN4266"
  21839. ></A
  21840. ><P
  21841. ></P
  21842. ><TABLE
  21843. BORDER="0"
  21844. BGCOLOR="#E0E0E0"
  21845. CELLPADDING="5"
  21846. ><TR
  21847. ><TD
  21848. ><PRE
  21849. CLASS="php"
  21850. >echo $HOME;  /* Shows the HOME environment variable, if set. */</PRE
  21851. ></TD
  21852. ></TR
  21853. ></TABLE
  21854. ><P
  21855. ></P
  21856. ></DIV
  21857. >
  21858.     </P
  21859. ><P
  21860. >      Since information coming in via GET, POST and Cookie mechanisms
  21861.      also automatically create PHP variables, it is sometimes best to
  21862.      explicitly read a variable from the environment in order to make
  21863.      sure that you are getting the right version.  The
  21864.      <A
  21865. HREF="#function.getenv"
  21866. ><B
  21867. CLASS="function"
  21868. >getenv()</B
  21869. ></A
  21870. > function can be used for this.  You
  21871.      can also set an environment variable with the
  21872.      <A
  21873. HREF="#function.putenv"
  21874. ><B
  21875. CLASS="function"
  21876. >putenv()</B
  21877. ></A
  21878. > function.
  21879.     </P
  21880. ></DIV
  21881. ><DIV
  21882. CLASS="sect2"
  21883. ><HR><H3
  21884. CLASS="sect2"
  21885. ><A
  21886. NAME="language.variables.external.dot-in-names"
  21887. ></A
  21888. >Dots in incoming variable names</H3
  21889. ><P
  21890. >      Typically, PHP does not alter the names of variables when they
  21891.      are passed into a script. However, it should be noted that the
  21892.      dot (period, full stop) is not a valid character in a PHP
  21893.      variable name. For the reason, look at it:
  21894.      <TABLE
  21895. BORDER="0"
  21896. BGCOLOR="#E0E0E0"
  21897. CELLPADDING="5"
  21898. ><TR
  21899. ><TD
  21900. ><PRE
  21901. CLASS="php"
  21902. >$varname.ext;  /* invalid variable name */</PRE
  21903. ></TD
  21904. ></TR
  21905. ></TABLE
  21906. >
  21907.      Now, what the parser sees is a variable named
  21908.      <TT
  21909. CLASS="varname"
  21910. >$varname</TT
  21911. >, followed by the string concatenation
  21912.      operator, followed by the barestring (i.e. unquoted string which
  21913.      doesn't match any known key or reserved words) 'ext'. Obviously,
  21914.      this doesn't have the intended result.
  21915.     </P
  21916. ><P
  21917. >      For this reason, it is important to note that PHP will
  21918.      automatically replace any dots in incoming variable names with
  21919.      underscores.
  21920.     </P
  21921. ></DIV
  21922. ><DIV
  21923. CLASS="sect2"
  21924. ><HR><H3
  21925. CLASS="sect2"
  21926. ><A
  21927. NAME="language.variables.determining-type-of"
  21928. ></A
  21929. >Determining variable types</H3
  21930. ><P
  21931. >      Because PHP determines the types of variables and converts them
  21932.      (generally) as needed, it is not always obvious what type a given
  21933.      variable is at any one time.  PHP includes several functions
  21934.      which find out what type a variable is. They are
  21935.      <A
  21936. HREF="#function.gettype"
  21937. ><B
  21938. CLASS="function"
  21939. >gettype()</B
  21940. ></A
  21941. >, <A
  21942. HREF="#function.is-array"
  21943. ><B
  21944. CLASS="function"
  21945. >is_array()</B
  21946. ></A
  21947. >,
  21948.      <A
  21949. HREF="#function.is-float"
  21950. ><B
  21951. CLASS="function"
  21952. >is_float()</B
  21953. ></A
  21954. >, <A
  21955. HREF="#function.is-int"
  21956. ><B
  21957. CLASS="function"
  21958. >is_int()</B
  21959. ></A
  21960. >,
  21961.      <A
  21962. HREF="#function.is-object"
  21963. ><B
  21964. CLASS="function"
  21965. >is_object()</B
  21966. ></A
  21967. >, and
  21968.      <A
  21969. HREF="#function.is-string"
  21970. ><B
  21971. CLASS="function"
  21972. >is_string()</B
  21973. ></A
  21974. >.
  21975.     </P
  21976. ></DIV
  21977. ></DIV
  21978. ></DIV
  21979. ><DIV
  21980. CLASS="chapter"
  21981. ><HR><H1
  21982. ><A
  21983. NAME="language.constants"
  21984. >Kapitola 8. Konstanty</A
  21985. ></H1
  21986. ><P
  21987. >   PHP definuje n∞kolik konstant a poskytuje mechanismus pro definici dal╣φch
  21988.   za b∞hu. Konstanty se hodn∞ podobajφ prom∞nn²m s v²jimkou dvou skuteΦnostφ:
  21989.   konstanty se musφ definovat pomocφ funkce <A
  21990. HREF="#function.define"
  21991. ><B
  21992. CLASS="function"
  21993. >define()</B
  21994. ></A
  21995. >, a
  21996.   nemohou pozd∞ji nab²vat jin²ch hodnot.
  21997.   </P
  21998. ><P
  21999. >   P°eddefinovanΘ konstanty (dostupnΘ v╛dy) jsou:
  22000.  
  22001.    <P
  22002. ></P
  22003. ><DIV
  22004. CLASS="variablelist"
  22005. ><DL
  22006. ><DT
  22007. >__FILE__</DT
  22008. ><DD
  22009. ><P
  22010. >       Nßzev souboru skriptu, kter² je prßv∞ Φten. Pokud je pou╛ita v souboru,
  22011.       kter² byl vlo╛en pomocφ "include" nebo "require", obsahuje nßzev vlo╛enΘho
  22012.       souboru, nikoli rodiΦovskΘho.
  22013.       </P
  22014. ></DD
  22015. ><DT
  22016. >__LINE__</DT
  22017. ><DD
  22018. ><P
  22019. >       ╚φslo °ßdku ve skriptu, kter² je prßv∞ Φten. Pokud je pou╛ita v
  22020.       souboru vlo╛enΘho pomocφ "include" nebo "require", obsahuje pozici
  22021.       v rßmci tohoto souboru.
  22022.       </P
  22023. ></DD
  22024. ><DT
  22025. >PHP_VERSION</DT
  22026. ><DD
  22027. ><P
  22028. >       TextovΘ vyjßd°enφ verze b∞╛φcφho PHP parseru, nap°. '3.0.8-dev'.
  22029.       </P
  22030. ></DD
  22031. ><DT
  22032. >PHP_OS</DT
  22033. ><DD
  22034. ><P
  22035. >       Nßzev operaΦnφho systΘmu, na kterΘm PHP parser b∞╛φ, nap°. 'Linux'.
  22036.       </P
  22037. ></DD
  22038. ><DT
  22039. ><TT
  22040. CLASS="constant"
  22041. ><B
  22042. >TRUE</B
  22043. ></TT
  22044. ></DT
  22045. ><DD
  22046. ><P
  22047. >        Pravdivß hodnota (logickß jedniΦka).
  22048.       </P
  22049. ></DD
  22050. ><DT
  22051. ><TT
  22052. CLASS="constant"
  22053. ><B
  22054. >FALSE</B
  22055. ></TT
  22056. ></DT
  22057. ><DD
  22058. ><P
  22059. >        Nepravdivß hodnota (logickß nula).
  22060.       </P
  22061. ></DD
  22062. ><DT
  22063. >E_ERROR</DT
  22064. ><DD
  22065. ><P
  22066. >       OznaΦuje neo╣et°itelnou chybu jinou ne╛ "parse error".
  22067.       </P
  22068. ></DD
  22069. ><DT
  22070. >E_WARNING</DT
  22071. ><DD
  22072. ><P
  22073. >       OznaΦuje stav, kdy PHP vφ, ╛e je n∞co ╣patn∞, ale bude dßl pokraΦovat.
  22074.       Tyto stavy se dajφ o╣et°it v samotnΘm skriptu. P°φkladem by byl neplatn²
  22075.       "regexp" (regulßrnφ v²raz) ve funkci <A
  22076. HREF="#function.ereg"
  22077. ><B
  22078. CLASS="function"
  22079. >ereg()</B
  22080. ></A
  22081. >.
  22082.       </P
  22083. ></DD
  22084. ><DT
  22085. >E_PARSE</DT
  22086. ><DD
  22087. ><P
  22088. >       Chyba p°i syntaktickΘ anal²ze skriptu (chybnß syntaxe). O╣et°enφ nenφ mo╛nΘ.
  22089.       </P
  22090. ></DD
  22091. ><DT
  22092. >E_NOTICE</DT
  22093. ><DD
  22094. ><P
  22095. >       Do╣lo k n∞Φemu, co by mohlo b²t chybou. Provßd∞nφ skriptu pokraΦuje.
  22096.       Mezi p°φklady pat°φ textov² index pole neopat°en² uvozovkami nebo prßce
  22097.       s prom∞nnou, kterß je╣t∞ nebyla definovßna.
  22098.       </P
  22099. ></DD
  22100. ><DT
  22101. >E_ALL</DT
  22102. ><DD
  22103. ><P
  22104. >       V╣echny E_* konstanty shrnutΘ do jednΘ. P°i pou╛itφ s funkcφ
  22105.        <A
  22106. HREF="#function.error-reporting"
  22107. ><B
  22108. CLASS="function"
  22109. >error_reporting()</B
  22110. ></A
  22111. > zp∙sobφ hlß╣enφ ·pln∞ v╣ech
  22112.        problΘmu zaregistrovan²ch PHP.
  22113.       </P
  22114. ></DD
  22115. ></DL
  22116. ></DIV
  22117. >
  22118.   </P
  22119. ><P
  22120. >    E_* konstanty se typicky pou╛φvajφ s funkcφ
  22121.    <A
  22122. HREF="#function.error-reporting"
  22123. ><B
  22124. CLASS="function"
  22125. >error_reporting()</B
  22126. ></A
  22127. > nastavenφ hladiny hlß╣enφ chyb. Viz
  22128.    v╣echny tyto konstanty v
  22129.    <A
  22130. HREF="#features.error-handling"
  22131. >O╣et°enφ chyb</A
  22132. >.
  22133.    </P
  22134. ><P
  22135. >    Dal╣φ konstanty m∙╛ete definovat pomocφ funkce
  22136.    <A
  22137. HREF="#function.define"
  22138. ><B
  22139. CLASS="function"
  22140. >define()</B
  22141. ></A
  22142. >.
  22143.    </P
  22144. ><P
  22145. >    V╣imn∞te si, ╛e toto jsou konstanty, ne cΘΦkovskß makra; konstanty mohou
  22146.    reprezentovat pouze platnß skalßrnφ data.
  22147.  
  22148.     <TABLE
  22149. WIDTH="100%"
  22150. BORDER="0"
  22151. CELLPADDING="0"
  22152. CELLSPACING="0"
  22153. CLASS="EXAMPLE"
  22154. ><TR
  22155. ><TD
  22156. ><DIV
  22157. CLASS="example"
  22158. ><A
  22159. NAME="AEN4346"
  22160. ></A
  22161. ><P
  22162. ><B
  22163. >P°φklad 8-1. Definice konstant</B
  22164. ></P
  22165. ><TABLE
  22166. BORDER="0"
  22167. BGCOLOR="#E0E0E0"
  22168. CELLPADDING="5"
  22169. ><TR
  22170. ><TD
  22171. ><PRE
  22172. CLASS="programlisting"
  22173. ><?php
  22174. define("CONSTANT", "Hello world.");
  22175. echo CONSTANT; // vytiskne "Hello world."
  22176. ?></PRE
  22177. ></TD
  22178. ></TR
  22179. ></TABLE
  22180. ></DIV
  22181. ></TD
  22182. ></TR
  22183. ></TABLE
  22184. >
  22185.  
  22186.     <TABLE
  22187. WIDTH="100%"
  22188. BORDER="0"
  22189. CELLPADDING="0"
  22190. CELLSPACING="0"
  22191. CLASS="EXAMPLE"
  22192. ><TR
  22193. ><TD
  22194. ><DIV
  22195. CLASS="example"
  22196. ><A
  22197. NAME="AEN4349"
  22198. ></A
  22199. ><P
  22200. ><B
  22201. >P°φklad 8-2. Pou╛itφ __FILE__ a __LINE__</B
  22202. ></P
  22203. ><TABLE
  22204. BORDER="0"
  22205. BGCOLOR="#E0E0E0"
  22206. CELLPADDING="5"
  22207. ><TR
  22208. ><TD
  22209. ><PRE
  22210. CLASS="programlisting"
  22211. ><?php
  22212. function report_error($file, $line, $message) {
  22213.     echo "Do╣lo k chyb∞ v souboru $file na °ßdku $line: $message.";
  22214. }
  22215.  
  22216. report_error(__FILE__,__LINE__, "N∞co je ╣patn∞!");
  22217. ?></PRE
  22218. ></TD
  22219. ></TR
  22220. ></TABLE
  22221. ></DIV
  22222. ></TD
  22223. ></TR
  22224. ></TABLE
  22225. ></P
  22226. ></DIV
  22227. ><DIV
  22228. CLASS="chapter"
  22229. ><HR><H1
  22230. ><A
  22231. NAME="language.expressions"
  22232. >Kapitola 9. V²razy</A
  22233. ></H1
  22234. ><P
  22235. >     V²razy jsou nejd∙le╛it∞j╣φmi stavebnφmi kameny PHP. V PHP je tΘm∞° v╣e,
  22236.     co napφ╣ete, v²raz. Nejjednodu╣╣φ, a p°ece nejp°esn∞j╣φ definicφ v²razu je
  22237.     "v╣echno, co mß hodnotu".
  22238.    </P
  22239. ><P
  22240. >     Nejzßkladn∞j╣φmi formami v²raz∙ jsou konstanty a prom∞nnΘ. Kdy╛ napφ╣ete
  22241.     "$a = 5", p°i°azujete '5' do $a.  '5' mß, pochopiteln∞, hodnotu 5, nebo
  22242.     jin²mi slovy, '5' je v²raz s hodnotou 5 (v tomto p°φpad∞ je '5'
  22243.     celoΦφselnou konstantou).
  22244.    </P
  22245. ><P
  22246. >     Po tomto p°i°azenφ budete oΦekßvat, ╛e hodnota $a bude 5, tak╛e kdybyste
  22247.     napsali $b = $a, oΦekßvali byste totΘ╛, jako p°i napsßnφ $b = 5. Jin²mi
  22248.     slovy, $a je tedy v²raz s hodnotou 5.  Pokud v╣e pracuje sprßvn∞,
  22249.     p°esn∞ to se takΘ stane.
  22250.    </P
  22251. ><P
  22252. >     O n∞co slo╛it∞j╣φm p°φkladem v²raz∙ jsou funkce. Uva╛ujme nap°. tuto
  22253.     funkci:
  22254.  
  22255.     <DIV
  22256. CLASS="informalexample"
  22257. ><A
  22258. NAME="AEN4358"
  22259. ></A
  22260. ><P
  22261. ></P
  22262. ><TABLE
  22263. BORDER="0"
  22264. BGCOLOR="#E0E0E0"
  22265. CELLPADDING="5"
  22266. ><TR
  22267. ><TD
  22268. ><PRE
  22269. CLASS="php"
  22270. >function foo ()
  22271. {
  22272.     return 5;
  22273. }</PRE
  22274. ></TD
  22275. ></TR
  22276. ></TABLE
  22277. ><P
  22278. ></P
  22279. ></DIV
  22280. ></P
  22281. ><P
  22282. >     Za p°edpokladu, ╛e jste dob°e seznßmeni s konceptem funkcφ (pokud ne,
  22283.     nahlΘdn∞te do kapitoly o funkcφch), byste p°edpoklßdali, ╛e napsßnφ
  22284.     <TT
  22285. CLASS="literal"
  22286. >$c = foo()</TT
  22287. > je v zßsad∞ totΘ╛ jako
  22288.     <TT
  22289. CLASS="literal"
  22290. >$c = 5</TT
  22291. >, a mßte pravdu. Funkce jsou v²razy s hodnotou
  22292.     jejich nßvratovΘ hodnoty. Funkce foo() vracφ 5, tudφ╛ hodnota v²razu
  22293.     'foo()' je 5. Obvykle funkce nevracejφ konstantnφ hodnotu, n²br╛ n∞co
  22294.     vypoΦφtßvajφ.
  22295.    </P
  22296. ><P
  22297. >     Hodnoty v PHP samoz°ejm∞ nemusejφ b²t pouze celß Φφsla, a velmi Φasto
  22298.     takΘ nejsou. PHP podporuje t°i typy skalßrnφch hodnot: celoΦφselnΘ,
  22299.     reßlnΘ (pohyblivß °ßdovß Φßrka) a °et∞zce (skalßrnφ hodnoty jsou hodnoty,
  22300.     kterΘ nejde "rozbφt" na men╣φ Φßsti, narozdφl nap°. od polφ). PHP
  22301.     podporuje takΘ dva kompozitnφ (neskalßrnφ) typy: pole a objekty. Ka╛d²
  22302.     z t∞chto typ∙ hodnot m∙╛e b²t p°i°azen do prom∞nnΘ nebo vracen z funkce.
  22303.    </P
  22304. ><P
  22305. >     U╛ivatelΘ PHP/FI 2 by nem∞li pocφtit zm∞nu. Ale PHP jde ve v²razech
  22306.     mnohem dßle, stejn∞ jako mnoho jin²ch programovacφch jazyk∙. PHP je
  22307.     v²razov∞ orientovan² jazyk, ve smyslu, ╛e tΘm∞° v╣e je v²raz. Uva╛ujme
  22308.     p°φklad, kter²m jsme se ji╛ zab²vali, '$a = 5'. Ihned vidφme, ╛e jsou
  22309.     zde zahrnuty dv∞ hodnoty, celoΦφselnß konstanta '5' a hodnota $a,
  22310.     kterß je aktualizovßna na 5. Ale je pravda, ╛e je tu je╣t∞ jedna hodnota,
  22311.     je to hodnota samotnΘho p°i°azenφ. P°i°azenφ jako takovΘ ohodnocuje
  22312.     p°i°azovanou hodnotu, v tomto p°φpad∞ 5. V praxi to znamenß, ╛e '$a = 5',
  22313.     bez ohledu na to co d∞lß, je v²raz s hodnotou 5. Proto je '$b = ($a = 5)'
  22314.     totΘ╛ jako '$a = 5; $b = 5;' (st°ednφk oznaΦuje konec v²razu). Proto╛e
  22315.     p°i°ezenφ jsou parsovßna zprava doleva, m∙╛ete takΘ napsat
  22316.     '$b = $a = 5'.
  22317.    </P
  22318. ><P
  22319. >     Jin²m dobr²m p°φkladem orientace na v²razy je pre- a post-inkrementace
  22320.     a dekrementace. U╛ivatelΘ PHP/FI 2 a mnoha jin²ch jazyk∙ znajφ notaci
  22321.     prom∞nnß++ a prom∞nnß--. To jsou inkrementaΦnφ a dekrementaΦnφ operßtory.
  22322.     V PHP/FI 2 nem∞lo '$a++' ╛ßdnou hodnotu (nenφ to v²raz), a proto ne╣lo
  22323.     p°i°adit nebo jinak pou╛φt. PHP roz╣i°uje schopnosti p°em∞nou t∞chto
  22324.     konstrukcφ ve v²razy, jako v C. V PHP, stejn∞ jako v C, existujφ dva typy
  22325.     inkrementace - pre-inkrementace a post-inkrementace. Oba ve svΘ podstat∞
  22326.     inkrementujφ prom∞nnou a efekt na tuto prom∞nnou je toto╛n². Rozdφl je
  22327.     v hodnot∞ inkrementaΦnφho v²razu. Pre-inkrementace, zapsanß jako
  22328.     '++$var', ohodnocuje v²raz inkrementovanou hodnotou (PHP inkrementuje
  22329.     prom∞nnou d°φve, ne╛ p°eΦte jejφ hodnotu, proto "pre-inkrementace").
  22330.     Post-inkrementace, zapsanß jako '$var++', ohodnocuje v²raz p∙vodnφ
  22331.     hodnotou prom∞nnΘ $var, p°ed inkrementacφ (PHP inkrementuje prom∞nnou
  22332.     po p°eΦtenφ jejφ hodnoty, proto "post-inkrement").
  22333.    </P
  22334. ><P
  22335. >     Velmi Φast²m typem v²raz∙ jsou v²razy porovnßvacφ. Tyto v²razy se
  22336.     ohodnocujφ 0 a 1 ve v²znamu <TT
  22337. CLASS="constant"
  22338. ><B
  22339. >FALSE</B
  22340. ></TT
  22341. >, resp. <TT
  22342. CLASS="constant"
  22343. ><B
  22344. >TRUE</B
  22345. ></TT
  22346. >. PHP podporuje
  22347.     > (v∞t╣φ ne╛), >= (v∞t╣φ nebo rovno), == (rovnß se), != (nerovnß se),
  22348.     < (men╣φ ne╛) a <= (men╣φ nebo rovno). Tyto v²razy se nejΦast∞ji
  22349.     pou╛φvajφ v podmφnkßch, jako je konstrukt <TT
  22350. CLASS="literal"
  22351. >if</TT
  22352. >.
  22353.    </P
  22354. ><P
  22355. >     Poslednφm p°φkladem v²raz∙, kter²m se budeme zab²vat, je kombinacφ
  22356.     p°i°azenφ a operßtor∙. Ji╛ vφte, ╛e kdy╛ chcete inkrementovat $a o
  22357.     jedniΦku, jednodu╣e napφ╣ete '$a++' nebo '++$a'. Ale co kdy╛ chcete
  22358.     hodnotu zv²╣it o jinΘ Φφslo, nap°. o 3? Mohli byste napsat '$a++'
  22359.     vφckrßt za sebou, ale to samoz°ejm∞ nenφ efektivnφ ani pohodlnΘ.
  22360.     Mnohem praktiΦt∞j╣φ je napsat '$a = $a + 3'. V²raz '$a + 3' ohodnocuje
  22361.     hodnotu $a plus 3 a je p°i°azen zp∞t do $a, co╛ dßvß $a inkrementovanΘ
  22362.     o 3. V PHP, stejn∞ jako v °ad∞ jin²ch jazyk∙ (jako je C), to m∙╛ete
  22363.     napsat krat╣φm zp∙sobem, kter² se Φasem stane jasn∞j╣φ i rychlej╣φ
  22364.     k pochopenφ. P°iΦtenφ 3 k aktußlnφ hodnot∞ $a lze zapsat jako '$a += 3'.
  22365.     P°esn∞ to znamenß "vezmi hodnotu $a, p°iΦti k nφ 3 a p°i°a∩ zp∞t do $a".
  22366.     Krom∞ krat╣φho a p°ehledn∞j╣φho zßpisu je v²hodou takΘ rychlej╣φ provedenφ.
  22367.     Hodnota '$a += 3', jako hodnota regulΘrnφho p°i°azenφ, je p°i°azovanß
  22368.     hodnota. Uv∞domte si, ╛e to NEN═ 3, n²br╛ $a plus 3 (co╛ je hodnota
  22369.     v²razu p°i°azovanΘho do $a). Takto lze pou╛φt jak²koli binßrnφ operßtor,
  22370.     nap°φklad '$a -= 5' (odeΦti 5 od hodnoty $a), '$b *= 7' (vynßsob hodnotu
  22371.     $b Φφslem 7) apod.
  22372.    </P
  22373. ><P
  22374. >     Je tu je╣t∞ jeden v²raz, kter² se m∙╛e zdßt zvlß╣tnφ, pokud jste ho
  22375.     je╣t∞ nevid∞li v jin²ch jazycφch: ternßrnφ podmφn∞n² operßtor:
  22376.  
  22377.     <DIV
  22378. CLASS="informalexample"
  22379. ><A
  22380. NAME="AEN4372"
  22381. ></A
  22382. ><P
  22383. ></P
  22384. ><TABLE
  22385. BORDER="0"
  22386. BGCOLOR="#E0E0E0"
  22387. CELLPADDING="5"
  22388. ><TR
  22389. ><TD
  22390. ><PRE
  22391. CLASS="programlisting"
  22392. >$prvni ? $druhy : $treti</PRE
  22393. ></TD
  22394. ></TR
  22395. ></TABLE
  22396. ><P
  22397. ></P
  22398. ></DIV
  22399. >
  22400.  
  22401.     Pokud hodnota prvnφho podv²razu je <TT
  22402. CLASS="constant"
  22403. ><B
  22404. >TRUE</B
  22405. ></TT
  22406. > (nenulovß), je ohodnocen druh²
  22407.     podv²raz a je v²sledkem celΘho podmφn∞nΘho v²razu. Jinak je ohodnocen
  22408.     t°etφ podv²raz a je pak hodotou celΘho v²razu.
  22409.    </P
  22410. ><P
  22411. >     Nßsledujφcφ p°φklad by m∞l pomoci lΘpe pochopit pre- a post-inkrementaci
  22412.     i v²razy obecn∞:
  22413.  
  22414.     <DIV
  22415. CLASS="informalexample"
  22416. ><A
  22417. NAME="AEN4376"
  22418. ></A
  22419. ><P
  22420. ></P
  22421. ><TABLE
  22422. BORDER="0"
  22423. BGCOLOR="#E0E0E0"
  22424. CELLPADDING="5"
  22425. ><TR
  22426. ><TD
  22427. ><PRE
  22428. CLASS="php"
  22429. >function double($i)
  22430. {
  22431.     return $i*2;
  22432. }
  22433. $b = $a = 5;        /* p°i°a∩ hodnotu p∞t do prom∞nn²ch $a a $b */
  22434. $c = $a++;          /* prove∩ post-inkrement, p°i°a∩ p∙vodnφ hodnotu $a 
  22435.                        (5) do $c */
  22436. $e = $d = ++$b;     /* prove∩ pre-inkrement, p°i°a∩ inkrementovanou hodnotu 
  22437.                        $b (6) do $d a $e */
  22438.  
  22439. /* nynφ jsou hodnoty prom∞nn²ch $d a $e rovny 6 */
  22440.  
  22441. $f = double($d++);  /* p°i°a∩ dvakrßt hodnotu $d <emphasis>p°ed</emphasis> 
  22442.                        inkrementacφ, 2*6 = 12, do $f */
  22443. $g = double(++$e);  /* p°i°a∩ dvakrßt hodnotu $e <emphasis>po</emphasis>
  22444.                        inkrementaci, 2*7 = 14 do $g */
  22445. $h = $g += 10;      /* nejd°φve je $g inkrementovßno o 10 mß pak hodnotu 24. 
  22446.                        Hodnota p°i°azenφ (24) se p°i°adφ do $h a $h tφm
  22447.                        zφskßvß takΘ hodnotu 24. */</PRE
  22448. ></TD
  22449. ></TR
  22450. ></TABLE
  22451. ><P
  22452. ></P
  22453. ></DIV
  22454. >
  22455.    </P
  22456. ><P
  22457. >     Na zaΦßtku kapitoly bylo °eΦeno, ╛e si popφ╣eme r∙znΘ typy konstrukt∙,
  22458.     a jak bylo slφbeno, v²razy mohou b²t konstrukty. V tomto p°φpad∞ majφ
  22459.     konstrukty formßt 'expr' ';', co╛ znamenß "v²raz nßsledovan² st°ednφkem.
  22460.     V konstruktu '$b=$a=5;', je $a=5 platn² v²raz, ale samo o sob∞ to nenφ
  22461.     konstrukt.'$b=$a=5;' je i platn² konstrukt.
  22462.    </P
  22463. ><P
  22464. >     <SPAN
  22465. CLASS="emphasis"
  22466. ><I
  22467. CLASS="emphasis"
  22468. >     Pozn. p°ekladatele: P°edchozφm odstavci (obΦas i jinde) pou╛φvßm termφn
  22469.     "konstrukt" pro anglickΘ slovo "statement". Tento p°eklad nenφ p°φli╣
  22470.     korektnφ, ale v ΦeskΘ programßtorskΘ mluv∞ neexistuje vhodn² termφn.
  22471.     Kdyby n∞kdo v∞d∞l o lep╣φm, napi╣te mi, prosφm, na luk@php.net.
  22472.     </I
  22473. ></SPAN
  22474. >
  22475.    </P
  22476. ><P
  22477. >     Poslednφ v∞cφ, kterß si zaslou╛φ zmφnku, je pravdivostnφ hodnota v²raz∙.
  22478.     V mnoha p°φpadech, hlavn∞ podmφnkßch a cyklech, vßs nezajφmß konkrΘtnφ
  22479.     hodnota v²razu, n²br╛ pouze to, jestli je <TT
  22480. CLASS="constant"
  22481. ><B
  22482. >TRUE</B
  22483. ></TT
  22484. > nebo <TT
  22485. CLASS="constant"
  22486. ><B
  22487. >FALSE</B
  22488. ></TT
  22489. >.
  22490.     
  22491.     
  22492.     
  22493.     Konstanty <TT
  22494. CLASS="constant"
  22495. ><B
  22496. >TRUE</B
  22497. ></TT
  22498. > a <TT
  22499. CLASS="constant"
  22500. ><B
  22501. >FALSE</B
  22502. ></TT
  22503. > (malß/velkß pφsmena nehrajφ roli) p°edstavujφ
  22504.     dv∞ mo╛nΘ boolovskΘ (pravdivostnφ) hodnoty. V p°φpad∞ pot°eby je v²raz
  22505.     automaticky p°eveden na typ boolean. Detailn∞j╣φ informace o zp∙sobu
  22506.     konverze - viz
  22507.     <A
  22508. HREF="#language.types.typecasting"
  22509. >sekce o typovΘ konverzi</A
  22510. >.
  22511.    </P
  22512. ><P
  22513. >     PHP poskytuje plnou a silnou implementaci v²raz∙ a ·pln∞ je zdokumentovat
  22514.     p°esahuje rozsah tohoto manußlu. V²╣e uvedenΘ p°φklady by vßm m∞li
  22515.     naznaΦit, co jsou v∙bec v²razy a jak konstruovat u╛iteΦnΘ v²razy. Ve
  22516.     zb²vajφcφ Φßsti manußlu budeme psßt <TT
  22517. CLASS="replaceable"
  22518. ><I
  22519. >expr</I
  22520. ></TT
  22521. >
  22522.     jako╛to jak²koli platn² PHP v²raz.
  22523.    </P
  22524. ></DIV
  22525. ><DIV
  22526. CLASS="chapter"
  22527. ><HR><H1
  22528. ><A
  22529. NAME="language.operators"
  22530. >Kapitola 10. Operßtory</A
  22531. ></H1
  22532. ><P
  22533. >   </P
  22534. ><DIV
  22535. CLASS="sect1"
  22536. ><HR><H2
  22537. CLASS="sect1"
  22538. ><A
  22539. NAME="language.operators.arithmetic"
  22540. ></A
  22541. >AritmetickΘ operßtory</H2
  22542. ><P
  22543. >     Vzpomφnßte si na zßkladnφ aritmetiku ze ╣koly? Tohle je ·pln∞ stejnΘ.    
  22544.    </P
  22545. ><DIV
  22546. CLASS="table"
  22547. ><A
  22548. NAME="AEN4395"
  22549. ></A
  22550. ><P
  22551. ><B
  22552. >Tabulka 10-1. AritmetickΘ operßtory</B
  22553. ></P
  22554. ><TABLE
  22555. BORDER="1"
  22556. CLASS="CALSTABLE"
  22557. ><THEAD
  22558. ><TR
  22559. ><TH
  22560. ALIGN="LEFT"
  22561. VALIGN="MIDDLE"
  22562. >P°φklad</TH
  22563. ><TH
  22564. ALIGN="LEFT"
  22565. VALIGN="MIDDLE"
  22566. >Nßzev</TH
  22567. ><TH
  22568. ALIGN="LEFT"
  22569. VALIGN="MIDDLE"
  22570. >V²sledek</TH
  22571. ></TR
  22572. ></THEAD
  22573. ><TBODY
  22574. ><TR
  22575. ><TD
  22576. ALIGN="LEFT"
  22577. VALIGN="MIDDLE"
  22578. >$a + $b</TD
  22579. ><TD
  22580. ALIGN="LEFT"
  22581. VALIGN="MIDDLE"
  22582. >SΦφtßnφ</TD
  22583. ><TD
  22584. ALIGN="LEFT"
  22585. VALIGN="MIDDLE"
  22586. >SouΦet $a a $b.</TD
  22587. ></TR
  22588. ><TR
  22589. ><TD
  22590. ALIGN="LEFT"
  22591. VALIGN="MIDDLE"
  22592. >$a - $b</TD
  22593. ><TD
  22594. ALIGN="LEFT"
  22595. VALIGN="MIDDLE"
  22596. >OdΦφtßnφ</TD
  22597. ><TD
  22598. ALIGN="LEFT"
  22599. VALIGN="MIDDLE"
  22600. >ROzdφl $a a $b.</TD
  22601. ></TR
  22602. ><TR
  22603. ><TD
  22604. ALIGN="LEFT"
  22605. VALIGN="MIDDLE"
  22606. >$a * $b</TD
  22607. ><TD
  22608. ALIGN="LEFT"
  22609. VALIGN="MIDDLE"
  22610. >Nßsobenφ</TD
  22611. ><TD
  22612. ALIGN="LEFT"
  22613. VALIGN="MIDDLE"
  22614. >SouΦin $a a $b.</TD
  22615. ></TR
  22616. ><TR
  22617. ><TD
  22618. ALIGN="LEFT"
  22619. VALIGN="MIDDLE"
  22620. >$a / $b</TD
  22621. ><TD
  22622. ALIGN="LEFT"
  22623. VALIGN="MIDDLE"
  22624. >D∞lenφ</TD
  22625. ><TD
  22626. ALIGN="LEFT"
  22627. VALIGN="MIDDLE"
  22628. >Podφl $a a $b.</TD
  22629. ></TR
  22630. ><TR
  22631. ><TD
  22632. ALIGN="LEFT"
  22633. VALIGN="MIDDLE"
  22634. >$a % $b</TD
  22635. ><TD
  22636. ALIGN="LEFT"
  22637. VALIGN="MIDDLE"
  22638. >Zbytek</TD
  22639. ><TD
  22640. ALIGN="LEFT"
  22641. VALIGN="MIDDLE"
  22642. >Zbytek po d∞lenφ $a a $b.</TD
  22643. ></TR
  22644. ></TBODY
  22645. ></TABLE
  22646. ></DIV
  22647. ><P
  22648. >     Operßtor d∞lenφ ("/") vracφ celoΦφselnou hodnotu (v²sledek celoΦφselnΘho
  22649.     d∞lenφ) prßv∞ tehdy, kdy╛ oba operandy jsou celß Φφsla (nebo °et∞zce,
  22650.     kterΘ se dajφ p°evΘst na celß Φφsla) a podφl je celΘ Φφslo. Pokud
  22651.     n∞kter² z operand∙ celoΦφseln² nenφ nebo v²sledek nenφ celΘ Φφslo, vrßtφ
  22652.     se hodnota v plovoucφ °ßdovΘ Φßrce (float).
  22653.    </P
  22654. ></DIV
  22655. ><DIV
  22656. CLASS="sect1"
  22657. ><HR><H2
  22658. CLASS="sect1"
  22659. ><A
  22660. NAME="language.operators.assignment"
  22661. ></A
  22662. >Operßtory p°i°azenφ</H2
  22663. ><P
  22664. >     Zßkladnφm p°i°azovacφm operßtorem je "=". Mohli byste si zprvu myslet, ╛e
  22665.     se jednß o "rovnß se". Nikoliv. SkuteΦn∞ to znamenß, ╛e se levΘmu operandu
  22666.     p°i°adφ hodnota v²razu vpravo (tj. "nastav na", "p°i°a∩ do" atd.).
  22667.    </P
  22668. ><P
  22669. >     Hodnotou v²razu p°i°azenφ je hodnota, kterß se p°i°azuje. Tj. hodnotou
  22670.     "$a = 3" je Φφslo 3. To vßm umo╛≥uje provßd∞t r∙znΘ triky:
  22671.     <DIV
  22672. CLASS="informalexample"
  22673. ><A
  22674. NAME="AEN4429"
  22675. ></A
  22676. ><P
  22677. ></P
  22678. ><TABLE
  22679. BORDER="0"
  22680. BGCOLOR="#E0E0E0"
  22681. CELLPADDING="5"
  22682. ><TR
  22683. ><TD
  22684. ><PRE
  22685. CLASS="php"
  22686. >$a = ($b = 4) + 5; // $a se ted rovnß 9, a $b bylo nastaveno na 4.</PRE
  22687. ></TD
  22688. ></TR
  22689. ></TABLE
  22690. ><P
  22691. ></P
  22692. ></DIV
  22693. >
  22694.    </P
  22695. ><P
  22696. >     Krom∞ zßkladnφho operßtoru p°i°azenφ existujφ je╣t∞ "kombinovanΘ
  22697.     operßtory" pro v╣echny binßrnφ aritmetickΘ a °et∞zovΘ operßtory, kterΘ
  22698.     umo╛≥ujφ pou╛φt hodnotu ve v²razu a pak hodnotu tohoto v²razu p°i°adit
  22699.     zp∞t. Nap°φklad:
  22700.     <DIV
  22701. CLASS="informalexample"
  22702. ><A
  22703. NAME="AEN4432"
  22704. ></A
  22705. ><P
  22706. ></P
  22707. ><TABLE
  22708. BORDER="0"
  22709. BGCOLOR="#E0E0E0"
  22710. CELLPADDING="5"
  22711. ><TR
  22712. ><TD
  22713. ><PRE
  22714. CLASS="php"
  22715. >$a = 3;
  22716. $a += 5; // nastavφ $a na hodnotu 8, jako kdybychom °ekli: $a = $a + 5;
  22717. $b = "Ahoj ";
  22718. $b .= "tam!"; // nastavφ $b na "Ahoj tam!", p°esn∞ tak, jako $b = $b . "tam!";</PRE
  22719. ></TD
  22720. ></TR
  22721. ></TABLE
  22722. ><P
  22723. ></P
  22724. ></DIV
  22725. >
  22726.    </P
  22727. ><P
  22728. >     Uv∞domte si, ╛e p°i°azenφ zkopφruje hodnotu p∙vodnφ prom∞nnΘ do novΘ
  22729.     prom∞nnΘ (p°i°azenφ hodnoty), tak╛e zm∞ny jednΘ z nich se na druhΘ
  22730.     prom∞nnΘ neprojevφ. To m∙╛e mφt v²znam takΘ tehdy, kdy╛ pot°ebujete
  22731.     zkopφrovat n∞co jako obrovskΘ pole uvnit° krßtkΘho cyklu. PHP 4 podporuje
  22732.     p°i°azenφ odkazem pou╛itφm syntaxe
  22733.     <TT
  22734. CLASS="computeroutput"
  22735. >$var = &$othervar;</TT
  22736. >, ale v PHP 3 to
  22737.     provΘst nelze. "P°i°azenφ odkazem" znamenß, ╛e  ob∞ prom∞nnΘ ukazujφ na
  22738.     tatß╛ data a nic se nikam nekopφruje. Chcete-li se o odkazech dozv∞d∞t
  22739.     vφce, Φt∞te prosφm
  22740.     <A
  22741. HREF="#language.references"
  22742. >Vysv∞tlenφ referencφ</A
  22743. >.
  22744.    </P
  22745. ></DIV
  22746. ><DIV
  22747. CLASS="sect1"
  22748. ><HR><H2
  22749. CLASS="sect1"
  22750. ><A
  22751. NAME="language.operators.bitwise"
  22752. ></A
  22753. >BitovΘ operßtory</H2
  22754. ><P
  22755. >     BitovΘ operßtory umo╛≥ujφ "p°ehodit" konkrΘtnφ bit v celoΦφselnΘ hodnot∞
  22756.     (integer) na jedniΦku nebo nulu. Pokud jsou jak lev², tak prav² parametr
  22757.     °et∞zce, pracujφ bitovΘ operßtory na znacφch v t∞chto °etezcφch.
  22758.    </P
  22759. ><P
  22760. >     <DIV
  22761. CLASS="informalexample"
  22762. ><A
  22763. NAME="AEN4441"
  22764. ></A
  22765. ><P
  22766. ></P
  22767. ><TABLE
  22768. BORDER="0"
  22769. BGCOLOR="#E0E0E0"
  22770. CELLPADDING="5"
  22771. ><TR
  22772. ><TD
  22773. ><PRE
  22774. CLASS="programlisting"
  22775. ><?php
  22776.     echo 12 ^ 9; // Vypφ╣e '5'
  22777.  
  22778.     echo "12" ^ "9"; // Vypφ╣e znak Backspace (ascii 8)
  22779.                      // ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8
  22780.  
  22781.     echo "hallo" ^ "hello"; // Vypφ╣e ascii hodnoty #0 #4 #0 #0 #0
  22782.                             // 'a' ^ 'e' = #4
  22783. ?></PRE
  22784. ></TD
  22785. ></TR
  22786. ></TABLE
  22787. ><P
  22788. ></P
  22789. ></DIV
  22790. > 
  22791.    </P
  22792. ><DIV
  22793. CLASS="table"
  22794. ><A
  22795. NAME="AEN4443"
  22796. ></A
  22797. ><P
  22798. ><B
  22799. >Tabulka 10-2. BitovΘ operßtory</B
  22800. ></P
  22801. ><TABLE
  22802. BORDER="1"
  22803. CLASS="CALSTABLE"
  22804. ><THEAD
  22805. ><TR
  22806. ><TH
  22807. ALIGN="LEFT"
  22808. VALIGN="MIDDLE"
  22809. >P°φklad</TH
  22810. ><TH
  22811. ALIGN="LEFT"
  22812. VALIGN="MIDDLE"
  22813. >Nßzev</TH
  22814. ><TH
  22815. ALIGN="LEFT"
  22816. VALIGN="MIDDLE"
  22817. >V²sledek</TH
  22818. ></TR
  22819. ></THEAD
  22820. ><TBODY
  22821. ><TR
  22822. ><TD
  22823. ALIGN="LEFT"
  22824. VALIGN="MIDDLE"
  22825. >$a & $b</TD
  22826. ><TD
  22827. ALIGN="LEFT"
  22828. VALIGN="MIDDLE"
  22829. >And (log. souΦin)</TD
  22830. ><TD
  22831. ALIGN="LEFT"
  22832. VALIGN="MIDDLE"
  22833. >Nastavujφ se bity, kde je jedniΦka v $a i v $b.</TD
  22834. ></TR
  22835. ><TR
  22836. ><TD
  22837. ALIGN="LEFT"
  22838. VALIGN="MIDDLE"
  22839. >$a | $b</TD
  22840. ><TD
  22841. ALIGN="LEFT"
  22842. VALIGN="MIDDLE"
  22843. >Or(log. souΦet)</TD
  22844. ><TD
  22845. ALIGN="LEFT"
  22846. VALIGN="MIDDLE"
  22847. >Nastavujφ se bity, kde je jedniΦka v $a nebo v $b (i v
  22848.        obou souΦasn∞).</TD
  22849. ></TR
  22850. ><TR
  22851. ><TD
  22852. ALIGN="LEFT"
  22853. VALIGN="MIDDLE"
  22854. >$a ^ $b</TD
  22855. ><TD
  22856. ALIGN="LEFT"
  22857. VALIGN="MIDDLE"
  22858. >Xor (exkluzφvnφ log. souΦet)</TD
  22859. ><TD
  22860. ALIGN="LEFT"
  22861. VALIGN="MIDDLE"
  22862. >     Nastavujφ se bity, kde je jedniΦka v $a nebo v $b, ale ne v obou
  22863.         souΦasn∞.
  22864.        </TD
  22865. ></TR
  22866. ><TR
  22867. ><TD
  22868. ALIGN="LEFT"
  22869. VALIGN="MIDDLE"
  22870. >~ $a</TD
  22871. ><TD
  22872. ALIGN="LEFT"
  22873. VALIGN="MIDDLE"
  22874. >Not (negace)</TD
  22875. ><TD
  22876. ALIGN="LEFT"
  22877. VALIGN="MIDDLE"
  22878. >     Tam, kde je nula, bude jedniΦka, a naopak.
  22879.        </TD
  22880. ></TR
  22881. ><TR
  22882. ><TD
  22883. ALIGN="LEFT"
  22884. VALIGN="MIDDLE"
  22885. >$a << $b</TD
  22886. ><TD
  22887. ALIGN="LEFT"
  22888. VALIGN="MIDDLE"
  22889. >Posun vlevo</TD
  22890. ><TD
  22891. ALIGN="LEFT"
  22892. VALIGN="MIDDLE"
  22893. >         Posune bity v $a o $b krok∙ (mφst) vlevo (ka╛d² krok znamenß
  22894.         "nßsobenφ dv∞ma").
  22895.        </TD
  22896. ></TR
  22897. ><TR
  22898. ><TD
  22899. ALIGN="LEFT"
  22900. VALIGN="MIDDLE"
  22901. >$a >> $b</TD
  22902. ><TD
  22903. ALIGN="LEFT"
  22904. VALIGN="MIDDLE"
  22905. >Posun vpravo</TD
  22906. ><TD
  22907. ALIGN="LEFT"
  22908. VALIGN="MIDDLE"
  22909. >     Posune bity v $a o $b krok∙ (mφst) vpravo (ka╛d² krok znamenß
  22910.         "d∞lenφ dv∞ma").
  22911.        </TD
  22912. ></TR
  22913. ></TBODY
  22914. ></TABLE
  22915. ></DIV
  22916. ></DIV
  22917. ><DIV
  22918. CLASS="sect1"
  22919. ><HR><H2
  22920. CLASS="sect1"
  22921. ><A
  22922. NAME="language.operators.comparison"
  22923. ></A
  22924. >Operßtory porovnßnφ</H2
  22925. ><P
  22926. >     Operßtory porovnßnφ, jak nßzev napovφdß, slou╛φ k porovnßnφ dvou hodnot.
  22927.    </P
  22928. ><DIV
  22929. CLASS="table"
  22930. ><A
  22931. NAME="AEN4479"
  22932. ></A
  22933. ><P
  22934. ><B
  22935. >Tabulka 10-3. Operßtory porovnßnφ</B
  22936. ></P
  22937. ><TABLE
  22938. BORDER="1"
  22939. CLASS="CALSTABLE"
  22940. ><THEAD
  22941. ><TR
  22942. ><TH
  22943. ALIGN="LEFT"
  22944. VALIGN="MIDDLE"
  22945. >P°φklad</TH
  22946. ><TH
  22947. ALIGN="LEFT"
  22948. VALIGN="MIDDLE"
  22949. >Nßzev</TH
  22950. ><TH
  22951. ALIGN="LEFT"
  22952. VALIGN="MIDDLE"
  22953. >V²sledek</TH
  22954. ></TR
  22955. ></THEAD
  22956. ><TBODY
  22957. ><TR
  22958. ><TD
  22959. ALIGN="LEFT"
  22960. VALIGN="MIDDLE"
  22961. >$a == $b</TD
  22962. ><TD
  22963. ALIGN="LEFT"
  22964. VALIGN="MIDDLE"
  22965. >Rovnost</TD
  22966. ><TD
  22967. ALIGN="LEFT"
  22968. VALIGN="MIDDLE"
  22969. ><TT
  22970. CLASS="constant"
  22971. ><B
  22972. >TRUE</B
  22973. ></TT
  22974. >, prßv∞ kdy╛ je $a rovno $b.</TD
  22975. ></TR
  22976. ><TR
  22977. ><TD
  22978. ALIGN="LEFT"
  22979. VALIGN="MIDDLE"
  22980. >$a === $b</TD
  22981. ><TD
  22982. ALIGN="LEFT"
  22983. VALIGN="MIDDLE"
  22984. >Identita</TD
  22985. ><TD
  22986. ALIGN="LEFT"
  22987. VALIGN="MIDDLE"
  22988. >     <TT
  22989. CLASS="constant"
  22990. ><B
  22991. >TRUE</B
  22992. ></TT
  22993. > kdy╛ je $a rovno $b a navφc tΘto╛ typu (pouze PHP 4).
  22994.        </TD
  22995. ></TR
  22996. ><TR
  22997. ><TD
  22998. ALIGN="LEFT"
  22999. VALIGN="MIDDLE"
  23000. >$a != $b</TD
  23001. ><TD
  23002. ALIGN="LEFT"
  23003. VALIGN="MIDDLE"
  23004. >Nerovnost</TD
  23005. ><TD
  23006. ALIGN="LEFT"
  23007. VALIGN="MIDDLE"
  23008. ><TT
  23009. CLASS="constant"
  23010. ><B
  23011. >TRUE</B
  23012. ></TT
  23013. > prßv∞ kdy╛ $a nenφ rovno $b.</TD
  23014. ></TR
  23015. ><TR
  23016. ><TD
  23017. ALIGN="LEFT"
  23018. VALIGN="MIDDLE"
  23019. >$a <> $b</TD
  23020. ><TD
  23021. ALIGN="LEFT"
  23022. VALIGN="MIDDLE"
  23023. >Nerovnost</TD
  23024. ><TD
  23025. ALIGN="LEFT"
  23026. VALIGN="MIDDLE"
  23027. ><TT
  23028. CLASS="constant"
  23029. ><B
  23030. >TRUE</B
  23031. ></TT
  23032. > prßv∞ kdy╛ $a nenφ rovno $b.</TD
  23033. ></TR
  23034. ><TR
  23035. ><TD
  23036. ALIGN="LEFT"
  23037. VALIGN="MIDDLE"
  23038. >$a !== $b</TD
  23039. ><TD
  23040. ALIGN="LEFT"
  23041. VALIGN="MIDDLE"
  23042. >Neidentita</TD
  23043. ><TD
  23044. ALIGN="LEFT"
  23045. VALIGN="MIDDLE"
  23046. >     <TT
  23047. CLASS="constant"
  23048. ><B
  23049. >TRUE</B
  23050. ></TT
  23051. > kdy╛ $a nenφ rovno $b nebo nejsou tΘho╛ typu (pouze PHP 4).
  23052.        </TD
  23053. ></TR
  23054. ><TR
  23055. ><TD
  23056. ALIGN="LEFT"
  23057. VALIGN="MIDDLE"
  23058. >$a < $b</TD
  23059. ><TD
  23060. ALIGN="LEFT"
  23061. VALIGN="MIDDLE"
  23062. >Men╣φ ne╛</TD
  23063. ><TD
  23064. ALIGN="LEFT"
  23065. VALIGN="MIDDLE"
  23066. ><TT
  23067. CLASS="constant"
  23068. ><B
  23069. >TRUE</B
  23070. ></TT
  23071. > kdy╛ je $a ost°e men╣φ ne╛ $b.</TD
  23072. ></TR
  23073. ><TR
  23074. ><TD
  23075. ALIGN="LEFT"
  23076. VALIGN="MIDDLE"
  23077. >$a > $b</TD
  23078. ><TD
  23079. ALIGN="LEFT"
  23080. VALIGN="MIDDLE"
  23081. >V∞t╣φ ne╛</TD
  23082. ><TD
  23083. ALIGN="LEFT"
  23084. VALIGN="MIDDLE"
  23085. ><TT
  23086. CLASS="constant"
  23087. ><B
  23088. >TRUE</B
  23089. ></TT
  23090. > kdy╛ je $a ost°e v∞t╣φ ne╛ $b.</TD
  23091. ></TR
  23092. ><TR
  23093. ><TD
  23094. ALIGN="LEFT"
  23095. VALIGN="MIDDLE"
  23096. >$a <= $b</TD
  23097. ><TD
  23098. ALIGN="LEFT"
  23099. VALIGN="MIDDLE"
  23100. >Men╣φ nebo rovno</TD
  23101. ><TD
  23102. ALIGN="LEFT"
  23103. VALIGN="MIDDLE"
  23104. ><TT
  23105. CLASS="constant"
  23106. ><B
  23107. >TRUE</B
  23108. ></TT
  23109. > kdy╛ je $a men╣φ nebo rovno $b.</TD
  23110. ></TR
  23111. ><TR
  23112. ><TD
  23113. ALIGN="LEFT"
  23114. VALIGN="MIDDLE"
  23115. >$a >= $b</TD
  23116. ><TD
  23117. ALIGN="LEFT"
  23118. VALIGN="MIDDLE"
  23119. >V∞t╣φ nebo rovno</TD
  23120. ><TD
  23121. ALIGN="LEFT"
  23122. VALIGN="MIDDLE"
  23123. ><TT
  23124. CLASS="constant"
  23125. ><B
  23126. >TRUE</B
  23127. ></TT
  23128. > kdy╛ je $a v∞t╣φ nebo rovno $b.</TD
  23129. ></TR
  23130. ></TBODY
  23131. ></TABLE
  23132. ></DIV
  23133. ><P
  23134. >     Jin²m podmφnkov²m operßtorem je "?:" (ternßrnφ) operßtor, kter² funguje
  23135.     stejn∞ jako v C a mnoh²ch jin²ch jazycφch.
  23136.     <DIV
  23137. CLASS="informalexample"
  23138. ><A
  23139. NAME="AEN4534"
  23140. ></A
  23141. ><P
  23142. ></P
  23143. ><TABLE
  23144. BORDER="0"
  23145. BGCOLOR="#E0E0E0"
  23146. CELLPADDING="5"
  23147. ><TR
  23148. ><TD
  23149. ><PRE
  23150. CLASS="programlisting"
  23151. >(expr1) ? (expr2) : (expr3);</PRE
  23152. ></TD
  23153. ></TR
  23154. ></TABLE
  23155. ><P
  23156. ></P
  23157. ></DIV
  23158. > 
  23159.     V²raz je ohodnocen jako hodnota <TT
  23160. CLASS="replaceable"
  23161. ><I
  23162. >expr2</I
  23163. ></TT
  23164. > kdy╛
  23165.     mß <TT
  23166. CLASS="replaceable"
  23167. ><I
  23168. >expr1</I
  23169. ></TT
  23170. > hodnotu <TT
  23171. CLASS="constant"
  23172. ><B
  23173. >TRUE</B
  23174. ></TT
  23175. >, a
  23176.     <TT
  23177. CLASS="replaceable"
  23178. ><I
  23179. >expr3</I
  23180. ></TT
  23181. > kdy╛
  23182.     mß <TT
  23183. CLASS="replaceable"
  23184. ><I
  23185. >expr1</I
  23186. ></TT
  23187. > hodnotu <TT
  23188. CLASS="constant"
  23189. ><B
  23190. >FALSE</B
  23191. ></TT
  23192. >.
  23193.    </P
  23194. ></DIV
  23195. ><DIV
  23196. CLASS="sect1"
  23197. ><HR><H2
  23198. CLASS="sect1"
  23199. ><A
  23200. NAME="language.operators.errorcontrol"
  23201. ></A
  23202. >Operßtory °φzenφ chyb</H2
  23203. ><P
  23204. >     PHP podporuje jeden operßtor °φzenφ chyb: znak at (@). Kdy╛ ho p°ed°adφte
  23205.     v²razu v PHP, jakΘkoli chybovΘ zprßvy, kterΘ se mohou generovat ve
  23206.     v²razu, budou ignorovßny. 
  23207.    </P
  23208. ><P
  23209. >     Pokud je zapnuto<A
  23210. HREF="#ini.track-errors"
  23211. >track_errors</A
  23212. >,
  23213.     budou se v╣echny chybovΘ zprßvy generovanΘ v²razem uklßdat do globßlnφ
  23214.     prom∞nnΘ $php_errormsg. Tato prom∞nnß bude p°epsßna p°i ka╛dΘ chyb∞,
  23215.     tak╛e ji testujte v╛dy co nejd°φve, pokud ji chcete pou╛φvat.
  23216.    </P
  23217. ><P
  23218. >     <DIV
  23219. CLASS="informalexample"
  23220. ><A
  23221. NAME="AEN4548"
  23222. ></A
  23223. ><P
  23224. ></P
  23225. ><TABLE
  23226. BORDER="0"
  23227. BGCOLOR="#E0E0E0"
  23228. CELLPADDING="5"
  23229. ><TR
  23230. ><TD
  23231. ><PRE
  23232. CLASS="php"
  23233. ><?php
  23234. /* Intentional file error */
  23235. $my_file = @file ('non_existent_file') or
  23236.     die ("Failed opening file: error was '$php_errormsg'");
  23237.  
  23238. // this works for any expression, not just functions:
  23239. $value = @$cache[$key]; 
  23240. // will not issue a notice if the index $key doesn't exist.
  23241.  
  23242. ?></PRE
  23243. ></TD
  23244. ></TR
  23245. ></TABLE
  23246. ><P
  23247. ></P
  23248. ></DIV
  23249. >
  23250.    </P
  23251. ><DIV
  23252. CLASS="note"
  23253. ><BLOCKQUOTE
  23254. CLASS="note"
  23255. ><P
  23256. ><B
  23257. >Poznßmka: </B
  23258. >
  23259.      Operßtor @ pracuje pouze na v²razech. Platφ jednoduchΘ pravidlo:
  23260.      m∙╛ete-li zφskat hodnotu n∞Φeho, m∙╛ete p°ed to dßt operßtor @.
  23261.      To se t²kß nap°φklad prom∞nn²ch, funkcφ, volßnφ
  23262.      <A
  23263. HREF="#function.include"
  23264. ><B
  23265. CLASS="function"
  23266. >include()</B
  23267. ></A
  23268. > konstant a podobn∞. Nem∙╛ete ho p°ed°adit
  23269.      definicφm funkcφ nebo t°φd a podmφnkov²m strukturßm typu
  23270.      <TT
  23271. CLASS="literal"
  23272. >if</TT
  23273. > nebo <TT
  23274. CLASS="literal"
  23275. >foreach</TT
  23276. >.
  23277.     </P
  23278. ></BLOCKQUOTE
  23279. ></DIV
  23280. ><P
  23281. >     Viz takΘ <A
  23282. HREF="#function.error-reporting"
  23283. ><B
  23284. CLASS="function"
  23285. >error_reporting()</B
  23286. ></A
  23287. >.
  23288.    </P
  23289. ><DIV
  23290. CLASS="warning"
  23291. ><P
  23292. ></P
  23293. ><TABLE
  23294. CLASS="warning"
  23295. BORDER="1"
  23296. WIDTH="100%"
  23297. ><TR
  23298. ><TD
  23299. ALIGN="CENTER"
  23300. ><B
  23301. >Varovßnφ</B
  23302. ></TD
  23303. ></TR
  23304. ><TR
  23305. ><TD
  23306. ALIGN="LEFT"
  23307. ><P
  23308. >      V souΦasnosti p°ed°azenφ operßtoru °φzenφ chyb "@" vy°adφ i hlß╣enφ
  23309.      kritick²ch chyb, kterΘ zp∙sobφ ukonΦenφ provßd∞nφ skriptu. To mj.
  23310.      znamenß, ╛e pokud pou╛ijete "@" k potlaΦenφ chyb z n∞jakΘ funkce,
  23311.      a tato funkce nenφ k dispozici nebo obsahuje chyby, skript zde skonΦφ
  23312.      bez jakΘkoli indikace, co se stalo.
  23313.     </P
  23314. ></TD
  23315. ></TR
  23316. ></TABLE
  23317. ></DIV
  23318. ></DIV
  23319. ><DIV
  23320. CLASS="sect1"
  23321. ><HR><H2
  23322. CLASS="sect1"
  23323. ><A
  23324. NAME="language.operators.execution"
  23325. ></A
  23326. >Provßd∞cφ operßtory</H2
  23327. ><P
  23328. >     PHP podporuje jeden provßd∞cφ operßtor: obrßcenΘ apostrofy (``).
  23329.     Uv∞domte si, ╛e to nejsou obyΦejnΘ apostrofy! PHP se pokusφ provΘst
  23330.     obsah uzav°en² mezi t∞mito znaky jako p°φkaz shellu; v²stup je vrßcen
  23331.     (tzn. nebude pouze vypsßn na v²stup∙ m∙╛e b²t p°i°azen prom∞nnΘ).
  23332.     <DIV
  23333. CLASS="informalexample"
  23334. ><A
  23335. NAME="AEN4562"
  23336. ></A
  23337. ><P
  23338. ></P
  23339. ><TABLE
  23340. BORDER="0"
  23341. BGCOLOR="#E0E0E0"
  23342. CELLPADDING="5"
  23343. ><TR
  23344. ><TD
  23345. ><PRE
  23346. CLASS="php"
  23347. >$output = `ls -al`;
  23348. echo "<pre>$output</pre>";</PRE
  23349. ></TD
  23350. ></TR
  23351. ></TABLE
  23352. ><P
  23353. ></P
  23354. ></DIV
  23355. >
  23356.    </P
  23357. ><DIV
  23358. CLASS="note"
  23359. ><BLOCKQUOTE
  23360. CLASS="note"
  23361. ><P
  23362. ><B
  23363. >Poznßmka: </B
  23364. >
  23365.      Operßtor m∙╛e b²t vy°azen, pokud je aktivnφ
  23366.      <A
  23367. HREF="#ini.safe-mode"
  23368. >bezpeΦn² re╛im</A
  23369. > nebo je vypnuto
  23370.      <A
  23371. HREF="#function.shell-exec"
  23372. ><B
  23373. CLASS="function"
  23374. >shell_exec()</B
  23375. ></A
  23376. >.
  23377.     </P
  23378. ></BLOCKQUOTE
  23379. ></DIV
  23380. ><P
  23381. >     Viz takΘ <A
  23382. HREF="#function.escapeshellcmd"
  23383. ><B
  23384. CLASS="function"
  23385. >escapeshellcmd()</B
  23386. ></A
  23387. >, <A
  23388. HREF="#function.exec"
  23389. ><B
  23390. CLASS="function"
  23391. >exec()</B
  23392. ></A
  23393. >,
  23394.     <A
  23395. HREF="#function.passthru"
  23396. ><B
  23397. CLASS="function"
  23398. >passthru()</B
  23399. ></A
  23400. >, <A
  23401. HREF="#function.popen"
  23402. ><B
  23403. CLASS="function"
  23404. >popen()</B
  23405. ></A
  23406. >,
  23407.     <A
  23408. HREF="#function.shell-exec"
  23409. ><B
  23410. CLASS="function"
  23411. >shell_exec()</B
  23412. ></A
  23413. >, a <A
  23414. HREF="#function.system"
  23415. ><B
  23416. CLASS="function"
  23417. >system()</B
  23418. ></A
  23419. >.
  23420.    </P
  23421. ></DIV
  23422. ><DIV
  23423. CLASS="sect1"
  23424. ><HR><H2
  23425. CLASS="sect1"
  23426. ><A
  23427. NAME="language.operators.increment"
  23428. ></A
  23429. >InkrementaΦnφ/DekrementaΦnφ operßtory</H2
  23430. ><P
  23431. >     PHP podporuje pre- a post inkrementaΦnφ a dekrementaΦnφ operßtory ve
  23432.     stylu C.
  23433.    </P
  23434. ><DIV
  23435. CLASS="table"
  23436. ><A
  23437. NAME="AEN4578"
  23438. ></A
  23439. ><P
  23440. ><B
  23441. >Tabulka 10-4. InkrementaΦnφ/dekrementaΦnφ operßtory</B
  23442. ></P
  23443. ><TABLE
  23444. BORDER="1"
  23445. CLASS="CALSTABLE"
  23446. ><THEAD
  23447. ><TR
  23448. ><TH
  23449. ALIGN="LEFT"
  23450. VALIGN="MIDDLE"
  23451. >P°φklad</TH
  23452. ><TH
  23453. ALIGN="LEFT"
  23454. VALIGN="MIDDLE"
  23455. >Nßzev</TH
  23456. ><TH
  23457. ALIGN="LEFT"
  23458. VALIGN="MIDDLE"
  23459. >┌Φinek</TH
  23460. ></TR
  23461. ></THEAD
  23462. ><TBODY
  23463. ><TR
  23464. ><TD
  23465. ALIGN="LEFT"
  23466. VALIGN="MIDDLE"
  23467. >++$a</TD
  23468. ><TD
  23469. ALIGN="LEFT"
  23470. VALIGN="MIDDLE"
  23471. >Pre-inkrementace</TD
  23472. ><TD
  23473. ALIGN="LEFT"
  23474. VALIGN="MIDDLE"
  23475. >Inkrementuje $a o jedniΦku, potom vrßtφ $a.</TD
  23476. ></TR
  23477. ><TR
  23478. ><TD
  23479. ALIGN="LEFT"
  23480. VALIGN="MIDDLE"
  23481. >$a++</TD
  23482. ><TD
  23483. ALIGN="LEFT"
  23484. VALIGN="MIDDLE"
  23485. >Post-inkrementace</TD
  23486. ><TD
  23487. ALIGN="LEFT"
  23488. VALIGN="MIDDLE"
  23489. >Vrßtφ $a, potom inkrementuje $a o jedniΦku.</TD
  23490. ></TR
  23491. ><TR
  23492. ><TD
  23493. ALIGN="LEFT"
  23494. VALIGN="MIDDLE"
  23495. >--$a</TD
  23496. ><TD
  23497. ALIGN="LEFT"
  23498. VALIGN="MIDDLE"
  23499. >Pre-dekrementace</TD
  23500. ><TD
  23501. ALIGN="LEFT"
  23502. VALIGN="MIDDLE"
  23503. >Dekrementuje $a o jedniΦku, potom vrßtφ $a.</TD
  23504. ></TR
  23505. ><TR
  23506. ><TD
  23507. ALIGN="LEFT"
  23508. VALIGN="MIDDLE"
  23509. >$a--</TD
  23510. ><TD
  23511. ALIGN="LEFT"
  23512. VALIGN="MIDDLE"
  23513. >Post-dekrementace</TD
  23514. ><TD
  23515. ALIGN="LEFT"
  23516. VALIGN="MIDDLE"
  23517. >Vrßtφ $a, potom dkrementuje $a o jedniΦku.</TD
  23518. ></TR
  23519. ></TBODY
  23520. ></TABLE
  23521. ></DIV
  23522. ><P
  23523. >     Zde je p°φklad jednoduchΘho skriptu:
  23524.     <DIV
  23525. CLASS="informalexample"
  23526. ><A
  23527. NAME="AEN4604"
  23528. ></A
  23529. ><P
  23530. ></P
  23531. ><TABLE
  23532. BORDER="0"
  23533. BGCOLOR="#E0E0E0"
  23534. CELLPADDING="5"
  23535. ><TR
  23536. ><TD
  23537. ><PRE
  23538. CLASS="php"
  23539. ><?php
  23540. echo "<h3&gt;Postinkrementace</h3&gt;";
  23541. $a = 5;
  23542. echo "M∞lo by b²t 5: " . $a++ . "<br>\n";
  23543. echo "M∞lo by b²t 6: " . $a . "<br>\n";
  23544.  
  23545. echo "<h3>Preinkrementace</h3>";
  23546. $a = 5;
  23547. echo "M∞lo by b²t 6: " . ++$a . "<br>\n";
  23548. echo "M∞lo by b²t 6: " . $a . "<br>\n";
  23549.  
  23550. echo "<h3>Postdekrementace</h3>";
  23551. $a = 5;
  23552. echo "M∞lo by b²t 5: " . $a-- . "<br>\n";
  23553. echo "M∞lo by b²t: " . $a . "<br>\n";
  23554.  
  23555. echo "<h3>Predekrementace</h3>";
  23556. $a = 5;
  23557. echo "M∞lo by b²t 4: " . --$a . "<br>\n";
  23558. echo "M∞lo by b²t 4: " . $a . "<br>\n";
  23559. ?></PRE
  23560. ></TD
  23561. ></TR
  23562. ></TABLE
  23563. ><P
  23564. ></P
  23565. ></DIV
  23566. >
  23567.    </P
  23568. ></DIV
  23569. ><DIV
  23570. CLASS="sect1"
  23571. ><HR><H2
  23572. CLASS="sect1"
  23573. ><A
  23574. NAME="language.operators.logical"
  23575. ></A
  23576. >LogickΘ operßtory</H2
  23577. ><DIV
  23578. CLASS="table"
  23579. ><A
  23580. NAME="AEN4608"
  23581. ></A
  23582. ><P
  23583. ><B
  23584. >Tabulka 10-5. LogickΘ operßtory</B
  23585. ></P
  23586. ><TABLE
  23587. BORDER="1"
  23588. CLASS="CALSTABLE"
  23589. ><THEAD
  23590. ><TR
  23591. ><TH
  23592. ALIGN="LEFT"
  23593. VALIGN="MIDDLE"
  23594. >P°φklad</TH
  23595. ><TH
  23596. ALIGN="LEFT"
  23597. VALIGN="MIDDLE"
  23598. >Nßzev</TH
  23599. ><TH
  23600. ALIGN="LEFT"
  23601. VALIGN="MIDDLE"
  23602. >V²sledek</TH
  23603. ></TR
  23604. ></THEAD
  23605. ><TBODY
  23606. ><TR
  23607. ><TD
  23608. ALIGN="LEFT"
  23609. VALIGN="MIDDLE"
  23610. >$a and $b</TD
  23611. ><TD
  23612. ALIGN="LEFT"
  23613. VALIGN="MIDDLE"
  23614. >And</TD
  23615. ><TD
  23616. ALIGN="LEFT"
  23617. VALIGN="MIDDLE"
  23618. ><TT
  23619. CLASS="constant"
  23620. ><B
  23621. >TRUE</B
  23622. ></TT
  23623. > kdy╛ $a i $b jsou <TT
  23624. CLASS="constant"
  23625. ><B
  23626. >TRUE</B
  23627. ></TT
  23628. >.</TD
  23629. ></TR
  23630. ><TR
  23631. ><TD
  23632. ALIGN="LEFT"
  23633. VALIGN="MIDDLE"
  23634. >$a or $b</TD
  23635. ><TD
  23636. ALIGN="LEFT"
  23637. VALIGN="MIDDLE"
  23638. >Or</TD
  23639. ><TD
  23640. ALIGN="LEFT"
  23641. VALIGN="MIDDLE"
  23642. ><TT
  23643. CLASS="constant"
  23644. ><B
  23645. >TRUE</B
  23646. ></TT
  23647. > kdy╛ $a nebo $b je <TT
  23648. CLASS="constant"
  23649. ><B
  23650. >TRUE</B
  23651. ></TT
  23652. >.</TD
  23653. ></TR
  23654. ><TR
  23655. ><TD
  23656. ALIGN="LEFT"
  23657. VALIGN="MIDDLE"
  23658. >$a xor $b</TD
  23659. ><TD
  23660. ALIGN="LEFT"
  23661. VALIGN="MIDDLE"
  23662. >Xor</TD
  23663. ><TD
  23664. ALIGN="LEFT"
  23665. VALIGN="MIDDLE"
  23666. ><TT
  23667. CLASS="constant"
  23668. ><B
  23669. >TRUE</B
  23670. ></TT
  23671. > kdy╛ $a nebo $b je <TT
  23672. CLASS="constant"
  23673. ><B
  23674. >TRUE</B
  23675. ></TT
  23676. >, ale ne oba souΦasn∞.</TD
  23677. ></TR
  23678. ><TR
  23679. ><TD
  23680. ALIGN="LEFT"
  23681. VALIGN="MIDDLE"
  23682. >! $a</TD
  23683. ><TD
  23684. ALIGN="LEFT"
  23685. VALIGN="MIDDLE"
  23686. >Not</TD
  23687. ><TD
  23688. ALIGN="LEFT"
  23689. VALIGN="MIDDLE"
  23690. ><TT
  23691. CLASS="constant"
  23692. ><B
  23693. >TRUE</B
  23694. ></TT
  23695. > kdy╛ $a nenφ <TT
  23696. CLASS="constant"
  23697. ><B
  23698. >TRUE</B
  23699. ></TT
  23700. >.</TD
  23701. ></TR
  23702. ><TR
  23703. ><TD
  23704. ALIGN="LEFT"
  23705. VALIGN="MIDDLE"
  23706. >$a && $b</TD
  23707. ><TD
  23708. ALIGN="LEFT"
  23709. VALIGN="MIDDLE"
  23710. >And</TD
  23711. ><TD
  23712. ALIGN="LEFT"
  23713. VALIGN="MIDDLE"
  23714. ><TT
  23715. CLASS="constant"
  23716. ><B
  23717. >TRUE</B
  23718. ></TT
  23719. > kdy╛ $a i $b jsou <TT
  23720. CLASS="constant"
  23721. ><B
  23722. >TRUE</B
  23723. ></TT
  23724. >.</TD
  23725. ></TR
  23726. ><TR
  23727. ><TD
  23728. ALIGN="LEFT"
  23729. VALIGN="MIDDLE"
  23730. >$a || $b</TD
  23731. ><TD
  23732. ALIGN="LEFT"
  23733. VALIGN="MIDDLE"
  23734. >Or</TD
  23735. ><TD
  23736. ALIGN="LEFT"
  23737. VALIGN="MIDDLE"
  23738. ><TT
  23739. CLASS="constant"
  23740. ><B
  23741. >TRUE</B
  23742. ></TT
  23743. > kdy╛ $a nebo $b je <TT
  23744. CLASS="constant"
  23745. ><B
  23746. >TRUE</B
  23747. ></TT
  23748. >.</TD
  23749. ></TR
  23750. ></TBODY
  23751. ></TABLE
  23752. ></DIV
  23753. ><P
  23754. >     D∙vodem pro dv∞ r∙znΘ varianty operßtor∙  "and" a "or" je to, ╛e majφ
  23755.     jinou prioritu. (Viz <A
  23756. HREF="#language.operators.precedence"
  23757. >Priorita
  23758.     operßtor∙</A
  23759. >.)
  23760.    </P
  23761. ></DIV
  23762. ><DIV
  23763. CLASS="sect1"
  23764. ><HR><H2
  23765. CLASS="sect1"
  23766. ><A
  23767. NAME="language.operators.precedence"
  23768. ></A
  23769. >Priorita operßtor∙</H2
  23770. ><P
  23771. >     Priorita operßtoru specifikuje, jak "t∞sn∞" vß╛e dva v²razy mezi sebou.
  23772.     Nap°φklad v²raz <TT
  23773. CLASS="literal"
  23774. >1 + 5 * 3</TT
  23775. >,
  23776.     v²sledkem je <TT
  23777. CLASS="literal"
  23778. >16</TT
  23779. > a nikoli <TT
  23780. CLASS="literal"
  23781. >18</TT
  23782. >,
  23783.     proto╛e operßtor nßsobenφ ("*") mß vy╣╣φ prioritu ne╛ operßtor sΦφtßnφ
  23784.     ("+"). K vynucenφ priority m∙╛eme v p°φpad∞ pot°eby pou╛φt zßvorky.
  23785.     Kup°. <TT
  23786. CLASS="literal"
  23787. >(1 + 5) * 3</TT
  23788. > mß hodnotu <TT
  23789. CLASS="literal"
  23790. >18</TT
  23791. >.
  23792.    </P
  23793. ><P
  23794. >     Nßsledujφcφ tabulka ukazuje p°ehled operßtor∙ vzestupn∞ se°azen²ch podle
  23795.     priority.
  23796.     <DIV
  23797. CLASS="table"
  23798. ><A
  23799. NAME="AEN4664"
  23800. ></A
  23801. ><P
  23802. ><B
  23803. >Tabulka 10-6. Priorita operßtor∙</B
  23804. ></P
  23805. ><TABLE
  23806. BORDER="1"
  23807. CLASS="CALSTABLE"
  23808. ><THEAD
  23809. ><TR
  23810. ><TH
  23811. ALIGN="LEFT"
  23812. VALIGN="MIDDLE"
  23813. >Asociativita</TH
  23814. ><TH
  23815. ALIGN="LEFT"
  23816. VALIGN="MIDDLE"
  23817. >Operßtory</TH
  23818. ></TR
  23819. ></THEAD
  23820. ><TBODY
  23821. ><TR
  23822. ><TD
  23823. ALIGN="LEFT"
  23824. VALIGN="MIDDLE"
  23825. >levß</TD
  23826. ><TD
  23827. ALIGN="LEFT"
  23828. VALIGN="MIDDLE"
  23829. >,</TD
  23830. ></TR
  23831. ><TR
  23832. ><TD
  23833. ALIGN="LEFT"
  23834. VALIGN="MIDDLE"
  23835. >levß</TD
  23836. ><TD
  23837. ALIGN="LEFT"
  23838. VALIGN="MIDDLE"
  23839. >or</TD
  23840. ></TR
  23841. ><TR
  23842. ><TD
  23843. ALIGN="LEFT"
  23844. VALIGN="MIDDLE"
  23845. >levß</TD
  23846. ><TD
  23847. ALIGN="LEFT"
  23848. VALIGN="MIDDLE"
  23849. >xor</TD
  23850. ></TR
  23851. ><TR
  23852. ><TD
  23853. ALIGN="LEFT"
  23854. VALIGN="MIDDLE"
  23855. >levß</TD
  23856. ><TD
  23857. ALIGN="LEFT"
  23858. VALIGN="MIDDLE"
  23859. >and</TD
  23860. ></TR
  23861. ><TR
  23862. ><TD
  23863. ALIGN="LEFT"
  23864. VALIGN="MIDDLE"
  23865. >pravß</TD
  23866. ><TD
  23867. ALIGN="LEFT"
  23868. VALIGN="MIDDLE"
  23869. >print</TD
  23870. ></TR
  23871. ><TR
  23872. ><TD
  23873. ALIGN="LEFT"
  23874. VALIGN="MIDDLE"
  23875. >levß</TD
  23876. ><TD
  23877. ALIGN="LEFT"
  23878. VALIGN="MIDDLE"
  23879. >          = += -= *= /= .= %= &= |= ^= ~= <<= >>=
  23880.         </TD
  23881. ></TR
  23882. ><TR
  23883. ><TD
  23884. ALIGN="LEFT"
  23885. VALIGN="MIDDLE"
  23886. >levß</TD
  23887. ><TD
  23888. ALIGN="LEFT"
  23889. VALIGN="MIDDLE"
  23890. >? :</TD
  23891. ></TR
  23892. ><TR
  23893. ><TD
  23894. ALIGN="LEFT"
  23895. VALIGN="MIDDLE"
  23896. >levß</TD
  23897. ><TD
  23898. ALIGN="LEFT"
  23899. VALIGN="MIDDLE"
  23900. >||</TD
  23901. ></TR
  23902. ><TR
  23903. ><TD
  23904. ALIGN="LEFT"
  23905. VALIGN="MIDDLE"
  23906. >levß</TD
  23907. ><TD
  23908. ALIGN="LEFT"
  23909. VALIGN="MIDDLE"
  23910. >&&</TD
  23911. ></TR
  23912. ><TR
  23913. ><TD
  23914. ALIGN="LEFT"
  23915. VALIGN="MIDDLE"
  23916. >levß</TD
  23917. ><TD
  23918. ALIGN="LEFT"
  23919. VALIGN="MIDDLE"
  23920. >|</TD
  23921. ></TR
  23922. ><TR
  23923. ><TD
  23924. ALIGN="LEFT"
  23925. VALIGN="MIDDLE"
  23926. >levß</TD
  23927. ><TD
  23928. ALIGN="LEFT"
  23929. VALIGN="MIDDLE"
  23930. >^</TD
  23931. ></TR
  23932. ><TR
  23933. ><TD
  23934. ALIGN="LEFT"
  23935. VALIGN="MIDDLE"
  23936. >levß</TD
  23937. ><TD
  23938. ALIGN="LEFT"
  23939. VALIGN="MIDDLE"
  23940. >&</TD
  23941. ></TR
  23942. ><TR
  23943. ><TD
  23944. ALIGN="LEFT"
  23945. VALIGN="MIDDLE"
  23946. >bez asociativity</TD
  23947. ><TD
  23948. ALIGN="LEFT"
  23949. VALIGN="MIDDLE"
  23950. >== != === !==</TD
  23951. ></TR
  23952. ><TR
  23953. ><TD
  23954. ALIGN="LEFT"
  23955. VALIGN="MIDDLE"
  23956. >bez asociativity</TD
  23957. ><TD
  23958. ALIGN="LEFT"
  23959. VALIGN="MIDDLE"
  23960. >< <= > >=</TD
  23961. ></TR
  23962. ><TR
  23963. ><TD
  23964. ALIGN="LEFT"
  23965. VALIGN="MIDDLE"
  23966. >levß</TD
  23967. ><TD
  23968. ALIGN="LEFT"
  23969. VALIGN="MIDDLE"
  23970. ><< >></TD
  23971. ></TR
  23972. ><TR
  23973. ><TD
  23974. ALIGN="LEFT"
  23975. VALIGN="MIDDLE"
  23976. >levß</TD
  23977. ><TD
  23978. ALIGN="LEFT"
  23979. VALIGN="MIDDLE"
  23980. >+ - .</TD
  23981. ></TR
  23982. ><TR
  23983. ><TD
  23984. ALIGN="LEFT"
  23985. VALIGN="MIDDLE"
  23986. >levß</TD
  23987. ><TD
  23988. ALIGN="LEFT"
  23989. VALIGN="MIDDLE"
  23990. >* / %</TD
  23991. ></TR
  23992. ><TR
  23993. ><TD
  23994. ALIGN="LEFT"
  23995. VALIGN="MIDDLE"
  23996. >pravß</TD
  23997. ><TD
  23998. ALIGN="LEFT"
  23999. VALIGN="MIDDLE"
  24000. >! ~ ++ -- (int) (double) (string) (array) (object) @</TD
  24001. ></TR
  24002. ><TR
  24003. ><TD
  24004. ALIGN="LEFT"
  24005. VALIGN="MIDDLE"
  24006. >pravß</TD
  24007. ><TD
  24008. ALIGN="LEFT"
  24009. VALIGN="MIDDLE"
  24010. >[</TD
  24011. ></TR
  24012. ><TR
  24013. ><TD
  24014. ALIGN="LEFT"
  24015. VALIGN="MIDDLE"
  24016. >bez asociativity</TD
  24017. ><TD
  24018. ALIGN="LEFT"
  24019. VALIGN="MIDDLE"
  24020. >new</TD
  24021. ></TR
  24022. ></TBODY
  24023. ></TABLE
  24024. ></DIV
  24025. >
  24026.    </P
  24027. ></DIV
  24028. ><DIV
  24029. CLASS="sect1"
  24030. ><HR><H2
  24031. CLASS="sect1"
  24032. ><A
  24033. NAME="language.operators.string"
  24034. ></A
  24035. >╪et∞zcovΘ operßtory</H2
  24036. ><P
  24037. >     Existujφ dva °etezcovΘ operßtory. Jednφm je operßtor spojenφ ('.'),
  24038.     kter² vracφ spojenφ pravΘho a levΘho argumentu. Druh²m je operßtor
  24039.     spojujφcφho p°i°azenφ ('.='), jen╛ p°ipojφ argument na pravΘ stran∞
  24040.     k argumentu na stran∞ levΘ. Pro vφce informacφ si laskav∞ p°eΦt∞te 
  24041.     <A
  24042. HREF="#language.operators.assignment"
  24043. >Operßtory p°i°azenφ</A
  24044. >.
  24045.    </P
  24046. ><P
  24047. >     <DIV
  24048. CLASS="informalexample"
  24049. ><A
  24050. NAME="AEN4737"
  24051. ></A
  24052. ><P
  24053. ></P
  24054. ><TABLE
  24055. BORDER="0"
  24056. BGCOLOR="#E0E0E0"
  24057. CELLPADDING="5"
  24058. ><TR
  24059. ><TD
  24060. ><PRE
  24061. CLASS="php"
  24062. >$a = "Ahoj ";
  24063. $b = $a . "sv∞te!"; // nynφ $b obsahuje "Ahoj sv∞te!"
  24064.  
  24065. $a = "Ahoj ";
  24066. $a .= "sv∞te!";     // nynφ $a obsahuje "Ahoj sv∞te!"</PRE
  24067. ></TD
  24068. ></TR
  24069. ></TABLE
  24070. ><P
  24071. ></P
  24072. ></DIV
  24073. >
  24074.    </P
  24075. ></DIV
  24076. ></DIV
  24077. ><DIV
  24078. CLASS="chapter"
  24079. ><HR><H1
  24080. ><A
  24081. NAME="control-structures"
  24082. >Kapitola 11. ╪φdicφ struktury</A
  24083. ></H1
  24084. ><P
  24085. >    Jak²koli PHP skript je slo╛en ze sΘrie konstrukt∙. Konstrukt m∙╛e b²t
  24086.    p°i°azenφ, volßnφ funkce, cyklus, podmφnka, stejn∞ jako konstrukt, kter²
  24087.    nic ned∞lß (prßzdn² konstrukt). Konstrukt obvykle konΦφ st°ednφkem.
  24088.    Navφc lze konstrukty seskupit do skupiny (bloku) uzav°enΘ slo╛en²mi
  24089.    zßvorkami. Tento blok je sßm o sob∞ konstruktem. V tΘto kapitole jsou
  24090.    popsßny r∙znΘ typy konstrukt∙.
  24091.   </P
  24092. ><DIV
  24093. CLASS="sect1"
  24094. ><HR><H2
  24095. CLASS="sect1"
  24096. ><A
  24097. NAME="control-structures.if"
  24098. ></A
  24099. ><TT
  24100. CLASS="literal"
  24101. >if</TT
  24102. ></H2
  24103. ><P
  24104. >     Konstrukt <TT
  24105. CLASS="literal"
  24106. >if</TT
  24107. > je jednφm z nejd∙le╛it∞j╣φch prvk∙ v
  24108.     mnoha jazycφch, vΦetn∞ PHP. Umo╛≥uje podmφn∞nΘ provßd∞nφ kusu k≤du.
  24109.     Struktura <TT
  24110. CLASS="literal"
  24111. >if</TT
  24112. > v PHP je podobnß struktu°e v C:
  24113.     <DIV
  24114. CLASS="informalexample"
  24115. ><A
  24116. NAME="AEN4748"
  24117. ></A
  24118. ><P
  24119. ></P
  24120. ><TABLE
  24121. BORDER="0"
  24122. BGCOLOR="#E0E0E0"
  24123. CELLPADDING="5"
  24124. ><TR
  24125. ><TD
  24126. ><PRE
  24127. CLASS="programlisting"
  24128. >if (expr)
  24129.     statement</PRE
  24130. ></TD
  24131. ></TR
  24132. ></TABLE
  24133. ><P
  24134. ></P
  24135. ></DIV
  24136. >
  24137.    </P
  24138. ><P
  24139. >     Jak je popsßno v
  24140.     <A
  24141. HREF="#language.expressions"
  24142. >sekci o v²razech</A
  24143. >,
  24144.     v²raz <TT
  24145. CLASS="replaceable"
  24146. ><I
  24147. >expr</I
  24148. ></TT
  24149. > je ohodnoce svou boolovskou hodnotou.
  24150.     Poku je <TT
  24151. CLASS="replaceable"
  24152. ><I
  24153. >expr</I
  24154. ></TT
  24155. > ohodnocen jako <TT
  24156. CLASS="constant"
  24157. ><B
  24158. >TRUE</B
  24159. ></TT
  24160. >, PHP
  24161.     provede <TT
  24162. CLASS="replaceable"
  24163. ><I
  24164. >statement</I
  24165. ></TT
  24166. >; je-li ohodnocen jako
  24167.     <TT
  24168. CLASS="constant"
  24169. ><B
  24170. >FALSE</B
  24171. ></TT
  24172. >, neprovede se nic. Vφce informacφ o to, jak se v²razy ohodnocujφ
  24173.     jako <TT
  24174. CLASS="constant"
  24175. ><B
  24176. >FALSE</B
  24177. ></TT
  24178. > najdete v Φßsti
  24179.     <A
  24180. HREF="#language.types.boolean.casting"
  24181. >'Konverze na typ boolean'</A
  24182. >.
  24183.    </P
  24184. ><P
  24185. >     Nßsledujφcφ p°φklad by vypsal
  24186.     <TT
  24187. CLASS="computeroutput"
  24188. >a je v∞t╣φ ne╛ b</TT
  24189. >,
  24190.     pokud <TT
  24191. CLASS="replaceable"
  24192. ><I
  24193. >$a</I
  24194. ></TT
  24195. > je v∞t╣φ ne╛ <TT
  24196. CLASS="replaceable"
  24197. ><I
  24198. >$b</I
  24199. ></TT
  24200. >:
  24201.     <DIV
  24202. CLASS="informalexample"
  24203. ><A
  24204. NAME="AEN4763"
  24205. ></A
  24206. ><P
  24207. ></P
  24208. ><TABLE
  24209. BORDER="0"
  24210. BGCOLOR="#E0E0E0"
  24211. CELLPADDING="5"
  24212. ><TR
  24213. ><TD
  24214. ><PRE
  24215. CLASS="php"
  24216. >if ($a > $b)
  24217.     print "a je v∞t╣φ ne╛ b";</PRE
  24218. ></TD
  24219. ></TR
  24220. ></TABLE
  24221. ><P
  24222. ></P
  24223. ></DIV
  24224. >
  24225.    </P
  24226. ><P
  24227. >     ╚asto byste cht∞li, aby se podmφn∞n∞ provßd∞l vφce ne╛ jeden konstrukt.
  24228.     Nenφ samoz°ejm∞ nutnΘ ka╛d² konstrukt zabalit do struktury
  24229.     <TT
  24230. CLASS="literal"
  24231. >if</TT
  24232. >. Mφsto toho m∙╛ete seskupit vφce konstrukt∙ do
  24233.     bloku. Nap°φklad tento k≤d by zobrazil
  24234.     <TT
  24235. CLASS="computeroutput"
  24236. >a je v∞t╣φ ne╛ b</TT
  24237. >, pokud
  24238.     <TT
  24239. CLASS="replaceable"
  24240. ><I
  24241. >$a</I
  24242. ></TT
  24243. > je v∞t╣φ ne╛ <TT
  24244. CLASS="replaceable"
  24245. ><I
  24246. >$b</I
  24247. ></TT
  24248. >
  24249.     a p°i°adil by hodnotu <TT
  24250. CLASS="replaceable"
  24251. ><I
  24252. >$a</I
  24253. ></TT
  24254. >
  24255.     do <TT
  24256. CLASS="replaceable"
  24257. ><I
  24258. >$b</I
  24259. ></TT
  24260. >:
  24261.     <DIV
  24262. CLASS="informalexample"
  24263. ><A
  24264. NAME="AEN4772"
  24265. ></A
  24266. ><P
  24267. ></P
  24268. ><TABLE
  24269. BORDER="0"
  24270. BGCOLOR="#E0E0E0"
  24271. CELLPADDING="5"
  24272. ><TR
  24273. ><TD
  24274. ><PRE
  24275. CLASS="php"
  24276. >if ($a > $b) {
  24277.     print "a je v∞t╣φ ne╛ b";
  24278.     $b = $a;
  24279. }</PRE
  24280. ></TD
  24281. ></TR
  24282. ></TABLE
  24283. ><P
  24284. ></P
  24285. ></DIV
  24286. >
  24287.    </P
  24288. ><P
  24289. >     Konstrukty <TT
  24290. CLASS="literal"
  24291. >if</TT
  24292. > mohou b²t libovoln∞ vno°ovßny do jin²ch    
  24293.     konstrukt∙ <TT
  24294. CLASS="literal"
  24295. >if</TT
  24296. >, co╛ poskytuje plnou flexibilitu
  24297.     podmφn∞nΘho provßd∞nφ r∙zn²ch Φßstφ programu.
  24298.    </P
  24299. ></DIV
  24300. ><DIV
  24301. CLASS="sect1"
  24302. ><HR><H2
  24303. CLASS="sect1"
  24304. ><A
  24305. NAME="control-structures.else"
  24306. ></A
  24307. ><TT
  24308. CLASS="literal"
  24309. >else</TT
  24310. ></H2
  24311. ><P
  24312. >     ╚asto takΘ m∙╛ete chtφt n∞co provßd∞t, pokud je jistß podmφnka spln∞na,
  24313.     a n∞co jinΘho, kdy╛ spln∞na nenφ. To umo╛≥uje konstrukt
  24314.     <TT
  24315. CLASS="literal"
  24316. >else</TT
  24317. >.  <TT
  24318. CLASS="literal"
  24319. >else</TT
  24320. > roz╣i°uje
  24321.     konstrukt <TT
  24322. CLASS="literal"
  24323. >if</TT
  24324. > o provßd∞nφ k≤du v p°φpad∞, ╛e v²raz
  24325.     v konstruktu <TT
  24326. CLASS="literal"
  24327. >if</TT
  24328. > je ohodnocen jako <TT
  24329. CLASS="constant"
  24330. ><B
  24331. >FALSE</B
  24332. ></TT
  24333. >.  Nap°φklad
  24334.     nßsledujφcφ k≤d vypφ╣e <TT
  24335. CLASS="computeroutput"
  24336. >a je v∞t╣φ ne╛ b</TT
  24337. >,
  24338.     pokud <TT
  24339. CLASS="replaceable"
  24340. ><I
  24341. >$a</I
  24342. ></TT
  24343. > je v∞t╣φ ne╛
  24344.     <TT
  24345. CLASS="replaceable"
  24346. ><I
  24347. >$b</I
  24348. ></TT
  24349. >, a
  24350.     <TT
  24351. CLASS="computeroutput"
  24352. >a NEN═ v∞t╣φ ne╛ b</TT
  24353. > v ostatnφch p°φpadech:
  24354.     <DIV
  24355. CLASS="informalexample"
  24356. ><A
  24357. NAME="AEN4790"
  24358. ></A
  24359. ><P
  24360. ></P
  24361. ><TABLE
  24362. BORDER="0"
  24363. BGCOLOR="#E0E0E0"
  24364. CELLPADDING="5"
  24365. ><TR
  24366. ><TD
  24367. ><PRE
  24368. CLASS="php"
  24369. >if ($a > $b) {
  24370.     print "a je v∞t╣φ ne╛ b";
  24371. } else {
  24372.     print "a NEN═ v∞t╣φ ne╛ b";
  24373. }</PRE
  24374. ></TD
  24375. ></TR
  24376. ></TABLE
  24377. ><P
  24378. ></P
  24379. ></DIV
  24380. >
  24381.  
  24382.     Konstrukt v <TT
  24383. CLASS="literal"
  24384. >else</TT
  24385. > se provßdφ, pouze pokud je v²raz v
  24386.     <TT
  24387. CLASS="literal"
  24388. >if</TT
  24389. > ohodnocen jako <TT
  24390. CLASS="constant"
  24391. ><B
  24392. >FALSE</B
  24393. ></TT
  24394. >, a pokud by zde byly n∞jakΘ
  24395.     v²razy <TT
  24396. CLASS="literal"
  24397. >elseif</TT
  24398. > - pouze pokud by byly takΘ ohodnoceny
  24399.     jako <TT
  24400. CLASS="constant"
  24401. ><B
  24402. >FALSE</B
  24403. ></TT
  24404. > (viz <A
  24405. HREF="#control-structures.elseif"
  24406. >elseif</A
  24407. >).
  24408.  
  24409.    </P
  24410. ></DIV
  24411. ><DIV
  24412. CLASS="sect1"
  24413. ><HR><H2
  24414. CLASS="sect1"
  24415. ><A
  24416. NAME="control-structures.elseif"
  24417. ></A
  24418. ><TT
  24419. CLASS="literal"
  24420. >elseif</TT
  24421. ></H2
  24422. ><P
  24423. >     Jak nßzev napovφdß, <TT
  24424. CLASS="literal"
  24425. >elseif</TT
  24426. >, je kombinacφ
  24427.     <TT
  24428. CLASS="literal"
  24429. >if</TT
  24430. > a <TT
  24431. CLASS="literal"
  24432. >else</TT
  24433. >.  Stejn∞ jako
  24434.     <TT
  24435. CLASS="literal"
  24436. >else</TT
  24437. >, roz╣i°uje konstrukt <TT
  24438. CLASS="literal"
  24439. >if</TT
  24440. >
  24441.     k provßd∞nφ odli╣n²ch konstrukt∙ v p°φpad∞, ╛e jev²raz p∙vodnφho konstruktu
  24442.     <TT
  24443. CLASS="literal"
  24444. >if</TT
  24445. > ohodnocen jako <TT
  24446. CLASS="constant"
  24447. ><B
  24448. >FALSE</B
  24449. ></TT
  24450. >.  Tedy, narozdφl od
  24451.     <TT
  24452. CLASS="literal"
  24453. >else</TT
  24454. >, se provßdφ pouze tehdy, je-li v²raz v podmφnce
  24455.     <TT
  24456. CLASS="literal"
  24457. >elseif</TT
  24458. > ohodnocen jako <TT
  24459. CLASS="constant"
  24460. ><B
  24461. >TRUE</B
  24462. ></TT
  24463. >.  Nap°φklad nßsledujφcφ
  24464.     k≤d vypφ╣e <TT
  24465. CLASS="computeroutput"
  24466. >a je v∞t╣φ ne╛ b</TT
  24467. >,
  24468.     <TT
  24469. CLASS="computeroutput"
  24470. >a se rovnß b</TT
  24471. >
  24472.     nebo <TT
  24473. CLASS="computeroutput"
  24474. >a je men╣φ ne╛ b</TT
  24475. >:
  24476.     <DIV
  24477. CLASS="informalexample"
  24478. ><A
  24479. NAME="AEN4815"
  24480. ></A
  24481. ><P
  24482. ></P
  24483. ><TABLE
  24484. BORDER="0"
  24485. BGCOLOR="#E0E0E0"
  24486. CELLPADDING="5"
  24487. ><TR
  24488. ><TD
  24489. ><PRE
  24490. CLASS="php"
  24491. >if ($a > $b) {
  24492.     print "a je v∞t╣φ ne╛ b";
  24493. } elseif ($a == $b) {
  24494.     print "a se rovnß b";
  24495. } else {
  24496.     print "a je men╣φ ne╛ b";
  24497. }</PRE
  24498. ></TD
  24499. ></TR
  24500. ></TABLE
  24501. ><P
  24502. ></P
  24503. ></DIV
  24504. >
  24505.    </P
  24506. ><P
  24507. >     V rßmci jednoho konstruktu <TT
  24508. CLASS="literal"
  24509. >if</TT
  24510. > m∙╛e b²t vφce
  24511.     konstrukt∙ <TT
  24512. CLASS="literal"
  24513. >elseif</TT
  24514. >. Provßdφ se prvnφ konstrukt
  24515.     <TT
  24516. CLASS="literal"
  24517. >elseif</TT
  24518. > (pokud v∙bec n∞jak²), jeho╛ v²raz je ohodnocen
  24519.     <TT
  24520. CLASS="constant"
  24521. ><B
  24522. >TRUE</B
  24523. ></TT
  24524. >. V PHP m∙╛ete napsat i 'else if' (dv∞ma slovy), chovßnφ bude
  24525.     naprosto toto╛nΘ jako u 'elseif' (jednφm slovem).  Syntaktick² v²znam
  24526.     je mφrn∞ odli╣n² (znßte-li C, je to stejnΘ), av╣ak ve v²sledku dostaneme
  24527.     p°esn∞ toto╛nΘ chovßnφ.
  24528.    </P
  24529. ><P
  24530. >     Konstrukt <TT
  24531. CLASS="literal"
  24532. >elseif</TT
  24533. > se provßdφ, pouze jsou-li p°φslu╣n²
  24534.     (bezprost°edn∞ p°edchßzejφcφ) v²raz konstruktu <TT
  24535. CLASS="literal"
  24536. >if</TT
  24537. >
  24538.     a v²razy v╣ech p°φslu╣n²ch p°edchßzejφcφch konstrukt∙ 
  24539.     <TT
  24540. CLASS="literal"
  24541. >elseif</TT
  24542. > ohodnoceny jako <TT
  24543. CLASS="constant"
  24544. ><B
  24545. >FALSE</B
  24546. ></TT
  24547. >, a konkrΘtnφ v²raz
  24548.     v <TT
  24549. CLASS="literal"
  24550. >elseif</TT
  24551. > ohodnocen jako <TT
  24552. CLASS="constant"
  24553. ><B
  24554. >TRUE</B
  24555. ></TT
  24556. >.
  24557.    </P
  24558. ></DIV
  24559. ><DIV
  24560. CLASS="sect1"
  24561. ><HR><H2
  24562. CLASS="sect1"
  24563. ><A
  24564. NAME="control-structures.alternative-syntax"
  24565. ></A
  24566. >Alternativnφ syntaxe °φdicφch struktur</H2
  24567. ><P
  24568. >     PHP nabφzφ alternativnφ syntaxi pro n∞kterΘ z °φdicφch struktur,
  24569.     jmenovit∞ <TT
  24570. CLASS="literal"
  24571. >if</TT
  24572. >,
  24573.     <TT
  24574. CLASS="literal"
  24575. >while</TT
  24576. >, <TT
  24577. CLASS="literal"
  24578. >for</TT
  24579. >,
  24580.     <TT
  24581. CLASS="literal"
  24582. >foreach</TT
  24583. >, a <TT
  24584. CLASS="literal"
  24585. >switch</TT
  24586. >.
  24587.     V ka╛dΘm z t∞chto p°φpad∙ je zßkladnφm formßtem alternativnφ syntaxe
  24588.     zßm∞na otvφracφ zßvorky za dvojteΦku (:) a uzavφracφ zßvorky za
  24589.     <TT
  24590. CLASS="literal"
  24591. >endif;</TT
  24592. >, <TT
  24593. CLASS="literal"
  24594. >endwhile;</TT
  24595. >,
  24596.     <TT
  24597. CLASS="literal"
  24598. >endfor;</TT
  24599. >, <TT
  24600. CLASS="literal"
  24601. >endforeach;</TT
  24602. >, resp.
  24603.     <TT
  24604. CLASS="literal"
  24605. >endswitch;</TT
  24606. >.
  24607.     <DIV
  24608. CLASS="informalexample"
  24609. ><A
  24610. NAME="AEN4842"
  24611. ></A
  24612. ><P
  24613. ></P
  24614. ><TABLE
  24615. BORDER="0"
  24616. BGCOLOR="#E0E0E0"
  24617. CELLPADDING="5"
  24618. ><TR
  24619. ><TD
  24620. ><PRE
  24621. CLASS="php"
  24622. ><?php if ($a == 5): ?>
  24623. A se rovnß 5
  24624. <?php endif; ?></PRE
  24625. ></TD
  24626. ></TR
  24627. ></TABLE
  24628. ><P
  24629. ></P
  24630. ></DIV
  24631. >
  24632.    </P
  24633. ><P
  24634. >     Ve v²╣e uvedenΘm p°φkladu je HTML blok vno°en do konstruktu
  24635.     <TT
  24636. CLASS="literal"
  24637. >if</TT
  24638. > napsanΘm alternativnφ syntaxφ.
  24639.     Tento HTML blok by se zobrazil pouze v p°φpad∞, ╛e je $a rovno 5.
  24640.    </P
  24641. ><P
  24642. >     Alternativnφ syntaxi lze pou╛φt i pro <TT
  24643. CLASS="literal"
  24644. >else</TT
  24645. > a
  24646.     <TT
  24647. CLASS="literal"
  24648. >elseif</TT
  24649. >. Nßsledujφcφ p°φklad ukazuje strukturu
  24650.     <TT
  24651. CLASS="literal"
  24652. >if</TT
  24653. >, <TT
  24654. CLASS="literal"
  24655. >elseif</TT
  24656. > a
  24657.     <TT
  24658. CLASS="literal"
  24659. >else</TT
  24660. > v alternativnφm formßtu:
  24661.     <DIV
  24662. CLASS="informalexample"
  24663. ><A
  24664. NAME="AEN4852"
  24665. ></A
  24666. ><P
  24667. ></P
  24668. ><TABLE
  24669. BORDER="0"
  24670. BGCOLOR="#E0E0E0"
  24671. CELLPADDING="5"
  24672. ><TR
  24673. ><TD
  24674. ><PRE
  24675. CLASS="php"
  24676. >if ($a == 5):
  24677.     print "a se rovnß 5";
  24678.     print "...";
  24679. elseif ($a == 6):
  24680.     print "a se rovnß 6";
  24681.     print "!!!";
  24682. else:
  24683.     print "a nenφ ani 5, ani 6";
  24684. endif;</PRE
  24685. ></TD
  24686. ></TR
  24687. ></TABLE
  24688. ><P
  24689. ></P
  24690. ></DIV
  24691. >
  24692.    </P
  24693. ><P
  24694. >     Dal╣φ p°φklady - viz takΘ
  24695.     <A
  24696. HREF="#control-structures.while"
  24697. >while</A
  24698. >,
  24699.     <A
  24700. HREF="#control-structures.for"
  24701. >for</A
  24702. >, a <A
  24703. HREF="#control-structures.if"
  24704. >if</A
  24705. >.
  24706.    </P
  24707. ></DIV
  24708. ><DIV
  24709. CLASS="sect1"
  24710. ><HR><H2
  24711. CLASS="sect1"
  24712. ><A
  24713. NAME="control-structures.while"
  24714. ></A
  24715. ><TT
  24716. CLASS="literal"
  24717. >while</TT
  24718. ></H2
  24719. ><P
  24720. >     Cykly <TT
  24721. CLASS="literal"
  24722. >while</TT
  24723. > jsou nejjednodu╣╣φm typem cykl∙ v PHP.
  24724.     Chovajφ se jako jejich prot∞j╣ci v C. Zßkladφ formßt konstruktu
  24725.     <TT
  24726. CLASS="literal"
  24727. >while</TT
  24728. > je tento:
  24729.     <DIV
  24730. CLASS="informalexample"
  24731. ><A
  24732. NAME="AEN4864"
  24733. ></A
  24734. ><P
  24735. ></P
  24736. ><TABLE
  24737. BORDER="0"
  24738. BGCOLOR="#E0E0E0"
  24739. CELLPADDING="5"
  24740. ><TR
  24741. ><TD
  24742. ><PRE
  24743. CLASS="programlisting"
  24744. >while (expr) statement</PRE
  24745. ></TD
  24746. ></TR
  24747. ></TABLE
  24748. ><P
  24749. ></P
  24750. ></DIV
  24751. >
  24752.    </P
  24753. ><P
  24754. >     V²znam konstruktu <TT
  24755. CLASS="literal"
  24756. >while</TT
  24757. > je snadno pochopiteln².
  24758.     ╪φkß PHP, ╛e mß provßd∞t vno°en²(Θ) konstrukt(y) tak dlouho, dokud je
  24759.     v²raz ve <TT
  24760. CLASS="literal"
  24761. >while</TT
  24762. > roven <TT
  24763. CLASS="constant"
  24764. ><B
  24765. >TRUE</B
  24766. ></TT
  24767. >. Hodnota v²razu je testovßna
  24768.     poka╛dΘ na zaΦßtku cyklu (v ka╛dΘ iteraci), tak╛e i kdy╛ se tato hodnota
  24769.     b∞hem provßd∞nφ vno°en²ch konstrukt∙ zm∞nφ, provede se zbytek k≤du uvnit°
  24770.     cyklu - v konkrΘtnφ iteraci - a╛ do konce (ka╛dΘ provedenφ k≤du uvnit°
  24771.     cyklu je jedna iterace). N∞kdy, kdy╛ je v²raz ve 
  24772.     <TT
  24773. CLASS="literal"
  24774. >while</TT
  24775. > ohodnocen jako <TT
  24776. CLASS="constant"
  24777. ><B
  24778. >FALSE</B
  24779. ></TT
  24780. > ji╛ p°i vstupu do cyklu,
  24781.     vno°en² k≤d se neprovede v∙bec.
  24782.    </P
  24783. ><P
  24784. >     Podobn∞, jako v p°φpad∞ <TT
  24785. CLASS="literal"
  24786. >if</TT
  24787. >, m∙╛ete i zde seskupovat
  24788.     konstrukty uvnit° cyklu <TT
  24789. CLASS="literal"
  24790. >while</TT
  24791. > ohraniΦenφm tohoto
  24792.     k≤du slo╛en²mi zßvorkami nebo za pou╛itφ alternativnφ syntaxe:
  24793.     <DIV
  24794. CLASS="informalexample"
  24795. ><A
  24796. NAME="AEN4875"
  24797. ></A
  24798. ><P
  24799. ></P
  24800. ><TABLE
  24801. BORDER="0"
  24802. BGCOLOR="#E0E0E0"
  24803. CELLPADDING="5"
  24804. ><TR
  24805. ><TD
  24806. ><PRE
  24807. CLASS="programlisting"
  24808. >while (expr): statement ... endwhile;</PRE
  24809. ></TD
  24810. ></TR
  24811. ></TABLE
  24812. ><P
  24813. ></P
  24814. ></DIV
  24815. >
  24816.    </P
  24817. ><P
  24818. >     Nßsledujφcφ p°φklady jsou identickΘ, oba vypφ╣φ Φφsla od 1 do 10:
  24819.     <DIV
  24820. CLASS="informalexample"
  24821. ><A
  24822. NAME="AEN4878"
  24823. ></A
  24824. ><P
  24825. ></P
  24826. ><TABLE
  24827. BORDER="0"
  24828. BGCOLOR="#E0E0E0"
  24829. CELLPADDING="5"
  24830. ><TR
  24831. ><TD
  24832. ><PRE
  24833. CLASS="php"
  24834. >/* p°φklad 1 */
  24835.  
  24836. $i = 1;
  24837. while ($i <= 10) {
  24838.     print $i++;  /* vyti╣t∞nß hodnota by byla rovna
  24839.                     $i p°ed inkrementacφ
  24840.                     (post-inkrementace) */
  24841. }
  24842.  
  24843. /* p°φklad 2 */
  24844.  
  24845. $i = 1;
  24846. while ($i <= 10):
  24847.     print $i;
  24848.     $i++;
  24849. endwhile;</PRE
  24850. ></TD
  24851. ></TR
  24852. ></TABLE
  24853. ><P
  24854. ></P
  24855. ></DIV
  24856. >
  24857.    </P
  24858. ></DIV
  24859. ><DIV
  24860. CLASS="sect1"
  24861. ><HR><H2
  24862. CLASS="sect1"
  24863. ><A
  24864. NAME="control-structures.do.while"
  24865. ></A
  24866. ><TT
  24867. CLASS="literal"
  24868. >do..while</TT
  24869. ></H2
  24870. ><P
  24871. >     Cykly <TT
  24872. CLASS="literal"
  24873. >do..while</TT
  24874. > jsou velmi podobnΘ cykl∙m
  24875.     <TT
  24876. CLASS="literal"
  24877. >while</TT
  24878. > krom∞ toho, ╛e pravdivost v²razu se testuje
  24879.     na konci ka╛dΘ iterace namφsto jejφho zaΦßtku. Hlavnφ rozdφl oproti
  24880.     b∞╛n²m cykl∙m <TT
  24881. CLASS="literal"
  24882. >while</TT
  24883. > je ten, ╛e prvnφ iterace cyklu
  24884.     <TT
  24885. CLASS="literal"
  24886. >do..while</TT
  24887. > se provede v╛dy (pravdivostnφ v²raz je
  24888.     testovßn a╛ na konci iterace), co╛ u cyklu <TT
  24889. CLASS="literal"
  24890. >while</TT
  24891. >
  24892.     nenφ zaruΦeno (pravdivostnφ v²raz je testovßn na zaΦßtku iterace; pokud
  24893.     je ohodnocen jako <TT
  24894. CLASS="constant"
  24895. ><B
  24896. >FALSE</B
  24897. ></TT
  24898. >, provßd∞nφ cyklu hned skonΦφ).
  24899.    </P
  24900. ><P
  24901. >     Toto je jedinß syntaxe pro cykly <TT
  24902. CLASS="literal"
  24903. >do..while</TT
  24904. >:
  24905.  
  24906.     <DIV
  24907. CLASS="informalexample"
  24908. ><A
  24909. NAME="AEN4892"
  24910. ></A
  24911. ><P
  24912. ></P
  24913. ><TABLE
  24914. BORDER="0"
  24915. BGCOLOR="#E0E0E0"
  24916. CELLPADDING="5"
  24917. ><TR
  24918. ><TD
  24919. ><PRE
  24920. CLASS="php"
  24921. >$i = 0;
  24922. do {
  24923.    print $i;
  24924. } while ($i>0);</PRE
  24925. ></TD
  24926. ></TR
  24927. ></TABLE
  24928. ><P
  24929. ></P
  24930. ></DIV
  24931. >
  24932.    </P
  24933. ><P
  24934. >      V²╣e uveden² cyklus by se provedl prßv∞ jednou, proto╛e po prvnφ iteraci,
  24935.      kdy╛ se testuje pravdivostnφ v²raz, je tento ohodnocen jako <TT
  24936. CLASS="constant"
  24937. ><B
  24938. >FALSE</B
  24939. ></TT
  24940. >
  24941.      ($i nenφ v∞t╣φ ne╛ 0) a provßd∞nφ cyklu konΦφ.
  24942.    </P
  24943. ><P
  24944. >     PokroΦilφ programßto°i v C mohou znßt i odli╣nΘ pou╛itφ cyklu
  24945.     <TT
  24946. CLASS="literal"
  24947. >do..while</TT
  24948. >. K≤d se uzav°e do
  24949.     <TT
  24950. CLASS="literal"
  24951. >do..while</TT
  24952. >(0) a pou╛ije se p°φkaz
  24953.     <A
  24954. HREF="#control-structures.break"
  24955. ><TT
  24956. CLASS="literal"
  24957. >break</TT
  24958. ></A
  24959. >.
  24960.     To umo╛≥uje p°eru╣it provßd∞nφ cyklu uprost°ed k≤du, jak je znßzorn∞no
  24961.     v tomto p°φkladu:
  24962.     <DIV
  24963. CLASS="informalexample"
  24964. ><A
  24965. NAME="AEN4901"
  24966. ></A
  24967. ><P
  24968. ></P
  24969. ><TABLE
  24970. BORDER="0"
  24971. BGCOLOR="#E0E0E0"
  24972. CELLPADDING="5"
  24973. ><TR
  24974. ><TD
  24975. ><PRE
  24976. CLASS="php"
  24977. >do {
  24978.     if ($i < 5) {
  24979.         print "i nenφ dost velkΘ";
  24980.         break;
  24981.     }
  24982.     $i *= $factor;
  24983.     if ($i < $minimum_limit) {
  24984.         break;
  24985.     }
  24986.     print "i je ok";
  24987.  
  24988.      ...zpracuj i...
  24989.  
  24990. } while(0);</PRE
  24991. ></TD
  24992. ></TR
  24993. ></TABLE
  24994. ><P
  24995. ></P
  24996. ></DIV
  24997. >
  24998.    </P
  24999. ><P
  25000. >     Ned∞lejte si nic z toho, ╛e tomu hned a beze zbytku nerozumφte. M∙╛ete
  25001.     psßt skripty, a to i velmi ·ΦinnΘ skripty, i bez pou╛itφ tΘto 'finty'.
  25002.    </P
  25003. ></DIV
  25004. ><DIV
  25005. CLASS="sect1"
  25006. ><HR><H2
  25007. CLASS="sect1"
  25008. ><A
  25009. NAME="control-structures.for"
  25010. ></A
  25011. ><TT
  25012. CLASS="literal"
  25013. >for</TT
  25014. ></H2
  25015. ><P
  25016. >     Cykly <TT
  25017. CLASS="literal"
  25018. >for</TT
  25019. > jsou nejslo╛it∞j╣φmi cykly v PHP. Chovajφ se
  25020.     stejn∞, jako jejich soukmenovci v C. Syntaxe cyklu <TT
  25021. CLASS="literal"
  25022. >for</TT
  25023. >
  25024.     je nßsledujφcφ:
  25025.     <DIV
  25026. CLASS="informalexample"
  25027. ><A
  25028. NAME="AEN4910"
  25029. ></A
  25030. ><P
  25031. ></P
  25032. ><TABLE
  25033. BORDER="0"
  25034. BGCOLOR="#E0E0E0"
  25035. CELLPADDING="5"
  25036. ><TR
  25037. ><TD
  25038. ><PRE
  25039. CLASS="programlisting"
  25040. >for (expr1; expr2; expr3) statement</PRE
  25041. ></TD
  25042. ></TR
  25043. ></TABLE
  25044. ><P
  25045. ></P
  25046. ></DIV
  25047. >
  25048.    </P
  25049. ><P
  25050. >     Prvnφ v²raz (<TT
  25051. CLASS="replaceable"
  25052. ><I
  25053. >expr1</I
  25054. ></TT
  25055. >) je ohodnocen (proveden)
  25056.     jednou, bezpodmφneΦn∞, na zaΦßtku cyklu.
  25057.    </P
  25058. ><P
  25059. >     Na zaΦßtku ka╛dΘ iterace je ohodnocen v²raz
  25060.     <TT
  25061. CLASS="replaceable"
  25062. ><I
  25063. >expr2</I
  25064. ></TT
  25065. >. Pokud mß hodnotu <TT
  25066. CLASS="constant"
  25067. ><B
  25068. >TRUE</B
  25069. ></TT
  25070. >, cyklus pokraΦuje
  25071.     a zpracovßvß se k≤d uvnit° cyklu. Je-li naopak jeho hodnota <TT
  25072. CLASS="constant"
  25073. ><B
  25074. >FALSE</B
  25075. ></TT
  25076. >,
  25077.     provßd∞nφ cyklu konΦφ.
  25078.    </P
  25079. ><P
  25080. >     Na konci ka╛dΘ iterace se ohodnotφ (provede) v²raz 
  25081.     <TT
  25082. CLASS="replaceable"
  25083. ><I
  25084. >expr3</I
  25085. ></TT
  25086. >.
  25087.    </P
  25088. ><P
  25089. >     Ka╛d² z v²raz∙ m∙╛e b²t prßzdn². Prßzdn² v²raz
  25090.     <TT
  25091. CLASS="replaceable"
  25092. ><I
  25093. >expr2</I
  25094. ></TT
  25095. > znamenß, ╛e cyklus bude probφhat
  25096.     nekoneΦn∞ dlouho (PHP, stejn∞ jako C, implicitn∞ p°edpoklßdß hodnotu
  25097.     <TT
  25098. CLASS="constant"
  25099. ><B
  25100. >TRUE</B
  25101. ></TT
  25102. >). To nemusφ b²t tak bez u╛itku, jak si m∙╛ete myslet. ╚asto m∙╛ete
  25103.     toti╛ chtφt ukonΦit cyklus pomocφ podmφn∞nΘho p°φkazu
  25104.     <A
  25105. HREF="#control-structures.break"
  25106. ><TT
  25107. CLASS="literal"
  25108. >break</TT
  25109. ></A
  25110. >,
  25111.     namφsto pou╛itφ pravdivostnφho v²razu v konstruktu cyklu
  25112.     <TT
  25113. CLASS="literal"
  25114. >for</TT
  25115. >.
  25116.    </P
  25117. ><P
  25118. >     P°edpoklßdejme nßsledujφcφ p°φklady. V╣echny zobrazφ Φφsla od 1 do 10:
  25119.     <DIV
  25120. CLASS="informalexample"
  25121. ><A
  25122. NAME="AEN4927"
  25123. ></A
  25124. ><P
  25125. ></P
  25126. ><TABLE
  25127. BORDER="0"
  25128. BGCOLOR="#E0E0E0"
  25129. CELLPADDING="5"
  25130. ><TR
  25131. ><TD
  25132. ><PRE
  25133. CLASS="php"
  25134. >/* p°φklad 1 */
  25135.  
  25136. for ($i = 1; $i <= 10; $i++) {
  25137.     print $i;
  25138. }
  25139.  
  25140. /* p°φklad 2 */
  25141.  
  25142. for ($i = 1;;$i++) {
  25143.     if ($i > 10) {
  25144.         break;
  25145.     }
  25146.     print $i;
  25147. }
  25148.  
  25149. /* p°φklad 3 */
  25150.  
  25151. $i = 1;
  25152. for (;;) {
  25153.     if ($i > 10) {
  25154.         break;
  25155.     }
  25156.     print $i;
  25157.     $i++;
  25158. }
  25159.  
  25160. /* p°φklad 4 */
  25161.  
  25162. for ($i = 1; $i <= 10; print $i, $i++);</PRE
  25163. ></TD
  25164. ></TR
  25165. ></TABLE
  25166. ><P
  25167. ></P
  25168. ></DIV
  25169. >
  25170.    </P
  25171. ><P
  25172. >     Prvnφ p°φklad samoz°ejm∞ vypadß nejlΘpe (nebo mo╛nß i ten Φtvrt²), ale
  25173.     m∙╛ete p°ijφt na to, ╛e schopnost pou╛φvat prßzdnΘ v²razy v cyklech
  25174.     <TT
  25175. CLASS="literal"
  25176. >for</TT
  25177. > nemusφ b²t n∞kdy ·pln∞ k zahozenφ.
  25178.    </P
  25179. ><P
  25180. >     PHP podporuje pro cykly <TT
  25181. CLASS="literal"
  25182. >for</TT
  25183. > takΘ alternativnφ
  25184.     "dvojteΦkovou syntaxi".
  25185.     <DIV
  25186. CLASS="informalexample"
  25187. ><A
  25188. NAME="AEN4933"
  25189. ></A
  25190. ><P
  25191. ></P
  25192. ><TABLE
  25193. BORDER="0"
  25194. BGCOLOR="#E0E0E0"
  25195. CELLPADDING="5"
  25196. ><TR
  25197. ><TD
  25198. ><PRE
  25199. CLASS="programlisting"
  25200. >for (expr1; expr2; expr3): statement; ...; endfor;</PRE
  25201. ></TD
  25202. ></TR
  25203. ></TABLE
  25204. ><P
  25205. ></P
  25206. ></DIV
  25207. >
  25208.    </P
  25209. ><P
  25210. >     JinΘ jazyky majφ konstrukt <TT
  25211. CLASS="literal"
  25212. >foreach</TT
  25213. > k traverzovßnφ
  25214.     polφ nebo hash∙. V PHP 3 nic takovΘho nenφ, PHP 4 ano (viz <A
  25215. HREF="#control-structures.foreach"
  25216. >foreach</A
  25217. >). V PHP 3 m∙╛ete
  25218.     k dosa╛enφ stejnΘho efektu kombinovat
  25219.     <A
  25220. HREF="#control-structures.while"
  25221. >while</A
  25222. > s funkcemi
  25223.     <A
  25224. HREF="#function.list"
  25225. ><B
  25226. CLASS="function"
  25227. >list()</B
  25228. ></A
  25229. > a <A
  25230. HREF="#function.each"
  25231. ><B
  25232. CLASS="function"
  25233. >each()</B
  25234. ></A
  25235. >. P°φklady najdete
  25236.     v dokumentaci.
  25237.    </P
  25238. ></DIV
  25239. ><DIV
  25240. CLASS="sect1"
  25241. ><HR><H2
  25242. CLASS="sect1"
  25243. ><A
  25244. NAME="control-structures.foreach"
  25245. ></A
  25246. ><TT
  25247. CLASS="literal"
  25248. >foreach</TT
  25249. ></H2
  25250. ><P
  25251. >     PHP 4 (ne PHP 3) zahrnuje konstrukt <TT
  25252. CLASS="literal"
  25253. >foreach</TT
  25254. >, podobn∞
  25255.     jako Perl a r∙znΘ dal╣φ jazyky. To poskytuje snadn² zp∙sob k iteraci
  25256.     p°es pole. Existujφ dv∞ syntaxe; ta druhß je men╣φm, av╣ak u╛iteΦn²m
  25257.     roz╣φ°enφm tΘ prvnφ:
  25258.     <DIV
  25259. CLASS="informalexample"
  25260. ><A
  25261. NAME="AEN4946"
  25262. ></A
  25263. ><P
  25264. ></P
  25265. ><TABLE
  25266. BORDER="0"
  25267. BGCOLOR="#E0E0E0"
  25268. CELLPADDING="5"
  25269. ><TR
  25270. ><TD
  25271. ><PRE
  25272. CLASS="programlisting"
  25273. >foreach(array_expression as $value) statement
  25274. foreach(array_expression as $key => $value) statement</PRE
  25275. ></TD
  25276. ></TR
  25277. ></TABLE
  25278. ><P
  25279. ></P
  25280. ></DIV
  25281. >
  25282.    </P
  25283. ><P
  25284. >     Prvnφ forma traverzuje pole danΘ v²razem
  25285.     <TT
  25286. CLASS="literal"
  25287. >array_expression</TT
  25288. >. V ka╛dΘ iteraci je hodnota aktußlnφho
  25289.     elementu p°i°azena do <TT
  25290. CLASS="literal"
  25291. >$value</TT
  25292. > a vnit°nφ ukazatel na pole
  25293.     je zv²╣en o jednotku (tzn. v p°φ╣tφ iteraci budete hled∞t na nßsledujφcφ
  25294.     element).
  25295.    </P
  25296. ><P
  25297. >     Druhß forma d∞lß totΘ╛, krom∞ toho, ╛e aktußlnφ klφΦ elementu bude
  25298.     v ka╛dΘ iteraci p°i°azen do prom∞nnΘ <TT
  25299. CLASS="literal"
  25300. >$key</TT
  25301. >.
  25302.    </P
  25303. ><P
  25304. >     <DIV
  25305. CLASS="note"
  25306. ><BLOCKQUOTE
  25307. CLASS="note"
  25308. ><P
  25309. ><B
  25310. >Poznßmka: </B
  25311. >
  25312.       Kdy╛ <TT
  25313. CLASS="literal"
  25314. >foreach</TT
  25315. > zaΦne provßd∞nφ prvnφ iterace,
  25316.       je vnit°nφ ukazatel automaticky nastaven na prvnφ element pole. To
  25317.       znamenß, ╛e p°ed <TT
  25318. CLASS="literal"
  25319. >foreach</TT
  25320. > nemusφte volat
  25321.       <A
  25322. HREF="#function.reset"
  25323. ><B
  25324. CLASS="function"
  25325. >reset()</B
  25326. ></A
  25327. >.
  25328.      </P
  25329. ></BLOCKQUOTE
  25330. ></DIV
  25331. >
  25332.    </P
  25333. ><P
  25334. >     <DIV
  25335. CLASS="note"
  25336. ><BLOCKQUOTE
  25337. CLASS="note"
  25338. ><P
  25339. ><B
  25340. >Poznßmka: </B
  25341. >
  25342.       Uv∞domte si takΘ, ╛e <TT
  25343. CLASS="literal"
  25344. >foreach</TT
  25345. > pracuje na kopii
  25346.       specifikovanΘho pole, nikoli na poli samotnΘm, proto ukazatel na pole
  25347.       nenφ modifikovßn tak, jako konstruktem <A
  25348. HREF="#function.each"
  25349. ><B
  25350. CLASS="function"
  25351. >each()</B
  25352. ></A
  25353. > a
  25354.       zm∞ny na vrßcenΘm elementu se na p∙vodnφm poli neprojevφ.
  25355.      </P
  25356. ></BLOCKQUOTE
  25357. ></DIV
  25358. >
  25359.    </P
  25360. ><DIV
  25361. CLASS="note"
  25362. ><BLOCKQUOTE
  25363. CLASS="note"
  25364. ><P
  25365. ><B
  25366. >Poznßmka: </B
  25367. >
  25368.      <TT
  25369. CLASS="literal"
  25370. >foreach</TT
  25371. > nepodporuje mo╛nost potlaΦit chybovß hlß╣enφ
  25372.      pou╛itφm '@'.
  25373.     </P
  25374. ></BLOCKQUOTE
  25375. ></DIV
  25376. ><P
  25377. >     M∙╛ete si v╣imnout, ╛e nßsledujφcφ p°φklady jsou funkΦn∞ toto╛nΘ:
  25378.     <DIV
  25379. CLASS="informalexample"
  25380. ><A
  25381. NAME="AEN4968"
  25382. ></A
  25383. ><P
  25384. ></P
  25385. ><TABLE
  25386. BORDER="0"
  25387. BGCOLOR="#E0E0E0"
  25388. CELLPADDING="5"
  25389. ><TR
  25390. ><TD
  25391. ><PRE
  25392. CLASS="php"
  25393. >reset ($arr);
  25394. while (list(, $value) = each ($arr)) {
  25395.     echo "Hodnota: $value<br>\n";
  25396. }
  25397.  
  25398. foreach ($arr as $value) {
  25399.     echo "Hodnota: $value<br>\n";
  25400. }</PRE
  25401. ></TD
  25402. ></TR
  25403. ></TABLE
  25404. ><P
  25405. ></P
  25406. ></DIV
  25407. >
  25408.     Nßsledujφcφ p°φklady jsou rovn∞╛ funkΦn∞ toto╛nΘ:
  25409.     <DIV
  25410. CLASS="informalexample"
  25411. ><A
  25412. NAME="AEN4970"
  25413. ></A
  25414. ><P
  25415. ></P
  25416. ><TABLE
  25417. BORDER="0"
  25418. BGCOLOR="#E0E0E0"
  25419. CELLPADDING="5"
  25420. ><TR
  25421. ><TD
  25422. ><PRE
  25423. CLASS="php"
  25424. >reset ($arr);
  25425. while (list($key, $value) = each ($arr)) {
  25426.     echo "KlφΦ: $key; Hodnota: $value<br>\n";
  25427. }
  25428.  
  25429. foreach ($arr as $key => $value) {
  25430.     echo "KlφΦ: $key; Hodnota: $value<br>\n";
  25431. }</PRE
  25432. ></TD
  25433. ></TR
  25434. ></TABLE
  25435. ><P
  25436. ></P
  25437. ></DIV
  25438. >
  25439.    </P
  25440. ><P
  25441. >     Dal╣φ p°φklady demonstrujφcφ pou╛φtφ:
  25442.     <DIV
  25443. CLASS="informalexample"
  25444. ><A
  25445. NAME="AEN4973"
  25446. ></A
  25447. ><P
  25448. ></P
  25449. ><TABLE
  25450. BORDER="0"
  25451. BGCOLOR="#E0E0E0"
  25452. CELLPADDING="5"
  25453. ><TR
  25454. ><TD
  25455. ><PRE
  25456. CLASS="php"
  25457. >/* foreach p°φklad 1: pouze hodnota */
  25458.  
  25459. $a = array (1, 2, 3, 17);
  25460.  
  25461. foreach ($a as $v) {
  25462.    print "SouΦasnß hodnota \$a: $v.\n";
  25463. }
  25464.  
  25465. /* foreach p°φklad 2: hodnota (pro ilustraci je vypsßn i klφΦ) */
  25466.  
  25467. $a = array (1, 2, 3, 17);
  25468.  
  25469. $i = 0; /* pouze pro ilustrativnφ ·Φely */
  25470.  
  25471. foreach($a as $v) {
  25472.     print "\$a[$i] => $v.\n";
  25473.     $i++;
  25474. }
  25475.  
  25476. /* foreach p°φklad 3: klφΦ a hodnota */
  25477.  
  25478. $a = array (
  25479.     "jedna" => 1,
  25480.     "dv∞" => 2,
  25481.     "t°i" => 3,
  25482.     "sedmnßct" => 17
  25483. );
  25484.  
  25485. foreach($a as $k => $v) {
  25486.     print "\$a[$k] => $v.\n";
  25487. }
  25488.  
  25489. /* foreach p°φklad 4: vφcerozm∞rnß pole */
  25490.  
  25491. $a[0][0] = "a";
  25492. $a[0][1] = "b";
  25493. $a[1][0] = "y";
  25494. $a[1][1] = "z";
  25495.  
  25496. foreach($a as $v1) {
  25497.     foreach ($v1 as $v2) {
  25498.         print "$v2\n";
  25499.     }
  25500. }
  25501.  
  25502. /* foreach p°φklad 5: dynamickß pole */
  25503.  
  25504. foreach(array(1, 2, 3, 4, 5) as $v) {
  25505.     print "$v\n";
  25506. }</PRE
  25507. ></TD
  25508. ></TR
  25509. ></TABLE
  25510. ><P
  25511. ></P
  25512. ></DIV
  25513. >
  25514.    </P
  25515. ></DIV
  25516. ><DIV
  25517. CLASS="sect1"
  25518. ><HR><H2
  25519. CLASS="sect1"
  25520. ><A
  25521. NAME="control-structures.break"
  25522. ></A
  25523. ><TT
  25524. CLASS="literal"
  25525. >break</TT
  25526. ></H2
  25527. ><P
  25528. >     <TT
  25529. CLASS="literal"
  25530. >break</TT
  25531. > ukonΦuje provßd∞nφ aktußlnφho konstruktu
  25532.     <TT
  25533. CLASS="literal"
  25534. >for</TT
  25535. >, <TT
  25536. CLASS="literal"
  25537. >foreach</TT
  25538. >
  25539.     <TT
  25540. CLASS="literal"
  25541. >while</TT
  25542. >, <TT
  25543. CLASS="literal"
  25544. >do..while</TT
  25545. > nebo
  25546.     <TT
  25547. CLASS="literal"
  25548. >switch</TT
  25549. >.
  25550.    </P
  25551. ><P
  25552. >     <TT
  25553. CLASS="literal"
  25554. >break</TT
  25555. > akceptuje nepovinn² Φφseln² argument, kter² °φkß,
  25556.     z kolika vno°en²ch struktur se mß vyskoΦit.
  25557.    </P
  25558. ><P
  25559. >     <DIV
  25560. CLASS="informalexample"
  25561. ><A
  25562. NAME="AEN4988"
  25563. ></A
  25564. ><P
  25565. ></P
  25566. ><TABLE
  25567. BORDER="0"
  25568. BGCOLOR="#E0E0E0"
  25569. CELLPADDING="5"
  25570. ><TR
  25571. ><TD
  25572. ><PRE
  25573. CLASS="php"
  25574. >$arr = array ('jedna', 'dv∞', 't°i', 'Φty°i', 'stop', 'p∞t');
  25575. while (list (, $val) = each ($arr)) {
  25576.     if ($val == 'stop') {
  25577.         break;    /* Tady byste mohli napsat takΘ 'break 1;'. */
  25578.     }
  25579.     echo "$val<br>\n";
  25580. }
  25581.  
  25582. /* Pou╛itφ nepovinnΘho argumentu. */
  25583.  
  25584. $i = 0;
  25585. while (++$i) {
  25586.     switch ($i) {
  25587.     case 5:
  25588.         echo "P°i 5<br>\n";
  25589.         break 1;  /* UkonΦuje pouze switch. */
  25590.     case 10:
  25591.         echo "P°i 10; konec<br>\n";
  25592.         break 2;  /* UkonΦuje switch a while. */
  25593.     default:
  25594.         break;
  25595.     }
  25596. }</PRE
  25597. ></TD
  25598. ></TR
  25599. ></TABLE
  25600. ><P
  25601. ></P
  25602. ></DIV
  25603. >
  25604.    </P
  25605. ></DIV
  25606. ><DIV
  25607. CLASS="sect1"
  25608. ><HR><H2
  25609. CLASS="sect1"
  25610. ><A
  25611. NAME="control-structures.continue"
  25612. ></A
  25613. ><TT
  25614. CLASS="literal"
  25615. >continue</TT
  25616. ></H2
  25617. ><P
  25618. >     <TT
  25619. CLASS="literal"
  25620. >continue</TT
  25621. > se pou╛φvß uvnit° cykl∙ k p°eskoΦenφ zbytku
  25622.     aktußlnφ iterace a bezprost°ednφmu p°echodu na nßsledujφcφ iteraci.
  25623.    </P
  25624. ><P
  25625. >     <TT
  25626. CLASS="literal"
  25627. >continue</TT
  25628. > akceptuje nepovinn² Φφseln² argument, kter²
  25629.     °φkß, kolik ·rovnφ cykl∙ se mß narßz dokonΦit.
  25630.    </P
  25631. ><P
  25632. >     <DIV
  25633. CLASS="informalexample"
  25634. ><A
  25635. NAME="AEN4998"
  25636. ></A
  25637. ><P
  25638. ></P
  25639. ><TABLE
  25640. BORDER="0"
  25641. BGCOLOR="#E0E0E0"
  25642. CELLPADDING="5"
  25643. ><TR
  25644. ><TD
  25645. ><PRE
  25646. CLASS="php"
  25647. >while (list ($key, $value) = each ($arr)) {
  25648.     if (!($key % 2)) { // p°eskoΦ sudΘ Φleny
  25649.         continue;
  25650.     }
  25651.     do_something_odd ($value);
  25652. }
  25653.  
  25654. $i = 0;
  25655. while ($i++ &lt; 5) {
  25656.     echo "Vn∞j╣φ<br>\n";
  25657.     while (1) {
  25658.         echo "&nbsp;&nbsp;St°ednφ<br>\n";
  25659.         while (1) {
  25660.             echo "&nbsp;&nbsp;Vnit°nφ<br>\n";
  25661.             continue 3;
  25662.         }
  25663.         echo "Toto se nikdy nevytiskne.<br>\n";
  25664.     }
  25665.     echo "Ani tohle se neprovßdφ.<br>\n";
  25666. }</PRE
  25667. ></TD
  25668. ></TR
  25669. ></TABLE
  25670. ><P
  25671. ></P
  25672. ></DIV
  25673. >
  25674.     </P
  25675. ></DIV
  25676. ><DIV
  25677. CLASS="sect1"
  25678. ><HR><H2
  25679. CLASS="sect1"
  25680. ><A
  25681. NAME="control-structures.switch"
  25682. ></A
  25683. ><TT
  25684. CLASS="literal"
  25685. >switch</TT
  25686. ></H2
  25687. ><P
  25688. >     Konstrukt <TT
  25689. CLASS="literal"
  25690. >switch</TT
  25691. > je podobnß sΘrii konstrukt∙ IF,
  25692.     testujφcφch tent²╛ v²raz. V mnoha p°φpadech m∙╛ete chtφt porovnßvat
  25693.     stejnou prom∞nnou (nebo v²raz) s mnoha r∙zn²mi hodnotami a provßd∞t
  25694.     r∙znΘ kusy k≤du v zßvislosti na tom, kterΘ hodnot∞ se rovnß.
  25695.     To je p°esn∞ to, k Φemu je <TT
  25696. CLASS="literal"
  25697. >switch</TT
  25698. >.
  25699.    </P
  25700. ><P
  25701. >     Nßsledujφcφ dva p°φklady p°edstavujφ dva odli╣nΘ zp∙soby, jak napsat
  25702.     totΘ╛; jeden pou╛φvß sΘrii podmφnek <TT
  25703. CLASS="literal"
  25704. >if</TT
  25705. >, zatφmco
  25706.     druh² je zalo╛en na konstruktu <TT
  25707. CLASS="literal"
  25708. >switch</TT
  25709. >:
  25710.     <DIV
  25711. CLASS="informalexample"
  25712. ><A
  25713. NAME="AEN5009"
  25714. ></A
  25715. ><P
  25716. ></P
  25717. ><TABLE
  25718. BORDER="0"
  25719. BGCOLOR="#E0E0E0"
  25720. CELLPADDING="5"
  25721. ><TR
  25722. ><TD
  25723. ><PRE
  25724. CLASS="php"
  25725. >if ($i == 0) {
  25726.     print "i se rovnß 0";
  25727. }
  25728. if ($i == 1) {
  25729.     print "i se rovnß 1";
  25730. }
  25731. if ($i == 2) {
  25732.     print "i se rovnß 2";
  25733. }
  25734.  
  25735. switch ($i) {
  25736.     case 0:
  25737.         print "i se rovnß 0";
  25738.         break;
  25739.     case 1:
  25740.         print "i se rovnß 1";
  25741.         break;
  25742.     case 2:
  25743.         print "i se rovnß 2";
  25744.         break;
  25745. }</PRE
  25746. ></TD
  25747. ></TR
  25748. ></TABLE
  25749. ><P
  25750. ></P
  25751. ></DIV
  25752. >
  25753.    </P
  25754. ><P
  25755. >     Je d∙le╛itΘ pochopit, jak se konstrukt <TT
  25756. CLASS="literal"
  25757. >switch</TT
  25758. >
  25759.     provßdφ, aby se zabrßnilo chybßm. Konstrukt <TT
  25760. CLASS="literal"
  25761. >switch</TT
  25762. >
  25763.     provßdφ °ßdek po °ßdku (resp. konstrukt po konstruktu). Na zaΦßtku
  25764.     nenφ proveden ╛ßdn² k≤d. Pouze tehdy, kdy╛ se najde <TT
  25765. CLASS="literal"
  25766. >case</TT
  25767. >
  25768.     s hodnotou odpovφdajφcφ hodnot∞ v²razu u <TT
  25769. CLASS="literal"
  25770. >switch</TT
  25771. >,
  25772.     zaΦne PHP provßd∞t nßsledujφcφ konstrukty. Vykonßvßnφ k≤du pokraΦuje,
  25773.     dokud se nedosßhne konce bloku <TT
  25774. CLASS="literal"
  25775. >switch</TT
  25776. > nebo prvnφho
  25777.     p°φkazu <TT
  25778. CLASS="literal"
  25779. >break</TT
  25780. >. Pokud nenapφ╣ete na konec bloku po
  25781.     <TT
  25782. CLASS="literal"
  25783. >case</TT
  25784. > p°φkaz <TT
  25785. CLASS="literal"
  25786. >break</TT
  25787. >, bude PHP
  25788.     pokraΦovat v provßd∞nφ dal╣φch konstrukt∙ (po dal╣φm
  25789.     <TT
  25790. CLASS="literal"
  25791. >case</TT
  25792. >). Nap°φklad:
  25793.     <DIV
  25794. CLASS="informalexample"
  25795. ><A
  25796. NAME="AEN5021"
  25797. ></A
  25798. ><P
  25799. ></P
  25800. ><TABLE
  25801. BORDER="0"
  25802. BGCOLOR="#E0E0E0"
  25803. CELLPADDING="5"
  25804. ><TR
  25805. ><TD
  25806. ><PRE
  25807. CLASS="php"
  25808. >switch ($i) {
  25809.     case 0:
  25810.         print "i se rovnß 0";
  25811.     case 1:
  25812.         print "i se rovnß 1";
  25813.     case 2:
  25814.         print "i se rovnß 2";
  25815. }</PRE
  25816. ></TD
  25817. ></TR
  25818. ></TABLE
  25819. ><P
  25820. ></P
  25821. ></DIV
  25822. >
  25823.    </P
  25824. ><P
  25825. >     Zde, pokud se $i rovnß 0, se budou provßd∞t v╣echny p°φkazy "print"!
  25826.     Pokud se $i rovnß 1, PHP provede poslednφ dva p°φkazy, a pouze rovnß-li se
  25827.     $i Φφslu 2, obdr╛φte "oΦekßvanΘ" chovßnφ a zobrazφ se pouze "i se rovnß 2".
  25828.     Tak╛e je d∙le╛itΘ nezapomenout na p°φkaz <TT
  25829. CLASS="literal"
  25830. >break</TT
  25831. > (krom∞
  25832.     p°φpadu, kdy ho chcete vynechat zßm∞rn∞ k dosa╛enφ urΦitΘho cφle).
  25833.    </P
  25834. ><P
  25835. >     V konstruktu <TT
  25836. CLASS="literal"
  25837. >switch</TT
  25838. > se podmφnka testuje pouze jednou
  25839.     a v²sledek se porovnßvß s ka╛dou hodnotou v <TT
  25840. CLASS="literal"
  25841. >case</TT
  25842. >.
  25843.     V p°φpad∞ <TT
  25844. CLASS="literal"
  25845. >elseif</TT
  25846. > se podmφnka poka╛dΘ testuje znovu.
  25847.     Pokud je va╣e podmφnka komplikovan∞j╣φ ne╛ jednoduchΘ porovnßnφ a/nebo
  25848.     je uvnit° cyklu, <TT
  25849. CLASS="literal"
  25850. >switch</TT
  25851. > m∙╛e b²t rychlej╣φ.
  25852.    </P
  25853. ><P
  25854. >     Seznam konstrukt∙ za <TT
  25855. CLASS="literal"
  25856. >case</TT
  25857. > m∙╛e b²t takΘ prßzdn², co╛
  25858.     jednodu╣e p°edß °φzenφ nßsledujφcφmu <TT
  25859. CLASS="literal"
  25860. >case</TT
  25861. >.
  25862.     <DIV
  25863. CLASS="informalexample"
  25864. ><A
  25865. NAME="AEN5033"
  25866. ></A
  25867. ><P
  25868. ></P
  25869. ><TABLE
  25870. BORDER="0"
  25871. BGCOLOR="#E0E0E0"
  25872. CELLPADDING="5"
  25873. ><TR
  25874. ><TD
  25875. ><PRE
  25876. CLASS="php"
  25877. >switch ($i) {
  25878.     case 0:
  25879.     case 1:
  25880.     case 2:
  25881.         print "i je men╣φ ne╛ 3, ale nezßpornΘ";
  25882.         break;
  25883.     case 3:
  25884.         print "i je 3";
  25885. }</PRE
  25886. ></TD
  25887. ></TR
  25888. ></TABLE
  25889. ><P
  25890. ></P
  25891. ></DIV
  25892. >
  25893.    </P
  25894. ><P
  25895. >     Specißlnφ <TT
  25896. CLASS="literal"
  25897. >case</TT
  25898. > je "default". Vyhovuje v╣em ostatnφm
  25899.     hodnotßm, kterΘ nejsou pokryty n∞kter²m z ostatnφch
  25900.     <TT
  25901. CLASS="literal"
  25902. >case</TT
  25903. > a mß b²t v╛dy jako poslednφ. Nap°φklad:
  25904.     <DIV
  25905. CLASS="informalexample"
  25906. ><A
  25907. NAME="AEN5038"
  25908. ></A
  25909. ><P
  25910. ></P
  25911. ><TABLE
  25912. BORDER="0"
  25913. BGCOLOR="#E0E0E0"
  25914. CELLPADDING="5"
  25915. ><TR
  25916. ><TD
  25917. ><PRE
  25918. CLASS="php"
  25919. >switch ($i) {
  25920.     case 0:
  25921.         print "i se rovnß 0";
  25922.         break;
  25923.     case 1:
  25924.         print "i se rovnß 1";
  25925.         break;
  25926.     case 2:
  25927.         print "i se rovnß 2";
  25928.         break;
  25929.     default:
  25930.         print "i se nerovnß 0, 1 ani 2";
  25931. }</PRE
  25932. ></TD
  25933. ></TR
  25934. ></TABLE
  25935. ><P
  25936. ></P
  25937. ></DIV
  25938. >
  25939.    </P
  25940. ><P
  25941. >     V²raz v <TT
  25942. CLASS="literal"
  25943. >case</TT
  25944. > m∙╛e b²t libovoln² v²raz, jeho╛ hodnota
  25945.     je jednoduchΘho typu, tj. celΘ nebo reßlnΘ Φφslo nebo °et∞zec. Pole ani
  25946.     objekty nelze pou╛φt, leda╛e by odkazovaly na jednoduch² typ.
  25947.    </P
  25948. ><P
  25949. >     Alternativnφ syntaxe pro konstrukty <TT
  25950. CLASS="literal"
  25951. >switch</TT
  25952. > je
  25953.     podporovßna. Pro vφc informacφ viz
  25954.     <A
  25955. HREF="#control-structures.alternative-syntax"
  25956. >Alternativnφ syntaxe
  25957.     °φdicφch struktur</A
  25958. > .
  25959.     <DIV
  25960. CLASS="informalexample"
  25961. ><A
  25962. NAME="AEN5045"
  25963. ></A
  25964. ><P
  25965. ></P
  25966. ><TABLE
  25967. BORDER="0"
  25968. BGCOLOR="#E0E0E0"
  25969. CELLPADDING="5"
  25970. ><TR
  25971. ><TD
  25972. ><PRE
  25973. CLASS="php"
  25974. >switch ($i):
  25975.     case 0:
  25976.         print "i se rovnß 0";
  25977.         break;
  25978.     case 1:
  25979.         print "i se rovnß 1";
  25980.         break;
  25981.     case 2:
  25982.         print "i se rovnß 2";
  25983.         break;
  25984.     default:
  25985.         print "i se nerovnß 0, 1 ani 2";
  25986. endswitch;</PRE
  25987. ></TD
  25988. ></TR
  25989. ></TABLE
  25990. ><P
  25991. ></P
  25992. ></DIV
  25993. >
  25994.    </P
  25995. ></DIV
  25996. ><DIV
  25997. CLASS="sect1"
  25998. ><HR><H2
  25999. CLASS="sect1"
  26000. ><A
  26001. NAME="control-structures.declare"
  26002. ></A
  26003. ><TT
  26004. CLASS="literal"
  26005. >declare</TT
  26006. ></H2
  26007. ><P
  26008. >     Konstrukt <TT
  26009. CLASS="literal"
  26010. >declare</TT
  26011. > se pou╛φvß k nastavenφ provßd∞cφch
  26012.     direktiv pro blok k≤du. Syntaxe <TT
  26013. CLASS="literal"
  26014. >declare</TT
  26015. > je podobnß
  26016.     syntaxi ostatnφcj konstrukt∙ pro °φzenφ toku:
  26017.     <DIV
  26018. CLASS="informalexample"
  26019. ><A
  26020. NAME="AEN5053"
  26021. ></A
  26022. ><P
  26023. ></P
  26024. ><TABLE
  26025. BORDER="0"
  26026. BGCOLOR="#E0E0E0"
  26027. CELLPADDING="5"
  26028. ><TR
  26029. ><TD
  26030. ><PRE
  26031. CLASS="programlisting"
  26032. >declare (directive) statement</PRE
  26033. ></TD
  26034. ></TR
  26035. ></TABLE
  26036. ><P
  26037. ></P
  26038. ></DIV
  26039. >
  26040.    </P
  26041. ><P
  26042. >     ╚ßst <TT
  26043. CLASS="literal"
  26044. >directive</TT
  26045. > umo╛≥uje nastavit chovßnφ bloku, kter²
  26046.     mß b²t ovlivn∞n pomocφ <TT
  26047. CLASS="literal"
  26048. >declare</TT
  26049. >. V souΦasnosti je
  26050.     rozpoznßvßna pouze jedinß direktiva: <TT
  26051. CLASS="literal"
  26052. >ticks</TT
  26053. >.
  26054.     (Pro vφce informacφ viz nφ╛e - direktiva
  26055.     <A
  26056. HREF="#control-structures.declare.ticks"
  26057. >ticks</A
  26058. >)
  26059.    </P
  26060. ><P
  26061. >     ╚ßst <TT
  26062. CLASS="literal"
  26063. >statement</TT
  26064. > bloku <TT
  26065. CLASS="literal"
  26066. >declare</TT
  26067. >
  26068.     bude provedena - jak bude provedena a jakΘ vedlej╣φ efekty nastanou
  26069.     b∞hem provßd∞nφ m∙╛e zßle╛et na direktiv∞ nastavenΘ v bloku
  26070.     <TT
  26071. CLASS="literal"
  26072. >directive</TT
  26073. >.
  26074.    </P
  26075. ><DIV
  26076. CLASS="sect2"
  26077. ><HR><H3
  26078. CLASS="sect2"
  26079. ><A
  26080. NAME="control-structures.declare.ticks"
  26081. ></A
  26082. >Ticks</H3
  26083. ><P
  26084. >Tick je udßlost, kterß nastane pro ka╛d²ch
  26085.     <TT
  26086. CLASS="replaceable"
  26087. ><I
  26088. >N</I
  26089. ></TT
  26090. > nφzko·rov≥ov²ch konstrukt∙ proveden²ch
  26091.     parserem uvnit° bloku <TT
  26092. CLASS="literal"
  26093. >declare</TT
  26094. >. Hodnota
  26095.     <TT
  26096. CLASS="replaceable"
  26097. ><I
  26098. >N</I
  26099. ></TT
  26100. > je specifikovßna pomocφ
  26101.     <TT
  26102. CLASS="literal"
  26103. >ticks=<TT
  26104. CLASS="replaceable"
  26105. ><I
  26106. >N</I
  26107. ></TT
  26108. ></TT
  26109. > uvnit° sekce
  26110.     <TT
  26111. CLASS="literal"
  26112. >directive</TT
  26113. > bloku <TT
  26114. CLASS="literal"
  26115. >declare</TT
  26116. >.
  26117.    </P
  26118. ><P
  26119. >     Udßlost(i), kterß nastane p°i ka╛dΘm ticku, se specifikuje pomocφ
  26120.     <A
  26121. HREF="#function.register-tick-function"
  26122. ><B
  26123. CLASS="function"
  26124. >register_tick_function()</B
  26125. ></A
  26126. >. Vφce podrobnostφ - viz
  26127.     p°φklad nφ╛e. Uv∞domte si, ╛e na ka╛d² tick m∙╛e nastat vφce ne╛ jedna
  26128.     udßlost.
  26129.    </P
  26130. ><P
  26131. >     <TABLE
  26132. WIDTH="100%"
  26133. BORDER="0"
  26134. CELLPADDING="0"
  26135. CELLSPACING="0"
  26136. CLASS="EXAMPLE"
  26137. ><TR
  26138. ><TD
  26139. ><DIV
  26140. CLASS="example"
  26141. ><A
  26142. NAME="AEN5077"
  26143. ></A
  26144. ><P
  26145. ><B
  26146. >P°φklad 11-1. Profile a section of PHP code</B
  26147. ></P
  26148. ><TABLE
  26149. BORDER="0"
  26150. BGCOLOR="#E0E0E0"
  26151. CELLPADDING="5"
  26152. ><TR
  26153. ><TD
  26154. ><PRE
  26155. CLASS="php"
  26156. ><pre>
  26157. <?php
  26158. // A function that records the time when it is called
  26159. function profile ($dump = FALSE)
  26160. {
  26161.     static $profile;
  26162.  
  26163.     // Return the times stored in profile, then erase it
  26164.     if ($dump) {
  26165.         $temp = $profile;
  26166.         unset ($profile);
  26167.         return ($temp);
  26168.     }
  26169.  
  26170.     $profile[] = microtime ();
  26171. }
  26172.  
  26173. // Set up a tick handler
  26174. register_tick_function("profile");
  26175.  
  26176. // Initialize the function before the declare block
  26177. profile ();
  26178.  
  26179. // Run a block of code, throw a tick every 2nd statement
  26180. declare (ticks=2) {
  26181.     for ($x = 1; $x < 50; ++$x) {
  26182.         echo similar_text (md5($x), md5($x*$x)), "&lt;br&gt;";
  26183.     }
  26184. }
  26185.  
  26186. // Display the data stored in the profiler
  26187. print_r (profile (TRUE));
  26188. ?>
  26189. </pre></PRE
  26190. ></TD
  26191. ></TR
  26192. ></TABLE
  26193. ></DIV
  26194. ></TD
  26195. ></TR
  26196. ></TABLE
  26197. >
  26198.     The example profiles the PHP code within the 'declare'
  26199.     block, recording the time at which every second low-level
  26200.     statement in the block was executed. This information can
  26201.     then be used to find the slow areas within particular
  26202.     segments of code. This process can be performed using other
  26203.     methods: using ticks is more convenient and easier to
  26204.     implement.
  26205.    </P
  26206. ><P
  26207. >     Ticks are well suited for debugging, implementing simple
  26208.     multitasking, backgrounded I/O and many other tasks.
  26209.    </P
  26210. ><P
  26211. >     See also <A
  26212. HREF="#function.register-tick-function"
  26213. ><B
  26214. CLASS="function"
  26215. >register_tick_function()</B
  26216. ></A
  26217. > and
  26218.     <A
  26219. HREF="#function.unregister-tick-function"
  26220. ><B
  26221. CLASS="function"
  26222. >unregister_tick_function()</B
  26223. ></A
  26224. >.
  26225.    </P
  26226. ></DIV
  26227. ></DIV
  26228. ><DIV
  26229. CLASS="sect1"
  26230. ><HR><H2
  26231. CLASS="sect1"
  26232. ><A
  26233. NAME="function.return"
  26234. ></A
  26235. >return</H2
  26236. ><P
  26237. >     Zavolßn uvnit° funkce, konstrukt <A
  26238. HREF="#function.return"
  26239. ><B
  26240. CLASS="function"
  26241. >return()</B
  26242. ></A
  26243. > okam╛it∞
  26244.     ukonΦφ provßd∞nφ tΘto funkce a vracφ sv∙j argument jako hodnotu volßnφ
  26245.     funkce. <A
  26246. HREF="#function.return"
  26247. ><B
  26248. CLASS="function"
  26249. >return()</B
  26250. ></A
  26251. > takΘ obdobn∞ ukonΦφ provßd∞nφ
  26252.     konstruktu <A
  26253. HREF="#function.eval"
  26254. ><B
  26255. CLASS="function"
  26256. >eval()</B
  26257. ></A
  26258. > nebo celΘho skriptu.
  26259.    </P
  26260. ><P
  26261. >     Pokud se volß z globßlnφho kontextu, provßd∞nφ skriptu se ukonΦφ. Byl-li
  26262.     aktußlnφ skript vlo╛en pomocφ <A
  26263. HREF="#function.include"
  26264. ><B
  26265. CLASS="function"
  26266. >include()</B
  26267. ></A
  26268. > nebo
  26269.     <A
  26270. HREF="#function.require"
  26271. ><B
  26272. CLASS="function"
  26273. >require()</B
  26274. ></A
  26275. >, p°edß se °φzenφ volajφcφmu souboru. Navφc,
  26276.     bylo-li pou╛ito <A
  26277. HREF="#function.include"
  26278. ><B
  26279. CLASS="function"
  26280. >include()</B
  26281. ></A
  26282. >, bude hodnota specifikovanß
  26283.     v <A
  26284. HREF="#function.return"
  26285. ><B
  26286. CLASS="function"
  26287. >return()</B
  26288. ></A
  26289. > vrßcena jako hodnota volßnφ
  26290.     <A
  26291. HREF="#function.include"
  26292. ><B
  26293. CLASS="function"
  26294. >include()</B
  26295. ></A
  26296. >. Pokud se <A
  26297. HREF="#function.return"
  26298. ><B
  26299. CLASS="function"
  26300. >return()</B
  26301. ></A
  26302. >
  26303.     zavolß z hlavnφho souboru skriptu, provßd∞nφ skonΦφ. Kdy╛ se jednß o
  26304.     soubor specifikovan² pomocφ konfiguraΦnφch voleb
  26305.     <A
  26306. HREF="#ini.auto-prepend-file"
  26307. >auto_prepend_file</A
  26308. > nebo
  26309.     <A
  26310. HREF="#ini.auto-append-file"
  26311. >auto_append_file</A
  26312. >
  26313.     v <A
  26314. HREF="#configuration.file"
  26315. >konfiguraΦnφm souboru</A
  26316. >,
  26317.     zpracovßnφ souboru konΦφ.
  26318.    </P
  26319. ><P
  26320. >Vφce informacφ - viz
  26321.    <A
  26322. HREF="#functions.returning-values"
  26323. >NßvratovΘ hodnoty</A
  26324. >.
  26325.    </P
  26326. ><DIV
  26327. CLASS="note"
  26328. ><BLOCKQUOTE
  26329. CLASS="note"
  26330. ><P
  26331. ><B
  26332. >Poznßmka: </B
  26333. >
  26334.      Uv∞domte si, ╛e <A
  26335. HREF="#function.return"
  26336. ><B
  26337. CLASS="function"
  26338. >return()</B
  26339. ></A
  26340. > je jazykov² konstrukt, a
  26341.      nikoli funkce -- uzav°enφ argument∙ do zßvorek <SPAN
  26342. CLASS="emphasis"
  26343. ><I
  26344. CLASS="emphasis"
  26345. >nenφ</I
  26346. ></SPAN
  26347. >
  26348.      nutnΘ. Obvykle se vynechßvajφ, ale nezßle╛φ na tom, zda se pou╛ijφ Φi
  26349.      nikoli.
  26350.     </P
  26351. ></BLOCKQUOTE
  26352. ></DIV
  26353. ></DIV
  26354. ><DIV
  26355. CLASS="sect1"
  26356. ><HR><H2
  26357. CLASS="sect1"
  26358. ><A
  26359. NAME="function.require"
  26360. ></A
  26361. ><A
  26362. HREF="#function.require"
  26363. ><B
  26364. CLASS="function"
  26365. >require()</B
  26366. ></A
  26367. ></H2
  26368. ><P
  26369. >     Konstrukt <A
  26370. HREF="#function.require"
  26371. ><B
  26372. CLASS="function"
  26373. >require()</B
  26374. ></A
  26375. > vlo╛φ a ohodnotφ specifikovan²
  26376.     soubor.
  26377.    </P
  26378. ><P
  26379. >      <A
  26380. HREF="#function.require"
  26381. ><B
  26382. CLASS="function"
  26383. >require()</B
  26384. ></A
  26385. > vlo╛φ a ohodnotφ specifikovan² soubor.
  26386.      PodrobnΘ informace o tom, jak vklßdßnφ pracuje, jsou popsßny v
  26387.      dokumentaci o <A
  26388. HREF="#function.include"
  26389. ><B
  26390. CLASS="function"
  26391. >include()</B
  26392. ></A
  26393. >.
  26394.    </P
  26395. ><P
  26396. >      <A
  26397. HREF="#function.require"
  26398. ><B
  26399. CLASS="function"
  26400. >require()</B
  26401. ></A
  26402. > a <A
  26403. HREF="#function.include"
  26404. ><B
  26405. CLASS="function"
  26406. >include()</B
  26407. ></A
  26408. > jsou toto╛nΘ,
  26409.      krom∞ toho, jak zpracovßvajφ chyby. <A
  26410. HREF="#function.include"
  26411. ><B
  26412. CLASS="function"
  26413. >include()</B
  26414. ></A
  26415. >
  26416.      vyprodukuje <A
  26417. HREF="#internal.e-warning"
  26418. >Warning</A
  26419. > (varovßnφ),
  26420.      zatφmco <A
  26421. HREF="#function.require"
  26422. ><B
  26423. CLASS="function"
  26424. >require()</B
  26425. ></A
  26426. > skonΦφ s chybou typu
  26427.      <A
  26428. HREF="#internal.e-error"
  26429. >Fatal Error</A
  26430. > (velmi vß╛nß chyba).
  26431.      Jinak °eΦeno, nerozpakujte se pou╛φt <A
  26432. HREF="#function.require"
  26433. ><B
  26434. CLASS="function"
  26435. >require()</B
  26436. ></A
  26437. >,
  26438.      pokud chcete, aby nep°φtomnost souboru zastavila zpracovßnφ strßnky.
  26439.      <A
  26440. HREF="#function.include"
  26441. ><B
  26442. CLASS="function"
  26443. >include()</B
  26444. ></A
  26445. > se takto nechovß, skript bude neru╣en∞
  26446.      pokraΦovat. Ujist∞te se takΘ, ╛e mßte v po°ßdku nastavenφ
  26447.      <A
  26448. HREF="#ini.include-path"
  26449. >include_path</A
  26450. >.
  26451.    </P
  26452. ><P
  26453. >     <TABLE
  26454. WIDTH="100%"
  26455. BORDER="0"
  26456. CELLPADDING="0"
  26457. CELLSPACING="0"
  26458. CLASS="EXAMPLE"
  26459. ><TR
  26460. ><TD
  26461. ><DIV
  26462. CLASS="example"
  26463. ><A
  26464. NAME="AEN5125"
  26465. ></A
  26466. ><P
  26467. ><B
  26468. >P°φklad 11-2. Zßkladnφ p°φklady pou╛itφ <A
  26469. HREF="#function.require"
  26470. ><B
  26471. CLASS="function"
  26472. >require()</B
  26473. ></A
  26474. ></B
  26475. ></P
  26476. ><TABLE
  26477. BORDER="0"
  26478. BGCOLOR="#E0E0E0"
  26479. CELLPADDING="5"
  26480. ><TR
  26481. ><TD
  26482. ><PRE
  26483. CLASS="php"
  26484. ><?php
  26485.  
  26486. require 'prepend.php';
  26487.  
  26488. require $somefile;
  26489.  
  26490. require ('somefile.txt');
  26491.  
  26492. ?></PRE
  26493. ></TD
  26494. ></TR
  26495. ></TABLE
  26496. ></DIV
  26497. ></TD
  26498. ></TR
  26499. ></TABLE
  26500. >
  26501.    </P
  26502. ><P
  26503. >     Dal╣φ p°φklady -- viz dokumentace <A
  26504. HREF="#function.include"
  26505. ><B
  26506. CLASS="function"
  26507. >include()</B
  26508. ></A
  26509. >.
  26510.    </P
  26511. ><DIV
  26512. CLASS="note"
  26513. ><BLOCKQUOTE
  26514. CLASS="note"
  26515. ><P
  26516. ><B
  26517. >Poznßmka: </B
  26518. >     
  26519.      U verzφ p°ed PHP 4.0.2 platφ toto: <A
  26520. HREF="#function.require"
  26521. ><B
  26522. CLASS="function"
  26523. >require()</B
  26524. ></A
  26525. > se v╛dy
  26526.      pokusφ p°eΦφst p°φslu╣n² soubor, krom∞ p°φpadu, ╛e se °ßdek s tφmto
  26527.      p°φkazem nem∙╛e nikdy provΘst. Podmφn∞n² v²raz
  26528.      <A
  26529. HREF="#function.require"
  26530. ><B
  26531. CLASS="function"
  26532. >require()</B
  26533. ></A
  26534. > neovliv≥uje. Av╣ak pokud se °ßdek, na kterΘm
  26535.      <A
  26536. HREF="#function.require"
  26537. ><B
  26538. CLASS="function"
  26539. >require()</B
  26540. ></A
  26541. > le╛φ, v∙bec neprovßdφ, nebude se provßd∞t
  26542.      ani k≤d v p°φslu╣nΘm souboru. Podobn∞ je tomu i v p°φpad∞ cykl∙ -- ani
  26543.      ty neovliv≥ujφ chovßnφ <A
  26544. HREF="#function.require"
  26545. ><B
  26546. CLASS="function"
  26547. >require()</B
  26548. ></A
  26549. >. P°esto╛e k≤d
  26550.      obsa╛en² ve vklßdanΘm souboru je stßle p°edm∞tem opakovßnφ, samotnΘ 
  26551.      <A
  26552. HREF="#function.require"
  26553. ><B
  26554. CLASS="function"
  26555. >require()</B
  26556. ></A
  26557. > se provede pouze jednou.
  26558.     </P
  26559. ></BLOCKQUOTE
  26560. ></DIV
  26561. ><P
  26562. >     Viz takΘ <A
  26563. HREF="#function.include"
  26564. ><B
  26565. CLASS="function"
  26566. >include()</B
  26567. ></A
  26568. >, <A
  26569. HREF="#function.require-once"
  26570. ><B
  26571. CLASS="function"
  26572. >require_once()</B
  26573. ></A
  26574. >,
  26575.     <A
  26576. HREF="#function.include-once"
  26577. ><B
  26578. CLASS="function"
  26579. >include_once()</B
  26580. ></A
  26581. >, <A
  26582. HREF="#function.eval"
  26583. ><B
  26584. CLASS="function"
  26585. >eval()</B
  26586. ></A
  26587. >, 
  26588.     <A
  26589. HREF="#function.file"
  26590. ><B
  26591. CLASS="function"
  26592. >file()</B
  26593. ></A
  26594. >, <A
  26595. HREF="#function.readfile"
  26596. ><B
  26597. CLASS="function"
  26598. >readfile()</B
  26599. ></A
  26600. >, 
  26601.     <A
  26602. HREF="#function.virtual"
  26603. ><B
  26604. CLASS="function"
  26605. >virtual()</B
  26606. ></A
  26607. > a <A
  26608. HREF="#ini.include-path"
  26609. >include_path</A
  26610. >.
  26611.    </P
  26612. ></DIV
  26613. ><DIV
  26614. CLASS="sect1"
  26615. ><HR><H2
  26616. CLASS="sect1"
  26617. ><A
  26618. NAME="function.include"
  26619. ></A
  26620. ><A
  26621. HREF="#function.include"
  26622. ><B
  26623. CLASS="function"
  26624. >include()</B
  26625. ></A
  26626. ></H2
  26627. ><P
  26628. >     Konstrukt <A
  26629. HREF="#function.include"
  26630. ><B
  26631. CLASS="function"
  26632. >include()</B
  26633. ></A
  26634. > vlo╛φ a ohodnotφ specifikovan²
  26635.     soubor.
  26636.    </P
  26637. ><P
  26638. >      Nφ╛e popsanΘ platφ i pro <A
  26639. HREF="#function.require"
  26640. ><B
  26641. CLASS="function"
  26642. >require()</B
  26643. ></A
  26644. >. Tyto dva konstrukty
  26645.      jsou zcela toto╛nΘ, krom∞ toho, jak zpracovßvajφ chyby.
  26646.      <A
  26647. HREF="#function.include"
  26648. ><B
  26649. CLASS="function"
  26650. >include()</B
  26651. ></A
  26652. > produkuje
  26653.      <A
  26654. HREF="#internal.e-warning"
  26655. >Warning</A
  26656. > (varovßnφ), zatφmco
  26657.      <A
  26658. HREF="#function.require"
  26659. ><B
  26660. CLASS="function"
  26661. >require()</B
  26662. ></A
  26663. > skonΦφ s chybou typu
  26664.      <A
  26665. HREF="#internal.e-error"
  26666. >Fatal Error</A
  26667. >.
  26668.      Jin²mi slovy, <A
  26669. HREF="#function.require"
  26670. ><B
  26671. CLASS="function"
  26672. >require()</B
  26673. ></A
  26674. > pou╛ijte tehdy, chcete-li,
  26675.      aby se p°i chyb∞jφcφm souboru zastavilo zpracovßvßnφ.
  26676.      <A
  26677. HREF="#function.include"
  26678. ><B
  26679. CLASS="function"
  26680. >include()</B
  26681. ></A
  26682. > se tak nechovß, skript bude neru╣en∞
  26683.      pokraΦovat. Ujist∞te se takΘ, ╛e mßte v po°ßdku nastavenφ
  26684.      <A
  26685. HREF="#ini.include-path"
  26686. >include_path</A
  26687. >.
  26688.    </P
  26689. ><P
  26690. >      Pokud se vlo╛φ soubor, potom k≤d v n∞m obsa╛en² d∞dφ
  26691.      <A
  26692. HREF="#language.variables.scope"
  26693. >kontext prom∞nnΘ</A
  26694. >
  26695.      °ßdku, kde byl vlo╛en. V╣echny prom∞nnΘ dostupnΘ na tomto °ßdku
  26696.      volajφcφho souboru budou (od tΘto chvφle) dostupnΘ i ve volanΘm souboru.
  26697.    </P
  26698. ><P
  26699. >      <TABLE
  26700. WIDTH="100%"
  26701. BORDER="0"
  26702. CELLPADDING="0"
  26703. CELLSPACING="0"
  26704. CLASS="EXAMPLE"
  26705. ><TR
  26706. ><TD
  26707. ><DIV
  26708. CLASS="example"
  26709. ><A
  26710. NAME="AEN5164"
  26711. ></A
  26712. ><P
  26713. ><B
  26714. >P°φklad 11-3. Zßkladnφ p°φklad -- <A
  26715. HREF="#function.include"
  26716. ><B
  26717. CLASS="function"
  26718. >include()</B
  26719. ></A
  26720. ></B
  26721. ></P
  26722. ><TABLE
  26723. BORDER="0"
  26724. BGCOLOR="#E0E0E0"
  26725. CELLPADDING="5"
  26726. ><TR
  26727. ><TD
  26728. ><PRE
  26729. CLASS="php"
  26730. >vars.php
  26731. <?php
  26732.  
  26733. $color = 'zelenΘ';
  26734. $fruit = 'jablko';
  26735.  
  26736. ?>
  26737.  
  26738. test.php
  26739. <?php
  26740.  
  26741. echo "Vidφm $color $fruit"; // Vidφm
  26742.  
  26743. include 'vars.php';
  26744.  
  26745. echo "Vidφm $color $fruit"; // Vidφm zelenΘ jablko
  26746.  
  26747. ?></PRE
  26748. ></TD
  26749. ></TR
  26750. ></TABLE
  26751. ></DIV
  26752. ></TD
  26753. ></TR
  26754. ></TABLE
  26755. >
  26756.    </P
  26757. ><P
  26758. >      Pokud ke vlo╛enφ dojde uvnit° funkce ve volajφcφm souboru, potom se v╣echen
  26759.      k≤d obsa╛en² ve volanΘm souboru bude chovat, jako by byl definovßn
  26760.      uvnit° tΘto funkce -- tedy v rßmci kontextu prom∞nn²ch funkce.     
  26761.    </P
  26762. ><P
  26763. >      <TABLE
  26764. WIDTH="100%"
  26765. BORDER="0"
  26766. CELLPADDING="0"
  26767. CELLSPACING="0"
  26768. CLASS="EXAMPLE"
  26769. ><TR
  26770. ><TD
  26771. ><DIV
  26772. CLASS="example"
  26773. ><A
  26774. NAME="AEN5170"
  26775. ></A
  26776. ><P
  26777. ><B
  26778. >P°φklad 11-4. Vklßdßnφ uvnit° funkcφ</B
  26779. ></P
  26780. ><TABLE
  26781. BORDER="0"
  26782. BGCOLOR="#E0E0E0"
  26783. CELLPADDING="5"
  26784. ><TR
  26785. ><TD
  26786. ><PRE
  26787. CLASS="php"
  26788. ><?php
  26789.  
  26790. function foo()
  26791. {
  26792. global $color;
  26793.  
  26794.     include 'vars.php';
  26795.  
  26796.     echo "Vidφm $color $fruit";
  26797. }
  26798.  
  26799. /* vars.php je v kontextu foo(), tak╛e      *
  26800.  * $fruit NEN═ dostupnß mimo tento kontext. *
  26801.  * Naopak $color JE, proto╛e je deklarovßna *
  26802.  * jako globßlnφ.                           */
  26803.  
  26804. foo();                        // Vidφm zelenΘ jablko
  26805. echo "Vidφm $color $fruit";   // Vidφm zelenΘ
  26806.  
  26807. ?></PRE
  26808. ></TD
  26809. ></TR
  26810. ></TABLE
  26811. ></DIV
  26812. ></TD
  26813. ></TR
  26814. ></TABLE
  26815. >
  26816.    </P
  26817. ><P
  26818. >      P°i vklßdßnφ souboru p°ejde parsing na zaΦßtku souboru z PHP re╛imu do
  26819.      m≤du HTML a na jeho konci se vracφ zp∞t do m≤du PHP. Z tohoho d∙vodu
  26820.      musφ b²t provßd∞n² PHP k≤d ve vklßdanΘm souboru uzav°en mezi
  26821.      <A
  26822. HREF="#language.basic-syntax.phpmode"
  26823. >platnou poΦßteΦnφ a
  26824.      koncovou PHP znaΦku</A
  26825. >.
  26826.    </P
  26827. ><P
  26828. >      Pokud jsou v PHP povoleny
  26829.      "<A
  26830. HREF="#ini.allow-url-fopen"
  26831. >URL fopen wrappery</A
  26832. >"
  26833.      (co╛ tak implicitn∞ je), m∙╛ete specifikovat soubor ke vlo╛enφ pomocφ
  26834.      URL (p°es HTTP) namφsto lokßlnφho umφst∞nφ. Pokud p°φsku╣n² server
  26835.      interpretuje po╛adovan² soubor jako PHP k≤d, prom∞nnΘ mohou b²t odkazovßny
  26836.      pomocφ °et∞zce URL po╛adavku jako u HTTP GET. Nenφ to ·pln∞ totΘ╛ jako
  26837.      vlo╛enφ souboru s d∞d∞nφm kontextu prom∞nn²ch od rodiΦovskΘho souboru;
  26838.      skript b∞╛φ na vzdßlenΘm serveru a v²sledek se potom vlo╛φ do lokßlnφho
  26839.      skriptu.
  26840.    </P
  26841. ><P
  26842. >     <TABLE
  26843. WIDTH="100%"
  26844. BORDER="0"
  26845. CELLPADDING="0"
  26846. CELLSPACING="0"
  26847. CLASS="EXAMPLE"
  26848. ><TR
  26849. ><TD
  26850. ><DIV
  26851. CLASS="example"
  26852. ><A
  26853. NAME="AEN5178"
  26854. ></A
  26855. ><P
  26856. ><B
  26857. >P°φklad 11-5. <A
  26858. HREF="#function.include"
  26859. ><B
  26860. CLASS="function"
  26861. >include()</B
  26862. ></A
  26863. > p°es HTTP</B
  26864. ></P
  26865. ><TABLE
  26866. BORDER="0"
  26867. BGCOLOR="#E0E0E0"
  26868. CELLPADDING="5"
  26869. ><TR
  26870. ><TD
  26871. ><PRE
  26872. CLASS="php"
  26873. ><?php
  26874.  
  26875. /* Tento p°φklad p°edpoklßdß, ╛e www.example.com je konfigurovßn k parsovßnφ *
  26876.  * soubor∙ .php a nikoli soubor∙ .txt. Tedy, 'funguje' zde znamenß, ╛e       *
  26877.  * prom∞nnΘ $foo a $bar jsou dostupnΘ uvnit° vklßdanΘho souboru.             */
  26878.  
  26879. // Nefunguje; file.txt nebyl na www.example.com zpracovßn jako PHP
  26880. include 'http://www.example.com/file.txt?foo=1&bar=2';
  26881.  
  26882. // Nefunguje; hledß soubor 'file.php?foo=1&bar=2' v lokßlnφm systΘmu soubor∙.
  26883. include 'file.php?foo=1&bar=2';
  26884.  
  26885. // Funguje.
  26886. include 'http://www.example.com/file.php?foo=1&bar=2';
  26887.  
  26888. $foo = 1;
  26889. $bar = 2;
  26890. include 'file.txt';  // Funguje.
  26891. include 'file.php';  // Funguje.
  26892.  
  26893. ?></PRE
  26894. ></TD
  26895. ></TR
  26896. ></TABLE
  26897. ></DIV
  26898. ></TD
  26899. ></TR
  26900. ></TABLE
  26901. >
  26902.      Souvisejφcφ informace -- viz takΘ
  26903.      <A
  26904. HREF="#features.remote-files"
  26905. >VzdßlenΘ soubory</A
  26906. >,
  26907.      <A
  26908. HREF="#function.fopen"
  26909. ><B
  26910. CLASS="function"
  26911. >fopen()</B
  26912. ></A
  26913. > a <A
  26914. HREF="#function.file"
  26915. ><B
  26916. CLASS="function"
  26917. >file()</B
  26918. ></A
  26919. >.
  26920.    </P
  26921. ><P
  26922. >      Proto╛e <A
  26923. HREF="#function.include"
  26924. ><B
  26925. CLASS="function"
  26926. >include()</B
  26927. ></A
  26928. > a <A
  26929. HREF="#function.require"
  26930. ><B
  26931. CLASS="function"
  26932. >require()</B
  26933. ></A
  26934. >
  26935.      jsou specißlnφ jazykovΘ konstrukty, pokud se provßd∞jφ podmφn∞n∞,
  26936.      musφte je uzav°φt do bloku.
  26937.    </P
  26938. ><P
  26939. >     <TABLE
  26940. WIDTH="100%"
  26941. BORDER="0"
  26942. CELLPADDING="0"
  26943. CELLSPACING="0"
  26944. CLASS="EXAMPLE"
  26945. ><TR
  26946. ><TD
  26947. ><DIV
  26948. CLASS="example"
  26949. ><A
  26950. NAME="AEN5189"
  26951. ></A
  26952. ><P
  26953. ><B
  26954. >P°φklad 11-6. include() a podmφn∞nΘ bloky</B
  26955. ></P
  26956. ><TABLE
  26957. BORDER="0"
  26958. BGCOLOR="#E0E0E0"
  26959. CELLPADDING="5"
  26960. ><TR
  26961. ><TD
  26962. ><PRE
  26963. CLASS="php"
  26964. ><?php
  26965.  
  26966. // Toto je ⌐PATN╠ a (jak bylo °eΦeno) nebude to fungovat.
  26967. if ($condition)
  26968.     include $file;
  26969. else
  26970.     include $other;
  26971.  
  26972.  
  26973. // Tohle je SPR┴VN╠.
  26974. if ($condition) {
  26975.     include $file;
  26976. } else {
  26977.     include $other;
  26978. }
  26979.  
  26980. ?></PRE
  26981. ></TD
  26982. ></TR
  26983. ></TABLE
  26984. ></DIV
  26985. ></TD
  26986. ></TR
  26987. ></TABLE
  26988. >
  26989.    </P
  26990. ><P
  26991. >     Obsluha nßvrat∙: Uvnit° vklßdanΘho souboru lze provΘst konstrukt
  26992.     <A
  26993. HREF="#function.return"
  26994. ><B
  26995. CLASS="function"
  26996. >return()</B
  26997. ></A
  26998. > k ukonΦenφ provßd∞nφ souboru a nßvrat do
  26999.     volajφcφho skriptu. Je tedy mo╛nΘ z vlo╛en²ch soubor∙ vracet hodnoty.
  27000.     M∙╛ete vzφt hodnotu volßnφ include, jako by to byla normßlnφ funkce.
  27001.    </P
  27002. ><DIV
  27003. CLASS="note"
  27004. ><BLOCKQUOTE
  27005. CLASS="note"
  27006. ><P
  27007. ><B
  27008. >Poznßmka: </B
  27009. >
  27010.      V PHP 3 se return nesmφ objevit uvnit° bloku, pokud to nenφ funkΦnφ blok;
  27011.      tehdy v╣ak se v╣ak <A
  27012. HREF="#function.return"
  27013. ><B
  27014. CLASS="function"
  27015. >return()</B
  27016. ></A
  27017. > t²kß tΘto funkce a ne
  27018.      celΘho souboru.
  27019.     </P
  27020. ></BLOCKQUOTE
  27021. ></DIV
  27022. ><P
  27023. >     <TABLE
  27024. WIDTH="100%"
  27025. BORDER="0"
  27026. CELLPADDING="0"
  27027. CELLSPACING="0"
  27028. CLASS="EXAMPLE"
  27029. ><TR
  27030. ><TD
  27031. ><DIV
  27032. CLASS="example"
  27033. ><A
  27034. NAME="AEN5198"
  27035. ></A
  27036. ><P
  27037. ><B
  27038. >P°φklad 11-7. <A
  27039. HREF="#function.include"
  27040. ><B
  27041. CLASS="function"
  27042. >include()</B
  27043. ></A
  27044. > a konstrukt <A
  27045. HREF="#function.return"
  27046. ><B
  27047. CLASS="function"
  27048. >return()</B
  27049. ></A
  27050. ></B
  27051. ></P
  27052. ><TABLE
  27053. BORDER="0"
  27054. BGCOLOR="#E0E0E0"
  27055. CELLPADDING="5"
  27056. ><TR
  27057. ><TD
  27058. ><PRE
  27059. CLASS="php"
  27060. >return.php
  27061. <?php
  27062.  
  27063. $var = 'PHP';
  27064.  
  27065. return $var;
  27066.  
  27067. ?>
  27068.  
  27069. noreturn.php
  27070. <?php
  27071.  
  27072. $var = 'PHP';
  27073.  
  27074. ?>
  27075.  
  27076. testreturns.php
  27077. <?php
  27078.  
  27079. $foo = include 'return.php';
  27080.  
  27081. echo $foo; // vypφ╣e 'PHP'
  27082.  
  27083. $bar = include 'noreturn.php';
  27084.  
  27085. echo $bar; // vypφ╣e 1
  27086.  
  27087. ?></PRE
  27088. ></TD
  27089. ></TR
  27090. ></TABLE
  27091. ></DIV
  27092. ></TD
  27093. ></TR
  27094. ></TABLE
  27095. >
  27096.    </P
  27097. ><P
  27098. >     <TT
  27099. CLASS="literal"
  27100. >$bar</TT
  27101. > mß hodnotu <TT
  27102. CLASS="literal"
  27103. >1</TT
  27104. >, proto╛e p°φkaz
  27105.     include byl ·sp∞╣n². V╣imn∞te si rozdφlu mezi v²╣e uveden²mi p°φklady.
  27106.     Prvnφ pou╛φvß ve vklßdanΘm souboru <A
  27107. HREF="#function.return"
  27108. ><B
  27109. CLASS="function"
  27110. >return()</B
  27111. ></A
  27112. >, druh²
  27113.     nikoli. Dal╣φmi zp∙soby, jak p°i°adit hodnotu souboru do prom∞nnΘ, jsou
  27114.     funkce <A
  27115. HREF="#function.fopen"
  27116. ><B
  27117. CLASS="function"
  27118. >fopen()</B
  27119. ></A
  27120. >, <A
  27121. HREF="#function.file"
  27122. ><B
  27123. CLASS="function"
  27124. >file()</B
  27125. ></A
  27126. > a pou╛itφ
  27127.     <A
  27128. HREF="#function.include"
  27129. ><B
  27130. CLASS="function"
  27131. >include()</B
  27132. ></A
  27133. > spoleΦn∞ s
  27134.     <A
  27135. HREF="#ref.outcontrol"
  27136. >funkcemi °φzenφ v²stupu</A
  27137. >.
  27138.    </P
  27139. ><P
  27140. >     Viz takΘ <A
  27141. HREF="#function.require"
  27142. ><B
  27143. CLASS="function"
  27144. >require()</B
  27145. ></A
  27146. >, <A
  27147. HREF="#function.require-once"
  27148. ><B
  27149. CLASS="function"
  27150. >require_once()</B
  27151. ></A
  27152. >,
  27153.     <A
  27154. HREF="#function.include-once"
  27155. ><B
  27156. CLASS="function"
  27157. >include_once()</B
  27158. ></A
  27159. >, <A
  27160. HREF="#function.readfile"
  27161. ><B
  27162. CLASS="function"
  27163. >readfile()</B
  27164. ></A
  27165. >,
  27166.     <A
  27167. HREF="#function.virtual"
  27168. ><B
  27169. CLASS="function"
  27170. >virtual()</B
  27171. ></A
  27172. >, a
  27173.     <A
  27174. HREF="#ini.include-path"
  27175. >include_path</A
  27176. >.
  27177.    </P
  27178. ></DIV
  27179. ><DIV
  27180. CLASS="sect1"
  27181. ><HR><H2
  27182. CLASS="sect1"
  27183. ><A
  27184. NAME="function.require-once"
  27185. ></A
  27186. ><A
  27187. HREF="#function.require-once"
  27188. ><B
  27189. CLASS="function"
  27190. >require_once()</B
  27191. ></A
  27192. ></H2
  27193. ><P
  27194. >     Konstrukt <A
  27195. HREF="#function.require-once"
  27196. ><B
  27197. CLASS="function"
  27198. >require_once()</B
  27199. ></A
  27200. > vlo╛φ a ohodnotφ specifikovan²
  27201.     soubor b∞hem provßd∞nφ skriptu. Chovß se tedy podobn∞ jako
  27202.     <A
  27203. HREF="#function.require"
  27204. ><B
  27205. CLASS="function"
  27206. >require()</B
  27207. ></A
  27208. >, s tφm rozdφlem, ╛e pokud u╛ byl k≤d ze
  27209.     souboru d°φve vlo╛en do skriptu, nebude znovu vklßdßn. Vφce informacφ o
  27210.     chovßnφ p°φkazu -- viz p°φkaz <A
  27211. HREF="#function.require"
  27212. ><B
  27213. CLASS="function"
  27214. >require()</B
  27215. ></A
  27216. >.
  27217.    </P
  27218. ><P
  27219. >     P°φkaz <A
  27220. HREF="#function.require-once"
  27221. ><B
  27222. CLASS="function"
  27223. >require_once()</B
  27224. ></A
  27225. > by se m∞l pou╛φvat v p°φpadech,
  27226.     kde by mohl b²t b∞hem provßd∞nφ skriptu tent²╛ soubor vlo╛en a ohodnocen
  27227.     vφckrßt, a p°itom chcete zajistit prßv∞ jedno vlo╛enφ (je t°eba se vyhnout
  27228.     redefinicφm funkcφ, novΘmu p°i°azenφ hodnot atd.).
  27229.    </P
  27230. ><P
  27231. >      P°φklady na pou╛itφ <A
  27232. HREF="#function.require-once"
  27233. ><B
  27234. CLASS="function"
  27235. >require_once()</B
  27236. ></A
  27237. > a
  27238.      <A
  27239. HREF="#function.include-once"
  27240. ><B
  27241. CLASS="function"
  27242. >include_once()</B
  27243. ></A
  27244. > najdete v k≤du 
  27245.      <A
  27246. HREF="http://pear.php.net/"
  27247. TARGET="_top"
  27248. >PEAR</A
  27249. > p°ilo╛enΘm v nejnov∞j╣φch
  27250.      distribucφch zdrojov²ch k≤d∙ PHP.
  27251.    </P
  27252. ><DIV
  27253. CLASS="note"
  27254. ><BLOCKQUOTE
  27255. CLASS="note"
  27256. ><P
  27257. ><B
  27258. >Poznßmka: </B
  27259. >
  27260.      P°φkaz <A
  27261. HREF="#function.require-once"
  27262. ><B
  27263. CLASS="function"
  27264. >require_once()</B
  27265. ></A
  27266. > byl p°idßn v PHP 4.0.1pl2.
  27267.     </P
  27268. ></BLOCKQUOTE
  27269. ></DIV
  27270. ><P
  27271. >     Viz takΘ: <A
  27272. HREF="#function.require"
  27273. ><B
  27274. CLASS="function"
  27275. >require()</B
  27276. ></A
  27277. >,
  27278.     <A
  27279. HREF="#function.include"
  27280. ><B
  27281. CLASS="function"
  27282. >include()</B
  27283. ></A
  27284. >, <A
  27285. HREF="#function.include-once"
  27286. ><B
  27287. CLASS="function"
  27288. >include_once()</B
  27289. ></A
  27290. >,
  27291.     <A
  27292. HREF="#function.get-required-files"
  27293. ><B
  27294. CLASS="function"
  27295. >get_required_files()</B
  27296. ></A
  27297. >,
  27298.     <A
  27299. HREF="#function.get-included-files"
  27300. ><B
  27301. CLASS="function"
  27302. >get_included_files()</B
  27303. ></A
  27304. >, <A
  27305. HREF="#function.readfile"
  27306. ><B
  27307. CLASS="function"
  27308. >readfile()</B
  27309. ></A
  27310. >,
  27311.     a <A
  27312. HREF="#function.virtual"
  27313. ><B
  27314. CLASS="function"
  27315. >virtual()</B
  27316. ></A
  27317. >.
  27318.    </P
  27319. ></DIV
  27320. ><DIV
  27321. CLASS="sect1"
  27322. ><HR><H2
  27323. CLASS="sect1"
  27324. ><A
  27325. NAME="function.include-once"
  27326. ></A
  27327. ><A
  27328. HREF="#function.include-once"
  27329. ><B
  27330. CLASS="function"
  27331. >include_once()</B
  27332. ></A
  27333. ></H2
  27334. ><P
  27335. >     Konstrukt <A
  27336. HREF="#function.include-once"
  27337. ><B
  27338. CLASS="function"
  27339. >include_once()</B
  27340. ></A
  27341. > vlo╛φ a ohodnotφ specifikovan²
  27342.     soubor b∞hem provßd∞nφ skriptu. Chovß se tedy podobn∞ jako
  27343.     <A
  27344. HREF="#function.include"
  27345. ><B
  27346. CLASS="function"
  27347. >include()</B
  27348. ></A
  27349. > , s tφm rozdφlem, ╛e pokud u╛ byl k≤d ze
  27350.     souboru d°φve vlo╛en do skriptu, nebude znovu vklßdßn. Jak nßzev napovφdß,
  27351.     bude vlo╛en prßv∞ jednou.
  27352.    </P
  27353. ><P
  27354. >     P°φkaz <A
  27355. HREF="#function.include-once"
  27356. ><B
  27357. CLASS="function"
  27358. >include_once()</B
  27359. ></A
  27360. > by se m∞l pou╛φvat v p°φpadech,
  27361.     kde by mohl b²t b∞hem provßd∞nφ skriptu tent²╛ soubor vlo╛en a ohodnocen
  27362.     vφckrßt, a p°itom chcete zajistit prßv∞ jedno vlo╛enφ (je t°eba se vyhnout
  27363.     redefinicφm funkcφ, novΘmu p°i°azenφ hodnot atd.).
  27364.    </P
  27365. ><P
  27366. >      P°φklady na pou╛itφ <A
  27367. HREF="#function.require-once"
  27368. ><B
  27369. CLASS="function"
  27370. >require_once()</B
  27371. ></A
  27372. > and
  27373.      <A
  27374. HREF="#function.include-once"
  27375. ><B
  27376. CLASS="function"
  27377. >include_once()</B
  27378. ></A
  27379. > najdete v k≤du 
  27380.      <A
  27381. HREF="http://pear.php.net/"
  27382. TARGET="_top"
  27383. >PEAR</A
  27384. > p°ilo╛enΘm v nejnov∞j╣φch
  27385.      distribucφch zdrojov²ch k≤d∙ PHP.
  27386.    </P
  27387. ><DIV
  27388. CLASS="note"
  27389. ><BLOCKQUOTE
  27390. CLASS="note"
  27391. ><P
  27392. ><B
  27393. >Poznßmka: </B
  27394. >
  27395.      P°φkaz <A
  27396. HREF="#function.include-once"
  27397. ><B
  27398. CLASS="function"
  27399. >include_once()</B
  27400. ></A
  27401. > byl p°idßn v PHP 4.0.1pl2.
  27402.     </P
  27403. ></BLOCKQUOTE
  27404. ></DIV
  27405. ><P
  27406. >     Viz takΘ <A
  27407. HREF="#function.include"
  27408. ><B
  27409. CLASS="function"
  27410. >include()</B
  27411. ></A
  27412. >,
  27413.     <A
  27414. HREF="#function.require"
  27415. ><B
  27416. CLASS="function"
  27417. >require()</B
  27418. ></A
  27419. >, <A
  27420. HREF="#function.require-once"
  27421. ><B
  27422. CLASS="function"
  27423. >require_once()</B
  27424. ></A
  27425. >,
  27426.     <A
  27427. HREF="#function.get-required-files"
  27428. ><B
  27429. CLASS="function"
  27430. >get_required_files()</B
  27431. ></A
  27432. >,
  27433.     <A
  27434. HREF="#function.get-included-files"
  27435. ><B
  27436. CLASS="function"
  27437. >get_included_files()</B
  27438. ></A
  27439. >, <A
  27440. HREF="#function.readfile"
  27441. ><B
  27442. CLASS="function"
  27443. >readfile()</B
  27444. ></A
  27445. >,
  27446.     a <A
  27447. HREF="#function.virtual"
  27448. ><B
  27449. CLASS="function"
  27450. >virtual()</B
  27451. ></A
  27452. >.
  27453.    </P
  27454. ></DIV
  27455. ></DIV
  27456. ><DIV
  27457. CLASS="chapter"
  27458. ><HR><H1
  27459. ><A
  27460. NAME="functions"
  27461. >Kapitola 12. Funkce</A
  27462. ></H1
  27463. ><DIV
  27464. CLASS="sect1"
  27465. ><H2
  27466. CLASS="sect1"
  27467. ><A
  27468. NAME="functions.user-defined"
  27469. ></A
  27470. >U╛ivatelsky definovanΘ funkce</H2
  27471. ><P
  27472. >     Funkce m∙╛e b²t definovßna pomocφ syntaxe podobnΘ tΘto:
  27473.  
  27474.     <DIV
  27475. CLASS="informalexample"
  27476. ><A
  27477. NAME="AEN5270"
  27478. ></A
  27479. ><P
  27480. ></P
  27481. ><TABLE
  27482. BORDER="0"
  27483. BGCOLOR="#E0E0E0"
  27484. CELLPADDING="5"
  27485. ><TR
  27486. ><TD
  27487. ><PRE
  27488. CLASS="php"
  27489. >function foo ($arg_1, $arg_2, ..., $arg_n)
  27490. {
  27491.     echo "Ukßzkovß funkce.\n";
  27492.     return $retval;
  27493. }</PRE
  27494. ></TD
  27495. ></TR
  27496. ></TABLE
  27497. ><P
  27498. ></P
  27499. ></DIV
  27500. >
  27501.    </P
  27502. ><P
  27503. >     Do funkce m∙╛e b²t vlo╛en jak²koli platn² PHP k≤d, dokonce i definice
  27504.     jin²ch funkcφ a <A
  27505. HREF="#keyword.class"
  27506. >t°φd</A
  27507. >.
  27508.    </P
  27509. ><P
  27510. >     V PHP 3 musφ b²t funkce definovßny d°φve, ne╛ je na n∞ odkazovßno.
  27511.     V PHP u╛ tento po╛adavek neplatφ.
  27512.    </P
  27513. ><P
  27514. >     PHP nepodporuje p°et∞╛ovßnφ funkcφ, nenφ mo╛nΘ ani oddefinovßnφ nebo
  27515.     p°edefinovanß d°φve deklarovan²ch funkcφ.
  27516.    </P
  27517. ><P
  27518. >     PHP 3 nepodporuje prom∞nn² poΦet argument∙ funkcφ, zatφmco implicitnφ
  27519.     argumenty jsou podporovßny (vφce informacφ - viz
  27520.     <A
  27521. HREF="#functions.arguments.default"
  27522. >Implicitnφ hodnoty argument∙</A
  27523. >).
  27524.     PHP 4 podporuje obojφ: vφce informacφ - viz
  27525.     <A
  27526. HREF="#functions.variable-arg-list"
  27527. >Seznam argument∙ prom∞nnΘ
  27528.     dΘlky</A
  27529. > a reference funkcφ <A
  27530. HREF="#function.func-num-args"
  27531. ><B
  27532. CLASS="function"
  27533. >func_num_args()</B
  27534. ></A
  27535. >,
  27536.     <A
  27537. HREF="#function.func-get-arg"
  27538. ><B
  27539. CLASS="function"
  27540. >func_get_arg()</B
  27541. ></A
  27542. >, a <A
  27543. HREF="#function.func-get-args"
  27544. ><B
  27545. CLASS="function"
  27546. >func_get_args()</B
  27547. ></A
  27548. >.
  27549.    </P
  27550. ></DIV
  27551. ><DIV
  27552. CLASS="sect1"
  27553. ><HR><H2
  27554. CLASS="sect1"
  27555. ><A
  27556. NAME="functions.arguments"
  27557. ></A
  27558. >Argumenty funkcφ</H2
  27559. ><P
  27560. >     Informace mohou b²t do funkcφ p°edßvßny p°es seznam argument∙, co╛ je
  27561.     seznam prom∞nn²ch a/nebo konstant odd∞len²ch Φßrkou.
  27562.    </P
  27563. ><P
  27564. >     PHP podporuje p°edßvßnφ argument∙ hodnotou (implicitnφ),
  27565.     <A
  27566. HREF="#functions.arguments.by-reference"
  27567. >p°edßvßnφ odkazem</A
  27568. >,
  27569.     a <A
  27570. HREF="#functions.arguments.default"
  27571. >implicitnφ hodnoty
  27572.     argument∙</A
  27573. >. Prom∞nnß dΘlka seznamu argument∙ je podporovßna pouze
  27574.     v PHP 4 a pozd∞j╣φch; viz
  27575.     <A
  27576. HREF="#functions.variable-arg-list"
  27577. >Seznam argument∙ prom∞nnΘ
  27578.     dΘlky</A
  27579. > a reference funkcφ <A
  27580. HREF="#function.func-num-args"
  27581. ><B
  27582. CLASS="function"
  27583. >func_num_args()</B
  27584. ></A
  27585. >,
  27586.     <A
  27587. HREF="#function.func-get-arg"
  27588. ><B
  27589. CLASS="function"
  27590. >func_get_arg()</B
  27591. ></A
  27592. >, a <A
  27593. HREF="#function.func-get-args"
  27594. ><B
  27595. CLASS="function"
  27596. >func_get_args()</B
  27597. ></A
  27598. >.
  27599.     Podobn² efekt m∙╛e b²t v PHP 3 dosa╛en p°edßnφm pole argument∙ do
  27600.     funkce:
  27601.  
  27602.     <DIV
  27603. CLASS="informalexample"
  27604. ><A
  27605. NAME="AEN5292"
  27606. ></A
  27607. ><P
  27608. ></P
  27609. ><TABLE
  27610. BORDER="0"
  27611. BGCOLOR="#E0E0E0"
  27612. CELLPADDING="5"
  27613. ><TR
  27614. ><TD
  27615. ><PRE
  27616. CLASS="php"
  27617. >function takes_array($input)
  27618. {
  27619.     echo "$input[0] + $input[1] = ", $input[0]+$input[1];
  27620. }</PRE
  27621. ></TD
  27622. ></TR
  27623. ></TABLE
  27624. ><P
  27625. ></P
  27626. ></DIV
  27627. >
  27628.    </P
  27629. ><DIV
  27630. CLASS="sect2"
  27631. ><HR><H3
  27632. CLASS="sect2"
  27633. ><A
  27634. NAME="functions.arguments.by-reference"
  27635. ></A
  27636. >P°edßvßnφ argument∙ odkazem</H3
  27637. ><P
  27638. >      Implicitn∞ jsou argumenty funkcφ p°edßvßny hodnotou (tak╛e kdy╛ zm∞nφte
  27639.      hodnotu argumentu ve funkci, nezm∞nφ se mimo funkci). Pokud chcete
  27640.      umo╛nit funkci modifikovat svΘ argumenty, musφte je p°edßvat odkazem.
  27641.     </P
  27642. ><P
  27643. >      Pokud chcete, aby byl argument do funkce p°edßvßn v╛dy odkazem, m∙╛ete
  27644.      p°ed nßzev argumentu v definici funkce p°ed°adit ampersand (&):
  27645.  
  27646.      <DIV
  27647. CLASS="informalexample"
  27648. ><A
  27649. NAME="AEN5298"
  27650. ></A
  27651. ><P
  27652. ></P
  27653. ><TABLE
  27654. BORDER="0"
  27655. BGCOLOR="#E0E0E0"
  27656. CELLPADDING="5"
  27657. ><TR
  27658. ><TD
  27659. ><PRE
  27660. CLASS="php"
  27661. >function add_some_extra(&$string)
  27662. {
  27663.     $string .= 'a n∞co navφc.';
  27664. }
  27665. $str = 'Toto je °et∞zec ';
  27666. add_some_extra($str);
  27667. echo $str;    // vypφ╣e 'Toto je °et∞zec a n∞co navφc.'</PRE
  27668. ></TD
  27669. ></TR
  27670. ></TABLE
  27671. ><P
  27672. ></P
  27673. ></DIV
  27674. >
  27675.     </P
  27676. ></DIV
  27677. ><DIV
  27678. CLASS="sect2"
  27679. ><HR><H3
  27680. CLASS="sect2"
  27681. ><A
  27682. NAME="functions.arguments.default"
  27683. ></A
  27684. >Implicitnφ hodnoty argument∙</H3
  27685. ><P
  27686. >      Funkce m∙╛e ve stylu C++ definovat implicitnφ hodnoty pro skalßrnφ
  27687.      argumenty takto:
  27688.  
  27689.      <DIV
  27690. CLASS="informalexample"
  27691. ><A
  27692. NAME="AEN5303"
  27693. ></A
  27694. ><P
  27695. ></P
  27696. ><TABLE
  27697. BORDER="0"
  27698. BGCOLOR="#E0E0E0"
  27699. CELLPADDING="5"
  27700. ><TR
  27701. ><TD
  27702. ><PRE
  27703. CLASS="php"
  27704. >function makecoffee ($type = "cappucina")
  27705. {
  27706.     return "D∞lßm ╣ßlek $type.\n";
  27707. }
  27708. echo makecoffee ();
  27709. echo makecoffee ("espressa");</PRE
  27710. ></TD
  27711. ></TR
  27712. ></TABLE
  27713. ><P
  27714. ></P
  27715. ></DIV
  27716. >
  27717.     </P
  27718. ><P
  27719. >      V²stupem v²╣e uvedenΘho k≤du je:
  27720.  
  27721.      <TABLE
  27722. BORDER="0"
  27723. BGCOLOR="#E0E0E0"
  27724. CELLPADDING="5"
  27725. ><TR
  27726. ><TD
  27727. ><PRE
  27728. CLASS="screen"
  27729. >D∞lßm ╣ßlek cappucina.
  27730. D∞lßm ╣ßlek espressa.</PRE
  27731. ></TD
  27732. ></TR
  27733. ></TABLE
  27734. >
  27735.     </P
  27736. ><P
  27737. >      Implicitnφ hodnota musφ b²t konstantnφ v²raz, ne (nap°φklad) prom∞nnß
  27738.      nebo polo╛ka t°φdy.
  27739.     </P
  27740. ><P
  27741. >      Uv∞domte si, ╛e kdy╛ pou╛φvßte implicitnφ argumenty, jakΘkoli implicitnφ
  27742.      hodnoty by m∞ly b²t na pravΘ stan∞ neimplicitnφho argumentu; jinak
  27743.      to nebude pracovat podle oΦekßvßnφ. Uva╛ujme tento kus k≤du:
  27744.  
  27745.      <DIV
  27746. CLASS="informalexample"
  27747. ><A
  27748. NAME="AEN5309"
  27749. ></A
  27750. ><P
  27751. ></P
  27752. ><TABLE
  27753. BORDER="0"
  27754. BGCOLOR="#E0E0E0"
  27755. CELLPADDING="5"
  27756. ><TR
  27757. ><TD
  27758. ><PRE
  27759. CLASS="php"
  27760. >function makeyogurt ($type = "acidophilus", $flavour)
  27761. {
  27762.     return "D∞lßm kelφmek jogurtu $type $flavour.\n";
  27763. }
  27764.  
  27765. echo makeyogurt ("malina");   // nebude pracovat podle oΦekßvßnφ</PRE
  27766. ></TD
  27767. ></TR
  27768. ></TABLE
  27769. ><P
  27770. ></P
  27771. ></DIV
  27772. >
  27773.     </P
  27774. ><P
  27775. >      V²stupem uvedenΘho p°φkladu bude:
  27776.  
  27777.      <TABLE
  27778. BORDER="0"
  27779. BGCOLOR="#E0E0E0"
  27780. CELLPADDING="5"
  27781. ><TR
  27782. ><TD
  27783. ><PRE
  27784. CLASS="screen"
  27785. >Warning: Missing argument 2 in call to makeyogurt() in 
  27786. /usr/local/etc/httpd/htdocs/php3test/functest.html on line 41
  27787. D∞lßm kelφmek jogurtu malina.</PRE
  27788. ></TD
  27789. ></TR
  27790. ></TABLE
  27791. >
  27792.     </P
  27793. ><P
  27794. >      A nynφ to porovnejme s tφmto:
  27795.  
  27796.      <DIV
  27797. CLASS="informalexample"
  27798. ><A
  27799. NAME="AEN5314"
  27800. ></A
  27801. ><P
  27802. ></P
  27803. ><TABLE
  27804. BORDER="0"
  27805. BGCOLOR="#E0E0E0"
  27806. CELLPADDING="5"
  27807. ><TR
  27808. ><TD
  27809. ><PRE
  27810. CLASS="php"
  27811. >function makeyogurt ($flavour, $type = "acidophilus")
  27812. {
  27813.     return "D∞lßm kelφmek jogurtu $type $flavour.\n";
  27814. }
  27815.  
  27816. echo makeyogurt ("malina");   // pracuje podle oΦekßvßnφ</PRE
  27817. ></TD
  27818. ></TR
  27819. ></TABLE
  27820. ><P
  27821. ></P
  27822. ></DIV
  27823. >
  27824.     </P
  27825. ><P
  27826. >      P°φklad vytiskne:
  27827.  
  27828.      <TABLE
  27829. BORDER="0"
  27830. BGCOLOR="#E0E0E0"
  27831. CELLPADDING="5"
  27832. ><TR
  27833. ><TD
  27834. ><PRE
  27835. CLASS="screen"
  27836. >D∞lßm kelφmek jogurtu acidophilus malina.</PRE
  27837. ></TD
  27838. ></TR
  27839. ></TABLE
  27840. >
  27841.     </P
  27842. ></DIV
  27843. ><DIV
  27844. CLASS="sect2"
  27845. ><HR><H3
  27846. CLASS="sect2"
  27847. ><A
  27848. NAME="functions.variable-arg-list"
  27849. ></A
  27850. >Seznam argument∙ prom∞nnΘ dΘlky</H3
  27851. ><P
  27852. >      PHP 4 mß podporu pro seznam argument∙ prom∞nnΘ dΘlky v u╛ivatelsk²ch
  27853.      funkcφch. Je to opravdu jednoduchΘ, pou╛itφm funkcφ
  27854.      <A
  27855. HREF="#function.func-num-args"
  27856. ><B
  27857. CLASS="function"
  27858. >func_num_args()</B
  27859. ></A
  27860. >,
  27861.      <A
  27862. HREF="#function.func-get-arg"
  27863. ><B
  27864. CLASS="function"
  27865. >func_get_arg()</B
  27866. ></A
  27867. >, a
  27868.      <A
  27869. HREF="#function.func-get-args"
  27870. ><B
  27871. CLASS="function"
  27872. >func_get_args()</B
  27873. ></A
  27874. >.
  27875.     </P
  27876. ><P
  27877. >      Nenφ t°eba ╛ßdnß zvlß╣tnφ syntaxe, seznam argument∙ m∙╛e b²t stßle
  27878.      explicitn∞ poskytovßn definicemi funkcφ a bude se chovat jako normßln∞.
  27879.     </P
  27880. ></DIV
  27881. ></DIV
  27882. ><DIV
  27883. CLASS="sect1"
  27884. ><HR><H2
  27885. CLASS="sect1"
  27886. ><A
  27887. NAME="functions.returning-values"
  27888. ></A
  27889. >NßvratovΘ hodnoty</H2
  27890. ><P
  27891. >     Hodnoty jsou vraceny pomocφ nepovinnΘ klausule return. M∙╛e b²t vracen
  27892.     libovoln² typ, vΦetn∞ seznam∙ a objekt∙. Klasule zp∙sobuje, ╛e funkce
  27893.     okam╛it∞ ukonΦφ sv∙j b∞h a p°edß °φzenφ zp∞t na °ßdek, odkud byla volßna.
  27894.     Pro vφce informacφ viz <A
  27895. HREF="#function.return"
  27896. ><B
  27897. CLASS="function"
  27898. >return()</B
  27899. ></A
  27900. >.
  27901.     <DIV
  27902. CLASS="informalexample"
  27903. ><A
  27904. NAME="AEN5329"
  27905. ></A
  27906. ><P
  27907. ></P
  27908. ><TABLE
  27909. BORDER="0"
  27910. BGCOLOR="#E0E0E0"
  27911. CELLPADDING="5"
  27912. ><TR
  27913. ><TD
  27914. ><PRE
  27915. CLASS="php"
  27916. >function square ($num)
  27917. {
  27918.     return $num * $num;
  27919. }
  27920. echo square (4);   // vypφ╣e '16'.</PRE
  27921. ></TD
  27922. ></TR
  27923. ></TABLE
  27924. ><P
  27925. ></P
  27926. ></DIV
  27927. >
  27928.    </P
  27929. ><P
  27930. >     Z funkce nem∙╛ete vracet vφce hodnot, ale podobnΘho v²sledku m∙╛e b²t
  27931.     dosa╛eno vrßcenφm seznamu.
  27932.  
  27933.     <DIV
  27934. CLASS="informalexample"
  27935. ><A
  27936. NAME="AEN5332"
  27937. ></A
  27938. ><P
  27939. ></P
  27940. ><TABLE
  27941. BORDER="0"
  27942. BGCOLOR="#E0E0E0"
  27943. CELLPADDING="5"
  27944. ><TR
  27945. ><TD
  27946. ><PRE
  27947. CLASS="php"
  27948. >function small_numbers()
  27949. {
  27950.     return array (0, 1, 2);
  27951. }
  27952. list ($zero, $one, $two) = small_numbers();</PRE
  27953. ></TD
  27954. ></TR
  27955. ></TABLE
  27956. ><P
  27957. ></P
  27958. ></DIV
  27959. >
  27960.    </P
  27961. ><P
  27962. >     K vrßcenφ odkazu z funkce musφte pou╛φt referenΦnφ operßtor & jak
  27963.     v deklaraci funkce, tak p°i p°i°azovßnφ vrßcenΘ hodnoty do prom∞nnΘ:
  27964.     <DIV
  27965. CLASS="informalexample"
  27966. ><A
  27967. NAME="AEN5335"
  27968. ></A
  27969. ><P
  27970. ></P
  27971. ><TABLE
  27972. BORDER="0"
  27973. BGCOLOR="#E0E0E0"
  27974. CELLPADDING="5"
  27975. ><TR
  27976. ><TD
  27977. ><PRE
  27978. CLASS="php"
  27979. >function &returns_reference()
  27980. {
  27981.     return $someref;
  27982. }
  27983.  
  27984. $newref =& returns_reference();</PRE
  27985. ></TD
  27986. ></TR
  27987. ></TABLE
  27988. ><P
  27989. ></P
  27990. ></DIV
  27991. >
  27992.    </P
  27993. ><P
  27994. >     Pro dal╣φ informace o odkazech se laskav∞ podφvejte na
  27995.     <A
  27996. HREF="#language.references"
  27997. >Vysv∞tlenφ odkaz∙</A
  27998. >.
  27999.    </P
  28000. ></DIV
  28001. ><DIV
  28002. CLASS="sect1"
  28003. ><HR><H2
  28004. CLASS="sect1"
  28005. ><A
  28006. NAME="functions.old-syntax"
  28007. ></A
  28008. ><TT
  28009. CLASS="literal"
  28010. >old_function</TT
  28011. ></H2
  28012. ><P
  28013. >     Klausule <TT
  28014. CLASS="literal"
  28015. >old_function</TT
  28016. > umo╛≥uje deklarovat funkci
  28017.     s identickou syntaxφ jako v PHP/FI2 (krom∞ toho, ╛e musφte 'function'
  28018.     nahradit 'old_function'.
  28019.    </P
  28020. ><P
  28021. >     Toto je zavr╛enß mo╛nost a m∞la by b²t pou╛φvßna pouze PHP/FI2->PHP 3
  28022.     konvertorem.
  28023.    </P
  28024. ><DIV
  28025. CLASS="warning"
  28026. ><P
  28027. ></P
  28028. ><TABLE
  28029. CLASS="warning"
  28030. BORDER="1"
  28031. WIDTH="100%"
  28032. ><TR
  28033. ><TD
  28034. ALIGN="CENTER"
  28035. ><B
  28036. >Varovßnφ</B
  28037. ></TD
  28038. ></TR
  28039. ><TR
  28040. ><TD
  28041. ALIGN="LEFT"
  28042. ><P
  28043. >      Funkce deklarovanΘ jako <TT
  28044. CLASS="literal"
  28045. >old_function</TT
  28046. > nelze volat
  28047.      z internφho k≤du PHP. To mj. znamenß, ╛e je nem∙╛ete pou╛φvat ve funkcφch
  28048.      jako <A
  28049. HREF="#function.usort"
  28050. ><B
  28051. CLASS="function"
  28052. >usort()</B
  28053. ></A
  28054. >, <A
  28055. HREF="#function.array-walk"
  28056. ><B
  28057. CLASS="function"
  28058. >array_walk()</B
  28059. ></A
  28060. >, a
  28061.      <A
  28062. HREF="#function.register-shutdown-function"
  28063. ><B
  28064. CLASS="function"
  28065. >register_shutdown_function()</B
  28066. ></A
  28067. >. Toto omezenφ m∙╛ete
  28068.      obejφt napsßnφm wrapperu (v normßlnφ PHP 3 form∞), z n∞ho╛ volßte
  28069.      <TT
  28070. CLASS="literal"
  28071. >old_function</TT
  28072. >.
  28073.     </P
  28074. ></TD
  28075. ></TR
  28076. ></TABLE
  28077. ></DIV
  28078. ></DIV
  28079. ><DIV
  28080. CLASS="sect1"
  28081. ><HR><H2
  28082. CLASS="sect1"
  28083. ><A
  28084. NAME="functions.variable-functions"
  28085. ></A
  28086. >Funkce v prom∞nn²ch</H2
  28087. ><P
  28088. >     PHP podporuje koncept funkcφ v prom∞nn²ch. To znamenß, ╛e kdy╛
  28089.     mß nßzev prom∞nnΘ p°ipojeny zßvorky, PHP bude hledat funkci se stejn²m
  28090.     nßzvem, jako mß hodnota prom∞nnΘ, a pokusφ se ji provΘst. To lze mj.
  28091.     pou╛φt k implementacφ zp∞tn²ch volßnφ, tabulek funkcφ atd.
  28092.    </P
  28093. ><P
  28094. >     Funkce v prom∞nn²ch nebudou fungovat s jazykov²mi konstrukty jin²mi ne╛
  28095.     <A
  28096. HREF="#function.print"
  28097. ><B
  28098. CLASS="function"
  28099. >print()</B
  28100. ></A
  28101. >, jako je <A
  28102. HREF="#function.echo"
  28103. ><B
  28104. CLASS="function"
  28105. >echo()</B
  28106. ></A
  28107. >,
  28108.     <A
  28109. HREF="#function.unset"
  28110. ><B
  28111. CLASS="function"
  28112. >unset()</B
  28113. ></A
  28114. >, <A
  28115. HREF="#function.isset"
  28116. ><B
  28117. CLASS="function"
  28118. >isset()</B
  28119. ></A
  28120. > a
  28121.     <A
  28122. HREF="#function.empty"
  28123. ><B
  28124. CLASS="function"
  28125. >empty()</B
  28126. ></A
  28127. >. To je jeden z velk²ch rozdφl∙ mezi funkcemi
  28128.     PHP a jazykov²mi konstrukty.
  28129.    </P
  28130. ><P
  28131. >     <TABLE
  28132. WIDTH="100%"
  28133. BORDER="0"
  28134. CELLPADDING="0"
  28135. CELLSPACING="0"
  28136. CLASS="EXAMPLE"
  28137. ><TR
  28138. ><TD
  28139. ><DIV
  28140. CLASS="example"
  28141. ><A
  28142. NAME="AEN5362"
  28143. ></A
  28144. ><P
  28145. ><B
  28146. >P°φklad 12-1. P°φklad na funkce v prom∞nn²ch</B
  28147. ></P
  28148. ><TABLE
  28149. BORDER="0"
  28150. BGCOLOR="#E0E0E0"
  28151. CELLPADDING="5"
  28152. ><TR
  28153. ><TD
  28154. ><PRE
  28155. CLASS="php"
  28156. ><?php
  28157. function foo()
  28158. {
  28159.     echo "V foo()<br>\n";
  28160. }
  28161.  
  28162. function bar($arg = '')
  28163. {
  28164.     echo "V bar(); byl argument '$arg'.<br>\n";
  28165. }
  28166.  
  28167. $func = 'foo';
  28168. $func();
  28169. $func = 'bar';
  28170. $func('test');
  28171. ?></PRE
  28172. ></TD
  28173. ></TR
  28174. ></TABLE
  28175. ></DIV
  28176. ></TD
  28177. ></TR
  28178. ></TABLE
  28179. >
  28180.    </P
  28181. ></DIV
  28182. ></DIV
  28183. ><DIV
  28184. CLASS="chapter"
  28185. ><HR><H1
  28186. ><A
  28187. NAME="language.oop"
  28188. >Kapitola 13. Classes and Objects</A
  28189. ></H1
  28190. ><DIV
  28191. CLASS="sect1"
  28192. ><H2
  28193. CLASS="sect1"
  28194. ><A
  28195. NAME="keyword.class"
  28196. ></A
  28197. ><TT
  28198. CLASS="literal"
  28199. >class</TT
  28200. ></H2
  28201. ><P
  28202. >     A class is a collection of variables and functions working with
  28203.     these variables.  A class is defined using the following syntax:
  28204.    </P
  28205. ><P
  28206. >     <DIV
  28207. CLASS="informalexample"
  28208. ><A
  28209. NAME="AEN5372"
  28210. ></A
  28211. ><P
  28212. ></P
  28213. ><TABLE
  28214. BORDER="0"
  28215. BGCOLOR="#E0E0E0"
  28216. CELLPADDING="5"
  28217. ><TR
  28218. ><TD
  28219. ><PRE
  28220. CLASS="php"
  28221. ><?php
  28222. class Cart
  28223. {
  28224.     var $items;  // Items in our shopping cart
  28225.    
  28226.     // Add $num articles of $artnr to the cart
  28227.  
  28228.     function add_item ($artnr, $num)
  28229.     {
  28230.         $this->items[$artnr] += $num;
  28231.     }
  28232.    
  28233.     // Take $num articles of $artnr out of the cart
  28234.  
  28235.     function remove_item ($artnr, $num)
  28236.     {
  28237.         if ($this->items[$artnr] > $num) {
  28238.             $this->items[$artnr] -= $num;
  28239.             return true;
  28240.         } else {
  28241.             return false;
  28242.         }   
  28243.     }
  28244. }
  28245. ?></PRE
  28246. ></TD
  28247. ></TR
  28248. ></TABLE
  28249. ><P
  28250. ></P
  28251. ></DIV
  28252. >
  28253.    </P
  28254. ><P
  28255. >     This defines a class named Cart that consists of an associative
  28256.     array of articles in the cart and two functions to add and remove
  28257.     items from this cart.
  28258.    </P
  28259. ><DIV
  28260. CLASS="warning"
  28261. ><P
  28262. ></P
  28263. ><TABLE
  28264. CLASS="warning"
  28265. BORDER="1"
  28266. WIDTH="100%"
  28267. ><TR
  28268. ><TD
  28269. ALIGN="CENTER"
  28270. ><B
  28271. >Varovßnφ</B
  28272. ></TD
  28273. ></TR
  28274. ><TR
  28275. ><TD
  28276. ALIGN="LEFT"
  28277. ><P
  28278. >      You can <SPAN
  28279. CLASS="emphasis"
  28280. ><I
  28281. CLASS="emphasis"
  28282. >NOT</I
  28283. ></SPAN
  28284. > break up a class definition into
  28285.      multiple files, or multiple PHP blocks. The following will not work:
  28286.     </P
  28287. ><P
  28288. >      <DIV
  28289. CLASS="informalexample"
  28290. ><A
  28291. NAME="AEN5379"
  28292. ></A
  28293. ><P
  28294. ></P
  28295. ><TABLE
  28296. BORDER="0"
  28297. BGCOLOR="#E0E0E0"
  28298. CELLPADDING="5"
  28299. ><TR
  28300. ><TD
  28301. ><PRE
  28302. CLASS="php"
  28303. ><?php
  28304. class test {
  28305. ?>
  28306. <?php
  28307.     function test() {
  28308.         print 'OK';
  28309.     }
  28310. }
  28311. ?></PRE
  28312. ></TD
  28313. ></TR
  28314. ></TABLE
  28315. ><P
  28316. ></P
  28317. ></DIV
  28318. >
  28319.     </P
  28320. ></TD
  28321. ></TR
  28322. ></TABLE
  28323. ></DIV
  28324. ><P
  28325. >     The following cautionary notes are valid for PHP 4.
  28326.    </P
  28327. ><DIV
  28328. CLASS="caution"
  28329. ><P
  28330. ></P
  28331. ><TABLE
  28332. CLASS="caution"
  28333. BORDER="1"
  28334. WIDTH="100%"
  28335. ><TR
  28336. ><TD
  28337. ALIGN="CENTER"
  28338. ><B
  28339. >V²straha</B
  28340. ></TD
  28341. ></TR
  28342. ><TR
  28343. ><TD
  28344. ALIGN="LEFT"
  28345. ><P
  28346. >      The name <TT
  28347. CLASS="literal"
  28348. >stdClass</TT
  28349. > is used interally by
  28350.      Zend and is reserved. You cannot have a class named
  28351.      <TT
  28352. CLASS="literal"
  28353. >stdClass</TT
  28354. > in PHP.
  28355.     </P
  28356. ></TD
  28357. ></TR
  28358. ></TABLE
  28359. ></DIV
  28360. ><DIV
  28361. CLASS="caution"
  28362. ><P
  28363. ></P
  28364. ><TABLE
  28365. CLASS="caution"
  28366. BORDER="1"
  28367. WIDTH="100%"
  28368. ><TR
  28369. ><TD
  28370. ALIGN="CENTER"
  28371. ><B
  28372. >V²straha</B
  28373. ></TD
  28374. ></TR
  28375. ><TR
  28376. ><TD
  28377. ALIGN="LEFT"
  28378. ><P
  28379. >       The function names <TT
  28380. CLASS="literal"
  28381. >__sleep</TT
  28382. > and
  28383.       <TT
  28384. CLASS="literal"
  28385. >__wakeup</TT
  28386. > are magical in PHP classes. You
  28387.       cannot have functions with these names in any of your
  28388.       classes unless you want the magic functionality associated
  28389.       with them. See below for more information.
  28390.     </P
  28391. ></TD
  28392. ></TR
  28393. ></TABLE
  28394. ></DIV
  28395. ><DIV
  28396. CLASS="caution"
  28397. ><P
  28398. ></P
  28399. ><TABLE
  28400. CLASS="caution"
  28401. BORDER="1"
  28402. WIDTH="100%"
  28403. ><TR
  28404. ><TD
  28405. ALIGN="CENTER"
  28406. ><B
  28407. >V²straha</B
  28408. ></TD
  28409. ></TR
  28410. ><TR
  28411. ><TD
  28412. ALIGN="LEFT"
  28413. ><P
  28414. >       PHP reserves all function names starting with __ as magical.
  28415.       It is recommended that you do not use function names with
  28416.       __ in PHP unless you want some documented magic functionality.
  28417.     </P
  28418. ></TD
  28419. ></TR
  28420. ></TABLE
  28421. ></DIV
  28422. ><P
  28423. >     In PHP 4, only constant initializers for <TT
  28424. CLASS="literal"
  28425. >var</TT
  28426. >
  28427.     variables are allowed. To initialize variables with non-constant
  28428.     values, you need an initialization function which is called
  28429.     automatically when an object is being constructed from the
  28430.     class. Such a function is called a constructor (see below).
  28431.    </P
  28432. ><DIV
  28433. CLASS="informalexample"
  28434. ><A
  28435. NAME="AEN5394"
  28436. ></A
  28437. ><P
  28438. ></P
  28439. ><TABLE
  28440. BORDER="0"
  28441. BGCOLOR="#E0E0E0"
  28442. CELLPADDING="5"
  28443. ><TR
  28444. ><TD
  28445. ><PRE
  28446. CLASS="php"
  28447. ><?php
  28448. class Cart
  28449. {
  28450.     /* None of these will work in PHP 4. */
  28451.     var $todays_date = date("Y-m-d");
  28452.     var $name = $firstname;
  28453.     var $owner = 'Fred ' . 'Jones';
  28454.     /* Arrays containing constant values will, though. */
  28455.     var $items = array("VCR", "TV");
  28456. }
  28457.  
  28458. /* This is how it should be done. */
  28459. class Cart
  28460. {
  28461.     var $todays_date;
  28462.     var $name;
  28463.     var $owner;
  28464.     var $items = array("VCR", "TV");
  28465.  
  28466.     function Cart()
  28467.     {
  28468.         $this->todays_date = date("Y-m-d");
  28469.         $this->name = $GLOBALS['firstname'];
  28470.         /* etc. . . */
  28471.     }
  28472. }
  28473. ?></PRE
  28474. ></TD
  28475. ></TR
  28476. ></TABLE
  28477. ><P
  28478. ></P
  28479. ></DIV
  28480. ><P
  28481. >     Classes are types, that is, they are blueprints for actual
  28482.     variables. You have to create a variable of the desired type with
  28483.     the <TT
  28484. CLASS="literal"
  28485. >new</TT
  28486. > operator.
  28487.    </P
  28488. ><DIV
  28489. CLASS="informalexample"
  28490. ><A
  28491. NAME="AEN5398"
  28492. ></A
  28493. ><P
  28494. ></P
  28495. ><TABLE
  28496. BORDER="0"
  28497. BGCOLOR="#E0E0E0"
  28498. CELLPADDING="5"
  28499. ><TR
  28500. ><TD
  28501. ><PRE
  28502. CLASS="php"
  28503. ><?php
  28504. $cart = new Cart;
  28505. $cart->add_item("10", 1);
  28506.  
  28507. $another_cart = new Cart;
  28508. $another_cart->add_item("0815", 3);
  28509. ?></PRE
  28510. ></TD
  28511. ></TR
  28512. ></TABLE
  28513. ><P
  28514. ></P
  28515. ></DIV
  28516. ><P
  28517. >     This creates the objects <TT
  28518. CLASS="varname"
  28519. >$cart</TT
  28520. > and
  28521.     <TT
  28522. CLASS="varname"
  28523. >$another_cart</TT
  28524. >, both of the class Cart. The function
  28525.     add_item() of the <TT
  28526. CLASS="varname"
  28527. >$cart</TT
  28528. > object is being called to add 1
  28529.     item of article number 10 to the <TT
  28530. CLASS="varname"
  28531. >$cart</TT
  28532. >. 3 items of
  28533.     article number 0815 are being added to <TT
  28534. CLASS="varname"
  28535. >$another_cart</TT
  28536. >.
  28537.    </P
  28538. ><P
  28539. >     Both, <TT
  28540. CLASS="varname"
  28541. >$cart</TT
  28542. > and <TT
  28543. CLASS="varname"
  28544. >$another_cart</TT
  28545. >, have
  28546.     functions add_item(), remove_item() and a variable items. These are
  28547.     distinct functions and variables. You can think of the objects as
  28548.     something similar to directories in a filesystem. In a filesystem you can
  28549.     have two different files README.TXT, as long as they are in different
  28550.     directories.  Just like with directories where you'll have to type the
  28551.     full pathname in order to reach each file from the toplevel directory, you
  28552.     have to specify the complete name of the function you want to call: In PHP
  28553.     terms, the toplevel directory would be the global namespace, and the
  28554.     pathname separator would be <TT
  28555. CLASS="literal"
  28556. >-></TT
  28557. >.  Thus, the names
  28558.     <TT
  28559. CLASS="varname"
  28560. >$cart->items</TT
  28561. > and
  28562.     <TT
  28563. CLASS="varname"
  28564. >$another_cart->items</TT
  28565. > name two different variables.
  28566.     Note that the variable is named <TT
  28567. CLASS="varname"
  28568. >$cart->items</TT
  28569. >, not
  28570.     <TT
  28571. CLASS="varname"
  28572. >$cart->$items</TT
  28573. >, that is, a variable name in PHP has
  28574.     only a single dollar sign.
  28575.    </P
  28576. ><DIV
  28577. CLASS="informalexample"
  28578. ><A
  28579. NAME="AEN5414"
  28580. ></A
  28581. ><P
  28582. ></P
  28583. ><TABLE
  28584. BORDER="0"
  28585. BGCOLOR="#E0E0E0"
  28586. CELLPADDING="5"
  28587. ><TR
  28588. ><TD
  28589. ><PRE
  28590. CLASS="php"
  28591. ><?php
  28592. // correct, single $
  28593. $cart->items = array("10" => 1); 
  28594.  
  28595. // invalid, because $cart->$items becomes $cart->""
  28596. $cart->$items = array("10" => 1);
  28597.  
  28598. // correct, but may or may not be what was intended:
  28599. // $cart->$myvar becomes $cart->items
  28600. $myvar = 'items';
  28601. $cart->$myvar = array("10" => 1);  
  28602. ?></PRE
  28603. ></TD
  28604. ></TR
  28605. ></TABLE
  28606. ><P
  28607. ></P
  28608. ></DIV
  28609. ><P
  28610. >     Within a class definition, you do not know under which name the object
  28611.     will be accessible in your program: at the time the Cart class was
  28612.     written, it was unknown that the object will be named
  28613.     <TT
  28614. CLASS="varname"
  28615. >$cart</TT
  28616. > or <TT
  28617. CLASS="varname"
  28618. >$another_cart</TT
  28619. > later. Thus,
  28620.     you cannot write <TT
  28621. CLASS="varname"
  28622. >$cart->items</TT
  28623. > within the Cart class
  28624.     itself. Instead, in order to be able to access it's own functions and
  28625.     variables from within a class, one can use the pseudo-variable
  28626.     <TT
  28627. CLASS="varname"
  28628. >$this</TT
  28629. > which can be read as 'my own' or 'current
  28630.     object'. Thus, '<TT
  28631. CLASS="varname"
  28632. >$this->items[$artnr]</TT
  28633. > +=
  28634.     <TT
  28635. CLASS="varname"
  28636. >$num</TT
  28637. >' can be read as 'add <TT
  28638. CLASS="varname"
  28639. >$num</TT
  28640. > to
  28641.     the <TT
  28642. CLASS="varname"
  28643. >$artnr</TT
  28644. > counter of my own items array' or 'add
  28645.     <TT
  28646. CLASS="varname"
  28647. >$num</TT
  28648. > to the <TT
  28649. CLASS="varname"
  28650. >$artnr</TT
  28651. > counter of the
  28652.     items array within the current object'.
  28653.    </P
  28654. ><DIV
  28655. CLASS="note"
  28656. ><BLOCKQUOTE
  28657. CLASS="note"
  28658. ><P
  28659. ><B
  28660. >Poznßmka: </B
  28661. >
  28662.     There are some nice functions to handle classes and objects. You might want
  28663.     to take a look at the <A
  28664. HREF="#ref.classobj"
  28665. >Class/Object
  28666.     Functions</A
  28667. >
  28668.     </P
  28669. ></BLOCKQUOTE
  28670. ></DIV
  28671. ></DIV
  28672. ><DIV
  28673. CLASS="sect1"
  28674. ><HR><H2
  28675. CLASS="sect1"
  28676. ><A
  28677. NAME="keyword.extends"
  28678. ></A
  28679. ><TT
  28680. CLASS="literal"
  28681. >extends</TT
  28682. ></H2
  28683. ><P
  28684. >     Often you need classes with similar variables and functions
  28685.     to another existing class. In fact, it is good practice to
  28686.     define a generic class which can be used in all your
  28687.     projects and adapt this class for the needs of each of your
  28688.     specific projects. To facilitate this, classes can be
  28689.     extensions of other classes.  The extended or derived class
  28690.     has all variables and functions of the base class (this is
  28691.     called 'inheritance' despite the fact that nobody died) and what
  28692.     you add in the extended definition. It is not possible to
  28693.     substract from a class, that is, to undefine any existing 
  28694.     functions or variables. An extended class is always dependent
  28695.     on a single base class, that is, multiple inheritance is
  28696.     not supported. Classes are extended using the keyword 'extends'.
  28697.    </P
  28698. ><DIV
  28699. CLASS="informalexample"
  28700. ><A
  28701. NAME="AEN5434"
  28702. ></A
  28703. ><P
  28704. ></P
  28705. ><TABLE
  28706. BORDER="0"
  28707. BGCOLOR="#E0E0E0"
  28708. CELLPADDING="5"
  28709. ><TR
  28710. ><TD
  28711. ><PRE
  28712. CLASS="php"
  28713. ><?php
  28714. class Named_Cart extends Cart
  28715. {
  28716.     var $owner;
  28717.   
  28718.     function set_owner ($name)
  28719.     {
  28720.         $this->owner = $name;
  28721.     }
  28722. }
  28723. ?></PRE
  28724. ></TD
  28725. ></TR
  28726. ></TABLE
  28727. ><P
  28728. ></P
  28729. ></DIV
  28730. ><P
  28731. >     This defines a class Named_Cart that has all variables and functions of
  28732.     Cart plus an additional variable <TT
  28733. CLASS="varname"
  28734. >$owner</TT
  28735. > and an
  28736.     additional function set_owner(). You create a named cart the usual way and
  28737.     can now set and get the carts owner. You can still use normal cart
  28738.     functions on named carts:
  28739.    </P
  28740. ><DIV
  28741. CLASS="informalexample"
  28742. ><A
  28743. NAME="AEN5438"
  28744. ></A
  28745. ><P
  28746. ></P
  28747. ><TABLE
  28748. BORDER="0"
  28749. BGCOLOR="#E0E0E0"
  28750. CELLPADDING="5"
  28751. ><TR
  28752. ><TD
  28753. ><PRE
  28754. CLASS="php"
  28755. ><?php
  28756. $ncart = new Named_Cart;    // Create a named cart
  28757. $ncart->set_owner("kris");  // Name that cart
  28758. print $ncart->owner;        // print the cart owners name
  28759. $ncart->add_item("10", 1);  // (inherited functionality from cart)
  28760. ?></PRE
  28761. ></TD
  28762. ></TR
  28763. ></TABLE
  28764. ><P
  28765. ></P
  28766. ></DIV
  28767. ><P
  28768. >     This is also called a "parent-child" relationship. You create a class,
  28769.     parent, and use <TT
  28770. CLASS="literal"
  28771. >extends</TT
  28772. > to create a new class
  28773.     <SPAN
  28774. CLASS="emphasis"
  28775. ><I
  28776. CLASS="emphasis"
  28777. >based</I
  28778. ></SPAN
  28779. > on the parent class: the child class. You can
  28780.     even use this new child class and create another class based on this child
  28781.     class.
  28782.    </P
  28783. ><DIV
  28784. CLASS="note"
  28785. ><BLOCKQUOTE
  28786. CLASS="note"
  28787. ><P
  28788. ><B
  28789. >Poznßmka: </B
  28790. >
  28791.      Classes must be defined before they are used! If you want the class
  28792.      <TT
  28793. CLASS="literal"
  28794. >Named_Cart</TT
  28795. > to extend the class
  28796.      <TT
  28797. CLASS="literal"
  28798. >Cart</TT
  28799. >, you will have to define the class
  28800.      <TT
  28801. CLASS="literal"
  28802. >Cart</TT
  28803. > first. If you want to create another class called
  28804.      <TT
  28805. CLASS="literal"
  28806. >Yellow_named_cart</TT
  28807. > based on the class
  28808.      <TT
  28809. CLASS="literal"
  28810. >Named_Cart</TT
  28811. > you have to define
  28812.      <TT
  28813. CLASS="literal"
  28814. >Named_Cart</TT
  28815. > first. To make it short: the order in which
  28816.      the classes are defined is important.
  28817.     </P
  28818. ></BLOCKQUOTE
  28819. ></DIV
  28820. ></DIV
  28821. ><DIV
  28822. CLASS="sect1"
  28823. ><HR><H2
  28824. CLASS="sect1"
  28825. ><A
  28826. NAME="language.oop.constructor"
  28827. ></A
  28828. ><TT
  28829. CLASS="literal"
  28830. >Constructors</TT
  28831. ></H2
  28832. ><DIV
  28833. CLASS="caution"
  28834. ><P
  28835. ></P
  28836. ><TABLE
  28837. CLASS="caution"
  28838. BORDER="1"
  28839. WIDTH="100%"
  28840. ><TR
  28841. ><TD
  28842. ALIGN="CENTER"
  28843. ><B
  28844. >V²straha</B
  28845. ></TD
  28846. ></TR
  28847. ><TR
  28848. ><TD
  28849. ALIGN="LEFT"
  28850. ><P
  28851. >      In PHP 3 and PHP 4 constructors behave differently. The PHP 4
  28852.      semantics are strongly preferred.
  28853.     </P
  28854. ></TD
  28855. ></TR
  28856. ></TABLE
  28857. ></DIV
  28858. ><P
  28859. >     Constructors are functions in a class that are automatically
  28860.     called when you create a new instance of a class with
  28861.     <TT
  28862. CLASS="literal"
  28863. >new</TT
  28864. >. In PHP 3, a
  28865.     function becomes a constructor when it has the same name as 
  28866.     the class. In PHP 4, a function becomes a constructor, when
  28867.     it has the same name as the class it is defined in - the
  28868.     difference is subtle, but crucial (see below).
  28869.    </P
  28870. ><DIV
  28871. CLASS="informalexample"
  28872. ><A
  28873. NAME="AEN5458"
  28874. ></A
  28875. ><P
  28876. ></P
  28877. ><TABLE
  28878. BORDER="0"
  28879. BGCOLOR="#E0E0E0"
  28880. CELLPADDING="5"
  28881. ><TR
  28882. ><TD
  28883. ><PRE
  28884. CLASS="php"
  28885. ><?php
  28886. // Works in PHP 3 and PHP 4.
  28887. class Auto_Cart extends Cart
  28888. {
  28889.     function Auto_Cart()
  28890.     {
  28891.         $this->add_item ("10", 1);
  28892.     }
  28893. }
  28894. ?></PRE
  28895. ></TD
  28896. ></TR
  28897. ></TABLE
  28898. ><P
  28899. ></P
  28900. ></DIV
  28901. ><P
  28902. >     This defines a class Auto_Cart that is a Cart plus a constructor
  28903.     which initializes the cart with one item of article number "10"
  28904.     each time a new Auto_Cart is being made with "new". Constructors
  28905.     can take arguments and these arguments can be optional, which
  28906.     makes them much more useful. To be able to still use the class
  28907.     without parameters, all parameters to constructors should be
  28908.     made optional by providing default values.
  28909.    </P
  28910. ><DIV
  28911. CLASS="informalexample"
  28912. ><A
  28913. NAME="AEN5461"
  28914. ></A
  28915. ><P
  28916. ></P
  28917. ><TABLE
  28918. BORDER="0"
  28919. BGCOLOR="#E0E0E0"
  28920. CELLPADDING="5"
  28921. ><TR
  28922. ><TD
  28923. ><PRE
  28924. CLASS="php"
  28925. ><?php
  28926. // Works in PHP 3 and PHP 4.
  28927. class Constructor_Cart extends Cart
  28928. {
  28929.     function Constructor_Cart($item = "10", $num = 1)
  28930.     {
  28931.         $this->add_item ($item, $num);
  28932.     }
  28933. }
  28934.  
  28935. // Shop the same old boring stuff.
  28936.  
  28937. $default_cart = new Constructor_Cart;
  28938.  
  28939. // Shop for real...
  28940.  
  28941. $different_cart = new Constructor_Cart("20", 17);
  28942. ?></PRE
  28943. ></TD
  28944. ></TR
  28945. ></TABLE
  28946. ><P
  28947. ></P
  28948. ></DIV
  28949. ><P
  28950. >     You also can use the <TT
  28951. CLASS="literal"
  28952. >@</TT
  28953. > operator to
  28954.     <SPAN
  28955. CLASS="emphasis"
  28956. ><I
  28957. CLASS="emphasis"
  28958. >mute</I
  28959. ></SPAN
  28960. > errors occurring in the constructor, e.g.
  28961.     <TT
  28962. CLASS="literal"
  28963. >@new</TT
  28964. >.
  28965.    </P
  28966. ><DIV
  28967. CLASS="caution"
  28968. ><P
  28969. ></P
  28970. ><TABLE
  28971. CLASS="caution"
  28972. BORDER="1"
  28973. WIDTH="100%"
  28974. ><TR
  28975. ><TD
  28976. ALIGN="CENTER"
  28977. ><B
  28978. >V²straha</B
  28979. ></TD
  28980. ></TR
  28981. ><TR
  28982. ><TD
  28983. ALIGN="LEFT"
  28984. ><P
  28985. >      In PHP 3, derived classes and constructors have a number of
  28986.      limitations. The following examples should be read carefully
  28987.      to understand these limitations.
  28988.     </P
  28989. ></TD
  28990. ></TR
  28991. ></TABLE
  28992. ></DIV
  28993. ><DIV
  28994. CLASS="informalexample"
  28995. ><A
  28996. NAME="AEN5469"
  28997. ></A
  28998. ><P
  28999. ></P
  29000. ><TABLE
  29001. BORDER="0"
  29002. BGCOLOR="#E0E0E0"
  29003. CELLPADDING="5"
  29004. ><TR
  29005. ><TD
  29006. ><PRE
  29007. CLASS="php"
  29008. ><?php
  29009. class A
  29010. {
  29011.     function A()
  29012.     {
  29013.       echo "I am the constructor of A.<br>\n";
  29014.     }
  29015. }
  29016.  
  29017. class B extends A
  29018. {
  29019.     function C()
  29020.     {
  29021.         echo "I am a regular function.<br>\n";
  29022.     }
  29023. }
  29024.  
  29025. // no constructor is being called in PHP 3.
  29026. $b = new B;
  29027. ?></PRE
  29028. ></TD
  29029. ></TR
  29030. ></TABLE
  29031. ><P
  29032. ></P
  29033. ></DIV
  29034. ><P
  29035. >     In PHP 3, no constructor is being called in the above example.
  29036.     The rule in PHP 3 is: 'A constructor is a function of the same
  29037.     name as the class.'. The name of the class is B, and there is
  29038.     no function called B() in class B. Nothing happens.
  29039.    </P
  29040. ><P
  29041. >     This is fixed in PHP 4 by introducing another rule: If a class
  29042.     has no constructor, the constructor of the base class is being
  29043.     called, if it exists. The above example would have printed
  29044.     'I am the constructor of A.<br>' in PHP 4.
  29045.    </P
  29046. ><DIV
  29047. CLASS="informalexample"
  29048. ><A
  29049. NAME="AEN5473"
  29050. ></A
  29051. ><P
  29052. ></P
  29053. ><TABLE
  29054. BORDER="0"
  29055. BGCOLOR="#E0E0E0"
  29056. CELLPADDING="5"
  29057. ><TR
  29058. ><TD
  29059. ><PRE
  29060. CLASS="php"
  29061. ><?php
  29062. class A
  29063. {
  29064.     function A()
  29065.     {
  29066.         echo "I am the constructor of A.<br>\n";
  29067.     }
  29068.  
  29069.     function B()
  29070.     {
  29071.         echo "I am a regular function named B in class A.<br>\n";
  29072.         echo "I am not a constructor in A.<br>\n";
  29073.     }
  29074. }
  29075.  
  29076. class B extends A
  29077. {
  29078.     function C()
  29079.     {
  29080.         echo "I am a regular function.<br>\n";
  29081.     }
  29082. }
  29083.  
  29084. // This will call B() as a constructor.
  29085. $b = new B;
  29086. ?></PRE
  29087. ></TD
  29088. ></TR
  29089. ></TABLE
  29090. ><P
  29091. ></P
  29092. ></DIV
  29093. ><P
  29094. >     In PHP 3, the function B() in class A will suddenly become a
  29095.     constructor in class B, although it was never intended to be.
  29096.     The rule in PHP 3 is: 'A constructor is a function of the same
  29097.     name as the class.'. PHP 3 does not care if the function is
  29098.     being defined in class B, or if it has been inherited.
  29099.    </P
  29100. ><P
  29101. >     This is fixed in PHP 4 by modifying the rule to: 'A constructor
  29102.     is a function of the same name as the class it is being defined
  29103.     in.'. Thus in PHP 4, the class B would have no constructor function
  29104.     of its own and the constructor of the base class would have been
  29105.     called, printing 'I am the constructor of A.<br>'.
  29106.    </P
  29107. ><DIV
  29108. CLASS="caution"
  29109. ><P
  29110. ></P
  29111. ><TABLE
  29112. CLASS="caution"
  29113. BORDER="1"
  29114. WIDTH="100%"
  29115. ><TR
  29116. ><TD
  29117. ALIGN="CENTER"
  29118. ><B
  29119. >V²straha</B
  29120. ></TD
  29121. ></TR
  29122. ><TR
  29123. ><TD
  29124. ALIGN="LEFT"
  29125. ><P
  29126. >      Neither PHP 3 nor PHP 4 call constructors of the base class 
  29127.      automatically from a constructor of a derived class. It is
  29128.      your responsibility to propagate the call to constructors
  29129.      upstream where appropriate.
  29130.     </P
  29131. ></TD
  29132. ></TR
  29133. ></TABLE
  29134. ></DIV
  29135. ><DIV
  29136. CLASS="note"
  29137. ><BLOCKQUOTE
  29138. CLASS="note"
  29139. ><P
  29140. ><B
  29141. >Poznßmka: </B
  29142. >
  29143.      There are no destructors in PHP 3 or PHP 4. You may use
  29144.      <A
  29145. HREF="#function.register-shutdown-function"
  29146. ><B
  29147. CLASS="function"
  29148. >register_shutdown_function()</B
  29149. ></A
  29150. > instead
  29151.      to simulate most effects of destructors.
  29152.     </P
  29153. ></BLOCKQUOTE
  29154. ></DIV
  29155. ><P
  29156. >     Destructors are functions that are called automatically
  29157.     when an object is destroyed, either with <A
  29158. HREF="#function.unset"
  29159. ><B
  29160. CLASS="function"
  29161. >unset()</B
  29162. ></A
  29163. >
  29164.     or by simply going out of scope. There are no destructors
  29165.     in PHP.
  29166.    </P
  29167. ></DIV
  29168. ><DIV
  29169. CLASS="sect1"
  29170. ><HR><H2
  29171. CLASS="sect1"
  29172. ><A
  29173. NAME="keyword.paamayim-nekudotayim"
  29174. ></A
  29175. ><TT
  29176. CLASS="literal"
  29177. >::</TT
  29178. ></H2
  29179. ><DIV
  29180. CLASS="caution"
  29181. ><P
  29182. ></P
  29183. ><TABLE
  29184. CLASS="caution"
  29185. BORDER="1"
  29186. WIDTH="100%"
  29187. ><TR
  29188. ><TD
  29189. ALIGN="CENTER"
  29190. ><B
  29191. >V²straha</B
  29192. ></TD
  29193. ></TR
  29194. ><TR
  29195. ><TD
  29196. ALIGN="LEFT"
  29197. ><P
  29198. >      The following is valid for PHP 4 and later only.
  29199.     </P
  29200. ></TD
  29201. ></TR
  29202. ></TABLE
  29203. ></DIV
  29204. ><P
  29205. >     Sometimes it is useful to refer to functions and variables
  29206.     in base classes or to refer to functions in classes that
  29207.     have not yet any instances. The :: operator is being used
  29208.     for this.
  29209.    </P
  29210. ><DIV
  29211. CLASS="informalexample"
  29212. ><A
  29213. NAME="AEN5490"
  29214. ></A
  29215. ><P
  29216. ></P
  29217. ><TABLE
  29218. BORDER="0"
  29219. BGCOLOR="#E0E0E0"
  29220. CELLPADDING="5"
  29221. ><TR
  29222. ><TD
  29223. ><PRE
  29224. CLASS="php"
  29225. ><?php
  29226. class A
  29227. {
  29228.     function example()
  29229.     {
  29230.         echo "I am the original function A::example().<br>\n";
  29231.     }
  29232. }
  29233.  
  29234. class B extends A
  29235. {
  29236.     function example()
  29237.     {
  29238.         echo "I am the redefined function B::example().<br>\n";
  29239.         A::example();
  29240.     }
  29241. }
  29242.  
  29243. // there is no object of class A.
  29244. // this will print
  29245. //   I am the original function A::example().<br>
  29246. A::example();
  29247.  
  29248. // create an object of class B.
  29249. $b = new B;
  29250.  
  29251. // this will print 
  29252. //   I am the redefined function B::example().<br>
  29253. //   I am the original function A::example().<br>
  29254. $b->example();
  29255. ?></PRE
  29256. ></TD
  29257. ></TR
  29258. ></TABLE
  29259. ><P
  29260. ></P
  29261. ></DIV
  29262. ><P
  29263. >     The above example calls the function example() in
  29264.     class A, but there is no object of class A, so that
  29265.     we cannot write $a->example() or similar. Instead we
  29266.     call example() as a 'class function', that is, as a
  29267.     function of the class itself, not any object of that
  29268.     class.
  29269.    </P
  29270. ><P
  29271. >     There are class functions, but there are no class variables.
  29272.     In fact, there is no object at all at the time of the call.
  29273.     Thus, a class function may not use any object variables (but
  29274.     it can use local and global variables), and it may no use
  29275.     <TT
  29276. CLASS="varname"
  29277. >$this</TT
  29278. > at all.
  29279.    </P
  29280. ><P
  29281. >     In the above example, class B redefines the function example(). 
  29282.     The original definition in class A is shadowed
  29283.     and no longer available, unless you are referring specifically
  29284.     to the implementation of example() in class A using the 
  29285.     ::-operator. Write A::example() to do this (in fact, you
  29286.     should be writing parent::example(), as shown in the next
  29287.     section).
  29288.    </P
  29289. ><P
  29290. >     In this context, there is a current object and it may have object
  29291.     variables. Thus, when used from WITHIN an object function, you may use
  29292.     <TT
  29293. CLASS="varname"
  29294. >$this</TT
  29295. > and object variables.
  29296.    </P
  29297. ></DIV
  29298. ><DIV
  29299. CLASS="sect1"
  29300. ><HR><H2
  29301. CLASS="sect1"
  29302. ><A
  29303. NAME="keyword.parent"
  29304. ></A
  29305. ><TT
  29306. CLASS="literal"
  29307. >parent</TT
  29308. ></H2
  29309. ><P
  29310. >    You may find yourself writing code that refers to
  29311.    variables and functions in base classes. This is
  29312.    particularly true if your derived class is a refinement
  29313.    or specialisation of code in your base class. 
  29314.   </P
  29315. ><P
  29316. >    Instead of using the literal name of the base class in your
  29317.    code, you should be using the special name
  29318.    <TT
  29319. CLASS="literal"
  29320. >parent</TT
  29321. >, which refers to the name of your
  29322.    base class as given in the <TT
  29323. CLASS="literal"
  29324. >extends</TT
  29325. >
  29326.    declaration of your class. By doing this, you avoid using the
  29327.    name of your base class in more than one place. Should
  29328.    your inheritance tree change during implementation, the
  29329.    change is easily made by simply changing the 
  29330.    <TT
  29331. CLASS="literal"
  29332. >extends</TT
  29333. > declaration of your class.
  29334.   </P
  29335. ><DIV
  29336. CLASS="informalexample"
  29337. ><A
  29338. NAME="AEN5506"
  29339. ></A
  29340. ><P
  29341. ></P
  29342. ><TABLE
  29343. BORDER="0"
  29344. BGCOLOR="#E0E0E0"
  29345. CELLPADDING="5"
  29346. ><TR
  29347. ><TD
  29348. ><PRE
  29349. CLASS="php"
  29350. ><?php
  29351. class A
  29352. {
  29353.     function example()
  29354.     {
  29355.         echo "I am A::example() and provide basic functionality.<br>\n";
  29356.     }
  29357. }
  29358.  
  29359. class B extends A
  29360. {
  29361.     function example()
  29362.     {
  29363.         echo "I am B::example() and provide additional functionality.<br>\n";
  29364.         parent::example();
  29365.     }
  29366. }
  29367.  
  29368. $b = new B;
  29369.  
  29370. // This will call B::example(), which will in turn call A::example().
  29371. $b->example();
  29372. ?></PRE
  29373. ></TD
  29374. ></TR
  29375. ></TABLE
  29376. ><P
  29377. ></P
  29378. ></DIV
  29379. ></DIV
  29380. ><DIV
  29381. CLASS="sect1"
  29382. ><HR><H2
  29383. CLASS="sect1"
  29384. ><A
  29385. NAME="language.oop.serialization"
  29386. ></A
  29387. >Serializing objects - objects in sessions</H2
  29388. ><DIV
  29389. CLASS="note"
  29390. ><BLOCKQUOTE
  29391. CLASS="note"
  29392. ><P
  29393. ><B
  29394. >Poznßmka: </B
  29395. >
  29396.     In PHP 3, objects will lose their class association
  29397.     throughout the process of serialization and unserialization. 
  29398.     The resulting variable is of type object, but has no class
  29399.     and no methods, thus it is pretty useless (it has become
  29400.     just like an array with a funny syntax).
  29401.    </P
  29402. ></BLOCKQUOTE
  29403. ></DIV
  29404. ><DIV
  29405. CLASS="caution"
  29406. ><P
  29407. ></P
  29408. ><TABLE
  29409. CLASS="caution"
  29410. BORDER="1"
  29411. WIDTH="100%"
  29412. ><TR
  29413. ><TD
  29414. ALIGN="CENTER"
  29415. ><B
  29416. >V²straha</B
  29417. ></TD
  29418. ></TR
  29419. ><TR
  29420. ><TD
  29421. ALIGN="LEFT"
  29422. ><P
  29423. >     The following information is valid for PHP 4 only. 
  29424.    </P
  29425. ></TD
  29426. ></TR
  29427. ></TABLE
  29428. ></DIV
  29429. ><P
  29430. >    <A
  29431. HREF="#function.serialize"
  29432. ><B
  29433. CLASS="function"
  29434. >serialize()</B
  29435. ></A
  29436. > returns a string containing a
  29437.    byte-stream representation of any value that can be stored in
  29438.    PHP. <A
  29439. HREF="#function.unserialize"
  29440. ><B
  29441. CLASS="function"
  29442. >unserialize()</B
  29443. ></A
  29444. > can use this string to
  29445.    recreate the original variable values. Using serialize to
  29446.    save an object will save all variables in an object.  The
  29447.    functions in an object will not be saved, only the name of
  29448.    the class.
  29449.   </P
  29450. ><P
  29451. >    In order to be able to <A
  29452. HREF="#function.unserialize"
  29453. ><B
  29454. CLASS="function"
  29455. >unserialize()</B
  29456. ></A
  29457. > an object, the
  29458.    class of that object needs to be defined. That is, if you have an object
  29459.    <TT
  29460. CLASS="varname"
  29461. >$a</TT
  29462. > of class A on page1.php and serialize this, you'll
  29463.    get a string that refers to class A and contains all values of variabled
  29464.    contained in <TT
  29465. CLASS="varname"
  29466. >$a</TT
  29467. >. If you want to be able to unserialize
  29468.    this on page2.php, recreating <TT
  29469. CLASS="varname"
  29470. >$a</TT
  29471. > of class A, the
  29472.    definition of class A must be present in page2.php. This can be done for
  29473.    example by storing the class definition of class A in an include file and
  29474.    including this file in both page1.php and page2.php.
  29475.   </P
  29476. ><DIV
  29477. CLASS="informalexample"
  29478. ><A
  29479. NAME="AEN5522"
  29480. ></A
  29481. ><P
  29482. ></P
  29483. ><TABLE
  29484. BORDER="0"
  29485. BGCOLOR="#E0E0E0"
  29486. CELLPADDING="5"
  29487. ><TR
  29488. ><TD
  29489. ><PRE
  29490. CLASS="php"
  29491. ><?php
  29492. // classa.inc:
  29493.   
  29494.   class A 
  29495.   {
  29496.       var $one = 1;
  29497.     
  29498.       function show_one()
  29499.       {
  29500.           echo $this->one;
  29501.       }
  29502.   }
  29503.   
  29504. // page1.php:
  29505.  
  29506.   include("classa.inc");
  29507.   
  29508.   $a = new A;
  29509.   $s = serialize($a);
  29510.   // store $s somewhere where page2.php can find it.
  29511.   $fp = fopen("store", "w");
  29512.   fputs($fp, $s);
  29513.   fclose($fp);
  29514.  
  29515. // page2.php:
  29516.   
  29517.   // this is needed for the unserialize to work properly.
  29518.   include("classa.inc");
  29519.  
  29520.   $s = implode("", @file("store"));
  29521.   $a = unserialize($s);
  29522.  
  29523.   // now use the function show_one() of the $a object.  
  29524.   $a->show_one();
  29525. ?></PRE
  29526. ></TD
  29527. ></TR
  29528. ></TABLE
  29529. ><P
  29530. ></P
  29531. ></DIV
  29532. ><P
  29533. >    If you are using sessions and use <A
  29534. HREF="#function.session-register"
  29535. ><B
  29536. CLASS="function"
  29537. >session_register()</B
  29538. ></A
  29539. >
  29540.    to register objects, these objects are serialized automatically
  29541.    at the end of each PHP page, and are unserialized automatically on
  29542.    each of the following pages. This basically means that these objects
  29543.    can show up on any of your pages once they become part of your
  29544.    session.
  29545.   </P
  29546. ><P
  29547. >    It is strongly recommended that you include the class
  29548.    definitions of all such registered objects on all of your
  29549.    pages, even if you do not actually use these classes on all
  29550.    of your pages. If you don't and an object is being
  29551.    unserialized without its class definition being present, it
  29552.    will lose its class association and become an object of class
  29553.    <TT
  29554. CLASS="literal"
  29555. >stdClass</TT
  29556. > without any functions available
  29557.    at all, that is, it will become quite useless.
  29558.   </P
  29559. ><P
  29560. >    So if in the example above <TT
  29561. CLASS="varname"
  29562. >$a</TT
  29563. > became part of a session
  29564.    by running <TT
  29565. CLASS="literal"
  29566. >session_register("a")</TT
  29567. >, you should include the
  29568.    file <TT
  29569. CLASS="literal"
  29570. >classa.inc</TT
  29571. > on all of your pages, not only page1.php
  29572.    and page2.php.
  29573.   </P
  29574. ></DIV
  29575. ><DIV
  29576. CLASS="sect1"
  29577. ><HR><H2
  29578. CLASS="sect1"
  29579. ><A
  29580. NAME="language.oop.magic-functions"
  29581. ></A
  29582. >The magic functions <TT
  29583. CLASS="literal"
  29584. >__sleep</TT
  29585. > and <TT
  29586. CLASS="literal"
  29587. >__wakeup</TT
  29588. ></H2
  29589. ><P
  29590. >    <A
  29591. HREF="#function.serialize"
  29592. ><B
  29593. CLASS="function"
  29594. >serialize()</B
  29595. ></A
  29596. > checks if your class has a function with
  29597.    the magic name <TT
  29598. CLASS="literal"
  29599. >__sleep</TT
  29600. >. If so, that function is
  29601.    being run prior to any serialization. It can clean up the object
  29602.    and is supposed to return an array with the names of all variables
  29603.    of that object that should be serialized.
  29604.   </P
  29605. ><P
  29606. >    The intended use of <TT
  29607. CLASS="literal"
  29608. >__sleep</TT
  29609. > is to close any
  29610.    database connections that object may have, committing pending
  29611.    data or perform similar cleanup tasks. Also, the function is
  29612.    useful if you have very large objects which need not be
  29613.    saved completely.
  29614.   </P
  29615. ><P
  29616. >    Conversely, <A
  29617. HREF="#function.unserialize"
  29618. ><B
  29619. CLASS="function"
  29620. >unserialize()</B
  29621. ></A
  29622. > checks for the
  29623.    presence of a function with the magic name 
  29624.    <TT
  29625. CLASS="literal"
  29626. >__wakeup</TT
  29627. >. If present, this function can
  29628.    reconstruct any resources that object may have.
  29629.   </P
  29630. ><P
  29631. >     The intended use of <TT
  29632. CLASS="literal"
  29633. >__wakeup</TT
  29634. > is to
  29635.     reestablish any database connections that may have been lost
  29636.     during serialization and perform other reinitialization
  29637.     tasks.
  29638.   </P
  29639. ></DIV
  29640. ><DIV
  29641. CLASS="sect1"
  29642. ><HR><H2
  29643. CLASS="sect1"
  29644. ><A
  29645. NAME="language.oop.newref"
  29646. ></A
  29647. >References inside the constructor</H2
  29648. ><P
  29649. >     Creating references within the constructor can lead to confusing
  29650.     results. This tutorial-like section helps you to avoid problems.
  29651.  
  29652.     <DIV
  29653. CLASS="informalexample"
  29654. ><A
  29655. NAME="AEN5549"
  29656. ></A
  29657. ><P
  29658. ></P
  29659. ><TABLE
  29660. BORDER="0"
  29661. BGCOLOR="#E0E0E0"
  29662. CELLPADDING="5"
  29663. ><TR
  29664. ><TD
  29665. ><PRE
  29666. CLASS="php"
  29667. ><?php
  29668. class Foo
  29669. {
  29670.     function Foo($name)
  29671.     {
  29672.         // create a reference inside the global array $globalref
  29673.         global $globalref;
  29674.         $globalref[] = &$this;
  29675.         // set name to passed value
  29676.         $this->setName($name);
  29677.         // and put it out
  29678.         $this->echoName();
  29679.     }
  29680.  
  29681.     function echoName()
  29682.     {
  29683.         echo "<br>",$this->name;
  29684.     }
  29685.  
  29686.     function setName($name)
  29687.     {
  29688.         $this->name = $name;
  29689.     }
  29690. }
  29691. ?></PRE
  29692. ></TD
  29693. ></TR
  29694. ></TABLE
  29695. ><P
  29696. ></P
  29697. ></DIV
  29698. >
  29699.   </P
  29700. ><P
  29701. >     Let us check out if there is a difference between
  29702.     <TT
  29703. CLASS="varname"
  29704. >$bar1</TT
  29705. > which has been created using
  29706.     the copy <TT
  29707. CLASS="literal"
  29708. >=</TT
  29709. > operator and
  29710.     <TT
  29711. CLASS="varname"
  29712. >$bar2</TT
  29713. > which has been created using
  29714.     the reference <TT
  29715. CLASS="literal"
  29716. >=&</TT
  29717. > operator...
  29718.  
  29719.     <DIV
  29720. CLASS="informalexample"
  29721. ><A
  29722. NAME="AEN5556"
  29723. ></A
  29724. ><P
  29725. ></P
  29726. ><TABLE
  29727. BORDER="0"
  29728. BGCOLOR="#E0E0E0"
  29729. CELLPADDING="5"
  29730. ><TR
  29731. ><TD
  29732. ><PRE
  29733. CLASS="php"
  29734. ><?php
  29735. $bar1 = new Foo('set in constructor');
  29736. $bar1->echoName();
  29737. $globalref[0]->echoName();
  29738.  
  29739. /* output:
  29740. set in constructor
  29741. set in constructor
  29742. set in constructor */
  29743.  
  29744. $bar2 =& new Foo('set in constructor');
  29745. $bar2->echoName();
  29746. $globalref[1]->echoName();
  29747.  
  29748. /* output:
  29749. set in constructor
  29750. set in constructor
  29751. set in constructor */
  29752. ?></PRE
  29753. ></TD
  29754. ></TR
  29755. ></TABLE
  29756. ><P
  29757. ></P
  29758. ></DIV
  29759. >
  29760.    </P
  29761. ><P
  29762. >     Apparently there is no difference, but in fact there is a
  29763.     very significant one: <TT
  29764. CLASS="varname"
  29765. >$bar1</TT
  29766. > and
  29767.     <TT
  29768. CLASS="varname"
  29769. >$globalref[0]</TT
  29770. > are _NOT_ referenced, they
  29771.     are NOT the same variable. This is because "new" does not
  29772.     return a reference by default, instead it returns a copy.
  29773.     <DIV
  29774. CLASS="note"
  29775. ><BLOCKQUOTE
  29776. CLASS="note"
  29777. ><P
  29778. ><B
  29779. >Poznßmka: </B
  29780. >
  29781.       There is no performance loss (since PHP 4 and up use reference
  29782.       counting) returning copies instead of references. On the
  29783.       contrary it is most often better to simply work with copies
  29784.       instead of references, because creating references takes some
  29785.       time where creating copies virtually takes no time (unless none
  29786.       of them is a large array or object and one of them gets changed
  29787.       and the other(s) one(s) subsequently, then it would be wise to
  29788.       use references to change them all concurrently).
  29789.      </P
  29790. ></BLOCKQUOTE
  29791. ></DIV
  29792. >
  29793.     To prove what is written above let us watch the code below.
  29794.  
  29795.     <DIV
  29796. CLASS="informalexample"
  29797. ><A
  29798. NAME="AEN5563"
  29799. ></A
  29800. ><P
  29801. ></P
  29802. ><TABLE
  29803. BORDER="0"
  29804. BGCOLOR="#E0E0E0"
  29805. CELLPADDING="5"
  29806. ><TR
  29807. ><TD
  29808. ><PRE
  29809. CLASS="php"
  29810. ><?php
  29811. // now we will change the name. what do you expect?
  29812. // you could expect that both $bar1 and $globalref[0] change their names...
  29813. $bar1->setName('set from outside');
  29814.  
  29815. // as mentioned before this is not the case.
  29816. $bar1->echoName();
  29817. $globalref[0]->echoName();
  29818.  
  29819. /* output:
  29820. set from outside
  29821. set in constructor */
  29822.  
  29823. // let us see what is different with $bar2 and $globalref[1]
  29824. $bar2->setName('set from outside');
  29825.  
  29826. // luckily they are not only equal, they are the same variable
  29827. // thus $bar2->name and $globalref[1]->name are the same too
  29828. $bar2->echoName();
  29829. $globalref[1]->echoName();
  29830.  
  29831. /* output:
  29832. set from outside
  29833. set from outside */
  29834. ?></PRE
  29835. ></TD
  29836. ></TR
  29837. ></TABLE
  29838. ><P
  29839. ></P
  29840. ></DIV
  29841. >   
  29842.    </P
  29843. ><P
  29844. >    Another final example, try to understand it.
  29845.    
  29846.     <DIV
  29847. CLASS="informalexample"
  29848. ><A
  29849. NAME="AEN5566"
  29850. ></A
  29851. ><P
  29852. ></P
  29853. ><TABLE
  29854. BORDER="0"
  29855. BGCOLOR="#E0E0E0"
  29856. CELLPADDING="5"
  29857. ><TR
  29858. ><TD
  29859. ><PRE
  29860. CLASS="php"
  29861. ><?php
  29862. class A
  29863. {
  29864.     function A($i)
  29865.     {
  29866.         $this->value = $i;
  29867.         // try to figure out why we do not need a reference here
  29868.         $this->b = new B($this);
  29869.     }
  29870.  
  29871.     function createRef()
  29872.     {
  29873.         $this->c = new B($this);
  29874.     }
  29875.  
  29876.     function echoValue()
  29877.     {
  29878.         echo "<br>","class ",get_class($this),': ',$this->value;
  29879.     }
  29880. }
  29881.  
  29882.  
  29883. class B
  29884. {
  29885.     function B(&$a)
  29886.     {
  29887.         $this->a = &$a;
  29888.     }
  29889.  
  29890.     function echoValue()
  29891.     {
  29892.         echo "<br>","class ",get_class($this),': ',$this->a->value;
  29893.     }
  29894. }
  29895.  
  29896. // try to understand why using a simple copy here would yield
  29897. // in an undesired result in the *-marked line
  29898. $a =& new A(10);
  29899. $a->createRef();
  29900.  
  29901. $a->echoValue();
  29902. $a->b->echoValue();
  29903. $a->c->echoValue();
  29904.  
  29905. $a->value = 11;
  29906.  
  29907. $a->echoValue();
  29908. $a->b->echoValue(); // *
  29909. $a->c->echoValue();
  29910.  
  29911. /*
  29912. output:
  29913. class A: 10
  29914. class B: 10
  29915. class B: 10
  29916. class A: 11
  29917. class B: 11
  29918. class B: 11
  29919. */
  29920. ?></PRE
  29921. ></TD
  29922. ></TR
  29923. ></TABLE
  29924. ><P
  29925. ></P
  29926. ></DIV
  29927. >
  29928.    </P
  29929. ></DIV
  29930. ><DIV
  29931. CLASS="sect1"
  29932. ><HR><H2
  29933. CLASS="sect1"
  29934. ><A
  29935. NAME="language.oop.object-comparison-php4"
  29936. ></A
  29937. >Comparing objects in PHP 4</H2
  29938. ><P
  29939. >    In PHP 4, objects are compared in a very simple manner, namely: Two object
  29940.    instances are equal if they have the same attributes and values, and are
  29941.    instances of the same class. Similar rules are applied when comparing two
  29942.    objects using the identity operator (<TT
  29943. CLASS="literal"
  29944. >===</TT
  29945. >).
  29946.   </P
  29947. ><P
  29948. >    If we were to execute the code in the example below:
  29949.    <TABLE
  29950. WIDTH="100%"
  29951. BORDER="0"
  29952. CELLPADDING="0"
  29953. CELLSPACING="0"
  29954. CLASS="EXAMPLE"
  29955. ><TR
  29956. ><TD
  29957. ><DIV
  29958. CLASS="example"
  29959. ><A
  29960. NAME="AEN5573"
  29961. ></A
  29962. ><P
  29963. ><B
  29964. >P°φklad 13-1. Example of object comparison in PHP 4</B
  29965. ></P
  29966. ><TABLE
  29967. BORDER="0"
  29968. BGCOLOR="#E0E0E0"
  29969. CELLPADDING="5"
  29970. ><TR
  29971. ><TD
  29972. ><PRE
  29973. CLASS="php"
  29974. ><?php
  29975. function bool2str($bool) {
  29976.     if ($bool === false) {
  29977.             return 'FALSE';
  29978.     } else {
  29979.             return 'TRUE';
  29980.     }
  29981. }
  29982.  
  29983. function compareObjects(&$o1, &$o2) {
  29984.     echo 'o1 == o2 : '.bool2str($o1 == $o2)."\n";
  29985.     echo 'o1 != o2 : '.bool2str($o1 != $o2)."\n";
  29986.     echo 'o1 === o2 : '.bool2str($o1 === $o2)."\n";
  29987.     echo 'o1 !== o2 : '.bool2str($o1 !== $o2)."\n";
  29988. }
  29989.  
  29990. class Flag {
  29991.     var $flag;
  29992.  
  29993.     function Flag($flag=true) {
  29994.             $this->flag = $flag;
  29995.     }
  29996. }
  29997.  
  29998. class SwitchableFlag extends Flag {
  29999.  
  30000.     function turnOn() {
  30001.         $this->flag = true;
  30002.     }
  30003.  
  30004.     function turnOff() {
  30005.         $this->flag = false;
  30006.     }
  30007. }
  30008.  
  30009. $o = new Flag();
  30010. $p = new Flag(false);
  30011. $q = new Flag();
  30012.  
  30013. $r = new SwitchableFlag();
  30014.  
  30015. echo "Compare instances created with the same parameters\n";
  30016. compareObjects($o, $q);
  30017.  
  30018. echo "\nCompare instances created with different parameters\n";
  30019. compareObjects($o, $p);
  30020.  
  30021. echo "\nCompare an instance of a parent class with one from a subclass\n";
  30022. compareObjects($o, $r);
  30023. ?></PRE
  30024. ></TD
  30025. ></TR
  30026. ></TABLE
  30027. ></DIV
  30028. ></TD
  30029. ></TR
  30030. ></TABLE
  30031. >
  30032.    We will see:
  30033.    <TABLE
  30034. BORDER="0"
  30035. BGCOLOR="#E0E0E0"
  30036. CELLPADDING="5"
  30037. ><TR
  30038. ><TD
  30039. ><PRE
  30040. CLASS="screen"
  30041. >Compare instances created with the same parameters
  30042. o1 == o2 : TRUE
  30043. o1 != o2 : FALSE
  30044. o1 === o2 : TRUE
  30045. o1 !== o2 : FALSE
  30046.  
  30047. Compare instances created with different parameters
  30048. o1 == o2 : FALSE
  30049. o1 != o2 : TRUE
  30050. o1 === o2 : FALSE
  30051. o1 !== o2 : TRUE
  30052.  
  30053. Compare an instance of a parent class with one from a subclass
  30054. o1 == o2 : FALSE
  30055. o1 != o2 : TRUE
  30056. o1 === o2 : FALSE
  30057. o1 !== o2 : TRUE</PRE
  30058. ></TD
  30059. ></TR
  30060. ></TABLE
  30061. >
  30062.    Which is the output we will expect to obtain given the comparison rules
  30063.    above. Only instances with the same values for their attributes and from the same
  30064.    class are considered equal and identical.
  30065.   </P
  30066. ><P
  30067. >    Even in the cases where we have object composition, the same comparison
  30068.    rules apply. In the example below we create a container class that stores
  30069.    an associative array of <B
  30070. CLASS="classname"
  30071. >Flag</B
  30072. > objects.
  30073.    <TABLE
  30074. WIDTH="100%"
  30075. BORDER="0"
  30076. CELLPADDING="0"
  30077. CELLSPACING="0"
  30078. CLASS="EXAMPLE"
  30079. ><TR
  30080. ><TD
  30081. ><DIV
  30082. CLASS="example"
  30083. ><A
  30084. NAME="AEN5579"
  30085. ></A
  30086. ><P
  30087. ><B
  30088. >P°φklad 13-2. Compound object comparisons in PHP 4</B
  30089. ></P
  30090. ><TABLE
  30091. BORDER="0"
  30092. BGCOLOR="#E0E0E0"
  30093. CELLPADDING="5"
  30094. ><TR
  30095. ><TD
  30096. ><PRE
  30097. CLASS="php"
  30098. ><?php
  30099. class FlagSet {
  30100.     var $set;
  30101.  
  30102.     function FlagSet($flagArr = array()) {
  30103.         $this->set = $flagArr;
  30104.     }
  30105.  
  30106.     function addFlag($name, $flag) {
  30107.         $this->set[$name] = $flag;
  30108.     }
  30109.  
  30110.     function removeFlag($name) {
  30111.         if (array_key_exists($name, $this->set)) {
  30112.             unset($this->set[$name]);
  30113.         }
  30114.     }
  30115. }
  30116.  
  30117.  
  30118. $u = new FlagSet();
  30119. $u->addFlag('flag1', $o);
  30120. $u->addFlag('flag2', $p);
  30121. $v = new FlagSet(array('flag1'=>$q, 'flag2'=>$p));
  30122. $w = new FlagSet(array('flag1'=>$q));
  30123.  
  30124. echo "\nComposite objects u(o,p) and v(q,p)\n";
  30125. compareObjects($u, $v);
  30126.  
  30127. echo "\nu(o,p) and w(q)\n";
  30128. compareObjects($u, $w);
  30129. ?></PRE
  30130. ></TD
  30131. ></TR
  30132. ></TABLE
  30133. ></DIV
  30134. ></TD
  30135. ></TR
  30136. ></TABLE
  30137. >
  30138.    Which gives the expected output:
  30139.    <TABLE
  30140. BORDER="0"
  30141. BGCOLOR="#E0E0E0"
  30142. CELLPADDING="5"
  30143. ><TR
  30144. ><TD
  30145. ><PRE
  30146. CLASS="screen"
  30147. >Composite objects u(o,p) and v(q,p)
  30148. o1 == o2 : TRUE
  30149. o1 != o2 : FALSE
  30150. o1 === o2 : TRUE
  30151. o1 !== o2 : FALSE
  30152.  
  30153. u(o,p) and w(q)
  30154. o1 == o2 : FALSE
  30155. o1 != o2 : TRUE
  30156. o1 === o2 : FALSE
  30157. o1 !== o2 : TRUE</PRE
  30158. ></TD
  30159. ></TR
  30160. ></TABLE
  30161. >
  30162.   </P
  30163. ></DIV
  30164. ><DIV
  30165. CLASS="sect1"
  30166. ><HR><H2
  30167. CLASS="sect1"
  30168. ><A
  30169. NAME="language.oop.object-comparison-php5"
  30170. ></A
  30171. >Comparing objects in PHP 5</H2
  30172. ><DIV
  30173. CLASS="warning"
  30174. ><P
  30175. ></P
  30176. ><TABLE
  30177. CLASS="warning"
  30178. BORDER="1"
  30179. WIDTH="100%"
  30180. ><TR
  30181. ><TD
  30182. ALIGN="CENTER"
  30183. ><B
  30184. >Varovßnφ</B
  30185. ></TD
  30186. ></TR
  30187. ><TR
  30188. ><TD
  30189. ALIGN="LEFT"
  30190. ><P
  30191. >Toto roz╣φ°enφ je
  30192. <SPAN
  30193. CLASS="emphasis"
  30194. ><I
  30195. CLASS="emphasis"
  30196. >EXPERIMENT┴LN═</I
  30197. ></SPAN
  30198. >. Chovßnφ tohoto roz╣φ°enφ,
  30199. nßzvy funkcφ a v╣echno ostatnφ, co je zde zdokumentovßno, se v budoucφch
  30200. verzφch PHP m∙╛e bez ohlß╣enφ zm∞nit. Berte to v ·vahu a pou╛φvejte tento modul
  30201. na vlastnφ nebezpeΦφ.</P
  30202. ></TD
  30203. ></TR
  30204. ></TABLE
  30205. ></DIV
  30206. ><P
  30207. >     In PHP 5, object comparison is a more complicated than in PHP 4 and more
  30208.     in accordance to what one will expect from an Object Oriented Language
  30209.     (not that PHP 5 is such a language).
  30210.    </P
  30211. ><P
  30212. >     When using the comparison operator (<TT
  30213. CLASS="literal"
  30214. >==</TT
  30215. >), 
  30216.     object variables are compared in a simple manner, namely: Two object
  30217.     instances are equal if they have the same attributes and values, and are
  30218.     instances of the same class.
  30219.    </P
  30220. ><P
  30221. >     On the other hand, when using the identity operator (<TT
  30222. CLASS="literal"
  30223. >===</TT
  30224. >),
  30225.     object variables are identical if and only if they refer to the same
  30226.     instance of the same class.
  30227.    </P
  30228. ><P
  30229. >     An example will clarify these rules.
  30230.     <TABLE
  30231. WIDTH="100%"
  30232. BORDER="0"
  30233. CELLPADDING="0"
  30234. CELLSPACING="0"
  30235. CLASS="EXAMPLE"
  30236. ><TR
  30237. ><TD
  30238. ><DIV
  30239. CLASS="example"
  30240. ><A
  30241. NAME="AEN5594"
  30242. ></A
  30243. ><P
  30244. ><B
  30245. >P°φklad 13-3. Example of object comparison in PHP 5</B
  30246. ></P
  30247. ><TABLE
  30248. BORDER="0"
  30249. BGCOLOR="#E0E0E0"
  30250. CELLPADDING="5"
  30251. ><TR
  30252. ><TD
  30253. ><PRE
  30254. CLASS="php"
  30255. ><?php
  30256. function bool2str($bool) {
  30257.     if ($bool === false) {
  30258.             return 'FALSE';
  30259.     } else {
  30260.             return 'TRUE';
  30261.     }
  30262. }
  30263.  
  30264. function compareObjects(&$o1, &$o2) {
  30265.     echo 'o1 == o2 : '.bool2str($o1 == $o2)."\n";
  30266.     echo 'o1 != o2 : '.bool2str($o1 != $o2)."\n";
  30267.     echo 'o1 === o2 : '.bool2str($o1 === $o2)."\n";
  30268.     echo 'o1 !== o2 : '.bool2str($o1 !== $o2)."\n";
  30269. }
  30270.  
  30271. class Flag {
  30272.     var $flag;
  30273.  
  30274.     function Flag($flag=true) {
  30275.             $this->flag = $flag;
  30276.     }
  30277. }
  30278.  
  30279. class OtherFlag {
  30280.     var $flag;
  30281.  
  30282.     function OtherFlag($flag=true) {
  30283.             $this->flag = $flag;
  30284.     }
  30285. }
  30286.  
  30287. $o = new Flag();
  30288. $p = new Flag();
  30289. $q = $o;
  30290. $r = new OtherFlag();
  30291.  
  30292. echo "Two instances of the same class\n";
  30293. compareObjects($o, $p);
  30294.  
  30295. echo "\nTwo references to the same instance\n";
  30296. compareObjects($o, $q);
  30297.  
  30298. echo "\nInstances of two different classes\n";
  30299. compareObjects($o, $r);
  30300. ?></PRE
  30301. ></TD
  30302. ></TR
  30303. ></TABLE
  30304. ></DIV
  30305. ></TD
  30306. ></TR
  30307. ></TABLE
  30308. >
  30309.     This example will output:
  30310.     <TABLE
  30311. BORDER="0"
  30312. BGCOLOR="#E0E0E0"
  30313. CELLPADDING="5"
  30314. ><TR
  30315. ><TD
  30316. ><PRE
  30317. CLASS="screen"
  30318. >Two instances of the same class
  30319. o1 == o2 : TRUE
  30320. o1 != o2 : FALSE
  30321. o1 === o2 : FALSE
  30322. o1 !== o2 : TRUE
  30323.  
  30324. Two references to the same instance
  30325. o1 == o2 : TRUE
  30326. o1 != o2 : FALSE
  30327. o1 === o2 : TRUE
  30328. o1 !== o2 : FALSE
  30329.  
  30330. Instances of two different classes
  30331. o1 == o2 : FALSE
  30332. o1 != o2 : TRUE
  30333. o1 === o2 : FALSE
  30334. o1 !== o2 : TRUE</PRE
  30335. ></TD
  30336. ></TR
  30337. ></TABLE
  30338. >
  30339.    </P
  30340. ></DIV
  30341. ></DIV
  30342. ><DIV
  30343. CLASS="chapter"
  30344. ><HR><H1
  30345. ><A
  30346. NAME="language.references"
  30347. >Kapitola 14. Vysv∞tlenφ referencφ (odkaz∙)</A
  30348. ></H1
  30349. ><DIV
  30350. CLASS="sect1"
  30351. ><H2
  30352. CLASS="sect1"
  30353. ><A
  30354. NAME="language.references.whatare"
  30355. ></A
  30356. >Co jsou reference</H2
  30357. ><P
  30358. >     Reference (odkazy) jsou prost°edek, jak v PHP p°istupovat k tΘmu╛ obsahu
  30359.     prom∞nnΘ pod r∙zn²mi jmΘny. Nejsou to ukazatele (pointery) jako v C, jsou
  30360.     to aliasy v tabulce symbol∙. Uv∞domte si, ╛e v PHP je rozdφl mezi
  30361.     nßzvem prom∞nnΘ a jejφm obsahem, tak╛e stejn² obsah m∙╛e mφt r∙znΘ nßzvy.
  30362.     Nejbli╛╣φ analogiφ jsou nßzvy soubor∙ a soubory v UNIXu - nßzvy
  30363.     prom∞nn²ch jsou polo╛ky adresß°e, obsahy prom∞nn²ch samotnΘ soubory.
  30364.     Na reference m∙╛e b²t nazφrßno jako na hardlinky v UNIXovΘm systΘmu
  30365.     soubor∙.
  30366.    </P
  30367. ></DIV
  30368. ><DIV
  30369. CLASS="sect1"
  30370. ><HR><H2
  30371. CLASS="sect1"
  30372. ><A
  30373. NAME="language.references.whatdo"
  30374. ></A
  30375. >Co reference d∞lajφ</H2
  30376. ><P
  30377. >     PHP reference umo╛≥ujφ zajistit, aby dv∞ prom∞nnΘ odkazovaly na tent²╛
  30378.     obsah. Tzn. kdy╛ provedete:    
  30379.     <DIV
  30380. CLASS="informalexample"
  30381. ><A
  30382. NAME="AEN5606"
  30383. ></A
  30384. ><P
  30385. ></P
  30386. ><TABLE
  30387. BORDER="0"
  30388. BGCOLOR="#E0E0E0"
  30389. CELLPADDING="5"
  30390. ><TR
  30391. ><TD
  30392. ><PRE
  30393. CLASS="php"
  30394. >$a =& $b</PRE
  30395. ></TD
  30396. ></TR
  30397. ></TABLE
  30398. ><P
  30399. ></P
  30400. ></DIV
  30401. >
  30402.     znamenß to, ╛e <TT
  30403. CLASS="varname"
  30404. >$a</TT
  30405. > a <TT
  30406. CLASS="varname"
  30407. >$b</TT
  30408. > ukazujφ
  30409.     na stejnou prom∞nnou.
  30410.     <DIV
  30411. CLASS="note"
  30412. ><BLOCKQUOTE
  30413. CLASS="note"
  30414. ><P
  30415. ><B
  30416. >Poznßmka: </B
  30417. >
  30418.       <TT
  30419. CLASS="varname"
  30420. >$a</TT
  30421. > a <TT
  30422. CLASS="varname"
  30423. >$b</TT
  30424. > jsou zde ·pln∞
  30425.       ekvivalentnφ, tj. nikoliv ╛e <TT
  30426. CLASS="varname"
  30427. >$a</TT
  30428. > ukazuje na
  30429.       <TT
  30430. CLASS="varname"
  30431. >$b</TT
  30432. > apod., n²br╛ ╛e <TT
  30433. CLASS="varname"
  30434. >$a</TT
  30435. >
  30436.       a <TT
  30437. CLASS="varname"
  30438. >$b</TT
  30439. > ukazujφ na stejnΘ mφsto.
  30440.      </P
  30441. ></BLOCKQUOTE
  30442. ></DIV
  30443. >
  30444.    </P
  30445. ><P
  30446. >     Stejnß syntaxe se m∙╛e pou╛φt s funkcemi, kterΘ vracφ reference a 
  30447.    s operßtorem <TT
  30448. CLASS="literal"
  30449. >new</TT
  30450. > (v PHP 4.0.4 a pozd∞j╣φch):
  30451.     <DIV
  30452. CLASS="informalexample"
  30453. ><A
  30454. NAME="AEN5620"
  30455. ></A
  30456. ><P
  30457. ></P
  30458. ><TABLE
  30459. BORDER="0"
  30460. BGCOLOR="#E0E0E0"
  30461. CELLPADDING="5"
  30462. ><TR
  30463. ><TD
  30464. ><PRE
  30465. CLASS="php"
  30466. >$bar =& new fooclass();
  30467. $foo =& find_var ($bar);</PRE
  30468. ></TD
  30469. ></TR
  30470. ></TABLE
  30471. ><P
  30472. ></P
  30473. ></DIV
  30474. >
  30475.     </P
  30476. ><DIV
  30477. CLASS="note"
  30478. ><BLOCKQUOTE
  30479. CLASS="note"
  30480. ><P
  30481. ><B
  30482. >Poznßmka: </B
  30483. >
  30484.       Nepou╛itφ operßtoru <TT
  30485. CLASS="literal"
  30486. >&</TT
  30487. > zp∙sobφ zkopφrovßnφ
  30488.       objektu. Kdy╛ ve t°φd∞ pou╛ijete <TT
  30489. CLASS="literal"
  30490. >$this</TT
  30491. >, bude se
  30492.       pracovat s aktußlnφ instancφ t°φdy. P°i°azenφ bez
  30493.       <TT
  30494. CLASS="literal"
  30495. >&</TT
  30496. > zkopφruje instanci (nap°. objektu) a
  30497.      <TT
  30498. CLASS="literal"
  30499. >$this</TT
  30500. > bude pracovat s touto kopiφ, co╛ nenφ v╛dy to,
  30501.      co se po╛aduje. V∞t╣inou chcete mφt jedinou instanci, s nφ╛ budete
  30502.      pracovat, kv∙li rychlosti a alokaci pam∞ti.
  30503.      </P
  30504. ></BLOCKQUOTE
  30505. ></DIV
  30506. ><P
  30507. >     Druhou v∞cφ, kterou reference d∞lajφ, je p°edßvßnφ prom∞nn²ch odkazem.
  30508.     To se d∞lß vytvo°enφm lokßlnφ prom∞nnΘ ve funkci a prom∞nnΘ v kontextu
  30509.     volajφcφho prost°edφ, kdy se odkazuje na tent²╛ obsah. Nap°φklad:
  30510.     <DIV
  30511. CLASS="informalexample"
  30512. ><A
  30513. NAME="AEN5629"
  30514. ></A
  30515. ><P
  30516. ></P
  30517. ><TABLE
  30518. BORDER="0"
  30519. BGCOLOR="#E0E0E0"
  30520. CELLPADDING="5"
  30521. ><TR
  30522. ><TD
  30523. ><PRE
  30524. CLASS="php"
  30525. >function foo (&$var)
  30526. {
  30527.     $var++;
  30528. }
  30529.  
  30530. $a=5;
  30531. foo ($a);</PRE
  30532. ></TD
  30533. ></TR
  30534. ></TABLE
  30535. ><P
  30536. ></P
  30537. ></DIV
  30538. >
  30539.     nastavφ do <TT
  30540. CLASS="varname"
  30541. >$a</TT
  30542. > hodnotu 6. To proto, ╛e ve funkci
  30543.     <TT
  30544. CLASS="varname"
  30545. >foo</TT
  30546. > prom∞nnß <TT
  30547. CLASS="varname"
  30548. >$var</TT
  30549. > odkazuje tent²╛
  30550.     obsah jako <TT
  30551. CLASS="varname"
  30552. >$a</TT
  30553. >. Viz detailn∞j╣φ vysv∞tlenφ o
  30554.     <A
  30555. HREF="#language.references.pass"
  30556. >p°edßvßnφ odkazem</A
  30557. >.
  30558.    </P
  30559. ><P
  30560. >     T°etφ v∞cφ, kterou mohou reference d∞lat, je
  30561.     <A
  30562. HREF="#language.references.return"
  30563. >vracenφ p°es reference</A
  30564. >.
  30565.    </P
  30566. ></DIV
  30567. ><DIV
  30568. CLASS="sect1"
  30569. ><HR><H2
  30570. CLASS="sect1"
  30571. ><A
  30572. NAME="language.references.arent"
  30573. ></A
  30574. >Co reference nejsou</H2
  30575. ><P
  30576. >     Jak ji╛ bylo °eΦeno, reference nejsou ukazatele. To znamenß, ╛e tento
  30577.     konstrukt nebude d∞lat to, co oΦekßvßte:
  30578.     <DIV
  30579. CLASS="informalexample"
  30580. ><A
  30581. NAME="AEN5641"
  30582. ></A
  30583. ><P
  30584. ></P
  30585. ><TABLE
  30586. BORDER="0"
  30587. BGCOLOR="#E0E0E0"
  30588. CELLPADDING="5"
  30589. ><TR
  30590. ><TD
  30591. ><PRE
  30592. CLASS="php"
  30593. >function foo (&$var)
  30594. {
  30595.     $var =& $GLOBALS["baz"];
  30596. }
  30597. foo($bar);</PRE
  30598. ></TD
  30599. ></TR
  30600. ></TABLE
  30601. ><P
  30602. ></P
  30603. ></DIV
  30604. >
  30605.    </P
  30606. ><P
  30607. >     Nastane to, ╛e <TT
  30608. CLASS="varname"
  30609. >$var</TT
  30610. > ve funkci <TT
  30611. CLASS="varname"
  30612. >foo</TT
  30613. >
  30614.     bude p°i°azena <TT
  30615. CLASS="varname"
  30616. >$bar</TT
  30617. > ve volajφcφm kontextu, av╣ak potΘ
  30618.     bude p°i°azena <TT
  30619. CLASS="varname"
  30620. >$GLOBALS["baz"]</TT
  30621. >. Nenφ zp∙sob, jak
  30622.     p°i°adit <TT
  30623. CLASS="varname"
  30624. >$bar</TT
  30625. > ve volajφcφm kontextu n∞Φemu jinΘmu
  30626.     za pou╛itφ mechanismu referencφ, proto╛e <TT
  30627. CLASS="varname"
  30628. >$bar</TT
  30629. > nenφ
  30630.     ve funkci <TT
  30631. CLASS="varname"
  30632. >foo</TT
  30633. > dostupnß (je reprezentovßna
  30634.     <TT
  30635. CLASS="varname"
  30636. >$var</TT
  30637. >, ale <TT
  30638. CLASS="varname"
  30639. >$var</TT
  30640. > mß pouze obsah
  30641.     a nikoli spojenφ nßzvu s hodnotou v tabulce symbol∙).
  30642.    </P
  30643. ></DIV
  30644. ><DIV
  30645. CLASS="sect1"
  30646. ><HR><H2
  30647. CLASS="sect1"
  30648. ><A
  30649. NAME="language.references.pass"
  30650. ></A
  30651. >P°edßvßnφ referencφ (odkazem)</H2
  30652. ><P
  30653. >     M∙╛ete p°edßvat prom∞nnou do funkce pomocφ odkazu, tak╛e funkce m∙╛e
  30654.     modifikovat jejφ argumenty. Syntaxe je nßsledujφcφ:
  30655.     <DIV
  30656. CLASS="informalexample"
  30657. ><A
  30658. NAME="AEN5656"
  30659. ></A
  30660. ><P
  30661. ></P
  30662. ><TABLE
  30663. BORDER="0"
  30664. BGCOLOR="#E0E0E0"
  30665. CELLPADDING="5"
  30666. ><TR
  30667. ><TD
  30668. ><PRE
  30669. CLASS="php"
  30670. >function foo (&$var)
  30671. {
  30672.     $var++;
  30673. }
  30674.  
  30675. $a=5;
  30676. foo ($a);
  30677. // $a je te∩ 6</PRE
  30678. ></TD
  30679. ></TR
  30680. ></TABLE
  30681. ><P
  30682. ></P
  30683. ></DIV
  30684. >
  30685.     V╣imn∞te si, ╛e ve volßnφ funkce nenφ znak reference - pouze v jejφ
  30686.     definici. Samotnß definice funkce staΦφ na sprßvnΘ p°edßvßnφ argumentu
  30687.     odkazem. 
  30688.   </P
  30689. ><P
  30690. >   Nßsledujφcφ v∞ci lze p°edßvat referencφ:
  30691.    <P
  30692. ></P
  30693. ><UL
  30694. ><LI
  30695. ><P
  30696. >       Prom∞nnß, nap°. <TT
  30697. CLASS="literal"
  30698. >foo($a)</TT
  30699. >
  30700.      </P
  30701. ></LI
  30702. ><LI
  30703. ><P
  30704. >       Konstrukt s new, nap°. <TT
  30705. CLASS="literal"
  30706. >foo(new foobar())</TT
  30707. >
  30708.      </P
  30709. ></LI
  30710. ><LI
  30711. ><P
  30712. >       Reference, vracenß z funkce, nap°.:
  30713.     <DIV
  30714. CLASS="informalexample"
  30715. ><A
  30716. NAME="AEN5668"
  30717. ></A
  30718. ><P
  30719. ></P
  30720. ><TABLE
  30721. BORDER="0"
  30722. BGCOLOR="#E0E0E0"
  30723. CELLPADDING="5"
  30724. ><TR
  30725. ><TD
  30726. ><PRE
  30727. CLASS="php"
  30728. >function &bar()
  30729. {
  30730.     $a = 5;
  30731.     return $a;
  30732. }
  30733. foo(bar());</PRE
  30734. ></TD
  30735. ></TR
  30736. ></TABLE
  30737. ><P
  30738. ></P
  30739. ></DIV
  30740. >
  30741.     Viz takΘ vysv∞tlenφ
  30742.     <A
  30743. HREF="#language.references.return"
  30744. >vracenφ p°es reference</A
  30745. >. 
  30746.      </P
  30747. ></LI
  30748. ></UL
  30749. >
  30750.   </P
  30751. ><P
  30752. >    «ßdnΘ jinΘ v²razy nemohou b²t p°edßvßny odkazem, v²sledek tohoto nenφ
  30753.    definovßn. Nap°φklad, nßsledujφcφ ukßzky p°edßvßnφ odkazem jsou neplatnΘ:
  30754.     <DIV
  30755. CLASS="informalexample"
  30756. ><A
  30757. NAME="AEN5672"
  30758. ></A
  30759. ><P
  30760. ></P
  30761. ><TABLE
  30762. BORDER="0"
  30763. BGCOLOR="#E0E0E0"
  30764. CELLPADDING="5"
  30765. ><TR
  30766. ><TD
  30767. ><PRE
  30768. CLASS="php"
  30769. >function bar() // V╣imn∞te si chyb∞jφcφho &
  30770. {
  30771.     $a = 5;
  30772.     return $a;
  30773. }
  30774. foo(bar());
  30775.  
  30776. foo($a = 5) // V²raz, nikoli prom∞nnß
  30777. foo(5) // Konstanta, nikoli prom∞nnß</PRE
  30778. ></TD
  30779. ></TR
  30780. ></TABLE
  30781. ><P
  30782. ></P
  30783. ></DIV
  30784. >
  30785.         Tyto po╛adavky platφ pro PHP 4.0.4 a pozd∞j╣φ.
  30786.   </P
  30787. ></DIV
  30788. ><DIV
  30789. CLASS="sect1"
  30790. ><HR><H2
  30791. CLASS="sect1"
  30792. ><A
  30793. NAME="language.references.return"
  30794. ></A
  30795. >Vracenφ referencφ</H2
  30796. ><P
  30797. >     Vracenφ odkazem je u╛iteΦnΘ, kdy╛ chcete pou╛φt funkci k nalezenφ
  30798.     prom∞nnΘ, kterß by m∞la b²t odkazu p°i°azena. P°i vracenφ referencφ
  30799.     pou╛ijte tuto syntaxi:
  30800.     <DIV
  30801. CLASS="informalexample"
  30802. ><A
  30803. NAME="AEN5677"
  30804. ></A
  30805. ><P
  30806. ></P
  30807. ><TABLE
  30808. BORDER="0"
  30809. BGCOLOR="#E0E0E0"
  30810. CELLPADDING="5"
  30811. ><TR
  30812. ><TD
  30813. ><PRE
  30814. CLASS="php"
  30815. >function &find_var ($param)
  30816. {
  30817.     ...n∞jak² k≤d...
  30818.     return $found_var;
  30819. }
  30820.  
  30821. $foo =& find_var ($bar);
  30822. $foo->x = 2;</PRE
  30823. ></TD
  30824. ></TR
  30825. ></TABLE
  30826. ><P
  30827. ></P
  30828. ></DIV
  30829. >
  30830.     V tomto p°φkladu by bylo funkcφ <TT
  30831. CLASS="varname"
  30832. >find_var</TT
  30833. > nastaveno
  30834.     vlastnictvφ tΘho╛ objektu, nikoli jeho kopie, jak by se stalo bez pou╛itφ
  30835.     syntaxe bez odkaz∙.
  30836.    </P
  30837. ><DIV
  30838. CLASS="note"
  30839. ><BLOCKQUOTE
  30840. CLASS="note"
  30841. ><P
  30842. ><B
  30843. >Poznßmka: </B
  30844. >
  30845.      Narozdφl od p°edßvßnφ parametru, zde musφte <TT
  30846. CLASS="literal"
  30847. >&</TT
  30848. >
  30849.      pou╛φt na obou mφstech - k indikaci, ╛e vracφte odkaz a nikoli kopii
  30850.      jako obvykle, a k indikaci p°i°azenφ reference do <TT
  30851. CLASS="varname"
  30852. >$foo</TT
  30853. >
  30854.      namφsto b∞╛nΘho p°i°azenφ (hodnoty).
  30855.     </P
  30856. ></BLOCKQUOTE
  30857. ></DIV
  30858. ></DIV
  30859. ><DIV
  30860. CLASS="sect1"
  30861. ><HR><H2
  30862. CLASS="sect1"
  30863. ><A
  30864. NAME="language.references.unset"
  30865. ></A
  30866. >Odnastavenφ odkaz∙</H2
  30867. ><P
  30868. >     Kdy╛ odnastavφte referenci, p°eru╣φte vazbu mezi nßzvem prom∞nnΘ a jejφm
  30869.     obsahem. To neznamenß, ╛e by obsah byl zniΦen. Nap°φklad:
  30870.     <DIV
  30871. CLASS="informalexample"
  30872. ><A
  30873. NAME="AEN5687"
  30874. ></A
  30875. ><P
  30876. ></P
  30877. ><TABLE
  30878. BORDER="0"
  30879. BGCOLOR="#E0E0E0"
  30880. CELLPADDING="5"
  30881. ><TR
  30882. ><TD
  30883. ><PRE
  30884. CLASS="php"
  30885. >$a = 1;
  30886. $b =& $a;
  30887. unset ($a);</PRE
  30888. ></TD
  30889. ></TR
  30890. ></TABLE
  30891. ><P
  30892. ></P
  30893. ></DIV
  30894. >
  30895.     neodnastavφ <TT
  30896. CLASS="varname"
  30897. >$b</TT
  30898. >, n²br╛ pouze <TT
  30899. CLASS="varname"
  30900. >$a</TT
  30901. >. 
  30902.    </P
  30903. ><P
  30904. >     Znovu je dobrΘ si p°ipomenout analogii s UNIXov²m p°φkazem
  30905.     <B
  30906. CLASS="command"
  30907. >unlink</B
  30908. >.
  30909.    </P
  30910. ></DIV
  30911. ><DIV
  30912. CLASS="sect1"
  30913. ><HR><H2
  30914. CLASS="sect1"
  30915. ><A
  30916. NAME="language.references.spot"
  30917. ></A
  30918. >Dal╣φ v²skyt referencφ</H2
  30919. ><P
  30920. >     Mnoho syntaktick²ch konstrukt∙ v PHP je implementovßno p°es odkazov²
  30921.     mechanismus, tak╛e v╣e, co bylo °eΦeno v²╣e o p°i°azovßnφ referencφ,
  30922.     platφ i na tyto konstrukty. N∞kterΘ konstrukty, jako p°edßvßnφ a
  30923.     vracenφ p°es odkazy, byly ji╛ zmφn∞ny. Ostatnφ konstrukty pou╛φvajφcφ
  30924.     reference jsou:
  30925.    </P
  30926. ><DIV
  30927. CLASS="sect2"
  30928. ><HR><H3
  30929. CLASS="sect2"
  30930. ><A
  30931. NAME="references.global"
  30932. ></A
  30933. >odkazy <TT
  30934. CLASS="literal"
  30935. >global</TT
  30936. ></H3
  30937. ><P
  30938. >      Kdy╛ deklarujete prom∞nnou jako <B
  30939. CLASS="command"
  30940. >global $var</B
  30941. >, ve
  30942.      skuteΦnosti vytvß°φte odkaz na globßlnφ prom∞nnou. Tzn. je to totΘ╛,
  30943.      jako:
  30944.      <DIV
  30945. CLASS="informalexample"
  30946. ><A
  30947. NAME="AEN5701"
  30948. ></A
  30949. ><P
  30950. ></P
  30951. ><TABLE
  30952. BORDER="0"
  30953. BGCOLOR="#E0E0E0"
  30954. CELLPADDING="5"
  30955. ><TR
  30956. ><TD
  30957. ><PRE
  30958. CLASS="php"
  30959. >$var =& $GLOBALS["var"];</PRE
  30960. ></TD
  30961. ></TR
  30962. ></TABLE
  30963. ><P
  30964. ></P
  30965. ></DIV
  30966. >
  30967.     </P
  30968. ><P
  30969. >      To znamenß, nap°φklad, ╛e odnastavenφ <TT
  30970. CLASS="varname"
  30971. >$var</TT
  30972. >
  30973.      neodnastavφ globßlnφ prom∞nnou.
  30974.     </P
  30975. ></DIV
  30976. ><DIV
  30977. CLASS="sect2"
  30978. ><HR><H3
  30979. CLASS="sect2"
  30980. ><A
  30981. NAME="references.this"
  30982. ></A
  30983. ><TT
  30984. CLASS="literal"
  30985. >$this</TT
  30986. ></H3
  30987. ><P
  30988. >      V metod∞ objektu je <TT
  30989. CLASS="varname"
  30990. >$this</TT
  30991. > v╛dy odkazem na volajφcφ
  30992.      objekt.
  30993.     </P
  30994. ></DIV
  30995. ></DIV
  30996. ></DIV
  30997. ></DIV
  30998. ><DIV
  30999. CLASS="PART"
  31000. ><A
  31001. NAME="security"
  31002. ></A
  31003. ><DIV
  31004. CLASS="TITLEPAGE"
  31005. ><H1
  31006. CLASS="title"
  31007. >III. Security</H1
  31008. ><DIV
  31009. CLASS="TOC"
  31010. ><DL
  31011. ><DT
  31012. ><B
  31013. >Obsah</B
  31014. ></DT
  31015. ><DT
  31016. >15. <A
  31017. HREF="#security.index"
  31018. >Security</A
  31019. ></DT
  31020. ></DL
  31021. ></DIV
  31022. ></DIV
  31023. ><DIV
  31024. CLASS="chapter"
  31025. ><HR><H1
  31026. ><A
  31027. NAME="security.index"
  31028. >Kapitola 15. Security</A
  31029. ></H1
  31030. ><P
  31031. >    PHP is a powerful language and the interpreter, whether included
  31032.    in a web server as a module or executed as a separate
  31033.    <SPAN
  31034. CLASS="acronym"
  31035. >CGI</SPAN
  31036. > binary, is able to access files, execute
  31037.    commands and open network connections on the server.  These
  31038.    properties make anything run on a web server insecure by default.
  31039.    PHP is designed specifically to be a more secure language for
  31040.    writing CGI programs than Perl or C, and with correct selection of
  31041.    compile-time and runtime configuration options, and proper coding
  31042.    practices, it can give you exactly the combination of freedom and
  31043.    security you need.
  31044.   </P
  31045. ><P
  31046. >    As there are many different ways of utilizing PHP, there are many
  31047.    configuration options controlling its behaviour.  A large
  31048.    selection of options guarantees you can use PHP for a lot of
  31049.    purposes, but it also means there are combinations of these
  31050.    options and server configurations that result in an insecure
  31051.    setup.
  31052.   </P
  31053. ><P
  31054. >    The configuration flexibility of PHP is equally rivalled by the
  31055.    code flexibility. PHP can be used to build complete server
  31056.    applications, with all the power of a shell user, or it can be used
  31057.    for simple server-side includes with little risk in a tightly
  31058.    controlled environment. How you build that environment, and how
  31059.    secure it is, is largely up to the PHP developer.
  31060.   </P
  31061. ><P
  31062. >    This chapter starts with some general security advice, explains
  31063.    the different configuration option combinations and the situations
  31064.    they can be safely used, and describes different considerations in
  31065.    coding for different levels of security.
  31066.   </P
  31067. ><DIV
  31068. CLASS="sect1"
  31069. ><HR><H2
  31070. CLASS="sect1"
  31071. ><A
  31072. NAME="security.general"
  31073. ></A
  31074. >General considerations</H2
  31075. ><P
  31076. >     A completely secure system is a virtual impossibility, so an
  31077.     approach often used in the security profession is one of balancing
  31078.     risk and usability. If every variable submitted by a user required
  31079.     two forms of biometric validation (such as a retinal scan and a
  31080.     fingerprint), you would have an extremely high level of
  31081.     accountability. It would also take half an hour to fill out a fairly
  31082.     complex form, which would tend to encourage users to find ways of
  31083.     bypassing the security.
  31084.    </P
  31085. ><P
  31086. >     The best security is often inobtrusive enough to suit the
  31087.     requirements without the user being prevented from accomplishing
  31088.     their work, or over-burdening the code author with excessive
  31089.     complexity. Indeed, some security attacks are merely exploits of
  31090.     this kind of overly built security, which tends to erode over time.
  31091.    </P
  31092. ><P
  31093. >     A phrase worth remembering: A system is only as good as the weakest
  31094.     link in a chain. If all transactions are heavily logged based on
  31095.     time, location, transaction type, etc. but the user is only
  31096.     verified based on a single cookie, the validity of tying the users
  31097.     to the transaction log is severely weakened.
  31098.    </P
  31099. ><P
  31100. >     When testing, keep in mind that you will not be able to test all
  31101.     possibilities for even the simplest of pages. The input you
  31102.     may expect will be completely unrelated to the input given by
  31103.     a disgruntled employee, a cracker with months of time on their
  31104.     hands, or a housecat walking across the keyboard. This is why it's
  31105.     best to look at the code from a logical perspective, to discern
  31106.     where unexpected data can be introduced, and then follow how it is
  31107.     modified, reduced, or amplified.
  31108.    </P
  31109. ><P
  31110. >     The Internet is filled with people trying to make a name for
  31111.     themselves by breaking your code, crashing your site, posting
  31112.     inappropriate content, and otherwise making your day interesting.
  31113.     It doesn't matter if you have a small or large site, you are
  31114.     a target by simply being online, by having a server that can be
  31115.     connected to. Many cracking programs do not discern by size, they
  31116.     simply trawl massive IP blocks looking for victims. Try not to
  31117.     become one.
  31118.    </P
  31119. ></DIV
  31120. ><DIV
  31121. CLASS="sect1"
  31122. ><HR><H2
  31123. CLASS="sect1"
  31124. ><A
  31125. NAME="security.cgi-bin"
  31126. ></A
  31127. >Installed as CGI binary</H2
  31128. ><DIV
  31129. CLASS="sect2"
  31130. ><H3
  31131. CLASS="sect2"
  31132. ><A
  31133. NAME="security.cgi-bin.attacks"
  31134. ></A
  31135. >Possible attacks</H3
  31136. ><P
  31137. >      Using PHP as a <SPAN
  31138. CLASS="acronym"
  31139. >CGI</SPAN
  31140. > binary is an option for
  31141.      setups that for some reason do not wish to integrate PHP as a
  31142.      module into server software (like Apache), or will use PHP with
  31143.      different kinds of CGI wrappers to create safe chroot and setuid
  31144.      environments for scripts.  This setup usually involves installing
  31145.      executable PHP binary to the web server cgi-bin directory.  CERT
  31146.      advisory <A
  31147. HREF="http://www.cert.org/advisories/CA-1996-11.html"
  31148. TARGET="_top"
  31149. >CA-96.11</A
  31150. > recommends
  31151.      against placing any interpreters into cgi-bin.  Even if the PHP
  31152.      binary can be used as a standalone interpreter, PHP is designed
  31153.      to prevent the attacks this setup makes possible:
  31154.     </P
  31155. ><P
  31156. ></P
  31157. ><UL
  31158. ><LI
  31159. ><P
  31160. >        Accessing system files: <TT
  31161. CLASS="filename"
  31162. >http://my.host/cgi-bin/php?/etc/passwd</TT
  31163. >
  31164.       </P
  31165. ><P
  31166. >        The query information in a url after the question mark (?)  is
  31167.        passed as command line arguments to the interpreter by the CGI
  31168.        interface.  Usually interpreters open and execute the file
  31169.        specified as the first argument on the command line.
  31170.       </P
  31171. ><P
  31172. >        When invoked as a CGI binary, PHP refuses to interpret the
  31173.        command line arguments.
  31174.       </P
  31175. ></LI
  31176. ><LI
  31177. ><P
  31178. >        Accessing any web document on server: <TT
  31179. CLASS="filename"
  31180. >http://my.host/cgi-bin/php/secret/doc.html</TT
  31181. >
  31182.       </P
  31183. ><P
  31184. >        The path information part of the url after the PHP binary name,
  31185.        <TT
  31186. CLASS="filename"
  31187. >/secret/doc.html</TT
  31188. > is
  31189.        conventionally used to specify the name of the file to be
  31190.        opened and interpreted by the <SPAN
  31191. CLASS="acronym"
  31192. >CGI</SPAN
  31193. > program.
  31194.        Usually some web server configuration directives (Apache:
  31195.        Action) are used to redirect requests to documents like
  31196.        <TT
  31197. CLASS="filename"
  31198. >http://my.host/secret/script.php</TT
  31199. > to the
  31200.        PHP interpreter.  With this setup, the web server first checks
  31201.        the access permissions to the directory <TT
  31202. CLASS="filename"
  31203. >/secret</TT
  31204. >, and after that creates the
  31205.        redirected request <TT
  31206. CLASS="filename"
  31207. >http://my.host/cgi-bin/php/secret/script.php</TT
  31208. >.
  31209.        Unfortunately, if the request is originally given in this form,
  31210.        no access checks are made by web server for file <TT
  31211. CLASS="filename"
  31212. >/secret/script.php</TT
  31213. >, but only for the
  31214.        <TT
  31215. CLASS="filename"
  31216. >/cgi-bin/php</TT
  31217. > file.  This way
  31218.        any user able to access <TT
  31219. CLASS="filename"
  31220. >/cgi-bin/php</TT
  31221. > is able to access any
  31222.        protected document on the web server.
  31223.       </P
  31224. ><P
  31225. >        In PHP, compile-time configuration option <A
  31226. HREF="#install.configure.enable-force-cgi-redirect"
  31227. >--enable-force-cgi-redirect</A
  31228. >
  31229.        and runtime configuration directives <A
  31230. HREF="#ini.doc-root"
  31231. >doc_root</A
  31232. > and <A
  31233. HREF="#ini.user-dir"
  31234. >user_dir</A
  31235. > can be used to prevent
  31236.        this attack, if the server document tree has any directories
  31237.        with access restrictions.  See below for full the explanation
  31238.        of the different combinations.
  31239.       </P
  31240. ></LI
  31241. ></UL
  31242. ></DIV
  31243. ><DIV
  31244. CLASS="sect2"
  31245. ><HR><H3
  31246. CLASS="sect2"
  31247. ><A
  31248. NAME="security.cgi-bin.default"
  31249. ></A
  31250. >Case 1: only public files served</H3
  31251. ><P
  31252. >      If your server does not have any content that is not restricted
  31253.      by password or ip based access control, there is no need for
  31254.      these configuration options.  If your web server does not allow
  31255.      you to do redirects, or the server does not have a way to
  31256.      communicate to the PHP binary that the request is a safely
  31257.      redirected request, you can specify the option <A
  31258. HREF="#install.configure.enable-force-cgi-redirect"
  31259. >--enable-force-cgi-redirect</A
  31260. >
  31261.      to the configure script.  You still have to make sure your PHP
  31262.      scripts do not rely on one or another way of calling the script,
  31263.      neither by directly <TT
  31264. CLASS="filename"
  31265. >http://my.host/cgi-bin/php/dir/script.php</TT
  31266. >
  31267.      nor by redirection <TT
  31268. CLASS="filename"
  31269. >http://my.host/dir/script.php</TT
  31270. >.
  31271.     </P
  31272. ><P
  31273. >      Redirection can be configured in Apache by using AddHandler and
  31274.      Action directives (see below).
  31275.     </P
  31276. ></DIV
  31277. ><DIV
  31278. CLASS="sect2"
  31279. ><HR><H3
  31280. CLASS="sect2"
  31281. ><A
  31282. NAME="security.cgi-bin.force-redirect"
  31283. ></A
  31284. >Case 2: using --enable-force-cgi-redirect</H3
  31285. ><P
  31286. >      This compile-time option prevents anyone from calling PHP
  31287.      directly with a url like <TT
  31288. CLASS="filename"
  31289. >http://my.host/cgi-bin/php/secretdir/script.php</TT
  31290. >.
  31291.      Instead, PHP will only parse in this mode if it has gone through
  31292.      a web server redirect rule.
  31293.     </P
  31294. ><P
  31295. >      Usually the redirection in the Apache configuration is done with
  31296.      the following directives:
  31297.     </P
  31298. ><TABLE
  31299. BORDER="0"
  31300. BGCOLOR="#E0E0E0"
  31301. CELLPADDING="5"
  31302. ><TR
  31303. ><TD
  31304. ><PRE
  31305. CLASS="apache-conf"
  31306. >Action php-script /cgi-bin/php
  31307. AddHandler php-script .php</PRE
  31308. ></TD
  31309. ></TR
  31310. ></TABLE
  31311. ><P
  31312. >      This option has only been tested with the Apache web server, and
  31313.      relies on Apache to set the non-standard CGI environment variable
  31314.      <TT
  31315. CLASS="envar"
  31316. >REDIRECT_STATUS</TT
  31317. > on redirected requests.  If your
  31318.      web server does not support any way of telling if the request is
  31319.      direct or redirected, you cannot use this option and you must use
  31320.      one of the other ways of running the CGI version documented
  31321.      here.
  31322.     </P
  31323. ></DIV
  31324. ><DIV
  31325. CLASS="sect2"
  31326. ><HR><H3
  31327. CLASS="sect2"
  31328. ><A
  31329. NAME="security.cgi-bin.doc-root"
  31330. ></A
  31331. >Case 3: setting doc_root or user_dir</H3
  31332. ><P
  31333. >      To include active content, like scripts and executables, in the
  31334.      web server document directories is sometimes considered an insecure
  31335.      practice.  If, because of some configuration mistake, the scripts
  31336.      are not executed but displayed as regular HTML documents, this
  31337.      may result in leakage of intellectual property or security
  31338.      information like passwords.  Therefore many sysadmins will prefer
  31339.      setting up another directory structure for scripts that are
  31340.      accessible only through the PHP CGI, and therefore always
  31341.      interpreted and not displayed as such.
  31342.     </P
  31343. ><P
  31344. >      Also if the method for making sure the requests are not
  31345.      redirected, as described in the previous section, is not
  31346.      available, it is necessary to set up a script doc_root that is
  31347.      different from web document root.
  31348.     </P
  31349. ><P
  31350. >      You can set the PHP script document root by the configuration
  31351.      directive <A
  31352. HREF="#ini.doc-root"
  31353. >doc_root</A
  31354. > in the
  31355.      <A
  31356. HREF="#configuration.file"
  31357. >configuration file</A
  31358. >, or
  31359.      you can set the environment variable
  31360.      <TT
  31361. CLASS="envar"
  31362. >PHP_DOCUMENT_ROOT</TT
  31363. >.  If it is set, the CGI version
  31364.      of PHP will always construct the file name to open with this
  31365.      <TT
  31366. CLASS="parameter"
  31367. ><I
  31368. >doc_root</I
  31369. ></TT
  31370. > and the path information in the
  31371.      request, so you can be sure no script is executed outside this
  31372.      directory (except for <TT
  31373. CLASS="parameter"
  31374. ><I
  31375. >user_dir</I
  31376. ></TT
  31377. >
  31378.      below).
  31379.     </P
  31380. ><P
  31381. >      Another option usable here is <A
  31382. HREF="#ini.user-dir"
  31383. >user_dir</A
  31384. >.  When user_dir is unset,
  31385.      only thing controlling the opened file name is
  31386.      <TT
  31387. CLASS="parameter"
  31388. ><I
  31389. >doc_root</I
  31390. ></TT
  31391. >.  Opening an url like <TT
  31392. CLASS="filename"
  31393. >http://my.host/~user/doc.php</TT
  31394. > does not
  31395.      result in opening a file under users home directory, but a file
  31396.      called <TT
  31397. CLASS="filename"
  31398. >~user/doc.php</TT
  31399. > under
  31400.      doc_root (yes, a directory name starting with a tilde
  31401.      [<TT
  31402. CLASS="literal"
  31403. >~</TT
  31404. >]).
  31405.     </P
  31406. ><P
  31407. >      If user_dir is set to for example <TT
  31408. CLASS="filename"
  31409. >public_php</TT
  31410. >, a request like <TT
  31411. CLASS="filename"
  31412. >http://my.host/~user/doc.php</TT
  31413. > will open a
  31414.      file called <TT
  31415. CLASS="filename"
  31416. >doc.php</TT
  31417. > under the directory
  31418.      named <TT
  31419. CLASS="filename"
  31420. >public_php</TT
  31421. > under the home
  31422.      directory of the user.  If the home of the user is <TT
  31423. CLASS="filename"
  31424. >/home/user</TT
  31425. >, the file executed is
  31426.      <TT
  31427. CLASS="filename"
  31428. >/home/user/public_php/doc.php</TT
  31429. >.
  31430.     </P
  31431. ><P
  31432. >      <TT
  31433. CLASS="parameter"
  31434. ><I
  31435. >user_dir</I
  31436. ></TT
  31437. > expansion happens regardless of
  31438.      the <TT
  31439. CLASS="parameter"
  31440. ><I
  31441. >doc_root</I
  31442. ></TT
  31443. > setting, so you can control
  31444.      the document root and user directory access
  31445.      separately.
  31446.     </P
  31447. ></DIV
  31448. ><DIV
  31449. CLASS="sect2"
  31450. ><HR><H3
  31451. CLASS="sect2"
  31452. ><A
  31453. NAME="security.cgi-bin.shell"
  31454. ></A
  31455. >Case 4: PHP parser outside of web tree</H3
  31456. ><P
  31457. >      A very secure option is to put the PHP parser binary somewhere
  31458.      outside of the web tree of files.  In <TT
  31459. CLASS="filename"
  31460. >/usr/local/bin</TT
  31461. >, for example.  The only real
  31462.      downside to this option is that you will now have to put a line
  31463.      similar to:
  31464.      <DIV
  31465. CLASS="informalexample"
  31466. ><A
  31467. NAME="AEN5800"
  31468. ></A
  31469. ><P
  31470. ></P
  31471. ><TABLE
  31472. BORDER="0"
  31473. BGCOLOR="#E0E0E0"
  31474. CELLPADDING="5"
  31475. ><TR
  31476. ><TD
  31477. ><PRE
  31478. CLASS="programlisting"
  31479. >#!/usr/local/bin/php</PRE
  31480. ></TD
  31481. ></TR
  31482. ></TABLE
  31483. ><P
  31484. ></P
  31485. ></DIV
  31486. >
  31487.      as the first line of any file containing PHP tags.  You will also
  31488.      need to make the file executable.  That is, treat it exactly as
  31489.      you would treat any other CGI script written in Perl or sh or any
  31490.      other common scripting language which uses the
  31491.      <TT
  31492. CLASS="literal"
  31493. >#!</TT
  31494. > shell-escape mechanism for launching
  31495.      itself.
  31496.     </P
  31497. ><P
  31498. >      To get PHP to handle <TT
  31499. CLASS="envar"
  31500. >PATH_INFO</TT
  31501. > and
  31502.      <TT
  31503. CLASS="envar"
  31504. >PATH_TRANSLATED</TT
  31505. > information correctly with this
  31506.      setup, the PHP parser should be compiled with the <A
  31507. HREF="#install.configure.enable-discard-path"
  31508. >--enable-discard-path</A
  31509. >
  31510.      configure option.
  31511.     </P
  31512. ></DIV
  31513. ></DIV
  31514. ><DIV
  31515. CLASS="sect1"
  31516. ><HR><H2
  31517. CLASS="sect1"
  31518. ><A
  31519. NAME="security.apache"
  31520. ></A
  31521. >Installed as an Apache module</H2
  31522. ><P
  31523. >     When PHP is used as an Apache module it inherits Apache's user
  31524.     permissions (typically those of the "nobody" user). This has several
  31525.     impacts on security and authorization. For example, if you are using
  31526.     PHP to access a database, unless that database has built-in access
  31527.     control, you will have to make the database accessible to the
  31528.     "nobody" user. This means a malicious script could access and modify
  31529.     the database, even without a username and password. It's entirely
  31530.     possible that a web spider could stumble across a database
  31531.     administrator's web page, and drop all of your databases. You can
  31532.     protect against this with Apache authorization, or you can design
  31533.     your own access model using LDAP, <TT
  31534. CLASS="filename"
  31535. >.htaccess</TT
  31536. > files, etc. and include
  31537.     that code as part of your PHP scripts.
  31538.    </P
  31539. ><P
  31540. >     Often, once security is established to the point where the PHP user
  31541.     (in this case, the apache user) has very little risk attached to it,
  31542.     it is discovered that PHP is now prevented from writing any files
  31543.     to user directories. Or perhaps it has been prevented from accessing
  31544.     or changing databases. It has equally been secured from writing
  31545.     good and bad files, or entering good and bad database transactions.
  31546.    </P
  31547. ><P
  31548. >     A frequent security mistake made at this point is to allow apache
  31549.     root permissions, or to escalate apache's abilitites in some other
  31550.     way.
  31551.    </P
  31552. ><P
  31553. >     Escalating the Apache user's permissions to root is extremely
  31554.     dangerous and may compromise the entire system, so sudo'ing,
  31555.     chroot'ing, or otherwise running as root should not be considered by
  31556.     those who are not security professionals.
  31557.    </P
  31558. ><P
  31559. >     There are some simpler solutions. By using
  31560.     <A
  31561. HREF="#ini.open-basedir"
  31562. >open_basedir</A
  31563. > you can control and restrict what
  31564.     directories are allowed to be used for PHP. You can also set up
  31565.     apache-only areas, to restrict all web based activity to non-user,
  31566.     or non-system, files.
  31567.    </P
  31568. ></DIV
  31569. ><DIV
  31570. CLASS="sect1"
  31571. ><HR><H2
  31572. CLASS="sect1"
  31573. ><A
  31574. NAME="security.filesystem"
  31575. ></A
  31576. >Filesystem Security</H2
  31577. ><P
  31578. >     PHP is subject to the security built into most server systems with
  31579.     respect to permissions on a file and directory basis. This allows
  31580.     you to control which files in the filesystem may be read. Care
  31581.     should be taken with any files which are world readable to ensure
  31582.     that they are safe for reading by all users who have access to that
  31583.     filesystem.
  31584.    </P
  31585. ><P
  31586. >     Since PHP was designed to allow user level access to the filesystem,
  31587.     it's entirely possible to write a PHP script that will allow you
  31588.     to read system files such as /etc/passwd, modify your ethernet
  31589.     connections, send massive printer jobs out, etc. This has some
  31590.     obvious implications, in that you need to ensure that the files
  31591.     that you read from and write to are the appropriate ones.
  31592.    </P
  31593. ><P
  31594. >     Consider the following script, where a user indicates that they'd
  31595.     like to delete a file in their home directory. This assumes a
  31596.     situation where a PHP web interface is regularly used for file
  31597.     management, so the Apache user is allowed to delete files in
  31598.     the user home directories.
  31599.    </P
  31600. ><P
  31601. >     <TABLE
  31602. WIDTH="100%"
  31603. BORDER="0"
  31604. CELLPADDING="0"
  31605. CELLSPACING="0"
  31606. CLASS="EXAMPLE"
  31607. ><TR
  31608. ><TD
  31609. ><DIV
  31610. CLASS="example"
  31611. ><A
  31612. NAME="AEN5822"
  31613. ></A
  31614. ><P
  31615. ><B
  31616. >P°φklad 15-1. Poor variable checking leads to....</B
  31617. ></P
  31618. ><TABLE
  31619. BORDER="0"
  31620. BGCOLOR="#E0E0E0"
  31621. CELLPADDING="5"
  31622. ><TR
  31623. ><TD
  31624. ><PRE
  31625. CLASS="php"
  31626. ><?php
  31627. // remove a file from the user's home directory
  31628. $username = $_POST['user_submitted_name'];
  31629. $homedir = "/home/$username";
  31630. $file_to_delete = "$userfile";
  31631. unlink ("$homedir/$userfile");
  31632. echo "$file_to_delete has been deleted!";
  31633. ?></PRE
  31634. ></TD
  31635. ></TR
  31636. ></TABLE
  31637. ></DIV
  31638. ></TD
  31639. ></TR
  31640. ></TABLE
  31641. >
  31642.    Since the username is postable from a user form, they can submit
  31643.    a username and file belonging to someone else, and delete files.
  31644.    In this case, you'd want to use some other form of authentication.
  31645.    Consider what could happen if the variables submitted were
  31646.    "../etc/" and "passwd". The code would then effectively read:
  31647.     <TABLE
  31648. WIDTH="100%"
  31649. BORDER="0"
  31650. CELLPADDING="0"
  31651. CELLSPACING="0"
  31652. CLASS="EXAMPLE"
  31653. ><TR
  31654. ><TD
  31655. ><DIV
  31656. CLASS="example"
  31657. ><A
  31658. NAME="AEN5825"
  31659. ></A
  31660. ><P
  31661. ><B
  31662. >P°φklad 15-2. ... A filesystem attack</B
  31663. ></P
  31664. ><TABLE
  31665. BORDER="0"
  31666. BGCOLOR="#E0E0E0"
  31667. CELLPADDING="5"
  31668. ><TR
  31669. ><TD
  31670. ><PRE
  31671. CLASS="php"
  31672. ><?php
  31673. // removes a file from anywhere on the hard drive that
  31674. // the PHP user has access to. If PHP has root access:
  31675. $username = "../etc/";
  31676. $homedir = "/home/../etc/";
  31677. $file_to_delete = "passwd";
  31678. unlink ("/home/../etc/passwd");
  31679. echo "/home/../etc/passwd has been deleted!";
  31680. ?></PRE
  31681. ></TD
  31682. ></TR
  31683. ></TABLE
  31684. ></DIV
  31685. ></TD
  31686. ></TR
  31687. ></TABLE
  31688. >
  31689.     There are two important measures you should take to prevent these
  31690.     issues.
  31691.     <P
  31692. ></P
  31693. ><UL
  31694. ><LI
  31695. ><P
  31696. >        Only allow limited permissions to the PHP web user binary.
  31697.       </P
  31698. ></LI
  31699. ><LI
  31700. ><P
  31701. >        Check all variables which are submitted.
  31702.       </P
  31703. ></LI
  31704. ></UL
  31705. >
  31706.     Here is an improved script:
  31707.     <TABLE
  31708. WIDTH="100%"
  31709. BORDER="0"
  31710. CELLPADDING="0"
  31711. CELLSPACING="0"
  31712. CLASS="EXAMPLE"
  31713. ><TR
  31714. ><TD
  31715. ><DIV
  31716. CLASS="example"
  31717. ><A
  31718. NAME="AEN5833"
  31719. ></A
  31720. ><P
  31721. ><B
  31722. >P°φklad 15-3. More secure file name checking</B
  31723. ></P
  31724. ><TABLE
  31725. BORDER="0"
  31726. BGCOLOR="#E0E0E0"
  31727. CELLPADDING="5"
  31728. ><TR
  31729. ><TD
  31730. ><PRE
  31731. CLASS="php"
  31732. ><?php
  31733. // removes a file from the hard drive that
  31734. // the PHP user has access to.
  31735. $username = $_SERVER['REMOTE_USER']; // using an authentication mechanisim
  31736.  
  31737. $homedir = "/home/$username";
  31738.  
  31739. $file_to_delete = basename("$userfile"); // strip paths
  31740. unlink ($homedir/$file_to_delete);
  31741.  
  31742. $fp = fopen("/home/logging/filedelete.log","+a"); //log the deletion
  31743. $logstring = "$username $homedir $file_to_delete";
  31744. fputs ($fp, $logstring);
  31745. fclose($fp);
  31746.  
  31747. echo "$file_to_delete has been deleted!";
  31748. ?></PRE
  31749. ></TD
  31750. ></TR
  31751. ></TABLE
  31752. ></DIV
  31753. ></TD
  31754. ></TR
  31755. ></TABLE
  31756. >
  31757.     However, even this is not without it's flaws. If your authentication
  31758.     system allowed users to create their own user logins, and a user
  31759.     chose the login "../etc/", the system is once again exposed. For
  31760.     this reason, you may prefer to write a more customized check:
  31761.     <TABLE
  31762. WIDTH="100%"
  31763. BORDER="0"
  31764. CELLPADDING="0"
  31765. CELLSPACING="0"
  31766. CLASS="EXAMPLE"
  31767. ><TR
  31768. ><TD
  31769. ><DIV
  31770. CLASS="example"
  31771. ><A
  31772. NAME="AEN5836"
  31773. ></A
  31774. ><P
  31775. ><B
  31776. >P°φklad 15-4. More secure file name checking</B
  31777. ></P
  31778. ><TABLE
  31779. BORDER="0"
  31780. BGCOLOR="#E0E0E0"
  31781. CELLPADDING="5"
  31782. ><TR
  31783. ><TD
  31784. ><PRE
  31785. CLASS="php"
  31786. ><?php
  31787. $username = $_SERVER['REMOTE_USER']; // using an authentication mechanisim
  31788. $homedir = "/home/$username";
  31789.  
  31790. if (!ereg('^[^./][^/]*$', $userfile))
  31791.      die('bad filename'); //die, do not process
  31792.  
  31793. if (!ereg('^[^./][^/]*$', $username))
  31794.      die('bad username'); //die, do not process
  31795. //etc...
  31796. ?></PRE
  31797. ></TD
  31798. ></TR
  31799. ></TABLE
  31800. ></DIV
  31801. ></TD
  31802. ></TR
  31803. ></TABLE
  31804. >
  31805.    </P
  31806. ><P
  31807. >     Depending on your operating system, there are a wide variety of files
  31808.     which you should be concerned about, including device entries (/dev/
  31809.     or COM1), configuration files (/etc/ files and the .ini files),
  31810.     well known file storage areas (/home/, My Documents), etc. For this
  31811.     reason, it's usually easier to create a policy where you forbid
  31812.     everything except for what you explicitly allow.
  31813.    </P
  31814. ></DIV
  31815. ><DIV
  31816. CLASS="sect1"
  31817. ><HR><H2
  31818. CLASS="sect1"
  31819. ><A
  31820. NAME="security.database"
  31821. ></A
  31822. >Database Security</H2
  31823. ><P
  31824. >     Nowadays, databases are cardinal components of any web based application by
  31825.     enabling websites to provide varying dynamic content. Since very sensitive
  31826.     or secret information can be stored in a database, you should strongly
  31827.     consider protecting your databases.
  31828.    </P
  31829. ><P
  31830. >     To retrieve or to store any information you need to connect to the database,
  31831.     send a legitimate query, fetch the result, and close the connection.
  31832.     Nowadays, the commonly used query language in this interaction is the
  31833.     Structured Query Language (SQL). See how an attacker can <A
  31834. HREF="#security.database.sql-injection"
  31835. >tamper with an SQL query</A
  31836. >.
  31837.    </P
  31838. ><P
  31839. >     As you can surmise, PHP cannot protect your database by itself. The
  31840.     following sections aim to be an introduction into the very basics of how to
  31841.     access and manipulate databases within PHP scripts.
  31842.    </P
  31843. ><P
  31844. >     Keep in mind this simple rule: defense in depth. The more places you
  31845.     take action to increase the protection of your database, the less
  31846.     probability of an attacker succeeding in exposing or abusing any stored
  31847.     information. Good design of the database schema and the application
  31848.     deals with your greatest fears.
  31849.    </P
  31850. ><DIV
  31851. CLASS="sect2"
  31852. ><HR><H3
  31853. CLASS="sect2"
  31854. ><A
  31855. NAME="security.database.design"
  31856. ></A
  31857. >Designing Databases</H3
  31858. ><P
  31859. >       The first step is always to create the database, unless you want to use
  31860.       one from a third party. When a database is created, it is
  31861.       assigned to an owner, who executed the creation statement. Usually, only
  31862.       the owner (or a superuser) can do anything with the objects in that
  31863.       database, and in order to allow other users to use it, privileges must be
  31864.       granted.
  31865.      </P
  31866. ><P
  31867. >       Applications should never connect to the database as its owner or a
  31868.       superuser, because these users can execute any query at will, for
  31869.       example, modifying the schema (e.g. dropping tables) or deleting its
  31870.       entire content.
  31871.      </P
  31872. ><P
  31873. >       You may create different database users for every aspect of your
  31874.       application with very limited rights to database objects. The most
  31875.       required privileges should be granted only, and avoid that the same user
  31876.       can interact with the database in different use cases. This means that if
  31877.       intruders gain access to your database using your applications credentials,
  31878.       they can only effect as many changes as your application can.
  31879.      </P
  31880. ><P
  31881. >       You are encouraged not to implement all the business logic in the web
  31882.       application (i.e. your script), instead do it in the database schema
  31883.       using views, triggers or rules. If the system evolves, new ports will be
  31884.       intended to open to the database, and you have to re-implement the logic
  31885.       in each separate database client. Over and above, triggers can be used
  31886.       to transparently and automatically handle fields, which often provides
  31887.       insight when debugging problems with your application or tracing back
  31888.       transactions.
  31889.      </P
  31890. ></DIV
  31891. ><DIV
  31892. CLASS="sect2"
  31893. ><HR><H3
  31894. CLASS="sect2"
  31895. ><A
  31896. NAME="security.database.connection"
  31897. ></A
  31898. >Connecting to Database</H3
  31899. ><P
  31900. >      You may want to estabilish the connections over SSL to encrypt
  31901.      client/server communications for increased security, or you can use ssh
  31902.      to encrypt the network connection between clients and the database server.
  31903.      If either of these is used, then monitoring your traffic and gaining
  31904.      information about your database will be difficult for a would-be attacker.
  31905.     </P
  31906. ></DIV
  31907. ><DIV
  31908. CLASS="sect2"
  31909. ><HR><H3
  31910. CLASS="sect2"
  31911. ><A
  31912. NAME="security.database.storage"
  31913. ></A
  31914. >Encrypted Storage Model</H3
  31915. ><P
  31916. >      SSL/SSH protects data travelling from the client to the server, SSL/SSH
  31917.      does not protect the persistent data stored in a database. SSL is an
  31918.      on-the-wire protocol.
  31919.     </P
  31920. ><P
  31921. >      Once an attacker gains access to your database directly (bypassing the
  31922.      webserver), the stored sensitive data may be exposed or misused, unless
  31923.      the information is protected by the database itself. Encrypting the data
  31924.      is a good way to mitigate this threat, but very few databases offer this
  31925.      type of data encryption.
  31926.     </P
  31927. ><P
  31928. >      The easiest way to work around this problem is to first create your own
  31929.      encryption package, and then use it from within your PHP scripts. PHP
  31930.      can assist you in this with several extensions, such as <A
  31931. HREF="#ref.mcrypt"
  31932. >Mcrypt</A
  31933. > and <A
  31934. HREF="#ref.mhash"
  31935. >Mhash</A
  31936. >, covering a wide variety of encryption
  31937.      algorithms. The script encrypts the data before inserting it into the database, and decrypts
  31938.      it when retrieving. See the references for further examples of how
  31939.      encryption works.
  31940.     </P
  31941. ><P
  31942. >      In case of truly hidden data, if its raw representation is not needed
  31943.      (i.e. not be displayed), hashing may also be taken into consideration.
  31944.      The well-known example for the hashing is storing the MD5 hash of a
  31945.      password in a database, instead of the password itself. See also
  31946.      <A
  31947. HREF="#function.crypt"
  31948. ><B
  31949. CLASS="function"
  31950. >crypt()</B
  31951. ></A
  31952. > and <A
  31953. HREF="#function.md5"
  31954. ><B
  31955. CLASS="function"
  31956. >md5()</B
  31957. ></A
  31958. >.
  31959.     </P
  31960. ><TABLE
  31961. WIDTH="100%"
  31962. BORDER="0"
  31963. CELLPADDING="0"
  31964. CELLSPACING="0"
  31965. CLASS="EXAMPLE"
  31966. ><TR
  31967. ><TD
  31968. ><DIV
  31969. CLASS="example"
  31970. ><A
  31971. NAME="AEN5866"
  31972. ></A
  31973. ><P
  31974. ><B
  31975. >P°φklad 15-5. Using hashed password field</B
  31976. ></P
  31977. ><TABLE
  31978. BORDER="0"
  31979. BGCOLOR="#E0E0E0"
  31980. CELLPADDING="5"
  31981. ><TR
  31982. ><TD
  31983. ><PRE
  31984. CLASS="php"
  31985. >// storing password hash
  31986. $query  = sprintf("INSERT INTO users(name,pwd) VALUES('%s','%s');",
  31987.             addslashes($username), md5($password));
  31988. $result = pg_exec($connection, $query);
  31989.  
  31990. // querying if user submitted the right password
  31991. $query = sprintf("SELECT 1 FROM users WHERE name='%s' AND pwd='%s';",
  31992.             addslashes($username), md5($password));
  31993. $result = pg_exec($connection, $query);
  31994.  
  31995. if (pg_numrows($result) > 0) {
  31996.     echo "Welcome, $username!";
  31997. }
  31998. else {
  31999.     echo "Authentication failed for $username.";
  32000. }</PRE
  32001. ></TD
  32002. ></TR
  32003. ></TABLE
  32004. ></DIV
  32005. ></TD
  32006. ></TR
  32007. ></TABLE
  32008. ></DIV
  32009. ><DIV
  32010. CLASS="sect2"
  32011. ><HR><H3
  32012. CLASS="sect2"
  32013. ><A
  32014. NAME="security.database.sql-injection"
  32015. ></A
  32016. >SQL Injection</H3
  32017. ><P
  32018. >      Many web developers are unaware of how SQL queries can be tampered with,
  32019.      and assume that an SQL query is a trusted command. It means that SQL
  32020.      queries are able to circumvent access controls, thereby bypassing standard
  32021.      authentication and authorization checks, and sometimes SQL queries even
  32022.      may allow access to host operating system level commands.
  32023.     </P
  32024. ><P
  32025. >      Direct SQL Command Injection is a technique where an attacker creates or
  32026.      alters existing SQL commands to expose hidden data, or to override valuable
  32027.      ones, or even to execute dangerous system level commands on the database
  32028.      host. This is accomplished by the application taking user input and
  32029.      combining it with static parameters to build a SQL query. The following
  32030.      examples are based on true stories, unfortunately.
  32031.     </P
  32032. ><P
  32033. >      Owing to the lack of input validation and connecting to the database on
  32034.      behalf of a superuser or the one who can create users, the attacker
  32035.      may create a superuser in your database.
  32036.      <TABLE
  32037. WIDTH="100%"
  32038. BORDER="0"
  32039. CELLPADDING="0"
  32040. CELLSPACING="0"
  32041. CLASS="EXAMPLE"
  32042. ><TR
  32043. ><TD
  32044. ><DIV
  32045. CLASS="example"
  32046. ><A
  32047. NAME="AEN5874"
  32048. ></A
  32049. ><P
  32050. ><B
  32051. >P°φklad 15-6. 
  32052.        Splitting the result set into pages ... and making superusers
  32053.        (PostgreSQL and MySQL)
  32054.       </B
  32055. ></P
  32056. ><TABLE
  32057. BORDER="0"
  32058. BGCOLOR="#E0E0E0"
  32059. CELLPADDING="5"
  32060. ><TR
  32061. ><TD
  32062. ><PRE
  32063. CLASS="php"
  32064. >$offset = argv[0]; // beware, no input validation!
  32065. $query  = "SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET $offset;";
  32066. // with PostgreSQL 
  32067. $result = pg_exec($conn, $query);
  32068. // with MySQL
  32069. $result = mysql_query($query);</PRE
  32070. ></TD
  32071. ></TR
  32072. ></TABLE
  32073. ></DIV
  32074. ></TD
  32075. ></TR
  32076. ></TABLE
  32077. >
  32078.       Normal users click on the 'next', 'prev' links where the <TT
  32079. CLASS="varname"
  32080. >$offset</TT
  32081. >
  32082.       is encoded into the URL. The script expects that the incoming
  32083.       <TT
  32084. CLASS="varname"
  32085. >$offset</TT
  32086. > is a decimal number. However, what if someone tries to
  32087.       break in by appending a <A
  32088. HREF="#function.urlencode"
  32089. ><B
  32090. CLASS="function"
  32091. >urlencode()</B
  32092. ></A
  32093. >'d form of the
  32094.       following to the URL 
  32095.       <DIV
  32096. CLASS="informalexample"
  32097. ><A
  32098. NAME="AEN5880"
  32099. ></A
  32100. ><P
  32101. ></P
  32102. ><TABLE
  32103. BORDER="0"
  32104. BGCOLOR="#E0E0E0"
  32105. CELLPADDING="5"
  32106. ><TR
  32107. ><TD
  32108. ><PRE
  32109. CLASS="programlisting"
  32110. >// in case of PostgreSQL
  32111. 0;
  32112. insert into pg_shadow(usename,usesysid,usesuper,usecatupd,passwd)
  32113.     select 'crack', usesysid, 't','t','crack'
  32114.     from pg_shadow where usename='postgres';
  32115. --
  32116.  
  32117. // in case of MySQL
  32118. 0;
  32119. UPDATE user SET Password=PASSWORD('crack') WHERE user='root';
  32120. FLUSH PRIVILEGES;</PRE
  32121. ></TD
  32122. ></TR
  32123. ></TABLE
  32124. ><P
  32125. ></P
  32126. ></DIV
  32127. >
  32128.       If it happened, then the script would present a superuser access to him.
  32129.       Note that <TT
  32130. CLASS="literal"
  32131. >0;</TT
  32132. > is to supply a valid offset to the
  32133.       original query and to terminate it.
  32134.     </P
  32135. ><DIV
  32136. CLASS="note"
  32137. ><BLOCKQUOTE
  32138. CLASS="note"
  32139. ><P
  32140. ><B
  32141. >Poznßmka: </B
  32142. >
  32143.       It is common technique to force the SQL parser to ignore the rest of the
  32144.       query written by the developer with <TT
  32145. CLASS="literal"
  32146. >--</TT
  32147. > which is the
  32148.       comment sign in SQL.
  32149.      </P
  32150. ></BLOCKQUOTE
  32151. ></DIV
  32152. ><P
  32153. >      A feasible way to gain passwords is to circumvent your search result pages.
  32154.      The only thing the attacker needs to do is to see if there are any submitted variables
  32155.      used in SQL statements which are not handled properly. These filters can be set
  32156.      commonly in a preceding form to customize <TT
  32157. CLASS="literal"
  32158. >WHERE, ORDER BY, 
  32159.      LIMIT</TT
  32160. > and <TT
  32161. CLASS="literal"
  32162. >OFFSET</TT
  32163. > clauses in <TT
  32164. CLASS="literal"
  32165. >SELECT</TT
  32166. >
  32167.      statements. If your database supports the <TT
  32168. CLASS="literal"
  32169. >UNION</TT
  32170. > construct, 
  32171.      the attacker may try to append an entire query to the original one to list 
  32172.      passwords from an arbitrary table. Using encrypted password fields is 
  32173.      strongly encouraged.
  32174.      <TABLE
  32175. WIDTH="100%"
  32176. BORDER="0"
  32177. CELLPADDING="0"
  32178. CELLSPACING="0"
  32179. CLASS="EXAMPLE"
  32180. ><TR
  32181. ><TD
  32182. ><DIV
  32183. CLASS="example"
  32184. ><A
  32185. NAME="AEN5891"
  32186. ></A
  32187. ><P
  32188. ><B
  32189. >P°φklad 15-7. 
  32190.        Listing out articles ... and some passwords (any database server)
  32191.       </B
  32192. ></P
  32193. ><TABLE
  32194. BORDER="0"
  32195. BGCOLOR="#E0E0E0"
  32196. CELLPADDING="5"
  32197. ><TR
  32198. ><TD
  32199. ><PRE
  32200. CLASS="php"
  32201. >$query  = "SELECT id, name, inserted, size FROM products
  32202.                   WHERE size = '$size'
  32203.                   ORDER BY $order LIMIT $limit, $offset;";
  32204. $result = odbc_exec($conn, $query);</PRE
  32205. ></TD
  32206. ></TR
  32207. ></TABLE
  32208. ></DIV
  32209. ></TD
  32210. ></TR
  32211. ></TABLE
  32212. >
  32213.      The static part of the query can be combined with another
  32214.      <TT
  32215. CLASS="literal"
  32216. >SELECT</TT
  32217. > statement which reveals all passwords:
  32218.      <DIV
  32219. CLASS="informalexample"
  32220. ><A
  32221. NAME="AEN5895"
  32222. ></A
  32223. ><P
  32224. ></P
  32225. ><TABLE
  32226. BORDER="0"
  32227. BGCOLOR="#E0E0E0"
  32228. CELLPADDING="5"
  32229. ><TR
  32230. ><TD
  32231. ><PRE
  32232. CLASS="programlisting"
  32233. >'
  32234. union select '1', concat(uname||'-'||passwd) as name, '1971-01-01', '0' from usertable;
  32235. --</PRE
  32236. ></TD
  32237. ></TR
  32238. ></TABLE
  32239. ><P
  32240. ></P
  32241. ></DIV
  32242. >
  32243.      If this query (playing with the <TT
  32244. CLASS="literal"
  32245. >'</TT
  32246. > and
  32247.      <TT
  32248. CLASS="literal"
  32249. >--</TT
  32250. >) were assigned to one of the variables used in
  32251.      <TT
  32252. CLASS="varname"
  32253. >$query</TT
  32254. >, the query beast awakened.
  32255.     </P
  32256. ><P
  32257. >      SQL UPDATE's are also susceptible to attack. These queries are
  32258.      also threatened by chopping and appending an entirely new query to it. But
  32259.      the attacker might fiddle with the <TT
  32260. CLASS="literal"
  32261. >SET</TT
  32262. > clause. In this
  32263.      case some schema information must be possessed to manipulate the query
  32264.      successfully. This can be acquired by examining the form variable names, or
  32265.      just simply brute forcing. There are not so many naming conventions for
  32266.      fields storing passwords or usernames.
  32267.      <TABLE
  32268. WIDTH="100%"
  32269. BORDER="0"
  32270. CELLPADDING="0"
  32271. CELLSPACING="0"
  32272. CLASS="EXAMPLE"
  32273. ><TR
  32274. ><TD
  32275. ><DIV
  32276. CLASS="example"
  32277. ><A
  32278. NAME="AEN5902"
  32279. ></A
  32280. ><P
  32281. ><B
  32282. >P°φklad 15-8. 
  32283.       From resetting a password ... to gaining more privileges (any database server)
  32284.      </B
  32285. ></P
  32286. ><TABLE
  32287. BORDER="0"
  32288. BGCOLOR="#E0E0E0"
  32289. CELLPADDING="5"
  32290. ><TR
  32291. ><TD
  32292. ><PRE
  32293. CLASS="php"
  32294. >$query = "UPDATE usertable SET pwd='$pwd' WHERE uid='$uid';";</PRE
  32295. ></TD
  32296. ></TR
  32297. ></TABLE
  32298. ></DIV
  32299. ></TD
  32300. ></TR
  32301. ></TABLE
  32302. >
  32303.      But a malicious user sumbits the value
  32304.      <TT
  32305. CLASS="literal"
  32306. >' or uid like'%admin%'; --</TT
  32307. > to <TT
  32308. CLASS="varname"
  32309. >$uid</TT
  32310. > to
  32311.      change the admin's password, or simply sets <TT
  32312. CLASS="varname"
  32313. >$pwd</TT
  32314. > to
  32315.      <TT
  32316. CLASS="literal"
  32317. >"hehehe', admin='yes', trusted=100 "</TT
  32318. > (with a trailing
  32319.      space) to gain more privileges. Then, the query will be twisted:
  32320.      <DIV
  32321. CLASS="informalexample"
  32322. ><A
  32323. NAME="AEN5909"
  32324. ></A
  32325. ><P
  32326. ></P
  32327. ><TABLE
  32328. BORDER="0"
  32329. BGCOLOR="#E0E0E0"
  32330. CELLPADDING="5"
  32331. ><TR
  32332. ><TD
  32333. ><PRE
  32334. CLASS="php"
  32335. >// $uid == ' or uid like'%admin%'; --
  32336. $query = "UPDATE usertable SET pwd='...' WHERE uid='' or uid like '%admin%'; --";
  32337.  
  32338. // $pwd == "hehehe', admin='yes', trusted=100 "
  32339. $query = "UPDATE usertable SET pwd='hehehe', admin='yes', trusted=100 WHERE ...;"</PRE
  32340. ></TD
  32341. ></TR
  32342. ></TABLE
  32343. ><P
  32344. ></P
  32345. ></DIV
  32346. >
  32347.     </P
  32348. ><P
  32349. >      A frightening example how operating system level commands can be accessed
  32350.      on some database hosts.
  32351.      <TABLE
  32352. WIDTH="100%"
  32353. BORDER="0"
  32354. CELLPADDING="0"
  32355. CELLSPACING="0"
  32356. CLASS="EXAMPLE"
  32357. ><TR
  32358. ><TD
  32359. ><DIV
  32360. CLASS="example"
  32361. ><A
  32362. NAME="AEN5912"
  32363. ></A
  32364. ><P
  32365. ><B
  32366. >P°φklad 15-9. Attacking the database hosts operating system (MSSQL Server)</B
  32367. ></P
  32368. ><TABLE
  32369. BORDER="0"
  32370. BGCOLOR="#E0E0E0"
  32371. CELLPADDING="5"
  32372. ><TR
  32373. ><TD
  32374. ><PRE
  32375. CLASS="php"
  32376. >$query  = "SELECT * FROM products WHERE id LIKE '%$prod%'";
  32377. $result = mssql_query($query);</PRE
  32378. ></TD
  32379. ></TR
  32380. ></TABLE
  32381. ></DIV
  32382. ></TD
  32383. ></TR
  32384. ></TABLE
  32385. >
  32386.      If attacker submits the value
  32387.      <TT
  32388. CLASS="literal"
  32389. >a%' exec master..xp_cmdshell 'net user test testpass /ADD' --</TT
  32390. >
  32391.      to <TT
  32392. CLASS="varname"
  32393. >$prod</TT
  32394. >, then the <TT
  32395. CLASS="varname"
  32396. >$query</TT
  32397. > will be:
  32398.      <DIV
  32399. CLASS="informalexample"
  32400. ><A
  32401. NAME="AEN5918"
  32402. ></A
  32403. ><P
  32404. ></P
  32405. ><TABLE
  32406. BORDER="0"
  32407. BGCOLOR="#E0E0E0"
  32408. CELLPADDING="5"
  32409. ><TR
  32410. ><TD
  32411. ><PRE
  32412. CLASS="php"
  32413. >$query  = "SELECT * FROM products
  32414.                     WHERE id LIKE '%a%'
  32415.                     exec master..xp_cmdshell 'net user test testpass /ADD'--";
  32416. $result = mssql_query($query);</PRE
  32417. ></TD
  32418. ></TR
  32419. ></TABLE
  32420. ><P
  32421. ></P
  32422. ></DIV
  32423. >
  32424.      MSSQL Server executes the SQL statements in the batch including a command
  32425.      to add a new user to the local accounts database. If this application
  32426.      were running as <TT
  32427. CLASS="literal"
  32428. >sa</TT
  32429. > and the MSSQLSERVER service is
  32430.      running with sufficient privileges, the attacker would now have an
  32431.      account with which to access this machine.
  32432.     </P
  32433. ><DIV
  32434. CLASS="note"
  32435. ><BLOCKQUOTE
  32436. CLASS="note"
  32437. ><P
  32438. ><B
  32439. >Poznßmka: </B
  32440. >
  32441.       Some of the examples above is tied to a specific database server. This
  32442.       does not mean that a similar attack is impossible against other products.
  32443.       Your database server may be similarly vulnerable in another manner.
  32444.      </P
  32445. ></BLOCKQUOTE
  32446. ></DIV
  32447. ><DIV
  32448. CLASS="sect3"
  32449. ><HR><H4
  32450. CLASS="sect3"
  32451. ><A
  32452. NAME="security.database.avoiding"
  32453. ></A
  32454. >Avoiding techniques</H4
  32455. ><P
  32456. >       You may plead that the attacker must possess a piece of information
  32457.       about the database schema in most examples. You are right, but you
  32458.       never know when and how it can be taken out, and if it happens,
  32459.       your database may be exposed. If you are using an open source, or
  32460.       publicly available database handling package, which may belong to a
  32461.       content management system or forum, the intruders easily produce
  32462.       a copy of a piece of your code. It may be also a security risk if it
  32463.       is a poorly designed one.
  32464.      </P
  32465. ><P
  32466. >       These attacks are mainly based on exploiting the code not being written
  32467.       with security in mind. Never trust any kind of input, especially that
  32468.       which comes from the client side, even though it comes from a select box,
  32469.       a hidden input field or a cookie. The first example shows that such a
  32470.       blameless query can cause disasters.
  32471.      </P
  32472. ><P
  32473. ></P
  32474. ><UL
  32475. ><LI
  32476. ><P
  32477. >         Never connect to the database as a superuser or as the database owner.
  32478.         Use always customized users with very limited privileges.
  32479.        </P
  32480. ></LI
  32481. ><LI
  32482. ><P
  32483. >         Check if the given input has the expected data type. PHP has
  32484.         a wide range of input validating functions, from the simplest ones
  32485.         found in <A
  32486. HREF="#ref.variables"
  32487. >Variable Functions</A
  32488. > and
  32489.         in <A
  32490. HREF="#ref.ctype"
  32491. >Character Type Functions</A
  32492. >
  32493.         (e.g. <A
  32494. HREF="#function.is-numeric"
  32495. ><B
  32496. CLASS="function"
  32497. >is_numeric()</B
  32498. ></A
  32499. >, <A
  32500. HREF="#function.ctype-digit"
  32501. ><B
  32502. CLASS="function"
  32503. >ctype_digit()</B
  32504. ></A
  32505. >
  32506.         respectively) and onwards to the
  32507.         <A
  32508. HREF="#ref.pcre"
  32509. >Perl compatible Regular Expressions</A
  32510. >
  32511.         support.
  32512.        </P
  32513. ></LI
  32514. ><LI
  32515. ><P
  32516. >         If the application waits for numerical input, consider verifying data
  32517.         with <A
  32518. HREF="#function.is-numeric"
  32519. ><B
  32520. CLASS="function"
  32521. >is_numeric()</B
  32522. ></A
  32523. >, or silently change its type
  32524.         using <A
  32525. HREF="#function.settype"
  32526. ><B
  32527. CLASS="function"
  32528. >settype()</B
  32529. ></A
  32530. >, or use its numeric representation
  32531.         by <A
  32532. HREF="#function.sprintf"
  32533. ><B
  32534. CLASS="function"
  32535. >sprintf()</B
  32536. ></A
  32537. >.
  32538.         <TABLE
  32539. WIDTH="100%"
  32540. BORDER="0"
  32541. CELLPADDING="0"
  32542. CELLSPACING="0"
  32543. CLASS="EXAMPLE"
  32544. ><TR
  32545. ><TD
  32546. ><DIV
  32547. CLASS="example"
  32548. ><A
  32549. NAME="AEN5942"
  32550. ></A
  32551. ><P
  32552. ><B
  32553. >P°φklad 15-10. A more secure way to compose a query for paging</B
  32554. ></P
  32555. ><TABLE
  32556. BORDER="0"
  32557. BGCOLOR="#E0E0E0"
  32558. CELLPADDING="5"
  32559. ><TR
  32560. ><TD
  32561. ><PRE
  32562. CLASS="php"
  32563. >settype($offset, 'integer');
  32564. $query = "SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET $offset;";
  32565.  
  32566. // please note %d in the format string, using %s would be meaningless
  32567. $query = sprintf("SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET %d;",
  32568.                  $offset);</PRE
  32569. ></TD
  32570. ></TR
  32571. ></TABLE
  32572. ></DIV
  32573. ></TD
  32574. ></TR
  32575. ></TABLE
  32576. >
  32577.        </P
  32578. ></LI
  32579. ><LI
  32580. ><P
  32581. >         Quote each non numeric user input which is passed to the database with
  32582.         <A
  32583. HREF="#function.addslashes"
  32584. ><B
  32585. CLASS="function"
  32586. >addslashes()</B
  32587. ></A
  32588. > or <A
  32589. HREF="#function.addcslashes"
  32590. ><B
  32591. CLASS="function"
  32592. >addcslashes()</B
  32593. ></A
  32594. >.
  32595.         See <A
  32596. HREF="#security.database.storage"
  32597. >the first example</A
  32598. >.
  32599.         As the examples shows, quotes burnt into the static part of the query
  32600.         is not enough, and can be easily cracked.
  32601.        </P
  32602. ></LI
  32603. ><LI
  32604. ><P
  32605. >         Do not print out any database specific information, especially
  32606.         about the schema, by fair means or foul. See also <A
  32607. HREF="#security.errors"
  32608. >Error Reporting</A
  32609. > and <A
  32610. HREF="#ref.errorfunc"
  32611. >Error Handling and Logging Functions</A
  32612. >.
  32613.        </P
  32614. ></LI
  32615. ><LI
  32616. ><P
  32617. >         You may use stored procedures and previously defined cursors to abstract
  32618.         data access so that users do not directly access tables or views, but
  32619.         this solution has another impacts.
  32620.        </P
  32621. ></LI
  32622. ></UL
  32623. ><P
  32624. >       Besides these, you benefit from logging queries either within your script
  32625.       or by the database itself, if it supports logging. Obviously, the logging is unable
  32626.       to prevent any harmful attempt, but it can be helpful to trace back which
  32627.       application has been circumvented. The log is not useful by itself, but
  32628.       through the information it contains. More detail is generally better than less.
  32629.      </P
  32630. ></DIV
  32631. ></DIV
  32632. ></DIV
  32633. ><DIV
  32634. CLASS="sect1"
  32635. ><HR><H2
  32636. CLASS="sect1"
  32637. ><A
  32638. NAME="security.errors"
  32639. ></A
  32640. >Error Reporting</H2
  32641. ><P
  32642. >     With PHP security, there are two sides to error reporting. One is
  32643.     beneficial to increasing security, the other is detrimental.
  32644.    </P
  32645. ><P
  32646. >     A standard attack tactic involves profiling a system by feeding
  32647.     it improper data, and checking for the kinds, and contexts, of the
  32648.     errors which are returned. This allows the system cracker to probe
  32649.     for information about the server, to determine possible weaknesses.
  32650.     For example, if an attacker had gleaned information about a page
  32651.     based on a prior form submission, they may attempt to override
  32652.     variables, or modify them:
  32653.     <TABLE
  32654. WIDTH="100%"
  32655. BORDER="0"
  32656. CELLPADDING="0"
  32657. CELLSPACING="0"
  32658. CLASS="EXAMPLE"
  32659. ><TR
  32660. ><TD
  32661. ><DIV
  32662. CLASS="example"
  32663. ><A
  32664. NAME="AEN5961"
  32665. ></A
  32666. ><P
  32667. ><B
  32668. >P°φklad 15-11. Attacking Variables with a custom HTML page</B
  32669. ></P
  32670. ><TABLE
  32671. BORDER="0"
  32672. BGCOLOR="#E0E0E0"
  32673. CELLPADDING="5"
  32674. ><TR
  32675. ><TD
  32676. ><PRE
  32677. CLASS="php"
  32678. ><form method="POST" action="attacktarget?username=badfoo&password=badfoo">
  32679. <input type="hidden" name="username" value="badfoo">
  32680. <input type="hidden" name="password" value="badfoo">
  32681. </form></PRE
  32682. ></TD
  32683. ></TR
  32684. ></TABLE
  32685. ></DIV
  32686. ></TD
  32687. ></TR
  32688. ></TABLE
  32689. >
  32690.    </P
  32691. ><P
  32692. >     The PHP errors which are normally returned can be quite helpful to a
  32693.     developer who is trying to debug a script, indicating such things
  32694.     as the function or file that failed, the PHP file it failed in,
  32695.     and the line number which the failure occured in. This is all
  32696.     information that can be exploited.  It is not uncommon for a php
  32697.     developer to use <A
  32698. HREF="#function.show-source"
  32699. ><B
  32700. CLASS="function"
  32701. >show_source()</B
  32702. ></A
  32703. >,
  32704.     <A
  32705. HREF="#function.highlight-string"
  32706. ><B
  32707. CLASS="function"
  32708. >highlight_string()</B
  32709. ></A
  32710. >, or
  32711.     <A
  32712. HREF="#function.highlight-file"
  32713. ><B
  32714. CLASS="function"
  32715. >highlight_file()</B
  32716. ></A
  32717. > as a debugging measure, but in
  32718.     a live site, this can expose hidden variables, unchecked syntax,
  32719.     and other dangerous information. Especially dangerous is running
  32720.     code from known sources with built-in debugging handlers, or using
  32721.     common debugging techniques. If the attacker can determine what
  32722.     general technique you are using, they may try to brute-force a page,
  32723.     by sending various common debugging strings:
  32724.     <TABLE
  32725. WIDTH="100%"
  32726. BORDER="0"
  32727. CELLPADDING="0"
  32728. CELLSPACING="0"
  32729. CLASS="EXAMPLE"
  32730. ><TR
  32731. ><TD
  32732. ><DIV
  32733. CLASS="example"
  32734. ><A
  32735. NAME="AEN5968"
  32736. ></A
  32737. ><P
  32738. ><B
  32739. >P°φklad 15-12. Exploiting common debugging variables</B
  32740. ></P
  32741. ><TABLE
  32742. BORDER="0"
  32743. BGCOLOR="#E0E0E0"
  32744. CELLPADDING="5"
  32745. ><TR
  32746. ><TD
  32747. ><PRE
  32748. CLASS="php"
  32749. ><form method="POST" action="attacktarget?errors=Y&amp;showerrors=1&amp;debug=1">
  32750. <input type="hidden" name="errors" value="Y">
  32751. <input type="hidden" name="showerrors" value="1">
  32752. <input type="hidden" name="debug" value="1">
  32753. </form></PRE
  32754. ></TD
  32755. ></TR
  32756. ></TABLE
  32757. ></DIV
  32758. ></TD
  32759. ></TR
  32760. ></TABLE
  32761. >
  32762.    </P
  32763. ><P
  32764. >     Regardless of the method of error handling, the ability to probe a
  32765.     system for errors leads to providing an attacker with more
  32766.     information.
  32767.    </P
  32768. ><P
  32769. >     For example, the very style of a generic PHP error indicates a system
  32770.     is running PHP. If the attacker was looking at an .html page, and
  32771.     wanted to probe for the back-end (to look for known weaknesses in
  32772.     the system), by feeding it the wrong data they may be able to
  32773.     determine that a system was built with PHP.
  32774.    </P
  32775. ><P
  32776. >     A function error can indicate whether a system may be running a
  32777.     specific database engine, or give clues as to how a web page or
  32778.     programmed or designed. This allows for deeper investigation into
  32779.     open database ports, or to look for specific bugs or weaknesses
  32780.     in a web page. By feeding different pieces of bad data, for example,
  32781.     an attacker can determine the order of authentication in a script,
  32782.     (from the line number errors) as well as probe for exploits that
  32783.     may be exploited in different locations in the script.
  32784.    </P
  32785. ><P
  32786. >     A filesystem or general PHP error can indicate what permissions
  32787.     the webserver has, as well as the structure and organization of
  32788.     files on the web server. Developer written error code can aggravate
  32789.     this problem, leading to easy exploitation of formerly "hidden"
  32790.     information.
  32791.    </P
  32792. ><P
  32793. >     There are three major solutions to this issue. The first is to
  32794.     scrutinize all functions, and attempt to compensate for the bulk
  32795.     of the errors. The second is to disable error reporting entirely
  32796.     on the running code. The third is to use PHP's custom error
  32797.     handling functions to create your own error handler. Depending
  32798.     on your security policy, you may find all three to be applicable
  32799.     to your situation.
  32800.    </P
  32801. ><P
  32802. >     One way of catching this issue ahead of time is to make use of
  32803.     PHP's own <A
  32804. HREF="#function.error-reporting"
  32805. ><B
  32806. CLASS="function"
  32807. >error_reporting()</B
  32808. ></A
  32809. >, to help you
  32810.     secure your code and find variable usage that may be dangerous.
  32811.     By testing your code, prior to deployment, with E_ALL, you can
  32812.     quickly find areas where your variables may be open to poisoning
  32813.     or modification in other ways. Once you are ready for deployment,
  32814.     by using E_NONE, you insulate your code from probing.
  32815.     <TABLE
  32816. WIDTH="100%"
  32817. BORDER="0"
  32818. CELLPADDING="0"
  32819. CELLSPACING="0"
  32820. CLASS="EXAMPLE"
  32821. ><TR
  32822. ><TD
  32823. ><DIV
  32824. CLASS="example"
  32825. ><A
  32826. NAME="AEN5978"
  32827. ></A
  32828. ><P
  32829. ><B
  32830. >P°φklad 15-13. Finding dangerous variables with E_ALL</B
  32831. ></P
  32832. ><TABLE
  32833. BORDER="0"
  32834. BGCOLOR="#E0E0E0"
  32835. CELLPADDING="5"
  32836. ><TR
  32837. ><TD
  32838. ><PRE
  32839. CLASS="php"
  32840. ><?php
  32841. if ($username) {  // Not initialized or checked before usage
  32842.     $good_login = 1;
  32843. }
  32844. if ($good_login == 1) { // If above test fails, not initialized or checked before usage
  32845.     readfile ("/highly/sensitive/data/index.html");
  32846. }
  32847. ?></PRE
  32848. ></TD
  32849. ></TR
  32850. ></TABLE
  32851. ></DIV
  32852. ></TD
  32853. ></TR
  32854. ></TABLE
  32855. >
  32856.    </P
  32857. ></DIV
  32858. ><DIV
  32859. CLASS="sect1"
  32860. ><HR><H2
  32861. CLASS="sect1"
  32862. ><A
  32863. NAME="security.registerglobals"
  32864. ></A
  32865. >Using Register Globals</H2
  32866. ><P
  32867. >     Perhaps the most controversial change in PHP is when the default value
  32868.     for the PHP directive <A
  32869. HREF="#ini.register-globals"
  32870. >     register_globals</A
  32871. > went from ON to OFF in PHP 
  32872.     <A
  32873. HREF="http://www.php.net/release_4_2_0.php"
  32874. TARGET="_top"
  32875. >4.2.0</A
  32876. >.  Reliance on this
  32877.     directive was quite common and many people didn't even know it existed
  32878.     and assumed it's just how PHP works.  This page will explain how one can
  32879.     write insecure code with this directive but keep in mind that the
  32880.     directive itself isn't insecure but rather it's the misuse of it.
  32881.    </P
  32882. ><P
  32883. >     When on, register_globals will inject (poison) your scripts will all
  32884.     sorts of variables, like request variables from HTML forms.  This
  32885.     coupled with the fact that PHP doesn't require variable initialization
  32886.     means writing insecure code is that much easier.  It was a difficult
  32887.     decision, but the PHP community decided to disable this directive by 
  32888.     default.  When on, people use variables yet really don't know for sure
  32889.     where they come from and can only assume.  Internal variables that are
  32890.     defined in the script itself get mixed up with request data sent by
  32891.     users and disabling register_globals changes this.  Let's demonstrate
  32892.     with an example misuse of register_globals: 
  32893.    </P
  32894. ><P
  32895. >     <TABLE
  32896. WIDTH="100%"
  32897. BORDER="0"
  32898. CELLPADDING="0"
  32899. CELLSPACING="0"
  32900. CLASS="EXAMPLE"
  32901. ><TR
  32902. ><TD
  32903. ><DIV
  32904. CLASS="example"
  32905. ><A
  32906. NAME="AEN5988"
  32907. ></A
  32908. ><P
  32909. ><B
  32910. >P°φklad 15-14. Example misuse with register_globals = on</B
  32911. ></P
  32912. ><TABLE
  32913. BORDER="0"
  32914. BGCOLOR="#E0E0E0"
  32915. CELLPADDING="5"
  32916. ><TR
  32917. ><TD
  32918. ><PRE
  32919. CLASS="php"
  32920. ><?php
  32921. // define $authorized = true only if user is authenticated
  32922. if (authenticated_user()) {
  32923.     $authorized = true;
  32924. }
  32925.  
  32926. // Because we didn't first initialize $authorized as false, this might be
  32927. // defined through register_globals, like from GET auth.php?authorized=1 
  32928. // So, anyone can be seen as authenticated!
  32929. if ($authorized) {
  32930.     include "/highly/sensitive/data.php";
  32931. }
  32932. ?></PRE
  32933. ></TD
  32934. ></TR
  32935. ></TABLE
  32936. ></DIV
  32937. ></TD
  32938. ></TR
  32939. ></TABLE
  32940. >
  32941.    </P
  32942. ><P
  32943. >     When register_globals = on, our logic above may be compromised.  When
  32944.     off, <TT
  32945. CLASS="varname"
  32946. >$authorized</TT
  32947. > can't be set via request so it'll
  32948.     be fine, although it really is generally a good programming practice to 
  32949.     initialize variables first.  For example, in our example above we might
  32950.     have first done <TT
  32951. CLASS="literal"
  32952. >$authorized = false</TT
  32953. >.  Doing this
  32954.     first means our above code would work with register_globals on or off as 
  32955.     users by default would be unauthorized.
  32956.    </P
  32957. ><P
  32958. >     Another example is that of <A
  32959. HREF="#ref.session"
  32960. >sessions</A
  32961. >.
  32962.     When register_globals = on, we could also use
  32963.     <TT
  32964. CLASS="varname"
  32965. >$username</TT
  32966. > in our example below but again you must
  32967.     realize that <TT
  32968. CLASS="varname"
  32969. >$username</TT
  32970. > could also come from other
  32971.     means, such as GET (through the URL).  
  32972.    </P
  32973. ><P
  32974. >     <TABLE
  32975. WIDTH="100%"
  32976. BORDER="0"
  32977. CELLPADDING="0"
  32978. CELLSPACING="0"
  32979. CLASS="EXAMPLE"
  32980. ><TR
  32981. ><TD
  32982. ><DIV
  32983. CLASS="example"
  32984. ><A
  32985. NAME="AEN5999"
  32986. ></A
  32987. ><P
  32988. ><B
  32989. >P°φklad 15-15. Example use of sessions with register_globals on or off</B
  32990. ></P
  32991. ><TABLE
  32992. BORDER="0"
  32993. BGCOLOR="#E0E0E0"
  32994. CELLPADDING="5"
  32995. ><TR
  32996. ><TD
  32997. ><PRE
  32998. CLASS="php"
  32999. ><?php
  33000. // We wouldn't know where $username came from but do know $_SESSION is 
  33001. // for session data 
  33002. if (isset($_SESSION['username'])) {
  33003.     
  33004.     echo "Hello <b>{$_SESSION['username']}</b>";
  33005.  
  33006. } else {
  33007.     
  33008.     echo "Hello <b>Guest</b><br />";
  33009.     echo "Would you like to login?";
  33010.  
  33011. }
  33012. ?></PRE
  33013. ></TD
  33014. ></TR
  33015. ></TABLE
  33016. ></DIV
  33017. ></TD
  33018. ></TR
  33019. ></TABLE
  33020. >
  33021.    </P
  33022. ><P
  33023. >     It's even possible to take preventative measures to warn when forging is
  33024.     being attempted. If you know ahead of time exactly where a variable
  33025.     should be coming from, you can check to see if the submitted data is
  33026.     coming from an inappropriate kind of submission.  While it doesn't
  33027.     guarantee that data has not been forged, it does require an attacker to
  33028.     guess the right kind of forging.  If you don't care where the request
  33029.     data comes from, you can use <TT
  33030. CLASS="varname"
  33031. >$_REQUEST</TT
  33032. > as it contains
  33033.     a mix of GET, POST and COOKIE data.  See also the manual section on
  33034.     using <A
  33035. HREF="#language.variables.external"
  33036. >variables from outside
  33037.     of PHP</A
  33038. >. 
  33039.    </P
  33040. ><P
  33041. >     <TABLE
  33042. WIDTH="100%"
  33043. BORDER="0"
  33044. CELLPADDING="0"
  33045. CELLSPACING="0"
  33046. CLASS="EXAMPLE"
  33047. ><TR
  33048. ><TD
  33049. ><DIV
  33050. CLASS="example"
  33051. ><A
  33052. NAME="AEN6006"
  33053. ></A
  33054. ><P
  33055. ><B
  33056. >P°φklad 15-16. Detecting simple variable poisoning</B
  33057. ></P
  33058. ><TABLE
  33059. BORDER="0"
  33060. BGCOLOR="#E0E0E0"
  33061. CELLPADDING="5"
  33062. ><TR
  33063. ><TD
  33064. ><PRE
  33065. CLASS="php"
  33066. ><?php
  33067. if (isset($_COOKIE['MAGIC_COOKIE'])) {
  33068.     
  33069.     // MAGIC_COOKIE comes from a cookie.
  33070.     // Be sure to validate the cookie data!
  33071.  
  33072. } elseif (isset($_GET['MAGIC_COOKIE']) || isset($_POST['MAGIC_COOKIE'])) {
  33073.    
  33074.    mail("admin@example.com", "Possible breakin attempt", $_SERVER['REMOTE_ADDR']);
  33075.    echo "Security violation, admin has been alerted.";
  33076.    exit;
  33077.  
  33078. } else {
  33079.    
  33080.    // MAGIC_COOKIE isn't set through this REQUEST
  33081.  
  33082. }
  33083. ?></PRE
  33084. ></TD
  33085. ></TR
  33086. ></TABLE
  33087. ></DIV
  33088. ></TD
  33089. ></TR
  33090. ></TABLE
  33091. >
  33092.    </P
  33093. ><P
  33094. >     Of course, simply turning off register_globals does not mean your code
  33095.     is secure.  For every piece of data that is submitted, it should also be
  33096.     checked in other ways.  Always validate your user data and initialize
  33097.     your variables!  To check for unitialized variables you may turn up
  33098.     <A
  33099. HREF="#function.error-reporting"
  33100. ><B
  33101. CLASS="function"
  33102. >error_reporting()</B
  33103. ></A
  33104. > to show
  33105.     <TT
  33106. CLASS="constant"
  33107. ><B
  33108. >E_NOTICE</B
  33109. ></TT
  33110. > level errors.
  33111.    </P
  33112. ><DIV
  33113. CLASS="note"
  33114. ><BLOCKQUOTE
  33115. CLASS="note"
  33116. ><P
  33117. ><B
  33118. >dostupnost superglobßlnφch prom∞nn²ch: </B
  33119. >Od PHP 4.1.0 jsou k dispozici superglobßlnφ pole jako <TT
  33120. CLASS="varname"
  33121. >$_GET
  33122. </TT
  33123. >, <TT
  33124. CLASS="varname"
  33125. >$_POST</TT
  33126. > a <TT
  33127. CLASS="varname"
  33128. >$_SERVER</TT
  33129. >.
  33130. Pro vφce informacφ viz Φßst manußlu o <A
  33131. HREF="#language.variables.predefined"
  33132. >superglobals</A
  33133. ></P
  33134. ></BLOCKQUOTE
  33135. ></DIV
  33136. ></DIV
  33137. ><DIV
  33138. CLASS="sect1"
  33139. ><HR><H2
  33140. CLASS="sect1"
  33141. ><A
  33142. NAME="security.variables"
  33143. ></A
  33144. >User Submitted Data</H2
  33145. ><P
  33146. >     The greatest weakness in many PHP programs is not inherent in the
  33147.     language itself, but merely an issue of code not being written with
  33148.     security in mind. For this reason, you should always take the time
  33149.     to consider the implications of a given piece of code, to ascertain
  33150.     the possible damage if an unexpected variable is submitted to it.
  33151.     <TABLE
  33152. WIDTH="100%"
  33153. BORDER="0"
  33154. CELLPADDING="0"
  33155. CELLSPACING="0"
  33156. CLASS="EXAMPLE"
  33157. ><TR
  33158. ><TD
  33159. ><DIV
  33160. CLASS="example"
  33161. ><A
  33162. NAME="AEN6022"
  33163. ></A
  33164. ><P
  33165. ><B
  33166. >P°φklad 15-17. Dangerous Variable Usage</B
  33167. ></P
  33168. ><TABLE
  33169. BORDER="0"
  33170. BGCOLOR="#E0E0E0"
  33171. CELLPADDING="5"
  33172. ><TR
  33173. ><TD
  33174. ><PRE
  33175. CLASS="php"
  33176. ><?php
  33177. // remove a file from the user's home directory... or maybe
  33178. // somebody else's?
  33179. unlink ($evil_var);
  33180.  
  33181. // Write logging of their access... or maybe an /etc/passwd entry?
  33182. fputs ($fp, $evil_var);
  33183.  
  33184. // Execute something trivial.. or rm -rf *?
  33185. system ($evil_var);
  33186. exec ($evil_var);
  33187.  
  33188. ?></PRE
  33189. ></TD
  33190. ></TR
  33191. ></TABLE
  33192. ></DIV
  33193. ></TD
  33194. ></TR
  33195. ></TABLE
  33196. >
  33197.     You should always carefully examine your code to make sure that any
  33198.     variables being submitted from a web browser are being properly
  33199.     checked, and ask yourself the following questions:
  33200.     <P
  33201. ></P
  33202. ><UL
  33203. ><LI
  33204. ><P
  33205. >        Will this script only affect the intended files?
  33206.       </P
  33207. ></LI
  33208. ><LI
  33209. ><P
  33210. >        Can unusual or undesirable data be acted upon?
  33211.       </P
  33212. ></LI
  33213. ><LI
  33214. ><P
  33215. >        Can this script be used in unintended ways?
  33216.       </P
  33217. ></LI
  33218. ><LI
  33219. ><P
  33220. >        Can this be used in conjunction with other scripts in a negative
  33221.        manner?
  33222.       </P
  33223. ></LI
  33224. ><LI
  33225. ><P
  33226. >        Will any transactions be adequately logged?
  33227.       </P
  33228. ></LI
  33229. ></UL
  33230. >
  33231.     By adequately asking these questions while writing the script,
  33232.     rather than later, you prevent an unfortunate re-write when you
  33233.     need to increase your security. By starting out with this mindset,
  33234.     you won't guarantee the security of your system, but you can help
  33235.     improve it.
  33236.    </P
  33237. ><P
  33238. >     You may also want to consider turning off register_globals,
  33239.     magic_quotes, or other convenience settings which may confuse
  33240.     you as to the validity, source, or value of a given variable.
  33241.     Working with PHP in error_reporting(E_ALL) mode can also help warn
  33242.     you about variables being used before they are checked or
  33243.     initialized (so you can prevent unusual data from being
  33244.     operated upon).
  33245.    </P
  33246. ></DIV
  33247. ><DIV
  33248. CLASS="sect1"
  33249. ><HR><H2
  33250. CLASS="sect1"
  33251. ><A
  33252. NAME="security.hiding"
  33253. ></A
  33254. >Hiding PHP</H2
  33255. ><P
  33256. >     In general, security by obscurity is one of the weakest forms of security.
  33257.     But in some cases, every little bit of extra security is desirable.
  33258.    </P
  33259. ><P
  33260. >     A few simple techniques can help to hide PHP, possibly slowing
  33261.     down an attacker who is attempting to discover weaknesses in your
  33262.     system. By setting expose_php = off in your <TT
  33263. CLASS="filename"
  33264. >php.ini</TT
  33265. > file, you
  33266.     reduce the amount of information available to them.
  33267.    </P
  33268. ><P
  33269. >     Another tactic is to configure web servers such as apache to
  33270.     parse different filetypes through PHP, either with an <TT
  33271. CLASS="filename"
  33272. >.htaccess</TT
  33273. >
  33274.     directive, or in the apache configuration file itself. You can
  33275.     then use misleading file extensions:
  33276.     <TABLE
  33277. WIDTH="100%"
  33278. BORDER="0"
  33279. CELLPADDING="0"
  33280. CELLSPACING="0"
  33281. CLASS="EXAMPLE"
  33282. ><TR
  33283. ><TD
  33284. ><DIV
  33285. CLASS="example"
  33286. ><A
  33287. NAME="AEN6044"
  33288. ></A
  33289. ><P
  33290. ><B
  33291. >P°φklad 15-18. Hiding PHP as another language</B
  33292. ></P
  33293. ><TABLE
  33294. BORDER="0"
  33295. BGCOLOR="#E0E0E0"
  33296. CELLPADDING="5"
  33297. ><TR
  33298. ><TD
  33299. ><PRE
  33300. CLASS="apache-conf"
  33301. ># Make PHP code look like other code types
  33302. AddType application/x-httpd-php .asp .py .pl</PRE
  33303. ></TD
  33304. ></TR
  33305. ></TABLE
  33306. ></DIV
  33307. ></TD
  33308. ></TR
  33309. ></TABLE
  33310. >
  33311.     Or obscure it completely:
  33312.     <TABLE
  33313. WIDTH="100%"
  33314. BORDER="0"
  33315. CELLPADDING="0"
  33316. CELLSPACING="0"
  33317. CLASS="EXAMPLE"
  33318. ><TR
  33319. ><TD
  33320. ><DIV
  33321. CLASS="example"
  33322. ><A
  33323. NAME="AEN6047"
  33324. ></A
  33325. ><P
  33326. ><B
  33327. >P°φklad 15-19. Using unknown types for PHP extensions</B
  33328. ></P
  33329. ><TABLE
  33330. BORDER="0"
  33331. BGCOLOR="#E0E0E0"
  33332. CELLPADDING="5"
  33333. ><TR
  33334. ><TD
  33335. ><PRE
  33336. CLASS="apache-conf"
  33337. ># Make PHP code look like unknown types
  33338. AddType application/x-httpd-php .bop .foo .133t</PRE
  33339. ></TD
  33340. ></TR
  33341. ></TABLE
  33342. ></DIV
  33343. ></TD
  33344. ></TR
  33345. ></TABLE
  33346. >
  33347.     Or hide it as HTML code, which has a slight performance hit because
  33348.     all HTML will be parsed through the PHP engine:
  33349.     <TABLE
  33350. WIDTH="100%"
  33351. BORDER="0"
  33352. CELLPADDING="0"
  33353. CELLSPACING="0"
  33354. CLASS="EXAMPLE"
  33355. ><TR
  33356. ><TD
  33357. ><DIV
  33358. CLASS="example"
  33359. ><A
  33360. NAME="AEN6050"
  33361. ></A
  33362. ><P
  33363. ><B
  33364. >P°φklad 15-20. Using HTML types for PHP extensions</B
  33365. ></P
  33366. ><TABLE
  33367. BORDER="0"
  33368. BGCOLOR="#E0E0E0"
  33369. CELLPADDING="5"
  33370. ><TR
  33371. ><TD
  33372. ><PRE
  33373. CLASS="apache-conf"
  33374. ># Make all PHP code look like HTML
  33375. AddType application/x-httpd-php .htm .html</PRE
  33376. ></TD
  33377. ></TR
  33378. ></TABLE
  33379. ></DIV
  33380. ></TD
  33381. ></TR
  33382. ></TABLE
  33383. >
  33384.     For this to work effectively, you must rename your PHP files with
  33385.     the above extensions. While it is a form of security through
  33386.     obscurity, it's a minor preventative measure with few drawbacks.
  33387.    </P
  33388. ></DIV
  33389. ><DIV
  33390. CLASS="sect1"
  33391. ><HR><H2
  33392. CLASS="sect1"
  33393. ><A
  33394. NAME="security.current"
  33395. ></A
  33396. >Keeping Current</H2
  33397. ><P
  33398. >     PHP, like any other large system, is under constant scrutiny and
  33399.     improvement. Each new version will often include both major and
  33400.     minor changes to enhance and repair security flaws, configuration
  33401.     mishaps, and other issues that will affect the overall security
  33402.     and stability of your system.
  33403.    </P
  33404. ><P
  33405. >     Like other system-level scripting languages and programs, the best
  33406.     approach is to update often, and maintain awareness of the latest
  33407.     versions and their changes.
  33408.    </P
  33409. ></DIV
  33410. ></DIV
  33411. ></DIV
  33412. ><DIV
  33413. CLASS="PART"
  33414. ><A
  33415. NAME="features"
  33416. ></A
  33417. ><DIV
  33418. CLASS="TITLEPAGE"
  33419. ><H1
  33420. CLASS="title"
  33421. >IV. Vlastnosti</H1
  33422. ><DIV
  33423. CLASS="TOC"
  33424. ><DL
  33425. ><DT
  33426. ><B
  33427. >Obsah</B
  33428. ></DT
  33429. ><DT
  33430. >16. <A
  33431. HREF="#features.http-auth"
  33432. >HTTP autentikace a PHP</A
  33433. ></DT
  33434. ><DT
  33435. >17. <A
  33436. HREF="#features.cookies"
  33437. >Cookies</A
  33438. ></DT
  33439. ><DT
  33440. >18. <A
  33441. HREF="#features.file-upload"
  33442. >Zpracovßnφ uploadu soubor∙</A
  33443. ></DT
  33444. ><DT
  33445. >19. <A
  33446. HREF="#features.remote-files"
  33447. >Pou╛itφ vzdßlen²ch soubor∙</A
  33448. ></DT
  33449. ><DT
  33450. >20. <A
  33451. HREF="#features.connection-handling"
  33452. >Obsluha spojenφ</A
  33453. ></DT
  33454. ><DT
  33455. >21. <A
  33456. HREF="#features.persistent-connections"
  33457. >Persistentnφ databßzovß spojenφ</A
  33458. ></DT
  33459. ><DT
  33460. >22. <A
  33461. HREF="#features.safe-mode"
  33462. >BezpeΦn² re╛im</A
  33463. ></DT
  33464. ><DT
  33465. >23. <A
  33466. HREF="#features.commandline"
  33467. >Pou╛itφ PHP z p°φkazovΘ °ßdky</A
  33468. ></DT
  33469. ></DL
  33470. ></DIV
  33471. ></DIV
  33472. ><DIV
  33473. CLASS="chapter"
  33474. ><HR><H1
  33475. ><A
  33476. NAME="features.http-auth"
  33477. >Kapitola 16. HTTP autentikace a PHP</A
  33478. ></H1
  33479. ><P
  33480. >   Prost°edky HTTP autentikace jsou v PHP p°φstupnΘ pouze pokud PHP b∞╛φ jako
  33481.   modul Apache, tudφ╛ nejsou p°φstupnΘ v CGI verzi. V PHP skriptu b∞╛φcφm pod
  33482.   modulem Apache lze pou╛φt funkci <A
  33483. HREF="#function.header"
  33484. ><B
  33485. CLASS="function"
  33486. >header()</B
  33487. ></A
  33488. > k odeslßnφ
  33489.   zprßvy "Authentication Required" klientskΘmu browseru, co╛ vyvolß zobrazenφ
  33490.   dialogovΘho okna pro vlo╛enφ u╛ivatelskΘho jmΘna a hesla. Jakmile u╛ivatel
  33491.   zadß jmΘno a heslo, URL obsahujφcφ tento PHP skript se zavolß znovu s
  33492.   prom∞nn²mi $PHP_AUTH_USER, $PHP_AUTH_PW and $PHP_AUTH_TYPE obsahujφcφmi
  33493.   jmΘno, heslo a typ autentikace. V souΦasnosti je podporovßna pouze "Basic"
  33494.   autentikace. Vφce informacφ viz funkce <A
  33495. HREF="#function.header"
  33496. ><B
  33497. CLASS="function"
  33498. >header()</B
  33499. ></A
  33500. >.
  33501.   </P
  33502. ><P
  33503. >   Nßsledujφcφ fragment k≤du m∙╛e poslou╛it jako ukßzka vy╛ßdßnφ autentikace
  33504.   u╛ivatele na strßnce:
  33505.  
  33506.    <TABLE
  33507. WIDTH="100%"
  33508. BORDER="0"
  33509. CELLPADDING="0"
  33510. CELLSPACING="0"
  33511. CLASS="EXAMPLE"
  33512. ><TR
  33513. ><TD
  33514. ><DIV
  33515. CLASS="example"
  33516. ><A
  33517. NAME="AEN6065"
  33518. ></A
  33519. ><P
  33520. ><B
  33521. >P°φklad 16-1. Ukßzka HTTP Autentikace</B
  33522. ></P
  33523. ><TABLE
  33524. BORDER="0"
  33525. BGCOLOR="#E0E0E0"
  33526. CELLPADDING="5"
  33527. ><TR
  33528. ><TD
  33529. ><PRE
  33530. CLASS="php"
  33531. ><?php
  33532.   if(!isset($PHP_AUTH_USER)) {
  33533.     Header("WWW-Authenticate: Basic realm=\"My Realm\"");
  33534.     Header("HTTP/1.0 401 Unauthorized");
  33535.     echo "Text, kter² se ode╣le, pokud u╛ivatel zmßΦkne tlaΦφtko Cancel\n";
  33536.     exit;
  33537.   } else {
  33538.     echo "Ahoj $PHP_AUTH_USER.<P>";
  33539.     echo "Jako heslo jsi zadal $PHP_AUTH_PW.<P>";
  33540.   }
  33541. ?></PRE
  33542. ></TD
  33543. ></TR
  33544. ></TABLE
  33545. ></DIV
  33546. ></TD
  33547. ></TR
  33548. ></TABLE
  33549. ></P
  33550. ><P
  33551. >   Mφsto protΘho vyti╣t∞nφ $PHP_AUTH_USER a $PHP_AUTH_PW byste asi
  33552.   cht∞li ov∞°it platnost zadanΘho jmΘna a hesla. Nap°φklad dotazem
  33553.   v databßzi nebo vyhledßnφm u╛ivatele v dbm souboru.
  33554.   </P
  33555. ><P
  33556. >   Pozor na chybovΘ browsery Internet Explorer. Zdß se, ╛e jsou velice
  33557.   vybφravΘ, pokud jde o po°adφ hlaviΦek. Zdß se, ╛e odeslßnφ hlaviΦky
  33558.   <SPAN
  33559. CLASS="emphasis"
  33560. ><I
  33561. CLASS="emphasis"
  33562. >WWW-Authenticate</I
  33563. ></SPAN
  33564. > p°ed hlaviΦkou
  33565.   <SPAN
  33566. CLASS="errorcode"
  33567. >HTTP/1.0 401</SPAN
  33568. > zabφrß.
  33569.   </P
  33570. ><P
  33571. >   Aby se zabrßnilo psanφ skript∙ odhalujφcφch hesla na strßnkßch
  33572.   autentikovan²ch n∞kter²m z tradiΦnφch externφch mechanism∙, PHP_AUTH
  33573.   prom∞nnΘ se nevytvo°φ, pokud je pro tu kterou strßnku zapnuta externφ
  33574.   autentikace. V takovΘm p°φpad∞ m∙╛ete k identifikaci extern∞
  33575.   autentikovanΘho u╛ivatele pou╛φt prom∞nnou $REMOTE_USER.
  33576.   </P
  33577. ><P
  33578. >   V╣imn∞te si nicmΘn∞, ╛e v²╣e uvedenΘ nezabrßnφ krßde╛φm hesel z
  33579.   autentikovan²ch URL osobou, kterß ovlßdß neautentikovanou URL na stejnΘm
  33580.   serveru.
  33581.   </P
  33582. ><P
  33583. >   Jak Netscape, tak Internet Explorer po p°ijetφ response k≤du 401 vyprßzdnφ
  33584.   autentikaΦnφ cache souΦasnΘho realmu. Tak m∙╛ete u╛ivatele v podstat∞
  33585.   "odlogovat". N∞kte°φ lidΘ toho vyu╛φvajφ k "vypr╣enφ" p°ihlß╣enφ nebo
  33586.   tvorb∞ odhla╣ovacφho tlaΦφtka.
  33587.   </P
  33588. ><P
  33589. ></P
  33590. ><TABLE
  33591. WIDTH="100%"
  33592. BORDER="0"
  33593. CELLPADDING="0"
  33594. CELLSPACING="0"
  33595. CLASS="EXAMPLE"
  33596. ><TR
  33597. ><TD
  33598. ><DIV
  33599. CLASS="example"
  33600. ><A
  33601. NAME="AEN6076"
  33602. ></A
  33603. ><P
  33604. ><B
  33605. >P°φklad 16-2. Ukßzka HTTP autentikace vy╛adujφcφ novΘ jmΘno a heslo</B
  33606. ></P
  33607. ><TABLE
  33608. BORDER="0"
  33609. BGCOLOR="#E0E0E0"
  33610. CELLPADDING="5"
  33611. ><TR
  33612. ><TD
  33613. ><PRE
  33614. CLASS="php"
  33615. ><?php
  33616.   function authenticate() {
  33617.     Header( "WWW-Authenticate: Basic realm=\"Test Authentication System\"");
  33618.     Header( "HTTP/1.0 401 Unauthorized");
  33619.     echo "K p°φstupu na tento zdroj musφte zadat platnΘ ID a heslo\n";
  33620.     exit;
  33621.   }
  33622.  
  33623.   if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER)) ) {
  33624.    authenticate();
  33625.   }
  33626.   else {
  33627.    echo "Welcome: $PHP_AUTH_USER<BR>";
  33628.    echo "Old: $OldAuth";
  33629.    echo "<FORM ACTION=\"$PHP_SELF\" METHOD=POST>\n";
  33630.    echo "<INPUT TYPE=HIDDEN NAME=\"SeenBefore\" VALUE=\"1\">\n";
  33631.    echo "<INPUT TYPE=HIDDEN NAME=\"OldAuth\" VALUE=\"$PHP_AUTH_USER\">\n";
  33632.    echo "<INPUT TYPE=Submit VALUE=\"Re Authenticate\">\n";
  33633.    echo "</FORM>\n";
  33634.   }
  33635. ?></PRE
  33636. ></TD
  33637. ></TR
  33638. ></TABLE
  33639. ></DIV
  33640. ></TD
  33641. ></TR
  33642. ></TABLE
  33643. ><P
  33644. >   Podle standardu HTTP Basic authentication se toto chovßnφ nevy╛aduje, tak╛e
  33645.   byste na to nikdy nem∞li spolΘhat. Pokusy s Lynxem ukßzaly, ╛e Lynx po p°ijetφ
  33646.   response k≤du 401 nevyprßzdnφ autentikaΦnφ ·daje, tak╛e po stisknutφ back a
  33647.   forward se znovu ukß╛e po╛adovan² zdroj (pokud se nezm∞nily po╛adavky na
  33648.   ·daje).
  33649.   </P
  33650. ><P
  33651. >   Dßle si v╣imn∞te, ╛e tato vlastnost p°i pou╛itφ IIS serveru a CGI verze PHP
  33652.   dφky omezenφm IIS nefunguje.
  33653.   </P
  33654. ></DIV
  33655. ><DIV
  33656. CLASS="chapter"
  33657. ><HR><H1
  33658. ><A
  33659. NAME="features.cookies"
  33660. >Kapitola 17. Cookies</A
  33661. ></H1
  33662. ><P
  33663. >   PHP transparentn∞ podporuje HTTP cookies. Cookies jsou mechanismem na
  33664.   uklßdßnφ dat ve vzdßlenΘm browseru a tudφ╛ sledovßnφ nebo identifikaci
  33665.   vracejφcφch se u╛ivatel∙. Cookies m∙╛ete nastavovat pomocφ funkce
  33666.   <A
  33667. HREF="#function.setcookie"
  33668. ><B
  33669. CLASS="function"
  33670. >setcookie()</B
  33671. ></A
  33672. >. Cookies jsou souΦßstφ HTTP hlaviΦky,
  33673.   tudφ╛ <A
  33674. HREF="#function.setcookie"
  33675. ><B
  33676. CLASS="function"
  33677. >setcookie()</B
  33678. ></A
  33679. > se musφ volat p°ed odeslßnφm v²stupu
  33680.   do browseru. To je stejnΘ omezenφ, jako mß funkce <A
  33681. HREF="#function.header"
  33682. ><B
  33683. CLASS="function"
  33684. >header()</B
  33685. ></A
  33686. >.
  33687.   </P
  33688. ><P
  33689. >   V╣echny cookies p°ijatΘ od klienta se automaticky stßvajφ PHP prom∞nnou
  33690.   stejn∞ jako u GET a POST dat. Pokud chcete p°i°adit jednomu cookie vφce
  33691.   hodnot, p°idejte <SPAN
  33692. CLASS="emphasis"
  33693. ><I
  33694. CLASS="emphasis"
  33695. >[]</I
  33696. ></SPAN
  33697. > na konec jmΘna cookie. Vφce
  33698.   detail∙ viz funkce <A
  33699. HREF="#function.setcookie"
  33700. ><B
  33701. CLASS="function"
  33702. >setcookie()</B
  33703. ></A
  33704. >.</P
  33705. ></DIV
  33706. ><DIV
  33707. CLASS="chapter"
  33708. ><HR><H1
  33709. ><A
  33710. NAME="features.file-upload"
  33711. >Kapitola 18. Zpracovßnφ uploadu soubor∙</A
  33712. ></H1
  33713. ><DIV
  33714. CLASS="sect1"
  33715. ><H2
  33716. CLASS="sect1"
  33717. ><A
  33718. NAME="features.file-upload.post-method"
  33719. ></A
  33720. >Uploading metodou POST</H2
  33721. ><P
  33722. >     PHP umo╛≥uje zpracovßnφ uploadu soubor∙ z jakΘhokoli prohlφ╛eΦe
  33723.     vyhovujφcφho RFC-1867 (co╛ zahrnuje mj. Netscape Navigator 3 a pozd∞j╣φ,
  33724.     Microsoft Internet Explorer 3 se zßplatou od Microsoftu, nebo pozd∞j╣φ
  33725.     bez zßplaty).  Tato schopnost umo╛≥uje lidem uploadovat textovΘ i
  33726.     binßrnφ soubory. S autentizacφ poskytovanou PHP a s funkcemi pro manipulaci
  33727.     se soubory mßte plnou kontrolu nad tφm, kdo smφ uploadovat a co se mß
  33728.     ud∞lat s uploadovan²m souborem.    
  33729.    </P
  33730. ><P
  33731. >     Nezapome≥te, ╛e PHP podporuje takΘ uploady metodou PUT tak, jak se pou╛φvß
  33732.     v Netscape Composeru a v editoru Amaya od W3C. Pro bli╛╣φ detaily viz
  33733.     <A
  33734. HREF="#features.file-upload.put-method"
  33735. >Podpora metody PUT</A
  33736. >.
  33737.    </P
  33738. ><P
  33739. >     Obrazovka pro upload souboru m∙╛e b²t tvo°ena specißlnφm formulß°em, kter²
  33740.     vypadß podobn∞ jako tento:    
  33741.     <TABLE
  33742. WIDTH="100%"
  33743. BORDER="0"
  33744. CELLPADDING="0"
  33745. CELLSPACING="0"
  33746. CLASS="EXAMPLE"
  33747. ><TR
  33748. ><TD
  33749. ><DIV
  33750. CLASS="example"
  33751. ><A
  33752. NAME="AEN6098"
  33753. ></A
  33754. ><P
  33755. ><B
  33756. >P°φklad 18-1. Formulß° pro upload souboru</B
  33757. ></P
  33758. ><TABLE
  33759. BORDER="0"
  33760. BGCOLOR="#E0E0E0"
  33761. CELLPADDING="5"
  33762. ><TR
  33763. ><TD
  33764. ><PRE
  33765. CLASS="html"
  33766. ><form enctype="multipart/form-data" action="_URL_" method="post">
  33767. <input type="hidden" name="MAX_FILE_SIZE" value="1000">
  33768. Send this file: <input name="userfile" type="file">
  33769. <input type="submit" value="Send File">
  33770. </form></PRE
  33771. ></TD
  33772. ></TR
  33773. ></TABLE
  33774. ></DIV
  33775. ></TD
  33776. ></TR
  33777. ></TABLE
  33778. >
  33779.     _URL_ by m∞lo oznaΦovat PHP soubor. SkrytΘ pole MAX_FILE_SIZE musφ
  33780.     p°edchßzet pole pro vlo╛enφ souboru a jeho hodnota specifikuje maximßlnφ
  33781.     akceptovanou velikost souboru. Hodnota je v bytech.    
  33782.     <DIV
  33783. CLASS="warning"
  33784. ><P
  33785. ></P
  33786. ><TABLE
  33787. CLASS="warning"
  33788. BORDER="1"
  33789. WIDTH="100%"
  33790. ><TR
  33791. ><TD
  33792. ALIGN="CENTER"
  33793. ><B
  33794. >Varovßnφ</B
  33795. ></TD
  33796. ></TR
  33797. ><TR
  33798. ><TD
  33799. ALIGN="LEFT"
  33800. ><P
  33801. >       Hodnota MAX_FILE_SIZE je z hlediska prohlφ╛eΦe pouze informativnφ.
  33802.       Je snadnΘ ji obejφt. Tak╛e nepoΦφtejte s tφm, ╛e prohlφ╛eΦ se bude
  33803.       chovat tak, jak si p°ejete. Nastavenφ maximßlnφ velikosti v PHP v╣ak
  33804.       samoz°ejm∞ nem∙╛e b²t obelst∞no.       
  33805.      </P
  33806. ></TD
  33807. ></TR
  33808. ></TABLE
  33809. ></DIV
  33810. >
  33811.    </P
  33812. ><P
  33813. >     Prom∞nnΘ definovanΘ pro uploadovanΘ soubory se li╣φ v zßvislosti na
  33814.     verzi a konfiguraci PHP. Pokud je aktivnφ volba
  33815.     <A
  33816. HREF="#ini.track-vars"
  33817. >track_vars</A
  33818. >, bude inicializovßno pole
  33819.     $HTTP_POST_FILES/$_FILES. KoneΦn∞, souvisejφcφ prom∞nnΘ mohou b²t
  33820.     inicializovßny jako globßlnφ, pokud je zapnuta volba    
  33821.     <A
  33822. HREF="#ini.register-globals"
  33823. >register_globals</A
  33824. >.
  33825.     Ov╣em pou╛φvßnφ globßlnφch prom∞nn²ch nenφ doporuΦeno.
  33826.     Po ·sp∞╣nΘm uploadu budou v cφlovΘm skriptu definovßny nßsledujφcφ
  33827.     prom∞nnΘ:    
  33828.    </P
  33829. ><DIV
  33830. CLASS="note"
  33831. ><BLOCKQUOTE
  33832. CLASS="note"
  33833. ><P
  33834. ><B
  33835. >Poznßmka: </B
  33836. >
  33837.      <A
  33838. HREF="#ini.track-vars"
  33839. >track_vars</A
  33840. > je od PHP 4.0.3
  33841.     v╛dy zapnuto. U PHP 4.1.0 a pozd∞j╣φch m∙╛e b²t pou╛ito $_FILES
  33842.     namφsto <TT
  33843. CLASS="varname"
  33844. >$HTTP_POST_FILES</TT
  33845. >. <TT
  33846. CLASS="varname"
  33847. >$_FILES</TT
  33848. >
  33849.     je v╛dy globßlnφ prom∞nnß, tak╛e by se nem∞la pou╛φvat specifikace
  33850.     <TT
  33851. CLASS="literal"
  33852. >global</TT
  33853. > pro prom∞nnou $_FILES.
  33854.     </P
  33855. ></BLOCKQUOTE
  33856. ></DIV
  33857. ><P
  33858. >     <TT
  33859. CLASS="varname"
  33860. >$HTTP_POST_FILES</TT
  33861. >/<TT
  33862. CLASS="varname"
  33863. >$_FILES</TT
  33864. >
  33865.     obsahuje informace o uploadovanΘm souboru.     
  33866.    </P
  33867. ><P
  33868. >     Obsah <TT
  33869. CLASS="varname"
  33870. >$HTTP_POST_FILES</TT
  33871. > je takov²to (uv∞domte si, ╛e
  33872.     se p°edpoklßdß pou╛itφ nßzvu uploadovanΘho souboru 'userfile' tak,    
  33873.     jako v p°φkladu v²╣e):
  33874.     <P
  33875. ></P
  33876. ><DIV
  33877. CLASS="variablelist"
  33878. ><DL
  33879. ><DT
  33880. ><TT
  33881. CLASS="varname"
  33882. >$HTTP_POST_FILES['userfile']['name']</TT
  33883. ></DT
  33884. ><DD
  33885. ><P
  33886. >         Originßlnφ nßzev souboru na klientskΘm poΦφtaΦi.
  33887.        </P
  33888. ></DD
  33889. ><DT
  33890. ><TT
  33891. CLASS="varname"
  33892. >$HTTP_POST_FILES['userfile']['type']</TT
  33893. ></DT
  33894. ><DD
  33895. ><P
  33896. >         MIME typ souboru, pokud prohlφ╛eΦ tuto informaci poskytuje
  33897.     (nap°. <TT
  33898. CLASS="literal"
  33899. >"image/gif"</TT
  33900. >).
  33901.         </P
  33902. ></DD
  33903. ><DT
  33904. ><TT
  33905. CLASS="varname"
  33906. >$HTTP_POST_FILES['userfile']['size']</TT
  33907. ></DT
  33908. ><DD
  33909. ><P
  33910. >         Velikost uploadovanΘho souboru v bytech.
  33911.        </P
  33912. ></DD
  33913. ><DT
  33914. ><TT
  33915. CLASS="varname"
  33916. >$HTTP_POST_FILES['userfile']['tmp_name']</TT
  33917. ></DT
  33918. ><DD
  33919. ><P
  33920. >         DoΦasn² nßzev souboru, pod nφm╛ byl uploadovan² soubor ulo╛en na server.
  33921.        </P
  33922. ></DD
  33923. ></DL
  33924. ></DIV
  33925. >
  33926.    </P
  33927. ><DIV
  33928. CLASS="note"
  33929. ><BLOCKQUOTE
  33930. CLASS="note"
  33931. ><P
  33932. ><B
  33933. >Poznßmka: </B
  33934. >
  33935.      PHP 4.1.0 a pozd∞j╣φ podporujφ zkrßcen² nßzev prom∞nnΘ
  33936.      <TT
  33937. CLASS="varname"
  33938. >$_FILES</TT
  33939. >. PHP 3 nepodporuje
  33940.      <TT
  33941. CLASS="varname"
  33942. >$HTTP_POST_FILES</TT
  33943. >.
  33944.     </P
  33945. ></BLOCKQUOTE
  33946. ></DIV
  33947. ><P
  33948. >     Obsah prom∞nnßch v situaci, kdy je prom∞nnß
  33949.     <A
  33950. HREF="#ini.register-globals"
  33951. >register_globals</A
  33952. >
  33953.     zapnuta nastavenφm v souboru <TT
  33954. CLASS="filename"
  33955. >php.ini</TT
  33956. > (uv∞domte si, ╛e
  33957.     se p°edpoklßdß pou╛itφ nßzvu uploadovanΘho souboru 'userfile' tak,    
  33958.     jako v p°φkladu v²╣e):
  33959.  
  33960.     <P
  33961. ></P
  33962. ><UL
  33963. ><LI
  33964. ><P
  33965. >        <TT
  33966. CLASS="varname"
  33967. >$userfile</TT
  33968. > - DoΦasn² nßzev souboru, pod kter²m byl
  33969.        uploadovan² soubor ulo╛en na server.
  33970.       </P
  33971. ></LI
  33972. ><LI
  33973. ><P
  33974. >        <TT
  33975. CLASS="varname"
  33976. >$userfile_name</TT
  33977. > - Originßlnφ nßzev souboru nebo cesta
  33978.        na odesφlajφcφm systΘmu.
  33979.       </P
  33980. ></LI
  33981. ><LI
  33982. ><P
  33983. >        <TT
  33984. CLASS="varname"
  33985. >$userfile_size</TT
  33986. > - Velikost uploadovanΘho souboru
  33987.        v bytech.
  33988.       </P
  33989. ></LI
  33990. ><LI
  33991. ><P
  33992. >        <TT
  33993. CLASS="varname"
  33994. >$userfile_type</TT
  33995. > - MIME typ souboru, pokud prohlφ╛eΦ
  33996.        tuto informaci poskytuje (nap°. "image/gif").
  33997.       </P
  33998. ></LI
  33999. ></UL
  34000. >
  34001.     Uv∞domte si, ╛e prom∞nnß "<TT
  34002. CLASS="varname"
  34003. >$userfile</TT
  34004. >" ve skuteΦnosti
  34005.     p°edstavuje nßzev pole <input> se specifikacφ type="file" ve
  34006.     formulß°i. Pro v²╣e uveden² p°φklad jsme zvolili nßzev "userfile".
  34007.    </P
  34008. ><DIV
  34009. CLASS="note"
  34010. ><BLOCKQUOTE
  34011. CLASS="note"
  34012. ><P
  34013. ><B
  34014. >Poznßmka: </B
  34015. >
  34016.      Nastavenφ <TT
  34017. CLASS="literal"
  34018. >register_globals = On</TT
  34019. > se nedoporuΦuje z
  34020.      bezpeΦnostnφch a v²konnostnφch d∙vod∙.     
  34021.     </P
  34022. ></BLOCKQUOTE
  34023. ></DIV
  34024. ><P
  34025. >     Soubory se implicitn∞ uklßdajφ do systΘmovΘho adresß°e pro doΦasnΘ
  34026.     soubory, pokud nebylo direktivou
  34027.     <A
  34028. HREF="#ini.upload-tmp-dir"
  34029. >upload_tmp_dir</A
  34030. > v souboru
  34031.     <TT
  34032. CLASS="filename"
  34033. >php.ini</TT
  34034. > stanoveno jinak. SystΘmov² adresß° pro
  34035.     doΦasnΘ soubory m∙╛e b²t zm∞n∞n nastavenφ prom∞nnΘ prost°edφ
  34036.     <TT
  34037. CLASS="envar"
  34038. >TMPDIR</TT
  34039. > v prost°edφ, kde PHP b∞╛φ. Nastavenφ za pou╛itφ
  34040.     <A
  34041. HREF="#function.putenv"
  34042. ><B
  34043. CLASS="function"
  34044. >putenv()</B
  34045. ></A
  34046. > z PHP skriptu nebude fungovat. Tato
  34047.     prom∞nnß prost°edφ m∙╛e b²t takΘ pou╛ita k uji╣t∞nφ se, ╛e v╣echny
  34048.     ostatnφ operace pracujφ s uploadovan²mi soubory.    
  34049.     <TABLE
  34050. WIDTH="100%"
  34051. BORDER="0"
  34052. CELLPADDING="0"
  34053. CELLSPACING="0"
  34054. CLASS="EXAMPLE"
  34055. ><TR
  34056. ><TD
  34057. ><DIV
  34058. CLASS="example"
  34059. ><A
  34060. NAME="AEN6168"
  34061. ></A
  34062. ><P
  34063. ><B
  34064. >P°φklad 18-2. Ov∞°ovßnφ uploadu souboru</B
  34065. ></P
  34066. ><P
  34067. >       Nßsledujφcφ p°φklady jsou pro verze PHP 4 vy╣╣φ ne╛ PHP 4.0.2.
  34068.       (viz funkce
  34069.       <A
  34070. HREF="#function.is-uploaded-file"
  34071. ><B
  34072. CLASS="function"
  34073. >is_uploaded_file()</B
  34074. ></A
  34075. > a
  34076.       <A
  34077. HREF="#function.move-uploaded-file"
  34078. ><B
  34079. CLASS="function"
  34080. >move_uploaded_file()</B
  34081. ></A
  34082. >).
  34083.      </P
  34084. ><TABLE
  34085. BORDER="0"
  34086. BGCOLOR="#E0E0E0"
  34087. CELLPADDING="5"
  34088. ><TR
  34089. ><TD
  34090. ><PRE
  34091. CLASS="php"
  34092. ><?php 
  34093. // V PHP 4.1.0 a pozd∞j╣φch by m∞lo b²t pou╛ito $_FILES namφsto $HTTP_POST_FILES.
  34094. if (is_uploaded_file($HTTP_POST_FILES['userfile']['tmp_name'])) {
  34095.     copy($HTTP_POST_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file");
  34096. } else {
  34097.     echo "Possible file upload attack. Filename: " . $HTTP_POST_FILES['userfile']['name'];
  34098. }
  34099. /* ...or... */
  34100. move_uploaded_file($HTTP_POST_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file");
  34101. ?></PRE
  34102. ></TD
  34103. ></TR
  34104. ></TABLE
  34105. ></DIV
  34106. ></TD
  34107. ></TR
  34108. ></TABLE
  34109. >
  34110.    </P
  34111. ><P
  34112. >     PHP skript, kter² p°ijφmß uploadovanΘ soubory, by m∞l implementovat
  34113.     ve╣kerou logiku pro stanovenφ, co by se m∞lo ud∞lat s uploadovan²m
  34114.     souborem. M∙╛ete nap°. pou╛φt prom∞nnou
  34115.     <TT
  34116. CLASS="varname"
  34117. >$HTTP_POST_FILES['userfile']['size']</TT
  34118. > pro zahozenφ
  34119.     soubor∙, kterΘ jsou p°φli╣ malΘ nebo velkΘ. Mohli byste pou╛φt takΘ
  34120.     prom∞nnou <TT
  34121. CLASS="varname"
  34122. >$HTTP_POST_FILES['userfile']['type']</TT
  34123. >
  34124.     pro filtraci soubor∙ podle MIME datovΘho typu. Bez ohledu na °e╣enφ,
  34125.     soubor by m∞l b²t smazßn nebo p°esunut jinam.    
  34126.    </P
  34127. ><P
  34128. >     Soubor bude automaticky smazßn z doΦasnΘho adresß°e na konci skriptu,
  34129.     pokud nebyl p°esunut jinam nebo p°ejmenovßn.    
  34130.    </P
  34131. ></DIV
  34132. ><DIV
  34133. CLASS="sect1"
  34134. ><HR><H2
  34135. CLASS="sect1"
  34136. ><A
  34137. NAME="features.file-upload.common-pitfalls"
  34138. ></A
  34139. >╚astß ·skalφ</H2
  34140. ><P
  34141. >     <TT
  34142. CLASS="literal"
  34143. >MAX_FILE_SIZE</TT
  34144. > nem∙╛e specifikovat velikost souboru
  34145.     v∞t╣φ ne╛ je ta, kterß byla nastavena pomocφ
  34146.     <A
  34147. HREF="#ini.upload-max-filesize"
  34148. >upload_max_filesize</A
  34149. >
  34150.     v konfiguraci PHP. Implicitn∞ jsou to 2 MB.    
  34151.    </P
  34152. ><P
  34153. >     Pokud je zapnut limit pam∞ti, m∙╛e b²t pot°eba v∞t╣φ hodnota
  34154.     <A
  34155. HREF="#ini.memory-limit"
  34156. >memory_limit</A
  34157. >. Ujist∞te se, ╛e
  34158.     je hodnota <A
  34159. HREF="#ini.memory-limit"
  34160. >memory_limit</A
  34161. >
  34162.     dostateΦn∞ velkß.
  34163.    </P
  34164. ><P
  34165. >     Pokud je nastavenß hodnota <TT
  34166. CLASS="literal"
  34167. >max_execution_time</TT
  34168. > p°φli╣
  34169.     malß, doba provßd∞nφ skriptu ji m∙╛e p°ekroΦit. Ujist∞te se, ╛e je
  34170.     hodnota <TT
  34171. CLASS="literal"
  34172. >max_execution_time</TT
  34173. > dostateΦn∞ velkß.
  34174.    </P
  34175. ><P
  34176. >     Pokud je nastavenß hodnota <TT
  34177. CLASS="literal"
  34178. >post_max_size</TT
  34179. > p°φli╣ malß,
  34180.     nem∙╛e b²t uploadovßn v∞t╣φ soubor. Ujist∞te se, ╛e je hodnota
  34181.     <TT
  34182. CLASS="literal"
  34183. >post_max_size</TT
  34184. > dostateΦn∞ velkß.
  34185.    </P
  34186. ><P
  34187. >     Neov∞°ovßnφ, se kter²m souborem se pracuje, m∙╛e znamenat, ╛e se u╛ivatelΘ
  34188.     mohou dostat k citliv²m informacφm v jin²ch adresß°φch.
  34189.    </P
  34190. ><P
  34191. >     Uv∞domte si prosφm, ╛e server CERN httpd odstra≥uje v╣echno, co poΦφnaje
  34192.     prvnφ bφlou mezerou (whitespace) v MIME hlaviΦce Content-Type
  34193.     obdr╛φ od klienta. Za existence tohoto jevu nebude CERN httpd podporovat
  34194.     uploading soubor∙.    
  34195.    </P
  34196. ></DIV
  34197. ><DIV
  34198. CLASS="sect1"
  34199. ><HR><H2
  34200. CLASS="sect1"
  34201. ><A
  34202. NAME="features.file-upload.multiple"
  34203. ></A
  34204. >Uploading vφce soubor∙</H2
  34205. ><P
  34206. >     Vφce soubor∙ m∙╛e b²t uploadovßnφ za pou╛itφ r∙zn²ch nßzv∙
  34207.     <TT
  34208. CLASS="literal"
  34209. >name</TT
  34210. > pro souborovΘ pole <TT
  34211. CLASS="literal"
  34212. >input</TT
  34213. >.
  34214.    </P
  34215. ><P
  34216. >     Je takΘ mo╛nΘ uploadovat vφce soubor∙ souΦasn∞ a nechat informace
  34217.     automaticky zorganizovat v polφch. V takovΘm p°φpad∞ je t°eba
  34218.     pou╛φt stejnou syntaxi v HTML formulß°i jako pro vφcenßsobnΘ v²b∞ry
  34219.     a za╣krtßvacφ polφΦka (checkboxy).    
  34220.    </P
  34221. ><DIV
  34222. CLASS="note"
  34223. ><BLOCKQUOTE
  34224. CLASS="note"
  34225. ><P
  34226. ><B
  34227. >Poznßmka: </B
  34228. >
  34229.      Podpora pro upload vφce soubor∙ byla p°idßna ve verzi 3.0.10.
  34230.     </P
  34231. ></BLOCKQUOTE
  34232. ></DIV
  34233. ><P
  34234. >     <TABLE
  34235. WIDTH="100%"
  34236. BORDER="0"
  34237. CELLPADDING="0"
  34238. CELLSPACING="0"
  34239. CLASS="EXAMPLE"
  34240. ><TR
  34241. ><TD
  34242. ><DIV
  34243. CLASS="example"
  34244. ><A
  34245. NAME="AEN6203"
  34246. ></A
  34247. ><P
  34248. ><B
  34249. >P°φklad 18-3. Uploading vφce soubor∙</B
  34250. ></P
  34251. ><TABLE
  34252. BORDER="0"
  34253. BGCOLOR="#E0E0E0"
  34254. CELLPADDING="5"
  34255. ><TR
  34256. ><TD
  34257. ><PRE
  34258. CLASS="html"
  34259. ><form action="file-upload.php" method="post" enctype="multipart/form-data">
  34260.   Send these files:<br>
  34261.   <input name="userfile[]" type="file"><br>
  34262.   <input name="userfile[]" type="file"><br>
  34263.   <input type="submit" value="Send files">
  34264. </form></PRE
  34265. ></TD
  34266. ></TR
  34267. ></TABLE
  34268. ></DIV
  34269. ></TD
  34270. ></TR
  34271. ></TABLE
  34272. >
  34273.    </P
  34274. ><P
  34275. >     Pokud je v²╣e uveden² formulß° odeslßn, pole    
  34276.     <TT
  34277. CLASS="varname"
  34278. >$HTTP_POST_FILES['userfile']</TT
  34279. >,
  34280.     <TT
  34281. CLASS="varname"
  34282. >$HTTP_POST_FILES['userfile']['name']</TT
  34283. >, a
  34284.     <TT
  34285. CLASS="varname"
  34286. >$HTTP_POST_FILES['userfile']['size']</TT
  34287. > budou
  34288.     inicializovßna (jak $_FILES v PHP 4.1.0 a pozd∞j╣φm, tak
  34289.     $HTTP_POST_VARS v PHP 3. Pokud je nastavenφ
  34290.     <TT
  34291. CLASS="literal"
  34292. >register_globals</TT
  34293. > aktivnφ globßlnφ prom∞nnΘ pro
  34294.     uploadovanΘ soubory jsou takΘ inicializovßny). Ka╛dΘ z nich bude
  34295.     Φφseln∞ indexovanΘ pole odpovφdajφcφch hodnot pro odeslanΘ soubory.    
  34296.    </P
  34297. ><P
  34298. >     Kup°φkladu p°edpoklßdejme, ╛e se posφlajφ soubory s nßzvy
  34299.     <TT
  34300. CLASS="filename"
  34301. >/home/test/review.html</TT
  34302. > a
  34303.     <TT
  34304. CLASS="filename"
  34305. >/home/test/xwp.out</TT
  34306. >. V tom p°φpad∞ by
  34307.     <TT
  34308. CLASS="varname"
  34309. >$HTTP_POST_FILES['userfile']['name'][0]</TT
  34310. > obsahovalo
  34311.     hodnotu <TT
  34312. CLASS="filename"
  34313. >review.html</TT
  34314. > a
  34315.     <TT
  34316. CLASS="varname"
  34317. >$HTTP_POST_FILES['userfile']['name'][1]</TT
  34318. > hodnotu
  34319.     <TT
  34320. CLASS="filename"
  34321. >xwp.out</TT
  34322. >. Podobn∞
  34323.     <TT
  34324. CLASS="varname"
  34325. >$HTTP_POST_FILES['userfile']['size'][0]</TT
  34326. > by obsahovalo
  34327.     velikost <TT
  34328. CLASS="filename"
  34329. >review.html</TT
  34330. > atd.
  34331.    </P
  34332. ><P
  34333. >     <TT
  34334. CLASS="varname"
  34335. >$HTTP_POST_FILES['userfile']['name'][0]</TT
  34336. >,
  34337.     <TT
  34338. CLASS="varname"
  34339. >$HTTP_POST_FILES['userfile']['tmp_name'][0]</TT
  34340. >,
  34341.     <TT
  34342. CLASS="varname"
  34343. >$HTTP_POST_FILES['userfile']['size'][0]</TT
  34344. > a
  34345.     <TT
  34346. CLASS="varname"
  34347. >$HTTP_POST_FILES['userfile']['type'][0]</TT
  34348. > budou
  34349.     rovn∞╛ nastaveny.
  34350.    </P
  34351. ></DIV
  34352. ><DIV
  34353. CLASS="sect1"
  34354. ><HR><H2
  34355. CLASS="sect1"
  34356. ><A
  34357. NAME="features.file-upload.put-method"
  34358. ></A
  34359. >Podpora metody PUT</H2
  34360. ><P
  34361. >     PHP poskytuje podporu pro HTTP PUT metodu pou╛φvanou klienty jako
  34362.     Netscape Composer nebo W3C Amaya. Po╛adavky s metodou PUT jsou mnohem
  34363.     jednodu╣╣φ ne╛ upload soubor∙ a vypadajφ p°ibli╛n∞ takto:    
  34364.     <DIV
  34365. CLASS="informalexample"
  34366. ><A
  34367. NAME="AEN6228"
  34368. ></A
  34369. ><P
  34370. ></P
  34371. ><TABLE
  34372. BORDER="0"
  34373. BGCOLOR="#E0E0E0"
  34374. CELLPADDING="5"
  34375. ><TR
  34376. ><TD
  34377. ><PRE
  34378. CLASS="programlisting"
  34379. >PUT /path/filename.html HTTP/1.1</PRE
  34380. ></TD
  34381. ></TR
  34382. ></TABLE
  34383. ><P
  34384. ></P
  34385. ></DIV
  34386. >
  34387.    </P
  34388. ><P
  34389. >     Toto by normßln∞ znamenalo, ╛e by cht∞l klient ulo╛it obsah, kter²
  34390.     nßsleduje za nßzvem /path/filename.html, do svΘho webovΘho stromu.
  34391.     To samoz°ejm∞ nenφ dobr² nßpad, aby Apache nebo PHP automaticky
  34392.     nechal kohokoli p°epsat jakΘkoli soubory ve strom∞. Tak╛e, 
  34393.     pro zpracovßnφ takovΘho po╛adavku je t°eba nejd°φv °ici va╣emu
  34394.     WWW serveru, ╛e chcete po╛adavek zpracovßvat konkrΘtnφm PHP skriptem.
  34395.     U serveru Apache se to provede direktivou    
  34396.     <SPAN
  34397. CLASS="emphasis"
  34398. ><I
  34399. CLASS="emphasis"
  34400. >Script</I
  34401. ></SPAN
  34402. >. M∙╛e b²t umφst∞na kdekoli v konfiguraΦnφm
  34403.     souboru Apache. ╚ast²mi mφsty jsou bloky <Directory> a 
  34404.     <Virtualhost>. Pou╛ije se k tomu °ßdek podobn² tomuto:
  34405.     <DIV
  34406. CLASS="informalexample"
  34407. ><A
  34408. NAME="AEN6232"
  34409. ></A
  34410. ><P
  34411. ></P
  34412. ><TABLE
  34413. BORDER="0"
  34414. BGCOLOR="#E0E0E0"
  34415. CELLPADDING="5"
  34416. ><TR
  34417. ><TD
  34418. ><PRE
  34419. CLASS="programlisting"
  34420. >Skript PUT /put.php</PRE
  34421. ></TD
  34422. ></TR
  34423. ></TABLE
  34424. ><P
  34425. ></P
  34426. ></DIV
  34427. >
  34428.    </P
  34429. ><P
  34430. >     Toto °ekne serveru Apache, aby v╣echny PUT po╛adavky na n∞jak² URI
  34431.     vyhovujφcφ kontextu posφlal skriptu put.php. To pochopiteln∞ p°edpoklßdß,
  34432.     ╛e mßte povoleno PHP pro p°φponu .php a PHP je aktivnφ.     
  34433.    </P
  34434. ><P
  34435. >     V souboru put.php byste potom mohli napsat n∞co jako:
  34436.    </P
  34437. ><P
  34438. >     <DIV
  34439. CLASS="informalexample"
  34440. ><A
  34441. NAME="AEN6237"
  34442. ></A
  34443. ><P
  34444. ></P
  34445. ><TABLE
  34446. BORDER="0"
  34447. BGCOLOR="#E0E0E0"
  34448. CELLPADDING="5"
  34449. ><TR
  34450. ><TD
  34451. ><PRE
  34452. CLASS="php"
  34453. ><?php copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); ?></PRE
  34454. ></TD
  34455. ></TR
  34456. ></TABLE
  34457. ><P
  34458. ></P
  34459. ></DIV
  34460. >
  34461.    </P
  34462. ><P
  34463. >     Toto by m∞lo zkopφrovat soubor na mφsto po╛adovanΘ vzdßlen²m klientem.
  34464.     Pravd∞podobn∞ byste cht∞li provΘst n∞jakß ov∞°enφ a/nebo autentizace
  34465.     u╛ivatele p°ed provedenφm tohoto zkopφrovßnφ. Jedin²m pou╛iteln²m trikem
  34466.     je, ╛e PHP ulo╛φ p°enesen² soubor do doΦasnΘho adresß°e podobn∞, jako
  34467.     p°i pou╛itφ
  34468.     <A
  34469. HREF="#features.file-upload.post-method"
  34470. >metody POST</A
  34471. >.
  34472.     A╛ skript skonΦφ, doΦasn² soubor bude odstran∞n. Tak╛e vß╣ PHP skipt
  34473.     pro zpracovßnφ PUT po╛adavk∙ musφ soubor zkopφrovat jinam. Nßzev souboru
  34474.     v doΦasnΘm umφst∞nφ je ulo╛en v prom∞nnΘ $PHP_PUT_FILENAME a po╛adovan²
  34475.     nßzev cφlovΘho souboru v prom∞nnΘ $REQUEST_URI (m∙╛e se li╣it u server∙
  34476.     jin²ch ne╛ Apache).  Toto cφlovΘ jmΘno je to jedinΘ, co klient
  34477.     specifikoval. Nemusφte ho poslechnout. Mohli byste, nap°φklad, kopφrovat
  34478.     v╣echny uploadovanΘ soubory do specißlnφho uploadovΘho adresß°e.    
  34479.    </P
  34480. ></DIV
  34481. ></DIV
  34482. ><DIV
  34483. CLASS="chapter"
  34484. ><HR><H1
  34485. ><A
  34486. NAME="features.remote-files"
  34487. >Kapitola 19. Pou╛itφ vzdßlen²ch soubor∙</A
  34488. ></H1
  34489. ><P
  34490. >   Pokud p°i konfiguraci PHP aktivujete podporu "URL fopen wrapper"
  34491.   (standardn∞ je zapnutß, leda╛e pro configure explicitn∞ zadßte
  34492.   <TT
  34493. CLASS="option"
  34494. >--disable-url-fopen-wrapper</TT
  34495. > p°φznak (verze do 4.0.3),
  34496.   nebo (u nov∞j╣φch verzφ) nastavφte <TT
  34497. CLASS="parameter"
  34498. ><I
  34499. >allow_url_fopen</I
  34500. ></TT
  34501. > v
  34502.   php.ini na off), m∙╛ete ve volßnφch v∞t╣iny funkcφ, kterΘ oΦekßvajφ
  34503.   jako argument nßzev souboru (vΦetn∞ <A
  34504. HREF="#function.require"
  34505. ><B
  34506. CLASS="function"
  34507. >require()</B
  34508. ></A
  34509. > a
  34510.   <A
  34511. HREF="#function.include"
  34512. ><B
  34513. CLASS="function"
  34514. >include()</B
  34515. ></A
  34516. >) uvΘst HTTP nebo FTP URL.
  34517.   </P
  34518. ><P
  34519. >    <DIV
  34520. CLASS="note"
  34521. ><BLOCKQUOTE
  34522. CLASS="note"
  34523. ><P
  34524. ><B
  34525. >Poznßmka: </B
  34526. >
  34527.     Na Windows nelze pou╛φvat vzdßlenΘ soubory v
  34528.     <A
  34529. HREF="#function.include"
  34530. ><B
  34531. CLASS="function"
  34532. >include()</B
  34533. ></A
  34534. > a <A
  34535. HREF="#function.require"
  34536. ><B
  34537. CLASS="function"
  34538. >require()</B
  34539. ></A
  34540. > v²razech.
  34541.     </P
  34542. ></BLOCKQUOTE
  34543. ></DIV
  34544. >
  34545.   </P
  34546. ><P
  34547. >   M∙╛ete nap°φklad otev°φt soubor na vzdßlenΘm web serveru, vyseparovat z
  34548.   v²stupu data, kterß pot°ebujete, a tato data potom pou╛φt v dotazu na
  34549.   databßzi, nebo je prost∞ zaΦlenit do v²stupu stylem odpovφdajφcφm zbytku
  34550.   va╣φ web site.
  34551.   </P
  34552. ><P
  34553. >    <TABLE
  34554. WIDTH="100%"
  34555. BORDER="0"
  34556. CELLPADDING="0"
  34557. CELLSPACING="0"
  34558. CLASS="EXAMPLE"
  34559. ><TR
  34560. ><TD
  34561. ><DIV
  34562. CLASS="example"
  34563. ><A
  34564. NAME="AEN6255"
  34565. ></A
  34566. ><P
  34567. ><B
  34568. >P°φklad 19-1. Zφskßnφ nßzvu vzdßlenΘ strßnky</B
  34569. ></P
  34570. ><TABLE
  34571. BORDER="0"
  34572. BGCOLOR="#E0E0E0"
  34573. CELLPADDING="5"
  34574. ><TR
  34575. ><TD
  34576. ><PRE
  34577. CLASS="php"
  34578. ><?php
  34579. $file = fopen ("http://www.php.net/", "r");
  34580. if (!$file) {
  34581.     echo "<p>Nelze otev°φt vzdßlen² soubor.\n";
  34582.     exit;
  34583. }
  34584. while (!feof ($file)) {
  34585.     $line = fgets ($file, 1024);
  34586.     /* Toto bude fungovat pouze pokud jsou tagy a nßzev na jednΘ °ßdce */
  34587.     if (eregi ("<title>(.*)</title>", $line, $out)) {
  34588.         $title = $out[1];
  34589.         break;
  34590.     }
  34591. }
  34592. fclose($file);
  34593. ?></PRE
  34594. ></TD
  34595. ></TR
  34596. ></TABLE
  34597. ></DIV
  34598. ></TD
  34599. ></TR
  34600. ></TABLE
  34601. >
  34602.   </P
  34603. ><P
  34604. >   Pokud se p°ipojφte jako u╛ivatel s dostateΦn²mi prßvy, a dan² soubor u╛
  34605.   neexistuje, m∙╛ete data takΘ uklßdat po FTP. Pokud se chcete p°ipojit jako
  34606.   jin² u╛ivatel ne╛ 'anonymous', musφte v URL udat u╛ivatelskΘ jmΘno (a
  34607.   pravd∞podobn∞ i heslo), nap°.
  34608.   'ftp://uzivatel:heslo@ftp.example.com/path/to/file'. (Pro p°φstup k soubor∙m
  34609.   p°es HTTP, kterΘ vy╛adujφ Basic authentication, m∙╛ete pou╛φt stejnou
  34610.   syntaxi.)
  34611.   </P
  34612. ><P
  34613. >    <TABLE
  34614. WIDTH="100%"
  34615. BORDER="0"
  34616. CELLPADDING="0"
  34617. CELLSPACING="0"
  34618. CLASS="EXAMPLE"
  34619. ><TR
  34620. ><TD
  34621. ><DIV
  34622. CLASS="example"
  34623. ><A
  34624. NAME="AEN6260"
  34625. ></A
  34626. ><P
  34627. ><B
  34628. >P°φklad 19-2. Ulo╛enφ dat na vzdßlenΘm serveru</B
  34629. ></P
  34630. ><TABLE
  34631. BORDER="0"
  34632. BGCOLOR="#E0E0E0"
  34633. CELLPADDING="5"
  34634. ><TR
  34635. ><TD
  34636. ><PRE
  34637. CLASS="php"
  34638. ><?php
  34639. $file = fopen ("ftp://ftp.php.net/incoming/outputfile", "w");
  34640. if (!$file) {
  34641.     echo "<p>Nelze otev°φt vzdßlen² soubor pro zßpis.\n";
  34642.     exit;
  34643. }
  34644. /* Zapφ╣eme data. */
  34645. fputs ($file, "$HTTP_USER_AGENT\n");
  34646. fclose ($file);
  34647. ?></PRE
  34648. ></TD
  34649. ></TR
  34650. ></TABLE
  34651. ></DIV
  34652. ></TD
  34653. ></TR
  34654. ></TABLE
  34655. >
  34656.   </P
  34657. ><P
  34658. >    <DIV
  34659. CLASS="note"
  34660. ><BLOCKQUOTE
  34661. CLASS="note"
  34662. ><P
  34663. ><B
  34664. >Poznßmka: </B
  34665. >
  34666.     Z v²╣e uvedenΘho p°φkladu by vßs mohlo napadnout vyu╛φt tuto techniku k
  34667.     zßpisu do vzdßlenΘho logu, ale jak u╛ bylo zmφn∞no v²╣e, pomocφ URL fopen()
  34668.     wrapperu m∙╛ete zapisovat pouze do novΘho souboru. Pokud mßte zßjem o
  34669.     distribuovanΘ logovßnφ, podφvejte se na <A
  34670. HREF="#function.syslog"
  34671. ><B
  34672. CLASS="function"
  34673. >syslog()</B
  34674. ></A
  34675. >.
  34676.     </P
  34677. ></BLOCKQUOTE
  34678. ></DIV
  34679. >
  34680.   </P
  34681. ></DIV
  34682. ><DIV
  34683. CLASS="chapter"
  34684. ><HR><H1
  34685. ><A
  34686. NAME="features.connection-handling"
  34687. >Kapitola 20. Obsluha spojenφ</A
  34688. ></H1
  34689. ><DIV
  34690. CLASS="note"
  34691. ><BLOCKQUOTE
  34692. CLASS="note"
  34693. ><P
  34694. ><B
  34695. >Poznßmka: </B
  34696. >Nßsledujφcφ text platφ pro verzi 3.0.7 a vy╣╣φ.</P
  34697. ></BLOCKQUOTE
  34698. ></DIV
  34699. ><P
  34700. >   Stav spojenφ se v PHP intern∞ sleduje. Jsou t°i mo╛nΘ stavy:
  34701.    <P
  34702. ></P
  34703. ><UL
  34704. ><LI
  34705. ><P
  34706. >0 - NORMAL (normßlnφ)</P
  34707. ></LI
  34708. ><LI
  34709. ><P
  34710. >1 - ABORTED (zru╣eno)</P
  34711. ></LI
  34712. ><LI
  34713. ><P
  34714. >2 - TIMEOUT (vypr╣el Φasov² limit)</P
  34715. ></LI
  34716. ></UL
  34717. >
  34718.   </P
  34719. ><P
  34720. >   P°i normßlnφm b∞hu PHP skriptu je aktivnφ stav NORMAL. Pokud se klient
  34721.   odpojφ, nastavφ se p°φznak ABORTED. K odpojenφ vzdßlenΘho klienta typicky
  34722.   dochßzφ, kdy╛ u╛ivatel zmßΦkne tlaΦφtko STOP. Pokud se dosßhne ΦasovΘho
  34723.   limitu (viz <A
  34724. HREF="#function.set-time-limit"
  34725. ><B
  34726. CLASS="function"
  34727. >set_time_limit()</B
  34728. ></A
  34729. >), nastavφ se stavov² p°φznak
  34730.   TIMEOUT.
  34731.   </P
  34732. ><P
  34733. >   M∙╛ete se rozhodnout jestli chcete, aby odpojenφ klienta zp∙sobilo p°edΦasnΘ
  34734.   ukonΦenφ va╣eho skriptu. N∞kdy je u╛iteΦnΘ nechat skripty dob∞hnout do konce,
  34735.   p°esto╛e nenφ vzdßlenΘho browseru, kter² by p°ijφmal v²stup. V²chozφ chovßnφ
  34736.   je nicmΘn∞ takovΘ, ╛e p°i odpojenφ vzdßlenΘho klienta dojde k ukonΦenφ b∞hu
  34737.   skriptu. Toto chovßnφ se dß zm∞nit skrze konfiguraΦnφ direktivu
  34738.   ignore_user_abort v php3.ini, odpovφdajφcφ direktivu php3_ignore_user_abort
  34739.   v .conf souboru Apache, Φi funkci <A
  34740. HREF="#function.ignore-user-abort"
  34741. ><B
  34742. CLASS="function"
  34743. >ignore_user_abort()</B
  34744. ></A
  34745. >.
  34746.   Pokud nedßte PHP pokyn ignorovat odpojenφ u╛ivatele a ten se odpojφ, vß╣
  34747.   skript se ukonΦφ. V²jimkou je, pokud mßte pomocφ
  34748.   <A
  34749. HREF="#function.register-shutdown-function"
  34750. ><B
  34751. CLASS="function"
  34752. >register_shutdown_function()</B
  34753. ></A
  34754. > zaregistrovanou funkci pro
  34755.   provedenφ p°i ukonΦenφ skriptu. V tom p°φpad∞, pokud vzdßlen² u╛ivatel zmßΦkne
  34756.   tlaΦφtko STOP, p°i dal╣φm pokusu tohoto skriptu odeslat v²stup PHP detekuje,
  34757.   ╛e spojenφ bylo zru╣eno, a zavolß se funkce zaregistrovanß pro provedenφ p°i
  34758.   ukonΦenφ skriptu. Tato funkce se zavolß takΘ na konci b∞hu skriptu konΦφcφm
  34759.   normßln∞, tak╛e pokud chcete po zru╣enΘm spojenφ ud∞lat n∞co jinΘho, m∙╛ete
  34760.   pou╛φt <A
  34761. HREF="#function.connection-aborted"
  34762. ><B
  34763. CLASS="function"
  34764. >connection_aborted()</B
  34765. ></A
  34766. >. Tato funkce vrßtφ
  34767.   <TT
  34768. CLASS="constant"
  34769. ><B
  34770. >TRUE</B
  34771. ></TT
  34772. >, pokud bylo spojenφ zru╣eno.
  34773.   </P
  34774. ><P
  34775. >   Vß╣ skript m∙╛e takΘ ukonΦit vestav∞n² ΦφtaΦ Φasu. V²chozφ Φasov² limit je
  34776.   30 sekund. To se dß zm∞nit max_execution_time direktivou v php╣.ini nebo
  34777.   odpovφdajφcφ php3_max_execution_time direktivou v .conf souboru Apahe, Φi
  34778.   volßnφm funkce <A
  34779. HREF="#function.set-time-limit"
  34780. ><B
  34781. CLASS="function"
  34782. >set_time_limit()</B
  34783. ></A
  34784. >. Kdy╛ ΦφtaΦ Φasu dob∞hne,
  34785.   skript se ukonΦφ, a jako ve v²╣e uvedenΘm p°φpad∞ u╛ivatelskΘho odpojenφ,
  34786.   pokud je zaregistrovanß funkce pro provedenφ p°i ukonΦenφ skriptu, tato se
  34787.   zavolß. Uvnit° tΘto funkce m∙╛te zkontrolovat, jestli jejφ zavolßnφ zp∙sobilo
  34788.   dob∞hnutφ ΦφtaΦe Φasu zavolßnφm funkce <A
  34789. HREF="#function.connection-timeout"
  34790. ><B
  34791. CLASS="function"
  34792. >connection_timeout()</B
  34793. ></A
  34794. >.
  34795.   Tato funkce vrßtφ <TT
  34796. CLASS="constant"
  34797. ><B
  34798. >TRUE</B
  34799. ></TT
  34800. >, pokud volßnφ funkce registrovanΘ
  34801.   pro provedenφ p°i ukonΦenφ skriptu zp∙sobilo dob∞hnutφ ΦφtaΦe Φasu.
  34802.   </P
  34803. ><P
  34804. >   SkuteΦnostφ hodnou pov╣imnutφ je, ╛e stavy ABORTED a TIMEOUT mohou b²t
  34805.   aktivnφ souΦasn∞. Mo╛nΘ je to v p°φpad∞, ╛e na°φdφte PHP ignorovat odpojenφ
  34806.   u╛ivatee. PHP i tak bude v∞d∞t, ╛e u╛ivatel p°eru╣il spojenφ, ale skript
  34807.   pob∞╛φ dßl. Pokud potom dosßhne ΦasovΘho limitu, bude ukonΦen, a zavolß se
  34808.   va╣e funkce pro provedenφ p°i ukonΦenφ skriptu, pokud existuje. V tomto
  34809.   okam╛iku zjistφte, ╛e jak <A
  34810. HREF="#function.connection-timeout"
  34811. ><B
  34812. CLASS="function"
  34813. >connection_timeout()</B
  34814. ></A
  34815. >, tak
  34816.   <A
  34817. HREF="#function.connection-aborted"
  34818. ><B
  34819. CLASS="function"
  34820. >connection_aborted()</B
  34821. ></A
  34822. > vracejφ <TT
  34823. CLASS="constant"
  34824. ><B
  34825. >TRUE</B
  34826. ></TT
  34827. >.
  34828.   Oba stavy m∙╛ete zkontrolovat jedin²m volßnφm funkce
  34829.   <A
  34830. HREF="#function.connection-status"
  34831. ><B
  34832. CLASS="function"
  34833. >connection_status()</B
  34834. ></A
  34835. >. Tato funkce vracφ bitovΘ pole
  34836.   aktivnφch stav∙. Tak╛e nap°φklad, pokud jsou aktivnφ oba tyto stavy, vrßtφ
  34837.   3.
  34838.   </P
  34839. ></DIV
  34840. ><DIV
  34841. CLASS="chapter"
  34842. ><HR><H1
  34843. ><A
  34844. NAME="features.persistent-connections"
  34845. >Kapitola 21. Persistentnφ databßzovß spojenφ</A
  34846. ></H1
  34847. ><P
  34848. >   Trvalß spojenφ jsou SQL spojenφ, kterß se nezavφrajφ na konci pr∙b∞hu skriptu.
  34849.   P°i po╛adavku na trvalΘ spojenφ PHP nejd°φve zkontroluje, jestli u╛ neexistuje
  34850.   identickΘ spojenφ (kterΘ z∙stalo otev°eno z d°φv∞j╣ka) - a pokud existuje,
  34851.   pou╛ije ho. Pokud neexistuje, PHP ho otev°e. "IdentickΘ" spojenφ je spojenφ,
  34852.   kterΘ bylo otev°eno se stejn²m serverem, u╛ivatelsk²m jmΘnem a heslem (pokud
  34853.   je zadßte).
  34854.   </P
  34855. ><DIV
  34856. CLASS="note"
  34857. ><BLOCKQUOTE
  34858. CLASS="note"
  34859. ><P
  34860. ><B
  34861. >Poznßmka: </B
  34862. >
  34863.    Existujφ i dal╣φ roz╣φ°enφ, kterß vytvß°φ trvalß spojenφ,
  34864.    nap°φklad
  34865.     <A
  34866. HREF="#ref.imap"
  34867. >Roz╣φ°enφ IMAP</A
  34868. >.
  34869.    </P
  34870. ></BLOCKQUOTE
  34871. ></DIV
  34872. ><P
  34873. >   LidΘ, kte°φ nejsou d∙kladn∞ obeznßmeni se zp∙sobem, jak²m web servery fungujφ
  34874.   a distribuujφ zßt∞╛, mohou poklßdat trvalß spojenφ za n∞co Φφm nejsou. Zvlß╣t∞
  34875.   <SPAN
  34876. CLASS="emphasis"
  34877. ><I
  34878. CLASS="emphasis"
  34879. >neumo╛≥ujφ</I
  34880. ></SPAN
  34881. > otvφrßnφ "u╛ivatelsk²ch sessions" na stejnΘm
  34882.   SQL spojenφ, <SPAN
  34883. CLASS="emphasis"
  34884. ><I
  34885. CLASS="emphasis"
  34886. >neumo╛≥ujφ</I
  34887. ></SPAN
  34888. > efektivnφ tvorbu transakcφ, a
  34889.   neumo╛≥ujφ spoustu dal╣φch v∞cφ. Dokonce, aby o tom bylo opravdu a d∙kladn∞ jasno,
  34890.   vßm trvalß spojenφ nedajφ <SPAN
  34891. CLASS="emphasis"
  34892. ><I
  34893. CLASS="emphasis"
  34894. >╛ßdnou</I
  34895. ></SPAN
  34896. > funkcionalitu,
  34897.   kterß by nebyla mo╛nß s jejich netrval²mi prot∞j╣ky.
  34898.   </P
  34899. ><P
  34900. >    ProΦ?
  34901.   </P
  34902. ><P
  34903. >   To je dßno zp∙sobem, jak²m fungujφ webovΘ servery. Jsou t°i zp∙soby, jak²mi
  34904.   vß╣ web server m∙╛e vyu╛φt PHP ke generovßnφ webov²ch strßnek.
  34905.   </P
  34906. ><P
  34907. >   Prvnφ metodou je pou╛φt PHP jako CGI "obal". V tomto re╛imu se vytvß°φ
  34908.   a niΦφ jedna instance PHP interpretru pro ka╛d² po╛adavek (na PHP strnßnku)
  34909.   na va╣em web serveru. Proto╛e je zniΦena po obslou╛enφ po╛adavku, v╣echny
  34910.   zdroje, kterΘ zφskß (jako t°eba spojenφ s databßzov²m serverem) jsou p°i
  34911.   jejφm zniΦenφ zav°eny. V tomto p°φpad∞ pokusem o pou╛itφ trval²ch spojenφ nic
  34912.   nezφskßte - prost∞ nevydr╛φ.
  34913.   </P
  34914. ><P
  34915. >   Druhou, a nejpopulßrn∞j╣φ, metodou, je provozovat PHP jako modul v
  34916.   multiprocesnφm web serveru, co╛ je mno╛ina, kterß v souΦasnosti obsahuje
  34917.   pouze Apache. Multiprocesnφ web server mß typicky jeden proces (rodiΦe),
  34918.   kter² °φdφ skupinu proces∙ (sv²ch d∞tφ), kterΘ d∞lajφ vlastnφ prßci -
  34919.   servφrujφ strßnky. Ka╛d² po╛adavek, kter² p°ijde od klienta, je obslou╛en
  34920.   jednφm z d∞tφ, kterΘ prßv∞ neobsluhuje jinΘho klienta. To znamenß, ╛e kdy╛
  34921.   stejn² klient vznese dal╣φ po╛adavek na stejn² server, tento m∙╛e b²t
  34922.   obslou╛en jin²m d∞tsk²m procesem ne╛ ten prvnφ. Trvalß spojenφ zaji╣╗ujφ, aby
  34923.   se ka╛d² d∞tsk² proces musel na vß╣ SQL server p°ihlßsit pouze p°i prvnφm
  34924.   odeslßnφ strßnky, kterß takovΘ spojenφ vyu╛φvß. Kdy╛ spojenφ s SQL serverem
  34925.   vy╛aduje dal╣φ strßnka, m∙╛e pou╛φt spojenφ, kterΘ toto dφt∞ otev°elo u╛
  34926.   d°φve.
  34927.   </P
  34928. ><P
  34929. >   Poslednφ metodou je pou╛φt PHP jako plug-in v multivlßknovΘm web serveru. Aktußln∞ PHP 4 mß tuto podporu pro ISAPI, WSAPI a NSAPI
  34930.   (na Windows), co╛ umo╛nuje pou╛φvat PHP jako plug-in v multivlßknov²ch serverech
  34931.   jako Netscape FastTrack (iPlanet), Microsoft Internet Information Server (IIS),
  34932.   a O'Reilly's WebSite Pro. Chovßnφ je stejnΘ
  34933.   jako u multiprocesnφm modelu popsanΘm d°φve. Podpora pro SAPI nenφ dostupnß v PHP 3.
  34934.   </P
  34935. ><P
  34936. >   Pokud trvalß spojenφ neposkytujφ ╛ßdnou p°idanou funkcionalitu, k Φemu jsou
  34937.   dobrß?
  34938.   </P
  34939. ><P
  34940. >   Odpov∞∩ na tuto otßzku je velmi jednoduchß - efektivita. Trvalß spojenφ jsou
  34941.   dobrß, pokud mß tvorba spojenφ s va╣φm SQL serverem vysokou re╛ii. Reßlnß
  34942.   v²╣e tΘto re╛ie zßle╛φ na mnoha faktorech. Nap°φklad jak² je to typ databßze,
  34943.   jestli sφdlφ na stejnΘm poΦφtaΦi jako vß╣ webserver, jak zatφ╛en² je stroj,
  34944.   na kterΘm vß╣ SQL server b∞╛φ a tak dßle. Pointa je, ╛e pokud je spojovacφ
  34945.   re╛ie vysokß, trvalß spojenφ vßm znateln∞ pomohou. Umo╛nφ d∞tskΘmu procesu
  34946.   p°ipojit se pouze jednou za cel² jeho ╛ivotnφ cyklus mφsto ka╛dΘho zpracovßnφ
  34947.   strßnky, kterß vy╛aduje spojenφ s SQL serverem. To znamenß, ╛e ka╛dΘ dφt∞,
  34948.   kterΘ otev°elo trvalΘ spojenφ, bude mφt otev°enΘ vlastnφ trvalΘ spojenφ se
  34949.   serverem. Pokud nap°φklad mßte 20 d∞tsk²ch proces∙, kterΘ spustily skript,
  34950.   kter² otev°el trvalΘ spojenφ s va╣φm SQL serverem, mßte 20 nezßvisl²ch spojenφ
  34951.   s SQL serverem, po jednom z ka╛dΘho dφt∞te.
  34952.   </P
  34953. ><P
  34954. >   V╣imn∞te si nicmΘn∞, ╛e to m∙╛e mφt nev²hody, pokud pou╛φvate databßzi s
  34955.   omezen²m poΦtem p°ipojenφ, kter² trvalß spojenφ d∞tφ p°ekroΦφ. Pokud mß va╣e
  34956.   databßze limit 16 souΦasn²ch p°ipojenφ, a v ru╣nΘm okam╛iku se pokusφ p°ipojit
  34957.   17 d∞tsk²ch proces∙, jednomu se to nepoda°φ. Pokud mßte ve sv²ch skriptech
  34958.   chyby, kterΘ brßnφ zavφrßnφ spojenφ (nap°. nekoneΦnΘ smyΦky), databßze s
  34959.   pouh²mi 32 spojenφmi bude brzy zaplavena. Vyhledejte si v dokumentaci va╣φ
  34960.   databßze informace o obsluze opu╣t∞n²ch nebo neΦinn²ch spojenφ.
  34961.   </P
  34962. ><DIV
  34963. CLASS="warning"
  34964. ><P
  34965. ></P
  34966. ><TABLE
  34967. CLASS="warning"
  34968. BORDER="1"
  34969. WIDTH="100%"
  34970. ><TR
  34971. ><TD
  34972. ALIGN="CENTER"
  34973. ><B
  34974. >Varovßnφ</B
  34975. ></TD
  34976. ></TR
  34977. ><TR
  34978. ><TD
  34979. ALIGN="LEFT"
  34980. ><P
  34981. >    Zde je n∞kolik dodateΦn²ch nßmitek, kterΘ se usadily v mysli b∞hem
  34982.    pou╛φvßnφ trval²ch spojenφ. Jedna z nich je, kdy╛ pou╛φvßte zamknutΘ
  34983.    tabulky p°i trvalΘm spojenφ a skript z jakΘhokoli d∙vodu nem∙╛e 
  34984.    uvolnit zßmek, pak nßsledujφcφ skript, kter² pou╛φvß stejnΘ spojenφ, 
  34985.    bude nejspφ╣e na trvalo zablokovßn a mo╛nß bude nutnΘ, abyste
  34986.    poka╛dΘ restartovali http server nebo databßzov² server. 
  34987.    Dßle pak v p°φpad∞ pou╛itφ transakcφ se transakΦnφ blok p°enese i do
  34988.    dal╣φho skriptu pou╛φvajφcφho stejnΘ spojenφ, pokud jeho vykonßnφ
  34989.    konΦφ d°φve ne╛ transakΦnφ blok. V ka╛dΘm p°φpad∞ m∙╛ete pou╛φt
  34990.    <A
  34991. HREF="#function.register-shutdown-function"
  34992. ><B
  34993. CLASS="function"
  34994. >register_shutdown_function()</B
  34995. ></A
  34996. > k registraci a
  34997.    jednoduchΘmu vyΦi╣t∞nφ funkce pro odemknutφ tabulek nebo zru╣enφ
  34998.    b∞╛φcφ transakce (roll back). NejlΘpe se problΘmu vyvarujete ·pln∞
  34999.    nepou╛φvßnφm trval²ch spojenφ ve skriptech, ve kter²ch se zamykajφ
  35000.    tabulky nebo pou╛φvajφ transakce (m∙╛ete je stßle pou╛φvat na
  35001.    mnoh²ch dal╣φch mφstech).
  35002.    </P
  35003. ></TD
  35004. ></TR
  35005. ></TABLE
  35006. ></DIV
  35007. ><P
  35008. >   D∙le╛it² souhrn. Trvalß spojenφ byla navr╛ena tak, aby odpovφdala jedna k
  35009.   jednΘ normßlnφm spojenφm. To znamenß, ╛e byste <SPAN
  35010. CLASS="emphasis"
  35011. ><I
  35012. CLASS="emphasis"
  35013. >v╛dy</I
  35014. ></SPAN
  35015. > m∞li
  35016.   b²t schopni nahradit trvalß spojenφ netrval²mi beze zm∞ny fungovßnφ va╣eho
  35017.   skriptu. <SPAN
  35018. CLASS="emphasis"
  35019. ><I
  35020. CLASS="emphasis"
  35021. >M∙╛e</I
  35022. ></SPAN
  35023. > to (a pravd∞podobn∞ bude) mφt vliv na
  35024.   efektivitu tohoto skriptu, ale ne jeho chovßnφ!
  35025.   </P
  35026. ><P
  35027. >    Dßle takΘ:
  35028.     <A
  35029. HREF="#function.fbsql-pconnect"
  35030. ><B
  35031. CLASS="function"
  35032. >fbsql_pconnect()</B
  35033. ></A
  35034. >,
  35035.    <A
  35036. HREF="#function.ibase-pconnect"
  35037. ><B
  35038. CLASS="function"
  35039. >ibase_pconnect()</B
  35040. ></A
  35041. >,  <A
  35042. HREF="#function.ifx-pconnect"
  35043. ><B
  35044. CLASS="function"
  35045. >ifx_pconnect()</B
  35046. ></A
  35047. >,
  35048.    <B
  35049. CLASS="function"
  35050. >imap_popen()</B
  35051. >, <A
  35052. HREF="#function.ingres-pconnect"
  35053. ><B
  35054. CLASS="function"
  35055. >ingres_pconnect()</B
  35056. ></A
  35057. >,
  35058.    <A
  35059. HREF="#function.msql-pconnect"
  35060. ><B
  35061. CLASS="function"
  35062. >msql_pconnect()</B
  35063. ></A
  35064. >, <A
  35065. HREF="#function.mssql-pconnect"
  35066. ><B
  35067. CLASS="function"
  35068. >mssql_pconnect()</B
  35069. ></A
  35070. >,
  35071.    <A
  35072. HREF="#function.mysql-pconnect"
  35073. ><B
  35074. CLASS="function"
  35075. >mysql_pconnect()</B
  35076. ></A
  35077. >, <A
  35078. HREF="#function.ociplogon"
  35079. ><B
  35080. CLASS="function"
  35081. >OCIPLogon()</B
  35082. ></A
  35083. >,
  35084.    <A
  35085. HREF="#function.odbc-pconnect"
  35086. ><B
  35087. CLASS="function"
  35088. >odbc_pconnect()</B
  35089. ></A
  35090. >, <A
  35091. HREF="#function.ora-plogon"
  35092. ><B
  35093. CLASS="function"
  35094. >Ora_pLogon()</B
  35095. ></A
  35096. >,
  35097.    <A
  35098. HREF="#function.pfsockopen"
  35099. ><B
  35100. CLASS="function"
  35101. >pfsockopen()</B
  35102. ></A
  35103. >, <A
  35104. HREF="#function.pg-pconnect"
  35105. ><B
  35106. CLASS="function"
  35107. >pg_pconnect()</B
  35108. ></A
  35109. > a
  35110.    <A
  35111. HREF="#function.sybase-pconnect"
  35112. ><B
  35113. CLASS="function"
  35114. >sybase_pconnect()</B
  35115. ></A
  35116. >.
  35117.   </P
  35118. ></DIV
  35119. ><DIV
  35120. CLASS="chapter"
  35121. ><HR><H1
  35122. ><A
  35123. NAME="features.safe-mode"
  35124. >Kapitola 22. BezpeΦn² re╛im</A
  35125. ></H1
  35126. ><P
  35127. >    BezpeΦn² re╛im PHP je pokus o °e╣enφ bezpeΦnosti sdφlen²ch server∙.
  35128.    Je architekturßln∞ nekorektnφ pokou╣et se °e╣it tento problΘm na
  35129.    ·rovni PHP, ale proto╛e °e╣enφ na ·rovni webovskΘho serveru a operaΦnφho
  35130.    systΘmu nejsou p°φli╣ realistickß, mnoho lidφ, zvla╣t∞ ISP, pou╛φvß
  35131.    nynφ bezpeΦn² re╛im.    
  35132.   </P
  35133. ><P
  35134. >    KonfiguraΦnφ direktivy, kterΘ ovlßdajφ bezpeΦn² re╛im: 
  35135.    <TABLE
  35136. BORDER="0"
  35137. BGCOLOR="#E0E0E0"
  35138. CELLPADDING="5"
  35139. ><TR
  35140. ><TD
  35141. ><PRE
  35142. CLASS="ini"
  35143. >safe_mode = Off 
  35144. open_basedir = 
  35145. safe_mode_exec_dir = 
  35146. safe_mode_allowed_env_vars = PHP_ 
  35147. safe_mode_protected_env_vars = LD_LIBRARY_PATH 
  35148. disable_functions =</PRE
  35149. ></TD
  35150. ></TR
  35151. ></TABLE
  35152. >
  35153.   </P
  35154. ><P
  35155. >    Pokud je <A
  35156. HREF="#ini.safe-mode"
  35157. >safe_mode</A
  35158. > zapnut², PHP
  35159.    kontroluje, je-li vlastnφk b∞╛φcφho skriptu vlastnφkem souboru, s nφm╛
  35160.    se mß manipulovat. Nap°φklad: 
  35161.    <TABLE
  35162. BORDER="0"
  35163. BGCOLOR="#E0E0E0"
  35164. CELLPADDING="5"
  35165. ><TR
  35166. ><TD
  35167. ><PRE
  35168. CLASS="ls"
  35169. >-rw-rw-r--    1 rasmus   rasmus       33 Jul  1 19:20 script.php 
  35170. -rw-r--r--    1 root     root       1116 May 26 18:01 /etc/passwd</PRE
  35171. ></TD
  35172. ></TR
  35173. ></TABLE
  35174. >
  35175.    Spu╣t∞nφ skriptu script.php 
  35176.    <TABLE
  35177. BORDER="0"
  35178. BGCOLOR="#E0E0E0"
  35179. CELLPADDING="5"
  35180. ><TR
  35181. ><TD
  35182. ><PRE
  35183. CLASS="php"
  35184. ><?php
  35185.  readfile('/etc/passwd'); 
  35186. ?></PRE
  35187. ></TD
  35188. ></TR
  35189. ></TABLE
  35190. >
  35191.    bude mφt v bezpeΦnΘm re╛imu za v²sledek tuto chybu: 
  35192.    <TABLE
  35193. BORDER="0"
  35194. BGCOLOR="#E0E0E0"
  35195. CELLPADDING="5"
  35196. ><TR
  35197. ><TD
  35198. ><PRE
  35199. CLASS="screen"
  35200. >Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not 
  35201. allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2</PRE
  35202. ></TD
  35203. ></TR
  35204. ></TABLE
  35205. >
  35206.   </P
  35207. ><P
  35208. >    Pokud namφsto <A
  35209. HREF="#ini.safe-mode"
  35210. >safe_mode</A
  35211. > nastavφte 
  35212.    adresß° <A
  35213. HREF="#ini.open-basedir"
  35214. >open_basedir</A
  35215. >, potom
  35216.    v╣echny operace se soubory budou omezeny pod specifikovan² adresß°.
  35217.    Nap°φklad (p°φklad Apache httpd.conf): 
  35218.    <TABLE
  35219. BORDER="0"
  35220. BGCOLOR="#E0E0E0"
  35221. CELLPADDING="5"
  35222. ><TR
  35223. ><TD
  35224. ><PRE
  35225. CLASS="ini"
  35226. ><Directory /docroot>
  35227.   php_admin_value open_basedir /docroot 
  35228. </Directory></PRE
  35229. ></TD
  35230. ></TR
  35231. ></TABLE
  35232. >
  35233.    Kdy╛ spustφte tent²╛ soubor script.php s timto nastavenφm
  35234.    <A
  35235. HREF="#ini.open-basedir"
  35236. >open_basedir</A
  35237. >, dostanete tento
  35238.    v²sledek:
  35239.    <TABLE
  35240. BORDER="0"
  35241. BGCOLOR="#E0E0E0"
  35242. CELLPADDING="5"
  35243. ><TR
  35244. ><TD
  35245. ><PRE
  35246. CLASS="screen"
  35247. >Warning: open_basedir restriction in effect. File is in wrong directory in 
  35248. /docroot/script.php on line 2</PRE
  35249. ></TD
  35250. ></TR
  35251. ></TABLE
  35252. >
  35253.   </P
  35254. ><P
  35255. >    M∙╛ete takΘ vypnout jednotlivΘ funkce. Pokud p°idßme toto do souboru
  35256.    php.ini:    
  35257.    <TABLE
  35258. BORDER="0"
  35259. BGCOLOR="#E0E0E0"
  35260. CELLPADDING="5"
  35261. ><TR
  35262. ><TD
  35263. ><PRE
  35264. CLASS="ini"
  35265. >disable_functions readfile,system</PRE
  35266. ></TD
  35267. ></TR
  35268. ></TABLE
  35269. >
  35270.    zφskßme takov²to v²stup: 
  35271.    <TABLE
  35272. BORDER="0"
  35273. BGCOLOR="#E0E0E0"
  35274. CELLPADDING="5"
  35275. ><TR
  35276. ><TD
  35277. ><PRE
  35278. CLASS="screen"
  35279. >Warning: readfile() has been disabled for security reasons in 
  35280. /docroot/script.php on line 2</PRE
  35281. ></TD
  35282. ></TR
  35283. ></TABLE
  35284. >
  35285.   </P
  35286. ><DIV
  35287. CLASS="sect1"
  35288. ><HR><H2
  35289. CLASS="sect1"
  35290. ><A
  35291. NAME="features.safe-mode.functions"
  35292. ></A
  35293. >Funkce omezenΘ/deaktivovanΘ v bezpeΦnΘm re╛imu</H2
  35294. ><P
  35295. >     Toto je pravd∞podobn∞ ne·pln² a mo╛nß nesprßvn² p°ehled funkcφ
  35296.     omezen²ch v 
  35297.     <A
  35298. HREF="#features.safe-mode"
  35299. >bezpeΦnΘm re╛imu</A
  35300. >.
  35301.     
  35302.     <DIV
  35303. CLASS="table"
  35304. ><A
  35305. NAME="AEN6357"
  35306. ></A
  35307. ><P
  35308. ><B
  35309. >Tabulka 22-1. Funkce omezenΘ v bezpeΦnΘm re╛imu</B
  35310. ></P
  35311. ><TABLE
  35312. BORDER="1"
  35313. CLASS="CALSTABLE"
  35314. ><THEAD
  35315. ><TR
  35316. ><TH
  35317. ALIGN="LEFT"
  35318. VALIGN="MIDDLE"
  35319. >Funkce</TH
  35320. ><TH
  35321. ALIGN="LEFT"
  35322. VALIGN="MIDDLE"
  35323. >Omezenφ</TH
  35324. ></TR
  35325. ></THEAD
  35326. ><TBODY
  35327. ><TR
  35328. ><TD
  35329. ALIGN="LEFT"
  35330. VALIGN="MIDDLE"
  35331. ><A
  35332. HREF="#function.dbmopen"
  35333. ><B
  35334. CLASS="function"
  35335. >dbmopen()</B
  35336. ></A
  35337. ></TD
  35338. ><TD
  35339. ALIGN="LEFT"
  35340. VALIGN="MIDDLE"
  35341. >Kontroluje, zda soubory/adresß°e,
  35342. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35343. ></TR
  35344. ><TR
  35345. ><TD
  35346. ALIGN="LEFT"
  35347. VALIGN="MIDDLE"
  35348. ><A
  35349. HREF="#function.dbase-open"
  35350. ><B
  35351. CLASS="function"
  35352. >dbase_open()</B
  35353. ></A
  35354. ></TD
  35355. ><TD
  35356. ALIGN="LEFT"
  35357. VALIGN="MIDDLE"
  35358. >Kontroluje, zda soubory/adresß°e,
  35359. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35360. ></TR
  35361. ><TR
  35362. ><TD
  35363. ALIGN="LEFT"
  35364. VALIGN="MIDDLE"
  35365. ><A
  35366. HREF="#function.filepro"
  35367. ><B
  35368. CLASS="function"
  35369. >filepro()</B
  35370. ></A
  35371. ></TD
  35372. ><TD
  35373. ALIGN="LEFT"
  35374. VALIGN="MIDDLE"
  35375. >Kontroluje, zda soubory/adresß°e,
  35376. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35377. ></TR
  35378. ><TR
  35379. ><TD
  35380. ALIGN="LEFT"
  35381. VALIGN="MIDDLE"
  35382. ><A
  35383. HREF="#function.filepro-rowcount"
  35384. ><B
  35385. CLASS="function"
  35386. >filepro_rowcount()</B
  35387. ></A
  35388. ></TD
  35389. ><TD
  35390. ALIGN="LEFT"
  35391. VALIGN="MIDDLE"
  35392. >Kontroluje, zda soubory/adresß°e,
  35393. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35394. ></TR
  35395. ><TR
  35396. ><TD
  35397. ALIGN="LEFT"
  35398. VALIGN="MIDDLE"
  35399. ><A
  35400. HREF="#function.filepro-retrieve"
  35401. ><B
  35402. CLASS="function"
  35403. >filepro_retrieve()</B
  35404. ></A
  35405. ></TD
  35406. ><TD
  35407. ALIGN="LEFT"
  35408. VALIGN="MIDDLE"
  35409. >Kontroluje, zda soubory/adresß°e,
  35410. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35411. ></TR
  35412. ><TR
  35413. ><TD
  35414. ALIGN="LEFT"
  35415. VALIGN="MIDDLE"
  35416. ><B
  35417. CLASS="function"
  35418. >ifx_*()</B
  35419. ></TD
  35420. ><TD
  35421. ALIGN="LEFT"
  35422. VALIGN="MIDDLE"
  35423. >sql_safe_mode restrictions, (!= safe mode)</TD
  35424. ></TR
  35425. ><TR
  35426. ><TD
  35427. ALIGN="LEFT"
  35428. VALIGN="MIDDLE"
  35429. ><B
  35430. CLASS="function"
  35431. >ingres_*()</B
  35432. ></TD
  35433. ><TD
  35434. ALIGN="LEFT"
  35435. VALIGN="MIDDLE"
  35436. >sql_safe_mode restrictions, (!= safe mode)</TD
  35437. ></TR
  35438. ><TR
  35439. ><TD
  35440. ALIGN="LEFT"
  35441. VALIGN="MIDDLE"
  35442. ><B
  35443. CLASS="function"
  35444. >mysql_*()</B
  35445. ></TD
  35446. ><TD
  35447. ALIGN="LEFT"
  35448. VALIGN="MIDDLE"
  35449. >sql_safe_mode restrictions, (!= safe mode)</TD
  35450. ></TR
  35451. ><TR
  35452. ><TD
  35453. ALIGN="LEFT"
  35454. VALIGN="MIDDLE"
  35455. ><B
  35456. CLASS="function"
  35457. >pg_loimport()</B
  35458. ></TD
  35459. ><TD
  35460. ALIGN="LEFT"
  35461. VALIGN="MIDDLE"
  35462. >Kontroluje, zda soubory/adresß°e,
  35463. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35464. ></TR
  35465. ><TR
  35466. ><TD
  35467. ALIGN="LEFT"
  35468. VALIGN="MIDDLE"
  35469. ><A
  35470. HREF="#function.posix-mkfifo"
  35471. ><B
  35472. CLASS="function"
  35473. >posix_mkfifo()</B
  35474. ></A
  35475. ></TD
  35476. ><TD
  35477. ALIGN="LEFT"
  35478. VALIGN="MIDDLE"
  35479. >Kontroluje, zda adresß°,
  35480. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript.</TD
  35481. ></TR
  35482. ><TR
  35483. ><TD
  35484. ALIGN="LEFT"
  35485. VALIGN="MIDDLE"
  35486. ><A
  35487. HREF="#function.putenv"
  35488. ><B
  35489. CLASS="function"
  35490. >putenv()</B
  35491. ></A
  35492. ></TD
  35493. ><TD
  35494. ALIGN="LEFT"
  35495. VALIGN="MIDDLE"
  35496. >Obeys the safe_mode_protected_env_vars and 
  35497.         safe_mode_allowed_env_vars ini-directives. Viz takΘ dokumentaci
  35498.     <A
  35499. HREF="#function.putenv"
  35500. ><B
  35501. CLASS="function"
  35502. >putenv()</B
  35503. ></A
  35504. ></TD
  35505. ></TR
  35506. ><TR
  35507. ><TD
  35508. ALIGN="LEFT"
  35509. VALIGN="MIDDLE"
  35510. ><A
  35511. HREF="#function.move-uploaded-file"
  35512. ><B
  35513. CLASS="function"
  35514. >move_uploaded_file()</B
  35515. ></A
  35516. ></TD
  35517. ><TD
  35518. ALIGN="LEFT"
  35519. VALIGN="MIDDLE"
  35520. >Kontroluje, zda soubory/adresß°e,
  35521. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. </TD
  35522. ></TR
  35523. ><TR
  35524. ><TD
  35525. ALIGN="LEFT"
  35526. VALIGN="MIDDLE"
  35527. ><A
  35528. HREF="#function.chdir"
  35529. ><B
  35530. CLASS="function"
  35531. >chdir()</B
  35532. ></A
  35533. ></TD
  35534. ><TD
  35535. ALIGN="LEFT"
  35536. VALIGN="MIDDLE"
  35537. >Kontroluje, zda adresß°,
  35538. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript.</TD
  35539. ></TR
  35540. ><TR
  35541. ><TD
  35542. ALIGN="LEFT"
  35543. VALIGN="MIDDLE"
  35544. ><A
  35545. HREF="#function.dl"
  35546. ><B
  35547. CLASS="function"
  35548. >dl()</B
  35549. ></A
  35550. ></TD
  35551. ><TD
  35552. ALIGN="LEFT"
  35553. VALIGN="MIDDLE"
  35554. >Tyto funkce jsou v bezpeΦnΘm re╛imu (<A
  35555. HREF="#features.safe-mode"
  35556. >safe-mode</A
  35557. >) deaktivovßny.</TD
  35558. ></TR
  35559. ><TR
  35560. ><TD
  35561. ALIGN="LEFT"
  35562. VALIGN="MIDDLE"
  35563. ><A
  35564. HREF="#language.operators.execution"
  35565. >backtick operßtor</A
  35566. ></TD
  35567. ><TD
  35568. ALIGN="LEFT"
  35569. VALIGN="MIDDLE"
  35570. >Tyto funkce jsou v bezpeΦnΘm re╛imu (<A
  35571. HREF="#features.safe-mode"
  35572. >safe-mode</A
  35573. >) deaktivovßny.</TD
  35574. ></TR
  35575. ><TR
  35576. ><TD
  35577. ALIGN="LEFT"
  35578. VALIGN="MIDDLE"
  35579. ><A
  35580. HREF="#function.shell-exec"
  35581. ><B
  35582. CLASS="function"
  35583. >shell_exec()</B
  35584. ></A
  35585. > (funkΦnφ ekvivalent backticks)</TD
  35586. ><TD
  35587. ALIGN="LEFT"
  35588. VALIGN="MIDDLE"
  35589. >Tyto funkce jsou v bezpeΦnΘm re╛imu (<A
  35590. HREF="#features.safe-mode"
  35591. >safe-mode</A
  35592. >) deaktivovßny.</TD
  35593. ></TR
  35594. ><TR
  35595. ><TD
  35596. ALIGN="LEFT"
  35597. VALIGN="MIDDLE"
  35598. ><A
  35599. HREF="#function.exec"
  35600. ><B
  35601. CLASS="function"
  35602. >exec()</B
  35603. ></A
  35604. ></TD
  35605. ><TD
  35606. ALIGN="LEFT"
  35607. VALIGN="MIDDLE"
  35608. >M∙╛ete spou╣t∞t programy pouze uvnit° adresß°e <A
  35609. HREF="#ini.safe-mode-exec-dir"
  35610. >safe_mode_exec_dir</A
  35611. >.
  35612.         Z praktick²ch d∙vod∙ nenφ momentßln∞ mo╛nΘ mφt v cest∞ k souboru
  35613.     s programem komponenty <TT
  35614. CLASS="literal"
  35615. >..</TT
  35616. >.</TD
  35617. ></TR
  35618. ><TR
  35619. ><TD
  35620. ALIGN="LEFT"
  35621. VALIGN="MIDDLE"
  35622. ><A
  35623. HREF="#function.system"
  35624. ><B
  35625. CLASS="function"
  35626. >system()</B
  35627. ></A
  35628. ></TD
  35629. ><TD
  35630. ALIGN="LEFT"
  35631. VALIGN="MIDDLE"
  35632. >M∙╛ete spou╣t∞t programy pouze uvnit° adresß°e <A
  35633. HREF="#ini.safe-mode-exec-dir"
  35634. >safe_mode_exec_dir</A
  35635. >.
  35636.         Z praktick²ch d∙vod∙ nenφ momentßln∞ mo╛nΘ mφt v cest∞ k souboru
  35637.     s programem komponenty <TT
  35638. CLASS="literal"
  35639. >..</TT
  35640. >.</TD
  35641. ></TR
  35642. ><TR
  35643. ><TD
  35644. ALIGN="LEFT"
  35645. VALIGN="MIDDLE"
  35646. ><A
  35647. HREF="#function.passthru"
  35648. ><B
  35649. CLASS="function"
  35650. >passthru()</B
  35651. ></A
  35652. ></TD
  35653. ><TD
  35654. ALIGN="LEFT"
  35655. VALIGN="MIDDLE"
  35656. >M∙╛ete spou╣t∞t programy pouze uvnit° adresß°e <A
  35657. HREF="#ini.safe-mode-exec-dir"
  35658. >safe_mode_exec_dir</A
  35659. >.
  35660.         Z praktick²ch d∙vod∙ nenφ momentßln∞ mo╛nΘ mφt v cest∞ k souboru
  35661.     s programem komponenty <TT
  35662. CLASS="literal"
  35663. >..</TT
  35664. >.</TD
  35665. ></TR
  35666. ><TR
  35667. ><TD
  35668. ALIGN="LEFT"
  35669. VALIGN="MIDDLE"
  35670. ><A
  35671. HREF="#function.popen"
  35672. ><B
  35673. CLASS="function"
  35674. >popen()</B
  35675. ></A
  35676. ></TD
  35677. ><TD
  35678. ALIGN="LEFT"
  35679. VALIGN="MIDDLE"
  35680. >M∙╛ete spou╣t∞t programy pouze uvnit° adresß°e <A
  35681. HREF="#ini.safe-mode-exec-dir"
  35682. >safe_mode_exec_dir</A
  35683. >.
  35684.         Z praktick²ch d∙vod∙ nenφ momentßln∞ mo╛nΘ mφt v cest∞ k souboru
  35685.     s programem komponenty <TT
  35686. CLASS="literal"
  35687. >..</TT
  35688. >.</TD
  35689. ></TR
  35690. ><TR
  35691. ><TD
  35692. ALIGN="LEFT"
  35693. VALIGN="MIDDLE"
  35694. ><A
  35695. HREF="#function.mkdir"
  35696. ><B
  35697. CLASS="function"
  35698. >mkdir()</B
  35699. ></A
  35700. ></TD
  35701. ><TD
  35702. ALIGN="LEFT"
  35703. VALIGN="MIDDLE"
  35704. >Kontroluje, zda adresß°,
  35705. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript.</TD
  35706. ></TR
  35707. ><TR
  35708. ><TD
  35709. ALIGN="LEFT"
  35710. VALIGN="MIDDLE"
  35711. ><A
  35712. HREF="#function.rmdir"
  35713. ><B
  35714. CLASS="function"
  35715. >rmdir()</B
  35716. ></A
  35717. ></TD
  35718. ><TD
  35719. ALIGN="LEFT"
  35720. VALIGN="MIDDLE"
  35721. >Kontroluje, zda soubory/adresß°e,
  35722. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35723. ></TR
  35724. ><TR
  35725. ><TD
  35726. ALIGN="LEFT"
  35727. VALIGN="MIDDLE"
  35728. ><A
  35729. HREF="#function.rename"
  35730. ><B
  35731. CLASS="function"
  35732. >rename()</B
  35733. ></A
  35734. ></TD
  35735. ><TD
  35736. ALIGN="LEFT"
  35737. VALIGN="MIDDLE"
  35738. >Kontroluje, zda soubory/adresß°e,
  35739. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Kontroluje, zda adresß°,
  35740. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript.</TD
  35741. ></TR
  35742. ><TR
  35743. ><TD
  35744. ALIGN="LEFT"
  35745. VALIGN="MIDDLE"
  35746. ><A
  35747. HREF="#function.unlink"
  35748. ><B
  35749. CLASS="function"
  35750. >unlink()</B
  35751. ></A
  35752. ></TD
  35753. ><TD
  35754. ALIGN="LEFT"
  35755. VALIGN="MIDDLE"
  35756. >Kontroluje, zda soubory/adresß°e,
  35757. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Kontroluje, zda adresß°,
  35758. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript.</TD
  35759. ></TR
  35760. ><TR
  35761. ><TD
  35762. ALIGN="LEFT"
  35763. VALIGN="MIDDLE"
  35764. ><A
  35765. HREF="#function.copy"
  35766. ><B
  35767. CLASS="function"
  35768. >copy()</B
  35769. ></A
  35770. ></TD
  35771. ><TD
  35772. ALIGN="LEFT"
  35773. VALIGN="MIDDLE"
  35774. >Kontroluje, zda soubory/adresß°e,
  35775. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Kontroluje, zda adresß°,
  35776. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript. (pro 
  35777.         <TT
  35778. CLASS="parameter"
  35779. ><I
  35780. >source</I
  35781. ></TT
  35782. > a 
  35783.         <TT
  35784. CLASS="parameter"
  35785. ><I
  35786. >target</I
  35787. ></TT
  35788. >) </TD
  35789. ></TR
  35790. ><TR
  35791. ><TD
  35792. ALIGN="LEFT"
  35793. VALIGN="MIDDLE"
  35794. ><A
  35795. HREF="#function.chgrp"
  35796. ><B
  35797. CLASS="function"
  35798. >chgrp()</B
  35799. ></A
  35800. ></TD
  35801. ><TD
  35802. ALIGN="LEFT"
  35803. VALIGN="MIDDLE"
  35804. >Kontroluje, zda soubory/adresß°e,
  35805. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35806. ></TR
  35807. ><TR
  35808. ><TD
  35809. ALIGN="LEFT"
  35810. VALIGN="MIDDLE"
  35811. ><A
  35812. HREF="#function.chown"
  35813. ><B
  35814. CLASS="function"
  35815. >chown()</B
  35816. ></A
  35817. ></TD
  35818. ><TD
  35819. ALIGN="LEFT"
  35820. VALIGN="MIDDLE"
  35821. >Kontroluje, zda soubory/adresß°e,
  35822. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript.</TD
  35823. ></TR
  35824. ><TR
  35825. ><TD
  35826. ALIGN="LEFT"
  35827. VALIGN="MIDDLE"
  35828. ><A
  35829. HREF="#function.chmod"
  35830. ><B
  35831. CLASS="function"
  35832. >chmod()</B
  35833. ></A
  35834. ></TD
  35835. ><TD
  35836. ALIGN="LEFT"
  35837. VALIGN="MIDDLE"
  35838. >Kontroluje, zda soubory/adresß°e,
  35839. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Navφc nem∙╛ete nastavovat  
  35840.         SUID, SGID a sticky bit</TD
  35841. ></TR
  35842. ><TR
  35843. ><TD
  35844. ALIGN="LEFT"
  35845. VALIGN="MIDDLE"
  35846. ><A
  35847. HREF="#function.touch"
  35848. ><B
  35849. CLASS="function"
  35850. >touch()</B
  35851. ></A
  35852. ></TD
  35853. ><TD
  35854. ALIGN="LEFT"
  35855. VALIGN="MIDDLE"
  35856. >Kontroluje, zda soubory/adresß°e,
  35857. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Kontroluje, zda adresß°,
  35858. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript.</TD
  35859. ></TR
  35860. ><TR
  35861. ><TD
  35862. ALIGN="LEFT"
  35863. VALIGN="MIDDLE"
  35864. ><A
  35865. HREF="#function.symlink"
  35866. ><B
  35867. CLASS="function"
  35868. >symlink()</B
  35869. ></A
  35870. ></TD
  35871. ><TD
  35872. ALIGN="LEFT"
  35873. VALIGN="MIDDLE"
  35874. >Kontroluje, zda soubory/adresß°e,
  35875. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Kontroluje, zda adresß°,
  35876. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript. (pozn.: testovßn je pouze
  35877.     cφl)</TD
  35878. ></TR
  35879. ><TR
  35880. ><TD
  35881. ALIGN="LEFT"
  35882. VALIGN="MIDDLE"
  35883. ><A
  35884. HREF="#function.link"
  35885. ><B
  35886. CLASS="function"
  35887. >link()</B
  35888. ></A
  35889. ></TD
  35890. ><TD
  35891. ALIGN="LEFT"
  35892. VALIGN="MIDDLE"
  35893. >Kontroluje, zda soubory/adresß°e,
  35894. se kter²mi pracujete, majφ stejnΘ UID jako spu╣t∞n² skript. Kontroluje, zda adresß°,
  35895. ve kterΘm pracujete, mß stejnΘ UID jako spu╣t∞n² skript. (pozn.: testovßn je pouze
  35896.     cφl)</TD
  35897. ></TR
  35898. ><TR
  35899. ><TD
  35900. ALIGN="LEFT"
  35901. VALIGN="MIDDLE"
  35902. ><A
  35903. HREF="#function.getallheaders"
  35904. ><B
  35905. CLASS="function"
  35906. >getallheaders()</B
  35907. ></A
  35908. ></TD
  35909. ><TD
  35910. ALIGN="LEFT"
  35911. VALIGN="MIDDLE"
  35912. >V bezpeΦnΘm re╛imu nebudou hlaviΦky zaΦφnajφcφ 'authorization'
  35913.     (bez ohledu na velikost pφsmen) vraceny. Varovßnφ: toto nefunguje
  35914.     s aol-server implementacφ <A
  35915. HREF="#function.getallheaders"
  35916. ><B
  35917. CLASS="function"
  35918. >getallheaders()</B
  35919. ></A
  35920. >!</TD
  35921. ></TR
  35922. ><TR
  35923. ><TD
  35924. ALIGN="LEFT"
  35925. VALIGN="MIDDLE"
  35926. >JakΘkoli funkce kterΘ pou╛φvajφ 
  35927.          <TT
  35928. CLASS="filename"
  35929. >php4/main/fopen_wrappers.c</TT
  35930. >
  35931.         </TD
  35932. ><TD
  35933. ALIGN="LEFT"
  35934. VALIGN="MIDDLE"
  35935. >??</TD
  35936. ></TR
  35937. ></TBODY
  35938. ></TABLE
  35939. ></DIV
  35940. >
  35941.    </P
  35942. ></DIV
  35943. ></DIV
  35944. ><DIV
  35945. CLASS="chapter"
  35946. ><HR><H1
  35947. ><A
  35948. NAME="features.commandline"
  35949. >Kapitola 23. Pou╛itφ PHP z p°φkazovΘ °ßdky</A
  35950. ></H1
  35951. ><P
  35952. >   Mo╛nosti PHP p°i spou╣t∞nφ z p°φkazovΘ °ßdky p°inß╣ejφ mnoho u╛itku,
  35953.   pokud chcete ladit nebo testovat va╣e nastavenφ PHP, hodφ se v╣ak
  35954.   i pro p°φpady, kdy byste rßdi pou╛ili PHP pro jinΘ ·Φely ne╛ WWW
  35955.   skriptovßnφ.  
  35956.  </P
  35957. ><P
  35958. >   Uv∞domte si, ╛e m∙╛ete v╛dy sm∞rovat v²stup programu PHP do vn∞j╣φho
  35959.   souboru pomocφ znaku >, tak╛e <TT
  35960. CLASS="literal"
  35961. >php -q test.php >
  35962.   test.html</TT
  35963. > vytiskne v²stup <TT
  35964. CLASS="filename"
  35965. >test.php</TT
  35966. >
  35967.   bez HTTP hlaviΦek do <TT
  35968. CLASS="filename"
  35969. >test.html</TT
  35970. > ve stejnΘm adresß°i.  
  35971.  </P
  35972. ><P
  35973. >   Mo╛nosti p°φkazovΘ °ßdky m∙╛ete vyu╛φvat pouze tehdy, mßte-li (spustiteln²)
  35974.   program PHP. Pokud jste zkompilovali pouze modul do serveru a nemßte na
  35975.   poΦφtaΦi ╛ßdnou CGI verzi, nem∙╛ete p°φkazovou °ßdku pou╛φvat.
  35976.   Pro u╛ivatele Windows je v binßrnφm balφΦku jak serverov² modul, tak
  35977.   spustiteln² soubor nazvan² <TT
  35978. CLASS="filename"
  35979. >php.exe</TT
  35980. >.
  35981.  </P
  35982. ><P
  35983. >   Tento seznem voleb pro p°φkazovou °ßdku je konzistentnφ s PHP 4.0.6.
  35984.   Aktußlnφ seznam vΦetn∞ jedno°ßdkov²ch popis∙ m∙╛ete zφskat pomocφ parametru
  35985.   <TT
  35986. CLASS="literal"
  35987. >-h</TT
  35988. >. V²stup <TT
  35989. CLASS="literal"
  35990. >php -h</TT
  35991. > by m∞l vypadat
  35992.   p°ibli╛n∞ takto:  
  35993.   <TABLE
  35994. BORDER="0"
  35995. BGCOLOR="#E0E0E0"
  35996. CELLPADDING="5"
  35997. ><TR
  35998. ><TD
  35999. ><PRE
  36000. CLASS="screen"
  36001. >Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] |  {<file> [args...]}
  36002.   -q             Quiet-mode.  Suppress HTTP Header output.
  36003.   -s             Display colour syntax highlighted source.
  36004.   -f <file>      Parse <file>.  Implies `-q'
  36005.   -v             Version number
  36006.   -C             Do not chdir to the script's directory
  36007.   -c <path>      Look for php.ini file in this directory
  36008.   -d foo[=bar]   Define INI entry foo with value 'bar'
  36009.   -e             Generate extended information for debugger/profiler
  36010.   -z <file>      Load Zend extension <file>.
  36011.   -l             Syntax check only (lint)
  36012.   -m             Show compiled in modules
  36013.   -i             PHP information
  36014.   -h             This help</PRE
  36015. ></TD
  36016. ></TR
  36017. ></TABLE
  36018. >
  36019.  </P
  36020. ><P
  36021. >   Zde uvßdφme n∞kterΘ z nejd∙le╛it∞j╣φch voleb s detailnφm vysv∞tlenφm.  
  36022.  </P
  36023. ><P
  36024. >   <DIV
  36025. CLASS="table"
  36026. ><A
  36027. NAME="AEN6527"
  36028. ></A
  36029. ><P
  36030. ><B
  36031. >Tabulka 23-1. Volby pro p°φkazovou °ßdku</B
  36032. ></P
  36033. ><TABLE
  36034. BORDER="1"
  36035. CLASS="CALSTABLE"
  36036. ><THEAD
  36037. ><TR
  36038. ><TH
  36039. ALIGN="LEFT"
  36040. VALIGN="MIDDLE"
  36041. >Volba</TH
  36042. ><TH
  36043. ALIGN="LEFT"
  36044. VALIGN="MIDDLE"
  36045. >Popis</TH
  36046. ></TR
  36047. ></THEAD
  36048. ><TBODY
  36049. ><TR
  36050. ><TD
  36051. ALIGN="LEFT"
  36052. VALIGN="MIDDLE"
  36053. >-q</TD
  36054. ><TD
  36055. ALIGN="LEFT"
  36056. VALIGN="MIDDLE"
  36057. >        PotlaΦφ v²stup HTTP hlaviΦek. Normßln∞ PHP tiskne HTTP hlaviΦky
  36058.        pro volajφcφ program (typicky WWW server) k p°edßnφ prohlφ╛eΦi.
  36059.        P°i pou╛itφ pro aplikace spou╣t∞nΘ z p°φkazovΘ °ßdky nemajφ hlaviΦky
  36060.        smysl.
  36061.       </TD
  36062. ></TR
  36063. ><TR
  36064. ><TD
  36065. ALIGN="LEFT"
  36066. VALIGN="MIDDLE"
  36067. >-s</TD
  36068. ><TD
  36069. ALIGN="LEFT"
  36070. VALIGN="MIDDLE"
  36071. >        Zobrazφ barevn∞ vysvφcen² zdrojov² soubor s dan²m nßzvem.
  36072.        Je to totΘ╛, jako kdy╛ se zdroj vytiskne pomocφ funkce
  36073.        <A
  36074. HREF="#function.highlight-file"
  36075. ><B
  36076. CLASS="function"
  36077. >highlight_file()</B
  36078. ></A
  36079. > v PHP skriptu.
  36080.       </TD
  36081. ></TR
  36082. ><TR
  36083. ><TD
  36084. ALIGN="LEFT"
  36085. VALIGN="MIDDLE"
  36086. >-f</TD
  36087. ><TD
  36088. ALIGN="LEFT"
  36089. VALIGN="MIDDLE"
  36090. >        Parsuje dan² soubor a hledß syntaktickΘ a fatßlnφ chyby.
  36091.        Tato volba implikuje -q. Pou╛ijte pro ladicφ ·Φely
  36092.        (debugging).       
  36093.       </TD
  36094. ></TR
  36095. ><TR
  36096. ><TD
  36097. ALIGN="LEFT"
  36098. VALIGN="MIDDLE"
  36099. >-v</TD
  36100. ><TD
  36101. ALIGN="LEFT"
  36102. VALIGN="MIDDLE"
  36103. >        Zavolßnφm PHP s tφmto p°epφnaΦem si m∙╛ete vypsat Φφslo verze,
  36104.        nap°. 4.0.6.        
  36105.       </TD
  36106. ></TR
  36107. ><TR
  36108. ><TD
  36109. ALIGN="LEFT"
  36110. VALIGN="MIDDLE"
  36111. >-C</TD
  36112. ><TD
  36113. ALIGN="LEFT"
  36114. VALIGN="MIDDLE"
  36115. >        Za normßlnφch okolnostφ PHP m∞nφ pracovnφ adresß° na ten, kde se
  36116.        nachßzφ spou╣t∞n² skript. To nap°φklad umo╛≥uje otvφrat soubory
  36117.        ve stejnΘm adresß°i urΦenφm pouhΘho nßzvu souboru (bez cesty).
  36118.        Pokud byste toto cht∞li potlaΦit, pou╛ijte tuto volbu.       
  36119.       </TD
  36120. ></TR
  36121. ><TR
  36122. ><TD
  36123. ALIGN="LEFT"
  36124. VALIGN="MIDDLE"
  36125. >-c</TD
  36126. ><TD
  36127. ALIGN="LEFT"
  36128. VALIGN="MIDDLE"
  36129. >        Pou╛itφm tohoto argumentu m∙╛ete specifikovat alternativnφ
  36130.        umφst∞nφ souboru <TT
  36131. CLASS="filename"
  36132. >php.ini</TT
  36133. >, tak╛e PHP bude
  36134.        hledat konfiguraΦnφ soubor zde namφsto implicitnφho umφst∞nφ.       
  36135.       </TD
  36136. ></TR
  36137. ><TR
  36138. ><TD
  36139. ALIGN="LEFT"
  36140. VALIGN="MIDDLE"
  36141. >-d</TD
  36142. ><TD
  36143. ALIGN="LEFT"
  36144. VALIGN="MIDDLE"
  36145. >        Touto volbou m∙╛ete provΘst individußlnφ nastavenφ        
  36146.        <TT
  36147. CLASS="filename"
  36148. >php.ini</TT
  36149. > b∞hem provßd∞nφ skriptu.
  36150.       </TD
  36151. ></TR
  36152. ><TR
  36153. ><TD
  36154. ALIGN="LEFT"
  36155. VALIGN="MIDDLE"
  36156. >-l</TD
  36157. ><TD
  36158. ALIGN="LEFT"
  36159. VALIGN="MIDDLE"
  36160. >        Otestuje dan² soubor na syntaktickΘ chyby. Tato volba implikuje
  36161.        -q. Pou╛ijte ji pro ·Φely lad∞nφ. Nebudou se hledat fatßlnφ chyby
  36162.        (jako jsou nedefinovanΘ funkce). Pokud chcete hledat i fatßlnφ
  36163.        chyby, pou╛ijte -f.       
  36164.       </TD
  36165. ></TR
  36166. ><TR
  36167. ><TD
  36168. ALIGN="LEFT"
  36169. VALIGN="MIDDLE"
  36170. >-m</TD
  36171. ><TD
  36172. ALIGN="LEFT"
  36173. VALIGN="MIDDLE"
  36174. >        Pou╛itφm tΘto volby PHP vypφ╣e zabudovanΘ (a naΦtenΘ) PHP a Zend
  36175.        moduly, Φφsla verzφ PHP a Zend, a takΘ krßtkou informaci o
  36176.        autorsk²ch prßvech k jßdru Zend.       
  36177.       </TD
  36178. ></TR
  36179. ><TR
  36180. ><TD
  36181. ALIGN="LEFT"
  36182. VALIGN="MIDDLE"
  36183. >-i</TD
  36184. ><TD
  36185. ALIGN="LEFT"
  36186. VALIGN="MIDDLE"
  36187. >        Tento p°epφnaΦ zavolß funkci <A
  36188. HREF="#function.phpinfo"
  36189. ><B
  36190. CLASS="function"
  36191. >phpinfo()</B
  36192. ></A
  36193. > a vypφ╣e
  36194.        jejφ v²sledek. Pokud PHP nepracuje sprßvn∞, je dobrΘ spustit
  36195.        <TT
  36196. CLASS="literal"
  36197. >php -i</TT
  36198. > a podφvat se, zda se nevypsala n∞jakß
  36199.        chybovß hlß╣enφ p°ed nebo uvnit° informaΦnφch tabulek.
  36200.       </TD
  36201. ></TR
  36202. ><TR
  36203. ><TD
  36204. ALIGN="LEFT"
  36205. VALIGN="MIDDLE"
  36206. >-h</TD
  36207. ><TD
  36208. ALIGN="LEFT"
  36209. VALIGN="MIDDLE"
  36210. >        Touto volbou zφskßte informace o aktußlnφch volbßch p°φkazovΘ °ßdky
  36211.        a jedno°ßdkovΘ popisy o tom, co d∞lajφ.       
  36212.       </TD
  36213. ></TR
  36214. ></TBODY
  36215. ></TABLE
  36216. ></DIV
  36217. >
  36218.  </P
  36219. ><P
  36220. >   Spustitelnß verze PHP m∙╛e b²t pou╛ita pro spou╣t∞nφ skript∙ absolutn∞
  36221.   nezßvisle na webovskΘm serveru. Pokud jste na unixovΘm systΘmu, m∙╛ete
  36222.   do PHP skriptu p°idat specißlnφ prvnφ °ßdek a ud∞lat z n∞j spustiteln²
  36223.   program - systΘm bude v∞d∞t, jak² program by m∞l skript zpracovßvat.
  36224.   Na Windows m∙╛ete asociovat <TT
  36225. CLASS="literal"
  36226. >php.exe -q</TT
  36227. > se souborovou
  36228.   p°φponou <TT
  36229. CLASS="literal"
  36230. >.php</TT
  36231. > (pro spou╣t∞nφ dvojklikem), nebo m∙╛ete
  36232.   vytvo°it dßvkov² soubor pro spu╣t∞nφ skriptu p°es PHP. Prvnφ °ßdek skriptu
  36233.   pro prßci v Unixu nebude ve Windows vadit, tak╛e tφmto zp∙sobem m∙╛ete
  36234.   psßt programy pro vφce platforem. Jednoduch² p°φklad psanφ PHP programu
  36235.   pro p°φkazovou °ßdku je uveden nφ╛e.    
  36236.  </P
  36237. ><TABLE
  36238. WIDTH="100%"
  36239. BORDER="0"
  36240. CELLPADDING="0"
  36241. CELLSPACING="0"
  36242. CLASS="EXAMPLE"
  36243. ><TR
  36244. ><TD
  36245. ><DIV
  36246. CLASS="example"
  36247. ><A
  36248. NAME="AEN6576"
  36249. ></A
  36250. ><P
  36251. ><B
  36252. >P°φklad 23-1. Skript urΦen² ke spou╣t∞nφ z p°φkazovΘ °ßdky (script.php)</B
  36253. ></P
  36254. ><TABLE
  36255. BORDER="0"
  36256. BGCOLOR="#E0E0E0"
  36257. CELLPADDING="5"
  36258. ><TR
  36259. ><TD
  36260. ><PRE
  36261. CLASS="php"
  36262. >#!/usr/bin/php -q
  36263. <?php
  36264.  
  36265. if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
  36266. ?>
  36267.  
  36268. This is a command line PHP script with one option.
  36269.  
  36270.   Usage:
  36271.   <?php echo $argv[0]; ?> <option>
  36272.  
  36273.   <option> can be some word you would like
  36274.   to print out. With the --help, -help, -h,
  36275.   or -? options, you can get this help.
  36276.  
  36277. <?php
  36278. } else {
  36279.     echo $argv[1];
  36280. }
  36281. ?></PRE
  36282. ></TD
  36283. ></TR
  36284. ></TABLE
  36285. ></DIV
  36286. ></TD
  36287. ></TR
  36288. ></TABLE
  36289. ><P
  36290. >   Ve v²╣e uvedenΘm skriptu jsme pou╛ili specißlnφ prvnφ °ßdek k indikaci,
  36291.   ╛e by tento soubor m∞l b²t spou╣t∞n pomocφ PHP a nem∞l by vypisovat
  36292.   HTTP hlaviΦky. Jsou zde dv∞ prom∞nnΘ, kterΘ m∙╛ete pou╛φt p°i psanφ
  36293.   aplikacφ pro PHP spou╣t∞n²ch z p°φkazovΘ °ßdky:
  36294.   <TT
  36295. CLASS="varname"
  36296. >$argc</TT
  36297. > a
  36298.   <TT
  36299. CLASS="varname"
  36300. >$argv</TT
  36301. >. Prvnφ z nich je poΦet argument∙ + 1 (nßzev
  36302.   b∞╛φcφho skriptu). Druhß je pole obsahujφcφ argumenty, poΦφnaje nßzvem
  36303.   skriptu jako Φφslo 0 (<TT
  36304. CLASS="varname"
  36305. >$argv[0]</TT
  36306. >).
  36307.  </P
  36308. ><P
  36309. >   V ukßzkovΘm programu se testuje, zda je argument∙ vφce Φi mΘn∞ ne╛ jeden.
  36310.   Pokud by argument byl <TT
  36311. CLASS="literal"
  36312. >--help</TT
  36313. >,
  36314.   <TT
  36315. CLASS="literal"
  36316. >-help</TT
  36317. >, <TT
  36318. CLASS="literal"
  36319. >-h</TT
  36320. > nebo <TT
  36321. CLASS="literal"
  36322. >-?</TT
  36323. >,
  36324.   vytiskne se nßpov∞da k programu vΦetn∞ skuteΦnΘho nßzvu skriptu.
  36325.   Pokud by byly p°idßny n∞jakΘ dal╣φ argumenty, vytisknou se na v²stup.  
  36326.  </P
  36327. ><P
  36328. >   Pokud byste cht∞li spou╣t∞t uveden² skript pod Unixem, musφte ho ud∞lat
  36329.   spustiteln²m (nastavit prßva pro spou╣t∞nφ), a pak jednodu╣e napsat
  36330.   <TT
  36331. CLASS="literal"
  36332. >script.php vypis_tohle</TT
  36333. > nebo
  36334.   <TT
  36335. CLASS="literal"
  36336. >script.php -h</TT
  36337. >. Na Windows musφte pro tento ·kol vytvo°it
  36338.   dßvkov² soubor:  
  36339.  </P
  36340. ><TABLE
  36341. WIDTH="100%"
  36342. BORDER="0"
  36343. CELLPADDING="0"
  36344. CELLSPACING="0"
  36345. CLASS="EXAMPLE"
  36346. ><TR
  36347. ><TD
  36348. ><DIV
  36349. CLASS="example"
  36350. ><A
  36351. NAME="AEN6591"
  36352. ></A
  36353. ><P
  36354. ><B
  36355. >P°φklad 23-2. Dßvkov² soubor pro spou╣t∞nφ PHP skriptu z p°φkazovΘ °ßdky (script.bat)</B
  36356. ></P
  36357. ><TABLE
  36358. BORDER="0"
  36359. BGCOLOR="#E0E0E0"
  36360. CELLPADDING="5"
  36361. ><TR
  36362. ><TD
  36363. ><PRE
  36364. CLASS="winbat"
  36365. >@c:\php\php.exe -q script.php %1 %2 %3 %4</PRE
  36366. ></TD
  36367. ></TR
  36368. ></TABLE
  36369. ></DIV
  36370. ></TD
  36371. ></TR
  36372. ></TABLE
  36373. ><P
  36374. >   Za p°edpokladu, ╛e jste v²╣e uveden² program nazvali
  36375.   <TT
  36376. CLASS="filename"
  36377. >script.php</TT
  36378. > a soubor
  36379.   <TT
  36380. CLASS="filename"
  36381. >php.exe</TT
  36382. > mßte ulo╛en² jako
  36383.   <TT
  36384. CLASS="filename"
  36385. >c:\php\php.exe</TT
  36386. >, m∙╛ete tento dßvkov² soubor spou╣t∞t
  36387.   takto:  
  36388.   <TT
  36389. CLASS="literal"
  36390. >script.bat echothis</TT
  36391. > nebo
  36392.   <TT
  36393. CLASS="literal"
  36394. >script.bat -h</TT
  36395. >.
  36396.  </P
  36397. ><P
  36398. >   Viz takΘ dokumentaci roz╣φ°enφ <A
  36399. HREF="#ref.readline"
  36400. >Readline</A
  36401. >,
  36402.   kde najdete vφce funkcφ pro pou╛itφ k aplikacφm PHP spou╣t∞n²ch z
  36403.   p°φkazovΘ °ßdky.  
  36404.  </P
  36405. ></DIV
  36406. ></DIV
  36407. ><DIV
  36408. CLASS="PART"
  36409. ><A
  36410. NAME="funcref"
  36411. ></A
  36412. ><DIV
  36413. CLASS="TITLEPAGE"
  36414. ><H1
  36415. CLASS="title"
  36416. >V. Reference funkcφ</H1
  36417. ><DIV
  36418. CLASS="TOC"
  36419. ><DL
  36420. ><DT
  36421. ><B
  36422. >Obsah</B
  36423. ></DT
  36424. ><DT
  36425. >I. <A
  36426. HREF="#ref.apache"
  36427. >Funkce specifickΘ pro Apache</A
  36428. ></DT
  36429. ><DT
  36430. >II. <A
  36431. HREF="#ref.array"
  36432. >Funkce pro prßci s poli</A
  36433. ></DT
  36434. ><DT
  36435. >III. <A
  36436. HREF="#ref.aspell"
  36437. >Aspell funkce [zastaralΘ]</A
  36438. ></DT
  36439. ><DT
  36440. >IV. <A
  36441. HREF="#ref.bc"
  36442. >BCMath funkce pro v²poΦty s libovolnou p°esnostφ</A
  36443. ></DT
  36444. ><DT
  36445. >V. <A
  36446. HREF="#ref.bzip2"
  36447. >Kompresnφ funkce bzip2</A
  36448. ></DT
  36449. ><DT
  36450. >VI. <A
  36451. HREF="#ref.calendar"
  36452. >Kalendß°ovΘ funkce</A
  36453. ></DT
  36454. ><DT
  36455. >VII. <A
  36456. HREF="#ref.ccvs"
  36457. >CCVS API Functions</A
  36458. ></DT
  36459. ><DT
  36460. >VIII. <A
  36461. HREF="#ref.com"
  36462. >Funkce na podporu COM ve Windows</A
  36463. ></DT
  36464. ><DT
  36465. >IX. <A
  36466. HREF="#ref.classobj"
  36467. >Funkce pro prßci s t°φdami/objekty</A
  36468. ></DT
  36469. ><DT
  36470. >X. <A
  36471. HREF="#ref.cpdf"
  36472. >ClibPDF functions</A
  36473. ></DT
  36474. ><DT
  36475. >XI. <A
  36476. HREF="#ref.crack"
  36477. >Crack functions</A
  36478. ></DT
  36479. ><DT
  36480. >XII. <A
  36481. HREF="#ref.curl"
  36482. >Funkce pro prßci s CURL, Client URL Library</A
  36483. ></DT
  36484. ><DT
  36485. >XIII. <A
  36486. HREF="#ref.cybercash"
  36487. >Cybercash platebnφ funkce</A
  36488. ></DT
  36489. ><DT
  36490. >XIV. <A
  36491. HREF="#ref.cyrus"
  36492. >Cyrus IMAP administration functions</A
  36493. ></DT
  36494. ><DT
  36495. >XV. <A
  36496. HREF="#ref.ctype"
  36497. >Character type functions</A
  36498. ></DT
  36499. ><DT
  36500. >XVI. <A
  36501. HREF="#ref.dba"
  36502. >Database (dbm-style) abstraction layer functions</A
  36503. ></DT
  36504. ><DT
  36505. >XVII. <A
  36506. HREF="#ref.datetime"
  36507. >Funkce pro datum a Φas</A
  36508. ></DT
  36509. ><DT
  36510. >XVIII. <A
  36511. HREF="#ref.dbase"
  36512. >dBase functions</A
  36513. ></DT
  36514. ><DT
  36515. >XIX. <A
  36516. HREF="#ref.dbm"
  36517. >DBM Funkce [zastaralΘ]</A
  36518. ></DT
  36519. ><DT
  36520. >XX. <A
  36521. HREF="#ref.dbx"
  36522. >dbx functions</A
  36523. ></DT
  36524. ><DT
  36525. >XXI. <A
  36526. HREF="#ref.dbplus"
  36527. >DB++ Functions</A
  36528. ></DT
  36529. ><DT
  36530. >XXII. <A
  36531. HREF="#ref.dio"
  36532. >Direct IO functions</A
  36533. ></DT
  36534. ><DT
  36535. >XXIII. <A
  36536. HREF="#ref.dir"
  36537. >Adresß°ovΘ funkce</A
  36538. ></DT
  36539. ><DT
  36540. >XXIV. <A
  36541. HREF="#ref.domxml"
  36542. >DOM XML functions</A
  36543. ></DT
  36544. ><DT
  36545. >XXV. <A
  36546. HREF="#ref.dotnet"
  36547. >.NET functions</A
  36548. ></DT
  36549. ><DT
  36550. >XXVI. <A
  36551. HREF="#ref.errorfunc"
  36552. >Error Handling and Logging Functions</A
  36553. ></DT
  36554. ><DT
  36555. >XXVII. <A
  36556. HREF="#ref.fam"
  36557. >File alteration monitor functions</A
  36558. ></DT
  36559. ><DT
  36560. >XXVIII. <A
  36561. HREF="#ref.fbsql"
  36562. >FrontBase Functions</A
  36563. ></DT
  36564. ><DT
  36565. >XXIX. <A
  36566. HREF="#ref.filepro"
  36567. >filePro funkce</A
  36568. ></DT
  36569. ><DT
  36570. >XXX. <A
  36571. HREF="#ref.filesystem"
  36572. >Funkce filesystΘmu</A
  36573. ></DT
  36574. ><DT
  36575. >XXXI. <A
  36576. HREF="#ref.fdf"
  36577. >Forms Data Format functions</A
  36578. ></DT
  36579. ><DT
  36580. >XXXII. <A
  36581. HREF="#ref.fribidi"
  36582. >FriBiDi functions</A
  36583. ></DT
  36584. ><DT
  36585. >XXXIII. <A
  36586. HREF="#ref.ftp"
  36587. >FTP functions</A
  36588. ></DT
  36589. ><DT
  36590. >XXXIV. <A
  36591. HREF="#ref.funchand"
  36592. >Funkce pro prßci s funkcemi</A
  36593. ></DT
  36594. ><DT
  36595. >XXXV. <A
  36596. HREF="#ref.gettext"
  36597. >Gettext</A
  36598. ></DT
  36599. ><DT
  36600. >XXXVI. <A
  36601. HREF="#ref.gmp"
  36602. >GMP functions</A
  36603. ></DT
  36604. ><DT
  36605. >XXXVII. <A
  36606. HREF="#ref.http"
  36607. >HTTP funkce</A
  36608. ></DT
  36609. ><DT
  36610. >XXXVIII. <A
  36611. HREF="#ref.hyperwave"
  36612. >Hyperwave functions</A
  36613. ></DT
  36614. ><DT
  36615. >XXXIX. <A
  36616. HREF="#ref.hwapi"
  36617. >Hyperwave API functions</A
  36618. ></DT
  36619. ><DT
  36620. >XL. <A
  36621. HREF="#ref.iconv"
  36622. >iconv functions</A
  36623. ></DT
  36624. ><DT
  36625. >XLI. <A
  36626. HREF="#ref.image"
  36627. >Image functions</A
  36628. ></DT
  36629. ><DT
  36630. >XLII. <A
  36631. HREF="#ref.imap"
  36632. >IMAP, POP3 and NNTP functions</A
  36633. ></DT
  36634. ><DT
  36635. >XLIII. <A
  36636. HREF="#ref.ifx"
  36637. >Informix functions</A
  36638. ></DT
  36639. ><DT
  36640. >XLIV. <A
  36641. HREF="#ref.ibase"
  36642. >InterBase functions</A
  36643. ></DT
  36644. ><DT
  36645. >XLV. <A
  36646. HREF="#ref.ingres"
  36647. >Ingres II functions</A
  36648. ></DT
  36649. ><DT
  36650. >XLVI. <A
  36651. HREF="#ref.ircg"
  36652. >IRC Gateway Functions</A
  36653. ></DT
  36654. ><DT
  36655. >XLVII. <A
  36656. HREF="#ref.java"
  36657. >PHP / Java Integration</A
  36658. ></DT
  36659. ><DT
  36660. >XLVIII. <A
  36661. HREF="#ref.ldap"
  36662. >LDAP functions</A
  36663. ></DT
  36664. ><DT
  36665. >XLIX. <A
  36666. HREF="#ref.mail"
  36667. >MailovΘ funkce</A
  36668. ></DT
  36669. ><DT
  36670. >L. <A
  36671. HREF="#ref.mailparse"
  36672. >mailparse functions</A
  36673. ></DT
  36674. ><DT
  36675. >LI. <A
  36676. HREF="#ref.math"
  36677. >MatematickΘ funkce</A
  36678. ></DT
  36679. ><DT
  36680. >LII. <A
  36681. HREF="#ref.mbstring"
  36682. >Multi-Byte String Functions</A
  36683. ></DT
  36684. ><DT
  36685. >LIII. <A
  36686. HREF="#ref.mcal"
  36687. >MCAL functions</A
  36688. ></DT
  36689. ><DT
  36690. >LIV. <A
  36691. HREF="#ref.mcrypt"
  36692. >Mcrypt Encryption Functions</A
  36693. ></DT
  36694. ><DT
  36695. >LV. <A
  36696. HREF="#ref.mcve"
  36697. >MCVE Payment Functions</A
  36698. ></DT
  36699. ><DT
  36700. >LVI. <A
  36701. HREF="#ref.mhash"
  36702. >Mhash funkce</A
  36703. ></DT
  36704. ><DT
  36705. >LVII. <A
  36706. HREF="#ref.mime-magic"
  36707. >Mimetype Functions</A
  36708. ></DT
  36709. ><DT
  36710. >LVIII. <A
  36711. HREF="#ref.mssql"
  36712. >Microsoft SQL Server functions</A
  36713. ></DT
  36714. ><DT
  36715. >LIX. <A
  36716. HREF="#ref.ming"
  36717. >Ming functions for Flash</A
  36718. ></DT
  36719. ><DT
  36720. >LX. <A
  36721. HREF="#ref.misc"
  36722. >R∙znΘ funkce</A
  36723. ></DT
  36724. ><DT
  36725. >LXI. <A
  36726. HREF="#ref.mnogo"
  36727. >mnoGoSearch Functions</A
  36728. ></DT
  36729. ><DT
  36730. >LXII. <A
  36731. HREF="#ref.msql"
  36732. >mSQL functions</A
  36733. ></DT
  36734. ><DT
  36735. >LXIII. <A
  36736. HREF="#ref.mysql"
  36737. >MySQL funkce</A
  36738. ></DT
  36739. ><DT
  36740. >LXIV. <A
  36741. HREF="#ref.mysqli"
  36742. >Improved MySQL Extension</A
  36743. ></DT
  36744. ><DT
  36745. >LXV. <A
  36746. HREF="#ref.msession"
  36747. >Mohawk Software session handler functions</A
  36748. ></DT
  36749. ><DT
  36750. >LXVI. <A
  36751. HREF="#ref.muscat"
  36752. >muscat functions</A
  36753. ></DT
  36754. ><DT
  36755. >LXVII. <A
  36756. HREF="#ref.network"
  36757. >Sφ╗ovΘ funkce</A
  36758. ></DT
  36759. ><DT
  36760. >LXVIII. <A
  36761. HREF="#ref.ncurses"
  36762. >Ncurses terminal screen control functions</A
  36763. ></DT
  36764. ><DT
  36765. >LXIX. <A
  36766. HREF="#ref.notes"
  36767. >Lotus Notes functions</A
  36768. ></DT
  36769. ><DT
  36770. >LXX. <A
  36771. HREF="#ref.nsapi"
  36772. >NSAPI-specific Functions</A
  36773. ></DT
  36774. ><DT
  36775. >LXXI. <A
  36776. HREF="#ref.odbc"
  36777. >Unified ODBC functions</A
  36778. ></DT
  36779. ><DT
  36780. >LXXII. <A
  36781. HREF="#ref.objaggregation"
  36782. >Object Aggregation/Composition Functions</A
  36783. ></DT
  36784. ><DT
  36785. >LXXIII. <A
  36786. HREF="#ref.oci8"
  36787. >Oracle 8 functions</A
  36788. ></DT
  36789. ><DT
  36790. >LXXIV. <A
  36791. HREF="#ref.openssl"
  36792. >OpenSSL funkce</A
  36793. ></DT
  36794. ><DT
  36795. >LXXV. <A
  36796. HREF="#ref.oracle"
  36797. >Oracle functions</A
  36798. ></DT
  36799. ><DT
  36800. >LXXVI. <A
  36801. HREF="#ref.ovrimos"
  36802. >Ovrimos SQL functions</A
  36803. ></DT
  36804. ><DT
  36805. >LXXVII. <A
  36806. HREF="#ref.outcontrol"
  36807. >Funkce pro °φzenφ v²stupu</A
  36808. ></DT
  36809. ><DT
  36810. >LXXVIII. <A
  36811. HREF="#ref.overload"
  36812. >Object property and method call overloading</A
  36813. ></DT
  36814. ><DT
  36815. >LXXIX. <A
  36816. HREF="#ref.pdf"
  36817. >PDF funkce</A
  36818. ></DT
  36819. ><DT
  36820. >LXXX. <A
  36821. HREF="#ref.pfpro"
  36822. >Funkce pro prßci s Verisign Payflow Pro</A
  36823. ></DT
  36824. ><DT
  36825. >LXXXI. <A
  36826. HREF="#ref.info"
  36827. >PHP volby a informace</A
  36828. ></DT
  36829. ><DT
  36830. >LXXXII. <A
  36831. HREF="#ref.posix"
  36832. >POSIX functions</A
  36833. ></DT
  36834. ><DT
  36835. >LXXXIII. <A
  36836. HREF="#ref.pgsql"
  36837. >PostgreSQL functions</A
  36838. ></DT
  36839. ><DT
  36840. >LXXXIV. <A
  36841. HREF="#ref.pcntl"
  36842. >Process Control Functions</A
  36843. ></DT
  36844. ><DT
  36845. >LXXXV. <A
  36846. HREF="#ref.exec"
  36847. >Funkce spou╣t∞nφ program∙</A
  36848. ></DT
  36849. ><DT
  36850. >LXXXVI. <A
  36851. HREF="#ref.printer"
  36852. >Printer functions</A
  36853. ></DT
  36854. ><DT
  36855. >LXXXVII. <A
  36856. HREF="#ref.pspell"
  36857. >Pspell Functions</A
  36858. ></DT
  36859. ><DT
  36860. >LXXXVIII. <A
  36861. HREF="#ref.readline"
  36862. >GNU Readline</A
  36863. ></DT
  36864. ><DT
  36865. >LXXXIX. <A
  36866. HREF="#ref.recode"
  36867. >GNU Recode funkce</A
  36868. ></DT
  36869. ><DT
  36870. >XC. <A
  36871. HREF="#ref.pcre"
  36872. >Regular Expression Functions (Perl-Compatible)</A
  36873. ></DT
  36874. ><DT
  36875. >XCI. <A
  36876. HREF="#ref.qtdom"
  36877. >qtdom functions</A
  36878. ></DT
  36879. ><DT
  36880. >XCII. <A
  36881. HREF="#ref.regex"
  36882. >Regular Expression Functions (POSIX Extended)</A
  36883. ></DT
  36884. ><DT
  36885. >XCIII. <A
  36886. HREF="#ref.sem"
  36887. >Semaphore, Shared Memory and IPC Functions</A
  36888. ></DT
  36889. ><DT
  36890. >XCIV. <A
  36891. HREF="#ref.sesam"
  36892. >SESAM database functions</A
  36893. ></DT
  36894. ><DT
  36895. >XCV. <A
  36896. HREF="#ref.session"
  36897. >Session handling functions</A
  36898. ></DT
  36899. ><DT
  36900. >XCVI. <A
  36901. HREF="#ref.shmop"
  36902. >Funkce pro prßci se sdφlenou pam∞tφ</A
  36903. ></DT
  36904. ><DT
  36905. >XCVII. <A
  36906. HREF="#ref.sqlite"
  36907. >SQLite</A
  36908. ></DT
  36909. ><DT
  36910. >XCVIII. <A
  36911. HREF="#ref.swf"
  36912. >Shockwave Flash functions</A
  36913. ></DT
  36914. ><DT
  36915. >XCIX. <A
  36916. HREF="#ref.snmp"
  36917. >SNMP functions</A
  36918. ></DT
  36919. ><DT
  36920. >C. <A
  36921. HREF="#ref.sockets"
  36922. >Socket functions</A
  36923. ></DT
  36924. ><DT
  36925. >CI. <A
  36926. HREF="#ref.stream"
  36927. >Stream functions</A
  36928. ></DT
  36929. ><DT
  36930. >CII. <A
  36931. HREF="#ref.strings"
  36932. >Funkce pro prßci s °et∞zci</A
  36933. ></DT
  36934. ><DT
  36935. >CIII. <A
  36936. HREF="#ref.sybase"
  36937. >Sybase functions</A
  36938. ></DT
  36939. ><DT
  36940. >CIV. <A
  36941. HREF="#ref.tidy"
  36942. >tidy Functions</A
  36943. ></DT
  36944. ><DT
  36945. >CV. <A
  36946. HREF="#ref.tokenizer"
  36947. >Tokenizer functions</A
  36948. ></DT
  36949. ><DT
  36950. >CVI. <A
  36951. HREF="#ref.url"
  36952. >URL funkce</A
  36953. ></DT
  36954. ><DT
  36955. >CVII. <A
  36956. HREF="#ref.variables"
  36957. >Variable Functions</A
  36958. ></DT
  36959. ><DT
  36960. >CVIII. <A
  36961. HREF="#ref.vpopmail"
  36962. >vpopmail functions</A
  36963. ></DT
  36964. ><DT
  36965. >CIX. <A
  36966. HREF="#ref.w32api"
  36967. >W32api functions</A
  36968. ></DT
  36969. ><DT
  36970. >CX. <A
  36971. HREF="#ref.wddx"
  36972. >WDDX funkce</A
  36973. ></DT
  36974. ><DT
  36975. >CXI. <A
  36976. HREF="#ref.xml"
  36977. >XML parser functions</A
  36978. ></DT
  36979. ><DT
  36980. >CXII. <A
  36981. HREF="#ref.xmlrpc"
  36982. >XML-RPC functions</A
  36983. ></DT
  36984. ><DT
  36985. >CXIII. <A
  36986. HREF="#ref.xslt"
  36987. >XSLT funkce</A
  36988. ></DT
  36989. ><DT
  36990. >CXIV. <A
  36991. HREF="#ref.yaz"
  36992. >YAZ functions</A
  36993. ></DT
  36994. ><DT
  36995. >CXV. <A
  36996. HREF="#ref.nis"
  36997. >Funkce pro prßci s YP/NIS</A
  36998. ></DT
  36999. ><DT
  37000. >CXVI. <A
  37001. HREF="#ref.zip"
  37002. >Zip File Functions (Read Only Access)</A
  37003. ></DT
  37004. ><DT
  37005. >CXVII. <A
  37006. HREF="#ref.zlib"
  37007. >Zlib Compression Functions</A
  37008. ></DT
  37009. ></DL
  37010. ></DIV
  37011. ></DIV
  37012. ><DIV
  37013. CLASS="reference"
  37014. ><A
  37015. NAME="ref.apache"
  37016. ></A
  37017. ><DIV
  37018. CLASS="TITLEPAGE"
  37019. ><H1
  37020. CLASS="title"
  37021. >I. Funkce specifickΘ pro Apache</H1
  37022. ><DIV
  37023. CLASS="PARTINTRO"
  37024. ><A
  37025. NAME="AEN6607"
  37026. ></A
  37027. ><DIV
  37028. CLASS="section"
  37029. ><H1
  37030. CLASS="section"
  37031. ><A
  37032. NAME="apache.intro"
  37033. ></A
  37034. >┌vod</H1
  37035. ><P
  37036. >      Tyto funkce jsou k dispozici pouze pokud PHP b∞╛φ jako modul Apache 1.x.
  37037.     </P
  37038. ></DIV
  37039. ><DIV
  37040. CLASS="section"
  37041. ><HR><H1
  37042. CLASS="section"
  37043. ><A
  37044. NAME="apache.installation"
  37045. ></A
  37046. >Instalace</H1
  37047. ><P
  37048. >      Instalaci PHP v Apache 1.x viz
  37049.      <A
  37050. HREF="#install.apache"
  37051. >Φßst Apache</A
  37052. > kapitoly
  37053.      o instalaci.
  37054.     </P
  37055. ></DIV
  37056. ><DIV
  37057. CLASS="section"
  37058. ><HR><H1
  37059. CLASS="section"
  37060. ><A
  37061. NAME="apache.configuration"
  37062. ></A
  37063. >Konfigurace b∞hu</H1
  37064. ><P
  37065. >   The behaviour of the Apache PHP module is affected by settings in <TT
  37066. CLASS="filename"
  37067. >php.ini</TT
  37068. >.
  37069.   Configuration settings from <TT
  37070. CLASS="filename"
  37071. >php.ini</TT
  37072. > may be overridden by php_flag settings
  37073.   in the server configuration file or local <TT
  37074. CLASS="filename"
  37075. >.htaccess</TT
  37076. > files.
  37077.  </P
  37078. ><TABLE
  37079. WIDTH="100%"
  37080. BORDER="0"
  37081. CELLPADDING="0"
  37082. CELLSPACING="0"
  37083. CLASS="EXAMPLE"
  37084. ><TR
  37085. ><TD
  37086. ><DIV
  37087. CLASS="example"
  37088. ><A
  37089. NAME="AEN6621"
  37090. ></A
  37091. ><P
  37092. ><B
  37093. >P°φklad 1. Turning off PHP parsing for a directory using <TT
  37094. CLASS="filename"
  37095. >.htaccess</TT
  37096. ></B
  37097. ></P
  37098. ><TABLE
  37099. BORDER="0"
  37100. BGCOLOR="#E0E0E0"
  37101. CELLPADDING="5"
  37102. ><TR
  37103. ><TD
  37104. ><PRE
  37105. CLASS="programlisting"
  37106. >php_flag engine off</PRE
  37107. ></TD
  37108. ></TR
  37109. ></TABLE
  37110. ></DIV
  37111. ></TD
  37112. ></TR
  37113. ></TABLE
  37114. ><P
  37115. >   <DIV
  37116. CLASS="table"
  37117. ><A
  37118. NAME="AEN6626"
  37119. ></A
  37120. ><P
  37121. ><B
  37122. >Tabulka 1. Apache configuration options</B
  37123. ></P
  37124. ><TABLE
  37125. BORDER="1"
  37126. CLASS="CALSTABLE"
  37127. ><THEAD
  37128. ><TR
  37129. ><TH
  37130. ALIGN="LEFT"
  37131. VALIGN="MIDDLE"
  37132. >Name</TH
  37133. ><TH
  37134. ALIGN="LEFT"
  37135. VALIGN="MIDDLE"
  37136. >Default</TH
  37137. ><TH
  37138. ALIGN="LEFT"
  37139. VALIGN="MIDDLE"
  37140. >Changeable</TH
  37141. ><TH
  37142. ALIGN="LEFT"
  37143. VALIGN="MIDDLE"
  37144. >Function</TH
  37145. ></TR
  37146. ></THEAD
  37147. ><TBODY
  37148. ><TR
  37149. ><TD
  37150. ALIGN="LEFT"
  37151. VALIGN="MIDDLE"
  37152. >engine</TD
  37153. ><TD
  37154. ALIGN="LEFT"
  37155. VALIGN="MIDDLE"
  37156. >On</TD
  37157. ><TD
  37158. ALIGN="LEFT"
  37159. VALIGN="MIDDLE"
  37160. >PHP_INI_ALL</TD
  37161. ><TD
  37162. ALIGN="LEFT"
  37163. VALIGN="MIDDLE"
  37164. >turns PHP parsing on or off</TD
  37165. ></TR
  37166. ><TR
  37167. ><TD
  37168. ALIGN="LEFT"
  37169. VALIGN="MIDDLE"
  37170. >child_terminate</TD
  37171. ><TD
  37172. ALIGN="LEFT"
  37173. VALIGN="MIDDLE"
  37174. >Off</TD
  37175. ><TD
  37176. ALIGN="LEFT"
  37177. VALIGN="MIDDLE"
  37178. >PHP_INI_ALL</TD
  37179. ><TD
  37180. ALIGN="LEFT"
  37181. VALIGN="MIDDLE"
  37182. >        specify whether PHP scripts may request child process termination on end of request, 
  37183.        see also <A
  37184. HREF="#function.apache-child-terminate"
  37185. ><B
  37186. CLASS="function"
  37187. >apache_child_terminate()</B
  37188. ></A
  37189. >
  37190.       </TD
  37191. ></TR
  37192. ><TR
  37193. ><TD
  37194. ALIGN="LEFT"
  37195. VALIGN="MIDDLE"
  37196. >last_modified</TD
  37197. ><TD
  37198. ALIGN="LEFT"
  37199. VALIGN="MIDDLE"
  37200. >Off</TD
  37201. ><TD
  37202. ALIGN="LEFT"
  37203. VALIGN="MIDDLE"
  37204. >PHP_INI_ALL</TD
  37205. ><TD
  37206. ALIGN="LEFT"
  37207. VALIGN="MIDDLE"
  37208. >send PHP scripts modification date as Last-Modified: header for this request</TD
  37209. ></TR
  37210. ><TR
  37211. ><TD
  37212. ALIGN="LEFT"
  37213. VALIGN="MIDDLE"
  37214. >xbithack</TD
  37215. ><TD
  37216. ALIGN="LEFT"
  37217. VALIGN="MIDDLE"
  37218. >Off</TD
  37219. ><TD
  37220. ALIGN="LEFT"
  37221. VALIGN="MIDDLE"
  37222. >PHP_INI_ALL</TD
  37223. ><TD
  37224. ALIGN="LEFT"
  37225. VALIGN="MIDDLE"
  37226. >parse files with executable bit set as PHP regardless of their file ending</TD
  37227. ></TR
  37228. ></TBODY
  37229. ></TABLE
  37230. ></DIV
  37231. >
  37232.  </P
  37233. ><P
  37234. >Zde je struΦnΘ vysv∞tlenφ
  37235. konfiguraΦnφch direktiv.</P
  37236. ><P
  37237. >  <P
  37238. ></P
  37239. ><DIV
  37240. CLASS="variablelist"
  37241. ><DL
  37242. ><DT
  37243. ><A
  37244. NAME="ini.engine"
  37245. ></A
  37246. ><TT
  37247. CLASS="parameter"
  37248. ><I
  37249. >engine</I
  37250. ></TT
  37251. >
  37252.    <A
  37253. HREF="#language.types.boolean"
  37254. ><B
  37255. CLASS="type"
  37256. >boolean</B
  37257. ></A
  37258. ></DT
  37259. ><DD
  37260. ><P
  37261. >      This directive is really only useful in the Apache module
  37262.      version of PHP. It is used by sites that would like to turn
  37263.      PHP parsing on and off on a per-directory or per-virtual
  37264.      server basis. By putting <TT
  37265. CLASS="userinput"
  37266. ><B
  37267. >engine off</B
  37268. ></TT
  37269. >
  37270.      in the appropriate places in the <TT
  37271. CLASS="filename"
  37272. >httpd.conf</TT
  37273. > file, PHP can
  37274.      be enabled or disabled.
  37275.     </P
  37276. ></DD
  37277. ></DL
  37278. ></DIV
  37279. >
  37280.  </P
  37281. ></DIV
  37282. ><DIV
  37283. CLASS="section"
  37284. ><HR><H1
  37285. CLASS="section"
  37286. ><A
  37287. NAME="apache.resources"
  37288. ></A
  37289. >Typy prost°edk∙</H1
  37290. ><P
  37291. >Toto roz╣φ°enφ nemß definovßn ╛ßdn² typ prost°edku
  37292. (resource).</P
  37293. ></DIV
  37294. ><DIV
  37295. CLASS="section"
  37296. ><HR><H1
  37297. CLASS="section"
  37298. ><A
  37299. NAME="apache.constants"
  37300. ></A
  37301. >P°eddefinovanΘ konstanty</H1
  37302. ><P
  37303. >Toto roz╣φ°enφ nemß definovßny ╛ßdnΘ
  37304. konstanty.</P
  37305. ></DIV
  37306. ></DIV
  37307. ><DIV
  37308. CLASS="TOC"
  37309. ><DL
  37310. ><DT
  37311. ><B
  37312. >Obsah</B
  37313. ></DT
  37314. ><DT
  37315. ><A
  37316. HREF="#function.apache-child-terminate"
  37317. >apache_child_terminate</A
  37318. > -- Terminate apache process after this request</DT
  37319. ><DT
  37320. ><A
  37321. HREF="#function.apache-get-version"
  37322. >apache_get_version</A
  37323. > -- 
  37324.      Fetch Apache version
  37325.     </DT
  37326. ><DT
  37327. ><A
  37328. HREF="#function.apache-lookup-uri"
  37329. >apache_lookup_uri</A
  37330. > -- 
  37331.      Provßdφ ΦßsteΦn² po╛adavek na zadanou URI a vracφ v╣echno info o nφ
  37332.     </DT
  37333. ><DT
  37334. ><A
  37335. HREF="#function.apache-note"
  37336. >apache_note</A
  37337. > -- Zφskßvß a nastavuje poznßmky po╛adavku u Apache.</DT
  37338. ><DT
  37339. ><A
  37340. HREF="#function.apache-request-headers"
  37341. >apache_request_headers</A
  37342. > -- Fetch all HTTP request headers</DT
  37343. ><DT
  37344. ><A
  37345. HREF="#function.apache-response-headers"
  37346. >apache_response_headers</A
  37347. > -- 
  37348.      Fetch all HTTP response headers
  37349.     </DT
  37350. ><DT
  37351. ><A
  37352. HREF="#function.apache-setenv"
  37353. >apache_setenv</A
  37354. > -- Set an Apache subprocess_env variable</DT
  37355. ><DT
  37356. ><A
  37357. HREF="#function.ascii2ebcdic"
  37358. >ascii2ebcdic</A
  37359. > -- P°eklßdß °et∞zec z ASCII do EBCDIC</DT
  37360. ><DT
  37361. ><A
  37362. HREF="#function.ebcdic2ascii"
  37363. >ebcdic2ascii</A
  37364. > -- P°eklßdß °et∞zec z EBCDIC do ASCII</DT
  37365. ><DT
  37366. ><A
  37367. HREF="#function.getallheaders"
  37368. >getallheaders</A
  37369. > -- Zφskßvß v╣echny hlaviΦky HTTP po╛adavku</DT
  37370. ><DT
  37371. ><A
  37372. HREF="#function.virtual"
  37373. >virtual</A
  37374. > -- Provßdφ sub-po╛adavek Apache</DT
  37375. ></DL
  37376. ></DIV
  37377. ></DIV
  37378. ><H1
  37379. ><A
  37380. NAME="function.apache-child-terminate"
  37381. ></A
  37382. >apache_child_terminate</H1
  37383. ><DIV
  37384. CLASS="refnamediv"
  37385. ><A
  37386. NAME="AEN6675"
  37387. ></A
  37388. ><P
  37389. >    (PHP 4 >= 4.0.5)</P
  37390. >apache_child_terminate -- Terminate apache process after this request</DIV
  37391. ><DIV
  37392. CLASS="refsect1"
  37393. ><A
  37394. NAME="AEN6678"
  37395. ></A
  37396. ><H2
  37397. >Description</H2
  37398. >bool <B
  37399. CLASS="methodname"
  37400. >apache_child_terminate</B
  37401. > ( void )<BR
  37402. ></BR
  37403. ><P
  37404. >      <B
  37405. CLASS="function"
  37406. >apache_child_terminate()</B
  37407. > will register the
  37408.      Apache process executing the current PHP request for termination
  37409.      once execution of PHP code it is completed. It may be used to
  37410.      terminate a process after a script with high memory consumption has
  37411.      been run as memory will usually only be freed internally but not
  37412.      given back to the operating system. 
  37413.     </P
  37414. ><DIV
  37415. CLASS="note"
  37416. ><BLOCKQUOTE
  37417. CLASS="note"
  37418. ><P
  37419. ><B
  37420. >Poznßmka: </B
  37421. >
  37422.       The availability of this feature is controlled by the <TT
  37423. CLASS="filename"
  37424. >php.ini</TT
  37425. > directive
  37426.       <TT
  37427. CLASS="option"
  37428. >child_terminate</TT
  37429. >, which is set to <TT
  37430. CLASS="literal"
  37431. >off</TT
  37432. >
  37433.       by default.
  37434.      </P
  37435. ><P
  37436. >       This feature is also not available on multithreaded versions of apache 
  37437.       like the win32 version.
  37438.      </P
  37439. ></BLOCKQUOTE
  37440. ></DIV
  37441. ><P
  37442. >      See also <A
  37443. HREF="#function.exit"
  37444. ><B
  37445. CLASS="function"
  37446. >exit()</B
  37447. ></A
  37448. >.
  37449.     </P
  37450. ></DIV
  37451. ><H1
  37452. ><A
  37453. NAME="function.apache-get-version"
  37454. ></A
  37455. >apache_get_version</H1
  37456. ><DIV
  37457. CLASS="refnamediv"
  37458. ><A
  37459. NAME="AEN6695"
  37460. ></A
  37461. ><P
  37462. >    (PHP 4 >= 4.3.2)</P
  37463. >apache_get_version -- 
  37464.      Fetch Apache version
  37465.     </DIV
  37466. ><DIV
  37467. CLASS="refsect1"
  37468. ><A
  37469. NAME="AEN6698"
  37470. ></A
  37471. ><H2
  37472. >Description</H2
  37473. >string <B
  37474. CLASS="methodname"
  37475. >apache_get_version</B
  37476. > ( void )<BR
  37477. ></BR
  37478. ><P
  37479. >      <B
  37480. CLASS="function"
  37481. >apache_get_version()</B
  37482. > returns the version of Apache as
  37483.      string, or <TT
  37484. CLASS="constant"
  37485. ><B
  37486. >FALSE</B
  37487. ></TT
  37488. > on failure.
  37489.     </P
  37490. ><TABLE
  37491. WIDTH="100%"
  37492. BORDER="0"
  37493. CELLPADDING="0"
  37494. CELLSPACING="0"
  37495. CLASS="EXAMPLE"
  37496. ><TR
  37497. ><TD
  37498. ><DIV
  37499. CLASS="example"
  37500. ><A
  37501. NAME="AEN6707"
  37502. ></A
  37503. ><P
  37504. ><B
  37505. >P°φklad 1. <B
  37506. CLASS="function"
  37507. >apache_get_version()</B
  37508. > example</B
  37509. ></P
  37510. ><TABLE
  37511. BORDER="0"
  37512. BGCOLOR="#E0E0E0"
  37513. CELLPADDING="5"
  37514. ><TR
  37515. ><TD
  37516. ><PRE
  37517. CLASS="php"
  37518. ><?php
  37519. $version = apache_get_version();
  37520. echo "$version \n <br \>";
  37521. ?></PRE
  37522. ></TD
  37523. ></TR
  37524. ></TABLE
  37525. ><P
  37526. >       The printout of the above program will look similar to:
  37527.      </P
  37528. ><TABLE
  37529. BORDER="0"
  37530. BGCOLOR="#E0E0E0"
  37531. CELLPADDING="5"
  37532. ><TR
  37533. ><TD
  37534. ><PRE
  37535. CLASS="screen"
  37536. >Apache/1.3.29 (Unix) PHP/4.3.4</PRE
  37537. ></TD
  37538. ></TR
  37539. ></TABLE
  37540. ></DIV
  37541. ></TD
  37542. ></TR
  37543. ></TABLE
  37544. ><P
  37545. >      See also <A
  37546. HREF="#function.phpinfo"
  37547. ><B
  37548. CLASS="function"
  37549. >phpinfo()</B
  37550. ></A
  37551. >.
  37552.     </P
  37553. ></DIV
  37554. ><H1
  37555. ><A
  37556. NAME="function.apache-lookup-uri"
  37557. ></A
  37558. >apache_lookup_uri</H1
  37559. ><DIV
  37560. CLASS="refnamediv"
  37561. ><A
  37562. NAME="AEN6716"
  37563. ></A
  37564. ><P
  37565. >    (PHP 3>= 3.0.4, PHP 4 )</P
  37566. >apache_lookup_uri -- 
  37567.      Provßdφ ΦßsteΦn² po╛adavek na zadanou URI a vracφ v╣echno info o nφ
  37568.     </DIV
  37569. ><DIV
  37570. CLASS="refsect1"
  37571. ><A
  37572. NAME="AEN6719"
  37573. ></A
  37574. ><H2
  37575. >Popis</H2
  37576. >class <B
  37577. CLASS="methodname"
  37578. >apache_lookup_uri</B
  37579. > ( string filename)<BR
  37580. ></BR
  37581. ><P
  37582. >      Tato funkce provßdφ ΦßsteΦn² po╛adavek na URI. Jde jen tak daleko, aby
  37583.      zφskala v╣echny d∙le╛itΘ informace o danΘm zdroji a vracφ tyto informace
  37584.      ve t°φd∞. Vlastnosti tΘto t°φdy jsou:
  37585.      <P
  37586. ></P
  37587. ><TABLE
  37588. BORDER="0"
  37589. ><TBODY
  37590. ><TR
  37591. ><TD
  37592. >status</TD
  37593. ></TR
  37594. ><TR
  37595. ><TD
  37596. >the_request</TD
  37597. ></TR
  37598. ><TR
  37599. ><TD
  37600. >status_line</TD
  37601. ></TR
  37602. ><TR
  37603. ><TD
  37604. >method</TD
  37605. ></TR
  37606. ><TR
  37607. ><TD
  37608. >content_type</TD
  37609. ></TR
  37610. ><TR
  37611. ><TD
  37612. >handler</TD
  37613. ></TR
  37614. ><TR
  37615. ><TD
  37616. >uri</TD
  37617. ></TR
  37618. ><TR
  37619. ><TD
  37620. >filename</TD
  37621. ></TR
  37622. ><TR
  37623. ><TD
  37624. >path_info</TD
  37625. ></TR
  37626. ><TR
  37627. ><TD
  37628. >args</TD
  37629. ></TR
  37630. ><TR
  37631. ><TD
  37632. >boundary</TD
  37633. ></TR
  37634. ><TR
  37635. ><TD
  37636. >no_cache</TD
  37637. ></TR
  37638. ><TR
  37639. ><TD
  37640. >no_local_copy</TD
  37641. ></TR
  37642. ><TR
  37643. ><TD
  37644. >allowed</TD
  37645. ></TR
  37646. ><TR
  37647. ><TD
  37648. >send_bodyct</TD
  37649. ></TR
  37650. ><TR
  37651. ><TD
  37652. >bytes_sent</TD
  37653. ></TR
  37654. ><TR
  37655. ><TD
  37656. >byterange</TD
  37657. ></TR
  37658. ><TR
  37659. ><TD
  37660. >clength</TD
  37661. ></TR
  37662. ><TR
  37663. ><TD
  37664. >unparsed_uri</TD
  37665. ></TR
  37666. ><TR
  37667. ><TD
  37668. >mtime</TD
  37669. ></TR
  37670. ><TR
  37671. ><TD
  37672. >request_time</TD
  37673. ></TR
  37674. ></TBODY
  37675. ></TABLE
  37676. ><P
  37677. ></P
  37678. >
  37679.     </P
  37680. ><DIV
  37681. CLASS="note"
  37682. ><BLOCKQUOTE
  37683. CLASS="note"
  37684. ><P
  37685. ><B
  37686. >Poznßmka: </B
  37687. >
  37688.       <B
  37689. CLASS="function"
  37690. >apache_lookup_uri()</B
  37691. > pouze, pokud je PHP nainstalovßno
  37692.       jako modul Apache.
  37693.      </P
  37694. ></BLOCKQUOTE
  37695. ></DIV
  37696. ></DIV
  37697. ><H1
  37698. ><A
  37699. NAME="function.apache-note"
  37700. ></A
  37701. >apache_note</H1
  37702. ><DIV
  37703. CLASS="refnamediv"
  37704. ><A
  37705. NAME="AEN6754"
  37706. ></A
  37707. ><P
  37708. >    (PHP 3>= 3.0.2, PHP 4 )</P
  37709. >apache_note -- Zφskßvß a nastavuje poznßmky po╛adavku u Apache.</DIV
  37710. ><DIV
  37711. CLASS="refsect1"
  37712. ><A
  37713. NAME="AEN6757"
  37714. ></A
  37715. ><H2
  37716. >Popis</H2
  37717. >string <B
  37718. CLASS="methodname"
  37719. >apache_note</B
  37720. > ( string note_name [, string note_value])<BR
  37721. ></BR
  37722. ><P
  37723. >      <B
  37724. CLASS="function"
  37725. >apache_note()</B
  37726. > je funkce specifickß pro Apache, kterß
  37727.      zφskßvß a nastavuje hodnoty v tabulce <TT
  37728. CLASS="literal"
  37729. >poznßmek</TT
  37730. >
  37731.      po╛adavku. P°i volßnφ s jednφm argumentem vracφ souΦasnou hodnotu poznßmky
  37732.      <TT
  37733. CLASS="literal"
  37734. >note_name</TT
  37735. >. P°i volßnφ se dv∞ma argumenty nastavuje
  37736.      hodnotu poznßmky <TT
  37737. CLASS="literal"
  37738. >note_name</TT
  37739. > na
  37740.      <TT
  37741. CLASS="literal"
  37742. >note_value</TT
  37743. >, a vracφ p°edchozφ hodnotu poznßmky
  37744.      <TT
  37745. CLASS="literal"
  37746. >note_name</TT
  37747. >.
  37748.     </P
  37749. ></DIV
  37750. ><H1
  37751. ><A
  37752. NAME="function.apache-request-headers"
  37753. ></A
  37754. >apache_request_headers</H1
  37755. ><DIV
  37756. CLASS="refnamediv"
  37757. ><A
  37758. NAME="AEN6776"
  37759. ></A
  37760. ><P
  37761. >    (PHP 4 >= 4.3.0)</P
  37762. >apache_request_headers -- Fetch all HTTP request headers</DIV
  37763. ><DIV
  37764. CLASS="refsect1"
  37765. ><A
  37766. NAME="AEN6779"
  37767. ></A
  37768. ><H2
  37769. >Description</H2
  37770. >array <B
  37771. CLASS="methodname"
  37772. >apache_request_headers</B
  37773. > ( void )<BR
  37774. ></BR
  37775. ><P
  37776. >      <B
  37777. CLASS="function"
  37778. >apache_request_headers()</B
  37779. > returns an associative
  37780.      array of all the HTTP headers in the current request.  This is only
  37781.      supported when PHP runs as an <SPAN
  37782. CLASS="productname"
  37783. >Apache</SPAN
  37784. >
  37785.      module.
  37786.     </P
  37787. ><P
  37788. >      <TABLE
  37789. WIDTH="100%"
  37790. BORDER="0"
  37791. CELLPADDING="0"
  37792. CELLSPACING="0"
  37793. CLASS="EXAMPLE"
  37794. ><TR
  37795. ><TD
  37796. ><DIV
  37797. CLASS="example"
  37798. ><A
  37799. NAME="AEN6789"
  37800. ></A
  37801. ><P
  37802. ><B
  37803. >P°φklad 1. <B
  37804. CLASS="function"
  37805. >apache_request_headers()</B
  37806. > example</B
  37807. ></P
  37808. ><TABLE
  37809. BORDER="0"
  37810. BGCOLOR="#E0E0E0"
  37811. CELLPADDING="5"
  37812. ><TR
  37813. ><TD
  37814. ><PRE
  37815. CLASS="php"
  37816. ><?php
  37817. $headers = apache_request_headers();
  37818.  
  37819. foreach ($headers as $header => $value) {
  37820.     echo "$header: $value <br />\n";
  37821. }
  37822. ?></PRE
  37823. ></TD
  37824. ></TR
  37825. ></TABLE
  37826. ></DIV
  37827. ></TD
  37828. ></TR
  37829. ></TABLE
  37830. >
  37831.     </P
  37832. ><DIV
  37833. CLASS="note"
  37834. ><BLOCKQUOTE
  37835. CLASS="note"
  37836. ><P
  37837. ><B
  37838. >Poznßmka: </B
  37839. >
  37840.       Prior to PHP 4.3.0, <B
  37841. CLASS="function"
  37842. >apache_request_headers()</B
  37843. > was
  37844.       called <A
  37845. HREF="#function.getallheaders"
  37846. ><B
  37847. CLASS="function"
  37848. >getallheaders()</B
  37849. ></A
  37850. >.  After PHP 4.3.0,
  37851.       <A
  37852. HREF="#function.getallheaders"
  37853. ><B
  37854. CLASS="function"
  37855. >getallheaders()</B
  37856. ></A
  37857. > is an alias for
  37858.       <B
  37859. CLASS="function"
  37860. >apache_request_headers()</B
  37861. >.
  37862.      </P
  37863. ></BLOCKQUOTE
  37864. ></DIV
  37865. ><DIV
  37866. CLASS="note"
  37867. ><BLOCKQUOTE
  37868. CLASS="note"
  37869. ><P
  37870. ><B
  37871. >Poznßmka: </B
  37872. >
  37873.       You can also get at the value of the common CGI variables by
  37874.       reading them from the environment, which works whether or not
  37875.       you are using PHP as an <SPAN
  37876. CLASS="productname"
  37877. >Apache</SPAN
  37878. > module. Use
  37879.       <A
  37880. HREF="#function.phpinfo"
  37881. ><B
  37882. CLASS="function"
  37883. >phpinfo()</B
  37884. ></A
  37885. > to see a list of all of the available
  37886.       <A
  37887. HREF="#language.variables.predefined"
  37888. >environment variables</A
  37889. >.
  37890.      </P
  37891. ></BLOCKQUOTE
  37892. ></DIV
  37893. ><DIV
  37894. CLASS="note"
  37895. ><BLOCKQUOTE
  37896. CLASS="note"
  37897. ><P
  37898. ><B
  37899. >Poznßmka: </B
  37900. >
  37901.   From PHP 4.3.3 on you can use this function with the
  37902.   <A
  37903. HREF="#ref.nsapi"
  37904. >NSAPI server module</A
  37905. > in Netscape/iPlanet/SunONE
  37906.    webservers, too.
  37907.   </P
  37908. ></BLOCKQUOTE
  37909. ></DIV
  37910. ><P
  37911. >      See also <A
  37912. HREF="#function.apache-response-headers"
  37913. ><B
  37914. CLASS="function"
  37915. >apache_response_headers()</B
  37916. ></A
  37917. >.
  37918.     </P
  37919. ></DIV
  37920. ><H1
  37921. ><A
  37922. NAME="function.apache-response-headers"
  37923. ></A
  37924. >apache_response_headers</H1
  37925. ><DIV
  37926. CLASS="refnamediv"
  37927. ><A
  37928. NAME="AEN6810"
  37929. ></A
  37930. ><P
  37931. >    (PHP 4 >= 4.3.0)</P
  37932. >apache_response_headers -- 
  37933.      Fetch all HTTP response headers
  37934.     </DIV
  37935. ><DIV
  37936. CLASS="refsect1"
  37937. ><A
  37938. NAME="AEN6813"
  37939. ></A
  37940. ><H2
  37941. >Description</H2
  37942. >array <B
  37943. CLASS="methodname"
  37944. >apache_response_headers</B
  37945. > ( void )<BR
  37946. ></BR
  37947. ><P
  37948. >      Returns an array of all Apache response headers.  This functionality
  37949.      is only available in PHP version 4.3.0 and greater.
  37950.     </P
  37951. ><DIV
  37952. CLASS="note"
  37953. ><BLOCKQUOTE
  37954. CLASS="note"
  37955. ><P
  37956. ><B
  37957. >Poznßmka: </B
  37958. >
  37959.   From PHP 4.3.3 on you can use this function with the
  37960.   <A
  37961. HREF="#ref.nsapi"
  37962. >NSAPI server module</A
  37963. > in Netscape/iPlanet/SunONE
  37964.    webservers, too.
  37965.   </P
  37966. ></BLOCKQUOTE
  37967. ></DIV
  37968. ><P
  37969. >      See also <A
  37970. HREF="#function.apache-request-headers"
  37971. ><B
  37972. CLASS="function"
  37973. >apache_request_headers()</B
  37974. ></A
  37975. >, and
  37976.      <A
  37977. HREF="#function.headers-sent"
  37978. ><B
  37979. CLASS="function"
  37980. >headers_sent()</B
  37981. ></A
  37982. >.
  37983.     </P
  37984. ></DIV
  37985. ><H1
  37986. ><A
  37987. NAME="function.apache-setenv"
  37988. ></A
  37989. >apache_setenv</H1
  37990. ><DIV
  37991. CLASS="refnamediv"
  37992. ><A
  37993. NAME="AEN6827"
  37994. ></A
  37995. ><P
  37996. >    (PHP 4 >= 4.2.0)</P
  37997. >apache_setenv -- Set an Apache subprocess_env variable</DIV
  37998. ><DIV
  37999. CLASS="refsect1"
  38000. ><A
  38001. NAME="AEN6830"
  38002. ></A
  38003. ><H2
  38004. >Description</H2
  38005. >int <B
  38006. CLASS="methodname"
  38007. >apache_setenv</B
  38008. > ( string variable, string value [, bool walk_to_top])<BR
  38009. ></BR
  38010. ><P
  38011. >      <DIV
  38012. CLASS="warning"
  38013. ><P
  38014. ></P
  38015. ><TABLE
  38016. CLASS="warning"
  38017. BORDER="1"
  38018. WIDTH="100%"
  38019. ><TR
  38020. ><TD
  38021. ALIGN="CENTER"
  38022. ><B
  38023. >Varovßnφ</B
  38024. ></TD
  38025. ></TR
  38026. ><TR
  38027. ><TD
  38028. ALIGN="LEFT"
  38029. ><P
  38030. >Tato funkce je╣t∞ nenφ
  38031. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  38032. ></TD
  38033. ></TR
  38034. ></TABLE
  38035. ></DIV
  38036. >
  38037.     </P
  38038. ></DIV
  38039. ><H1
  38040. ><A
  38041. NAME="function.ascii2ebcdic"
  38042. ></A
  38043. >ascii2ebcdic</H1
  38044. ><DIV
  38045. CLASS="refnamediv"
  38046. ><A
  38047. NAME="AEN6848"
  38048. ></A
  38049. ><P
  38050. >    (PHP 3>= 3.0.17)</P
  38051. >ascii2ebcdic -- P°eklßdß °et∞zec z ASCII do EBCDIC</DIV
  38052. ><DIV
  38053. CLASS="refsect1"
  38054. ><A
  38055. NAME="AEN6851"
  38056. ></A
  38057. ><H2
  38058. >Popis</H2
  38059. >int <B
  38060. CLASS="methodname"
  38061. >ascii2ebcdic</B
  38062. > ( string ascii_str)<BR
  38063. ></BR
  38064. ><P
  38065. >      <B
  38066. CLASS="function"
  38067. >ascii2ebcdic()</B
  38068. > je funkce specifickß pro Apache dostupnß
  38069.      pouze na operaΦnφch systΘmech zalo╛en²ch na EBCDIC (OS/390, BS2000).
  38070.      P°eklßdß (binßrn∞ bezpeΦn∞) °e╛∞zec v ASCII k≤dovßnφ
  38071.      <TT
  38072. CLASS="parameter"
  38073. ><I
  38074. >ascii_str</I
  38075. ></TT
  38076. > na jeho ekvivalentnφ EBCDIC reprezentaci,
  38077.      a vracφ v²sledek.
  38078.     </P
  38079. ><P
  38080. >      Viz takΘ opaΦnou funkci <A
  38081. HREF="#function.ebcdic2ascii"
  38082. ><B
  38083. CLASS="function"
  38084. >ebcdic2ascii()</B
  38085. ></A
  38086. >
  38087.     </P
  38088. ></DIV
  38089. ><H1
  38090. ><A
  38091. NAME="function.ebcdic2ascii"
  38092. ></A
  38093. >ebcdic2ascii</H1
  38094. ><DIV
  38095. CLASS="refnamediv"
  38096. ><A
  38097. NAME="AEN6865"
  38098. ></A
  38099. ><P
  38100. >    (PHP 3>= 3.0.17)</P
  38101. >ebcdic2ascii -- P°eklßdß °et∞zec z EBCDIC do ASCII</DIV
  38102. ><DIV
  38103. CLASS="refsect1"
  38104. ><A
  38105. NAME="AEN6868"
  38106. ></A
  38107. ><H2
  38108. >Popis</H2
  38109. >int <B
  38110. CLASS="methodname"
  38111. >ebcdic2ascii</B
  38112. > ( string ebcdic_str)<BR
  38113. ></BR
  38114. ><P
  38115. >      <B
  38116. CLASS="function"
  38117. >ebcdic2ascii()</B
  38118. > je funkce specifickß pro Apache dostupnß
  38119.      pouze na operaΦnφch systΘmech zalo╛en²ch na EBCDIC (OS/390, BS2000).
  38120.      P°eklßdß (binßrn∞ bezpeΦn∞) °e╛∞zec v k≤dovßnφ EBCDIC
  38121.      <TT
  38122. CLASS="parameter"
  38123. ><I
  38124. >ascii_str</I
  38125. ></TT
  38126. > na jeho ekvivalentnφ ASCII reprezentaci,
  38127.      a vracφ v²sledek.
  38128.     </P
  38129. ><P
  38130. >      Viz takΘ opaΦnou funkci <A
  38131. HREF="#function.ascii2ebcdic"
  38132. ><B
  38133. CLASS="function"
  38134. >ascii2ebcdic()</B
  38135. ></A
  38136. >
  38137.     </P
  38138. ></DIV
  38139. ><H1
  38140. ><A
  38141. NAME="function.getallheaders"
  38142. ></A
  38143. >getallheaders</H1
  38144. ><DIV
  38145. CLASS="refnamediv"
  38146. ><A
  38147. NAME="AEN6882"
  38148. ></A
  38149. ><P
  38150. >    (PHP 3, PHP 4 )</P
  38151. >getallheaders -- Zφskßvß v╣echny hlaviΦky HTTP po╛adavku</DIV
  38152. ><DIV
  38153. CLASS="refsect1"
  38154. ><A
  38155. NAME="AEN6885"
  38156. ></A
  38157. ><H2
  38158. >Popis</H2
  38159. >array <B
  38160. CLASS="methodname"
  38161. >getallheaders</B
  38162. > ( void )<BR
  38163. ></BR
  38164. ><P
  38165. >      Tato funkce vracφ asociativnφ pole v╣ech HTTP hlaviΦek v souΦasnΘm
  38166.      po╛adavku.
  38167.     </P
  38168. ><P
  38169. >      <DIV
  38170. CLASS="note"
  38171. ><BLOCKQUOTE
  38172. CLASS="note"
  38173. ><P
  38174. ><B
  38175. >Poznßmka: </B
  38176. >
  38177.        Hodnotu b∞╛n²ch CGI prom∞nn²ch m∙╛ete takΘ zφskat tφm, ╛e je p°eΦtete
  38178.        z prost°edφ, co╛ funguje, a╗ pou╛φvßte PHP jako modu Apache nebo ne.
  38179.        Pokud chcete vid∞t seznam v╣ech systΘmov²ch prom∞nn²ch definovan²ch tφmto
  38180.        zp∙sobem, pou╛ijte <A
  38181. HREF="#function.phpinfo"
  38182. ><B
  38183. CLASS="function"
  38184. >phpinfo()</B
  38185. ></A
  38186. >.
  38187.       </P
  38188. ></BLOCKQUOTE
  38189. ></DIV
  38190. >
  38191.     </P
  38192. ><P
  38193. >      <TABLE
  38194. WIDTH="100%"
  38195. BORDER="0"
  38196. CELLPADDING="0"
  38197. CELLSPACING="0"
  38198. CLASS="EXAMPLE"
  38199. ><TR
  38200. ><TD
  38201. ><DIV
  38202. CLASS="example"
  38203. ><A
  38204. NAME="AEN6899"
  38205. ></A
  38206. ><P
  38207. ><B
  38208. >P°φklad 1. <B
  38209. CLASS="function"
  38210. >getallheaders()</B
  38211. > Example</B
  38212. ></P
  38213. ><TABLE
  38214. BORDER="0"
  38215. BGCOLOR="#E0E0E0"
  38216. CELLPADDING="5"
  38217. ><TR
  38218. ><TD
  38219. ><PRE
  38220. CLASS="php"
  38221. >$headers = getallheaders();
  38222. while (list ($header, $value) = each ($headers)) {
  38223.     echo "$header: $value<br>\n";
  38224. }</PRE
  38225. ></TD
  38226. ></TR
  38227. ></TABLE
  38228. ></DIV
  38229. ></TD
  38230. ></TR
  38231. ></TABLE
  38232. >
  38233.     </P
  38234. ><P
  38235. >      Tento p°φklad zobrazφ v╣echny hlaviΦky souΦasnΘho po╛adavku.
  38236.      <DIV
  38237. CLASS="note"
  38238. ><BLOCKQUOTE
  38239. CLASS="note"
  38240. ><P
  38241. ><B
  38242. >Poznßmka: </B
  38243. >
  38244.        <B
  38245. CLASS="function"
  38246. >getallheaders()</B
  38247. > je v souΦasnosti podporovßna jen kdy╛
  38248.        PHP b∞╛φ jako modul <SPAN
  38249. CLASS="productname"
  38250. >Apache</SPAN
  38251. >.
  38252.       </P
  38253. ></BLOCKQUOTE
  38254. ></DIV
  38255. >
  38256.     </P
  38257. ></DIV
  38258. ><H1
  38259. ><A
  38260. NAME="function.virtual"
  38261. ></A
  38262. >virtual</H1
  38263. ><DIV
  38264. CLASS="refnamediv"
  38265. ><A
  38266. NAME="AEN6909"
  38267. ></A
  38268. ><P
  38269. >    (PHP 3, PHP 4 )</P
  38270. >virtual -- Provßdφ sub-po╛adavek Apache</DIV
  38271. ><DIV
  38272. CLASS="refsect1"
  38273. ><A
  38274. NAME="AEN6912"
  38275. ></A
  38276. ><H2
  38277. >Popis</H2
  38278. >int <B
  38279. CLASS="methodname"
  38280. >virtual</B
  38281. > ( string filename)<BR
  38282. ></BR
  38283. ><P
  38284. >      <B
  38285. CLASS="function"
  38286. >virtual()</B
  38287. > je funkce specifickß pro Apache ekvivalentnφ
  38288.      s <!--#include virtual...--> v mod_include.
  38289.      Provßdφ sub-po╛adavek Apache. Je u╛iteΦnß pro vklßdßnφ CGI skript∙ nebo
  38290.      .shtml soubor∙, nebo Φehokoliv jinΘho, co mß Apache parsovat. CGI skripty
  38291.      musφ generovat platnΘ CGI hlaviΦky. To znamenß, ╛e musφ p°inejmen╣φm
  38292.      generovat Content-type hlaviΦku. Pro PHP soubory musφte pou╛φt
  38293.      <A
  38294. HREF="#function.include"
  38295. ><B
  38296. CLASS="function"
  38297. >include()</B
  38298. ></A
  38299. > nebo <A
  38300. HREF="#function.require"
  38301. ><B
  38302. CLASS="function"
  38303. >require()</B
  38304. ></A
  38305. >;
  38306.      <B
  38307. CLASS="function"
  38308. >virtual()</B
  38309. > se nedß pou╛φt k vlo╛enφ dokumentu, kter² je
  38310.      sßm PHP skriptem.
  38311.     </P
  38312. ></DIV
  38313. ></DIV
  38314. ><DIV
  38315. CLASS="reference"
  38316. ><A
  38317. NAME="ref.array"
  38318. ></A
  38319. ><DIV
  38320. CLASS="TITLEPAGE"
  38321. ><H1
  38322. CLASS="title"
  38323. >II. Funkce pro prßci s poli</H1
  38324. ><DIV
  38325. CLASS="PARTINTRO"
  38326. ><A
  38327. NAME="AEN6928"
  38328. ></A
  38329. ><DIV
  38330. CLASS="section"
  38331. ><H1
  38332. CLASS="section"
  38333. ><A
  38334. NAME="array.intro"
  38335. ></A
  38336. >┌vod</H1
  38337. ><P
  38338. >      Tyto funkce vßm umo╛≥ujφ manipulovat a interagovat r∙zn²mi zp∙soby s poli.
  38339.      Pole jsou nezbytnß pro uklßdßnφ a prßci se sadami prom∞nn²ch.
  38340.     </P
  38341. ><P
  38342. >      Podporovßna jsou jednoduchß a vφcerozm∞rnß pole; vytvß°et se dajφ u╛ivatelsky
  38343.      i jako v²stup funkce. Existujφ databßzovΘ funkce na pln∞nφ polφ v²sledky
  38344.      databßzov²ch dotaz∙, a n∞kolik dal╣φch funkcφ vracφ pole.
  38345.     </P
  38346. ><P
  38347. >      Viz takΘ Φßst manußlu <A
  38348. HREF="#language.types.array"
  38349. >pole</A
  38350. >
  38351.      pro detailnφ popis toho, jak jsou pole
  38352.      v PHP implementovßny a jak se pou╛φvajφ.
  38353.     </P
  38354. ></DIV
  38355. ><DIV
  38356. CLASS="section"
  38357. ><HR><H1
  38358. CLASS="section"
  38359. ><A
  38360. NAME="array.requirements"
  38361. ></A
  38362. >Po╛adavky</H1
  38363. ><P
  38364. >Tyto funkce jsou k dispozici jako souΦßst
  38365. standardnφho modulu, kter² je v╛dy dostupn².</P
  38366. ></DIV
  38367. ><DIV
  38368. CLASS="section"
  38369. ><HR><H1
  38370. CLASS="section"
  38371. ><A
  38372. NAME="array.installation"
  38373. ></A
  38374. >Instalace</H1
  38375. ><P
  38376. >K pou╛φvßnφ t∞chto funkcφ nenφ t°eba ╛ßdnß
  38377. instalace, jsou souΦßstφ jßdra PHP.</P
  38378. ></DIV
  38379. ><DIV
  38380. CLASS="section"
  38381. ><HR><H1
  38382. CLASS="section"
  38383. ><A
  38384. NAME="array.configuration"
  38385. ></A
  38386. >Konfigurace b∞hu</H1
  38387. ><P
  38388. >Toto roz╣φ°enφ nemß definovßno ╛ßdnΘ konfiguraΦnφ
  38389. direktivy.</P
  38390. ></DIV
  38391. ><DIV
  38392. CLASS="section"
  38393. ><HR><H1
  38394. CLASS="section"
  38395. ><A
  38396. NAME="array.resources"
  38397. ></A
  38398. >Typy prost°edk∙</H1
  38399. ><P
  38400. >Toto roz╣φ°enφ nemß definovßn ╛ßdn² typ prost°edku
  38401. (resource).</P
  38402. ></DIV
  38403. ><DIV
  38404. CLASS="section"
  38405. ><HR><H1
  38406. CLASS="section"
  38407. ><A
  38408. NAME="array.constants"
  38409. ></A
  38410. >P°eddefinovanΘ konstanty</H1
  38411. ><P
  38412. > Konstanty z tohoto seznamu jsou v╛dy dostupnΘ jako souΦßst jßdra PHP.
  38413. </P
  38414. ><P
  38415. >  <P
  38416. ></P
  38417. ><DIV
  38418. CLASS="variablelist"
  38419. ><DL
  38420. ><DT
  38421. ><TT
  38422. CLASS="constant"
  38423. ><B
  38424. >CASE_LOWER</B
  38425. ></TT
  38426. >
  38427.     (<A
  38428. HREF="#language.types.integer"
  38429. ><B
  38430. CLASS="type"
  38431. >integer</B
  38432. ></A
  38433. >)</DT
  38434. ><DD
  38435. ><P
  38436. >      <TT
  38437. CLASS="constant"
  38438. ><B
  38439. >CASE_LOWER</B
  38440. ></TT
  38441. > is used with
  38442.      <A
  38443. HREF="#function.array-change-key-case"
  38444. ><B
  38445. CLASS="function"
  38446. >array_change_key_case()</B
  38447. ></A
  38448. > and is used to convert array
  38449.      keys to lower case. This is also the default case for
  38450.      <A
  38451. HREF="#function.array-change-key-case"
  38452. ><B
  38453. CLASS="function"
  38454. >array_change_key_case()</B
  38455. ></A
  38456. >.
  38457.     </P
  38458. ></DD
  38459. ><DT
  38460. ><TT
  38461. CLASS="constant"
  38462. ><B
  38463. >CASE_UPPER</B
  38464. ></TT
  38465. >
  38466.     (<A
  38467. HREF="#language.types.integer"
  38468. ><B
  38469. CLASS="type"
  38470. >integer</B
  38471. ></A
  38472. >)</DT
  38473. ><DD
  38474. ><P
  38475. >      <TT
  38476. CLASS="constant"
  38477. ><B
  38478. >CASE_UPPER</B
  38479. ></TT
  38480. > is used with
  38481.      <A
  38482. HREF="#function.array-change-key-case"
  38483. ><B
  38484. CLASS="function"
  38485. >array_change_key_case()</B
  38486. ></A
  38487. > and is used to convert array
  38488.      keys to upper case.
  38489.     </P
  38490. ></DD
  38491. ></DL
  38492. ></DIV
  38493. >
  38494.  </P
  38495. ><P
  38496. > Sorting order flags:
  38497.  <P
  38498. ></P
  38499. ><DIV
  38500. CLASS="variablelist"
  38501. ><DL
  38502. ><DT
  38503. ><TT
  38504. CLASS="constant"
  38505. ><B
  38506. >SORT_ASC</B
  38507. ></TT
  38508. > 
  38509.     (<A
  38510. HREF="#language.types.integer"
  38511. ><B
  38512. CLASS="type"
  38513. >integer</B
  38514. ></A
  38515. >)</DT
  38516. ><DD
  38517. ><P
  38518. >      <TT
  38519. CLASS="constant"
  38520. ><B
  38521. >SORT_ASC</B
  38522. ></TT
  38523. > is used with
  38524.      <A
  38525. HREF="#function.array-multisort"
  38526. ><B
  38527. CLASS="function"
  38528. >array_multisort()</B
  38529. ></A
  38530. > to sort in ascending order.
  38531.     </P
  38532. ></DD
  38533. ><DT
  38534. ><TT
  38535. CLASS="constant"
  38536. ><B
  38537. >SORT_DESC</B
  38538. ></TT
  38539. > 
  38540.     (<A
  38541. HREF="#language.types.integer"
  38542. ><B
  38543. CLASS="type"
  38544. >integer</B
  38545. ></A
  38546. >)</DT
  38547. ><DD
  38548. ><P
  38549. >      <TT
  38550. CLASS="constant"
  38551. ><B
  38552. >SORT_DESC</B
  38553. ></TT
  38554. > is used with
  38555.      <A
  38556. HREF="#function.array-multisort"
  38557. ><B
  38558. CLASS="function"
  38559. >array_multisort()</B
  38560. ></A
  38561. > to sort in descending order.
  38562.     </P
  38563. ></DD
  38564. ></DL
  38565. ></DIV
  38566. >
  38567.  </P
  38568. ><P
  38569. > Sorting type flags: used by various sort functions
  38570.  <P
  38571. ></P
  38572. ><DIV
  38573. CLASS="variablelist"
  38574. ><DL
  38575. ><DT
  38576. ><TT
  38577. CLASS="constant"
  38578. ><B
  38579. >SORT_REGULAR</B
  38580. ></TT
  38581. > 
  38582.     (<A
  38583. HREF="#language.types.integer"
  38584. ><B
  38585. CLASS="type"
  38586. >integer</B
  38587. ></A
  38588. >)</DT
  38589. ><DD
  38590. ><P
  38591. >      <TT
  38592. CLASS="constant"
  38593. ><B
  38594. >SORT_REGULAR</B
  38595. ></TT
  38596. > is used to compare items normally.
  38597.     </P
  38598. ></DD
  38599. ><DT
  38600. ><TT
  38601. CLASS="constant"
  38602. ><B
  38603. >SORT_NUMERIC</B
  38604. ></TT
  38605. > 
  38606.     (<A
  38607. HREF="#language.types.integer"
  38608. ><B
  38609. CLASS="type"
  38610. >integer</B
  38611. ></A
  38612. >)</DT
  38613. ><DD
  38614. ><P
  38615. >      <TT
  38616. CLASS="constant"
  38617. ><B
  38618. >SORT_NUMERIC</B
  38619. ></TT
  38620. > is used to compare items numerically.
  38621.     </P
  38622. ></DD
  38623. ><DT
  38624. ><TT
  38625. CLASS="constant"
  38626. ><B
  38627. >SORT_STRING</B
  38628. ></TT
  38629. > 
  38630.     (<A
  38631. HREF="#language.types.integer"
  38632. ><B
  38633. CLASS="type"
  38634. >integer</B
  38635. ></A
  38636. >)</DT
  38637. ><DD
  38638. ><P
  38639. >     <TT
  38640. CLASS="constant"
  38641. ><B
  38642. >SORT_STRING</B
  38643. ></TT
  38644. > is used to compare items as strings.
  38645.     </P
  38646. ></DD
  38647. ></DL
  38648. ></DIV
  38649. >
  38650.  </P
  38651. ><P
  38652. ></P
  38653. ><DIV
  38654. CLASS="variablelist"
  38655. ><DL
  38656. ><DT
  38657. ><TT
  38658. CLASS="constant"
  38659. ><B
  38660. >COUNT_NORMAL</B
  38661. ></TT
  38662. >
  38663.      (<A
  38664. HREF="#language.types.integer"
  38665. ><B
  38666. CLASS="type"
  38667. >integer</B
  38668. ></A
  38669. >)</DT
  38670. ><DD
  38671. ><P
  38672. >
  38673.     </P
  38674. ></DD
  38675. ><DT
  38676. ><TT
  38677. CLASS="constant"
  38678. ><B
  38679. >COUNT_RECURSIVE</B
  38680. ></TT
  38681. >
  38682.      (<A
  38683. HREF="#language.types.integer"
  38684. ><B
  38685. CLASS="type"
  38686. >integer</B
  38687. ></A
  38688. >)</DT
  38689. ><DD
  38690. ><P
  38691. >
  38692.     </P
  38693. ></DD
  38694. ><DT
  38695. ><TT
  38696. CLASS="constant"
  38697. ><B
  38698. >EXTR_OVERWRITE</B
  38699. ></TT
  38700. >
  38701.      (<A
  38702. HREF="#language.types.integer"
  38703. ><B
  38704. CLASS="type"
  38705. >integer</B
  38706. ></A
  38707. >)</DT
  38708. ><DD
  38709. ><P
  38710. >
  38711.     </P
  38712. ></DD
  38713. ><DT
  38714. ><TT
  38715. CLASS="constant"
  38716. ><B
  38717. >EXTR_SKIP</B
  38718. ></TT
  38719. >
  38720.      (<A
  38721. HREF="#language.types.integer"
  38722. ><B
  38723. CLASS="type"
  38724. >integer</B
  38725. ></A
  38726. >)</DT
  38727. ><DD
  38728. ><P
  38729. >
  38730.     </P
  38731. ></DD
  38732. ><DT
  38733. ><TT
  38734. CLASS="constant"
  38735. ><B
  38736. >EXTR_PREFIX_SAME</B
  38737. ></TT
  38738. >
  38739.      (<A
  38740. HREF="#language.types.integer"
  38741. ><B
  38742. CLASS="type"
  38743. >integer</B
  38744. ></A
  38745. >)</DT
  38746. ><DD
  38747. ><P
  38748. >
  38749.     </P
  38750. ></DD
  38751. ><DT
  38752. ><TT
  38753. CLASS="constant"
  38754. ><B
  38755. >EXTR_PREFIX_ALL</B
  38756. ></TT
  38757. >
  38758.      (<A
  38759. HREF="#language.types.integer"
  38760. ><B
  38761. CLASS="type"
  38762. >integer</B
  38763. ></A
  38764. >)</DT
  38765. ><DD
  38766. ><P
  38767. >
  38768.     </P
  38769. ></DD
  38770. ><DT
  38771. ><TT
  38772. CLASS="constant"
  38773. ><B
  38774. >EXTR_PREFIX_INVALID</B
  38775. ></TT
  38776. >
  38777.      (<A
  38778. HREF="#language.types.integer"
  38779. ><B
  38780. CLASS="type"
  38781. >integer</B
  38782. ></A
  38783. >)</DT
  38784. ><DD
  38785. ><P
  38786. >
  38787.     </P
  38788. ></DD
  38789. ><DT
  38790. ><TT
  38791. CLASS="constant"
  38792. ><B
  38793. >EXTR_PREFIX_IF_EXISTS</B
  38794. ></TT
  38795. >
  38796.      (<A
  38797. HREF="#language.types.integer"
  38798. ><B
  38799. CLASS="type"
  38800. >integer</B
  38801. ></A
  38802. >)</DT
  38803. ><DD
  38804. ><P
  38805. >
  38806.     </P
  38807. ></DD
  38808. ><DT
  38809. ><TT
  38810. CLASS="constant"
  38811. ><B
  38812. >EXTR_IF_EXISTS</B
  38813. ></TT
  38814. >
  38815.      (<A
  38816. HREF="#language.types.integer"
  38817. ><B
  38818. CLASS="type"
  38819. >integer</B
  38820. ></A
  38821. >)</DT
  38822. ><DD
  38823. ><P
  38824. >
  38825.     </P
  38826. ></DD
  38827. ><DT
  38828. ><TT
  38829. CLASS="constant"
  38830. ><B
  38831. >EXTR_REFS</B
  38832. ></TT
  38833. >
  38834.      (<A
  38835. HREF="#language.types.integer"
  38836. ><B
  38837. CLASS="type"
  38838. >integer</B
  38839. ></A
  38840. >)</DT
  38841. ><DD
  38842. ><P
  38843. >
  38844.     </P
  38845. ></DD
  38846. ></DL
  38847. ></DIV
  38848. ></DIV
  38849. ><DIV
  38850. CLASS="section"
  38851. ><HR><H1
  38852. CLASS="section"
  38853. ><A
  38854. NAME="array.seealso"
  38855. ></A
  38856. >Viz takΘ</H1
  38857. ><P
  38858. >      Viz takΘ <A
  38859. HREF="#function.is-array"
  38860. ><B
  38861. CLASS="function"
  38862. >is_array()</B
  38863. ></A
  38864. >, <A
  38865. HREF="#function.explode"
  38866. ><B
  38867. CLASS="function"
  38868. >explode()</B
  38869. ></A
  38870. >,
  38871.      <A
  38872. HREF="#function.implode"
  38873. ><B
  38874. CLASS="function"
  38875. >implode()</B
  38876. ></A
  38877. >, <A
  38878. HREF="#function.split"
  38879. ><B
  38880. CLASS="function"
  38881. >split()</B
  38882. ></A
  38883. >,
  38884.      <A
  38885. HREF="#function.preg-split"
  38886. ><B
  38887. CLASS="function"
  38888. >preg_split()</B
  38889. ></A
  38890. > a <A
  38891. HREF="#function.unset"
  38892. ><B
  38893. CLASS="function"
  38894. >unset()</B
  38895. ></A
  38896. >.
  38897.     </P
  38898. ></DIV
  38899. ></DIV
  38900. ><DIV
  38901. CLASS="TOC"
  38902. ><DL
  38903. ><DT
  38904. ><B
  38905. >Obsah</B
  38906. ></DT
  38907. ><DT
  38908. ><A
  38909. HREF="#function.array-change-key-case"
  38910. >array_change_key_case</A
  38911. > -- Returns an array with all string keys lowercased or uppercased</DT
  38912. ><DT
  38913. ><A
  38914. HREF="#function.array-chunk"
  38915. >array_chunk</A
  38916. > -- Split an array into chunks</DT
  38917. ><DT
  38918. ><A
  38919. HREF="#function.array-combine"
  38920. >array_combine</A
  38921. > -- 
  38922.      Creates an array by using one array for keys and another for its values
  38923.     </DT
  38924. ><DT
  38925. ><A
  38926. HREF="#function.array-count-values"
  38927. >array_count_values</A
  38928. > -- SpoΦφtat v╣echny hodnoty v poli</DT
  38929. ><DT
  38930. ><A
  38931. HREF="#function.array-diff-assoc"
  38932. >array_diff_assoc</A
  38933. > -- Computes the difference of arrays with additional index check</DT
  38934. ><DT
  38935. ><A
  38936. HREF="#function.array-diff-uassoc"
  38937. >array_diff_uassoc</A
  38938. > -- Computes the difference of arrays with additional index check which is performed by a user supplied callback function.</DT
  38939. ><DT
  38940. ><A
  38941. HREF="#function.array-diff"
  38942. >array_diff</A
  38943. > -- SpoΦφtat rozdφl polφ</DT
  38944. ><DT
  38945. ><A
  38946. HREF="#function.array-fill"
  38947. >array_fill</A
  38948. > -- Fill an array with values</DT
  38949. ><DT
  38950. ><A
  38951. HREF="#function.array-filter"
  38952. >array_filter</A
  38953. > -- 
  38954.      Filters elements of an array using a callback function
  38955.     </DT
  38956. ><DT
  38957. ><A
  38958. HREF="#function.array-flip"
  38959. >array_flip</A
  38960. > -- Prohodit klφΦe a hodnoty pole</DT
  38961. ><DT
  38962. ><A
  38963. HREF="#function.array-intersect-assoc"
  38964. >array_intersect_assoc</A
  38965. > -- Computes the intersection of arrays with additional index check</DT
  38966. ><DT
  38967. ><A
  38968. HREF="#function.array-intersect"
  38969. >array_intersect</A
  38970. > -- SpoΦφtat pr∙nik polφ</DT
  38971. ><DT
  38972. ><A
  38973. HREF="#function.array-key-exists"
  38974. >array_key_exists</A
  38975. > -- Checks if the given key or index exists in the array</DT
  38976. ><DT
  38977. ><A
  38978. HREF="#function.array-keys"
  38979. >array_keys</A
  38980. > -- Vrßtit v╣echny klφΦe pole</DT
  38981. ><DT
  38982. ><A
  38983. HREF="#function.array-map"
  38984. >array_map</A
  38985. > -- 
  38986.      Applies the callback to the elements of the given arrays
  38987.     </DT
  38988. ><DT
  38989. ><A
  38990. HREF="#function.array-merge-recursive"
  38991. >array_merge_recursive</A
  38992. > -- Rekurzivn∞ slouΦit dv∞ nebo vφce polφ</DT
  38993. ><DT
  38994. ><A
  38995. HREF="#function.array-merge"
  38996. >array_merge</A
  38997. > -- SlouΦit dv∞ nebo vφce polφ</DT
  38998. ><DT
  38999. ><A
  39000. HREF="#function.array-multisort"
  39001. >array_multisort</A
  39002. > -- T°φdit vφce polφ, nebo vφcerozm∞rnΘ pole</DT
  39003. ><DT
  39004. ><A
  39005. HREF="#function.array-pad"
  39006. >array_pad</A
  39007. > -- Doplnit pole hodnotou na urΦenou dΘlku</DT
  39008. ><DT
  39009. ><A
  39010. HREF="#function.array-pop"
  39011. >array_pop</A
  39012. > -- Odstranit prvek z konce pole</DT
  39013. ><DT
  39014. ><A
  39015. HREF="#function.array-push"
  39016. >array_push</A
  39017. > -- P°idat jeden nebo vφce prvk∙ na konec pole</DT
  39018. ><DT
  39019. ><A
  39020. HREF="#function.array-rand"
  39021. >array_rand</A
  39022. > -- Vybrat nßhodn∞ jeden nebo vφce prvk∙ pole</DT
  39023. ><DT
  39024. ><A
  39025. HREF="#function.array-reduce"
  39026. >array_reduce</A
  39027. > -- 
  39028.      Iteratively reduce the array to a single value using a callback
  39029.      function
  39030.     </DT
  39031. ><DT
  39032. ><A
  39033. HREF="#function.array-reverse"
  39034. >array_reverse</A
  39035. > -- Vrßtit pole s prvky v opaΦnΘm po°adφ</DT
  39036. ><DT
  39037. ><A
  39038. HREF="#function.array-search"
  39039. >array_search</A
  39040. > -- 
  39041.      Searches the array for a given value and returns the
  39042.      corresponding key if successful
  39043.     </DT
  39044. ><DT
  39045. ><A
  39046. HREF="#function.array-shift"
  39047. >array_shift</A
  39048. > -- Odstranit prvek ze zaΦßtku pole</DT
  39049. ><DT
  39050. ><A
  39051. HREF="#function.array-slice"
  39052. >array_slice</A
  39053. > -- Vytßhnout Φßst pole</DT
  39054. ><DT
  39055. ><A
  39056. HREF="#function.array-splice"
  39057. >array_splice</A
  39058. > -- Odstranit Φßst pole a nahradit ji n∞Φφm jin²m</DT
  39059. ><DT
  39060. ><A
  39061. HREF="#function.array-sum"
  39062. >array_sum</A
  39063. > -- 
  39064.      Calculate the sum of values in an array.
  39065.     </DT
  39066. ><DT
  39067. ><A
  39068. HREF="#function.array-udiff-assoc"
  39069. >array_udiff_assoc</A
  39070. > -- Computes the difference of arrays with additional index check. The data is compared by using a callback function.</DT
  39071. ><DT
  39072. ><A
  39073. HREF="#function.array-udiff-uassoc"
  39074. >array_udiff_uassoc</A
  39075. > -- 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
  39076. ><DT
  39077. ><A
  39078. HREF="#function.array-udiff"
  39079. >array_udiff</A
  39080. > -- Computes the difference of arrays by using a callback function for data comparison.</DT
  39081. ><DT
  39082. ><A
  39083. HREF="#function.array-unique"
  39084. >array_unique</A
  39085. > -- Odstranit z pole duplicitnφ hodnoty</DT
  39086. ><DT
  39087. ><A
  39088. HREF="#function.array-unshift"
  39089. >array_unshift</A
  39090. > -- P°ipojit jeden nebo vφce prvk∙ na zaΦßtek pole</DT
  39091. ><DT
  39092. ><A
  39093. HREF="#function.array-values"
  39094. >array_values</A
  39095. > -- Vrßtit v╣echny hodnoty v poli</DT
  39096. ><DT
  39097. ><A
  39098. HREF="#function.array-walk"
  39099. >array_walk</A
  39100. > -- Pou╛φt u╛ivatelskou funkci na v╣echny prvky pole</DT
  39101. ><DT
  39102. ><A
  39103. HREF="#function.array"
  39104. >array</A
  39105. > -- 
  39106.      Vytvo°it pole
  39107.     </DT
  39108. ><DT
  39109. ><A
  39110. HREF="#function.arsort"
  39111. >arsort</A
  39112. > -- T°φdit pole sestupn∞ se zachovßnφm klφΦ∙
  39113.     </DT
  39114. ><DT
  39115. ><A
  39116. HREF="#function.asort"
  39117. >asort</A
  39118. > -- T°φdit pole se zachovßnφm index∙</DT
  39119. ><DT
  39120. ><A
  39121. HREF="#function.compact"
  39122. >compact</A
  39123. > -- Vytvo°it pole obsahujφcφ prom∞nnΘ a jejich hodnoty</DT
  39124. ><DT
  39125. ><A
  39126. HREF="#function.count"
  39127. >count</A
  39128. > -- SpoΦφtat prvky v prom∞nnΘ</DT
  39129. ><DT
  39130. ><A
  39131. HREF="#function.current"
  39132. >current</A
  39133. > -- Vrßtit souΦasn² prvek pole</DT
  39134. ><DT
  39135. ><A
  39136. HREF="#function.each"
  39137. >each</A
  39138. > -- 
  39139.      Vracφ dal╣φ klφΦ/hodnota pßr z pole
  39140.     </DT
  39141. ><DT
  39142. ><A
  39143. HREF="#function.end"
  39144. >end</A
  39145. > -- 
  39146.      Nastavit vnit°nφ ukazatel pole na jeho poslednφ prvek
  39147.     </DT
  39148. ><DT
  39149. ><A
  39150. HREF="#function.extract"
  39151. >extract</A
  39152. > -- Importovat prom∞nnΘ z pole do symbolovΘ tabulky</DT
  39153. ><DT
  39154. ><A
  39155. HREF="#function.in-array"
  39156. >in_array</A
  39157. > -- Vrßtit <TT
  39158. CLASS="constant"
  39159. ><B
  39160. >TRUE</B
  39161. ></TT
  39162. >, pokud v poli existuje danß hodnota</DT
  39163. ><DT
  39164. ><A
  39165. HREF="#function.key"
  39166. >key</A
  39167. > -- Fetch a key from an associative array</DT
  39168. ><DT
  39169. ><A
  39170. HREF="#function.krsort"
  39171. >krsort</A
  39172. > -- T°φdit pole sestupn∞ podle klφΦ∙</DT
  39173. ><DT
  39174. ><A
  39175. HREF="#function.ksort"
  39176. >ksort</A
  39177. > -- T°φdit pole podle klφΦ∙</DT
  39178. ><DT
  39179. ><A
  39180. HREF="#function.list"
  39181. >list</A
  39182. > -- P°i°adit hodnoty p°om∞nn²m jako kdyby byly polem</DT
  39183. ><DT
  39184. ><A
  39185. HREF="#function.natcasesort"
  39186. >natcasesort</A
  39187. > -- 
  39188.      T°φdit pole s vyu╛itφm algoritmu "p°irozenΘho t°φd∞nφ" (case-insensitive)
  39189.     </DT
  39190. ><DT
  39191. ><A
  39192. HREF="#function.natsort"
  39193. >natsort</A
  39194. > -- 
  39195.      T°φdit pole s vyu╛itφm algoritmu "p°irozenΘho t°φd∞nφ"
  39196.     </DT
  39197. ><DT
  39198. ><A
  39199. HREF="#function.next"
  39200. >next</A
  39201. > -- Posunout internφ ukazatel pole</DT
  39202. ><DT
  39203. ><A
  39204. HREF="#function.pos"
  39205. >pos</A
  39206. > -- Zφskat souΦasn² prvek pole</DT
  39207. ><DT
  39208. ><A
  39209. HREF="#function.prev"
  39210. >prev</A
  39211. > -- Rewind internφ ukazatel pole</DT
  39212. ><DT
  39213. ><A
  39214. HREF="#function.range"
  39215. >range</A
  39216. > -- Vytvo°it pole obsahujφcφ rozsah integer∙</DT
  39217. ><DT
  39218. ><A
  39219. HREF="#function.reset"
  39220. >reset</A
  39221. > -- Nastavit internφ ukazatel pole na jeho prvnφ prvek</DT
  39222. ><DT
  39223. ><A
  39224. HREF="#function.rsort"
  39225. >rsort</A
  39226. > -- T°φdit pole sestupn∞</DT
  39227. ><DT
  39228. ><A
  39229. HREF="#function.shuffle"
  39230. >shuffle</A
  39231. > -- Zamφchat pole</DT
  39232. ><DT
  39233. ><A
  39234. HREF="#function.sizeof"
  39235. >sizeof</A
  39236. > -- Zjistit poΦet prvk∙ v poli</DT
  39237. ><DT
  39238. ><A
  39239. HREF="#function.sort"
  39240. >sort</A
  39241. > -- T°φdit pole</DT
  39242. ><DT
  39243. ><A
  39244. HREF="#function.uasort"
  39245. >uasort</A
  39246. > -- 
  39247.      T°φdit pole pomocφ u╛ivatelsky definovanΘ porovnßvacφ funkce se zachovßnφm
  39248.      klφΦ∙
  39249.     </DT
  39250. ><DT
  39251. ><A
  39252. HREF="#function.uksort"
  39253. >uksort</A
  39254. > -- 
  39255.      T°φdit pole podle klφΦ∙ pomocφ u╛ivatelsky definovane porovnßvacφ funkce
  39256.     </DT
  39257. ><DT
  39258. ><A
  39259. HREF="#function.usort"
  39260. >usort</A
  39261. > -- 
  39262.      T°φdit pole podle hodnot pomocφ u╛ivatelsky definovanΘ porovnßvacφ funkce
  39263.     </DT
  39264. ></DL
  39265. ></DIV
  39266. ></DIV
  39267. ><H1
  39268. ><A
  39269. NAME="function.array-change-key-case"
  39270. ></A
  39271. >array_change_key_case</H1
  39272. ><DIV
  39273. CLASS="refnamediv"
  39274. ><A
  39275. NAME="AEN7081"
  39276. ></A
  39277. ><P
  39278. >    (PHP 4 >= 4.2.0)</P
  39279. >array_change_key_case -- Returns an array with all string keys lowercased or uppercased</DIV
  39280. ><DIV
  39281. CLASS="refsect1"
  39282. ><A
  39283. NAME="AEN7084"
  39284. ></A
  39285. ><H2
  39286. >Description</H2
  39287. >array <B
  39288. CLASS="methodname"
  39289. >array_change_key_case</B
  39290. > ( array input [, int case])<BR
  39291. ></BR
  39292. ><P
  39293. >      <B
  39294. CLASS="function"
  39295. >array_change_key_case()</B
  39296. > changes the
  39297.      keys in the <TT
  39298. CLASS="parameter"
  39299. ><I
  39300. >input</I
  39301. ></TT
  39302. > array to
  39303.      be all lowercase or uppercase. The change depends
  39304.      on the last optional <TT
  39305. CLASS="parameter"
  39306. ><I
  39307. >case</I
  39308. ></TT
  39309. >
  39310.      parameter. You can pass two constants there,
  39311.      <TT
  39312. CLASS="constant"
  39313. ><B
  39314. >CASE_UPPER</B
  39315. ></TT
  39316. > and
  39317.      <TT
  39318. CLASS="constant"
  39319. ><B
  39320. >CASE_LOWER</B
  39321. ></TT
  39322. >. The default is
  39323.      <TT
  39324. CLASS="constant"
  39325. ><B
  39326. >CASE_LOWER</B
  39327. ></TT
  39328. >. The function will leave
  39329.      number indices as is.
  39330.     </P
  39331. ><TABLE
  39332. WIDTH="100%"
  39333. BORDER="0"
  39334. CELLPADDING="0"
  39335. CELLSPACING="0"
  39336. CLASS="EXAMPLE"
  39337. ><TR
  39338. ><TD
  39339. ><DIV
  39340. CLASS="example"
  39341. ><A
  39342. NAME="AEN7102"
  39343. ></A
  39344. ><P
  39345. ><B
  39346. >P°φklad 1. <B
  39347. CLASS="function"
  39348. >array_change_key_case()</B
  39349. > example</B
  39350. ></P
  39351. ><TABLE
  39352. BORDER="0"
  39353. BGCOLOR="#E0E0E0"
  39354. CELLPADDING="5"
  39355. ><TR
  39356. ><TD
  39357. ><PRE
  39358. CLASS="php"
  39359. ><?php
  39360. $input_array = array("FirSt" => 1, "SecOnd" => 4);
  39361. print_r(array_change_key_case($input_array, CASE_UPPER));
  39362. ?></PRE
  39363. ></TD
  39364. ></TR
  39365. ></TABLE
  39366. ><P
  39367. >       The printout of the above program will be:
  39368.      </P
  39369. ><TABLE
  39370. BORDER="0"
  39371. BGCOLOR="#E0E0E0"
  39372. CELLPADDING="5"
  39373. ><TR
  39374. ><TD
  39375. ><PRE
  39376. CLASS="screen"
  39377. >Array
  39378. (
  39379.     [FIRST] => 1
  39380.     [SECOND] => 4
  39381. )</PRE
  39382. ></TD
  39383. ></TR
  39384. ></TABLE
  39385. ></DIV
  39386. ></TD
  39387. ></TR
  39388. ></TABLE
  39389. ><P
  39390. >      If an array has indices that will be the same once run through this
  39391.      function (e.g. "keY" and "kEY"), the value that is later in the array
  39392.      will override other indices.
  39393.     </P
  39394. ></DIV
  39395. ><H1
  39396. ><A
  39397. NAME="function.array-chunk"
  39398. ></A
  39399. >array_chunk</H1
  39400. ><DIV
  39401. CLASS="refnamediv"
  39402. ><A
  39403. NAME="AEN7110"
  39404. ></A
  39405. ><P
  39406. >    (PHP 4 >= 4.2.0)</P
  39407. >array_chunk -- Split an array into chunks</DIV
  39408. ><DIV
  39409. CLASS="refsect1"
  39410. ><A
  39411. NAME="AEN7113"
  39412. ></A
  39413. ><H2
  39414. >Description</H2
  39415. >array <B
  39416. CLASS="methodname"
  39417. >array_chunk</B
  39418. > ( array input, int size [, bool preserve_keys])<BR
  39419. ></BR
  39420. ><P
  39421. >      <B
  39422. CLASS="function"
  39423. >array_chunk()</B
  39424. > splits the array into
  39425.      several arrays with <TT
  39426. CLASS="parameter"
  39427. ><I
  39428. >size</I
  39429. ></TT
  39430. > values
  39431.      in them. You may also have an array with less values
  39432.      at the end. You get the arrays as members of a
  39433.      multidimensional array indexed with numbers starting
  39434.      from zero.
  39435.     </P
  39436. ><P
  39437. >      By setting the optional <TT
  39438. CLASS="parameter"
  39439. ><I
  39440. >preserve_keys</I
  39441. ></TT
  39442. >
  39443.      parameter to <TT
  39444. CLASS="constant"
  39445. ><B
  39446. >TRUE</B
  39447. ></TT
  39448. >, you can force PHP to preserve the original
  39449.      keys from the input array. If you specify <TT
  39450. CLASS="constant"
  39451. ><B
  39452. >FALSE</B
  39453. ></TT
  39454. > new number
  39455.      indices will be used in each resulting array with
  39456.      indices starting from zero. The default is <TT
  39457. CLASS="constant"
  39458. ><B
  39459. >FALSE</B
  39460. ></TT
  39461. >.
  39462.     </P
  39463. ><TABLE
  39464. WIDTH="100%"
  39465. BORDER="0"
  39466. CELLPADDING="0"
  39467. CELLSPACING="0"
  39468. CLASS="EXAMPLE"
  39469. ><TR
  39470. ><TD
  39471. ><DIV
  39472. CLASS="example"
  39473. ><A
  39474. NAME="AEN7135"
  39475. ></A
  39476. ><P
  39477. ><B
  39478. >P°φklad 1. <B
  39479. CLASS="function"
  39480. >array_chunk()</B
  39481. > example</B
  39482. ></P
  39483. ><TABLE
  39484. BORDER="0"
  39485. BGCOLOR="#E0E0E0"
  39486. CELLPADDING="5"
  39487. ><TR
  39488. ><TD
  39489. ><PRE
  39490. CLASS="php"
  39491. ><?php
  39492. $input_array = array('a', 'b', 'c', 'd', 'e');
  39493. print_r(array_chunk($input_array, 2));
  39494. print_r(array_chunk($input_array, 2, true));
  39495. ?></PRE
  39496. ></TD
  39497. ></TR
  39498. ></TABLE
  39499. ><P
  39500. >       The printout of the above program will be:
  39501.      </P
  39502. ><TABLE
  39503. BORDER="0"
  39504. BGCOLOR="#E0E0E0"
  39505. CELLPADDING="5"
  39506. ><TR
  39507. ><TD
  39508. ><PRE
  39509. CLASS="screen"
  39510. >Array
  39511. (
  39512.     [0] => Array
  39513.         (
  39514.             [0] => a
  39515.             [1] => b
  39516.         )
  39517.  
  39518.     [1] => Array
  39519.         (
  39520.             [0] => c
  39521.             [1] => d
  39522.         )
  39523.  
  39524.     [2] => Array
  39525.         (
  39526.             [0] => e
  39527.         )
  39528.  
  39529. )
  39530. Array
  39531. (
  39532.     [0] => Array
  39533.         (
  39534.             [0] => a
  39535.             [1] => b
  39536.         )
  39537.  
  39538.     [1] => Array
  39539.         (
  39540.             [2] => c
  39541.             [3] => d
  39542.         )
  39543.  
  39544.     [2] => Array
  39545.         (
  39546.             [4] => e
  39547.         )
  39548.  
  39549. )</PRE
  39550. ></TD
  39551. ></TR
  39552. ></TABLE
  39553. ></DIV
  39554. ></TD
  39555. ></TR
  39556. ></TABLE
  39557. ></DIV
  39558. ><H1
  39559. ><A
  39560. NAME="function.array-combine"
  39561. ></A
  39562. >array_combine</H1
  39563. ><DIV
  39564. CLASS="refnamediv"
  39565. ><A
  39566. NAME="AEN7142"
  39567. ></A
  39568. ><P
  39569. >    (PHP 5 CVS only)</P
  39570. >array_combine -- 
  39571.      Creates an array by using one array for keys and another for its values
  39572.     </DIV
  39573. ><DIV
  39574. CLASS="refsect1"
  39575. ><A
  39576. NAME="AEN7145"
  39577. ></A
  39578. ><H2
  39579. >Description</H2
  39580. >array <B
  39581. CLASS="methodname"
  39582. >array_combine</B
  39583. > ( array keys, array values)<BR
  39584. ></BR
  39585. ><P
  39586. >      Returns an <A
  39587. HREF="#language.types.array"
  39588. ><B
  39589. CLASS="type"
  39590. >array</B
  39591. ></A
  39592. > by using the values from the
  39593.      <TT
  39594. CLASS="parameter"
  39595. ><I
  39596. >keys</I
  39597. ></TT
  39598. > array as keys and the values from the
  39599.      <TT
  39600. CLASS="parameter"
  39601. ><I
  39602. >values</I
  39603. ></TT
  39604. > array as the corresponding values.
  39605.     </P
  39606. ><P
  39607. >      Returns <TT
  39608. CLASS="constant"
  39609. ><B
  39610. >FALSE</B
  39611. ></TT
  39612. > if the number of elements for each array isn't equal or
  39613.      if the arrays are empty.
  39614.     </P
  39615. ><P
  39616. >      <TABLE
  39617. WIDTH="100%"
  39618. BORDER="0"
  39619. CELLPADDING="0"
  39620. CELLSPACING="0"
  39621. CLASS="EXAMPLE"
  39622. ><TR
  39623. ><TD
  39624. ><DIV
  39625. CLASS="example"
  39626. ><A
  39627. NAME="AEN7163"
  39628. ></A
  39629. ><P
  39630. ><B
  39631. >P°φklad 1. A simple <B
  39632. CLASS="function"
  39633. >array_combine()</B
  39634. > example</B
  39635. ></P
  39636. ><TABLE
  39637. BORDER="0"
  39638. BGCOLOR="#E0E0E0"
  39639. CELLPADDING="5"
  39640. ><TR
  39641. ><TD
  39642. ><PRE
  39643. CLASS="php"
  39644. ><?php
  39645. $a = array('green', 'red', 'yellow');
  39646. $b = array('avocado', 'apple', 'banana');
  39647. $c = array_combine($a, $b);
  39648.  
  39649. print_r($c);
  39650. ?></PRE
  39651. ></TD
  39652. ></TR
  39653. ></TABLE
  39654. ><P
  39655. >        Outputs:
  39656.       </P
  39657. ><TABLE
  39658. BORDER="0"
  39659. BGCOLOR="#E0E0E0"
  39660. CELLPADDING="5"
  39661. ><TR
  39662. ><TD
  39663. ><PRE
  39664. CLASS="screen"
  39665. >Array
  39666. (
  39667.     [green]  => avocado
  39668.     [red]    => apple
  39669.     [yellow] => banana
  39670. )</PRE
  39671. ></TD
  39672. ></TR
  39673. ></TABLE
  39674. ></DIV
  39675. ></TD
  39676. ></TR
  39677. ></TABLE
  39678. >
  39679.     </P
  39680. ><P
  39681. >      See also <A
  39682. HREF="#function.array-merge"
  39683. ><B
  39684. CLASS="function"
  39685. >array_merge()</B
  39686. ></A
  39687. >,
  39688.      <A
  39689. HREF="#function.array-walk"
  39690. ><B
  39691. CLASS="function"
  39692. >array_walk()</B
  39693. ></A
  39694. >, and
  39695.      <A
  39696. HREF="#function.array-values"
  39697. ><B
  39698. CLASS="function"
  39699. >array_values()</B
  39700. ></A
  39701. >.
  39702.     </P
  39703. ></DIV
  39704. ><H1
  39705. ><A
  39706. NAME="function.array-count-values"
  39707. ></A
  39708. >array_count_values</H1
  39709. ><DIV
  39710. CLASS="refnamediv"
  39711. ><A
  39712. NAME="AEN7174"
  39713. ></A
  39714. ><P
  39715. >    (PHP 4 )</P
  39716. >array_count_values -- SpoΦφtat v╣echny hodnoty v poli</DIV
  39717. ><DIV
  39718. CLASS="refsect1"
  39719. ><A
  39720. NAME="AEN7177"
  39721. ></A
  39722. ><H2
  39723. >Popis</H2
  39724. >array <B
  39725. CLASS="methodname"
  39726. >array_count_values</B
  39727. > ( array input)<BR
  39728. ></BR
  39729. ><P
  39730. >      <B
  39731. CLASS="function"
  39732. >array_count_values()</B
  39733. > vracφ pole pou╛φvajφcφ hodnoty z
  39734.      <TT
  39735. CLASS="parameter"
  39736. ><I
  39737. >input</I
  39738. ></TT
  39739. > jako klφΦe a jejich Φetnosti v
  39740.      <TT
  39741. CLASS="parameter"
  39742. ><I
  39743. >input</I
  39744. ></TT
  39745. > jako hodnoty.
  39746.     </P
  39747. ><P
  39748. >      <TABLE
  39749. WIDTH="100%"
  39750. BORDER="0"
  39751. CELLPADDING="0"
  39752. CELLSPACING="0"
  39753. CLASS="EXAMPLE"
  39754. ><TR
  39755. ><TD
  39756. ><DIV
  39757. CLASS="example"
  39758. ><A
  39759. NAME="AEN7190"
  39760. ></A
  39761. ><P
  39762. ><B
  39763. >P°φklad 1. Ukßzka <B
  39764. CLASS="function"
  39765. >array_count_values()</B
  39766. ></B
  39767. ></P
  39768. ><TABLE
  39769. BORDER="0"
  39770. BGCOLOR="#E0E0E0"
  39771. CELLPADDING="5"
  39772. ><TR
  39773. ><TD
  39774. ><PRE
  39775. CLASS="php"
  39776. >$array = array (1, "hello", 1, "world", "hello");
  39777. array_count_values ($array); // vracφ array(1=>2, "hello"=>2, "world"=>1)</PRE
  39778. ></TD
  39779. ></TR
  39780. ></TABLE
  39781. ></DIV
  39782. ></TD
  39783. ></TR
  39784. ></TABLE
  39785. >
  39786.     </P
  39787. ></DIV
  39788. ><H1
  39789. ><A
  39790. NAME="function.array-diff-assoc"
  39791. ></A
  39792. >array_diff_assoc</H1
  39793. ><DIV
  39794. CLASS="refnamediv"
  39795. ><A
  39796. NAME="AEN7195"
  39797. ></A
  39798. ><P
  39799. >    (PHP 4 >= 4.3.0)</P
  39800. >array_diff_assoc -- Computes the difference of arrays with additional index check</DIV
  39801. ><DIV
  39802. CLASS="refsect1"
  39803. ><A
  39804. NAME="AEN7198"
  39805. ></A
  39806. ><H2
  39807. >Description</H2
  39808. >array <B
  39809. CLASS="methodname"
  39810. >array_diff_assoc</B
  39811. > ( array array1, array array2 [, array ...])<BR
  39812. ></BR
  39813. ><P
  39814. >      <B
  39815. CLASS="function"
  39816. >array_diff_assoc()</B
  39817. > returns an <A
  39818. HREF="#language.types.array"
  39819. ><B
  39820. CLASS="type"
  39821. >array</B
  39822. ></A
  39823. >
  39824.      containing all the values from <TT
  39825. CLASS="parameter"
  39826. ><I
  39827. >array1</I
  39828. ></TT
  39829. >
  39830.      that are not present in any of the other arguments.
  39831.      Note that the keys are used in the comparison unlike
  39832.      <A
  39833. HREF="#function.array-diff"
  39834. ><B
  39835. CLASS="function"
  39836. >array_diff()</B
  39837. ></A
  39838. >.
  39839.     </P
  39840. ><P
  39841. >      <TABLE
  39842. WIDTH="100%"
  39843. BORDER="0"
  39844. CELLPADDING="0"
  39845. CELLSPACING="0"
  39846. CLASS="EXAMPLE"
  39847. ><TR
  39848. ><TD
  39849. ><DIV
  39850. CLASS="example"
  39851. ><A
  39852. NAME="AEN7218"
  39853. ></A
  39854. ><P
  39855. ><B
  39856. >P°φklad 1. <B
  39857. CLASS="function"
  39858. >array_diff_assoc()</B
  39859. > example</B
  39860. ></P
  39861. ><TABLE
  39862. BORDER="0"
  39863. BGCOLOR="#E0E0E0"
  39864. CELLPADDING="5"
  39865. ><TR
  39866. ><TD
  39867. ><PRE
  39868. CLASS="php"
  39869. ><?php
  39870. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  39871. $array2 = array("a" => "green", "yellow", "red");
  39872. $result = array_diff_assoc($array1, $array2);
  39873. print_r($result);
  39874. ?></PRE
  39875. ></TD
  39876. ></TR
  39877. ></TABLE
  39878. ><P
  39879. >        The result is:
  39880.       </P
  39881. ><TABLE
  39882. BORDER="0"
  39883. BGCOLOR="#E0E0E0"
  39884. CELLPADDING="5"
  39885. ><TR
  39886. ><TD
  39887. ><PRE
  39888. CLASS="screen"
  39889. >Array
  39890. (
  39891.     [b] => brown
  39892.     [c] => blue
  39893.     [0] => red
  39894. )</PRE
  39895. ></TD
  39896. ></TR
  39897. ></TABLE
  39898. ></DIV
  39899. ></TD
  39900. ></TR
  39901. ></TABLE
  39902. >
  39903.     </P
  39904. ><P
  39905. >      In our example above you see the <TT
  39906. CLASS="literal"
  39907. >"a" => "green"</TT
  39908. >
  39909.      pair is present in both arrays and thus it is not in the ouput from the
  39910.      function. Unlike this, the pair <TT
  39911. CLASS="literal"
  39912. >0 => "red"</TT
  39913. > 
  39914.      is in the ouput because in the second argument <TT
  39915. CLASS="literal"
  39916. >"red"</TT
  39917. >
  39918.      has key which is <TT
  39919. CLASS="literal"
  39920. >1</TT
  39921. >. 
  39922.     </P
  39923. ><P
  39924. >      Two values from <SPAN
  39925. CLASS="emphasis"
  39926. ><I
  39927. CLASS="emphasis"
  39928. >key => value</I
  39929. ></SPAN
  39930. > pairs are
  39931.      considered equal only if <TT
  39932. CLASS="literal"
  39933. >(string) $elem1 === (string)
  39934.      $elem2 </TT
  39935. >. In other words a strict check takes place so 
  39936.      the string representations must be the same.
  39937.      
  39938.     </P
  39939. ><DIV
  39940. CLASS="note"
  39941. ><BLOCKQUOTE
  39942. CLASS="note"
  39943. ><P
  39944. ><B
  39945. >Poznßmka: </B
  39946. >
  39947.       Please note that this function only checks one dimension of a n-dimensional
  39948.       array. Of course you can check deeper dimensions by using, for example, 
  39949.       <TT
  39950. CLASS="literal"
  39951. >array_diff_assoc($array1[0], $array2[0]);</TT
  39952. >.
  39953.      </P
  39954. ></BLOCKQUOTE
  39955. ></DIV
  39956. ><P
  39957. >      See also <A
  39958. HREF="#function.array-diff"
  39959. ><B
  39960. CLASS="function"
  39961. >array_diff()</B
  39962. ></A
  39963. >,
  39964.      <A
  39965. HREF="#function.array-intersect"
  39966. ><B
  39967. CLASS="function"
  39968. >array_intersect()</B
  39969. ></A
  39970. >,
  39971.      and <A
  39972. HREF="#function.array-intersect-assoc"
  39973. ><B
  39974. CLASS="function"
  39975. >array_intersect_assoc()</B
  39976. ></A
  39977. >.
  39978.     </P
  39979. ></DIV
  39980. ><H1
  39981. ><A
  39982. NAME="function.array-diff-uassoc"
  39983. ></A
  39984. >array_diff_uassoc</H1
  39985. ><DIV
  39986. CLASS="refnamediv"
  39987. ><A
  39988. NAME="AEN7240"
  39989. ></A
  39990. ><P
  39991. >    (no version information, might be only in CVS)</P
  39992. >array_diff_uassoc -- Computes the difference of arrays with additional index check which is performed by a user supplied callback function.</DIV
  39993. ><DIV
  39994. CLASS="refsect1"
  39995. ><A
  39996. NAME="AEN7243"
  39997. ></A
  39998. ><H2
  39999. >Description</H2
  40000. >array <B
  40001. CLASS="methodname"
  40002. >array_diff_assoc</B
  40003. > ( array array1, array array2 [, array ..., callback key_compare_func])<BR
  40004. ></BR
  40005. ><P
  40006. >      <B
  40007. CLASS="function"
  40008. >array_diff_uassoc()</B
  40009. > returns an <A
  40010. HREF="#language.types.array"
  40011. ><B
  40012. CLASS="type"
  40013. >array</B
  40014. ></A
  40015. >
  40016.      containing all the values from <TT
  40017. CLASS="parameter"
  40018. ><I
  40019. >array1</I
  40020. ></TT
  40021. >
  40022.      that are not present in any of the other arguments.
  40023.      Note that the keys are used in the comparison unlike
  40024.      <A
  40025. HREF="#function.array-diff"
  40026. ><B
  40027. CLASS="function"
  40028. >array_diff()</B
  40029. ></A
  40030. >. This comparison is done by a user supplied callback function.
  40031.      It must return an integer less than, equal
  40032.      to, or greater than zero if the first argument is considered to
  40033.      be respectively less than, equal to, or greater than the
  40034.      second. This is unlike <A
  40035. HREF="#function.array-diff-assoc"
  40036. ><B
  40037. CLASS="function"
  40038. >array_diff_assoc()</B
  40039. ></A
  40040. > where an
  40041.      internal function for comparing the indices is used.
  40042.     </P
  40043. ><P
  40044. >      <TABLE
  40045. WIDTH="100%"
  40046. BORDER="0"
  40047. CELLPADDING="0"
  40048. CELLSPACING="0"
  40049. CLASS="EXAMPLE"
  40050. ><TR
  40051. ><TD
  40052. ><DIV
  40053. CLASS="example"
  40054. ><A
  40055. NAME="AEN7267"
  40056. ></A
  40057. ><P
  40058. ><B
  40059. >P°φklad 1. <B
  40060. CLASS="function"
  40061. >array_diff_uassoc()</B
  40062. > example</B
  40063. ></P
  40064. ><TABLE
  40065. BORDER="0"
  40066. BGCOLOR="#E0E0E0"
  40067. CELLPADDING="5"
  40068. ><TR
  40069. ><TD
  40070. ><PRE
  40071. CLASS="php"
  40072. ><?php
  40073. function key_compare_func($a, $b) {
  40074.     if ($a === $b) return 0;
  40075.     return ($a > $b)? 1:-1;
  40076. }
  40077.  
  40078. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  40079. $array2 = array("a" => "green", "yellow", "red");
  40080. $result = array_diff_uassoc($array1, $array2, "key_compare_func");
  40081. ?></PRE
  40082. ></TD
  40083. ></TR
  40084. ></TABLE
  40085. ><P
  40086. >        The result is:
  40087.       </P
  40088. ><TABLE
  40089. BORDER="0"
  40090. BGCOLOR="#E0E0E0"
  40091. CELLPADDING="5"
  40092. ><TR
  40093. ><TD
  40094. ><PRE
  40095. CLASS="screen"
  40096. >Array
  40097. (
  40098.     [b] => brown
  40099.     [c] => blue
  40100.     [0] => red
  40101. )</PRE
  40102. ></TD
  40103. ></TR
  40104. ></TABLE
  40105. ></DIV
  40106. ></TD
  40107. ></TR
  40108. ></TABLE
  40109. >
  40110.     </P
  40111. ><P
  40112. >      In our example above you see the <TT
  40113. CLASS="literal"
  40114. >"a" => "green"</TT
  40115. >
  40116.      pair is present in both arrays and thus it is not in the ouput from the
  40117.      function. Unlike this, the pair <TT
  40118. CLASS="literal"
  40119. >0 => "red"</TT
  40120. >
  40121.      is in the ouput because in the second argument <TT
  40122. CLASS="literal"
  40123. >"red"</TT
  40124. >
  40125.      has key which is <TT
  40126. CLASS="literal"
  40127. >1</TT
  40128. >.
  40129.     </P
  40130. ><P
  40131. >      The equality of 2 indices is checked by the user supplied callback function.
  40132.     </P
  40133. ><DIV
  40134. CLASS="note"
  40135. ><BLOCKQUOTE
  40136. CLASS="note"
  40137. ><P
  40138. ><B
  40139. >Poznßmka: </B
  40140. >
  40141.       Please note that this function only checks one dimension of a n-dimensional
  40142.       array. Of course you can check deeper dimensions by using, for example,
  40143.       <TT
  40144. CLASS="literal"
  40145. >array_diff_uassoc($array1[0], $array2[0], "key_compare_func");</TT
  40146. >.
  40147.      </P
  40148. ></BLOCKQUOTE
  40149. ></DIV
  40150. ><P
  40151. >      See also
  40152.      <A
  40153. HREF="#function.array-diff"
  40154. ><B
  40155. CLASS="function"
  40156. >array_diff()</B
  40157. ></A
  40158. >,
  40159.      <A
  40160. HREF="#function.array-diff-assoc"
  40161. ><B
  40162. CLASS="function"
  40163. >array_diff_assoc()</B
  40164. ></A
  40165. >,
  40166.      <A
  40167. HREF="#function.array-udiff"
  40168. ><B
  40169. CLASS="function"
  40170. >array_udiff()</B
  40171. ></A
  40172. >,
  40173.      <A
  40174. HREF="#function.array-udiff-assoc"
  40175. ><B
  40176. CLASS="function"
  40177. >array_udiff_assoc()</B
  40178. ></A
  40179. >, 
  40180.      <A
  40181. HREF="#function.array-udiff-uassoc"
  40182. ><B
  40183. CLASS="function"
  40184. >array_udiff_uassoc()</B
  40185. ></A
  40186. >, 
  40187.      <A
  40188. HREF="#function.array-intersect"
  40189. ><B
  40190. CLASS="function"
  40191. >array_intersect()</B
  40192. ></A
  40193. >,  
  40194.      <A
  40195. HREF="#function.array-intersect-assoc"
  40196. ><B
  40197. CLASS="function"
  40198. >array_intersect_assoc()</B
  40199. ></A
  40200. >,
  40201.      <B
  40202. CLASS="function"
  40203. >array_uintersect()</B
  40204. >,  
  40205.      <B
  40206. CLASS="function"
  40207. >array_uintersect_assoc()</B
  40208. > and 
  40209.      <B
  40210. CLASS="function"
  40211. >array_uintersect_uassoc()</B
  40212. >.
  40213.     </P
  40214. ></DIV
  40215. ><H1
  40216. ><A
  40217. NAME="function.array-diff"
  40218. ></A
  40219. >array_diff</H1
  40220. ><DIV
  40221. CLASS="refnamediv"
  40222. ><A
  40223. NAME="AEN7294"
  40224. ></A
  40225. ><P
  40226. >    (PHP 4 >= 4.0.1)</P
  40227. >array_diff -- SpoΦφtat rozdφl polφ</DIV
  40228. ><DIV
  40229. CLASS="refsect1"
  40230. ><A
  40231. NAME="AEN7297"
  40232. ></A
  40233. ><H2
  40234. >Popis</H2
  40235. >array <B
  40236. CLASS="methodname"
  40237. >array_diff</B
  40238. > ( array array1, array array2 [, array ...])<BR
  40239. ></BR
  40240. ><P
  40241. >      <B
  40242. CLASS="function"
  40243. >array_diff()</B
  40244. > vracφ pole obsahujφcφ v╣echny hodnoty z
  40245.      <TT
  40246. CLASS="parameter"
  40247. ><I
  40248. >array1</I
  40249. ></TT
  40250. >, kterΘ se nevyskytujφ v ╛ßdnΘm z dal╣φch
  40251.      argument∙. KlφΦe jsou zachovßny.
  40252.     </P
  40253. ><P
  40254. >      <TABLE
  40255. WIDTH="100%"
  40256. BORDER="0"
  40257. CELLPADDING="0"
  40258. CELLSPACING="0"
  40259. CLASS="EXAMPLE"
  40260. ><TR
  40261. ><TD
  40262. ><DIV
  40263. CLASS="example"
  40264. ><A
  40265. NAME="AEN7315"
  40266. ></A
  40267. ><P
  40268. ><B
  40269. >P°φklad 1. Ukßzka <B
  40270. CLASS="function"
  40271. >array_diff()</B
  40272. ></B
  40273. ></P
  40274. ><TABLE
  40275. BORDER="0"
  40276. BGCOLOR="#E0E0E0"
  40277. CELLPADDING="5"
  40278. ><TR
  40279. ><TD
  40280. ><PRE
  40281. CLASS="php"
  40282. >$array1 = array ("a" => "green", "red", "blue");
  40283. $array2 = array ("b" => "green", "yellow", "red");
  40284. $result = array_diff ($array1, $array2);</PRE
  40285. ></TD
  40286. ></TR
  40287. ></TABLE
  40288. ></DIV
  40289. ></TD
  40290. ></TR
  40291. ></TABLE
  40292. >
  40293.     </P
  40294. ><P
  40295. >      <TT
  40296. CLASS="varname"
  40297. >$result</TT
  40298. > obsahuje <TT
  40299. CLASS="literal"
  40300. >array ("blue");</TT
  40301. >
  40302.     </P
  40303. ><P
  40304. >      Viz takΘ: <A
  40305. HREF="#function.array-intersect"
  40306. ><B
  40307. CLASS="function"
  40308. >array_intersect()</B
  40309. ></A
  40310. >.
  40311.     </P
  40312. ></DIV
  40313. ><H1
  40314. ><A
  40315. NAME="function.array-fill"
  40316. ></A
  40317. >array_fill</H1
  40318. ><DIV
  40319. CLASS="refnamediv"
  40320. ><A
  40321. NAME="AEN7325"
  40322. ></A
  40323. ><P
  40324. >    (PHP 4 >= 4.2.0)</P
  40325. >array_fill -- Fill an array with values</DIV
  40326. ><DIV
  40327. CLASS="refsect1"
  40328. ><A
  40329. NAME="AEN7328"
  40330. ></A
  40331. ><H2
  40332. >Description</H2
  40333. >array <B
  40334. CLASS="methodname"
  40335. >array_fill</B
  40336. > ( int start_index, int num, mixed value)<BR
  40337. ></BR
  40338. ><P
  40339. >      <B
  40340. CLASS="function"
  40341. >array_fill()</B
  40342. > fills an array with
  40343.      <TT
  40344. CLASS="parameter"
  40345. ><I
  40346. >num</I
  40347. ></TT
  40348. > entries of the value of the
  40349.      <TT
  40350. CLASS="parameter"
  40351. ><I
  40352. >value</I
  40353. ></TT
  40354. > parameter, keys starting at the
  40355.      <TT
  40356. CLASS="parameter"
  40357. ><I
  40358. >start_index</I
  40359. ></TT
  40360. > parameter.  Note that <TT
  40361. CLASS="parameter"
  40362. ><I
  40363. >      num</I
  40364. ></TT
  40365. > must be a number greater than zero, or PHP will throw
  40366.      a warning.
  40367.     </P
  40368. ><P
  40369. >      <TABLE
  40370. WIDTH="100%"
  40371. BORDER="0"
  40372. CELLPADDING="0"
  40373. CELLSPACING="0"
  40374. CLASS="EXAMPLE"
  40375. ><TR
  40376. ><TD
  40377. ><DIV
  40378. CLASS="example"
  40379. ><A
  40380. NAME="AEN7349"
  40381. ></A
  40382. ><P
  40383. ><B
  40384. >P°φklad 1. <B
  40385. CLASS="function"
  40386. >array_fill()</B
  40387. > example</B
  40388. ></P
  40389. ><TABLE
  40390. BORDER="0"
  40391. BGCOLOR="#E0E0E0"
  40392. CELLPADDING="5"
  40393. ><TR
  40394. ><TD
  40395. ><PRE
  40396. CLASS="php"
  40397. ><?php
  40398. $a = array_fill(5, 6, 'banana');
  40399. print_r($a);
  40400. ?></PRE
  40401. ></TD
  40402. ></TR
  40403. ></TABLE
  40404. ><P
  40405. >        <TT
  40406. CLASS="varname"
  40407. >$a</TT
  40408. > now is:
  40409.       </P
  40410. ><TABLE
  40411. BORDER="0"
  40412. BGCOLOR="#E0E0E0"
  40413. CELLPADDING="5"
  40414. ><TR
  40415. ><TD
  40416. ><PRE
  40417. CLASS="screen"
  40418. >Array
  40419. (
  40420.     [5]  => banana
  40421.     [6]  => banana
  40422.     [7]  => banana
  40423.     [8]  => banana
  40424.     [9]  => banana
  40425.     [10] => banana
  40426. )</PRE
  40427. ></TD
  40428. ></TR
  40429. ></TABLE
  40430. ></DIV
  40431. ></TD
  40432. ></TR
  40433. ></TABLE
  40434. >
  40435.     </P
  40436. ><P
  40437. >      See also <A
  40438. HREF="#function.str-repeat"
  40439. ><B
  40440. CLASS="function"
  40441. >str_repeat()</B
  40442. ></A
  40443. > and
  40444.      <A
  40445. HREF="#function.range"
  40446. ><B
  40447. CLASS="function"
  40448. >range()</B
  40449. ></A
  40450. >.
  40451.     </P
  40452. ></DIV
  40453. ><H1
  40454. ><A
  40455. NAME="function.array-filter"
  40456. ></A
  40457. >array_filter</H1
  40458. ><DIV
  40459. CLASS="refnamediv"
  40460. ><A
  40461. NAME="AEN7360"
  40462. ></A
  40463. ><P
  40464. >    (PHP 4 >= 4.0.6)</P
  40465. >array_filter -- 
  40466.      Filters elements of an array using a callback function
  40467.     </DIV
  40468. ><DIV
  40469. CLASS="refsect1"
  40470. ><A
  40471. NAME="AEN7363"
  40472. ></A
  40473. ><H2
  40474. >Description</H2
  40475. >array <B
  40476. CLASS="methodname"
  40477. >array_filter</B
  40478. > ( array input [, callback callback])<BR
  40479. ></BR
  40480. ><P
  40481. >      <B
  40482. CLASS="function"
  40483. >array_filter()</B
  40484. > iterates over each value in
  40485.      the <TT
  40486. CLASS="parameter"
  40487. ><I
  40488. >input</I
  40489. ></TT
  40490. > array passing them to the
  40491.      <TT
  40492. CLASS="parameter"
  40493. ><I
  40494. >callback</I
  40495. ></TT
  40496. > function.  If the <TT
  40497. CLASS="parameter"
  40498. ><I
  40499. >      callback</I
  40500. ></TT
  40501. > function returns true, the current
  40502.      value from <TT
  40503. CLASS="parameter"
  40504. ><I
  40505. >input</I
  40506. ></TT
  40507. > is returned into the
  40508.      result array.  Array keys are preserved.
  40509.     </P
  40510. ><P
  40511. >      <TABLE
  40512. WIDTH="100%"
  40513. BORDER="0"
  40514. CELLPADDING="0"
  40515. CELLSPACING="0"
  40516. CLASS="EXAMPLE"
  40517. ><TR
  40518. ><TD
  40519. ><DIV
  40520. CLASS="example"
  40521. ><A
  40522. NAME="AEN7381"
  40523. ></A
  40524. ><P
  40525. ><B
  40526. >P°φklad 1. <B
  40527. CLASS="function"
  40528. >array_filter()</B
  40529. > example</B
  40530. ></P
  40531. ><TABLE
  40532. BORDER="0"
  40533. BGCOLOR="#E0E0E0"
  40534. CELLPADDING="5"
  40535. ><TR
  40536. ><TD
  40537. ><PRE
  40538. CLASS="php"
  40539. ><?php
  40540. function odd($var) {
  40541.     return($var % 2 == 1);
  40542. }
  40543.  
  40544. function even($var) {
  40545.     return($var % 2 == 0);
  40546. }
  40547.  
  40548. $array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);
  40549. $array2 = array(6, 7, 8, 9, 10, 11, 12);
  40550.  
  40551. echo "Odd :\n";
  40552. print_r(array_filter($array1, "odd"));
  40553. echo "Even:\n";
  40554. print_r(array_filter($array2, "even"));
  40555. ?></PRE
  40556. ></TD
  40557. ></TR
  40558. ></TABLE
  40559. ><P
  40560. >        The printout of the program above will be:
  40561.       </P
  40562. ><TABLE
  40563. BORDER="0"
  40564. BGCOLOR="#E0E0E0"
  40565. CELLPADDING="5"
  40566. ><TR
  40567. ><TD
  40568. ><PRE
  40569. CLASS="php"
  40570. >Odd :
  40571. Array
  40572. (
  40573.     [a] => 1
  40574.     [c] => 3
  40575.     [e] => 5
  40576. )
  40577. Even:
  40578. Array
  40579. (
  40580.     [0] => 6
  40581.     [2] => 8
  40582.     [4] => 10
  40583.     [6] => 12
  40584. )</PRE
  40585. ></TD
  40586. ></TR
  40587. ></TABLE
  40588. ></DIV
  40589. ></TD
  40590. ></TR
  40591. ></TABLE
  40592. >
  40593.     </P
  40594. ><P
  40595. >      Users may not change the array itself from the callback
  40596.      function. e.g. Add/delete an element, unset the array that
  40597.      <B
  40598. CLASS="function"
  40599. >array_filter()</B
  40600. > is applied to. If the array
  40601.      is changed, the behavior of this function is undefined.
  40602.     </P
  40603. ><P
  40604. >      If the <TT
  40605. CLASS="parameter"
  40606. ><I
  40607. >callback</I
  40608. ></TT
  40609. > function is not supplied,
  40610.      <B
  40611. CLASS="function"
  40612. >array_filter()</B
  40613. > will remove all the entries of
  40614.      <TT
  40615. CLASS="parameter"
  40616. ><I
  40617. >input</I
  40618. ></TT
  40619. > that are equal to <TT
  40620. CLASS="constant"
  40621. ><B
  40622. >FALSE</B
  40623. ></TT
  40624. >. See <A
  40625. HREF="#language.types.boolean.casting"
  40626. >converting to boolean</A
  40627. > 
  40628.      for more information.
  40629.     </P
  40630. ><P
  40631. >      <TABLE
  40632. WIDTH="100%"
  40633. BORDER="0"
  40634. CELLPADDING="0"
  40635. CELLSPACING="0"
  40636. CLASS="EXAMPLE"
  40637. ><TR
  40638. ><TD
  40639. ><DIV
  40640. CLASS="example"
  40641. ><A
  40642. NAME="AEN7396"
  40643. ></A
  40644. ><P
  40645. ><B
  40646. >P°φklad 2. <B
  40647. CLASS="function"
  40648. >array_filter()</B
  40649. > without
  40650.       <TT
  40651. CLASS="parameter"
  40652. ><I
  40653. >callback</I
  40654. ></TT
  40655. ></B
  40656. ></P
  40657. ><TABLE
  40658. BORDER="0"
  40659. BGCOLOR="#E0E0E0"
  40660. CELLPADDING="5"
  40661. ><TR
  40662. ><TD
  40663. ><PRE
  40664. CLASS="php"
  40665. ><?php
  40666.  
  40667. $entry = array(
  40668.              0 => 'foo',
  40669.              1 => false,
  40670.              2 => -1,
  40671.              3 => null,
  40672.              4 => ''
  40673.           );
  40674.  
  40675. print_r(array_filter($entry));
  40676. ?></PRE
  40677. ></TD
  40678. ></TR
  40679. ></TABLE
  40680. ><P
  40681. >        This will output :
  40682.       </P
  40683. ><TABLE
  40684. BORDER="0"
  40685. BGCOLOR="#E0E0E0"
  40686. CELLPADDING="5"
  40687. ><TR
  40688. ><TD
  40689. ><PRE
  40690. CLASS="screen"
  40691. >Array
  40692. (
  40693.     [0] => foo
  40694.     [2] => -1
  40695. )</PRE
  40696. ></TD
  40697. ></TR
  40698. ></TABLE
  40699. ></DIV
  40700. ></TD
  40701. ></TR
  40702. ></TABLE
  40703. >
  40704.     </P
  40705. ><P
  40706. >      See also <A
  40707. HREF="#function.array-map"
  40708. ><B
  40709. CLASS="function"
  40710. >array_map()</B
  40711. ></A
  40712. >,
  40713.      <A
  40714. HREF="#function.array-reduce"
  40715. ><B
  40716. CLASS="function"
  40717. >array_reduce()</B
  40718. ></A
  40719. >, and <A
  40720. HREF="#function.array-walk"
  40721. ><B
  40722. CLASS="function"
  40723. >array_walk()</B
  40724. ></A
  40725. >.
  40726.     </P
  40727. ></DIV
  40728. ><H1
  40729. ><A
  40730. NAME="function.array-flip"
  40731. ></A
  40732. >array_flip</H1
  40733. ><DIV
  40734. CLASS="refnamediv"
  40735. ><A
  40736. NAME="AEN7408"
  40737. ></A
  40738. ><P
  40739. >    (PHP 4 )</P
  40740. >array_flip -- Prohodit klφΦe a hodnoty pole</DIV
  40741. ><DIV
  40742. CLASS="refsect1"
  40743. ><A
  40744. NAME="AEN7411"
  40745. ></A
  40746. ><H2
  40747. >Popis</H2
  40748. >array <B
  40749. CLASS="methodname"
  40750. >array_flip</B
  40751. > ( array trans)<BR
  40752. ></BR
  40753. ><P
  40754. >      <B
  40755. CLASS="function"
  40756. >array_flip()</B
  40757. > pole s prohozen²mi klφΦi a hodnotami.
  40758.     </P
  40759. ><P
  40760. >      <TABLE
  40761. WIDTH="100%"
  40762. BORDER="0"
  40763. CELLPADDING="0"
  40764. CELLSPACING="0"
  40765. CLASS="EXAMPLE"
  40766. ><TR
  40767. ><TD
  40768. ><DIV
  40769. CLASS="example"
  40770. ><A
  40771. NAME="AEN7422"
  40772. ></A
  40773. ><P
  40774. ><B
  40775. >P°φklad 1. Ukßzka <B
  40776. CLASS="function"
  40777. >array_flip()</B
  40778. ></B
  40779. ></P
  40780. ><TABLE
  40781. BORDER="0"
  40782. BGCOLOR="#E0E0E0"
  40783. CELLPADDING="5"
  40784. ><TR
  40785. ><TD
  40786. ><PRE
  40787. CLASS="php"
  40788. >$trans = array_flip ($trans);
  40789. $original = strtr ($str, $trans);</PRE
  40790. ></TD
  40791. ></TR
  40792. ></TABLE
  40793. ></DIV
  40794. ></TD
  40795. ></TR
  40796. ></TABLE
  40797. >
  40798.     </P
  40799. ></DIV
  40800. ><H1
  40801. ><A
  40802. NAME="function.array-intersect-assoc"
  40803. ></A
  40804. >array_intersect_assoc</H1
  40805. ><DIV
  40806. CLASS="refnamediv"
  40807. ><A
  40808. NAME="AEN7427"
  40809. ></A
  40810. ><P
  40811. >    (PHP 4 >= 4.3.0)</P
  40812. >array_intersect_assoc -- Computes the intersection of arrays with additional index check</DIV
  40813. ><DIV
  40814. CLASS="refsect1"
  40815. ><A
  40816. NAME="AEN7430"
  40817. ></A
  40818. ><H2
  40819. >Description</H2
  40820. >array <B
  40821. CLASS="methodname"
  40822. >array_intersect_assoc</B
  40823. > ( array array1, array array2 [, array ...])<BR
  40824. ></BR
  40825. ><P
  40826. >      <B
  40827. CLASS="function"
  40828. >array_intersect_assoc()</B
  40829. > returns an array
  40830.      containing all the values of <TT
  40831. CLASS="parameter"
  40832. ><I
  40833. >array1</I
  40834. ></TT
  40835. >
  40836.      that are present in all the arguments. Note that the keys are used in
  40837.      the comparison unlike in <A
  40838. HREF="#function.array-intersect"
  40839. ><B
  40840. CLASS="function"
  40841. >array_intersect()</B
  40842. ></A
  40843. >.
  40844.     </P
  40845. ><P
  40846. >      <TABLE
  40847. WIDTH="100%"
  40848. BORDER="0"
  40849. CELLPADDING="0"
  40850. CELLSPACING="0"
  40851. CLASS="EXAMPLE"
  40852. ><TR
  40853. ><TD
  40854. ><DIV
  40855. CLASS="example"
  40856. ><A
  40857. NAME="AEN7449"
  40858. ></A
  40859. ><P
  40860. ><B
  40861. >P°φklad 1. <B
  40862. CLASS="function"
  40863. >array_intersect_assoc()</B
  40864. > example</B
  40865. ></P
  40866. ><TABLE
  40867. BORDER="0"
  40868. BGCOLOR="#E0E0E0"
  40869. CELLPADDING="5"
  40870. ><TR
  40871. ><TD
  40872. ><PRE
  40873. CLASS="php"
  40874. ><?php
  40875. $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
  40876. $array2 = array("a" => "green", "yellow", "red");
  40877. $result_array = array_intersect_assoc($array1, $array2);
  40878. ?></PRE
  40879. ></TD
  40880. ></TR
  40881. ></TABLE
  40882. ><P
  40883. >        $result_array will look like:
  40884.       </P
  40885. ><TABLE
  40886. BORDER="0"
  40887. BGCOLOR="#E0E0E0"
  40888. CELLPADDING="5"
  40889. ><TR
  40890. ><TD
  40891. ><PRE
  40892. CLASS="screen"
  40893. >Array
  40894. (
  40895.     [a] => green
  40896. )</PRE
  40897. ></TD
  40898. ></TR
  40899. ></TABLE
  40900. ></DIV
  40901. ></TD
  40902. ></TR
  40903. ></TABLE
  40904. >
  40905.     </P
  40906. ><P
  40907. >      In our example you see that only the pair <TT
  40908. CLASS="literal"
  40909. >"a" =>
  40910.      "green"</TT
  40911. > is present in both arrays and thus is returned. 
  40912.      The value <TT
  40913. CLASS="literal"
  40914. >"red"</TT
  40915. > is not returned because in 
  40916.      <TT
  40917. CLASS="varname"
  40918. >$array1</TT
  40919. > it's key is <TT
  40920. CLASS="literal"
  40921. >0</TT
  40922. > while
  40923.      the key of "red" in <TT
  40924. CLASS="varname"
  40925. >$array2</TT
  40926. > is 
  40927.      <TT
  40928. CLASS="literal"
  40929. >1</TT
  40930. >.
  40931.     </P
  40932. ><P
  40933. >      The two values from the <TT
  40934. CLASS="literal"
  40935. >key => value</TT
  40936. > pairs are
  40937.      considered equal only if 
  40938.      <TT
  40939. CLASS="literal"
  40940. >(string) $elem1 === (string) $elem2 </TT
  40941. >. In otherwords
  40942.      a strict type check is executed so the string representation must be
  40943.      the same. 
  40944.      
  40945.     </P
  40946. ><P
  40947. >      See also <A
  40948. HREF="#function.array-intersect"
  40949. ><B
  40950. CLASS="function"
  40951. >array_intersect()</B
  40952. ></A
  40953. >,
  40954.      <A
  40955. HREF="#function.array-diff"
  40956. ><B
  40957. CLASS="function"
  40958. >array_diff()</B
  40959. ></A
  40960. > and
  40961.      <A
  40962. HREF="#function.array-diff-assoc"
  40963. ><B
  40964. CLASS="function"
  40965. >array_diff_assoc()</B
  40966. ></A
  40967. >.
  40968.     </P
  40969. ></DIV
  40970. ><H1
  40971. ><A
  40972. NAME="function.array-intersect"
  40973. ></A
  40974. >array_intersect</H1
  40975. ><DIV
  40976. CLASS="refnamediv"
  40977. ><A
  40978. NAME="AEN7470"
  40979. ></A
  40980. ><P
  40981. >    (PHP 4 >= 4.0.1)</P
  40982. >array_intersect -- SpoΦφtat pr∙nik polφ</DIV
  40983. ><DIV
  40984. CLASS="refsect1"
  40985. ><A
  40986. NAME="AEN7473"
  40987. ></A
  40988. ><H2
  40989. >Popis</H2
  40990. >array <B
  40991. CLASS="methodname"
  40992. >array_intersect</B
  40993. > ( array array1, array array2 [, array ...])<BR
  40994. ></BR
  40995. ><P
  40996. >      <B
  40997. CLASS="function"
  40998. >array_intersect()</B
  40999. > vracφ pole obsahujφcφ v╣echny hodnoty
  41000.      z <TT
  41001. CLASS="parameter"
  41002. ><I
  41003. >array1</I
  41004. ></TT
  41005. >, kterΘ se vyskytujφ ve v╣ech argumentech.
  41006.      KlφΦe jsou zachovßny.
  41007.     </P
  41008. ><P
  41009. >      <TABLE
  41010. WIDTH="100%"
  41011. BORDER="0"
  41012. CELLPADDING="0"
  41013. CELLSPACING="0"
  41014. CLASS="EXAMPLE"
  41015. ><TR
  41016. ><TD
  41017. ><DIV
  41018. CLASS="example"
  41019. ><A
  41020. NAME="AEN7491"
  41021. ></A
  41022. ><P
  41023. ><B
  41024. >P°φklad 1. Ukßzka <B
  41025. CLASS="function"
  41026. >array_intersect()</B
  41027. ></B
  41028. ></P
  41029. ><TABLE
  41030. BORDER="0"
  41031. BGCOLOR="#E0E0E0"
  41032. CELLPADDING="5"
  41033. ><TR
  41034. ><TD
  41035. ><PRE
  41036. CLASS="php"
  41037. >$array1 = array ("a" => "green", "red", "blue");
  41038. $array2 = array ("b" => "green", "yellow", "red");
  41039. $result = array_intersect ($array1, $array2);</PRE
  41040. ></TD
  41041. ></TR
  41042. ></TABLE
  41043. ></DIV
  41044. ></TD
  41045. ></TR
  41046. ></TABLE
  41047. >
  41048.     </P
  41049. ><P
  41050. >      <TT
  41051. CLASS="varname"
  41052. >$result</TT
  41053. > obsahuje <TT
  41054. CLASS="literal"
  41055. >array ("a" => "green",
  41056.      "red");</TT
  41057. >
  41058.     </P
  41059. ><P
  41060. >      Viz takΘ: <A
  41061. HREF="#function.array-diff"
  41062. ><B
  41063. CLASS="function"
  41064. >array_diff()</B
  41065. ></A
  41066. >.
  41067.     </P
  41068. ></DIV
  41069. ><H1
  41070. ><A
  41071. NAME="function.array-key-exists"
  41072. ></A
  41073. >array_key_exists</H1
  41074. ><DIV
  41075. CLASS="refnamediv"
  41076. ><A
  41077. NAME="AEN7501"
  41078. ></A
  41079. ><P
  41080. >    (PHP 4 >= 4.1.0)</P
  41081. >array_key_exists -- Checks if the given key or index exists in the array</DIV
  41082. ><DIV
  41083. CLASS="refsect1"
  41084. ><A
  41085. NAME="AEN7504"
  41086. ></A
  41087. ><H2
  41088. >Description</H2
  41089. >bool <B
  41090. CLASS="methodname"
  41091. >array_key_exists</B
  41092. > ( mixed key, array search)<BR
  41093. ></BR
  41094. ><P
  41095. >      <B
  41096. CLASS="function"
  41097. >array_key_exists()</B
  41098. > returns <TT
  41099. CLASS="constant"
  41100. ><B
  41101. >TRUE</B
  41102. ></TT
  41103. > if the
  41104.      given <TT
  41105. CLASS="parameter"
  41106. ><I
  41107. >key</I
  41108. ></TT
  41109. > is set in the array.
  41110.      <TT
  41111. CLASS="parameter"
  41112. ><I
  41113. >key</I
  41114. ></TT
  41115. > can be any value possible
  41116.      for an array index.
  41117.     </P
  41118. ><P
  41119. >      <TABLE
  41120. WIDTH="100%"
  41121. BORDER="0"
  41122. CELLPADDING="0"
  41123. CELLSPACING="0"
  41124. CLASS="EXAMPLE"
  41125. ><TR
  41126. ><TD
  41127. ><DIV
  41128. CLASS="example"
  41129. ><A
  41130. NAME="AEN7521"
  41131. ></A
  41132. ><P
  41133. ><B
  41134. >P°φklad 1. <B
  41135. CLASS="function"
  41136. >array_key_exists()</B
  41137. > example</B
  41138. ></P
  41139. ><TABLE
  41140. BORDER="0"
  41141. BGCOLOR="#E0E0E0"
  41142. CELLPADDING="5"
  41143. ><TR
  41144. ><TD
  41145. ><PRE
  41146. CLASS="php"
  41147. ><?php
  41148. $search_array = array("first" => 1, "second" => 4);
  41149. if (array_key_exists("first", $search_array)) {
  41150.     echo "The 'first' element is in the array";
  41151. }
  41152. ?></PRE
  41153. ></TD
  41154. ></TR
  41155. ></TABLE
  41156. ></DIV
  41157. ></TD
  41158. ></TR
  41159. ></TABLE
  41160. >
  41161.     </P
  41162. ><DIV
  41163. CLASS="note"
  41164. ><BLOCKQUOTE
  41165. CLASS="note"
  41166. ><P
  41167. ><B
  41168. >Poznßmka: </B
  41169. >
  41170.       The name of this function is <B
  41171. CLASS="function"
  41172. >key_exists()</B
  41173. >
  41174.       in PHP version 4.0.6.
  41175.      </P
  41176. ></BLOCKQUOTE
  41177. ></DIV
  41178. ><P
  41179. >      See also <A
  41180. HREF="#function.isset"
  41181. ><B
  41182. CLASS="function"
  41183. >isset()</B
  41184. ></A
  41185. >, 
  41186.      <A
  41187. HREF="#function.array-keys"
  41188. ><B
  41189. CLASS="function"
  41190. >array_keys()</B
  41191. ></A
  41192. >, and
  41193.      <A
  41194. HREF="#function.in-array"
  41195. ><B
  41196. CLASS="function"
  41197. >in_array()</B
  41198. ></A
  41199. >.
  41200.     </P
  41201. ></DIV
  41202. ><H1
  41203. ><A
  41204. NAME="function.array-keys"
  41205. ></A
  41206. >array_keys</H1
  41207. ><DIV
  41208. CLASS="refnamediv"
  41209. ><A
  41210. NAME="AEN7533"
  41211. ></A
  41212. ><P
  41213. >    (PHP 4 )</P
  41214. >array_keys -- Vrßtit v╣echny klφΦe pole</DIV
  41215. ><DIV
  41216. CLASS="refsect1"
  41217. ><A
  41218. NAME="AEN7536"
  41219. ></A
  41220. ><H2
  41221. >Popis</H2
  41222. >array <B
  41223. CLASS="methodname"
  41224. >array_keys</B
  41225. > ( array input [, mixed search_value])<BR
  41226. ></BR
  41227. ><P
  41228. >      <B
  41229. CLASS="function"
  41230. >array_keys()</B
  41231. > vracφ klφΦe, numerickΘ i textovΘ, z pole
  41232.      <TT
  41233. CLASS="parameter"
  41234. ><I
  41235. >input</I
  41236. ></TT
  41237. >.
  41238.     </P
  41239. ><P
  41240. >      Pokud je p°φtomen voliteln² argument <TT
  41241. CLASS="parameter"
  41242. ><I
  41243. >search_value</I
  41244. ></TT
  41245. >,
  41246.      vracφ pouze klφΦe tΘto hodnoty. Jinak vracφ v╣echny klφΦe z pole
  41247.      <TT
  41248. CLASS="parameter"
  41249. ><I
  41250. >input</I
  41251. ></TT
  41252. >.
  41253.     </P
  41254. ><P
  41255. >      <TABLE
  41256. WIDTH="100%"
  41257. BORDER="0"
  41258. CELLPADDING="0"
  41259. CELLSPACING="0"
  41260. CLASS="EXAMPLE"
  41261. ><TR
  41262. ><TD
  41263. ><DIV
  41264. CLASS="example"
  41265. ><A
  41266. NAME="AEN7554"
  41267. ></A
  41268. ><P
  41269. ><B
  41270. >P°φklad 1. Ukßzka <B
  41271. CLASS="function"
  41272. >array_keys()</B
  41273. ></B
  41274. ></P
  41275. ><TABLE
  41276. BORDER="0"
  41277. BGCOLOR="#E0E0E0"
  41278. CELLPADDING="5"
  41279. ><TR
  41280. ><TD
  41281. ><PRE
  41282. CLASS="php"
  41283. >$array = array (0 => 100, "color" => "red");
  41284. array_keys ($array);       // vracφ array (0, "color")
  41285.  
  41286. $array = array ("blue", "red", "green", "blue", "blue");
  41287. array_keys ($array, "blue");  //  vracφ array (0, 3, 4)
  41288.  
  41289. $array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large"));
  41290. array_keys ($array);  //  vracφ array ("color", "size")</PRE
  41291. ></TD
  41292. ></TR
  41293. ></TABLE
  41294. ></DIV
  41295. ></TD
  41296. ></TR
  41297. ></TABLE
  41298. >
  41299.     </P
  41300. ><DIV
  41301. CLASS="note"
  41302. ><BLOCKQUOTE
  41303. CLASS="note"
  41304. ><P
  41305. ><B
  41306. >Poznßmka: </B
  41307. >
  41308.       Tato funkce byla p°idßna v PHP 4, dßle je uvedena implementace pro ty, kte°φ
  41309.       stßle pou╛φvajφ PHP 3.
  41310.       <TABLE
  41311. WIDTH="100%"
  41312. BORDER="0"
  41313. CELLPADDING="0"
  41314. CELLSPACING="0"
  41315. CLASS="EXAMPLE"
  41316. ><TR
  41317. ><TD
  41318. ><DIV
  41319. CLASS="example"
  41320. ><A
  41321. NAME="AEN7560"
  41322. ></A
  41323. ><P
  41324. ><B
  41325. >P°φklad 2. 
  41326.         Implementace <B
  41327. CLASS="function"
  41328. >array_keys()</B
  41329. > pro u╛ivatele PHP 3
  41330.        </B
  41331. ></P
  41332. ><TABLE
  41333. BORDER="0"
  41334. BGCOLOR="#E0E0E0"
  41335. CELLPADDING="5"
  41336. ><TR
  41337. ><TD
  41338. ><PRE
  41339. CLASS="php"
  41340. >function array_keys ($arr, $term="") {
  41341.     $t = array();
  41342.     while (list($k,$v) = each($arr)) {
  41343.         if ($term && $v != $term)
  41344.             continue;
  41345.             $t[] = $k;
  41346.         }
  41347.         return $t;
  41348. }</PRE
  41349. ></TD
  41350. ></TR
  41351. ></TABLE
  41352. ></DIV
  41353. ></TD
  41354. ></TR
  41355. ></TABLE
  41356. >
  41357.      </P
  41358. ></BLOCKQUOTE
  41359. ></DIV
  41360. ><P
  41361. >      Viz takΘ: <A
  41362. HREF="#function.array-values"
  41363. ><B
  41364. CLASS="function"
  41365. >array_values()</B
  41366. ></A
  41367. >.
  41368.     </P
  41369. ></DIV
  41370. ><H1
  41371. ><A
  41372. NAME="function.array-map"
  41373. ></A
  41374. >array_map</H1
  41375. ><DIV
  41376. CLASS="refnamediv"
  41377. ><A
  41378. NAME="AEN7567"
  41379. ></A
  41380. ><P
  41381. >    (PHP 4 >= 4.0.6)</P
  41382. >array_map -- 
  41383.      Applies the callback to the elements of the given arrays
  41384.     </DIV
  41385. ><DIV
  41386. CLASS="refsect1"
  41387. ><A
  41388. NAME="AEN7570"
  41389. ></A
  41390. ><H2
  41391. >Description</H2
  41392. >array <B
  41393. CLASS="methodname"
  41394. >array_map</B
  41395. > ( mixed callback, array arr1 [, array ...])<BR
  41396. ></BR
  41397. ><P
  41398. >      <B
  41399. CLASS="function"
  41400. >array_map()</B
  41401. > returns an array containing all
  41402.      the elements of <TT
  41403. CLASS="parameter"
  41404. ><I
  41405. >arr1</I
  41406. ></TT
  41407. > after applying the
  41408.      <TT
  41409. CLASS="parameter"
  41410. ><I
  41411. >callback</I
  41412. ></TT
  41413. > function to each one.
  41414.      The number of parameters that the <TT
  41415. CLASS="parameter"
  41416. ><I
  41417. >callback</I
  41418. ></TT
  41419. >
  41420.      function accepts
  41421.      should match the number of arrays
  41422.      passed to the <B
  41423. CLASS="function"
  41424. >array_map()</B
  41425. >
  41426.     </P
  41427. ><P
  41428. >      <TABLE
  41429. WIDTH="100%"
  41430. BORDER="0"
  41431. CELLPADDING="0"
  41432. CELLSPACING="0"
  41433. CLASS="EXAMPLE"
  41434. ><TR
  41435. ><TD
  41436. ><DIV
  41437. CLASS="example"
  41438. ><A
  41439. NAME="AEN7591"
  41440. ></A
  41441. ><P
  41442. ><B
  41443. >P°φklad 1. <B
  41444. CLASS="function"
  41445. >array_map()</B
  41446. > example</B
  41447. ></P
  41448. ><TABLE
  41449. BORDER="0"
  41450. BGCOLOR="#E0E0E0"
  41451. CELLPADDING="5"
  41452. ><TR
  41453. ><TD
  41454. ><PRE
  41455. CLASS="php"
  41456. ><?php
  41457. function cube($n) {
  41458.     return($n * $n * $n);
  41459. }
  41460.  
  41461. $a = array(1, 2, 3, 4, 5);
  41462. $b = array_map("cube", $a);
  41463. print_r($b);
  41464. ?></PRE
  41465. ></TD
  41466. ></TR
  41467. ></TABLE
  41468. ><P
  41469. >        This makes <TT
  41470. CLASS="varname"
  41471. >$b</TT
  41472. > have:
  41473.       </P
  41474. ><TABLE
  41475. BORDER="0"
  41476. BGCOLOR="#E0E0E0"
  41477. CELLPADDING="5"
  41478. ><TR
  41479. ><TD
  41480. ><PRE
  41481. CLASS="screen"
  41482. >Array
  41483. (
  41484.     [0] => 1
  41485.     [1] => 8
  41486.     [2] => 27
  41487.     [3] => 64
  41488.     [4] => 125
  41489. )</PRE
  41490. ></TD
  41491. ></TR
  41492. ></TABLE
  41493. ></DIV
  41494. ></TD
  41495. ></TR
  41496. ></TABLE
  41497. >
  41498.     </P
  41499. ><P
  41500. >      <TABLE
  41501. WIDTH="100%"
  41502. BORDER="0"
  41503. CELLPADDING="0"
  41504. CELLSPACING="0"
  41505. CLASS="EXAMPLE"
  41506. ><TR
  41507. ><TD
  41508. ><DIV
  41509. CLASS="example"
  41510. ><A
  41511. NAME="AEN7599"
  41512. ></A
  41513. ><P
  41514. ><B
  41515. >P°φklad 2. <B
  41516. CLASS="function"
  41517. >array_map()</B
  41518. > - using more arrays</B
  41519. ></P
  41520. ><TABLE
  41521. BORDER="0"
  41522. BGCOLOR="#E0E0E0"
  41523. CELLPADDING="5"
  41524. ><TR
  41525. ><TD
  41526. ><PRE
  41527. CLASS="php"
  41528. ><?php
  41529. function show_Spanish($n, $m) {
  41530.     return("The number $n is called $m in Spanish");
  41531. }
  41532.  
  41533. function map_Spanish($n, $m) {
  41534.     return(array($n => $m));
  41535. }
  41536.  
  41537. $a = array(1, 2, 3, 4, 5);
  41538. $b = array("uno", "dos", "tres", "cuatro", "cinco");
  41539.  
  41540. $c = array_map("show_Spanish", $a, $b);
  41541. print_r($c);
  41542.  
  41543. $d = array_map("map_Spanish", $a , $b);
  41544. print_r($d);
  41545. ?></PRE
  41546. ></TD
  41547. ></TR
  41548. ></TABLE
  41549. ><P
  41550. >        This results:
  41551.       </P
  41552. ><TABLE
  41553. BORDER="0"
  41554. BGCOLOR="#E0E0E0"
  41555. CELLPADDING="5"
  41556. ><TR
  41557. ><TD
  41558. ><PRE
  41559. CLASS="screen"
  41560. >// printout of $c
  41561. Array
  41562. (
  41563.     [0] => The number 1 is called uno in Spanish
  41564.     [1] => The number 2 is called dos in Spanish
  41565.     [2] => The number 3 is called tres in Spanish
  41566.     [3] => The number 4 is called cuatro in Spanish
  41567.     [4] => The number 5 is called cinco in Spanish
  41568. )
  41569.  
  41570. // printout of $d
  41571. Array
  41572. (
  41573.     [0] => Array
  41574.         (
  41575.             [1] => uno
  41576.         )
  41577.  
  41578.     [1] => Array
  41579.         (
  41580.             [2] => dos
  41581.         )
  41582.  
  41583.     [2] => Array
  41584.         (
  41585.             [3] => tres
  41586.         )
  41587.  
  41588.     [3] => Array
  41589.         (
  41590.             [4] => cuatro
  41591.         )
  41592.  
  41593.     [4] => Array
  41594.         (
  41595.             [5] => cinco
  41596.         )
  41597.  
  41598. )</PRE
  41599. ></TD
  41600. ></TR
  41601. ></TABLE
  41602. ></DIV
  41603. ></TD
  41604. ></TR
  41605. ></TABLE
  41606. >
  41607.     </P
  41608. ><P
  41609. >      Usually when using two or more arrays, they should be of equal length
  41610.      because the callback function is applied in parallel to the corresponding
  41611.      elements.
  41612.      If the arrays are of unequal length, the shortest one will be extended
  41613.      with empty elements.
  41614.     </P
  41615. ><P
  41616. >      An interesting use of this function is to construct an array of arrays,
  41617.      which can be easily performed by using <TT
  41618. CLASS="constant"
  41619. ><B
  41620. >NULL</B
  41621. ></TT
  41622. >
  41623.      as the name of the callback function
  41624.     </P
  41625. ><P
  41626. >      <TABLE
  41627. WIDTH="100%"
  41628. BORDER="0"
  41629. CELLPADDING="0"
  41630. CELLSPACING="0"
  41631. CLASS="EXAMPLE"
  41632. ><TR
  41633. ><TD
  41634. ><DIV
  41635. CLASS="example"
  41636. ><A
  41637. NAME="AEN7609"
  41638. ></A
  41639. ><P
  41640. ><B
  41641. >P°φklad 3. Creating an array of arrays</B
  41642. ></P
  41643. ><TABLE
  41644. BORDER="0"
  41645. BGCOLOR="#E0E0E0"
  41646. CELLPADDING="5"
  41647. ><TR
  41648. ><TD
  41649. ><PRE
  41650. CLASS="php"
  41651. ><?php
  41652. $a = array(1, 2, 3, 4, 5);
  41653. $b = array("one", "two", "three", "four", "five");
  41654. $c = array("uno", "dos", "tres", "cuatro", "cinco");
  41655.  
  41656. $d = array_map(null, $a, $b, $c);
  41657. print_r($d);
  41658. ?></PRE
  41659. ></TD
  41660. ></TR
  41661. ></TABLE
  41662. ></DIV
  41663. ></TD
  41664. ></TR
  41665. ></TABLE
  41666. >
  41667.     </P
  41668. ><P
  41669. >      The printout of the program above will be:
  41670.     </P
  41671. ><TABLE
  41672. BORDER="0"
  41673. BGCOLOR="#E0E0E0"
  41674. CELLPADDING="5"
  41675. ><TR
  41676. ><TD
  41677. ><PRE
  41678. CLASS="screen"
  41679. >Array
  41680. (
  41681.     [0] => Array
  41682.         (
  41683.             [0] => 1
  41684.             [1] => one
  41685.             [2] => uno
  41686.         )
  41687.  
  41688.     [1] => Array
  41689.         (
  41690.             [0] => 2
  41691.             [1] => two
  41692.             [2] => dos
  41693.         )
  41694.  
  41695.     [2] => Array
  41696.         (
  41697.             [0] => 3
  41698.             [1] => three
  41699.             [2] => tres
  41700.         )
  41701.  
  41702.     [3] => Array
  41703.         (
  41704.             [0] => 4
  41705.             [1] => four
  41706.             [2] => cuatro
  41707.         )
  41708.  
  41709.     [4] => Array
  41710.         (
  41711.             [0] => 5
  41712.             [1] => five
  41713.             [2] => cinco
  41714.         )
  41715.  
  41716. )</PRE
  41717. ></TD
  41718. ></TR
  41719. ></TABLE
  41720. ><P
  41721. >      See also <A
  41722. HREF="#function.array-filter"
  41723. ><B
  41724. CLASS="function"
  41725. >array_filter()</B
  41726. ></A
  41727. >, 
  41728.      <A
  41729. HREF="#function.array-reduce"
  41730. ><B
  41731. CLASS="function"
  41732. >array_reduce()</B
  41733. ></A
  41734. >, and
  41735.      <A
  41736. HREF="#function.array-walk"
  41737. ><B
  41738. CLASS="function"
  41739. >array_walk()</B
  41740. ></A
  41741. >.
  41742.     </P
  41743. ></DIV
  41744. ><H1
  41745. ><A
  41746. NAME="function.array-merge-recursive"
  41747. ></A
  41748. >array_merge_recursive</H1
  41749. ><DIV
  41750. CLASS="refnamediv"
  41751. ><A
  41752. NAME="AEN7619"
  41753. ></A
  41754. ><P
  41755. >    (PHP 4 >= 4.0.1)</P
  41756. >array_merge_recursive -- Rekurzivn∞ slouΦit dv∞ nebo vφce polφ</DIV
  41757. ><DIV
  41758. CLASS="refsect1"
  41759. ><A
  41760. NAME="AEN7622"
  41761. ></A
  41762. ><H2
  41763. >Popis</H2
  41764. >array <B
  41765. CLASS="methodname"
  41766. >array_merge_recursive</B
  41767. > ( array array1, array array2 [, array ...])<BR
  41768. ></BR
  41769. ><P
  41770. >      <B
  41771. CLASS="function"
  41772. >array_merge_recursive()</B
  41773. > slouΦφ prvky dvou nebo vφce
  41774.      polφ tak, ╛e hodnoty pole se p°ipojφ na konec p°edchozφho pole. Vracφ
  41775.      v²slednΘ pole.
  41776.     </P
  41777. ><P
  41778. >      Pokud obsahujφ vstupnφ pole stejn² textov² klφΦ, hodnoty t∞chto klφΦ∙ se
  41779.      rekurzivn∞ slouΦφ do pole tak, ╛e pokud je jedna z hodnot sama pole, tato
  41780.      funkce ji takΘ slouΦφ s odpovφdajφcφ polo╛kou z dal╣φho pole. Pokud ale
  41781.      tato pole majφ stejn² Φφseln² klφΦ, pozd∞j╣φ hodnota nep°epφ╣e tu d°φv∞j╣φ,
  41782.      ale p°ipojφ se.
  41783.     </P
  41784. ><P
  41785. >      <TABLE
  41786. WIDTH="100%"
  41787. BORDER="0"
  41788. CELLPADDING="0"
  41789. CELLSPACING="0"
  41790. CLASS="EXAMPLE"
  41791. ><TR
  41792. ><TD
  41793. ><DIV
  41794. CLASS="example"
  41795. ><A
  41796. NAME="AEN7640"
  41797. ></A
  41798. ><P
  41799. ><B
  41800. >P°φklad 1. Ukßzka <B
  41801. CLASS="function"
  41802. >array_merge_recursive()</B
  41803. ></B
  41804. ></P
  41805. ><TABLE
  41806. BORDER="0"
  41807. BGCOLOR="#E0E0E0"
  41808. CELLPADDING="5"
  41809. ><TR
  41810. ><TD
  41811. ><PRE
  41812. CLASS="php"
  41813. >$ar1 = array ("color" => array ("favorite" => "red"), 5);
  41814. $ar2 = array (10, "color" => array ("favorite" => "green", "blue"));
  41815. $result = array_merge_recursive ($ar1, $ar2);</PRE
  41816. ></TD
  41817. ></TR
  41818. ></TABLE
  41819. ></DIV
  41820. ></TD
  41821. ></TR
  41822. ></TABLE
  41823. >
  41824.     </P
  41825. ><P
  41826. >      V²slednΘ pole bude <TT
  41827. CLASS="literal"
  41828. >array ("color" => array
  41829.      ("favorite" => array ("red", "green"), "blue"), 5, 10)</TT
  41830. >.
  41831.     </P
  41832. ><P
  41833. >      Viz takΘ: <A
  41834. HREF="#function.array-merge"
  41835. ><B
  41836. CLASS="function"
  41837. >array_merge()</B
  41838. ></A
  41839. >.
  41840.     </P
  41841. ></DIV
  41842. ><H1
  41843. ><A
  41844. NAME="function.array-merge"
  41845. ></A
  41846. >array_merge</H1
  41847. ><DIV
  41848. CLASS="refnamediv"
  41849. ><A
  41850. NAME="AEN7649"
  41851. ></A
  41852. ><P
  41853. >    (PHP 4 )</P
  41854. >array_merge -- SlouΦit dv∞ nebo vφce polφ</DIV
  41855. ><DIV
  41856. CLASS="refsect1"
  41857. ><A
  41858. NAME="AEN7652"
  41859. ></A
  41860. ><H2
  41861. >Popis</H2
  41862. >array <B
  41863. CLASS="methodname"
  41864. >array_merge</B
  41865. > ( array array1, array array2 [, array ...])<BR
  41866. ></BR
  41867. ><P
  41868. >      <B
  41869. CLASS="function"
  41870. >array_merge()</B
  41871. > slouΦφ prvky dvou nebo vφce polφ dohromady
  41872.      tak, ╛e hodnoty ka╛dΘho pole se p°ipojφ na konec p°edchozφho. Vracφ v²slednΘ
  41873.      pole.
  41874.     </P
  41875. ><P
  41876. >      Pokud majφ vstupnφ pole stejn² textov² klφΦ, pozd∞j╣φ hodnota p°epφ╣e
  41877.      d°φv∞j╣φ hodnotu. Pokud ale majφ stejn² Φφseln² klφΦ, pozd∞j╣φ hodnota tu
  41878.      p·vodnφ nep°epφ╣e, ale p°ipojφ se k nφ.
  41879.     </P
  41880. ><P
  41881. >      <TABLE
  41882. WIDTH="100%"
  41883. BORDER="0"
  41884. CELLPADDING="0"
  41885. CELLSPACING="0"
  41886. CLASS="EXAMPLE"
  41887. ><TR
  41888. ><TD
  41889. ><DIV
  41890. CLASS="example"
  41891. ><A
  41892. NAME="AEN7670"
  41893. ></A
  41894. ><P
  41895. ><B
  41896. >P°φklad 1. Ukßzka <B
  41897. CLASS="function"
  41898. >array_merge()</B
  41899. ></B
  41900. ></P
  41901. ><TABLE
  41902. BORDER="0"
  41903. BGCOLOR="#E0E0E0"
  41904. CELLPADDING="5"
  41905. ><TR
  41906. ><TD
  41907. ><PRE
  41908. CLASS="php"
  41909. >$array1 = array ("color" => "red", 2, 4);
  41910. $array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4);
  41911. array_merge ($array1, $array2);</PRE
  41912. ></TD
  41913. ></TR
  41914. ></TABLE
  41915. ></DIV
  41916. ></TD
  41917. ></TR
  41918. ></TABLE
  41919. >
  41920.     </P
  41921. ><P
  41922. >      V²slednΘ pole bude <TT
  41923. CLASS="literal"
  41924. >array("color" => "green", 2, 4,
  41925.      "a", "b", "shape" => "trapezoid", 4)</TT
  41926. >.
  41927.     </P
  41928. ><P
  41929. >      Viz takΘ: <A
  41930. HREF="#function.array-merge-recursive"
  41931. ><B
  41932. CLASS="function"
  41933. >array_merge_recursive()</B
  41934. ></A
  41935. >.
  41936.     </P
  41937. ></DIV
  41938. ><H1
  41939. ><A
  41940. NAME="function.array-multisort"
  41941. ></A
  41942. >array_multisort</H1
  41943. ><DIV
  41944. CLASS="refnamediv"
  41945. ><A
  41946. NAME="AEN7679"
  41947. ></A
  41948. ><P
  41949. >    (PHP 4 )</P
  41950. >array_multisort -- T°φdit vφce polφ, nebo vφcerozm∞rnΘ pole</DIV
  41951. ><DIV
  41952. CLASS="refsect1"
  41953. ><A
  41954. NAME="AEN7682"
  41955. ></A
  41956. ><H2
  41957. >Popis</H2
  41958. >bool <B
  41959. CLASS="methodname"
  41960. >array_multisort</B
  41961. > ( array ar1 [, mixed arg [, mixed ... [, array ...]]])<BR
  41962. ></BR
  41963. ><P
  41964. >      <B
  41965. CLASS="function"
  41966. >array_multisort()</B
  41967. > se dß vyu╛φt k t°φd∞nφ n∞kolika
  41968.      polφ najednou nebo k t°φd∞nφ vφcerozm∞rnΘho pole XXX according by one of
  41969.      more dimensions. P°i t°φd∞nφ udr╛uje asociace klφΦ∙.
  41970.     </P
  41971. ><P
  41972. >      Vstupnφ pole jsou manipulovßna jako sloupce tabulky, kterß se mß t°φdit
  41973.      podle °ßdk∙ - p°ipomφnß to funkcionalitu SQL klauzule ORDER BY. Prvnφ pole
  41974.      je to, podle kterΘho se bude t°φdit. ╪ßdky (hodnoty) v tomto poli that
  41975.      compare the same are sorted by the next input array, and so on.
  41976.     </P
  41977. ><P
  41978. >      Struktura argument∙ tΘto funkce je trochu neobvyklß, ale pru╛nß. Prvnφ
  41979.      argument musφ b²t pole. Ka╛d² dal╣φ argument m∙╛e b²t bu∩ pole nebo jeden
  41980.      z p°φznak z nßsledujφcφch seznam∙:
  41981.     </P
  41982. ><P
  41983. >      P°φznaky sm∞ru t°φd∞nφ:
  41984.      <P
  41985. ></P
  41986. ><UL
  41987. ><LI
  41988. ><P
  41989. >SORT_ASC - t°φdit vzestupn∞</P
  41990. ></LI
  41991. ><LI
  41992. ><P
  41993. >SORT_DESC - t°φdit sestupn∞</P
  41994. ></LI
  41995. ></UL
  41996. >
  41997.     </P
  41998. ><P
  41999. >      P°φznaky typu t°φd∞nφ:
  42000.      <P
  42001. ></P
  42002. ><UL
  42003. ><LI
  42004. ><P
  42005. >SORT_REGULAR - porovnßvat polo╛ky normßln∞</P
  42006. ></LI
  42007. ><LI
  42008. ><P
  42009. >SORT_NUMERIC - porovnßvat polo╛ky Φφseln∞</P
  42010. ></LI
  42011. ><LI
  42012. ><P
  42013. >SORT_STRING - porovnßvat polo╛ky jako °et∞zce</P
  42014. ></LI
  42015. ></UL
  42016. >
  42017.     </P
  42018. ><P
  42019. >      Po ka╛dΘm poli m∙╛ete specifikovat jeden p°φznak ka╛dΘho typu. P°φznaky
  42020.      t°φd∞nφ specifikovanΘ po ka╛dΘm poli platφ pouze pro toto pole - pro dal╣φ
  42021.      pole se resetujφ na defaultnφ SORT_ASC a SORT_REGULAR.
  42022.     </P
  42023. ><P
  42024. >      P°i ·sp∞chu vracφ <TT
  42025. CLASS="constant"
  42026. ><B
  42027. >TRUE</B
  42028. ></TT
  42029. >, p°i selhßnφ
  42030.      <TT
  42031. CLASS="constant"
  42032. ><B
  42033. >FALSE</B
  42034. ></TT
  42035. >.
  42036.     </P
  42037. ><P
  42038. >      <TABLE
  42039. WIDTH="100%"
  42040. BORDER="0"
  42041. CELLPADDING="0"
  42042. CELLSPACING="0"
  42043. CLASS="EXAMPLE"
  42044. ><TR
  42045. ><TD
  42046. ><DIV
  42047. CLASS="example"
  42048. ><A
  42049. NAME="AEN7722"
  42050. ></A
  42051. ><P
  42052. ><B
  42053. >P°φklad 1. T°φd∞nφ vφce polφ</B
  42054. ></P
  42055. ><TABLE
  42056. BORDER="0"
  42057. BGCOLOR="#E0E0E0"
  42058. CELLPADDING="5"
  42059. ><TR
  42060. ><TD
  42061. ><PRE
  42062. CLASS="php"
  42063. >$ar1 = array ("10", 100, 100, "a");
  42064. $ar2 = array (1, 3, "2", 1);
  42065. array_multisort ($ar1, $ar2);</PRE
  42066. ></TD
  42067. ></TR
  42068. ></TABLE
  42069. ></DIV
  42070. ></TD
  42071. ></TR
  42072. ></TABLE
  42073. >
  42074.     </P
  42075. ><P
  42076. >      V tΘto ukßzce bude po set°φd∞nφ prvnφ pole obsahovat 10, "a", 100, 100.
  42077.      DruhΘ pole bude obsahovat 1, 1, 2, "3". Polo╛ky druhΘho pole odpovφdajφcφ
  42078.      identick²m polo╛kßm v prvnφm poli (100 a 100) byly takΘ set°φd∞ny.
  42079.     </P
  42080. ><P
  42081. >      <TABLE
  42082. WIDTH="100%"
  42083. BORDER="0"
  42084. CELLPADDING="0"
  42085. CELLSPACING="0"
  42086. CLASS="EXAMPLE"
  42087. ><TR
  42088. ><TD
  42089. ><DIV
  42090. CLASS="example"
  42091. ><A
  42092. NAME="AEN7727"
  42093. ></A
  42094. ><P
  42095. ><B
  42096. >P°φklad 2. T°φd∞nφ vφcerozm∞rnΘho pole</B
  42097. ></P
  42098. ><TABLE
  42099. BORDER="0"
  42100. BGCOLOR="#E0E0E0"
  42101. CELLPADDING="5"
  42102. ><TR
  42103. ><TD
  42104. ><PRE
  42105. CLASS="php"
  42106. >$ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1));
  42107. array_multisort ($ar[0], SORT_ASC, SORT_STRING,
  42108.                  $ar[1], SORT_NUMERIC, SORT_DESC);</PRE
  42109. ></TD
  42110. ></TR
  42111. ></TABLE
  42112. ></DIV
  42113. ></TD
  42114. ></TR
  42115. ></TABLE
  42116. >
  42117.     </P
  42118. ><P
  42119. >      V tΘto ukßzce bude po set°φd∞nφ prvnφ pole obsahovat 10, 100, 100, "a"
  42120.      (bylo t°φd∞no vzestupn∞ jako °et∞zce) a druhΘ pole bude obsahovat 1, 3,
  42121.      "2", 1 (t°φd∞no jako Φφsla, sestupn∞).
  42122.     </P
  42123. ></DIV
  42124. ><H1
  42125. ><A
  42126. NAME="function.array-pad"
  42127. ></A
  42128. >array_pad</H1
  42129. ><DIV
  42130. CLASS="refnamediv"
  42131. ><A
  42132. NAME="AEN7732"
  42133. ></A
  42134. ><P
  42135. >    (PHP 4 )</P
  42136. >array_pad -- Doplnit pole hodnotou na urΦenou dΘlku</DIV
  42137. ><DIV
  42138. CLASS="refsect1"
  42139. ><A
  42140. NAME="AEN7735"
  42141. ></A
  42142. ><H2
  42143. >Popis</H2
  42144. >array <B
  42145. CLASS="methodname"
  42146. >array_pad</B
  42147. > ( array input, int pad_size, mixed pad_value)<BR
  42148. ></BR
  42149. ><P
  42150. >      <B
  42151. CLASS="function"
  42152. >array_pad()</B
  42153. > vracφ kopii pole
  42154.      <TT
  42155. CLASS="parameter"
  42156. ><I
  42157. >input</I
  42158. ></TT
  42159. > dopln∞nou na velikost
  42160.      <TT
  42161. CLASS="parameter"
  42162. ><I
  42163. >pad_size</I
  42164. ></TT
  42165. > hodnotou
  42166.      <TT
  42167. CLASS="parameter"
  42168. ><I
  42169. >pad_value</I
  42170. ></TT
  42171. >. Pokud je
  42172.      <TT
  42173. CLASS="parameter"
  42174. ><I
  42175. >pad_size</I
  42176. ></TT
  42177. > kladnß, pole je dopln∞no zprava, pokud je
  42178.      negativnφ, zleva. Pokud je absolutnφ hodnota <TT
  42179. CLASS="parameter"
  42180. ><I
  42181. >pad_size</I
  42182. ></TT
  42183. >
  42184.      men╣φ nebo rovna velikosti <TT
  42185. CLASS="parameter"
  42186. ><I
  42187. >input</I
  42188. ></TT
  42189. >, k dopln∞nφ nedojde.
  42190.     </P
  42191. ><P
  42192. >      <TABLE
  42193. WIDTH="100%"
  42194. BORDER="0"
  42195. CELLPADDING="0"
  42196. CELLSPACING="0"
  42197. CLASS="EXAMPLE"
  42198. ><TR
  42199. ><TD
  42200. ><DIV
  42201. CLASS="example"
  42202. ><A
  42203. NAME="AEN7758"
  42204. ></A
  42205. ><P
  42206. ><B
  42207. >P°φklad 1. Ukßzka <B
  42208. CLASS="function"
  42209. >array_pad()</B
  42210. ></B
  42211. ></P
  42212. ><TABLE
  42213. BORDER="0"
  42214. BGCOLOR="#E0E0E0"
  42215. CELLPADDING="5"
  42216. ><TR
  42217. ><TD
  42218. ><PRE
  42219. CLASS="php"
  42220. >$input = array (12, 10, 9);
  42221.  
  42222. $result = array_pad ($input, 5, 0);
  42223. // v²sledek je array (12, 10, 9, 0, 0)
  42224.  
  42225. $result = array_pad ($input, -7, -1);
  42226. // v²sledek je array (-1, -1, -1, -1, 12, 10, 9)
  42227.  
  42228. $result = array_pad ($input, 2, "noop");
  42229. // nedopln∞no</PRE
  42230. ></TD
  42231. ></TR
  42232. ></TABLE
  42233. ></DIV
  42234. ></TD
  42235. ></TR
  42236. ></TABLE
  42237. >
  42238.     </P
  42239. ></DIV
  42240. ><H1
  42241. ><A
  42242. NAME="function.array-pop"
  42243. ></A
  42244. >array_pop</H1
  42245. ><DIV
  42246. CLASS="refnamediv"
  42247. ><A
  42248. NAME="AEN7763"
  42249. ></A
  42250. ><P
  42251. >    (PHP 4 )</P
  42252. >array_pop -- Odstranit prvek z konce pole</DIV
  42253. ><DIV
  42254. CLASS="refsect1"
  42255. ><A
  42256. NAME="AEN7766"
  42257. ></A
  42258. ><H2
  42259. >Popis</H2
  42260. >mixed <B
  42261. CLASS="methodname"
  42262. >array_pop</B
  42263. > ( array array)<BR
  42264. ></BR
  42265. ><P
  42266. >      <B
  42267. CLASS="function"
  42268. >array_pop()</B
  42269. > odstranφ a vrßtφ poslednφ hodnotu pole
  42270.      <TT
  42271. CLASS="parameter"
  42272. ><I
  42273. >array</I
  42274. ></TT
  42275. >, Φφm╛ ho zkrßtφ o jeden prvek.
  42276.     </P
  42277. ><P
  42278. >      <TABLE
  42279. WIDTH="100%"
  42280. BORDER="0"
  42281. CELLPADDING="0"
  42282. CELLSPACING="0"
  42283. CLASS="EXAMPLE"
  42284. ><TR
  42285. ><TD
  42286. ><DIV
  42287. CLASS="example"
  42288. ><A
  42289. NAME="AEN7778"
  42290. ></A
  42291. ><P
  42292. ><B
  42293. >P°φklad 1. Ukßzka <B
  42294. CLASS="function"
  42295. >array_pop()</B
  42296. ></B
  42297. ></P
  42298. ><TABLE
  42299. BORDER="0"
  42300. BGCOLOR="#E0E0E0"
  42301. CELLPADDING="5"
  42302. ><TR
  42303. ><TD
  42304. ><PRE
  42305. CLASS="php"
  42306. >$stack = array ("orange", "apple", "raspberry");
  42307. $fruit = array_pop ($stack);</PRE
  42308. ></TD
  42309. ></TR
  42310. ></TABLE
  42311. ></DIV
  42312. ></TD
  42313. ></TR
  42314. ></TABLE
  42315. >
  42316.     </P
  42317. ><P
  42318. >      <TT
  42319. CLASS="varname"
  42320. >$stack</TT
  42321. > mß te∩ pouze dva prvky:
  42322.      "orange" a "apple", a <TT
  42323. CLASS="varname"
  42324. >$fruit</TT
  42325. > obsahuje "raspberry".
  42326.     </P
  42327. ><P
  42328. >      Viz takΘ: <A
  42329. HREF="#function.array-push"
  42330. ><B
  42331. CLASS="function"
  42332. >array_push()</B
  42333. ></A
  42334. >,
  42335.      <A
  42336. HREF="#function.array-shift"
  42337. ><B
  42338. CLASS="function"
  42339. >array_shift()</B
  42340. ></A
  42341. > a
  42342.      <A
  42343. HREF="#function.array-unshift"
  42344. ><B
  42345. CLASS="function"
  42346. >array_unshift()</B
  42347. ></A
  42348. >.
  42349.     </P
  42350. ></DIV
  42351. ><H1
  42352. ><A
  42353. NAME="function.array-push"
  42354. ></A
  42355. >array_push</H1
  42356. ><DIV
  42357. CLASS="refnamediv"
  42358. ><A
  42359. NAME="AEN7790"
  42360. ></A
  42361. ><P
  42362. >    (PHP 4 )</P
  42363. >array_push -- P°idat jeden nebo vφce prvk∙ na konec pole</DIV
  42364. ><DIV
  42365. CLASS="refsect1"
  42366. ><A
  42367. NAME="AEN7793"
  42368. ></A
  42369. ><H2
  42370. >Popis</H2
  42371. >int <B
  42372. CLASS="methodname"
  42373. >array_push</B
  42374. > ( array array, mixed var [, mixed ...])<BR
  42375. ></BR
  42376. ><P
  42377. >      <B
  42378. CLASS="function"
  42379. >array_push()</B
  42380. > p°ipojuje p°edanΘ prom∞nnΘ na konec
  42381.      <TT
  42382. CLASS="parameter"
  42383. ><I
  42384. >array</I
  42385. ></TT
  42386. >. DΘlka <TT
  42387. CLASS="parameter"
  42388. ><I
  42389. >array</I
  42390. ></TT
  42391. > se zv∞t╣uje
  42392.      o poΦet p°idan²ch prom∞nn²ch. ┌Φinek je stejn² jako:
  42393.      <TABLE
  42394. BORDER="0"
  42395. BGCOLOR="#E0E0E0"
  42396. CELLPADDING="5"
  42397. ><TR
  42398. ><TD
  42399. ><PRE
  42400. CLASS="php"
  42401. >$array[] = $var;</PRE
  42402. ></TD
  42403. ></TR
  42404. ></TABLE
  42405. >
  42406.      opakovanΘ pro ka╛dou <TT
  42407. CLASS="parameter"
  42408. ><I
  42409. >var</I
  42410. ></TT
  42411. >.
  42412.     </P
  42413. ><P
  42414. >      Vracφ nov² poΦet prvk∙ v poli.
  42415.     </P
  42416. ><P
  42417. >      <TABLE
  42418. WIDTH="100%"
  42419. BORDER="0"
  42420. CELLPADDING="0"
  42421. CELLSPACING="0"
  42422. CLASS="EXAMPLE"
  42423. ><TR
  42424. ><TD
  42425. ><DIV
  42426. CLASS="example"
  42427. ><A
  42428. NAME="AEN7815"
  42429. ></A
  42430. ><P
  42431. ><B
  42432. >P°φklad 1. Ukßzka <B
  42433. CLASS="function"
  42434. >array_push()</B
  42435. ></B
  42436. ></P
  42437. ><TABLE
  42438. BORDER="0"
  42439. BGCOLOR="#E0E0E0"
  42440. CELLPADDING="5"
  42441. ><TR
  42442. ><TD
  42443. ><PRE
  42444. CLASS="php"
  42445. >$stack = array (1, 2);
  42446. array_push ($stack, "+", 3);</PRE
  42447. ></TD
  42448. ></TR
  42449. ></TABLE
  42450. ></DIV
  42451. ></TD
  42452. ></TR
  42453. ></TABLE
  42454. >
  42455.     </P
  42456. ><P
  42457. >      V²sledkem tΘto ukßzky by byl <TT
  42458. CLASS="varname"
  42459. >$stack</TT
  42460. > obsahujφcφ 4
  42461.      prvky: 1, 2, "+" a 3.
  42462.     </P
  42463. ><P
  42464. >      Viz takΘ: <A
  42465. HREF="#function.array-pop"
  42466. ><B
  42467. CLASS="function"
  42468. >array_pop()</B
  42469. ></A
  42470. >,
  42471.      <A
  42472. HREF="#function.array-shift"
  42473. ><B
  42474. CLASS="function"
  42475. >array_shift()</B
  42476. ></A
  42477. > a
  42478.      <A
  42479. HREF="#function.array-unshift"
  42480. ><B
  42481. CLASS="function"
  42482. >array_unshift()</B
  42483. ></A
  42484. >.
  42485.     </P
  42486. ></DIV
  42487. ><H1
  42488. ><A
  42489. NAME="function.array-rand"
  42490. ></A
  42491. >array_rand</H1
  42492. ><DIV
  42493. CLASS="refnamediv"
  42494. ><A
  42495. NAME="AEN7826"
  42496. ></A
  42497. ><P
  42498. >    (PHP 4 )</P
  42499. >array_rand -- Vybrat nßhodn∞ jeden nebo vφce prvk∙ pole</DIV
  42500. ><DIV
  42501. CLASS="refsect1"
  42502. ><A
  42503. NAME="AEN7829"
  42504. ></A
  42505. ><H2
  42506. >Popis</H2
  42507. >mixed <B
  42508. CLASS="methodname"
  42509. >array_rand</B
  42510. > ( array input [, int num_req])<BR
  42511. ></BR
  42512. ><P
  42513. >      <B
  42514. CLASS="function"
  42515. >array_rand()</B
  42516. > je pom∞rn∞ u╛iteΦnß, kdy╛ chcete z pole
  42517.      vybrat nßhodn∞ jednu nebo vφce hodnot. P°ijφmß pole
  42518.      <TT
  42519. CLASS="parameter"
  42520. ><I
  42521. >input</I
  42522. ></TT
  42523. > a voliteln² argument
  42524.      <TT
  42525. CLASS="parameter"
  42526. ><I
  42527. >num_req</I
  42528. ></TT
  42529. >, kter² urΦuje, kolik polo╛ek chcete. Jeho
  42530.      defaultnφ hodnota je 1.
  42531.     </P
  42532. ><P
  42533. >      Pokud vybφrßte pouze jednu polo╛ku, <B
  42534. CLASS="function"
  42535. >array_rand()</B
  42536. >
  42537.      vracφ klφΦ nßhodnΘ polo╛ky. Jinak vracφ pole klφΦ∙ nßhodn∞ vybran²ch polo╛ek.
  42538.      Takto m∙╛ete vybφrat nßhodn∞ hodnoty i klφΦe.
  42539.     </P
  42540. ><P
  42541. >      Nezapome≥te inicializovat generßtor nßhodn²ch Φφsel pomocφ
  42542.      <A
  42543. HREF="#function.srand"
  42544. ><B
  42545. CLASS="function"
  42546. >srand()</B
  42547. ></A
  42548. >.
  42549.     </P
  42550. ><P
  42551. >      <TABLE
  42552. WIDTH="100%"
  42553. BORDER="0"
  42554. CELLPADDING="0"
  42555. CELLSPACING="0"
  42556. CLASS="EXAMPLE"
  42557. ><TR
  42558. ><TD
  42559. ><DIV
  42560. CLASS="example"
  42561. ><A
  42562. NAME="AEN7849"
  42563. ></A
  42564. ><P
  42565. ><B
  42566. >P°φklad 1. Ukßzka <B
  42567. CLASS="function"
  42568. >array_rand()</B
  42569. ></B
  42570. ></P
  42571. ><TABLE
  42572. BORDER="0"
  42573. BGCOLOR="#E0E0E0"
  42574. CELLPADDING="5"
  42575. ><TR
  42576. ><TD
  42577. ><PRE
  42578. CLASS="php"
  42579. >srand ((double) microtime() * 10000000);
  42580. $input = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
  42581. $rand_keys = array_rand ($input, 2);
  42582. print $input[$rand_keys[0]]."\n";
  42583. print $input[$rand_keys[1]]."\n";</PRE
  42584. ></TD
  42585. ></TR
  42586. ></TABLE
  42587. ></DIV
  42588. ></TD
  42589. ></TR
  42590. ></TABLE
  42591. >
  42592.     </P
  42593. ></DIV
  42594. ><H1
  42595. ><A
  42596. NAME="function.array-reduce"
  42597. ></A
  42598. >array_reduce</H1
  42599. ><DIV
  42600. CLASS="refnamediv"
  42601. ><A
  42602. NAME="AEN7854"
  42603. ></A
  42604. ><P
  42605. >    (PHP 4 >= 4.0.5)</P
  42606. >array_reduce -- 
  42607.      Iteratively reduce the array to a single value using a callback
  42608.      function
  42609.     </DIV
  42610. ><DIV
  42611. CLASS="refsect1"
  42612. ><A
  42613. NAME="AEN7857"
  42614. ></A
  42615. ><H2
  42616. >Description</H2
  42617. >mixed <B
  42618. CLASS="methodname"
  42619. >array_reduce</B
  42620. > ( array input, callback function [, int initial])<BR
  42621. ></BR
  42622. ><P
  42623. >      <B
  42624. CLASS="function"
  42625. >array_reduce()</B
  42626. > applies iteratively the
  42627.      <TT
  42628. CLASS="parameter"
  42629. ><I
  42630. >function</I
  42631. ></TT
  42632. > function to the elements of the
  42633.      array <TT
  42634. CLASS="parameter"
  42635. ><I
  42636. >input</I
  42637. ></TT
  42638. >, so as to reduce the array to
  42639.      a single value. If the optional <TT
  42640. CLASS="parameter"
  42641. ><I
  42642. >initial</I
  42643. ></TT
  42644. > is
  42645.      available, it will be used at the beginning of the process, or as
  42646.      a final result in case the array is empty.
  42647.     </P
  42648. ><P
  42649. >      <TABLE
  42650. WIDTH="100%"
  42651. BORDER="0"
  42652. CELLPADDING="0"
  42653. CELLSPACING="0"
  42654. CLASS="EXAMPLE"
  42655. ><TR
  42656. ><TD
  42657. ><DIV
  42658. CLASS="example"
  42659. ><A
  42660. NAME="AEN7877"
  42661. ></A
  42662. ><P
  42663. ><B
  42664. >P°φklad 1. <B
  42665. CLASS="function"
  42666. >array_reduce()</B
  42667. > example</B
  42668. ></P
  42669. ><TABLE
  42670. BORDER="0"
  42671. BGCOLOR="#E0E0E0"
  42672. CELLPADDING="5"
  42673. ><TR
  42674. ><TD
  42675. ><PRE
  42676. CLASS="php"
  42677. ><?php
  42678. function rsum($v, $w) {
  42679.     $v += $w;
  42680.     return $v;
  42681. }
  42682.  
  42683. function rmul($v, $w) {
  42684.     $v *= $w;
  42685.     return $v;
  42686. }
  42687.  
  42688. $a = array(1, 2, 3, 4, 5);
  42689. $x = array();
  42690. $b = array_reduce($a, "rsum");
  42691. $c = array_reduce($a, "rmul", 10);
  42692. $d = array_reduce($x, "rsum", 1);
  42693. ?></PRE
  42694. ></TD
  42695. ></TR
  42696. ></TABLE
  42697. ></DIV
  42698. ></TD
  42699. ></TR
  42700. ></TABLE
  42701. >
  42702.     </P
  42703. ><P
  42704. >      This will result in <TT
  42705. CLASS="varname"
  42706. >$b</TT
  42707. > containing
  42708.      <TT
  42709. CLASS="literal"
  42710. >15</TT
  42711. >, <TT
  42712. CLASS="varname"
  42713. >$c</TT
  42714. > containing
  42715.      <TT
  42716. CLASS="literal"
  42717. >1200</TT
  42718. > (= 1*2*3*4*5*10), and
  42719.      <TT
  42720. CLASS="varname"
  42721. >$d</TT
  42722. > containing <TT
  42723. CLASS="literal"
  42724. >1</TT
  42725. >.
  42726.     </P
  42727. ><P
  42728. >      See also <A
  42729. HREF="#function.array-filter"
  42730. ><B
  42731. CLASS="function"
  42732. >array_filter()</B
  42733. ></A
  42734. >,
  42735.      <A
  42736. HREF="#function.array-map"
  42737. ><B
  42738. CLASS="function"
  42739. >array_map()</B
  42740. ></A
  42741. >,
  42742.      <A
  42743. HREF="#function.array-unique"
  42744. ><B
  42745. CLASS="function"
  42746. >array_unique()</B
  42747. ></A
  42748. >, and
  42749.      <A
  42750. HREF="#function.array-count-values"
  42751. ><B
  42752. CLASS="function"
  42753. >array_count_values()</B
  42754. ></A
  42755. >.
  42756.     </P
  42757. ></DIV
  42758. ><H1
  42759. ><A
  42760. NAME="function.array-reverse"
  42761. ></A
  42762. >array_reverse</H1
  42763. ><DIV
  42764. CLASS="refnamediv"
  42765. ><A
  42766. NAME="AEN7894"
  42767. ></A
  42768. ><P
  42769. >    (PHP 4 )</P
  42770. >array_reverse -- Vrßtit pole s prvky v opaΦnΘm po°adφ</DIV
  42771. ><DIV
  42772. CLASS="refsect1"
  42773. ><A
  42774. NAME="AEN7897"
  42775. ></A
  42776. ><H2
  42777. >Popis</H2
  42778. >array <B
  42779. CLASS="methodname"
  42780. >array_reverse</B
  42781. > ( array array [, bool preserve_keys])<BR
  42782. ></BR
  42783. ><P
  42784. >      <B
  42785. CLASS="function"
  42786. >array_reverse()</B
  42787. > takes input
  42788.      <TT
  42789. CLASS="parameter"
  42790. ><I
  42791. >array</I
  42792. ></TT
  42793. > and returns a new array with the
  42794.      order of the elements reversed, preserving the keys if
  42795.      <TT
  42796. CLASS="parameter"
  42797. ><I
  42798. >preserve_keys</I
  42799. ></TT
  42800. > is <TT
  42801. CLASS="constant"
  42802. ><B
  42803. >TRUE</B
  42804. ></TT
  42805. >.
  42806.     </P
  42807. ><P
  42808. >      <TABLE
  42809. WIDTH="100%"
  42810. BORDER="0"
  42811. CELLPADDING="0"
  42812. CELLSPACING="0"
  42813. CLASS="EXAMPLE"
  42814. ><TR
  42815. ><TD
  42816. ><DIV
  42817. CLASS="example"
  42818. ><A
  42819. NAME="AEN7914"
  42820. ></A
  42821. ><P
  42822. ><B
  42823. >P°φklad 1. <B
  42824. CLASS="function"
  42825. >array_reverse()</B
  42826. > example</B
  42827. ></P
  42828. ><TABLE
  42829. BORDER="0"
  42830. BGCOLOR="#E0E0E0"
  42831. CELLPADDING="5"
  42832. ><TR
  42833. ><TD
  42834. ><PRE
  42835. CLASS="php"
  42836. >$input = array ("php", 4.0, array ("green", "red"));
  42837. $result = array_reverse ($input);
  42838. $result_keyed = array_reverse ($input, true);</PRE
  42839. ></TD
  42840. ></TR
  42841. ></TABLE
  42842. ></DIV
  42843. ></TD
  42844. ></TR
  42845. ></TABLE
  42846. >
  42847.     </P
  42848. ><P
  42849. >      <TT
  42850. CLASS="varname"
  42851. >$result</TT
  42852. > te∩ obsahuje <TT
  42853. CLASS="literal"
  42854. >array (array ("green",
  42855.      "red"), 4.0, "php")</TT
  42856. >. Ale <TT
  42857. CLASS="varname"
  42858. >$result2[0]</TT
  42859. > je stßle
  42860.      <TT
  42861. CLASS="literal"
  42862. >"php"</TT
  42863. >.
  42864.     </P
  42865. ><DIV
  42866. CLASS="note"
  42867. ><BLOCKQUOTE
  42868. CLASS="note"
  42869. ><P
  42870. ><B
  42871. >Poznßmka: </B
  42872. >
  42873.       Druh² argument byl p°idßn v PHP 4.0.3.
  42874.      </P
  42875. ></BLOCKQUOTE
  42876. ></DIV
  42877. ></DIV
  42878. ><H1
  42879. ><A
  42880. NAME="function.array-search"
  42881. ></A
  42882. >array_search</H1
  42883. ><DIV
  42884. CLASS="refnamediv"
  42885. ><A
  42886. NAME="AEN7926"
  42887. ></A
  42888. ><P
  42889. >    (PHP 4 >= 4.0.5)</P
  42890. >array_search -- 
  42891.      Searches the array for a given value and returns the
  42892.      corresponding key if successful
  42893.     </DIV
  42894. ><DIV
  42895. CLASS="refsect1"
  42896. ><A
  42897. NAME="AEN7929"
  42898. ></A
  42899. ><H2
  42900. >Description</H2
  42901. >mixed <B
  42902. CLASS="methodname"
  42903. >array_search</B
  42904. > ( mixed needle, array haystack [, bool strict])<BR
  42905. ></BR
  42906. ><P
  42907. >      Searches <TT
  42908. CLASS="parameter"
  42909. ><I
  42910. >haystack</I
  42911. ></TT
  42912. > for
  42913.      <TT
  42914. CLASS="parameter"
  42915. ><I
  42916. >needle</I
  42917. ></TT
  42918. > and returns the key if it is found in
  42919.      the array, <TT
  42920. CLASS="constant"
  42921. ><B
  42922. >FALSE</B
  42923. ></TT
  42924. > otherwise.
  42925.     </P
  42926. ><DIV
  42927. CLASS="note"
  42928. ><BLOCKQUOTE
  42929. CLASS="note"
  42930. ><P
  42931. ><B
  42932. >Poznßmka: </B
  42933. >
  42934.       If <TT
  42935. CLASS="parameter"
  42936. ><I
  42937. >needle</I
  42938. ></TT
  42939. > is a string, the comparison is done
  42940.       in a case-sensitive manner.
  42941.      </P
  42942. ></BLOCKQUOTE
  42943. ></DIV
  42944. ><DIV
  42945. CLASS="note"
  42946. ><BLOCKQUOTE
  42947. CLASS="note"
  42948. ><P
  42949. ><B
  42950. >Poznßmka: </B
  42951. >
  42952.       Prior to PHP 4.2.0, <B
  42953. CLASS="function"
  42954. >array_search()</B
  42955. > returns
  42956.       <TT
  42957. CLASS="constant"
  42958. ><B
  42959. >NULL</B
  42960. ></TT
  42961. > on failure instead of <TT
  42962. CLASS="constant"
  42963. ><B
  42964. >FALSE</B
  42965. ></TT
  42966. >.
  42967.      </P
  42968. ></BLOCKQUOTE
  42969. ></DIV
  42970. ><P
  42971. >      If the optional third parameter <TT
  42972. CLASS="parameter"
  42973. ><I
  42974. >strict</I
  42975. ></TT
  42976. > is set to
  42977.      <TT
  42978. CLASS="constant"
  42979. ><B
  42980. >TRUE</B
  42981. ></TT
  42982. > then the <B
  42983. CLASS="function"
  42984. >array_search()</B
  42985. >
  42986.      will also check the types of the <TT
  42987. CLASS="parameter"
  42988. ><I
  42989. >needle</I
  42990. ></TT
  42991. >
  42992.      in the <TT
  42993. CLASS="parameter"
  42994. ><I
  42995. >haystack</I
  42996. ></TT
  42997. >.
  42998.     </P
  42999. ><P
  43000. >      If <TT
  43001. CLASS="parameter"
  43002. ><I
  43003. >needle</I
  43004. ></TT
  43005. > is found in
  43006.      <TT
  43007. CLASS="parameter"
  43008. ><I
  43009. >haystack</I
  43010. ></TT
  43011. > more than once, the first matching key
  43012.      is returned. To return the keys for all matching values, use
  43013.      <A
  43014. HREF="#function.array-keys"
  43015. ><B
  43016. CLASS="function"
  43017. >array_keys()</B
  43018. ></A
  43019. > with the optional
  43020.      <TT
  43021. CLASS="parameter"
  43022. ><I
  43023. >search_value</I
  43024. ></TT
  43025. > parameter instead.
  43026.     </P
  43027. ><P
  43028. >      <TABLE
  43029. WIDTH="100%"
  43030. BORDER="0"
  43031. CELLPADDING="0"
  43032. CELLSPACING="0"
  43033. CLASS="EXAMPLE"
  43034. ><TR
  43035. ><TD
  43036. ><DIV
  43037. CLASS="example"
  43038. ><A
  43039. NAME="AEN7967"
  43040. ></A
  43041. ><P
  43042. ><B
  43043. >P°φklad 1. <B
  43044. CLASS="function"
  43045. >array_search()</B
  43046. > example</B
  43047. ></P
  43048. ><TABLE
  43049. BORDER="0"
  43050. BGCOLOR="#E0E0E0"
  43051. CELLPADDING="5"
  43052. ><TR
  43053. ><TD
  43054. ><PRE
  43055. CLASS="php"
  43056. ><?php
  43057. $array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
  43058.  
  43059. $key = array_search('green', $array); // $key = 2;
  43060. $key = array_search('red', $array);   // $key = 1;
  43061. ?></PRE
  43062. ></TD
  43063. ></TR
  43064. ></TABLE
  43065. ></DIV
  43066. ></TD
  43067. ></TR
  43068. ></TABLE
  43069. >
  43070.     </P
  43071. ><DIV
  43072. CLASS="warning"
  43073. ><P
  43074. ></P
  43075. ><TABLE
  43076. CLASS="warning"
  43077. BORDER="1"
  43078. WIDTH="100%"
  43079. ><TR
  43080. ><TD
  43081. ALIGN="CENTER"
  43082. ><B
  43083. >Varovßnφ</B
  43084. ></TD
  43085. ></TR
  43086. ><TR
  43087. ><TD
  43088. ALIGN="LEFT"
  43089. ><P
  43090. >Tato funkce m∙╛e vracet
  43091. booleovskou hodnotu <TT
  43092. CLASS="constant"
  43093. ><B
  43094. >FALSE</B
  43095. ></TT
  43096. >, ale takΘ nebooleovskou hodnotu odpovφdajφcφ
  43097. ohodnocenφ <TT
  43098. CLASS="constant"
  43099. ><B
  43100. >FALSE</B
  43101. ></TT
  43102. >, nap°φklad <TT
  43103. CLASS="literal"
  43104. >0</TT
  43105. > nebo "". ╚t∞te
  43106. prosφm sekci o typu <A
  43107. HREF="#language.types.boolean"
  43108. >Boolean</A
  43109. >, kde
  43110. najdete vφce informacφ. Pro testovßnφ nßvratovΘ hodnoty tΘto funkce pou╛ijte
  43111. <A
  43112. HREF="#language.operators.comparison"
  43113. >operßtor
  43114. ===</A
  43115. >.</P
  43116. ></TD
  43117. ></TR
  43118. ></TABLE
  43119. ></DIV
  43120. ><P
  43121. >      See also <A
  43122. HREF="#function.array-keys"
  43123. ><B
  43124. CLASS="function"
  43125. >array_keys()</B
  43126. ></A
  43127. >,
  43128.      <A
  43129. HREF="#function.array-values"
  43130. ><B
  43131. CLASS="function"
  43132. >array_values()</B
  43133. ></A
  43134. >,
  43135.      <A
  43136. HREF="#function.array-key-exists"
  43137. ><B
  43138. CLASS="function"
  43139. >array_key_exists()</B
  43140. ></A
  43141. >, and
  43142.      <A
  43143. HREF="#function.in-array"
  43144. ><B
  43145. CLASS="function"
  43146. >in_array()</B
  43147. ></A
  43148. >.
  43149.     </P
  43150. ></DIV
  43151. ><H1
  43152. ><A
  43153. NAME="function.array-shift"
  43154. ></A
  43155. >array_shift</H1
  43156. ><DIV
  43157. CLASS="refnamediv"
  43158. ><A
  43159. NAME="AEN7984"
  43160. ></A
  43161. ><P
  43162. >    (PHP 4 )</P
  43163. >array_shift -- Odstranit prvek ze zaΦßtku pole</DIV
  43164. ><DIV
  43165. CLASS="refsect1"
  43166. ><A
  43167. NAME="AEN7987"
  43168. ></A
  43169. ><H2
  43170. >Popis</H2
  43171. >mixed <B
  43172. CLASS="methodname"
  43173. >array_shift</B
  43174. > ( array array)<BR
  43175. ></BR
  43176. ><P
  43177. >      <B
  43178. CLASS="function"
  43179. >array_shift()</B
  43180. > vracφ prvnφ polo╛ku
  43181.      <TT
  43182. CLASS="parameter"
  43183. ><I
  43184. >array</I
  43185. ></TT
  43186. > a odstranφ ji, Φφm╛ zkrßtφ
  43187.      <TT
  43188. CLASS="parameter"
  43189. ><I
  43190. >array</I
  43191. ></TT
  43192. > o jeden prvek a ostatnφ posune dol∙.
  43193.     </P
  43194. ><P
  43195. >      <TABLE
  43196. WIDTH="100%"
  43197. BORDER="0"
  43198. CELLPADDING="0"
  43199. CELLSPACING="0"
  43200. CLASS="EXAMPLE"
  43201. ><TR
  43202. ><TD
  43203. ><DIV
  43204. CLASS="example"
  43205. ><A
  43206. NAME="AEN8000"
  43207. ></A
  43208. ><P
  43209. ><B
  43210. >P°φklad 1. Ukßzka <B
  43211. CLASS="function"
  43212. >array_shift()</B
  43213. ></B
  43214. ></P
  43215. ><TABLE
  43216. BORDER="0"
  43217. BGCOLOR="#E0E0E0"
  43218. CELLPADDING="5"
  43219. ><TR
  43220. ><TD
  43221. ><PRE
  43222. CLASS="php"
  43223. >$args = array ("-v", "-f");
  43224. $opt = array_shift ($args);</PRE
  43225. ></TD
  43226. ></TR
  43227. ></TABLE
  43228. ></DIV
  43229. ></TD
  43230. ></TR
  43231. ></TABLE
  43232. >
  43233.     </P
  43234. ><P
  43235. >      <TT
  43236. CLASS="varname"
  43237. >$args</TT
  43238. > te∩ mß jeden prvek: "-f" a <TT
  43239. CLASS="varname"
  43240. >$opt</TT
  43241. >
  43242.      je "-v".
  43243.     </P
  43244. ><P
  43245. >      Viz takΘ: <A
  43246. HREF="#function.array-unshift"
  43247. ><B
  43248. CLASS="function"
  43249. >array_unshift()</B
  43250. ></A
  43251. >,
  43252.      <A
  43253. HREF="#function.array-push"
  43254. ><B
  43255. CLASS="function"
  43256. >array_push()</B
  43257. ></A
  43258. > a
  43259.      <A
  43260. HREF="#function.array-pop"
  43261. ><B
  43262. CLASS="function"
  43263. >array_pop()</B
  43264. ></A
  43265. >.
  43266.     </P
  43267. ></DIV
  43268. ><H1
  43269. ><A
  43270. NAME="function.array-slice"
  43271. ></A
  43272. >array_slice</H1
  43273. ><DIV
  43274. CLASS="refnamediv"
  43275. ><A
  43276. NAME="AEN8012"
  43277. ></A
  43278. ><P
  43279. >    (PHP 4 )</P
  43280. >array_slice -- Vytßhnout Φßst pole</DIV
  43281. ><DIV
  43282. CLASS="refsect1"
  43283. ><A
  43284. NAME="AEN8015"
  43285. ></A
  43286. ><H2
  43287. >Popis</H2
  43288. >array <B
  43289. CLASS="methodname"
  43290. >array_slice</B
  43291. > ( array array, int offset [, int length])<BR
  43292. ></BR
  43293. ><P
  43294. >      <B
  43295. CLASS="function"
  43296. >array_slice()</B
  43297. > vracφ sekvenci prvk∙
  43298.      <TT
  43299. CLASS="parameter"
  43300. ><I
  43301. >array</I
  43302. ></TT
  43303. > urΦen²ch argumenty
  43304.      <TT
  43305. CLASS="parameter"
  43306. ><I
  43307. >offset</I
  43308. ></TT
  43309. > a <TT
  43310. CLASS="parameter"
  43311. ><I
  43312. >length</I
  43313. ></TT
  43314. >.
  43315.     </P
  43316. ><P
  43317. >      Pokud je <TT
  43318. CLASS="parameter"
  43319. ><I
  43320. >offset</I
  43321. ></TT
  43322. > kladn², tato sekvence zaΦne
  43323.      <TT
  43324. CLASS="parameter"
  43325. ><I
  43326. >offset</I
  43327. ></TT
  43328. > polo╛ek od zaΦßtku
  43329.      <TT
  43330. CLASS="parameter"
  43331. ><I
  43332. >array</I
  43333. ></TT
  43334. >.  Pokud je <TT
  43335. CLASS="parameter"
  43336. ><I
  43337. >offset</I
  43338. ></TT
  43339. >
  43340.      zßporn², tato sekvence zaΦne tolik polo╛ek od konce
  43341.      <TT
  43342. CLASS="parameter"
  43343. ><I
  43344. >array</I
  43345. ></TT
  43346. >.
  43347.     </P
  43348. ><P
  43349. >      Pokud je <TT
  43350. CLASS="parameter"
  43351. ><I
  43352. >length</I
  43353. ></TT
  43354. > kladnß, tato sekvence bude obsahovat
  43355.      tolik prvk∙. Pokud je <TT
  43356. CLASS="parameter"
  43357. ><I
  43358. >length</I
  43359. ></TT
  43360. > zßpornß, tato sekvence
  43361.      skonΦφ tolik prvk∙ od konce <TT
  43362. CLASS="parameter"
  43363. ><I
  43364. >array</I
  43365. ></TT
  43366. >. Pokud
  43367.      <TT
  43368. CLASS="parameter"
  43369. ><I
  43370. >length</I
  43371. ></TT
  43372. > vynechßte, tato sekvence bude obsahovat
  43373.      v╣echny prvky <TT
  43374. CLASS="parameter"
  43375. ><I
  43376. >array</I
  43377. ></TT
  43378. > od <TT
  43379. CLASS="parameter"
  43380. ><I
  43381. >offset</I
  43382. ></TT
  43383. >
  43384.      do konce.
  43385.     </P
  43386. ><P
  43387. >      <TABLE
  43388. WIDTH="100%"
  43389. BORDER="0"
  43390. CELLPADDING="0"
  43391. CELLSPACING="0"
  43392. CLASS="EXAMPLE"
  43393. ><TR
  43394. ><TD
  43395. ><DIV
  43396. CLASS="example"
  43397. ><A
  43398. NAME="AEN8048"
  43399. ></A
  43400. ><P
  43401. ><B
  43402. >P°φklad 1. Ukßzka <B
  43403. CLASS="function"
  43404. >array_slice()</B
  43405. ></B
  43406. ></P
  43407. ><TABLE
  43408. BORDER="0"
  43409. BGCOLOR="#E0E0E0"
  43410. CELLPADDING="5"
  43411. ><TR
  43412. ><TD
  43413. ><PRE
  43414. CLASS="php"
  43415. >$input = array ("a", "b", "c", "d", "e");
  43416.  
  43417. $output = array_slice ($input, 2);      // returns "c", "d", and "e"
  43418. $output = array_slice ($input, 2, -1);  // returns "c", "d"
  43419. $output = array_slice ($input, -2, 1);  // returns "d"
  43420. $output = array_slice ($input, 0, 3);   // returns "a", "b", and "c"</PRE
  43421. ></TD
  43422. ></TR
  43423. ></TABLE
  43424. ></DIV
  43425. ></TD
  43426. ></TR
  43427. ></TABLE
  43428. >
  43429.     </P
  43430. ><P
  43431. >      Viz takΘ: <A
  43432. HREF="#function.array-splice"
  43433. ><B
  43434. CLASS="function"
  43435. >array_splice()</B
  43436. ></A
  43437. >.
  43438.     </P
  43439. ></DIV
  43440. ><H1
  43441. ><A
  43442. NAME="function.array-splice"
  43443. ></A
  43444. >array_splice</H1
  43445. ><DIV
  43446. CLASS="refnamediv"
  43447. ><A
  43448. NAME="AEN8055"
  43449. ></A
  43450. ><P
  43451. >    (PHP 4 )</P
  43452. >array_splice -- Odstranit Φßst pole a nahradit ji n∞Φφm jin²m</DIV
  43453. ><DIV
  43454. CLASS="refsect1"
  43455. ><A
  43456. NAME="AEN8058"
  43457. ></A
  43458. ><H2
  43459. >Popis</H2
  43460. >array <B
  43461. CLASS="methodname"
  43462. >array_splice</B
  43463. > ( array input, int offset [, int length [, array replacement]])<BR
  43464. ></BR
  43465. ><P
  43466. >      <B
  43467. CLASS="function"
  43468. >array_splice()</B
  43469. > odstra≥uje prvky pole
  43470.      <TT
  43471. CLASS="parameter"
  43472. ><I
  43473. >input</I
  43474. ></TT
  43475. > urΦenΘ argumenty <TT
  43476. CLASS="parameter"
  43477. ><I
  43478. >offset</I
  43479. ></TT
  43480. >
  43481.      a <TT
  43482. CLASS="parameter"
  43483. ><I
  43484. >length</I
  43485. ></TT
  43486. >, a p°φpadn∞ je nahrazuje prvky volitelnΘho
  43487.      argumentu (pole) <TT
  43488. CLASS="parameter"
  43489. ><I
  43490. >replacement</I
  43491. ></TT
  43492. >.
  43493.     </P
  43494. ><P
  43495. >      Pokud je <TT
  43496. CLASS="parameter"
  43497. ><I
  43498. >offset</I
  43499. ></TT
  43500. > kladn², tato odstran∞nß Φßst zaΦne
  43501.      <TT
  43502. CLASS="parameter"
  43503. ><I
  43504. >offset</I
  43505. ></TT
  43506. > polo╛ek od zaΦßtku
  43507.      <TT
  43508. CLASS="parameter"
  43509. ><I
  43510. >array</I
  43511. ></TT
  43512. >.  Pokud je <TT
  43513. CLASS="parameter"
  43514. ><I
  43515. >offset</I
  43516. ></TT
  43517. >
  43518.      zßporn², zaΦne tolik polo╛ek od konce <TT
  43519. CLASS="parameter"
  43520. ><I
  43521. >array</I
  43522. ></TT
  43523. >.
  43524.     </P
  43525. ><P
  43526. >      Pokud vynechßte <TT
  43527. CLASS="parameter"
  43528. ><I
  43529. >length</I
  43530. ></TT
  43531. >,
  43532.      <B
  43533. CLASS="function"
  43534. >array_splice()</B
  43535. > odstranφ v╣echno od
  43536.      <TT
  43537. CLASS="parameter"
  43538. ><I
  43539. >offset</I
  43540. ></TT
  43541. > do konce pole. Pokud je
  43542.      <TT
  43543. CLASS="parameter"
  43544. ><I
  43545. >length</I
  43546. ></TT
  43547. > kladnß, odstranφ se prßv∞ tolik prvk∙. Pokud
  43548.      je <TT
  43549. CLASS="parameter"
  43550. ><I
  43551. >length</I
  43552. ></TT
  43553. > zßpornß, konec odstran∞nΘ Φßsti bude
  43554.      prßv∞ tolik prvk∙ od konce pole. Tip: k odstran∞nφ v╣ech prvk∙ od
  43555.      <TT
  43556. CLASS="parameter"
  43557. ><I
  43558. >offset</I
  43559. ></TT
  43560. > do konce pole p°i souΦasn∞ urΦenΘm argumentu
  43561.      <TT
  43562. CLASS="parameter"
  43563. ><I
  43564. >replacement</I
  43565. ></TT
  43566. > pou╛ijte jako
  43567.      <TT
  43568. CLASS="parameter"
  43569. ><I
  43570. >length</I
  43571. ></TT
  43572. > <TT
  43573. CLASS="literal"
  43574. >count($input)</TT
  43575. >.
  43576.     </P
  43577. ><P
  43578. >      Pokud zadßte <TT
  43579. CLASS="parameter"
  43580. ><I
  43581. >replacement</I
  43582. ></TT
  43583. > pole, odstran∞nΘ prvky se
  43584.      nahradφ prvky tohoto pole. Pokud argumenty <TT
  43585. CLASS="parameter"
  43586. ><I
  43587. >offset</I
  43588. ></TT
  43589. > a
  43590.      <TT
  43591. CLASS="parameter"
  43592. ><I
  43593. >length</I
  43594. ></TT
  43595. > definovßny tak, ╛e se nic neodstranφ, prvky
  43596.      pole <TT
  43597. CLASS="parameter"
  43598. ><I
  43599. >replacement</I
  43600. ></TT
  43601. > se vlo╛φ na mφsto urΦenΘ argumentem
  43602.      <TT
  43603. CLASS="parameter"
  43604. ><I
  43605. >offset</I
  43606. ></TT
  43607. >. Tip: pokud je <TT
  43608. CLASS="parameter"
  43609. ><I
  43610. >replacement</I
  43611. ></TT
  43612. >
  43613.      jen jedna hodnota, nenφ nutno ji umis╗ovat do <TT
  43614. CLASS="literal"
  43615. >array()</TT
  43616. >,
  43617.      leda╛e chcete, aby tato polo╛ka byla opravdu pole.
  43618.     </P
  43619. ><P
  43620. >      Nßsledujφcφ volßnφ jsou ekvivalentnφ:
  43621.      <TABLE
  43622. BORDER="0"
  43623. BGCOLOR="#E0E0E0"
  43624. CELLPADDING="5"
  43625. ><TR
  43626. ><TD
  43627. ><PRE
  43628. CLASS="programlisting"
  43629. >array_push ($input, $x, $y)     array_splice ($input, count ($input), 0,
  43630.                                              array ($x, $y))
  43631. array_pop ($input)              array_splice ($input, -1)
  43632. array_shift ($input)            array_splice ($input, 0, 1)
  43633. array_unshift ($input, $x, $y)  array_splice ($input, 0, 0, array ($x, $y))
  43634. $a[$x] = $y                     array_splice ($input, $x, 1, $y)</PRE
  43635. ></TD
  43636. ></TR
  43637. ></TABLE
  43638. >
  43639.     </P
  43640. ><P
  43641. >      Vracφ pole odstran∞n²ch prvk∙.
  43642.     </P
  43643. ><P
  43644. >      <TABLE
  43645. WIDTH="100%"
  43646. BORDER="0"
  43647. CELLPADDING="0"
  43648. CELLSPACING="0"
  43649. CLASS="EXAMPLE"
  43650. ><TR
  43651. ><TD
  43652. ><DIV
  43653. CLASS="example"
  43654. ><A
  43655. NAME="AEN8109"
  43656. ></A
  43657. ><P
  43658. ><B
  43659. >P°φklad 1. Ukßzky <B
  43660. CLASS="function"
  43661. >array_splice()</B
  43662. ></B
  43663. ></P
  43664. ><TABLE
  43665. BORDER="0"
  43666. BGCOLOR="#E0E0E0"
  43667. CELLPADDING="5"
  43668. ><TR
  43669. ><TD
  43670. ><PRE
  43671. CLASS="php"
  43672. >$input = array ("red", "green", "blue", "yellow");
  43673.  
  43674. array_splice ($input, 2);      // $input is now array ("red", "green")
  43675. array_splice ($input, 1, -1);  // $input is now array ("red", "yellow")
  43676. array_splice ($input, 1, count($input), "orange");
  43677.                                // $input is now array ("red", "orange")
  43678. array_splice ($input, -1, 1, array("black", "maroon"));
  43679.                                // $input is now array ("red", "green",
  43680.                                //          "blue", "black", "maroon")</PRE
  43681. ></TD
  43682. ></TR
  43683. ></TABLE
  43684. ></DIV
  43685. ></TD
  43686. ></TR
  43687. ></TABLE
  43688. >
  43689.     </P
  43690. ><P
  43691. >      Viz takΘ: <A
  43692. HREF="#function.array-slice"
  43693. ><B
  43694. CLASS="function"
  43695. >array_slice()</B
  43696. ></A
  43697. >.
  43698.     </P
  43699. ></DIV
  43700. ><H1
  43701. ><A
  43702. NAME="function.array-sum"
  43703. ></A
  43704. >array_sum</H1
  43705. ><DIV
  43706. CLASS="refnamediv"
  43707. ><A
  43708. NAME="AEN8116"
  43709. ></A
  43710. ><P
  43711. >    (PHP 4 >= 4.0.4)</P
  43712. >array_sum -- 
  43713.      Calculate the sum of values in an array.
  43714.     </DIV
  43715. ><DIV
  43716. CLASS="refsect1"
  43717. ><A
  43718. NAME="AEN8119"
  43719. ></A
  43720. ><H2
  43721. >Description</H2
  43722. >mixed <B
  43723. CLASS="methodname"
  43724. >array_sum</B
  43725. > ( array array)<BR
  43726. ></BR
  43727. ><P
  43728. >      <B
  43729. CLASS="function"
  43730. >array_sum()</B
  43731. > returns the sum of values
  43732.      in an array as an integer or float.
  43733.     </P
  43734. ><P
  43735. >      <TABLE
  43736. WIDTH="100%"
  43737. BORDER="0"
  43738. CELLPADDING="0"
  43739. CELLSPACING="0"
  43740. CLASS="EXAMPLE"
  43741. ><TR
  43742. ><TD
  43743. ><DIV
  43744. CLASS="example"
  43745. ><A
  43746. NAME="AEN8130"
  43747. ></A
  43748. ><P
  43749. ><B
  43750. >P°φklad 1. <B
  43751. CLASS="function"
  43752. >array_sum()</B
  43753. > examples</B
  43754. ></P
  43755. ><TABLE
  43756. BORDER="0"
  43757. BGCOLOR="#E0E0E0"
  43758. CELLPADDING="5"
  43759. ><TR
  43760. ><TD
  43761. ><PRE
  43762. CLASS="php"
  43763. ><?php
  43764. $a = array(2, 4, 6, 8);
  43765. echo "sum(a) = " . array_sum($a) . "\n";
  43766.  
  43767. $b = array("a" => 1.2, "b" => 2.3, "c" => 3.4);
  43768. echo "sum(b) = " . array_sum($b) . "\n";
  43769. ?></PRE
  43770. ></TD
  43771. ></TR
  43772. ></TABLE
  43773. ><P
  43774. >        The printout of the program above will be:
  43775.       </P
  43776. ><TABLE
  43777. BORDER="0"
  43778. BGCOLOR="#E0E0E0"
  43779. CELLPADDING="5"
  43780. ><TR
  43781. ><TD
  43782. ><PRE
  43783. CLASS="screen"
  43784. >sum(a) = 20
  43785. sum(b) = 6.9</PRE
  43786. ></TD
  43787. ></TR
  43788. ></TABLE
  43789. ></DIV
  43790. ></TD
  43791. ></TR
  43792. ></TABLE
  43793. >
  43794.     </P
  43795. ><DIV
  43796. CLASS="note"
  43797. ><BLOCKQUOTE
  43798. CLASS="note"
  43799. ><P
  43800. ><B
  43801. >Poznßmka: </B
  43802. >
  43803.       PHP versions prior to 4.2.1 modified the passed array
  43804.       itself and converted strings to numbers (which most
  43805.       of the time converted them to zero, depending on
  43806.       their value).
  43807.      </P
  43808. ></BLOCKQUOTE
  43809. ></DIV
  43810. ></DIV
  43811. ><H1
  43812. ><A
  43813. NAME="function.array-udiff-assoc"
  43814. ></A
  43815. >array_udiff_assoc</H1
  43816. ><DIV
  43817. CLASS="refnamediv"
  43818. ><A
  43819. NAME="AEN8139"
  43820. ></A
  43821. ><P
  43822. >    (no version information, might be only in CVS)</P
  43823. >array_udiff_assoc -- Computes the difference of arrays with additional index check. The data is compared by using a callback function.</DIV
  43824. ><DIV
  43825. CLASS="refsect1"
  43826. ><A
  43827. NAME="AEN8142"
  43828. ></A
  43829. ><H2
  43830. >Description</H2
  43831. >array <B
  43832. CLASS="methodname"
  43833. >array_udiff_assoc</B
  43834. > ( array array1, array array2 [, array ..., callback data_compare_func])<BR
  43835. ></BR
  43836. ><P
  43837. >      <B
  43838. CLASS="function"
  43839. >array_udiff_assoc()</B
  43840. > returns an <A
  43841. HREF="#language.types.array"
  43842. ><B
  43843. CLASS="type"
  43844. >array</B
  43845. ></A
  43846. >
  43847.      containing all the values from <TT
  43848. CLASS="parameter"
  43849. ><I
  43850. >array1</I
  43851. ></TT
  43852. >
  43853.      that are not present in any of the other arguments.
  43854.      Note that the keys are used in the comparison unlike 
  43855.      <A
  43856. HREF="#function.array-diff"
  43857. ><B
  43858. CLASS="function"
  43859. >array_diff()</B
  43860. ></A
  43861. > and <A
  43862. HREF="#function.array-udiff"
  43863. ><B
  43864. CLASS="function"
  43865. >array_udiff()</B
  43866. ></A
  43867. >.
  43868.      The comparison of arrays' data is performed by using an user-supplied
  43869.      callback. In this aspect the behaviour is opposite to the behaviour of
  43870.      <A
  43871. HREF="#function.array-diff-assoc"
  43872. ><B
  43873. CLASS="function"
  43874. >array_diff_assoc()</B
  43875. ></A
  43876. > which uses internal function for
  43877.      comparison.
  43878.     </P
  43879. ><P
  43880. >      <TABLE
  43881. WIDTH="100%"
  43882. BORDER="0"
  43883. CELLPADDING="0"
  43884. CELLSPACING="0"
  43885. CLASS="EXAMPLE"
  43886. ><TR
  43887. ><TD
  43888. ><DIV
  43889. CLASS="example"
  43890. ><A
  43891. NAME="AEN8167"
  43892. ></A
  43893. ><P
  43894. ><B
  43895. >P°φklad 1. <B
  43896. CLASS="function"
  43897. >array_udiff_assoc()</B
  43898. > example</B
  43899. ></P
  43900. ><TABLE
  43901. BORDER="0"
  43902. BGCOLOR="#E0E0E0"
  43903. CELLPADDING="5"
  43904. ><TR
  43905. ><TD
  43906. ><PRE
  43907. CLASS="php"
  43908. ><?php
  43909. class cr {
  43910.     var $priv_member;
  43911.     function cr($val) {
  43912.         $this->priv_member = $val;
  43913.     }
  43914.     function comp_func_cr($a, $b) {
  43915.         if ($a->priv_member === $b->priv_member) return 0;
  43916.         return ($a->priv_member > $b->priv_member)? 1:-1;
  43917.     }
  43918. }
  43919. $a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
  43920. $b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
  43921.  
  43922. $result = array_udiff_assoc($a, $b, array("cr", "comp_func_cr"));
  43923. print_r($result);
  43924. ?></PRE
  43925. ></TD
  43926. ></TR
  43927. ></TABLE
  43928. ><P
  43929. >        The result is:
  43930.       </P
  43931. ><TABLE
  43932. BORDER="0"
  43933. BGCOLOR="#E0E0E0"
  43934. CELLPADDING="5"
  43935. ><TR
  43936. ><TD
  43937. ><PRE
  43938. CLASS="screen"
  43939. >Array
  43940. (
  43941.     [0.1] => cr Object
  43942.         (
  43943.             [priv_member:private] => 9
  43944.         )
  43945.  
  43946.     [0.5] => cr Object
  43947.         (
  43948.             [priv_member:private] => 12
  43949.         )
  43950.  
  43951.     [0] => cr Object
  43952.         (
  43953.             [priv_member:private] => 23
  43954.         )
  43955. )</PRE
  43956. ></TD
  43957. ></TR
  43958. ></TABLE
  43959. ></DIV
  43960. ></TD
  43961. ></TR
  43962. ></TABLE
  43963. >
  43964.     </P
  43965. ><P
  43966. >      In our example above you see the <TT
  43967. CLASS="literal"
  43968. >"1" => new cr(4)</TT
  43969. >
  43970.      pair is present in both arrays and thus it is not in the ouput from the
  43971.      function.
  43972.     </P
  43973. ><P
  43974. >      For comparison is used the user supplied callback function.
  43975.      It must return an integer less than, equal
  43976.      to, or greater than zero if the first argument is considered to
  43977.      be respectively less than, equal to, or greater than the
  43978.      second.
  43979.     </P
  43980. ><DIV
  43981. CLASS="note"
  43982. ><BLOCKQUOTE
  43983. CLASS="note"
  43984. ><P
  43985. ><B
  43986. >Poznßmka: </B
  43987. >
  43988.       Please note that this function only checks one dimension of a n-dimensional
  43989.       array. Of course you can check deeper dimensions by using, for example, 
  43990.       <TT
  43991. CLASS="literal"
  43992. >array_udiff_assoc($array1[0], $array2[0], "some_comparison_func");</TT
  43993. >.
  43994.      </P
  43995. ></BLOCKQUOTE
  43996. ></DIV
  43997. ><P
  43998. >      See also
  43999.      <A
  44000. HREF="#function.array-diff"
  44001. ><B
  44002. CLASS="function"
  44003. >array_diff()</B
  44004. ></A
  44005. >,
  44006.      <A
  44007. HREF="#function.array-diff-assoc"
  44008. ><B
  44009. CLASS="function"
  44010. >array_diff_assoc()</B
  44011. ></A
  44012. >,
  44013.      <A
  44014. HREF="#function.array-diff-uassoc"
  44015. ><B
  44016. CLASS="function"
  44017. >array_diff_uassoc()</B
  44018. ></A
  44019. >,
  44020.      <A
  44021. HREF="#function.array-udiff"
  44022. ><B
  44023. CLASS="function"
  44024. >array_udiff()</B
  44025. ></A
  44026. >,
  44027.      <A
  44028. HREF="#function.array-udiff-uassoc"
  44029. ><B
  44030. CLASS="function"
  44031. >array_udiff_uassoc()</B
  44032. ></A
  44033. >, 
  44034.      <A
  44035. HREF="#function.array-intersect"
  44036. ><B
  44037. CLASS="function"
  44038. >array_intersect()</B
  44039. ></A
  44040. >,  
  44041.      <A
  44042. HREF="#function.array-intersect-assoc"
  44043. ><B
  44044. CLASS="function"
  44045. >array_intersect_assoc()</B
  44046. ></A
  44047. >,
  44048.      <B
  44049. CLASS="function"
  44050. >array_uintersect()</B
  44051. >,  
  44052.      <B
  44053. CLASS="function"
  44054. >array_uintersect_assoc()</B
  44055. > and 
  44056.      <B
  44057. CLASS="function"
  44058. >array_uintersect_uassoc()</B
  44059. >.
  44060.     </P
  44061. ></DIV
  44062. ><H1
  44063. ><A
  44064. NAME="function.array-udiff-uassoc"
  44065. ></A
  44066. >array_udiff_uassoc</H1
  44067. ><DIV
  44068. CLASS="refnamediv"
  44069. ><A
  44070. NAME="AEN8191"
  44071. ></A
  44072. ><P
  44073. >    (no version information, might be only in CVS)</P
  44074. >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
  44075. ><DIV
  44076. CLASS="refsect1"
  44077. ><A
  44078. NAME="AEN8194"
  44079. ></A
  44080. ><H2
  44081. >Description</H2
  44082. >array <B
  44083. CLASS="methodname"
  44084. >array_udiff_uassoc</B
  44085. > ( array array1, array array2 [, array ..., callback data_compare_func, callback key_compare_func])<BR
  44086. ></BR
  44087. ><P
  44088. >      <B
  44089. CLASS="function"
  44090. >array_udiff_uassoc()</B
  44091. > returns an <A
  44092. HREF="#language.types.array"
  44093. ><B
  44094. CLASS="type"
  44095. >array</B
  44096. ></A
  44097. >
  44098.      containing all the values from <TT
  44099. CLASS="parameter"
  44100. ><I
  44101. >array1</I
  44102. ></TT
  44103. >
  44104.      that are not present in any of the other arguments.
  44105.      Note that the keys are used in the comparison unlike 
  44106.      <A
  44107. HREF="#function.array-diff"
  44108. ><B
  44109. CLASS="function"
  44110. >array_diff()</B
  44111. ></A
  44112. > and <A
  44113. HREF="#function.array-udiff"
  44114. ><B
  44115. CLASS="function"
  44116. >array_udiff()</B
  44117. ></A
  44118. >.
  44119.      The comparison of arrays' data is performed by using an user-supplied
  44120.      callback : <TT
  44121. CLASS="parameter"
  44122. ><I
  44123. >data_compare_func</I
  44124. ></TT
  44125. >. In this aspect
  44126.      the behaviour is opposite to the behaviour of
  44127.      <A
  44128. HREF="#function.array-diff-assoc"
  44129. ><B
  44130. CLASS="function"
  44131. >array_diff_assoc()</B
  44132. ></A
  44133. > which uses internal function for
  44134.      comparison. The comparison of keys (indices) is done also by the 
  44135.      callback function <TT
  44136. CLASS="parameter"
  44137. ><I
  44138. >key_compare_func</I
  44139. ></TT
  44140. >. This
  44141.      behaviour is unlike what <A
  44142. HREF="#function.array-udiff-assoc"
  44143. ><B
  44144. CLASS="function"
  44145. >array_udiff_assoc()</B
  44146. ></A
  44147. > does, since
  44148.      the latter compares the indices by using an internal function.
  44149.     </P
  44150. ><P
  44151. >      <TABLE
  44152. WIDTH="100%"
  44153. BORDER="0"
  44154. CELLPADDING="0"
  44155. CELLSPACING="0"
  44156. CLASS="EXAMPLE"
  44157. ><TR
  44158. ><TD
  44159. ><DIV
  44160. CLASS="example"
  44161. ><A
  44162. NAME="AEN8225"
  44163. ></A
  44164. ><P
  44165. ><B
  44166. >P°φklad 1. <B
  44167. CLASS="function"
  44168. >array_udiff_uassoc()</B
  44169. > example</B
  44170. ></P
  44171. ><TABLE
  44172. BORDER="0"
  44173. BGCOLOR="#E0E0E0"
  44174. CELLPADDING="5"
  44175. ><TR
  44176. ><TD
  44177. ><PRE
  44178. CLASS="php"
  44179. ><?php
  44180. class cr {
  44181.     var $priv_member;
  44182.     function cr($val) {
  44183.         $this->priv_member = $val;
  44184.     }
  44185.     function comp_func_cr($a, $b) {
  44186.         if ($a->priv_member === $b->priv_member) return 0;
  44187.         return ($a->priv_member > $b->priv_member)? 1:-1;
  44188.     }
  44189.     function comp_func_key($a, $b) {
  44190.         if ($a === $b) return 0;
  44191.         return ($a > $b)? 1:-1;
  44192.     }
  44193. }
  44194. $a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
  44195. $b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
  44196.  
  44197. $result = array_udiff_uassoc($a, $b, array("cr", "comp_func_cr"), array("cr", "comp_func_key"));
  44198. print_r($result);
  44199. ?></PRE
  44200. ></TD
  44201. ></TR
  44202. ></TABLE
  44203. ><P
  44204. >        The result is:
  44205.       </P
  44206. ><TABLE
  44207. BORDER="0"
  44208. BGCOLOR="#E0E0E0"
  44209. CELLPADDING="5"
  44210. ><TR
  44211. ><TD
  44212. ><PRE
  44213. CLASS="screen"
  44214. >Array
  44215. (
  44216.     [0.1] => cr Object
  44217.         (
  44218.             [priv_member:private] => 9
  44219.         )
  44220.  
  44221.     [0.5] => cr Object
  44222.         (
  44223.             [priv_member:private] => 12
  44224.         )
  44225.  
  44226.     [0] => cr Object
  44227.         (
  44228.             [priv_member:private] => 23
  44229.         )
  44230. )</PRE
  44231. ></TD
  44232. ></TR
  44233. ></TABLE
  44234. ></DIV
  44235. ></TD
  44236. ></TR
  44237. ></TABLE
  44238. >
  44239.     </P
  44240. ><P
  44241. >      In our example above you see the <TT
  44242. CLASS="literal"
  44243. >"1" => new cr(4)</TT
  44244. >
  44245.      pair is present in both arrays and thus it is not in the ouput from the
  44246.      function. Keep in mind that you have to supply 2 callback functions.
  44247.     </P
  44248. ><P
  44249. >      For comparison is used the user supplied callback function.
  44250.      It must return an integer less than, equal
  44251.      to, or greater than zero if the first argument is considered to
  44252.      be respectively less than, equal to, or greater than the
  44253.      second.
  44254.     </P
  44255. ><DIV
  44256. CLASS="note"
  44257. ><BLOCKQUOTE
  44258. CLASS="note"
  44259. ><P
  44260. ><B
  44261. >Poznßmka: </B
  44262. >
  44263.       Please note that this function only checks one dimension of a n-dimensional
  44264.       array. Of course you can check deeper dimensions by using, for example, 
  44265.       <TT
  44266. CLASS="literal"
  44267. >array_udiff_uassoc($array1[0], $array2[0], "data_compare_func",
  44268.       "key_compare_func");</TT
  44269. >.
  44270.      </P
  44271. ></BLOCKQUOTE
  44272. ></DIV
  44273. ><P
  44274. >      See also
  44275.      <A
  44276. HREF="#function.array-diff"
  44277. ><B
  44278. CLASS="function"
  44279. >array_diff()</B
  44280. ></A
  44281. >,
  44282.      <A
  44283. HREF="#function.array-diff-assoc"
  44284. ><B
  44285. CLASS="function"
  44286. >array_diff_assoc()</B
  44287. ></A
  44288. >,
  44289.      <A
  44290. HREF="#function.array-diff-uassoc"
  44291. ><B
  44292. CLASS="function"
  44293. >array_diff_uassoc()</B
  44294. ></A
  44295. >,
  44296.      <A
  44297. HREF="#function.array-udiff"
  44298. ><B
  44299. CLASS="function"
  44300. >array_udiff()</B
  44301. ></A
  44302. >,
  44303.      <A
  44304. HREF="#function.array-udiff-assoc"
  44305. ><B
  44306. CLASS="function"
  44307. >array_udiff_assoc()</B
  44308. ></A
  44309. >, 
  44310.      <A
  44311. HREF="#function.array-intersect"
  44312. ><B
  44313. CLASS="function"
  44314. >array_intersect()</B
  44315. ></A
  44316. >,  
  44317.      <A
  44318. HREF="#function.array-intersect-assoc"
  44319. ><B
  44320. CLASS="function"
  44321. >array_intersect_assoc()</B
  44322. ></A
  44323. >,
  44324.      <B
  44325. CLASS="function"
  44326. >array_uintersect()</B
  44327. >,  
  44328.      <B
  44329. CLASS="function"
  44330. >array_uintersect_assoc()</B
  44331. > and 
  44332.      <B
  44333. CLASS="function"
  44334. >array_uintersect_uassoc()</B
  44335. >.
  44336.     </P
  44337. ></DIV
  44338. ><H1
  44339. ><A
  44340. NAME="function.array-udiff"
  44341. ></A
  44342. >array_udiff</H1
  44343. ><DIV
  44344. CLASS="refnamediv"
  44345. ><A
  44346. NAME="AEN8249"
  44347. ></A
  44348. ><P
  44349. >    (no version information, might be only in CVS)</P
  44350. >array_udiff -- Computes the difference of arrays by using a callback function for data comparison.</DIV
  44351. ><DIV
  44352. CLASS="refsect1"
  44353. ><A
  44354. NAME="AEN8252"
  44355. ></A
  44356. ><H2
  44357. >Description</H2
  44358. >array <B
  44359. CLASS="methodname"
  44360. >array_udiff</B
  44361. > ( array array1, array array2 [, array ..., callback data_compare_func])<BR
  44362. ></BR
  44363. ><P
  44364. >      <B
  44365. CLASS="function"
  44366. >array_udiff()</B
  44367. > returns an array
  44368.      containing all the values of <TT
  44369. CLASS="parameter"
  44370. ><I
  44371. >array1</I
  44372. ></TT
  44373. >
  44374.      that are not present in any of the other arguments.
  44375.      Note that keys are preserved. For the comparison of the data
  44376.      <TT
  44377. CLASS="parameter"
  44378. ><I
  44379. >data_compare_func</I
  44380. ></TT
  44381. > is used.
  44382.      It must return an integer less than, equal
  44383.      to, or greater than zero if the first argument is considered to
  44384.      be respectively less than, equal to, or greater than the
  44385.      second. This is unlike <A
  44386. HREF="#function.array-diff"
  44387. ><B
  44388. CLASS="function"
  44389. >array_diff()</B
  44390. ></A
  44391. > which uses an
  44392.      internal function for comparing the data.
  44393.     </P
  44394. ><P
  44395. >      <TABLE
  44396. WIDTH="100%"
  44397. BORDER="0"
  44398. CELLPADDING="0"
  44399. CELLSPACING="0"
  44400. CLASS="EXAMPLE"
  44401. ><TR
  44402. ><TD
  44403. ><DIV
  44404. CLASS="example"
  44405. ><A
  44406. NAME="AEN8275"
  44407. ></A
  44408. ><P
  44409. ><B
  44410. >P°φklad 1. <B
  44411. CLASS="function"
  44412. >array_udiff()</B
  44413. > example</B
  44414. ></P
  44415. ><TABLE
  44416. BORDER="0"
  44417. BGCOLOR="#E0E0E0"
  44418. CELLPADDING="5"
  44419. ><TR
  44420. ><TD
  44421. ><PRE
  44422. CLASS="php"
  44423. ><?php
  44424. class cr {
  44425.     var $priv_member;
  44426.     function cr($val) {
  44427.         $this->priv_member = $val;
  44428.     }
  44429.     function comp_func_cr($a, $b) {
  44430.         if ($a->priv_member === $b->priv_member) return 0;
  44431.         return ($a->priv_member > $b->priv_member)? 1:-1;
  44432.     }
  44433. }
  44434. $a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
  44435. $b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
  44436.  
  44437. $result = array_udiff($a, $b, array("cr", "comp_func_cr"));
  44438. print_r($result);
  44439. ?></PRE
  44440. ></TD
  44441. ></TR
  44442. ></TABLE
  44443. ><P
  44444. >        The result is:
  44445.       </P
  44446. ><TABLE
  44447. BORDER="0"
  44448. BGCOLOR="#E0E0E0"
  44449. CELLPADDING="5"
  44450. ><TR
  44451. ><TD
  44452. ><PRE
  44453. CLASS="screen"
  44454. >Array
  44455. (
  44456.     [0.5] => cr Object
  44457.         (
  44458.             [priv_member:private] => 12
  44459.         )
  44460.  
  44461.     [0] => cr Object
  44462.         (
  44463.             [priv_member:private] => 23
  44464.         )
  44465.  
  44466. )</PRE
  44467. ></TD
  44468. ></TR
  44469. ></TABLE
  44470. ></DIV
  44471. ></TD
  44472. ></TR
  44473. ></TABLE
  44474. >
  44475.     </P
  44476. ><DIV
  44477. CLASS="note"
  44478. ><BLOCKQUOTE
  44479. CLASS="note"
  44480. ><P
  44481. ><B
  44482. >Poznßmka: </B
  44483. >
  44484.       Two elements are considered equal if and only if
  44485.       <TT
  44486. CLASS="literal"
  44487. >(string) $elem1 === (string) $elem2</TT
  44488. >. In words:
  44489.       when the string representation is the same.
  44490.      </P
  44491. ></BLOCKQUOTE
  44492. ></DIV
  44493. ><DIV
  44494. CLASS="note"
  44495. ><BLOCKQUOTE
  44496. CLASS="note"
  44497. ><P
  44498. ><B
  44499. >Poznßmka: </B
  44500. >
  44501.       Please note that this function only checks one dimension of a n-dimensional
  44502.       array. Of course you can check deeper dimensions by using
  44503.       <TT
  44504. CLASS="literal"
  44505. >array_udiff($array1[0], $array2[0], "data_compare_func");</TT
  44506. >.
  44507.      </P
  44508. ></BLOCKQUOTE
  44509. ></DIV
  44510. ><P
  44511. >      See also
  44512.      <A
  44513. HREF="#function.array-diff"
  44514. ><B
  44515. CLASS="function"
  44516. >array_diff()</B
  44517. ></A
  44518. >,
  44519.      <A
  44520. HREF="#function.array-diff-assoc"
  44521. ><B
  44522. CLASS="function"
  44523. >array_diff_assoc()</B
  44524. ></A
  44525. >,
  44526.      <A
  44527. HREF="#function.array-diff-uassoc"
  44528. ><B
  44529. CLASS="function"
  44530. >array_diff_uassoc()</B
  44531. ></A
  44532. >,
  44533.      <A
  44534. HREF="#function.array-udiff-assoc"
  44535. ><B
  44536. CLASS="function"
  44537. >array_udiff_assoc()</B
  44538. ></A
  44539. >, 
  44540.      <A
  44541. HREF="#function.array-udiff-uassoc"
  44542. ><B
  44543. CLASS="function"
  44544. >array_udiff_uassoc()</B
  44545. ></A
  44546. >, 
  44547.      <A
  44548. HREF="#function.array-intersect"
  44549. ><B
  44550. CLASS="function"
  44551. >array_intersect()</B
  44552. ></A
  44553. >,  
  44554.      <A
  44555. HREF="#function.array-intersect-assoc"
  44556. ><B
  44557. CLASS="function"
  44558. >array_intersect_assoc()</B
  44559. ></A
  44560. >,
  44561.      <B
  44562. CLASS="function"
  44563. >array_uintersect()</B
  44564. >,  
  44565.      <B
  44566. CLASS="function"
  44567. >array_uintersect_assoc()</B
  44568. > and 
  44569.      <B
  44570. CLASS="function"
  44571. >array_uintersect_uassoc()</B
  44572. >.
  44573.     </P
  44574. ></DIV
  44575. ><H1
  44576. ><A
  44577. NAME="function.array-unique"
  44578. ></A
  44579. >array_unique</H1
  44580. ><DIV
  44581. CLASS="refnamediv"
  44582. ><A
  44583. NAME="AEN8299"
  44584. ></A
  44585. ><P
  44586. >    (PHP 4 >= 4.0.1)</P
  44587. >array_unique -- Odstranit z pole duplicitnφ hodnoty</DIV
  44588. ><DIV
  44589. CLASS="refsect1"
  44590. ><A
  44591. NAME="AEN8302"
  44592. ></A
  44593. ><H2
  44594. >Popis</H2
  44595. >array <B
  44596. CLASS="methodname"
  44597. >array_unique</B
  44598. > ( array array)<BR
  44599. ></BR
  44600. ><P
  44601. >      <B
  44602. CLASS="function"
  44603. >array_unique()</B
  44604. > p°ijφmß pole <TT
  44605. CLASS="parameter"
  44606. ><I
  44607. >array</I
  44608. ></TT
  44609. >
  44610.      a vracφ novΘ pole bez duplicitnφch hodnot. KlφΦe jsou zachovßny.
  44611.     </P
  44612. ><P
  44613. >      <TABLE
  44614. WIDTH="100%"
  44615. BORDER="0"
  44616. CELLPADDING="0"
  44617. CELLSPACING="0"
  44618. CLASS="EXAMPLE"
  44619. ><TR
  44620. ><TD
  44621. ><DIV
  44622. CLASS="example"
  44623. ><A
  44624. NAME="AEN8314"
  44625. ></A
  44626. ><P
  44627. ><B
  44628. >P°φklad 1. Ukßzka <B
  44629. CLASS="function"
  44630. >array_unique()</B
  44631. ></B
  44632. ></P
  44633. ><TABLE
  44634. BORDER="0"
  44635. BGCOLOR="#E0E0E0"
  44636. CELLPADDING="5"
  44637. ><TR
  44638. ><TD
  44639. ><PRE
  44640. CLASS="php"
  44641. >$input = array ("a" => "green", "red", "b" => "green", "blue", "red");
  44642. $result = array_unique ($input);</PRE
  44643. ></TD
  44644. ></TR
  44645. ></TABLE
  44646. ></DIV
  44647. ></TD
  44648. ></TR
  44649. ></TABLE
  44650. >
  44651.     </P
  44652. ><P
  44653. >      <TT
  44654. CLASS="varname"
  44655. >$result</TT
  44656. > te∩ obsahuje <TT
  44657. CLASS="literal"
  44658. >array ("a" =>
  44659.      "green", "red", "blue");</TT
  44660. >.
  44661.     </P
  44662. ></DIV
  44663. ><H1
  44664. ><A
  44665. NAME="function.array-unshift"
  44666. ></A
  44667. >array_unshift</H1
  44668. ><DIV
  44669. CLASS="refnamediv"
  44670. ><A
  44671. NAME="AEN8322"
  44672. ></A
  44673. ><P
  44674. >    (PHP 4 )</P
  44675. >array_unshift -- P°ipojit jeden nebo vφce prvk∙ na zaΦßtek pole</DIV
  44676. ><DIV
  44677. CLASS="refsect1"
  44678. ><A
  44679. NAME="AEN8325"
  44680. ></A
  44681. ><H2
  44682. >Popis</H2
  44683. >int <B
  44684. CLASS="methodname"
  44685. >array_unshift</B
  44686. > ( array array, mixed var [, mixed ...])<BR
  44687. ></BR
  44688. ><P
  44689. >      <B
  44690. CLASS="function"
  44691. >array_unshift()</B
  44692. > p°ipojφ p°edanΘ prvky na zaΦßtek
  44693.      <TT
  44694. CLASS="parameter"
  44695. ><I
  44696. >array</I
  44697. ></TT
  44698. >. V╣echny prvky jsou p°idßny jako celek, Φili
  44699.      p°idanΘ prvky si zachovßvajφ po°adφ.
  44700.     </P
  44701. ><P
  44702. >      vracφ nov² poΦet prvk∙ v <TT
  44703. CLASS="parameter"
  44704. ><I
  44705. >array</I
  44706. ></TT
  44707. >.
  44708.     </P
  44709. ><P
  44710. >      <TABLE
  44711. WIDTH="100%"
  44712. BORDER="0"
  44713. CELLPADDING="0"
  44714. CELLSPACING="0"
  44715. CLASS="EXAMPLE"
  44716. ><TR
  44717. ><TD
  44718. ><DIV
  44719. CLASS="example"
  44720. ><A
  44721. NAME="AEN8345"
  44722. ></A
  44723. ><P
  44724. ><B
  44725. >P°φklad 1. Ukßzka <B
  44726. CLASS="function"
  44727. >array_unshift()</B
  44728. ></B
  44729. ></P
  44730. ><TABLE
  44731. BORDER="0"
  44732. BGCOLOR="#E0E0E0"
  44733. CELLPADDING="5"
  44734. ><TR
  44735. ><TD
  44736. ><PRE
  44737. CLASS="php"
  44738. >$queue = array ("p1", "p3");
  44739. array_unshift ($queue, "p4", "p5", "p6");</PRE
  44740. ></TD
  44741. ></TR
  44742. ></TABLE
  44743. ></DIV
  44744. ></TD
  44745. ></TR
  44746. ></TABLE
  44747. >
  44748.     </P
  44749. ><P
  44750. >      <TT
  44751. CLASS="varname"
  44752. >$queue</TT
  44753. > bude mφt 5 prvk∙: "p4", "p5", "p6", "p1" a "p3".
  44754.     </P
  44755. ><P
  44756. >      Viz takΘ: <A
  44757. HREF="#function.array-shift"
  44758. ><B
  44759. CLASS="function"
  44760. >array_shift()</B
  44761. ></A
  44762. >,
  44763.      <A
  44764. HREF="#function.array-push"
  44765. ><B
  44766. CLASS="function"
  44767. >array_push()</B
  44768. ></A
  44769. > a
  44770.      <A
  44771. HREF="#function.array-pop"
  44772. ><B
  44773. CLASS="function"
  44774. >array_pop()</B
  44775. ></A
  44776. >.
  44777.     </P
  44778. ></DIV
  44779. ><H1
  44780. ><A
  44781. NAME="function.array-values"
  44782. ></A
  44783. >array_values</H1
  44784. ><DIV
  44785. CLASS="refnamediv"
  44786. ><A
  44787. NAME="AEN8356"
  44788. ></A
  44789. ><P
  44790. >    (PHP 4 )</P
  44791. >array_values -- Vrßtit v╣echny hodnoty v poli</DIV
  44792. ><DIV
  44793. CLASS="refsect1"
  44794. ><A
  44795. NAME="AEN8359"
  44796. ></A
  44797. ><H2
  44798. >Popis</H2
  44799. >array <B
  44800. CLASS="methodname"
  44801. >array_values</B
  44802. > ( array input)<BR
  44803. ></BR
  44804. ><P
  44805. >      <B
  44806. CLASS="function"
  44807. >array_values()</B
  44808. > vracφ v╣echny hodnoty pole
  44809.      <TT
  44810. CLASS="parameter"
  44811. ><I
  44812. >input</I
  44813. ></TT
  44814. >.
  44815.     </P
  44816. ><P
  44817. >      <TABLE
  44818. WIDTH="100%"
  44819. BORDER="0"
  44820. CELLPADDING="0"
  44821. CELLSPACING="0"
  44822. CLASS="EXAMPLE"
  44823. ><TR
  44824. ><TD
  44825. ><DIV
  44826. CLASS="example"
  44827. ><A
  44828. NAME="AEN8371"
  44829. ></A
  44830. ><P
  44831. ><B
  44832. >P°φklad 1. Ukßzka <B
  44833. CLASS="function"
  44834. >array_values()</B
  44835. ></B
  44836. ></P
  44837. ><TABLE
  44838. BORDER="0"
  44839. BGCOLOR="#E0E0E0"
  44840. CELLPADDING="5"
  44841. ><TR
  44842. ><TD
  44843. ><PRE
  44844. CLASS="php"
  44845. >$array = array ("size" => "XL", "color" => "gold");
  44846. array_values ($array);    // vrßtφ array ("XL", "gold")</PRE
  44847. ></TD
  44848. ></TR
  44849. ></TABLE
  44850. ></DIV
  44851. ></TD
  44852. ></TR
  44853. ></TABLE
  44854. >
  44855.     </P
  44856. ><DIV
  44857. CLASS="note"
  44858. ><BLOCKQUOTE
  44859. CLASS="note"
  44860. ><P
  44861. ><B
  44862. >Poznßmka: </B
  44863. >
  44864.       Tato funkce byla p°idßna v PHP 4, nßsleduje implementace pro ty, kdo stßle
  44865.       pou╛φvajφ PHP 3.
  44866.       <TABLE
  44867. WIDTH="100%"
  44868. BORDER="0"
  44869. CELLPADDING="0"
  44870. CELLSPACING="0"
  44871. CLASS="EXAMPLE"
  44872. ><TR
  44873. ><TD
  44874. ><DIV
  44875. CLASS="example"
  44876. ><A
  44877. NAME="AEN8377"
  44878. ></A
  44879. ><P
  44880. ><B
  44881. >P°φklad 2. 
  44882.         Implementace <B
  44883. CLASS="function"
  44884. >array_values()</B
  44885. > pro u╛ivatele PHP 3
  44886.        </B
  44887. ></P
  44888. ><TABLE
  44889. BORDER="0"
  44890. BGCOLOR="#E0E0E0"
  44891. CELLPADDING="5"
  44892. ><TR
  44893. ><TD
  44894. ><PRE
  44895. CLASS="php"
  44896. >function array_values ($arr) {
  44897.     $t = array();
  44898.     while (list($k, $v) = each ($arr)) {
  44899.         $t[] = $v;
  44900.         return $t;
  44901.     }
  44902. }</PRE
  44903. ></TD
  44904. ></TR
  44905. ></TABLE
  44906. ></DIV
  44907. ></TD
  44908. ></TR
  44909. ></TABLE
  44910. >
  44911.      </P
  44912. ></BLOCKQUOTE
  44913. ></DIV
  44914. ></DIV
  44915. ><H1
  44916. ><A
  44917. NAME="function.array-walk"
  44918. ></A
  44919. >array_walk</H1
  44920. ><DIV
  44921. CLASS="refnamediv"
  44922. ><A
  44923. NAME="AEN8382"
  44924. ></A
  44925. ><P
  44926. >    (PHP 3>= 3.0.3, PHP 4 )</P
  44927. >array_walk -- Pou╛φt u╛ivatelskou funkci na v╣echny prvky pole</DIV
  44928. ><DIV
  44929. CLASS="refsect1"
  44930. ><A
  44931. NAME="AEN8385"
  44932. ></A
  44933. ><H2
  44934. >Popis</H2
  44935. >int <B
  44936. CLASS="methodname"
  44937. >array_walk</B
  44938. > ( array arr, string func, mixed userdata)<BR
  44939. ></BR
  44940. ><P
  44941. >      Aplikuje funkci <TT
  44942. CLASS="parameter"
  44943. ><I
  44944. >func</I
  44945. ></TT
  44946. > na v╣echny prvky pole
  44947.      <TT
  44948. CLASS="parameter"
  44949. ><I
  44950. >arr</I
  44951. ></TT
  44952. >. Funkci <TT
  44953. CLASS="parameter"
  44954. ><I
  44955. >func</I
  44956. ></TT
  44957. > se jako prvnφ
  44958.      argument p°edß hodnota a jako druh² klφΦ. Pokud je p°φtomen argument
  44959.      <TT
  44960. CLASS="parameter"
  44961. ><I
  44962. >userdata</I
  44963. ></TT
  44964. >, bude u╛ivatelskΘ funkci p°edßn jako
  44965.      t°etφ argument.
  44966.     </P
  44967. ><P
  44968. >      Pokud <TT
  44969. CLASS="parameter"
  44970. ><I
  44971. >func</I
  44972. ></TT
  44973. > vy╛aduje vφce ne╛ dva nebo t°i argumenty
  44974.      (v zßvislosti na <TT
  44975. CLASS="parameter"
  44976. ><I
  44977. >userdata</I
  44978. ></TT
  44979. >), pro ka╛dΘ volßnφ
  44980.      <TT
  44981. CLASS="parameter"
  44982. ><I
  44983. >func</I
  44984. ></TT
  44985. > z <B
  44986. CLASS="function"
  44987. >array_walk()</B
  44988. > se vygeneruje
  44989.      varovßnφ. Tato varovßnφ se dajφ potlaΦit p°idßnφm znaku '@' p°ed
  44990.      volßnφ <B
  44991. CLASS="function"
  44992. >array_walk()</B
  44993. > nebo pomocφ
  44994.      <A
  44995. HREF="#function.error-reporting"
  44996. ><B
  44997. CLASS="function"
  44998. >error_reporting()</B
  44999. ></A
  45000. >.
  45001.     </P
  45002. ><DIV
  45003. CLASS="note"
  45004. ><BLOCKQUOTE
  45005. CLASS="note"
  45006. ><P
  45007. ><B
  45008. >Poznßmka: </B
  45009. >
  45010.       Pokud <TT
  45011. CLASS="parameter"
  45012. ><I
  45013. >func</I
  45014. ></TT
  45015. > pot°ebuje pracovat p°φmo s dan²m polem,
  45016.       prvnφ argument <TT
  45017. CLASS="parameter"
  45018. ><I
  45019. >func</I
  45020. ></TT
  45021. > se musφ p°edßvat odkazem.
  45022.       V╣echny zm∞ny t∞chto hodnot se pak promφtnou p°φmo
  45023.       v <TT
  45024. CLASS="parameter"
  45025. ><I
  45026. >arr</I
  45027. ></TT
  45028. >.
  45029.      </P
  45030. ></BLOCKQUOTE
  45031. ></DIV
  45032. ><DIV
  45033. CLASS="note"
  45034. ><BLOCKQUOTE
  45035. CLASS="note"
  45036. ><P
  45037. ><B
  45038. >Poznßmka: </B
  45039. >
  45040.       Druh² a t°etφ argument <TT
  45041. CLASS="parameter"
  45042. ><I
  45043. >func</I
  45044. ></TT
  45045. > byly p°idßny v PHP 4.0.
  45046.      </P
  45047. ><P
  45048. >       V PHP 4 je t°eba volat podle pot°eby <A
  45049. HREF="#function.reset"
  45050. ><B
  45051. CLASS="function"
  45052. >reset()</B
  45053. ></A
  45054. >, proto╛e
  45055.       <B
  45056. CLASS="function"
  45057. >array_walk()</B
  45058. > sama vstupnφ pole neresetuje.
  45059.      </P
  45060. ></BLOCKQUOTE
  45061. ></DIV
  45062. ><P
  45063. >      <TABLE
  45064. WIDTH="100%"
  45065. BORDER="0"
  45066. CELLPADDING="0"
  45067. CELLSPACING="0"
  45068. CLASS="EXAMPLE"
  45069. ><TR
  45070. ><TD
  45071. ><DIV
  45072. CLASS="example"
  45073. ><A
  45074. NAME="AEN8423"
  45075. ></A
  45076. ><P
  45077. ><B
  45078. >P°φklad 1. Ukßzka <B
  45079. CLASS="function"
  45080. >array_walk()</B
  45081. ></B
  45082. ></P
  45083. ><TABLE
  45084. BORDER="0"
  45085. BGCOLOR="#E0E0E0"
  45086. CELLPADDING="5"
  45087. ><TR
  45088. ><TD
  45089. ><PRE
  45090. CLASS="php"
  45091. >$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
  45092.  
  45093. function test_alter (&$item1, $key, $prefix) {
  45094.     $item1 = "$prefix: $item1";
  45095. }
  45096.  
  45097. function test_print ($item2, $key) {
  45098.     echo "$key. $item2<br>\n";
  45099. }
  45100.  
  45101. array_walk ($fruits, 'test_print');
  45102. reset ($fruits);
  45103. array_walk ($fruits, 'test_alter', 'fruit');
  45104. reset ($fruits);
  45105. array_walk ($fruits, 'test_print');</PRE
  45106. ></TD
  45107. ></TR
  45108. ></TABLE
  45109. ></DIV
  45110. ></TD
  45111. ></TR
  45112. ></TABLE
  45113. >
  45114.     </P
  45115. ><P
  45116. >      Viz takΘ: <A
  45117. HREF="#function.each"
  45118. ><B
  45119. CLASS="function"
  45120. >each()</B
  45121. ></A
  45122. > a
  45123.      <A
  45124. HREF="#function.list"
  45125. ><B
  45126. CLASS="function"
  45127. >list()</B
  45128. ></A
  45129. >.
  45130.     </P
  45131. ></DIV
  45132. ><H1
  45133. ><A
  45134. NAME="function.array"
  45135. ></A
  45136. >array</H1
  45137. ><DIV
  45138. CLASS="refnamediv"
  45139. ><A
  45140. NAME="AEN8431"
  45141. ></A
  45142. ><P
  45143. >    (PHP 3, PHP 4 )</P
  45144. >array -- 
  45145.      Vytvo°it pole
  45146.     </DIV
  45147. ><DIV
  45148. CLASS="refsect1"
  45149. ><A
  45150. NAME="AEN8434"
  45151. ></A
  45152. ><H2
  45153. >Popis</H2
  45154. >array <B
  45155. CLASS="methodname"
  45156. >array</B
  45157. > ( [mixed ...])<BR
  45158. ></BR
  45159. ><P
  45160. >      Vracφ pole argument∙. Argument∙m m∙╛e b²t p°i°azen index pomocφ operßtoru
  45161.      <TT
  45162. CLASS="literal"
  45163. >=></TT
  45164. >.
  45165.     </P
  45166. ><P
  45167. >      <DIV
  45168. CLASS="note"
  45169. ><BLOCKQUOTE
  45170. CLASS="note"
  45171. ><P
  45172. ><B
  45173. >Poznßmka: </B
  45174. >
  45175.        <B
  45176. CLASS="function"
  45177. >array()</B
  45178. > je jazykov² konstrukt pou╛φvan² k reprezentaci
  45179.        polφ, nikoliv b∞╛nß funkce.
  45180.       </P
  45181. ></BLOCKQUOTE
  45182. ></DIV
  45183. >
  45184.     </P
  45185. ><P
  45186. >      Syntaxe "index => hodnota", s Φßrko jako odd∞lovaΦem, definuje indexy a
  45187.      hodnoty. Index m∙╛e b²t °et∞zec nebo Φφslo. Pokud se index vynechß,
  45188.      automaticky se generuje Φφseln² index zaΦφnajφcφ na 0. Pokud je index
  45189.      integer, dal╣φ generovan² index bude nejvy╣╣φ celoΦφseln² index + 1. Pozn.:
  45190.      pokud jsou definovßny dva identickΘ indexy, prvnφ se p°epφ╣e poslednφm.
  45191.     </P
  45192. ><P
  45193. >      Nßsledujφcφ ukßzka demonstruje jak vytvo°it dvourozm∞rnΘ pole, jak urΦit
  45194.      klφΦe v asociativnφch polφch, a jak p°eskakovat ΦφselnΘ indexy v normßlnφch
  45195.      polφch.
  45196.      <TABLE
  45197. WIDTH="100%"
  45198. BORDER="0"
  45199. CELLPADDING="0"
  45200. CELLSPACING="0"
  45201. CLASS="EXAMPLE"
  45202. ><TR
  45203. ><TD
  45204. ><DIV
  45205. CLASS="example"
  45206. ><A
  45207. NAME="AEN8450"
  45208. ></A
  45209. ><P
  45210. ><B
  45211. >P°φklad 1. Ukßzka <B
  45212. CLASS="function"
  45213. >array()</B
  45214. ></B
  45215. ></P
  45216. ><TABLE
  45217. BORDER="0"
  45218. BGCOLOR="#E0E0E0"
  45219. CELLPADDING="5"
  45220. ><TR
  45221. ><TD
  45222. ><PRE
  45223. CLASS="php"
  45224. >$fruits = array (
  45225.     "fruits"  => array ("a"=>"orange", "b"=>"banana", "c"=>"apple"),
  45226.     "numbers" => array (1, 2, 3, 4, 5, 6),
  45227.     "holes"   => array ("first", 5 => "second", "third")
  45228. );</PRE
  45229. ></TD
  45230. ></TR
  45231. ></TABLE
  45232. ></DIV
  45233. ></TD
  45234. ></TR
  45235. ></TABLE
  45236. >
  45237.     </P
  45238. ><P
  45239. >      <TABLE
  45240. WIDTH="100%"
  45241. BORDER="0"
  45242. CELLPADDING="0"
  45243. CELLSPACING="0"
  45244. CLASS="EXAMPLE"
  45245. ><TR
  45246. ><TD
  45247. ><DIV
  45248. CLASS="example"
  45249. ><A
  45250. NAME="AEN8455"
  45251. ></A
  45252. ><P
  45253. ><B
  45254. >P°φklad 2. Automatick² index a <B
  45255. CLASS="function"
  45256. >array()</B
  45257. ></B
  45258. ></P
  45259. ><TABLE
  45260. BORDER="0"
  45261. BGCOLOR="#E0E0E0"
  45262. CELLPADDING="5"
  45263. ><TR
  45264. ><TD
  45265. ><PRE
  45266. CLASS="php"
  45267. >$array = array( 1, 1, 1, 1,  1, 8=>1,  4=>1, 19, 3=>13);
  45268. print_r($array);</PRE
  45269. ></TD
  45270. ></TR
  45271. ></TABLE
  45272. ></DIV
  45273. ></TD
  45274. ></TR
  45275. ></TABLE
  45276. >
  45277.      v²stup bude nßsledujφcφ:
  45278.      <DIV
  45279. CLASS="informalexample"
  45280. ><A
  45281. NAME="AEN8459"
  45282. ></A
  45283. ><P
  45284. ></P
  45285. ><TABLE
  45286. BORDER="0"
  45287. BGCOLOR="#E0E0E0"
  45288. CELLPADDING="5"
  45289. ><TR
  45290. ><TD
  45291. ><PRE
  45292. CLASS="programlisting"
  45293. >Array
  45294. (
  45295.     [0] => 1
  45296.     [1] => 1
  45297.     [2] => 1
  45298.     [3] => 13
  45299.     [4] => 1
  45300.     [8] => 1
  45301.     [9] => 19
  45302. )</PRE
  45303. ></TD
  45304. ></TR
  45305. ></TABLE
  45306. ><P
  45307. ></P
  45308. ></DIV
  45309. >
  45310.      Index 3 je definovßn dvakrßt, a podr╛φ si poslednφ hodnotu 13. Index 4 je
  45311.      definovßn po indexu 8 a dal╣φ generovan² index (hodnota 19) je 9, proto╛e
  45312.      nejvy╣╣φ index byl 8.
  45313.     </P
  45314. ><P
  45315. >      Tato ukßzka vytvo°φ pole ΦφslovanΘ od 1.
  45316.      <TABLE
  45317. WIDTH="100%"
  45318. BORDER="0"
  45319. CELLPADDING="0"
  45320. CELLSPACING="0"
  45321. CLASS="EXAMPLE"
  45322. ><TR
  45323. ><TD
  45324. ><DIV
  45325. CLASS="example"
  45326. ><A
  45327. NAME="AEN8462"
  45328. ></A
  45329. ><P
  45330. ><B
  45331. >P°φklad 3. Index zaΦφnajφcφ 1 s <B
  45332. CLASS="function"
  45333. >array()</B
  45334. ></B
  45335. ></P
  45336. ><TABLE
  45337. BORDER="0"
  45338. BGCOLOR="#E0E0E0"
  45339. CELLPADDING="5"
  45340. ><TR
  45341. ><TD
  45342. ><PRE
  45343. CLASS="php"
  45344. >$firstquarter  = array(1 => 'January', 'February', 'March');
  45345.         print_r($firstquarter);</PRE
  45346. ></TD
  45347. ></TR
  45348. ></TABLE
  45349. ></DIV
  45350. ></TD
  45351. ></TR
  45352. ></TABLE
  45353. >
  45354.      toto bude v²stup:
  45355.      <DIV
  45356. CLASS="informalexample"
  45357. ><A
  45358. NAME="AEN8466"
  45359. ></A
  45360. ><P
  45361. ></P
  45362. ><TABLE
  45363. BORDER="0"
  45364. BGCOLOR="#E0E0E0"
  45365. CELLPADDING="5"
  45366. ><TR
  45367. ><TD
  45368. ><PRE
  45369. CLASS="programlisting"
  45370. >Array
  45371. (
  45372.     [1] => 'January'
  45373.     [2] => 'February'
  45374.     [3] => 'March'
  45375. )</PRE
  45376. ></TD
  45377. ></TR
  45378. ></TABLE
  45379. ><P
  45380. ></P
  45381. ></DIV
  45382. >
  45383.     </P
  45384. ><P
  45385. >      Viz takΘ: <A
  45386. HREF="#function.list"
  45387. ><B
  45388. CLASS="function"
  45389. >list()</B
  45390. ></A
  45391. >.
  45392.     </P
  45393. ></DIV
  45394. ><H1
  45395. ><A
  45396. NAME="function.arsort"
  45397. ></A
  45398. >arsort</H1
  45399. ><DIV
  45400. CLASS="refnamediv"
  45401. ><A
  45402. NAME="AEN8471"
  45403. ></A
  45404. ><P
  45405. >    (PHP 3, PHP 4 )</P
  45406. >arsort -- T°φdit pole sestupn∞ se zachovßnφm klφΦ∙
  45407.     </DIV
  45408. ><DIV
  45409. CLASS="refsect1"
  45410. ><A
  45411. NAME="AEN8474"
  45412. ></A
  45413. ><H2
  45414. >Popis</H2
  45415. >void <B
  45416. CLASS="methodname"
  45417. >arsort</B
  45418. > ( array array [, int sort_flags])<BR
  45419. ></BR
  45420. ><P
  45421. >      <B
  45422. CLASS="function"
  45423. >arsort()</B
  45424. > t°φdφ pole tak, ╛e indexy pole si zachovßvajφ
  45425.      korelace s prvky, se kter²mi jsou asociovßny. Toto je u╛iteΦnΘ hlavn∞ p°i
  45426.      t°φd∞nφ asociativnφch polφ, kde je po°adφ prvk∙ signifikantnφ.
  45427.      <TABLE
  45428. WIDTH="100%"
  45429. BORDER="0"
  45430. CELLPADDING="0"
  45431. CELLSPACING="0"
  45432. CLASS="EXAMPLE"
  45433. ><TR
  45434. ><TD
  45435. ><DIV
  45436. CLASS="example"
  45437. ><A
  45438. NAME="AEN8487"
  45439. ></A
  45440. ><P
  45441. ><B
  45442. >P°φklad 1. Ukßzka <B
  45443. CLASS="function"
  45444. >arsort()</B
  45445. ></B
  45446. ></P
  45447. ><TABLE
  45448. BORDER="0"
  45449. BGCOLOR="#E0E0E0"
  45450. CELLPADDING="5"
  45451. ><TR
  45452. ><TD
  45453. ><PRE
  45454. CLASS="php"
  45455. >$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
  45456. arsort ($fruits);
  45457. reset ($fruits);
  45458. while (list ($key, $val) = each ($fruits)) {
  45459.     echo "$key = $val\n";
  45460. }</PRE
  45461. ></TD
  45462. ></TR
  45463. ></TABLE
  45464. ></DIV
  45465. ></TD
  45466. ></TR
  45467. ></TABLE
  45468. >
  45469.     </P
  45470. ><P
  45471. >      Tato ukßzka zobrazφ:
  45472.     </P
  45473. ><P
  45474. >      <DIV
  45475. CLASS="informalexample"
  45476. ><A
  45477. NAME="AEN8493"
  45478. ></A
  45479. ><P
  45480. ></P
  45481. ><TABLE
  45482. BORDER="0"
  45483. BGCOLOR="#E0E0E0"
  45484. CELLPADDING="5"
  45485. ><TR
  45486. ><TD
  45487. ><PRE
  45488. CLASS="programlisting"
  45489. >fruits[a] = orange
  45490. fruits[d] = lemon
  45491. fruits[b] = banana
  45492. fruits[c] = apple</PRE
  45493. ></TD
  45494. ></TR
  45495. ></TABLE
  45496. ><P
  45497. ></P
  45498. ></DIV
  45499. >
  45500.     </P
  45501. ><P
  45502. >      Ovoce bylo sestupn∞ set°φd∞no podle abecedy, a indexy asociovanΘ s
  45503.      jednotliv²mi prvky byly zachovßny.
  45504.     </P
  45505. ><P
  45506. >      Chovßnφ t°φd∞nφ m∙╛ete upravit pomocφ volitelnΘho argumentu
  45507.      <TT
  45508. CLASS="parameter"
  45509. ><I
  45510. >sort_flags</I
  45511. ></TT
  45512. >, detaily viz <A
  45513. HREF="#function.sort"
  45514. ><B
  45515. CLASS="function"
  45516. >sort()</B
  45517. ></A
  45518. >.
  45519.     </P
  45520. ><P
  45521. >      Viz takΘ: <A
  45522. HREF="#function.asort"
  45523. ><B
  45524. CLASS="function"
  45525. >asort()</B
  45526. ></A
  45527. >,
  45528.      <A
  45529. HREF="#function.rsort"
  45530. ><B
  45531. CLASS="function"
  45532. >rsort()</B
  45533. ></A
  45534. >,
  45535.      <A
  45536. HREF="#function.ksort"
  45537. ><B
  45538. CLASS="function"
  45539. >ksort()</B
  45540. ></A
  45541. > a
  45542.      <A
  45543. HREF="#function.sort"
  45544. ><B
  45545. CLASS="function"
  45546. >sort()</B
  45547. ></A
  45548. >.
  45549.     </P
  45550. ></DIV
  45551. ><H1
  45552. ><A
  45553. NAME="function.asort"
  45554. ></A
  45555. >asort</H1
  45556. ><DIV
  45557. CLASS="refnamediv"
  45558. ><A
  45559. NAME="AEN8505"
  45560. ></A
  45561. ><P
  45562. >    (PHP 3, PHP 4 )</P
  45563. >asort -- T°φdit pole se zachovßnφm index∙</DIV
  45564. ><DIV
  45565. CLASS="refsect1"
  45566. ><A
  45567. NAME="AEN8508"
  45568. ></A
  45569. ><H2
  45570. >Popis</H2
  45571. >void <B
  45572. CLASS="methodname"
  45573. >asort</B
  45574. > ( array array [, int sort_flags])<BR
  45575. ></BR
  45576. ><P
  45577. >      <B
  45578. CLASS="function"
  45579. >asort()</B
  45580. > t°φdφ pole tak, ╛e si indexy zachovajφ corelace
  45581.      s prvky, se kter²mi jsou spojeny. To je u╛iteΦnΘ hlavn∞ p°i t°φd∞nφ
  45582.      asociativnφch polφ, u kter²ch je po°adφ prvk∙ signifikantnφ.
  45583.      <TABLE
  45584. WIDTH="100%"
  45585. BORDER="0"
  45586. CELLPADDING="0"
  45587. CELLSPACING="0"
  45588. CLASS="EXAMPLE"
  45589. ><TR
  45590. ><TD
  45591. ><DIV
  45592. CLASS="example"
  45593. ><A
  45594. NAME="AEN8521"
  45595. ></A
  45596. ><P
  45597. ><B
  45598. >P°φklad 1. Ukßzka <B
  45599. CLASS="function"
  45600. >asort()</B
  45601. ></B
  45602. ></P
  45603. ><TABLE
  45604. BORDER="0"
  45605. BGCOLOR="#E0E0E0"
  45606. CELLPADDING="5"
  45607. ><TR
  45608. ><TD
  45609. ><PRE
  45610. CLASS="php"
  45611. >$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
  45612. asort ($fruits);
  45613. reset ($fruits);
  45614. while (list ($key, $val) = each ($fruits)) {
  45615.     echo "$key = $val\n";
  45616. }</PRE
  45617. ></TD
  45618. ></TR
  45619. ></TABLE
  45620. ></DIV
  45621. ></TD
  45622. ></TR
  45623. ></TABLE
  45624. >
  45625.     </P
  45626. ><P
  45627. >      Tato ukßzka zobrazφ:
  45628.     </P
  45629. ><P
  45630. >      <DIV
  45631. CLASS="informalexample"
  45632. ><A
  45633. NAME="AEN8527"
  45634. ></A
  45635. ><P
  45636. ></P
  45637. ><TABLE
  45638. BORDER="0"
  45639. BGCOLOR="#E0E0E0"
  45640. CELLPADDING="5"
  45641. ><TR
  45642. ><TD
  45643. ><PRE
  45644. CLASS="programlisting"
  45645. >fruits[c] = apple
  45646. fruits[b] = banana
  45647. fruits[d] = lemon
  45648. fruits[a] = orange</PRE
  45649. ></TD
  45650. ></TR
  45651. ></TABLE
  45652. ><P
  45653. ></P
  45654. ></DIV
  45655. >
  45656.     </P
  45657. ><P
  45658. >      Ovoce bylo set°φd∞no podle abecedy a indexy spojenΘ s jednotliv²mi
  45659.      prvky byly zachovßny.
  45660.     </P
  45661. ><P
  45662. >      Chovßnφ t°φd∞nφ m∙╛ete upravit pomocφ volitelnΘho argumentu
  45663.      <TT
  45664. CLASS="parameter"
  45665. ><I
  45666. >sort_flags</I
  45667. ></TT
  45668. >, detaily viz <A
  45669. HREF="#function.sort"
  45670. ><B
  45671. CLASS="function"
  45672. >sort()</B
  45673. ></A
  45674. >.
  45675.     </P
  45676. ><P
  45677. >      Viz takΘ: <A
  45678. HREF="#function.arsort"
  45679. ><B
  45680. CLASS="function"
  45681. >arsort()</B
  45682. ></A
  45683. >,
  45684.      <A
  45685. HREF="#function.rsort"
  45686. ><B
  45687. CLASS="function"
  45688. >rsort()</B
  45689. ></A
  45690. >,
  45691.      <A
  45692. HREF="#function.ksort"
  45693. ><B
  45694. CLASS="function"
  45695. >ksort()</B
  45696. ></A
  45697. > a
  45698.      <A
  45699. HREF="#function.sort"
  45700. ><B
  45701. CLASS="function"
  45702. >sort()</B
  45703. ></A
  45704. >.
  45705.     </P
  45706. ></DIV
  45707. ><H1
  45708. ><A
  45709. NAME="function.compact"
  45710. ></A
  45711. >compact</H1
  45712. ><DIV
  45713. CLASS="refnamediv"
  45714. ><A
  45715. NAME="AEN8539"
  45716. ></A
  45717. ><P
  45718. >    (PHP 4 )</P
  45719. >compact -- Vytvo°it pole obsahujφcφ prom∞nnΘ a jejich hodnoty</DIV
  45720. ><DIV
  45721. CLASS="refsect1"
  45722. ><A
  45723. NAME="AEN8542"
  45724. ></A
  45725. ><H2
  45726. >Popis</H2
  45727. >array <B
  45728. CLASS="methodname"
  45729. >compact</B
  45730. > ( mixed varname [, mixed ...])<BR
  45731. ></BR
  45732. ><P
  45733. >      <B
  45734. CLASS="function"
  45735. >compact()</B
  45736. > p°ijφmß prom∞nn² poΦet argument∙. Ka╛d²
  45737.      argument m∙╛e b²t bu∩ °et∞zec obsahujφcφ nßzev prom∞nnΘ nebo pole nßzv∙
  45738.      prom∞nn²ch. Toto pole m∙╛e takΘ obsahovat pole nßzv∙ prom∞nn²ch∙;
  45739.      <B
  45740. CLASS="function"
  45741. >compact()</B
  45742. > je rekurzivn∞ zpracuje.
  45743.     </P
  45744. ><P
  45745. >      Pro ka╛d² z °et∞zc∙ <B
  45746. CLASS="function"
  45747. >compact()</B
  45748. > vyhledß v aktivnφ symbolovΘ
  45749.      tabulce prom∞nnou tohoto jmΘna a p°idß ji do v²slednΘho pole tak, ╛e nßzev
  45750.      tΘto prom∞nnΘ se stane klφΦem a obsah tΘto prom∞nnΘ hodnotou tohoto klφΦe.
  45751.      StruΦn∞ °eΦeno, d∞lß prav² opak toho, co <A
  45752. HREF="#function.extract"
  45753. ><B
  45754. CLASS="function"
  45755. >extract()</B
  45756. ></A
  45757. >.
  45758.      Vracφ pole obsahujφcφ v╣echny tyto prom∞nnΘ.
  45759.     </P
  45760. ><P
  45761. >      ╪et∞zce, kterΘ neobsahujφ nßzvy platn²ch prom∞nn²ch se p°eskoΦφ.
  45762.     </P
  45763. ><P
  45764. >      <TABLE
  45765. WIDTH="100%"
  45766. BORDER="0"
  45767. CELLPADDING="0"
  45768. CELLSPACING="0"
  45769. CLASS="EXAMPLE"
  45770. ><TR
  45771. ><TD
  45772. ><DIV
  45773. CLASS="example"
  45774. ><A
  45775. NAME="AEN8561"
  45776. ></A
  45777. ><P
  45778. ><B
  45779. >P°φklad 1. Ukßzka <B
  45780. CLASS="function"
  45781. >compact()</B
  45782. ></B
  45783. ></P
  45784. ><TABLE
  45785. BORDER="0"
  45786. BGCOLOR="#E0E0E0"
  45787. CELLPADDING="5"
  45788. ><TR
  45789. ><TD
  45790. ><PRE
  45791. CLASS="php"
  45792. >$city = "San Francisco";
  45793. $state = "CA";
  45794. $event = "SIGGRAPH";
  45795.  
  45796. $location_vars = array ("city", "state");
  45797.  
  45798. $result = compact ("event", "nothing_here", $location_vars);</PRE
  45799. ></TD
  45800. ></TR
  45801. ></TABLE
  45802. ><P
  45803. >        <TT
  45804. CLASS="varname"
  45805. >$result</TT
  45806. > bude <TT
  45807. CLASS="literal"
  45808. >array ("event"
  45809.        => "SIGGRAPH", "city" => "San Francisco", "state" => "CA")</TT
  45810. >.
  45811.       </P
  45812. ></DIV
  45813. ></TD
  45814. ></TR
  45815. ></TABLE
  45816. >
  45817.     </P
  45818. ><P
  45819. >      Viz takΘ: <A
  45820. HREF="#function.extract"
  45821. ><B
  45822. CLASS="function"
  45823. >extract()</B
  45824. ></A
  45825. >.
  45826.     </P
  45827. ></DIV
  45828. ><H1
  45829. ><A
  45830. NAME="function.count"
  45831. ></A
  45832. >count</H1
  45833. ><DIV
  45834. CLASS="refnamediv"
  45835. ><A
  45836. NAME="AEN8571"
  45837. ></A
  45838. ><P
  45839. >    (PHP 3, PHP 4 )</P
  45840. >count -- SpoΦφtat prvky v prom∞nnΘ</DIV
  45841. ><DIV
  45842. CLASS="refsect1"
  45843. ><A
  45844. NAME="AEN8574"
  45845. ></A
  45846. ><H2
  45847. >Popis</H2
  45848. >int <B
  45849. CLASS="methodname"
  45850. >count</B
  45851. > ( mixed var)<BR
  45852. ></BR
  45853. ><P
  45854. >      Vracφ poΦet prvk∙ v <TT
  45855. CLASS="parameter"
  45856. ><I
  45857. >var</I
  45858. ></TT
  45859. >, kterß je typicky pole
  45860.      (jeliko╛ v╣echno ostatnφ mß jeden prvek).
  45861.     </P
  45862. ><P
  45863. >      Vracφ <TT
  45864. CLASS="literal"
  45865. >1</TT
  45866. >, pokud <TT
  45867. CLASS="parameter"
  45868. ><I
  45869. >var</I
  45870. ></TT
  45871. > nenφ pole.
  45872.     </P
  45873. ><P
  45874. >      Vracφ <TT
  45875. CLASS="literal"
  45876. >0</TT
  45877. >, pokud <TT
  45878. CLASS="parameter"
  45879. ><I
  45880. >var</I
  45881. ></TT
  45882. > nenφ
  45883.      inicializovßna.
  45884.      <DIV
  45885. CLASS="warning"
  45886. ><P
  45887. ></P
  45888. ><TABLE
  45889. CLASS="warning"
  45890. BORDER="1"
  45891. WIDTH="100%"
  45892. ><TR
  45893. ><TD
  45894. ALIGN="CENTER"
  45895. ><B
  45896. >Varovßnφ</B
  45897. ></TD
  45898. ></TR
  45899. ><TR
  45900. ><TD
  45901. ALIGN="LEFT"
  45902. ><P
  45903. >        <B
  45904. CLASS="function"
  45905. >count()</B
  45906. > vracφ <TT
  45907. CLASS="literal"
  45908. >0</TT
  45909. > pro prom∞nnΘ,
  45910.        kterΘ nejsou inicializovßny, ale vracφ takΘ <TT
  45911. CLASS="literal"
  45912. >0</TT
  45913. > pro
  45914.        prom∞nnΘ, kterΘ obsahujφ prßzdnΘ pole. Pokud pot°ebujete zjistit, jestli
  45915.        dotyΦnß prom∞nnß existuje, pou╛ijte <A
  45916. HREF="#function.isset"
  45917. ><B
  45918. CLASS="function"
  45919. >isset()</B
  45920. ></A
  45921. >.
  45922.       </P
  45923. ></TD
  45924. ></TR
  45925. ></TABLE
  45926. ></DIV
  45927. >
  45928.     </P
  45929. ><P
  45930. >      <TABLE
  45931. WIDTH="100%"
  45932. BORDER="0"
  45933. CELLPADDING="0"
  45934. CELLSPACING="0"
  45935. CLASS="EXAMPLE"
  45936. ><TR
  45937. ><TD
  45938. ><DIV
  45939. CLASS="example"
  45940. ><A
  45941. NAME="AEN8597"
  45942. ></A
  45943. ><P
  45944. ><B
  45945. >P°φklad 1. Ukßzka <B
  45946. CLASS="function"
  45947. >count()</B
  45948. ></B
  45949. ></P
  45950. ><TABLE
  45951. BORDER="0"
  45952. BGCOLOR="#E0E0E0"
  45953. CELLPADDING="5"
  45954. ><TR
  45955. ><TD
  45956. ><PRE
  45957. CLASS="php"
  45958. >$a[0] = 1;
  45959. $a[1] = 3;
  45960. $a[2] = 5;
  45961. $result = count ($a);
  45962. //$result == 3</PRE
  45963. ></TD
  45964. ></TR
  45965. ></TABLE
  45966. ></DIV
  45967. ></TD
  45968. ></TR
  45969. ></TABLE
  45970. >
  45971.     </P
  45972. ><P
  45973. >      Viz takΘ: <A
  45974. HREF="#function.sizeof"
  45975. ><B
  45976. CLASS="function"
  45977. >sizeof()</B
  45978. ></A
  45979. >,
  45980.      <A
  45981. HREF="#function.isset"
  45982. ><B
  45983. CLASS="function"
  45984. >isset()</B
  45985. ></A
  45986. > a
  45987.      <A
  45988. HREF="#function.is-array"
  45989. ><B
  45990. CLASS="function"
  45991. >is_array()</B
  45992. ></A
  45993. >.
  45994.     </P
  45995. ></DIV
  45996. ><H1
  45997. ><A
  45998. NAME="function.current"
  45999. ></A
  46000. >current</H1
  46001. ><DIV
  46002. CLASS="refnamediv"
  46003. ><A
  46004. NAME="AEN8606"
  46005. ></A
  46006. ><P
  46007. >    (PHP 3, PHP 4 )</P
  46008. >current -- Vrßtit souΦasn² prvek pole</DIV
  46009. ><DIV
  46010. CLASS="refsect1"
  46011. ><A
  46012. NAME="AEN8609"
  46013. ></A
  46014. ><H2
  46015. >Popis</H2
  46016. >mixed <B
  46017. CLASS="methodname"
  46018. >current</B
  46019. > ( array array)<BR
  46020. ></BR
  46021. ><P
  46022. >      Ka╛dΘ pole mß vnit°nφ ukazatel na jeho "souΦasny" prvek, kter² se
  46023.      inicializuje  na prvnφ prvek vlo╛en² do tohoto pole.
  46024.     </P
  46025. ><P
  46026. >      <B
  46027. CLASS="function"
  46028. >current()</B
  46029. > vracφ prvek, na kter² tento internφ ukazatel
  46030.      prßv∞ ukazuje. Nijak tento ukazatel nem∞nφ. Pokud teto vnit°nφ ukazatel
  46031.      ukazuje za konec seznamu prvk∙, <B
  46032. CLASS="function"
  46033. >current()</B
  46034. > returns
  46035.      <TT
  46036. CLASS="constant"
  46037. ><B
  46038. >FALSE</B
  46039. ></TT
  46040. >.
  46041.      <DIV
  46042. CLASS="warning"
  46043. ><P
  46044. ></P
  46045. ><TABLE
  46046. CLASS="warning"
  46047. BORDER="1"
  46048. WIDTH="100%"
  46049. ><TR
  46050. ><TD
  46051. ALIGN="CENTER"
  46052. ><B
  46053. >Varovßnφ</B
  46054. ></TD
  46055. ></TR
  46056. ><TR
  46057. ><TD
  46058. ALIGN="LEFT"
  46059. ><P
  46060. >        Pokud toto pole obsahuje prßzdnΘ prvky (0 nebo "", prßzdn² °et∞zec), tato
  46061.        funkce pro tyto prvky takΘ vrßtφ <TT
  46062. CLASS="constant"
  46063. ><B
  46064. >FALSE</B
  46065. ></TT
  46066. >. Je proto
  46067.        nemo╛nΘ urΦit pomocφ <B
  46068. CLASS="function"
  46069. >current()</B
  46070. >, jestli jste opravdu na
  46071.        konci pole.
  46072.        To properly traverse an array that may contain empty elements, use the
  46073.        <A
  46074. HREF="#function.each"
  46075. ><B
  46076. CLASS="function"
  46077. >each()</B
  46078. ></A
  46079. > function.
  46080.       </P
  46081. ></TD
  46082. ></TR
  46083. ></TABLE
  46084. ></DIV
  46085. >
  46086.     </P
  46087. ><P
  46088. >      Viz takΘ: <A
  46089. HREF="#function.end"
  46090. ><B
  46091. CLASS="function"
  46092. >end()</B
  46093. ></A
  46094. >,
  46095.      <A
  46096. HREF="#function.next"
  46097. ><B
  46098. CLASS="function"
  46099. >next()</B
  46100. ></A
  46101. >,
  46102.      <A
  46103. HREF="#function.prev"
  46104. ><B
  46105. CLASS="function"
  46106. >prev()</B
  46107. ></A
  46108. > a
  46109.      <A
  46110. HREF="#function.reset"
  46111. ><B
  46112. CLASS="function"
  46113. >reset()</B
  46114. ></A
  46115. >.
  46116.     </P
  46117. ></DIV
  46118. ><H1
  46119. ><A
  46120. NAME="function.each"
  46121. ></A
  46122. >each</H1
  46123. ><DIV
  46124. CLASS="refnamediv"
  46125. ><A
  46126. NAME="AEN8633"
  46127. ></A
  46128. ><P
  46129. >    (PHP 3, PHP 4 )</P
  46130. >each -- 
  46131.      Vracφ dal╣φ klφΦ/hodnota pßr z pole
  46132.     </DIV
  46133. ><DIV
  46134. CLASS="refsect1"
  46135. ><A
  46136. NAME="AEN8636"
  46137. ></A
  46138. ><H2
  46139. >Popis</H2
  46140. >array <B
  46141. CLASS="methodname"
  46142. >each</B
  46143. > ( array array)<BR
  46144. ></BR
  46145. ><P
  46146. >      Vracφ souΦasn² klφΦ/hodnota pßr z pole <TT
  46147. CLASS="parameter"
  46148. ><I
  46149. >array</I
  46150. ></TT
  46151. > a posune
  46152.      internφ ukazatel pole. Tento pßr se vracφ jako pole Φty° prvk∙ s klφΦi
  46153.      <SPAN
  46154. CLASS="emphasis"
  46155. ><I
  46156. CLASS="emphasis"
  46157. >0</I
  46158. ></SPAN
  46159. >, <SPAN
  46160. CLASS="emphasis"
  46161. ><I
  46162. CLASS="emphasis"
  46163. >1</I
  46164. ></SPAN
  46165. >,
  46166.      <SPAN
  46167. CLASS="emphasis"
  46168. ><I
  46169. CLASS="emphasis"
  46170. >key</I
  46171. ></SPAN
  46172. > a
  46173.      <SPAN
  46174. CLASS="emphasis"
  46175. ><I
  46176. CLASS="emphasis"
  46177. >value</I
  46178. ></SPAN
  46179. >. Prvky <SPAN
  46180. CLASS="emphasis"
  46181. ><I
  46182. CLASS="emphasis"
  46183. >0</I
  46184. ></SPAN
  46185. > a
  46186.      <SPAN
  46187. CLASS="emphasis"
  46188. ><I
  46189. CLASS="emphasis"
  46190. >key</I
  46191. ></SPAN
  46192. > obsahujφ nßzev klφΦe tohoto prvku pole a
  46193.      <SPAN
  46194. CLASS="emphasis"
  46195. ><I
  46196. CLASS="emphasis"
  46197. >1</I
  46198. ></SPAN
  46199. > a <SPAN
  46200. CLASS="emphasis"
  46201. ><I
  46202. CLASS="emphasis"
  46203. >value</I
  46204. ></SPAN
  46205. > obsahujφ hodnotu.
  46206.     </P
  46207. ><P
  46208. >      Pokud internφ ukazatel pole ukazuje za konec tohoto pole,
  46209.      <B
  46210. CLASS="function"
  46211. >each()</B
  46212. > vracφ <TT
  46213. CLASS="constant"
  46214. ><B
  46215. >FALSE</B
  46216. ></TT
  46217. >.
  46218.     </P
  46219. ><P
  46220. >      <TABLE
  46221. WIDTH="100%"
  46222. BORDER="0"
  46223. CELLPADDING="0"
  46224. CELLSPACING="0"
  46225. CLASS="EXAMPLE"
  46226. ><TR
  46227. ><TD
  46228. ><DIV
  46229. CLASS="example"
  46230. ><A
  46231. NAME="AEN8658"
  46232. ></A
  46233. ><P
  46234. ><B
  46235. >P°φklad 1. Ukßzky <B
  46236. CLASS="function"
  46237. >each()</B
  46238. ></B
  46239. ></P
  46240. ><TABLE
  46241. BORDER="0"
  46242. BGCOLOR="#E0E0E0"
  46243. CELLPADDING="5"
  46244. ><TR
  46245. ><TD
  46246. ><PRE
  46247. CLASS="php"
  46248. >$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
  46249. $bar = each ($foo);</PRE
  46250. ></TD
  46251. ></TR
  46252. ></TABLE
  46253. ><P
  46254. >        <TT
  46255. CLASS="varname"
  46256. >$bar</TT
  46257. > te∩ obsahuje nßsledujφcφ klφΦ/hodnota pßry:
  46258.        <P
  46259. ></P
  46260. ><UL
  46261. COMPACT="COMPACT"
  46262. ><LI
  46263. ><SPAN
  46264. >0 => 0</SPAN
  46265. ></LI
  46266. ><LI
  46267. ><SPAN
  46268. >1 => 'bob'</SPAN
  46269. ></LI
  46270. ><LI
  46271. ><SPAN
  46272. >key => 0</SPAN
  46273. ></LI
  46274. ><LI
  46275. ><SPAN
  46276. >value => 'bob'</SPAN
  46277. ></LI
  46278. ></UL
  46279. >
  46280.        <TABLE
  46281. BORDER="0"
  46282. BGCOLOR="#E0E0E0"
  46283. CELLPADDING="5"
  46284. ><TR
  46285. ><TD
  46286. ><PRE
  46287. CLASS="php"
  46288. >$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
  46289. $bar = each ($foo);</PRE
  46290. ></TD
  46291. ></TR
  46292. ></TABLE
  46293. >
  46294.       </P
  46295. ><P
  46296. >        <TT
  46297. CLASS="varname"
  46298. >$bar</TT
  46299. > te∩ obsahuje nßsledujφcφ klφΦ/hodnota pßry:
  46300.        <P
  46301. ></P
  46302. ><UL
  46303. COMPACT="COMPACT"
  46304. ><LI
  46305. ><SPAN
  46306. >0 => 'Robert'</SPAN
  46307. ></LI
  46308. ><LI
  46309. ><SPAN
  46310. >1 => 'Bob'</SPAN
  46311. ></LI
  46312. ><LI
  46313. ><SPAN
  46314. >key => 'Robert'</SPAN
  46315. ></LI
  46316. ><LI
  46317. ><SPAN
  46318. >value => 'Bob'</SPAN
  46319. ></LI
  46320. ></UL
  46321. >
  46322.       </P
  46323. ></DIV
  46324. ></TD
  46325. ></TR
  46326. ></TABLE
  46327. >
  46328.     </P
  46329. ><P
  46330. >      <B
  46331. CLASS="function"
  46332. >each()</B
  46333. > se v∞t╣inou pou╛φva s
  46334.      <A
  46335. HREF="#function.list"
  46336. ><B
  46337. CLASS="function"
  46338. >list()</B
  46339. ></A
  46340. > k pr∙chodu polem, nap°.
  46341.      <TT
  46342. CLASS="varname"
  46343. >$HTTP_POST_VARS</TT
  46344. >:
  46345.      <TABLE
  46346. WIDTH="100%"
  46347. BORDER="0"
  46348. CELLPADDING="0"
  46349. CELLSPACING="0"
  46350. CLASS="EXAMPLE"
  46351. ><TR
  46352. ><TD
  46353. ><DIV
  46354. CLASS="example"
  46355. ><A
  46356. NAME="AEN8689"
  46357. ></A
  46358. ><P
  46359. ><B
  46360. >P°φklad 2. 
  46361.        Pr∙chod <TT
  46362. CLASS="varname"
  46363. >$HTTP_POST_VARS</TT
  46364. > pomocφ
  46365.        <B
  46366. CLASS="function"
  46367. >each()</B
  46368. >
  46369.       </B
  46370. ></P
  46371. ><TABLE
  46372. BORDER="0"
  46373. BGCOLOR="#E0E0E0"
  46374. CELLPADDING="5"
  46375. ><TR
  46376. ><TD
  46377. ><PRE
  46378. CLASS="php"
  46379. >echo "Hodnoty odeslanΘ metodou POST:<br>";
  46380. reset ($HTTP_POST_VARS);
  46381. while (list ($key, $val) = each ($HTTP_POST_VARS)) {
  46382.     echo "$key => $val<br>";
  46383. }</PRE
  46384. ></TD
  46385. ></TR
  46386. ></TABLE
  46387. ></DIV
  46388. ></TD
  46389. ></TR
  46390. ></TABLE
  46391. >
  46392.     </P
  46393. ><P
  46394. >      PotΘ, co prob∞hne <B
  46395. CLASS="function"
  46396. >each()</B
  46397. >, se internφ ukazatel pole posune
  46398.      na dal╣φ prvek pole nebo z∙stane na poslednφm prvku pole, pokud dojde na
  46399.      konec.
  46400.     </P
  46401. ><P
  46402. >      Viz takΘ: <A
  46403. HREF="#function.key"
  46404. ><B
  46405. CLASS="function"
  46406. >key()</B
  46407. ></A
  46408. >,
  46409.      <A
  46410. HREF="#function.list"
  46411. ><B
  46412. CLASS="function"
  46413. >list()</B
  46414. ></A
  46415. >,
  46416.      <A
  46417. HREF="#function.current"
  46418. ><B
  46419. CLASS="function"
  46420. >current()</B
  46421. ></A
  46422. >,
  46423.      <A
  46424. HREF="#function.reset"
  46425. ><B
  46426. CLASS="function"
  46427. >reset()</B
  46428. ></A
  46429. >,
  46430.      <A
  46431. HREF="#function.next"
  46432. ><B
  46433. CLASS="function"
  46434. >next()</B
  46435. ></A
  46436. > a
  46437.      <A
  46438. HREF="#function.prev"
  46439. ><B
  46440. CLASS="function"
  46441. >prev()</B
  46442. ></A
  46443. >.
  46444.     </P
  46445. ></DIV
  46446. ><H1
  46447. ><A
  46448. NAME="function.end"
  46449. ></A
  46450. >end</H1
  46451. ><DIV
  46452. CLASS="refnamediv"
  46453. ><A
  46454. NAME="AEN8704"
  46455. ></A
  46456. ><P
  46457. >    (PHP 3, PHP 4 )</P
  46458. >end -- 
  46459.      Nastavit vnit°nφ ukazatel pole na jeho poslednφ prvek
  46460.     </DIV
  46461. ><DIV
  46462. CLASS="refsect1"
  46463. ><A
  46464. NAME="AEN8707"
  46465. ></A
  46466. ><H2
  46467. >Popis</H2
  46468. >mixed <B
  46469. CLASS="methodname"
  46470. >end</B
  46471. > ( array array)<BR
  46472. ></BR
  46473. ><P
  46474. >      <B
  46475. CLASS="function"
  46476. >end()</B
  46477. > posune vnit°nφ ukazatel pole
  46478.      <TT
  46479. CLASS="parameter"
  46480. ><I
  46481. >array</I
  46482. ></TT
  46483. > na jeho poslednφ prvek a vracφ tento prvek.
  46484.     </P
  46485. ><P
  46486. >      Viz takΘ: <A
  46487. HREF="#function.current"
  46488. ><B
  46489. CLASS="function"
  46490. >current()</B
  46491. ></A
  46492. >,
  46493.      <A
  46494. HREF="#function.each"
  46495. ><B
  46496. CLASS="function"
  46497. >each()</B
  46498. ></A
  46499. >,
  46500.      <B
  46501. CLASS="function"
  46502. >end()</B
  46503. >,
  46504.      <A
  46505. HREF="#function.next"
  46506. ><B
  46507. CLASS="function"
  46508. >next()</B
  46509. ></A
  46510. > a
  46511.      <A
  46512. HREF="#function.reset"
  46513. ><B
  46514. CLASS="function"
  46515. >reset()</B
  46516. ></A
  46517. >.
  46518.     </P
  46519. ></DIV
  46520. ><H1
  46521. ><A
  46522. NAME="function.extract"
  46523. ></A
  46524. >extract</H1
  46525. ><DIV
  46526. CLASS="refnamediv"
  46527. ><A
  46528. NAME="AEN8725"
  46529. ></A
  46530. ><P
  46531. >    (PHP 3>= 3.0.7, PHP 4 )</P
  46532. >extract -- Importovat prom∞nnΘ z pole do symbolovΘ tabulky</DIV
  46533. ><DIV
  46534. CLASS="refsect1"
  46535. ><A
  46536. NAME="AEN8728"
  46537. ></A
  46538. ><H2
  46539. >Popis</H2
  46540. >int <B
  46541. CLASS="methodname"
  46542. >extract</B
  46543. > ( array var_array [, int extract_type [, string prefix]])<BR
  46544. ></BR
  46545. ><P
  46546. >      Tato funkce se pou╛φvß k importu prom∞nn²ch z pole do aktivnφ symbolovΘ
  46547.      tabulky. P°ijφmß pole <TT
  46548. CLASS="parameter"
  46549. ><I
  46550. >var_array</I
  46551. ></TT
  46552. >; z klφΦ∙ vytvß°φ
  46553.      nßzvy prom∞nn²ch a z hodnot hodnoty t∞chto prom∞nn²ch. Vytvß°φ jednu
  46554.      prom∞nnou z ka╛dΘho klφΦ/hodnota pßru (s ohledem na argumenty
  46555.      <TT
  46556. CLASS="parameter"
  46557. ><I
  46558. >extract_type</I
  46559. ></TT
  46560. > a <TT
  46561. CLASS="parameter"
  46562. ><I
  46563. >prefix</I
  46564. ></TT
  46565. >).
  46566.     </P
  46567. ><DIV
  46568. CLASS="note"
  46569. ><BLOCKQUOTE
  46570. CLASS="note"
  46571. ><P
  46572. ><B
  46573. >Poznßmka: </B
  46574. >
  46575.       Od PHP 4.0.5 tato funkce vracφ poΦet extrahovan²ch prom∞nn²ch.
  46576.      </P
  46577. ></BLOCKQUOTE
  46578. ></DIV
  46579. ><P
  46580. >      <B
  46581. CLASS="function"
  46582. >extract()</B
  46583. > ov∞°uje, jestli v╣echny klφΦe tvo°φ platnΘ
  46584.      nßzvy prom∞nn²ch, a takΘ jestli nekolidujφ s prom∞nn²mi existujφcφmi v
  46585.      aktivnφ symbolovΘ tabulce. Zp∙sob, jak²m se naklßdß s neplatn²mi/numerick²mi
  46586.      klφΦi a kolizemi zßvisφ na <TT
  46587. CLASS="parameter"
  46588. ><I
  46589. >extract_type</I
  46590. ></TT
  46591. >. Ten m∙╛e
  46592.      mφt jednu z nßsledujφcφch hodnot.
  46593.      <P
  46594. ></P
  46595. ><DIV
  46596. CLASS="variablelist"
  46597. ><DL
  46598. ><DT
  46599. >EXTR_OVERWRITE</DT
  46600. ><DD
  46601. ><P
  46602. >          Pokud existuje kolize, p°epsat existujφcφ prom∞nnou.
  46603.         </P
  46604. ></DD
  46605. ><DT
  46606. >EXTR_SKIP</DT
  46607. ><DD
  46608. ><P
  46609. >          Pokud existuje kolize, nep°epsat existujφcφ prom∞nnou.
  46610.         </P
  46611. ></DD
  46612. ><DT
  46613. >EXTR_PREFIX_SAME</DT
  46614. ><DD
  46615. ><P
  46616. >          Pokud existuje kolize, p°ed°adit p°ed nßzev novΘ prom∞nnΘ
  46617.         <TT
  46618. CLASS="parameter"
  46619. ><I
  46620. >prefix</I
  46621. ></TT
  46622. >.
  46623.         </P
  46624. ></DD
  46625. ><DT
  46626. >EXTR_PREFIX_ALL</DT
  46627. ><DD
  46628. ><P
  46629. >          Opat°it prefixem <TT
  46630. CLASS="parameter"
  46631. ><I
  46632. >prefix</I
  46633. ></TT
  46634. > v╣echny nßzvy prom∞nn²ch.
  46635.          Od PHP 4.0.5 toto zahrnuje i ΦφselnΘ indexy.
  46636.         </P
  46637. ></DD
  46638. ><DT
  46639. >EXTR_PREFIX_INVALID</DT
  46640. ><DD
  46641. ><P
  46642. >          Prefixem <TT
  46643. CLASS="parameter"
  46644. ><I
  46645. >prefix</I
  46646. ></TT
  46647. > opat°it pouze neplatnΘ/ΦφselnΘ
  46648.          nßzvy prom∞nn²ch. Tento p°φznak byl p°idßn v PHP 4.0.5.
  46649.         </P
  46650. ></DD
  46651. ></DL
  46652. ></DIV
  46653. >
  46654.     </P
  46655. ><P
  46656. >      Defaultnφ <TT
  46657. CLASS="parameter"
  46658. ><I
  46659. >extract_type</I
  46660. ></TT
  46661. > je EXTR_OVERWRITE.
  46662.     </P
  46663. ><P
  46664. >      Pozn.: <TT
  46665. CLASS="parameter"
  46666. ><I
  46667. >prefix</I
  46668. ></TT
  46669. > se vy╛aduje pouze pokud je
  46670.      <TT
  46671. CLASS="parameter"
  46672. ><I
  46673. >extract_type</I
  46674. ></TT
  46675. > EXTR_PREFIX_SAME, EXTR_PREFIX_ALL nebo
  46676.      EXTR_PREFIX_INVALID. Pokud v²sledn² nßzev (vΦ. prefixu) nenφ platn² nßzev
  46677.      prom∞nnΘ, nenaimportuje se do symbolovΘ tabulky.
  46678.     </P
  46679. ><P
  46680. >      <B
  46681. CLASS="function"
  46682. >extract()</B
  46683. > vracφ poΦet prom∞nn²ch ·sp∞╣n∞ naimportovan²ch
  46684.      do symbolovΘ tabulky.
  46685.     </P
  46686. ><P
  46687. >      Mo╛nΘ vyu╛itφ <B
  46688. CLASS="function"
  46689. >extract()</B
  46690. > je import prom∞nn²ch do
  46691.      symbolovΘ tabulky z asociativnφho pole vrßcenΘho
  46692.      <A
  46693. HREF="#function.wddx-deserialize"
  46694. ><B
  46695. CLASS="function"
  46696. >wddx_deserialize()</B
  46697. ></A
  46698. >.
  46699.     </P
  46700. ><P
  46701. >      <TABLE
  46702. WIDTH="100%"
  46703. BORDER="0"
  46704. CELLPADDING="0"
  46705. CELLSPACING="0"
  46706. CLASS="EXAMPLE"
  46707. ><TR
  46708. ><TD
  46709. ><DIV
  46710. CLASS="example"
  46711. ><A
  46712. NAME="AEN8786"
  46713. ></A
  46714. ><P
  46715. ><B
  46716. >P°φklad 1. Ukßzka <B
  46717. CLASS="function"
  46718. >extract()</B
  46719. ></B
  46720. ></P
  46721. ><TABLE
  46722. BORDER="0"
  46723. BGCOLOR="#E0E0E0"
  46724. CELLPADDING="5"
  46725. ><TR
  46726. ><TD
  46727. ><PRE
  46728. CLASS="php"
  46729. ><?php
  46730.  
  46731. /* P°edpoklßdejme, ╛e $var_array je pole vrßcenΘ
  46732.    z wddx_deserialize */
  46733.  
  46734. $size = "large";
  46735. $var_array = array ("color" => "blue",
  46736.                     "size"  => "medium",
  46737.                     "shape" => "sphere");
  46738. extract ($var_array, EXTR_PREFIX_SAME, "wddx");
  46739.  
  46740. print "$color, $size, $shape, $wddx_size\n";
  46741.  
  46742. ?></PRE
  46743. ></TD
  46744. ></TR
  46745. ></TABLE
  46746. ></DIV
  46747. ></TD
  46748. ></TR
  46749. ></TABLE
  46750. >
  46751.     </P
  46752. ><P
  46753. >      V²╣e uvedenß ukßzka vytiskne:
  46754.      <TABLE
  46755. BORDER="0"
  46756. BGCOLOR="#E0E0E0"
  46757. CELLPADDING="5"
  46758. ><TR
  46759. ><TD
  46760. ><PRE
  46761. CLASS="programlisting"
  46762. >blue, large, sphere, medium</PRE
  46763. ></TD
  46764. ></TR
  46765. ></TABLE
  46766. >
  46767.     </P
  46768. ><P
  46769. >      <TT
  46770. CLASS="varname"
  46771. >$size</TT
  46772. > se nep°epsala, proto╛e bylo specifikovßno
  46773.      EXTR_PREFIX_SAME, tudφ╛ se vytvo°ila prom∞nnß <TT
  46774. CLASS="varname"
  46775. >$wddx_size</TT
  46776. >.
  46777.      Pokud by bylo zadßno EXTR_SKIP, nevytvo°ila by se ani
  46778.      <TT
  46779. CLASS="varname"
  46780. >$wddx_size</TT
  46781. >.
  46782.      EXTR_OVERWRITE by zp∙sobilo p°epsßnφ hodnoty <TT
  46783. CLASS="varname"
  46784. >$size</TT
  46785. > na
  46786.      "medium", a EXTR_PREFIX_ALL by vytvo°ilo novΘ prom∞nnΘ pojmenovanΘ
  46787.      <TT
  46788. CLASS="varname"
  46789. >$wddx_color</TT
  46790. >,
  46791.      <TT
  46792. CLASS="varname"
  46793. >$wddx_size</TT
  46794. > a
  46795.      <TT
  46796. CLASS="varname"
  46797. >$wddx_shape</TT
  46798. >.
  46799.     </P
  46800. ><P
  46801. >      U PHP verzφ ni╛╣φch ne╛ 4.0.5 musφte pou╛φt asociativnφ pole.
  46802.     </P
  46803. ><P
  46804. >      Viz takΘ: <A
  46805. HREF="#function.compact"
  46806. ><B
  46807. CLASS="function"
  46808. >compact()</B
  46809. ></A
  46810. >.
  46811.     </P
  46812. ></DIV
  46813. ><H1
  46814. ><A
  46815. NAME="function.in-array"
  46816. ></A
  46817. >in_array</H1
  46818. ><DIV
  46819. CLASS="refnamediv"
  46820. ><A
  46821. NAME="AEN8804"
  46822. ></A
  46823. ><P
  46824. >    (PHP 4 )</P
  46825. >in_array -- Vrßtit <TT
  46826. CLASS="constant"
  46827. ><B
  46828. >TRUE</B
  46829. ></TT
  46830. >, pokud v poli existuje danß hodnota</DIV
  46831. ><DIV
  46832. CLASS="refsect1"
  46833. ><A
  46834. NAME="AEN8808"
  46835. ></A
  46836. ><H2
  46837. >Popis</H2
  46838. >bool <B
  46839. CLASS="methodname"
  46840. >in_array</B
  46841. > ( mixed needle, array haystack, bool strict)<BR
  46842. ></BR
  46843. ><P
  46844. >      Hledß v <TT
  46845. CLASS="parameter"
  46846. ><I
  46847. >haystack</I
  46848. ></TT
  46849. > <TT
  46850. CLASS="parameter"
  46851. ><I
  46852. >needle</I
  46853. ></TT
  46854. >
  46855.      a pokud ji najde, vracφ <TT
  46856. CLASS="constant"
  46857. ><B
  46858. >TRUE</B
  46859. ></TT
  46860. >, jinak
  46861.      <TT
  46862. CLASS="constant"
  46863. ><B
  46864. >FALSE</B
  46865. ></TT
  46866. >.
  46867.     </P
  46868. ><P
  46869. >      Pokud je t°etφ argument <TT
  46870. CLASS="parameter"
  46871. ><I
  46872. >strict</I
  46873. ></TT
  46874. > <TT
  46875. CLASS="constant"
  46876. ><B
  46877. >TRUE</B
  46878. ></TT
  46879. >,
  46880.      <B
  46881. CLASS="function"
  46882. >in_array()</B
  46883. > takΘ kontroluje typ <TT
  46884. CLASS="parameter"
  46885. ><I
  46886. >needle</I
  46887. ></TT
  46888. >
  46889.      v <TT
  46890. CLASS="parameter"
  46891. ><I
  46892. >haystack</I
  46893. ></TT
  46894. >.
  46895.     </P
  46896. ><P
  46897. >      <TABLE
  46898. WIDTH="100%"
  46899. BORDER="0"
  46900. CELLPADDING="0"
  46901. CELLSPACING="0"
  46902. CLASS="EXAMPLE"
  46903. ><TR
  46904. ><TD
  46905. ><DIV
  46906. CLASS="example"
  46907. ><A
  46908. NAME="AEN8834"
  46909. ></A
  46910. ><P
  46911. ><B
  46912. >P°φklad 1. Ukßzka <B
  46913. CLASS="function"
  46914. >in_array()</B
  46915. ></B
  46916. ></P
  46917. ><TABLE
  46918. BORDER="0"
  46919. BGCOLOR="#E0E0E0"
  46920. CELLPADDING="5"
  46921. ><TR
  46922. ><TD
  46923. ><PRE
  46924. CLASS="php"
  46925. >$os = array ("Mac", "NT", "Irix", "Linux");
  46926. if (in_array ("Irix", $os)){
  46927.     print "Got Irix";
  46928.     }</PRE
  46929. ></TD
  46930. ></TR
  46931. ></TABLE
  46932. ></DIV
  46933. ></TD
  46934. ></TR
  46935. ></TABLE
  46936. >
  46937.     </P
  46938. ><P
  46939. >      <TABLE
  46940. WIDTH="100%"
  46941. BORDER="0"
  46942. CELLPADDING="0"
  46943. CELLSPACING="0"
  46944. CLASS="EXAMPLE"
  46945. ><TR
  46946. ><TD
  46947. ><DIV
  46948. CLASS="example"
  46949. ><A
  46950. NAME="AEN8839"
  46951. ></A
  46952. ><P
  46953. ><B
  46954. >P°φklad 2. Ukßzka <B
  46955. CLASS="function"
  46956. >in_array()</B
  46957. > s argumentem <TT
  46958. CLASS="parameter"
  46959. ><I
  46960. >strict</I
  46961. ></TT
  46962. ></B
  46963. ></P
  46964. ><TABLE
  46965. BORDER="0"
  46966. BGCOLOR="#E0E0E0"
  46967. CELLPADDING="5"
  46968. ><TR
  46969. ><TD
  46970. ><PRE
  46971. CLASS="php"
  46972. >// V²stup bude:
  46973.  
  46974. 1.13 found with strict check</PRE
  46975. ></TD
  46976. ></TR
  46977. ></TABLE
  46978. ></DIV
  46979. ></TD
  46980. ></TR
  46981. ></TABLE
  46982. >
  46983.     </P
  46984. ></DIV
  46985. ><H1
  46986. ><A
  46987. NAME="function.key"
  46988. ></A
  46989. >key</H1
  46990. ><DIV
  46991. CLASS="refnamediv"
  46992. ><A
  46993. NAME="AEN8845"
  46994. ></A
  46995. ><P
  46996. >    (PHP 3, PHP 4 )</P
  46997. >key -- Fetch a key from an associative array</DIV
  46998. ><DIV
  46999. CLASS="refsect1"
  47000. ><A
  47001. NAME="AEN8848"
  47002. ></A
  47003. ><H2
  47004. >Popis</H2
  47005. >mixed <B
  47006. CLASS="methodname"
  47007. >key</B
  47008. > ( array array)<BR
  47009. ></BR
  47010. ><P
  47011. >      <B
  47012. CLASS="function"
  47013. >key()</B
  47014. > vracφ index souΦasnΘho prvku pole.
  47015.     </P
  47016. ><P
  47017. >      Viz takΘ: <A
  47018. HREF="#function.current"
  47019. ><B
  47020. CLASS="function"
  47021. >current()</B
  47022. ></A
  47023. > a
  47024.      <A
  47025. HREF="#function.next"
  47026. ><B
  47027. CLASS="function"
  47028. >next()</B
  47029. ></A
  47030. >.
  47031.     </P
  47032. ></DIV
  47033. ><H1
  47034. ><A
  47035. NAME="function.krsort"
  47036. ></A
  47037. >krsort</H1
  47038. ><DIV
  47039. CLASS="refnamediv"
  47040. ><A
  47041. NAME="AEN8862"
  47042. ></A
  47043. ><P
  47044. >    (PHP 3>= 3.0.13, PHP 4 )</P
  47045. >krsort -- T°φdit pole sestupn∞ podle klφΦ∙</DIV
  47046. ><DIV
  47047. CLASS="refsect1"
  47048. ><A
  47049. NAME="AEN8865"
  47050. ></A
  47051. ><H2
  47052. >Popis</H2
  47053. >int <B
  47054. CLASS="methodname"
  47055. >krsort</B
  47056. > ( array array [, int sort_flags])<BR
  47057. ></BR
  47058. ><P
  47059. >      T°φdφ pole sestupn∞ podle klφΦ∙ se zachovßnφ asociacφ index∙. To je
  47060.      u╛iteΦnΘ hlavn∞ p°i prßci s asociativnφmi poli.
  47061.      <TABLE
  47062. WIDTH="100%"
  47063. BORDER="0"
  47064. CELLPADDING="0"
  47065. CELLSPACING="0"
  47066. CLASS="EXAMPLE"
  47067. ><TR
  47068. ><TD
  47069. ><DIV
  47070. CLASS="example"
  47071. ><A
  47072. NAME="AEN8877"
  47073. ></A
  47074. ><P
  47075. ><B
  47076. >P°φklad 1. <B
  47077. CLASS="function"
  47078. >krsort()</B
  47079. > example</B
  47080. ></P
  47081. ><TABLE
  47082. BORDER="0"
  47083. BGCOLOR="#E0E0E0"
  47084. CELLPADDING="5"
  47085. ><TR
  47086. ><TD
  47087. ><PRE
  47088. CLASS="php"
  47089. >$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
  47090. krsort ($fruits);
  47091. reset ($fruits);
  47092. while (list ($key, $val) = each ($fruits)) {
  47093.     echo "$key -> $val\n";
  47094. }</PRE
  47095. ></TD
  47096. ></TR
  47097. ></TABLE
  47098. ></DIV
  47099. ></TD
  47100. ></TR
  47101. ></TABLE
  47102. >
  47103.     </P
  47104. ><P
  47105. >      Tato ukßzka vytiskne:
  47106.     </P
  47107. ><P
  47108. >      <DIV
  47109. CLASS="informalexample"
  47110. ><A
  47111. NAME="AEN8883"
  47112. ></A
  47113. ><P
  47114. ></P
  47115. ><TABLE
  47116. BORDER="0"
  47117. BGCOLOR="#E0E0E0"
  47118. CELLPADDING="5"
  47119. ><TR
  47120. ><TD
  47121. ><PRE
  47122. CLASS="programlisting"
  47123. >fruits[d] = lemon
  47124. fruits[c] = apple
  47125. fruits[b] = banana
  47126. fruits[a] = orange</PRE
  47127. ></TD
  47128. ></TR
  47129. ></TABLE
  47130. ><P
  47131. ></P
  47132. ></DIV
  47133. >
  47134.     </P
  47135. ><P
  47136. >      Vlastnosti t°φd∞nφ lze upravit pomocφ volitelnΘho argumentu
  47137.      <TT
  47138. CLASS="parameter"
  47139. ><I
  47140. >sort_flags</I
  47141. ></TT
  47142. >, detaily viz <A
  47143. HREF="#function.sort"
  47144. ><B
  47145. CLASS="function"
  47146. >sort()</B
  47147. ></A
  47148. >.
  47149.     </P
  47150. ><P
  47151. >      Viz takΘ: <A
  47152. HREF="#function.asort"
  47153. ><B
  47154. CLASS="function"
  47155. >asort()</B
  47156. ></A
  47157. >,
  47158.      <A
  47159. HREF="#function.arsort"
  47160. ><B
  47161. CLASS="function"
  47162. >arsort()</B
  47163. ></A
  47164. >,
  47165.      <A
  47166. HREF="#function.ksort"
  47167. ><B
  47168. CLASS="function"
  47169. >ksort()</B
  47170. ></A
  47171. >,
  47172.      <A
  47173. HREF="#function.sort"
  47174. ><B
  47175. CLASS="function"
  47176. >sort()</B
  47177. ></A
  47178. >,
  47179.      <A
  47180. HREF="#function.natsort"
  47181. ><B
  47182. CLASS="function"
  47183. >natsort()</B
  47184. ></A
  47185. > a
  47186.      <A
  47187. HREF="#function.rsort"
  47188. ><B
  47189. CLASS="function"
  47190. >rsort()</B
  47191. ></A
  47192. >.
  47193.     </P
  47194. ></DIV
  47195. ><H1
  47196. ><A
  47197. NAME="function.ksort"
  47198. ></A
  47199. >ksort</H1
  47200. ><DIV
  47201. CLASS="refnamediv"
  47202. ><A
  47203. NAME="AEN8896"
  47204. ></A
  47205. ><P
  47206. >    (PHP 3, PHP 4 )</P
  47207. >ksort -- T°φdit pole podle klφΦ∙</DIV
  47208. ><DIV
  47209. CLASS="refsect1"
  47210. ><A
  47211. NAME="AEN8899"
  47212. ></A
  47213. ><H2
  47214. >Popis</H2
  47215. >int <B
  47216. CLASS="methodname"
  47217. >ksort</B
  47218. > ( array array [, int sort_flags])<BR
  47219. ></BR
  47220. ><P
  47221. >      T°φdφ pole podle klφΦ∙ se zachovßnφ asociacφ index∙. To je
  47222.      u╛iteΦnΘ hlavn∞ p°i prßci s asociativnφmi poli.
  47223.      <TABLE
  47224. WIDTH="100%"
  47225. BORDER="0"
  47226. CELLPADDING="0"
  47227. CELLSPACING="0"
  47228. CLASS="EXAMPLE"
  47229. ><TR
  47230. ><TD
  47231. ><DIV
  47232. CLASS="example"
  47233. ><A
  47234. NAME="AEN8911"
  47235. ></A
  47236. ><P
  47237. ><B
  47238. >P°φklad 1. <B
  47239. CLASS="function"
  47240. >ksort()</B
  47241. > example</B
  47242. ></P
  47243. ><TABLE
  47244. BORDER="0"
  47245. BGCOLOR="#E0E0E0"
  47246. CELLPADDING="5"
  47247. ><TR
  47248. ><TD
  47249. ><PRE
  47250. CLASS="php"
  47251. >$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
  47252. ksort ($fruits);
  47253. reset ($fruits);
  47254. while (list ($key, $val) = each ($fruits)) {
  47255.     echo "$key -> $val\n";
  47256. }</PRE
  47257. ></TD
  47258. ></TR
  47259. ></TABLE
  47260. ></DIV
  47261. ></TD
  47262. ></TR
  47263. ></TABLE
  47264. >
  47265.     </P
  47266. ><P
  47267. >      Tato ukßzka vytiskne:
  47268.     </P
  47269. ><P
  47270. >      <DIV
  47271. CLASS="informalexample"
  47272. ><A
  47273. NAME="AEN8917"
  47274. ></A
  47275. ><P
  47276. ></P
  47277. ><TABLE
  47278. BORDER="0"
  47279. BGCOLOR="#E0E0E0"
  47280. CELLPADDING="5"
  47281. ><TR
  47282. ><TD
  47283. ><PRE
  47284. CLASS="programlisting"
  47285. >fruits[a] = orange
  47286. fruits[b] = banana
  47287. fruits[c] = apple
  47288. fruits[d] = lemon</PRE
  47289. ></TD
  47290. ></TR
  47291. ></TABLE
  47292. ><P
  47293. ></P
  47294. ></DIV
  47295. >
  47296.     </P
  47297. ><P
  47298. >      Vlastnosti t°φd∞nφ lze upravit pomocφ volitelnΘho argumentu
  47299.      <TT
  47300. CLASS="parameter"
  47301. ><I
  47302. >sort_flags</I
  47303. ></TT
  47304. >, detaily viz <A
  47305. HREF="#function.sort"
  47306. ><B
  47307. CLASS="function"
  47308. >sort()</B
  47309. ></A
  47310. >.
  47311.     </P
  47312. ><P
  47313. >      Viz takΘ: <A
  47314. HREF="#function.asort"
  47315. ><B
  47316. CLASS="function"
  47317. >asort()</B
  47318. ></A
  47319. >,
  47320.      <A
  47321. HREF="#function.arsort"
  47322. ><B
  47323. CLASS="function"
  47324. >arsort()</B
  47325. ></A
  47326. >,
  47327.      <A
  47328. HREF="#function.sort"
  47329. ><B
  47330. CLASS="function"
  47331. >sort()</B
  47332. ></A
  47333. >,
  47334.      <A
  47335. HREF="#function.natsort"
  47336. ><B
  47337. CLASS="function"
  47338. >natsort()</B
  47339. ></A
  47340. > a
  47341.      <A
  47342. HREF="#function.rsort"
  47343. ><B
  47344. CLASS="function"
  47345. >rsort()</B
  47346. ></A
  47347. >.
  47348.     </P
  47349. ><DIV
  47350. CLASS="note"
  47351. ><BLOCKQUOTE
  47352. CLASS="note"
  47353. ><P
  47354. ><B
  47355. >Poznßmka: </B
  47356. >
  47357.       Druh² argument byl p°idßn v PHP 4.
  47358.      </P
  47359. ></BLOCKQUOTE
  47360. ></DIV
  47361. ></DIV
  47362. ><H1
  47363. ><A
  47364. NAME="function.list"
  47365. ></A
  47366. >list</H1
  47367. ><DIV
  47368. CLASS="refnamediv"
  47369. ><A
  47370. NAME="AEN8931"
  47371. ></A
  47372. ><P
  47373. >    (PHP 3, PHP 4 )</P
  47374. >list -- P°i°adit hodnoty p°om∞nn²m jako kdyby byly polem</DIV
  47375. ><DIV
  47376. CLASS="refsect1"
  47377. ><A
  47378. NAME="AEN8934"
  47379. ></A
  47380. ><H2
  47381. >Popis</H2
  47382. >void <B
  47383. CLASS="methodname"
  47384. >list</B
  47385. > ( mixed ...)<BR
  47386. ></BR
  47387. ><P
  47388. >      Stejn∞ jako <A
  47389. HREF="#function.array"
  47390. ><B
  47391. CLASS="function"
  47392. >array()</B
  47393. ></A
  47394. >, <B
  47395. CLASS="function"
  47396. >list()</B
  47397. > vlastn∞
  47398.      nenφ funkce, ale jazykov² konstrukt. Pou╛φvß se k p°i°azenφ hodnot vφce
  47399.      prom∞nn²m v jednΘ operaci.
  47400.      <TABLE
  47401. WIDTH="100%"
  47402. BORDER="0"
  47403. CELLPADDING="0"
  47404. CELLSPACING="0"
  47405. CLASS="EXAMPLE"
  47406. ><TR
  47407. ><TD
  47408. ><DIV
  47409. CLASS="example"
  47410. ><A
  47411. NAME="AEN8945"
  47412. ></A
  47413. ><P
  47414. ><B
  47415. >P°φklad 1. Ukßzka <B
  47416. CLASS="function"
  47417. >list()</B
  47418. ></B
  47419. ></P
  47420. ><TABLE
  47421. BORDER="0"
  47422. BGCOLOR="#E0E0E0"
  47423. CELLPADDING="5"
  47424. ><TR
  47425. ><TD
  47426. ><PRE
  47427. CLASS="php"
  47428. ><table>
  47429.  <tr>
  47430.   <th>Employee name</th>
  47431.   <th>Salary</th>
  47432.  </tr>
  47433.  
  47434. <?php
  47435.  
  47436. $result = mysql ($conn, "SELECT id, name, salary FROM employees");
  47437. while (list ($id, $name, $salary) = mysql_fetch_row ($result)) {
  47438.     print (" <tr>\n".
  47439.            "  <td><a href=\"info.php3?id=$id\">$name</a></td>\n".
  47440.            "  <td>$salary</td>\n".
  47441.            " </tr>\n");
  47442. }
  47443.  
  47444. ?>
  47445.  
  47446. </table></PRE
  47447. ></TD
  47448. ></TR
  47449. ></TABLE
  47450. ></DIV
  47451. ></TD
  47452. ></TR
  47453. ></TABLE
  47454. >
  47455.     </P
  47456. ><P
  47457. >      Viz takΘ: <A
  47458. HREF="#function.each"
  47459. ><B
  47460. CLASS="function"
  47461. >each()</B
  47462. ></A
  47463. > a
  47464.      <A
  47465. HREF="#function.array"
  47466. ><B
  47467. CLASS="function"
  47468. >array()</B
  47469. ></A
  47470. >.
  47471.     </P
  47472. ></DIV
  47473. ><H1
  47474. ><A
  47475. NAME="function.natcasesort"
  47476. ></A
  47477. >natcasesort</H1
  47478. ><DIV
  47479. CLASS="refnamediv"
  47480. ><A
  47481. NAME="AEN8953"
  47482. ></A
  47483. ><P
  47484. >    (PHP 4 )</P
  47485. >natcasesort -- 
  47486.      T°φdit pole s vyu╛itφm algoritmu "p°irozenΘho t°φd∞nφ" (case-insensitive)
  47487.     </DIV
  47488. ><DIV
  47489. CLASS="refsect1"
  47490. ><A
  47491. NAME="AEN8956"
  47492. ></A
  47493. ><H2
  47494. >Popis</H2
  47495. >void <B
  47496. CLASS="methodname"
  47497. >natcasesort</B
  47498. > ( array array)<BR
  47499. ></BR
  47500. ><P
  47501. >      Tato funkce implementuje srovnßvacφ algoritmus kter² t°φdφ alfanumerickΘ
  47502.      °et∞zce stejn²m zp∙sobem jako Φlov∞k, toto se popisuje jako "p°irozenΘ
  47503.      t°φd∞nφ".
  47504.      </P
  47505. ><P
  47506. >      <B
  47507. CLASS="function"
  47508. >natcasesort()</B
  47509. > je case-insensitive verze
  47510.      <A
  47511. HREF="#function.natsort"
  47512. ><B
  47513. CLASS="function"
  47514. >natsort()</B
  47515. ></A
  47516. >.  Ukßzka rozdφlu mezi tφmto algoritmem
  47517.      a b∞╛n²m poΦφtaΦov²m t°φd∞nφm °et∞zc∙ viz <A
  47518. HREF="#function.natsort"
  47519. ><B
  47520. CLASS="function"
  47521. >natsort()</B
  47522. ></A
  47523. >.
  47524.     </P
  47525. ><P
  47526. >      Vφce informacφ viz strßnka Martina Poola <A
  47527. HREF="http://www.naturalordersort.org/"
  47528. TARGET="_top"
  47529. >Natural Order String Comparison</A
  47530. >.
  47531.     </P
  47532. ><P
  47533. >      Viz takΘ: <A
  47534. HREF="#function.sort"
  47535. ><B
  47536. CLASS="function"
  47537. >sort()</B
  47538. ></A
  47539. >,
  47540.      <A
  47541. HREF="#function.natsort"
  47542. ><B
  47543. CLASS="function"
  47544. >natsort()</B
  47545. ></A
  47546. >,
  47547.      <A
  47548. HREF="#function.strnatcmp"
  47549. ><B
  47550. CLASS="function"
  47551. >strnatcmp()</B
  47552. ></A
  47553. > and
  47554.      <A
  47555. HREF="#function.strnatcasecmp"
  47556. ><B
  47557. CLASS="function"
  47558. >strnatcasecmp()</B
  47559. ></A
  47560. >.
  47561.     </P
  47562. ></DIV
  47563. ><H1
  47564. ><A
  47565. NAME="function.natsort"
  47566. ></A
  47567. >natsort</H1
  47568. ><DIV
  47569. CLASS="refnamediv"
  47570. ><A
  47571. NAME="AEN8977"
  47572. ></A
  47573. ><P
  47574. >    (PHP 4 )</P
  47575. >natsort -- 
  47576.      T°φdit pole s vyu╛itφm algoritmu "p°irozenΘho t°φd∞nφ"
  47577.     </DIV
  47578. ><DIV
  47579. CLASS="refsect1"
  47580. ><A
  47581. NAME="AEN8980"
  47582. ></A
  47583. ><H2
  47584. >Popis</H2
  47585. >void <B
  47586. CLASS="methodname"
  47587. >natsort</B
  47588. > ( array array)<BR
  47589. ></BR
  47590. ><P
  47591. >      Tato funkce implementuje srovnßvacφ algoritmus kter² t°φdφ alfanumerickΘ
  47592.      °et∞zce stejn²m zp∙sobem jako Φlov∞k, toto se popisuje jako "p°irozenΘ
  47593.      t°φd∞nφ". Ukßzka rozdφlu m∞zi tφmto algoritmem a b∞╛n²mi poΦφtaΦov²mi
  47594.      algoritmy pro °azenφ °et∞zc∙ (nap°. <A
  47595. HREF="#function.sort"
  47596. ><B
  47597. CLASS="function"
  47598. >sort()</B
  47599. ></A
  47600. >):
  47601.     </P
  47602. ><P
  47603. >      <TABLE
  47604. WIDTH="100%"
  47605. BORDER="0"
  47606. CELLPADDING="0"
  47607. CELLSPACING="0"
  47608. CLASS="EXAMPLE"
  47609. ><TR
  47610. ><TD
  47611. ><DIV
  47612. CLASS="example"
  47613. ><A
  47614. NAME="AEN8991"
  47615. ></A
  47616. ><P
  47617. ><B
  47618. >P°φklad 1. Ukßzka <B
  47619. CLASS="function"
  47620. >natsort()</B
  47621. ></B
  47622. ></P
  47623. ><TABLE
  47624. BORDER="0"
  47625. BGCOLOR="#E0E0E0"
  47626. CELLPADDING="5"
  47627. ><TR
  47628. ><TD
  47629. ><PRE
  47630. CLASS="php"
  47631. >$array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png");
  47632.  
  47633. sort($array1);
  47634. echo "Standardnφ t°φd∞nφ\n";
  47635. print_r($array1);
  47636.  
  47637. natsort($array2);
  47638. echo "\nP°irozenΘ t°φd∞nφ\n";
  47639. print_r($array2);</PRE
  47640. ></TD
  47641. ></TR
  47642. ></TABLE
  47643. ></DIV
  47644. ></TD
  47645. ></TR
  47646. ></TABLE
  47647. >
  47648.     </P
  47649. ><P
  47650. >      V²╣e uveden² k≤d vygeneruje nßsledujφcφ v²stup:
  47651.     </P
  47652. ><P
  47653. >      <DIV
  47654. CLASS="informalexample"
  47655. ><A
  47656. NAME="AEN8997"
  47657. ></A
  47658. ><P
  47659. ></P
  47660. ><TABLE
  47661. BORDER="0"
  47662. BGCOLOR="#E0E0E0"
  47663. CELLPADDING="5"
  47664. ><TR
  47665. ><TD
  47666. ><PRE
  47667. CLASS="programlisting"
  47668. >Standardnφ t°φd∞nφ
  47669. Array
  47670. (
  47671.     [0] => img1.png
  47672.     [1] => img10.png
  47673.     [2] => img12.png
  47674.     [3] => img2.png
  47675. )
  47676.  
  47677. P°irozenΘ t°φd∞nφ
  47678. Array
  47679. (
  47680.     [3] => img1.png
  47681.     [2] => img2.png
  47682.     [1] => img10.png
  47683.     [0] => img12.png
  47684. )</PRE
  47685. ></TD
  47686. ></TR
  47687. ></TABLE
  47688. ><P
  47689. ></P
  47690. ></DIV
  47691. >
  47692.      Vφce informacφ viz strßnka Martina Poola <A
  47693. HREF="http://www.naturalordersort.org/"
  47694. TARGET="_top"
  47695. >Natural Order String Comparison</A
  47696. >.
  47697.     </P
  47698. ><P
  47699. >      Viz takΘ: <A
  47700. HREF="#function.natcasesort"
  47701. ><B
  47702. CLASS="function"
  47703. >natcasesort()</B
  47704. ></A
  47705. >,
  47706.      <A
  47707. HREF="#function.strnatcmp"
  47708. ><B
  47709. CLASS="function"
  47710. >strnatcmp()</B
  47711. ></A
  47712. > a
  47713.      <A
  47714. HREF="#function.strnatcasecmp"
  47715. ><B
  47716. CLASS="function"
  47717. >strnatcasecmp()</B
  47718. ></A
  47719. >.
  47720.     </P
  47721. ></DIV
  47722. ><H1
  47723. ><A
  47724. NAME="function.next"
  47725. ></A
  47726. >next</H1
  47727. ><DIV
  47728. CLASS="refnamediv"
  47729. ><A
  47730. NAME="AEN9005"
  47731. ></A
  47732. ><P
  47733. >    (PHP 3, PHP 4 )</P
  47734. >next -- Posunout internφ ukazatel pole</DIV
  47735. ><DIV
  47736. CLASS="refsect1"
  47737. ><A
  47738. NAME="AEN9008"
  47739. ></A
  47740. ><H2
  47741. >Popis</H2
  47742. >mixed <B
  47743. CLASS="methodname"
  47744. >next</B
  47745. > ( array array)<BR
  47746. ></BR
  47747. ><P
  47748. >      Vracφ dal╣φ prvek pole nebo <TT
  47749. CLASS="constant"
  47750. ><B
  47751. >FALSE</B
  47752. ></TT
  47753. >, pokud prvky do╣ly.
  47754.     </P
  47755. ><P
  47756. >      <B
  47757. CLASS="function"
  47758. >next()</B
  47759. > se chovß jako <A
  47760. HREF="#function.current"
  47761. ><B
  47762. CLASS="function"
  47763. >current()</B
  47764. ></A
  47765. >, s jednφm
  47766.      rozdφlem: posouvß internφ ukazatel pole o jeden prvek a vracφ prvek, na kter²
  47767.      tento ukazatel ukazuje po posunu. To znamenß, ╛e vracφ dal╣φ prvek pole
  47768.      a posouvß internφ ukazatel o jeden. Pokud by ukazatel po psunu ukazoval
  47769.      mimo pole, <B
  47770. CLASS="function"
  47771. >next()</B
  47772. > vracφ <TT
  47773. CLASS="constant"
  47774. ><B
  47775. >FALSE</B
  47776. ></TT
  47777. >.
  47778.      <DIV
  47779. CLASS="warning"
  47780. ><P
  47781. ></P
  47782. ><TABLE
  47783. CLASS="warning"
  47784. BORDER="1"
  47785. WIDTH="100%"
  47786. ><TR
  47787. ><TD
  47788. ALIGN="CENTER"
  47789. ><B
  47790. >Varovßnφ</B
  47791. ></TD
  47792. ></TR
  47793. ><TR
  47794. ><TD
  47795. ALIGN="LEFT"
  47796. ><P
  47797. >        Pokud toto pole obsahuje prßzdnΘ prvky, nebo prvky, jejich╛ index je 0,
  47798.        tato funkce vrßtφ <TT
  47799. CLASS="constant"
  47800. ><B
  47801. >FALSE</B
  47802. ></TT
  47803. > i pro tyto prvky. Ke sprßvnΘmu
  47804.        pr∙chodu polem, kterΘ m∙╛e obsahovat prßzdnΘ prvky nebo prvky s indexem 0
  47805.        pou╛ijte <A
  47806. HREF="#function.each"
  47807. ><B
  47808. CLASS="function"
  47809. >each()</B
  47810. ></A
  47811. >.
  47812.       </P
  47813. ></TD
  47814. ></TR
  47815. ></TABLE
  47816. ></DIV
  47817. >
  47818.     </P
  47819. ><P
  47820. >      Viz takΘ:
  47821.      <A
  47822. HREF="#function.current"
  47823. ><B
  47824. CLASS="function"
  47825. >current()</B
  47826. ></A
  47827. >,
  47828.      <A
  47829. HREF="#function.end"
  47830. ><B
  47831. CLASS="function"
  47832. >end()</B
  47833. ></A
  47834. >,
  47835.      <A
  47836. HREF="#function.prev"
  47837. ><B
  47838. CLASS="function"
  47839. >prev()</B
  47840. ></A
  47841. > a
  47842.      <A
  47843. HREF="#function.reset"
  47844. ><B
  47845. CLASS="function"
  47846. >reset()</B
  47847. ></A
  47848. >.
  47849.     </P
  47850. ></DIV
  47851. ><H1
  47852. ><A
  47853. NAME="function.pos"
  47854. ></A
  47855. >pos</H1
  47856. ><DIV
  47857. CLASS="refnamediv"
  47858. ><A
  47859. NAME="AEN9033"
  47860. ></A
  47861. ><P
  47862. >    (PHP 3, PHP 4 )</P
  47863. >pos -- Zφskat souΦasn² prvek pole</DIV
  47864. ><DIV
  47865. CLASS="refsect1"
  47866. ><A
  47867. NAME="AEN9036"
  47868. ></A
  47869. ><H2
  47870. >Popis</H2
  47871. >mixed <B
  47872. CLASS="methodname"
  47873. >pos</B
  47874. > ( array array)<BR
  47875. ></BR
  47876. ><P
  47877. >      Toto je alias k <A
  47878. HREF="#function.current"
  47879. ><B
  47880. CLASS="function"
  47881. >current()</B
  47882. ></A
  47883. >.
  47884.     </P
  47885. ><P
  47886. >      Viz takΘ: <A
  47887. HREF="#function.end"
  47888. ><B
  47889. CLASS="function"
  47890. >end()</B
  47891. ></A
  47892. >,
  47893.      <A
  47894. HREF="#function.next"
  47895. ><B
  47896. CLASS="function"
  47897. >next()</B
  47898. ></A
  47899. >,
  47900.      <A
  47901. HREF="#function.prev"
  47902. ><B
  47903. CLASS="function"
  47904. >prev()</B
  47905. ></A
  47906. > a
  47907.      <A
  47908. HREF="#function.reset"
  47909. ><B
  47910. CLASS="function"
  47911. >reset()</B
  47912. ></A
  47913. >.
  47914.     </P
  47915. ></DIV
  47916. ><H1
  47917. ><A
  47918. NAME="function.prev"
  47919. ></A
  47920. >prev</H1
  47921. ><DIV
  47922. CLASS="refnamediv"
  47923. ><A
  47924. NAME="AEN9052"
  47925. ></A
  47926. ><P
  47927. >    (PHP 3, PHP 4 )</P
  47928. >prev -- Rewind internφ ukazatel pole</DIV
  47929. ><DIV
  47930. CLASS="refsect1"
  47931. ><A
  47932. NAME="AEN9055"
  47933. ></A
  47934. ><H2
  47935. >Popis</H2
  47936. >mixed <B
  47937. CLASS="methodname"
  47938. >prev</B
  47939. > ( array array)<BR
  47940. ></BR
  47941. ><P
  47942. >      Vracφ prvek pole p°ed tφm prvkem, na kter² ukazuje internφ ukazatel pole,
  47943.      nebo <TT
  47944. CLASS="constant"
  47945. ><B
  47946. >FALSE</B
  47947. ></TT
  47948. >, pokud prvky do╣ly.
  47949.      <DIV
  47950. CLASS="warning"
  47951. ><P
  47952. ></P
  47953. ><TABLE
  47954. CLASS="warning"
  47955. BORDER="1"
  47956. WIDTH="100%"
  47957. ><TR
  47958. ><TD
  47959. ALIGN="CENTER"
  47960. ><B
  47961. >Varovßnφ</B
  47962. ></TD
  47963. ></TR
  47964. ><TR
  47965. ><TD
  47966. ALIGN="LEFT"
  47967. ><P
  47968. >        Pokud toto pole obsahuje prßzdnΘ prvky, tato funkce vrßtφ
  47969.        <TT
  47970. CLASS="constant"
  47971. ><B
  47972. >FALSE</B
  47973. ></TT
  47974. > i pro tyto prvky. Ke sprßvnΘmu pr∙chodu polem,
  47975.        kterΘ m∙╛e obsahovat prßzdnΘ prvky pou╛ijte <A
  47976. HREF="#function.each"
  47977. ><B
  47978. CLASS="function"
  47979. >each()</B
  47980. ></A
  47981. >.
  47982.       </P
  47983. ></TD
  47984. ></TR
  47985. ></TABLE
  47986. ></DIV
  47987. >
  47988.     </P
  47989. ><P
  47990. >      <B
  47991. CLASS="function"
  47992. >prev()</B
  47993. > se chovß stejn∞ jako <A
  47994. HREF="#function.next"
  47995. ><B
  47996. CLASS="function"
  47997. >next()</B
  47998. ></A
  47999. >,
  48000.      ale posouvß internφ ukazatel pole o jedno mφsto zpßtky mφsto dop°edu.
  48001.     </P
  48002. ><P
  48003. >      Viz takΘ: <A
  48004. HREF="#function.current"
  48005. ><B
  48006. CLASS="function"
  48007. >current()</B
  48008. ></A
  48009. >,
  48010.      <A
  48011. HREF="#function.end"
  48012. ><B
  48013. CLASS="function"
  48014. >end()</B
  48015. ></A
  48016. >,
  48017.      <A
  48018. HREF="#function.next"
  48019. ><B
  48020. CLASS="function"
  48021. >next()</B
  48022. ></A
  48023. > a
  48024.      <A
  48025. HREF="#function.reset"
  48026. ><B
  48027. CLASS="function"
  48028. >reset()</B
  48029. ></A
  48030. >.
  48031.     </P
  48032. ></DIV
  48033. ><H1
  48034. ><A
  48035. NAME="function.range"
  48036. ></A
  48037. >range</H1
  48038. ><DIV
  48039. CLASS="refnamediv"
  48040. ><A
  48041. NAME="AEN9078"
  48042. ></A
  48043. ><P
  48044. >    (PHP 3>= 3.0.8, PHP 4 )</P
  48045. >range -- Vytvo°it pole obsahujφcφ rozsah integer∙</DIV
  48046. ><DIV
  48047. CLASS="refsect1"
  48048. ><A
  48049. NAME="AEN9081"
  48050. ></A
  48051. ><H2
  48052. >Popis</H2
  48053. >array <B
  48054. CLASS="methodname"
  48055. >range</B
  48056. > ( int low, int high)<BR
  48057. ></BR
  48058. ><P
  48059. >      <B
  48060. CLASS="function"
  48061. >range()</B
  48062. > vracφ pole integer∙ od
  48063.      <TT
  48064. CLASS="parameter"
  48065. ><I
  48066. >low</I
  48067. ></TT
  48068. > po <TT
  48069. CLASS="parameter"
  48070. ><I
  48071. >high</I
  48072. ></TT
  48073. > vΦetn∞.
  48074.     </P
  48075. ><P
  48076. >      Ukßzka pou╛itφ viz <A
  48077. HREF="#function.shuffle"
  48078. ><B
  48079. CLASS="function"
  48080. >shuffle()</B
  48081. ></A
  48082. >.
  48083.     </P
  48084. ></DIV
  48085. ><H1
  48086. ><A
  48087. NAME="function.reset"
  48088. ></A
  48089. >reset</H1
  48090. ><DIV
  48091. CLASS="refnamediv"
  48092. ><A
  48093. NAME="AEN9099"
  48094. ></A
  48095. ><P
  48096. >    (PHP 3, PHP 4 )</P
  48097. >reset -- Nastavit internφ ukazatel pole na jeho prvnφ prvek</DIV
  48098. ><DIV
  48099. CLASS="refsect1"
  48100. ><A
  48101. NAME="AEN9102"
  48102. ></A
  48103. ><H2
  48104. >Popis</H2
  48105. >mixed <B
  48106. CLASS="methodname"
  48107. >reset</B
  48108. > ( array array)<BR
  48109. ></BR
  48110. ><P
  48111. >      <B
  48112. CLASS="function"
  48113. >reset()</B
  48114. > p°etoΦφ internφ ukazatel pole
  48115.      <TT
  48116. CLASS="parameter"
  48117. ><I
  48118. >array</I
  48119. ></TT
  48120. > na jeho prvnφ prvek.
  48121.     </P
  48122. ><P
  48123. >      <B
  48124. CLASS="function"
  48125. >reset()</B
  48126. > vracφ hodnotu prvnφho prvku pole.
  48127.     </P
  48128. ><P
  48129. >      Viz takΘ: <A
  48130. HREF="#function.current"
  48131. ><B
  48132. CLASS="function"
  48133. >current()</B
  48134. ></A
  48135. >,
  48136.      <A
  48137. HREF="#function.each"
  48138. ><B
  48139. CLASS="function"
  48140. >each()</B
  48141. ></A
  48142. >,
  48143.      <A
  48144. HREF="#function.next"
  48145. ><B
  48146. CLASS="function"
  48147. >next()</B
  48148. ></A
  48149. > a
  48150.      <A
  48151. HREF="#function.prev"
  48152. ><B
  48153. CLASS="function"
  48154. >prev()</B
  48155. ></A
  48156. >.
  48157.     </P
  48158. ></DIV
  48159. ><H1
  48160. ><A
  48161. NAME="function.rsort"
  48162. ></A
  48163. >rsort</H1
  48164. ><DIV
  48165. CLASS="refnamediv"
  48166. ><A
  48167. NAME="AEN9121"
  48168. ></A
  48169. ><P
  48170. >    (PHP 3, PHP 4 )</P
  48171. >rsort -- T°φdit pole sestupn∞</DIV
  48172. ><DIV
  48173. CLASS="refsect1"
  48174. ><A
  48175. NAME="AEN9124"
  48176. ></A
  48177. ><H2
  48178. >Popis</H2
  48179. >void <B
  48180. CLASS="methodname"
  48181. >rsort</B
  48182. > ( array array [, int sort_flags])<BR
  48183. ></BR
  48184. ><P
  48185. >      Tato funkce sestupn∞ t°φdφ pole.
  48186.      <TABLE
  48187. WIDTH="100%"
  48188. BORDER="0"
  48189. CELLPADDING="0"
  48190. CELLSPACING="0"
  48191. CLASS="EXAMPLE"
  48192. ><TR
  48193. ><TD
  48194. ><DIV
  48195. CLASS="example"
  48196. ><A
  48197. NAME="AEN9136"
  48198. ></A
  48199. ><P
  48200. ><B
  48201. >P°φklad 1. Ukßzka <B
  48202. CLASS="function"
  48203. >rsort()</B
  48204. ></B
  48205. ></P
  48206. ><TABLE
  48207. BORDER="0"
  48208. BGCOLOR="#E0E0E0"
  48209. CELLPADDING="5"
  48210. ><TR
  48211. ><TD
  48212. ><PRE
  48213. CLASS="php"
  48214. >$fruits = array ("lemon", "orange", "banana", "apple");
  48215. rsort ($fruits);
  48216. reset ($fruits);
  48217. while (list ($key, $val) = each ($fruits)) {
  48218.     echo "$key -> $val\n";
  48219. }</PRE
  48220. ></TD
  48221. ></TR
  48222. ></TABLE
  48223. ></DIV
  48224. ></TD
  48225. ></TR
  48226. ></TABLE
  48227. >
  48228.     </P
  48229. ><P
  48230. >      Tato ukßzka zobrazφ:
  48231.     </P
  48232. ><P
  48233. >      <DIV
  48234. CLASS="informalexample"
  48235. ><A
  48236. NAME="AEN9142"
  48237. ></A
  48238. ><P
  48239. ></P
  48240. ><TABLE
  48241. BORDER="0"
  48242. BGCOLOR="#E0E0E0"
  48243. CELLPADDING="5"
  48244. ><TR
  48245. ><TD
  48246. ><PRE
  48247. CLASS="programlisting"
  48248. >fruits[0] = orange
  48249. fruits[1] = lemon
  48250. fruits[2] = banana
  48251. fruits[3] = apple</PRE
  48252. ></TD
  48253. ></TR
  48254. ></TABLE
  48255. ><P
  48256. ></P
  48257. ></DIV
  48258. >
  48259.     </P
  48260. ><P
  48261. >      Ovoce bylo set°φd∞no podle abecedy sestupn∞.
  48262.     </P
  48263. ><P
  48264. >      Vlastnosti t°φd∞nφ lze upravit pomocφ volitelnΘho argumentu
  48265.      <TT
  48266. CLASS="parameter"
  48267. ><I
  48268. >sort_flags</I
  48269. ></TT
  48270. >, detaily viz <A
  48271. HREF="#function.sort"
  48272. ><B
  48273. CLASS="function"
  48274. >sort()</B
  48275. ></A
  48276. >.
  48277.     </P
  48278. ><P
  48279. >      Viz takΘ: <A
  48280. HREF="#function.arsort"
  48281. ><B
  48282. CLASS="function"
  48283. >arsort()</B
  48284. ></A
  48285. >,
  48286.      <A
  48287. HREF="#function.asort"
  48288. ><B
  48289. CLASS="function"
  48290. >asort()</B
  48291. ></A
  48292. >,
  48293.      <A
  48294. HREF="#function.ksort"
  48295. ><B
  48296. CLASS="function"
  48297. >ksort()</B
  48298. ></A
  48299. >,
  48300.      <A
  48301. HREF="#function.sort"
  48302. ><B
  48303. CLASS="function"
  48304. >sort()</B
  48305. ></A
  48306. > a
  48307.      <A
  48308. HREF="#function.usort"
  48309. ><B
  48310. CLASS="function"
  48311. >usort()</B
  48312. ></A
  48313. >.
  48314.     </P
  48315. ></DIV
  48316. ><H1
  48317. ><A
  48318. NAME="function.shuffle"
  48319. ></A
  48320. >shuffle</H1
  48321. ><DIV
  48322. CLASS="refnamediv"
  48323. ><A
  48324. NAME="AEN9155"
  48325. ></A
  48326. ><P
  48327. >    (PHP 3>= 3.0.8, PHP 4 )</P
  48328. >shuffle -- Zamφchat pole</DIV
  48329. ><DIV
  48330. CLASS="refsect1"
  48331. ><A
  48332. NAME="AEN9158"
  48333. ></A
  48334. ><H2
  48335. >Popis</H2
  48336. >void <B
  48337. CLASS="methodname"
  48338. >shuffle</B
  48339. > ( array array)<BR
  48340. ></BR
  48341. ><P
  48342. >      <B
  48343. CLASS="function"
  48344. >shuffle()</B
  48345. > zamφchß (nßhodn∞ zm∞nφ po°adφ prvk∙) pole.
  48346.      Musφte inicializovat generßtor nßhodn²ch Φφsel pomocφ
  48347.      <A
  48348. HREF="#function.srand"
  48349. ><B
  48350. CLASS="function"
  48351. >srand()</B
  48352. ></A
  48353. >.
  48354.      <TABLE
  48355. WIDTH="100%"
  48356. BORDER="0"
  48357. CELLPADDING="0"
  48358. CELLSPACING="0"
  48359. CLASS="EXAMPLE"
  48360. ><TR
  48361. ><TD
  48362. ><DIV
  48363. CLASS="example"
  48364. ><A
  48365. NAME="AEN9169"
  48366. ></A
  48367. ><P
  48368. ><B
  48369. >P°φklad 1. Ukßzka <B
  48370. CLASS="function"
  48371. >shuffle()</B
  48372. ></B
  48373. ></P
  48374. ><TABLE
  48375. BORDER="0"
  48376. BGCOLOR="#E0E0E0"
  48377. CELLPADDING="5"
  48378. ><TR
  48379. ><TD
  48380. ><PRE
  48381. CLASS="php"
  48382. >$numbers = range (1,20);
  48383. srand ((double)microtime()*1000000);
  48384. shuffle ($numbers);
  48385. while (list (, $number) = each ($numbers)) {
  48386.     echo "$number ";
  48387. }</PRE
  48388. ></TD
  48389. ></TR
  48390. ></TABLE
  48391. ></DIV
  48392. ></TD
  48393. ></TR
  48394. ></TABLE
  48395. >
  48396.     </P
  48397. ><P
  48398. >      Viz takΘ: <A
  48399. HREF="#function.arsort"
  48400. ><B
  48401. CLASS="function"
  48402. >arsort()</B
  48403. ></A
  48404. >,
  48405.      <A
  48406. HREF="#function.asort"
  48407. ><B
  48408. CLASS="function"
  48409. >asort()</B
  48410. ></A
  48411. >,
  48412.      <A
  48413. HREF="#function.ksort"
  48414. ><B
  48415. CLASS="function"
  48416. >ksort()</B
  48417. ></A
  48418. >,
  48419.      <A
  48420. HREF="#function.rsort"
  48421. ><B
  48422. CLASS="function"
  48423. >rsort()</B
  48424. ></A
  48425. >,
  48426.      <A
  48427. HREF="#function.sort"
  48428. ><B
  48429. CLASS="function"
  48430. >sort()</B
  48431. ></A
  48432. > a
  48433.      <A
  48434. HREF="#function.usort"
  48435. ><B
  48436. CLASS="function"
  48437. >usort()</B
  48438. ></A
  48439. >.
  48440.     </P
  48441. ></DIV
  48442. ><H1
  48443. ><A
  48444. NAME="function.sizeof"
  48445. ></A
  48446. >sizeof</H1
  48447. ><DIV
  48448. CLASS="refnamediv"
  48449. ><A
  48450. NAME="AEN9181"
  48451. ></A
  48452. ><P
  48453. >    (PHP 3, PHP 4 )</P
  48454. >sizeof -- Zjistit poΦet prvk∙ v poli</DIV
  48455. ><DIV
  48456. CLASS="refsect1"
  48457. ><A
  48458. NAME="AEN9184"
  48459. ></A
  48460. ><H2
  48461. >Popis</H2
  48462. >int <B
  48463. CLASS="methodname"
  48464. >sizeof</B
  48465. > ( array array)<BR
  48466. ></BR
  48467. ><P
  48468. >      Vracφ poΦet prvk∙ v poli.
  48469.     </P
  48470. ><P
  48471. >      Viz takΘ: <A
  48472. HREF="#function.count"
  48473. ><B
  48474. CLASS="function"
  48475. >count()</B
  48476. ></A
  48477. >.
  48478.     </P
  48479. ></DIV
  48480. ><H1
  48481. ><A
  48482. NAME="function.sort"
  48483. ></A
  48484. >sort</H1
  48485. ><DIV
  48486. CLASS="refnamediv"
  48487. ><A
  48488. NAME="AEN9196"
  48489. ></A
  48490. ><P
  48491. >    (PHP 3, PHP 4 )</P
  48492. >sort -- T°φdit pole</DIV
  48493. ><DIV
  48494. CLASS="refsect1"
  48495. ><A
  48496. NAME="AEN9199"
  48497. ></A
  48498. ><H2
  48499. >Popis</H2
  48500. >void <B
  48501. CLASS="methodname"
  48502. >sort</B
  48503. > ( array array [, int sort_flags])<BR
  48504. ></BR
  48505. ><P
  48506. >      <B
  48507. CLASS="function"
  48508. >sort()</B
  48509. > t°φdφ pole. Prvky se uspo°ßdajφ od nejmen╣φho
  48510.      k nejv∞t╣φmu.
  48511.      <TABLE
  48512. WIDTH="100%"
  48513. BORDER="0"
  48514. CELLPADDING="0"
  48515. CELLSPACING="0"
  48516. CLASS="EXAMPLE"
  48517. ><TR
  48518. ><TD
  48519. ><DIV
  48520. CLASS="example"
  48521. ><A
  48522. NAME="AEN9212"
  48523. ></A
  48524. ><P
  48525. ><B
  48526. >P°φklad 1. Ukßzka <B
  48527. CLASS="function"
  48528. >sort()</B
  48529. ></B
  48530. ></P
  48531. ><TABLE
  48532. BORDER="0"
  48533. BGCOLOR="#E0E0E0"
  48534. CELLPADDING="5"
  48535. ><TR
  48536. ><TD
  48537. ><PRE
  48538. CLASS="php"
  48539. ><?php
  48540.  
  48541. $fruits = array ("lemon", "orange", "banana", "apple");
  48542. sort ($fruits);
  48543. reset ($fruits);
  48544. while (list ($key, $val) = each ($fruits)) {
  48545.     echo "fruits[".$key."] = ".$val;
  48546. }
  48547.  
  48548. ?></PRE
  48549. ></TD
  48550. ></TR
  48551. ></TABLE
  48552. ></DIV
  48553. ></TD
  48554. ></TR
  48555. ></TABLE
  48556. >
  48557.     </P
  48558. ><P
  48559. >      Tato ukßzka zobrazφ:
  48560.     </P
  48561. ><P
  48562. >      <DIV
  48563. CLASS="informalexample"
  48564. ><A
  48565. NAME="AEN9218"
  48566. ></A
  48567. ><P
  48568. ></P
  48569. ><TABLE
  48570. BORDER="0"
  48571. BGCOLOR="#E0E0E0"
  48572. CELLPADDING="5"
  48573. ><TR
  48574. ><TD
  48575. ><PRE
  48576. CLASS="programlisting"
  48577. >fruits[0] = apple
  48578. fruits[1] = banana
  48579. fruits[2] = lemon
  48580. fruits[3] = orange</PRE
  48581. ></TD
  48582. ></TR
  48583. ></TABLE
  48584. ><P
  48585. ></P
  48586. ></DIV
  48587. >
  48588.     </P
  48589. ><P
  48590. >      Ovoce bylo se°azeno podle abecedy.
  48591.     </P
  48592. ><P
  48593. >      Vlastnosti t°φd∞nφ lze upravit pomocφ volitelnΘho argumentu
  48594.      <TT
  48595. CLASS="parameter"
  48596. ><I
  48597. >sort_flags</I
  48598. ></TT
  48599. >, kter² m∙╛e nab²vat t∞chto hodnot:
  48600.     </P
  48601. ><P
  48602. >      Typy t°φd∞nφ:
  48603.      <P
  48604. ></P
  48605. ><UL
  48606. ><LI
  48607. ><P
  48608. >SORT_REGULAR - normßlnφ porovnßvßnφ</P
  48609. ></LI
  48610. ><LI
  48611. ><P
  48612. >SORT_NUMERIC - numerickΘ porovnßvßnφ</P
  48613. ></LI
  48614. ><LI
  48615. ><P
  48616. >SORT_STRING - textovΘ porovnßvßnφ</P
  48617. ></LI
  48618. ></UL
  48619. >
  48620.     </P
  48621. ><P
  48622. >      Viz takΘ: <A
  48623. HREF="#function.arsort"
  48624. ><B
  48625. CLASS="function"
  48626. >arsort()</B
  48627. ></A
  48628. >,
  48629.      <A
  48630. HREF="#function.asort"
  48631. ><B
  48632. CLASS="function"
  48633. >asort()</B
  48634. ></A
  48635. >,
  48636.      <A
  48637. HREF="#function.ksort"
  48638. ><B
  48639. CLASS="function"
  48640. >ksort()</B
  48641. ></A
  48642. >,
  48643.      <A
  48644. HREF="#function.natsort"
  48645. ><B
  48646. CLASS="function"
  48647. >natsort()</B
  48648. ></A
  48649. >,
  48650.      <A
  48651. HREF="#function.natcasesort"
  48652. ><B
  48653. CLASS="function"
  48654. >natcasesort()</B
  48655. ></A
  48656. >,
  48657.      <A
  48658. HREF="#function.rsort"
  48659. ><B
  48660. CLASS="function"
  48661. >rsort()</B
  48662. ></A
  48663. >,
  48664.      <A
  48665. HREF="#function.usort"
  48666. ><B
  48667. CLASS="function"
  48668. >usort()</B
  48669. ></A
  48670. >,
  48671.      <A
  48672. HREF="#function.array-multisort"
  48673. ><B
  48674. CLASS="function"
  48675. >array_multisort()</B
  48676. ></A
  48677. > a
  48678.      <A
  48679. HREF="#function.uksort"
  48680. ><B
  48681. CLASS="function"
  48682. >uksort()</B
  48683. ></A
  48684. >.
  48685.     </P
  48686. ><DIV
  48687. CLASS="note"
  48688. ><BLOCKQUOTE
  48689. CLASS="note"
  48690. ><P
  48691. ><B
  48692. >Poznßmka: </B
  48693. >
  48694.       Druh² argument byl p°idßn v PHP 4.
  48695.      </P
  48696. ></BLOCKQUOTE
  48697. ></DIV
  48698. ></DIV
  48699. ><H1
  48700. ><A
  48701. NAME="function.uasort"
  48702. ></A
  48703. >uasort</H1
  48704. ><DIV
  48705. CLASS="refnamediv"
  48706. ><A
  48707. NAME="AEN9244"
  48708. ></A
  48709. ><P
  48710. >    (PHP 3>= 3.0.4, PHP 4 )</P
  48711. >uasort -- 
  48712.      T°φdit pole pomocφ u╛ivatelsky definovanΘ porovnßvacφ funkce se zachovßnφm
  48713.      klφΦ∙
  48714.     </DIV
  48715. ><DIV
  48716. CLASS="refsect1"
  48717. ><A
  48718. NAME="AEN9247"
  48719. ></A
  48720. ><H2
  48721. >Popis</H2
  48722. >void <B
  48723. CLASS="methodname"
  48724. >uasort</B
  48725. > ( array array, function cmp_function)<BR
  48726. ></BR
  48727. ><P
  48728. >      Tato funkce t°φdφ pole tak, ╛e si indexy uchovßvajφ spojenφ s hodnotami.
  48729.      To je u╛iteΦnΘ hlavn∞ p°i t°φd∞nφ asociativnφch polφ, kde je d∙le╛itΘ
  48730.      po°adφ prvk∙. Srovnßvacφ funkce je u╛ivatelsky definovßna.
  48731.     </P
  48732. ><DIV
  48733. CLASS="note"
  48734. ><BLOCKQUOTE
  48735. CLASS="note"
  48736. ><P
  48737. ><B
  48738. >Poznßmka: </B
  48739. >
  48740.       Ukßzky u╛ivatelsky definovan²ch porovnßvacφch funkcφ viz
  48741.       <A
  48742. HREF="#function.usort"
  48743. ><B
  48744. CLASS="function"
  48745. >usort()</B
  48746. ></A
  48747. > a <A
  48748. HREF="#function.uksort"
  48749. ><B
  48750. CLASS="function"
  48751. >uksort()</B
  48752. ></A
  48753. >.
  48754.      </P
  48755. ></BLOCKQUOTE
  48756. ></DIV
  48757. ><P
  48758. >      Viz takΘ: <A
  48759. HREF="#function.usort"
  48760. ><B
  48761. CLASS="function"
  48762. >usort()</B
  48763. ></A
  48764. >,
  48765.      <A
  48766. HREF="#function.uksort"
  48767. ><B
  48768. CLASS="function"
  48769. >uksort()</B
  48770. ></A
  48771. >,
  48772.      <A
  48773. HREF="#function.sort"
  48774. ><B
  48775. CLASS="function"
  48776. >sort()</B
  48777. ></A
  48778. >,
  48779.      <A
  48780. HREF="#function.asort"
  48781. ><B
  48782. CLASS="function"
  48783. >asort()</B
  48784. ></A
  48785. >,
  48786.      <A
  48787. HREF="#function.arsort"
  48788. ><B
  48789. CLASS="function"
  48790. >arsort()</B
  48791. ></A
  48792. >,
  48793.      <A
  48794. HREF="#function.ksort"
  48795. ><B
  48796. CLASS="function"
  48797. >ksort()</B
  48798. ></A
  48799. > a
  48800.      <A
  48801. HREF="#function.rsort"
  48802. ><B
  48803. CLASS="function"
  48804. >rsort()</B
  48805. ></A
  48806. >.
  48807.     </P
  48808. ></DIV
  48809. ><H1
  48810. ><A
  48811. NAME="function.uksort"
  48812. ></A
  48813. >uksort</H1
  48814. ><DIV
  48815. CLASS="refnamediv"
  48816. ><A
  48817. NAME="AEN9272"
  48818. ></A
  48819. ><P
  48820. >    (PHP 3>= 3.0.4, PHP 4 )</P
  48821. >uksort -- 
  48822.      T°φdit pole podle klφΦ∙ pomocφ u╛ivatelsky definovane porovnßvacφ funkce
  48823.     </DIV
  48824. ><DIV
  48825. CLASS="refsect1"
  48826. ><A
  48827. NAME="AEN9275"
  48828. ></A
  48829. ><H2
  48830. >Popis</H2
  48831. >void <B
  48832. CLASS="methodname"
  48833. >uksort</B
  48834. > ( array array, function cmp_function)<BR
  48835. ></BR
  48836. ><P
  48837. >      Tato funkce t°φdφ pole podle klφΦ∙ pomocφ u╛ivatelsky definovanΘ
  48838.      porovnßvacφ funkce. Pokud pot°ebujete t°φdit pole podle komplikovan∞j╣φch
  48839.      kritΘriφ, m∞li byste pou╛φt tuto funkci.
  48840.     </P
  48841. ><P
  48842. >      <TABLE
  48843. WIDTH="100%"
  48844. BORDER="0"
  48845. CELLPADDING="0"
  48846. CELLSPACING="0"
  48847. CLASS="EXAMPLE"
  48848. ><TR
  48849. ><TD
  48850. ><DIV
  48851. CLASS="example"
  48852. ><A
  48853. NAME="AEN9288"
  48854. ></A
  48855. ><P
  48856. ><B
  48857. >P°φklad 1. Ukßzka <B
  48858. CLASS="function"
  48859. >uksort()</B
  48860. ></B
  48861. ></P
  48862. ><TABLE
  48863. BORDER="0"
  48864. BGCOLOR="#E0E0E0"
  48865. CELLPADDING="5"
  48866. ><TR
  48867. ><TD
  48868. ><PRE
  48869. CLASS="php"
  48870. >function cmp ($a, $b) {
  48871.     if ($a == $b) return 0;
  48872.     return ($a > $b) ? -1 : 1;
  48873. }
  48874.  
  48875. $a = array (4 => "four", 3 => "three", 20 => "twenty", 10 => "ten");
  48876.  
  48877. uksort ($a, "cmp");
  48878.  
  48879. while (list ($key, $value) = each ($a)) {
  48880.     echo "$key: $value\n";
  48881. }</PRE
  48882. ></TD
  48883. ></TR
  48884. ></TABLE
  48885. ></DIV
  48886. ></TD
  48887. ></TR
  48888. ></TABLE
  48889. >
  48890.     </P
  48891. ><P
  48892. >      Tato ukßzka zobrazφ:
  48893.     </P
  48894. ><P
  48895. >      <DIV
  48896. CLASS="informalexample"
  48897. ><A
  48898. NAME="AEN9294"
  48899. ></A
  48900. ><P
  48901. ></P
  48902. ><TABLE
  48903. BORDER="0"
  48904. BGCOLOR="#E0E0E0"
  48905. CELLPADDING="5"
  48906. ><TR
  48907. ><TD
  48908. ><PRE
  48909. CLASS="programlisting"
  48910. >20: twenty
  48911. 10: ten
  48912. 4: four
  48913. 3: three</PRE
  48914. ></TD
  48915. ></TR
  48916. ></TABLE
  48917. ><P
  48918. ></P
  48919. ></DIV
  48920. >
  48921.     </P
  48922. ><P
  48923. >      Viz takΘ: <A
  48924. HREF="#function.usort"
  48925. ><B
  48926. CLASS="function"
  48927. >usort()</B
  48928. ></A
  48929. >,
  48930.      <A
  48931. HREF="#function.uasort"
  48932. ><B
  48933. CLASS="function"
  48934. >uasort()</B
  48935. ></A
  48936. >,
  48937.      <A
  48938. HREF="#function.sort"
  48939. ><B
  48940. CLASS="function"
  48941. >sort()</B
  48942. ></A
  48943. >,
  48944.      <A
  48945. HREF="#function.asort"
  48946. ><B
  48947. CLASS="function"
  48948. >asort()</B
  48949. ></A
  48950. >,
  48951.      <A
  48952. HREF="#function.arsort"
  48953. ><B
  48954. CLASS="function"
  48955. >arsort()</B
  48956. ></A
  48957. >,
  48958.      <A
  48959. HREF="#function.ksort"
  48960. ><B
  48961. CLASS="function"
  48962. >ksort()</B
  48963. ></A
  48964. >,
  48965.      <A
  48966. HREF="#function.natsort"
  48967. ><B
  48968. CLASS="function"
  48969. >natsort()</B
  48970. ></A
  48971. > a
  48972.      <A
  48973. HREF="#function.rsort"
  48974. ><B
  48975. CLASS="function"
  48976. >rsort()</B
  48977. ></A
  48978. >.
  48979.     </P
  48980. ></DIV
  48981. ><H1
  48982. ><A
  48983. NAME="function.usort"
  48984. ></A
  48985. >usort</H1
  48986. ><DIV
  48987. CLASS="refnamediv"
  48988. ><A
  48989. NAME="AEN9306"
  48990. ></A
  48991. ><P
  48992. >    (PHP 3>= 3.0.3, PHP 4 )</P
  48993. >usort -- 
  48994.      T°φdit pole podle hodnot pomocφ u╛ivatelsky definovanΘ porovnßvacφ funkce
  48995.     </DIV
  48996. ><DIV
  48997. CLASS="refsect1"
  48998. ><A
  48999. NAME="AEN9309"
  49000. ></A
  49001. ><H2
  49002. >Popis</H2
  49003. >void <B
  49004. CLASS="methodname"
  49005. >usort</B
  49006. > ( array array, string cmp_function)<BR
  49007. ></BR
  49008. ><P
  49009. >      Tato funkce t°φdφ pole podle hodnot pomocφ u╛ivatelsky definovanΘ
  49010.      porovnßvacφ funkce. Pokud pot°ebujete t°φdit pole podle komplikovan∞j╣φch
  49011.      kritΘriφ, m∞li byste pou╛φt tuto funkci.
  49012.     </P
  49013. ><P
  49014. >      Porovnßvacφ funkce musφ vrace integer men╣φ ne╛ 0, 0, a v∞t╣φ ne╛ 0, pokud
  49015.      je prvnφ argument men╣φ ne╛, stejn², nebo v∞t╣φ ne╛ druh² argument. Pokud
  49016.      jsou dv∞ porovnßvanΘ hodnoty stejnΘ, jejich po°adφ v t°φd∞nΘm poli je
  49017.      nedefinovßno.
  49018.     </P
  49019. ><P
  49020. >      <TABLE
  49021. WIDTH="100%"
  49022. BORDER="0"
  49023. CELLPADDING="0"
  49024. CELLSPACING="0"
  49025. CLASS="EXAMPLE"
  49026. ><TR
  49027. ><TD
  49028. ><DIV
  49029. CLASS="example"
  49030. ><A
  49031. NAME="AEN9323"
  49032. ></A
  49033. ><P
  49034. ><B
  49035. >P°φklad 1. Ukßzka <B
  49036. CLASS="function"
  49037. >usort()</B
  49038. ></B
  49039. ></P
  49040. ><TABLE
  49041. BORDER="0"
  49042. BGCOLOR="#E0E0E0"
  49043. CELLPADDING="5"
  49044. ><TR
  49045. ><TD
  49046. ><PRE
  49047. CLASS="php"
  49048. >function cmp ($a, $b) {
  49049.     if ($a == $b) return 0;
  49050.     return ($a > $b) ? -1 : 1;
  49051. }
  49052.  
  49053. $a = array (3, 2, 5, 6, 1);
  49054.  
  49055. usort ($a, "cmp");
  49056.  
  49057. while (list ($key, $value) = each ($a)) {
  49058.     echo "$key: $value\n";
  49059. }</PRE
  49060. ></TD
  49061. ></TR
  49062. ></TABLE
  49063. ></DIV
  49064. ></TD
  49065. ></TR
  49066. ></TABLE
  49067. >
  49068.     </P
  49069. ><P
  49070. >      Tato ukßzka zobrazφ:
  49071.     </P
  49072. ><P
  49073. >      <DIV
  49074. CLASS="informalexample"
  49075. ><A
  49076. NAME="AEN9329"
  49077. ></A
  49078. ><P
  49079. ></P
  49080. ><TABLE
  49081. BORDER="0"
  49082. BGCOLOR="#E0E0E0"
  49083. CELLPADDING="5"
  49084. ><TR
  49085. ><TD
  49086. ><PRE
  49087. CLASS="programlisting"
  49088. >0: 6
  49089. 1: 5
  49090. 2: 3
  49091. 3: 2
  49092. 4: 1</PRE
  49093. ></TD
  49094. ></TR
  49095. ></TABLE
  49096. ><P
  49097. ></P
  49098. ></DIV
  49099. >
  49100.     </P
  49101. ><DIV
  49102. CLASS="note"
  49103. ><BLOCKQUOTE
  49104. CLASS="note"
  49105. ><P
  49106. ><B
  49107. >Poznßmka: </B
  49108. >
  49109.       V tomto jednoduchΘm p°φpad∞ by pochopiteln∞ bylo vhodn∞j╣φ pou╛φt
  49110.       <A
  49111. HREF="#function.rsort"
  49112. ><B
  49113. CLASS="function"
  49114. >rsort()</B
  49115. ></A
  49116. >.
  49117.      </P
  49118. ></BLOCKQUOTE
  49119. ></DIV
  49120. ><P
  49121. >      <TABLE
  49122. WIDTH="100%"
  49123. BORDER="0"
  49124. CELLPADDING="0"
  49125. CELLSPACING="0"
  49126. CLASS="EXAMPLE"
  49127. ><TR
  49128. ><TD
  49129. ><DIV
  49130. CLASS="example"
  49131. ><A
  49132. NAME="AEN9335"
  49133. ></A
  49134. ><P
  49135. ><B
  49136. >P°φklad 2. 
  49137.        Ukßzka <B
  49138. CLASS="function"
  49139. >usort()</B
  49140. > s vφcerozm∞rn²m polem
  49141.       </B
  49142. ></P
  49143. ><TABLE
  49144. BORDER="0"
  49145. BGCOLOR="#E0E0E0"
  49146. CELLPADDING="5"
  49147. ><TR
  49148. ><TD
  49149. ><PRE
  49150. CLASS="php"
  49151. >function cmp ($a, $b) {
  49152.     return strcmp($a["fruit"],$b["fruit"]);
  49153. }
  49154.  
  49155. $fruits[0]["fruit"] = "lemons";
  49156. $fruits[1]["fruit"] = "apples";
  49157. $fruits[2]["fruit"] = "grapes";
  49158.  
  49159. usort($fruits, "cmp");
  49160.  
  49161. while (list ($key, $value) = each ($fruits)) {
  49162.     echo "\$fruits[$key]: " . $value["fruit"] . "\n";
  49163. }</PRE
  49164. ></TD
  49165. ></TR
  49166. ></TABLE
  49167. ></DIV
  49168. ></TD
  49169. ></TR
  49170. ></TABLE
  49171. >
  49172.     </P
  49173. ><P
  49174. >      P°i t°φd∞nφ vφcerozm∞rnΘho pole $a a $b obsahujφ reference na prvnφ index
  49175.      pole.
  49176.     </P
  49177. ><P
  49178. >      Tato ukßzka zobrazφ:
  49179.     </P
  49180. ><P
  49181. >      <DIV
  49182. CLASS="informalexample"
  49183. ><A
  49184. NAME="AEN9342"
  49185. ></A
  49186. ><P
  49187. ></P
  49188. ><TABLE
  49189. BORDER="0"
  49190. BGCOLOR="#E0E0E0"
  49191. CELLPADDING="5"
  49192. ><TR
  49193. ><TD
  49194. ><PRE
  49195. CLASS="programlisting"
  49196. >$fruits[0]: apples
  49197. $fruits[1]: grapes
  49198. $fruits[2]: lemons</PRE
  49199. ></TD
  49200. ></TR
  49201. ></TABLE
  49202. ><P
  49203. ></P
  49204. ></DIV
  49205. >
  49206.     </P
  49207. ><P
  49208. >      <DIV
  49209. CLASS="warning"
  49210. ><P
  49211. ></P
  49212. ><TABLE
  49213. CLASS="warning"
  49214. BORDER="1"
  49215. WIDTH="100%"
  49216. ><TR
  49217. ><TD
  49218. ALIGN="CENTER"
  49219. ><B
  49220. >Varovßnφ</B
  49221. ></TD
  49222. ></TR
  49223. ><TR
  49224. ><TD
  49225. ALIGN="LEFT"
  49226. ><P
  49227. >        Pou╛itß quicksort funkce v n∞kter²ch C knihovnßch (nap°. na systΘmech
  49228.        Solaris) m∙╛e zp∙sobit zhroucenφ PHP, pokud porovnßvacφ funkce nevracφ
  49229.        konsistentnφ hodnoty.
  49230.       </P
  49231. ></TD
  49232. ></TR
  49233. ></TABLE
  49234. ></DIV
  49235. >
  49236.     </P
  49237. ><P
  49238. >      Viz takΘ: <A
  49239. HREF="#function.uasort"
  49240. ><B
  49241. CLASS="function"
  49242. >uasort()</B
  49243. ></A
  49244. >,
  49245.      <A
  49246. HREF="#function.uksort"
  49247. ><B
  49248. CLASS="function"
  49249. >uksort()</B
  49250. ></A
  49251. >,
  49252.      <A
  49253. HREF="#function.sort"
  49254. ><B
  49255. CLASS="function"
  49256. >sort()</B
  49257. ></A
  49258. >,
  49259.      <A
  49260. HREF="#function.asort"
  49261. ><B
  49262. CLASS="function"
  49263. >asort()</B
  49264. ></A
  49265. >,
  49266.      <A
  49267. HREF="#function.arsort"
  49268. ><B
  49269. CLASS="function"
  49270. >arsort()</B
  49271. ></A
  49272. >,
  49273.      <A
  49274. HREF="#function.ksort"
  49275. ><B
  49276. CLASS="function"
  49277. >ksort()</B
  49278. ></A
  49279. >,
  49280.      <A
  49281. HREF="#function.natsort"
  49282. ><B
  49283. CLASS="function"
  49284. >natsort()</B
  49285. ></A
  49286. > a
  49287.      <A
  49288. HREF="#function.rsort"
  49289. ><B
  49290. CLASS="function"
  49291. >rsort()</B
  49292. ></A
  49293. >.
  49294.     </P
  49295. ></DIV
  49296. ></DIV
  49297. ><DIV
  49298. CLASS="reference"
  49299. ><A
  49300. NAME="ref.aspell"
  49301. ></A
  49302. ><DIV
  49303. CLASS="TITLEPAGE"
  49304. ><H1
  49305. CLASS="title"
  49306. >III. Aspell funkce [zastaralΘ]</H1
  49307. ><DIV
  49308. CLASS="PARTINTRO"
  49309. ><A
  49310. NAME="AEN9359"
  49311. ></A
  49312. ><DIV
  49313. CLASS="section"
  49314. ><H1
  49315. CLASS="section"
  49316. ><A
  49317. NAME="aspell.intro"
  49318. ></A
  49319. >┌vod</H1
  49320. ><P
  49321. >     <B
  49322. CLASS="function"
  49323. >aspell()</B
  49324. > funkce umo╛≥ujφ ov∞°it hlßskovßnφ slova
  49325.     a nabφdnout mo╛nΘ opravy.
  49326.     </P
  49327. ><DIV
  49328. CLASS="note"
  49329. ><BLOCKQUOTE
  49330. CLASS="note"
  49331. ><P
  49332. ><B
  49333. >Poznßmka: </B
  49334. >
  49335.      Toto roz╣φ°enφ bylo z PHP odebrßno a od PHP 4.3.0 nenφ
  49336.      k dispozici. Pokud chcete v PHP pou╛φt kontrolu hlßskovßnφ, pou╛ijte
  49337.      mφsto toho <A
  49338. HREF="#ref.pspell"
  49339. >pspell</A
  49340. >. Vyu╛φvß pspell
  49341.      knihovnu, a pracuje s nov∞j╣φmi verzemi aspellu.
  49342.     </P
  49343. ></BLOCKQUOTE
  49344. ></DIV
  49345. ></DIV
  49346. ><DIV
  49347. CLASS="section"
  49348. ><HR><H1
  49349. CLASS="section"
  49350. ><A
  49351. NAME="aspell.requirements"
  49352. ></A
  49353. >Po╛adavky</H1
  49354. ><P
  49355. >      Roz╣φ°enφ aspell funguje pouze s velmi star²mi (do p°ibli╛n∞ .27.*) verzemi
  49356.      aspell knihovny. Tento modul, ani tyto verze aspell knihovny u╛ nejsou
  49357.      podporovßny. Budete pot°ebovat knihovnu aspell dostupnou
  49358.      na: <A
  49359. HREF="http://aspell.sourceforge.net/"
  49360. TARGET="_top"
  49361. >http://aspell.sourceforge.net/</A
  49362. >.
  49363.     </P
  49364. ></DIV
  49365. ><DIV
  49366. CLASS="section"
  49367. ><HR><H1
  49368. CLASS="section"
  49369. ><A
  49370. NAME="aspell.installation"
  49371. ></A
  49372. >Instalace</H1
  49373. ><P
  49374. >   In PHP 4, these functions are only available if <TT
  49375. CLASS="literal"
  49376. >PHP</TT
  49377. > was
  49378.   configured with <TT
  49379. CLASS="option"
  49380. >--with-aspell=[DIR]</TT
  49381. >.
  49382.  </P
  49383. ></DIV
  49384. ><DIV
  49385. CLASS="section"
  49386. ><HR><H1
  49387. CLASS="section"
  49388. ><A
  49389. NAME="aspell.seealso"
  49390. ></A
  49391. >Viz takΘ</H1
  49392. ><P
  49393. >      Viz takΘ <A
  49394. HREF="#ref.pspell"
  49395. >pspell</A
  49396. >.
  49397.     </P
  49398. ></DIV
  49399. ></DIV
  49400. ><DIV
  49401. CLASS="TOC"
  49402. ><DL
  49403. ><DT
  49404. ><B
  49405. >Obsah</B
  49406. ></DT
  49407. ><DT
  49408. ><A
  49409. HREF="#function.aspell-check-raw"
  49410. >aspell_check_raw</A
  49411. > -- 
  49412.     Zkontrolovat slovo beze zm∞ny velikosti pφsmen nebo pokus∙ o o°ezßnφ
  49413.     </DT
  49414. ><DT
  49415. ><A
  49416. HREF="#function.aspell-check"
  49417. >aspell_check</A
  49418. > -- Zkontrolovat slovo</DT
  49419. ><DT
  49420. ><A
  49421. HREF="#function.aspell-new"
  49422. >aspell_new</A
  49423. > -- NaΦφst nov² slovnφk</DT
  49424. ><DT
  49425. ><A
  49426. HREF="#function.aspell-suggest"
  49427. >aspell_suggest</A
  49428. > -- Nabφdnout mo╛nΘ hlßskovßnφ slova</DT
  49429. ></DL
  49430. ></DIV
  49431. ></DIV
  49432. ><H1
  49433. ><A
  49434. NAME="function.aspell-check-raw"
  49435. ></A
  49436. >aspell_check_raw</H1
  49437. ><DIV
  49438. CLASS="refnamediv"
  49439. ><A
  49440. NAME="AEN9381"
  49441. ></A
  49442. ><P
  49443. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  49444. >aspell_check_raw -- 
  49445.     Zkontrolovat slovo beze zm∞ny velikosti pφsmen nebo pokus∙ o o°ezßnφ
  49446.     </DIV
  49447. ><DIV
  49448. CLASS="refsect1"
  49449. ><A
  49450. NAME="AEN9384"
  49451. ></A
  49452. ><H2
  49453. >Popis</H2
  49454. >boolean <B
  49455. CLASS="methodname"
  49456. >aspell_check_raw</B
  49457. > ( int dictionary_link, string word)<BR
  49458. ></BR
  49459. ><P
  49460. >      <B
  49461. CLASS="function"
  49462. >aspell_check_raw()</B
  49463. > zkontroluje hlßskovßnφ slova beze
  49464.      zm∞n velikosti pφsmen nebo pokus∙ ho jak²mkoliv zp∙sobem o°ezat, a vrßtφ
  49465.      <TT
  49466. CLASS="constant"
  49467. ><B
  49468. >TRUE</B
  49469. ></TT
  49470. >, pokud je hlßskovßnφ sprßvnΘ, a
  49471.      <TT
  49472. CLASS="constant"
  49473. ><B
  49474. >FALSE</B
  49475. ></TT
  49476. >, pokud nenφ.
  49477.     </P
  49478. ><P
  49479. >      <TABLE
  49480. WIDTH="100%"
  49481. BORDER="0"
  49482. CELLPADDING="0"
  49483. CELLSPACING="0"
  49484. CLASS="EXAMPLE"
  49485. ><TR
  49486. ><TD
  49487. ><DIV
  49488. CLASS="example"
  49489. ><A
  49490. NAME="AEN9400"
  49491. ></A
  49492. ><P
  49493. ><B
  49494. >P°φklad 1. <B
  49495. CLASS="function"
  49496. >aspell_check_raw()</B
  49497. ></B
  49498. ></P
  49499. ><TABLE
  49500. BORDER="0"
  49501. BGCOLOR="#E0E0E0"
  49502. CELLPADDING="5"
  49503. ><TR
  49504. ><TD
  49505. ><PRE
  49506. CLASS="php"
  49507. >$aspell_link=aspell_new ("english");
  49508. if (aspell_check_raw ($aspell_link, "test")) {
  49509.     echo "Toto je platnΘ hlßskovßnφ";
  49510. } else {
  49511.     echo "Pardon, ╣patnΘ hlßskovßnφ";
  49512. }</PRE
  49513. ></TD
  49514. ></TR
  49515. ></TABLE
  49516. ></DIV
  49517. ></TD
  49518. ></TR
  49519. ></TABLE
  49520. >
  49521.     </P
  49522. ></DIV
  49523. ><H1
  49524. ><A
  49525. NAME="function.aspell-check"
  49526. ></A
  49527. >aspell_check</H1
  49528. ><DIV
  49529. CLASS="refnamediv"
  49530. ><A
  49531. NAME="AEN9405"
  49532. ></A
  49533. ><P
  49534. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  49535. >aspell_check -- Zkontrolovat slovo</DIV
  49536. ><DIV
  49537. CLASS="refsect1"
  49538. ><A
  49539. NAME="AEN9408"
  49540. ></A
  49541. ><H2
  49542. >Popis</H2
  49543. >boolean <B
  49544. CLASS="methodname"
  49545. >aspell_check</B
  49546. > ( int dictionary_link, string word)<BR
  49547. ></BR
  49548. ><P
  49549. >      <B
  49550. CLASS="function"
  49551. >aspell_check()</B
  49552. > zkontroluje hlßskovßnφ slova a
  49553.      vrßtφ <TT
  49554. CLASS="constant"
  49555. ><B
  49556. >TRUE</B
  49557. ></TT
  49558. >, pokud je hlßskovßnφ sprßvnΘ, a
  49559.      <TT
  49560. CLASS="constant"
  49561. ><B
  49562. >FALSE</B
  49563. ></TT
  49564. >, pokud nenφ.
  49565.     </P
  49566. ><P
  49567. >      <TABLE
  49568. WIDTH="100%"
  49569. BORDER="0"
  49570. CELLPADDING="0"
  49571. CELLSPACING="0"
  49572. CLASS="EXAMPLE"
  49573. ><TR
  49574. ><TD
  49575. ><DIV
  49576. CLASS="example"
  49577. ><A
  49578. NAME="AEN9424"
  49579. ></A
  49580. ><P
  49581. ><B
  49582. >P°φklad 1. <B
  49583. CLASS="function"
  49584. >aspell_check()</B
  49585. ></B
  49586. ></P
  49587. ><TABLE
  49588. BORDER="0"
  49589. BGCOLOR="#E0E0E0"
  49590. CELLPADDING="5"
  49591. ><TR
  49592. ><TD
  49593. ><PRE
  49594. CLASS="programlisting"
  49595. >$aspell_link=aspell_new ("english");
  49596. if (aspell_check ($aspell_link, "testt")) {
  49597.     echo "Toto je platnΘ hlßskovßnφ";
  49598. } else {
  49599.     echo "Pardon, ╣patnΘ hlßskovßnφ";
  49600. }</PRE
  49601. ></TD
  49602. ></TR
  49603. ></TABLE
  49604. ></DIV
  49605. ></TD
  49606. ></TR
  49607. ></TABLE
  49608. >
  49609.     </P
  49610. ></DIV
  49611. ><H1
  49612. ><A
  49613. NAME="function.aspell-new"
  49614. ></A
  49615. >aspell_new</H1
  49616. ><DIV
  49617. CLASS="refnamediv"
  49618. ><A
  49619. NAME="AEN9429"
  49620. ></A
  49621. ><P
  49622. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  49623. >aspell_new -- NaΦφst nov² slovnφk</DIV
  49624. ><DIV
  49625. CLASS="refsect1"
  49626. ><A
  49627. NAME="AEN9432"
  49628. ></A
  49629. ><H2
  49630. >Popis</H2
  49631. >int <B
  49632. CLASS="methodname"
  49633. >aspell_new</B
  49634. > ( string master, string personal)<BR
  49635. ></BR
  49636. ><P
  49637. >      <B
  49638. CLASS="function"
  49639. >aspell_new()</B
  49640. > otev°e nov² slovnφk, a vrßtφ identifikßtor
  49641.      spojenφ na tento slovnφk vyu╛iteln² s dal╣φmi aspell funkcemi.
  49642.     </P
  49643. ><P
  49644. >      <TABLE
  49645. WIDTH="100%"
  49646. BORDER="0"
  49647. CELLPADDING="0"
  49648. CELLSPACING="0"
  49649. CLASS="EXAMPLE"
  49650. ><TR
  49651. ><TD
  49652. ><DIV
  49653. CLASS="example"
  49654. ><A
  49655. NAME="AEN9446"
  49656. ></A
  49657. ><P
  49658. ><B
  49659. >P°φklad 1. <B
  49660. CLASS="function"
  49661. >aspell_new()</B
  49662. ></B
  49663. ></P
  49664. ><TABLE
  49665. BORDER="0"
  49666. BGCOLOR="#E0E0E0"
  49667. CELLPADDING="5"
  49668. ><TR
  49669. ><TD
  49670. ><PRE
  49671. CLASS="php"
  49672. >$aspell_link=aspell_new ("english");</PRE
  49673. ></TD
  49674. ></TR
  49675. ></TABLE
  49676. ></DIV
  49677. ></TD
  49678. ></TR
  49679. ></TABLE
  49680. >
  49681.     </P
  49682. ></DIV
  49683. ><H1
  49684. ><A
  49685. NAME="function.aspell-suggest"
  49686. ></A
  49687. >aspell_suggest</H1
  49688. ><DIV
  49689. CLASS="refnamediv"
  49690. ><A
  49691. NAME="AEN9451"
  49692. ></A
  49693. ><P
  49694. >    (PHP 3>= 3.0.7, PHP 4  <= 4.2.3)</P
  49695. >aspell_suggest -- Nabφdnout mo╛nΘ hlßskovßnφ slova</DIV
  49696. ><DIV
  49697. CLASS="refsect1"
  49698. ><A
  49699. NAME="AEN9454"
  49700. ></A
  49701. ><H2
  49702. >Popis</H2
  49703. >array <B
  49704. CLASS="methodname"
  49705. >aspell_suggest</B
  49706. > ( int dictionary_link, string word)<BR
  49707. ></BR
  49708. ><P
  49709. >      <B
  49710. CLASS="function"
  49711. >aspell_suggest()</B
  49712. > vrßtφ pole mo╛n²ch hlßskovßnφ
  49713.      danΘho slova.
  49714.     </P
  49715. ><P
  49716. >      <TABLE
  49717. WIDTH="100%"
  49718. BORDER="0"
  49719. CELLPADDING="0"
  49720. CELLSPACING="0"
  49721. CLASS="EXAMPLE"
  49722. ><TR
  49723. ><TD
  49724. ><DIV
  49725. CLASS="example"
  49726. ><A
  49727. NAME="AEN9468"
  49728. ></A
  49729. ><P
  49730. ><B
  49731. >P°φklad 1. <B
  49732. CLASS="function"
  49733. >aspell_suggest()</B
  49734. ></B
  49735. ></P
  49736. ><TABLE
  49737. BORDER="0"
  49738. BGCOLOR="#E0E0E0"
  49739. CELLPADDING="5"
  49740. ><TR
  49741. ><TD
  49742. ><PRE
  49743. CLASS="php"
  49744. >$aspell_link=aspell_new ("english");
  49745.  
  49746. if (!aspell_check ($aspell_link, "test")) {
  49747.     $suggestions=aspell_suggest ($aspell_link, "test");
  49748.  
  49749.     for ($i=0; $i < count ($suggestions); $i++) {
  49750.         echo "Mo╛nΘ hlßskovßnφ: " . $suggestions[$i] . "<br>";
  49751.     }
  49752. }</PRE
  49753. ></TD
  49754. ></TR
  49755. ></TABLE
  49756. ></DIV
  49757. ></TD
  49758. ></TR
  49759. ></TABLE
  49760. >
  49761.     </P
  49762. ></DIV
  49763. ></DIV
  49764. ><DIV
  49765. CLASS="reference"
  49766. ><A
  49767. NAME="ref.bc"
  49768. ></A
  49769. ><DIV
  49770. CLASS="TITLEPAGE"
  49771. ><H1
  49772. CLASS="title"
  49773. >IV. BCMath funkce pro v²poΦty s libovolnou p°esnostφ</H1
  49774. ><DIV
  49775. CLASS="PARTINTRO"
  49776. ><A
  49777. NAME="AEN9475"
  49778. ></A
  49779. ><DIV
  49780. CLASS="section"
  49781. ><H1
  49782. CLASS="section"
  49783. ><A
  49784. NAME="bc.intro"
  49785. ></A
  49786. >┌vod</H1
  49787. ><P
  49788. >      Pro prßci s Φφsly libovolnΘ p°esnosti PHP nabφzφ Binary Calculator, kter²
  49789.      podporuje Φφsla libovoln∞ velkß a s libovolnou p°esnostφ, kterß jsou reprezentovßna jako °et∞zce.
  49790.     </P
  49791. ></DIV
  49792. ><DIV
  49793. CLASS="section"
  49794. ><HR><H1
  49795. CLASS="section"
  49796. ><A
  49797. NAME="bc.requirements"
  49798. ></A
  49799. >Po╛adavky</H1
  49800. ><P
  49801. >      Od PHP 4.0.4 je knihovna libbcmath dodßvßna s PHP. Pro toto roz╣φ°enφ tedy
  49802.      nepot°ebujete ╛ßdnΘ externφ knihovny.
  49803.     </P
  49804. ></DIV
  49805. ><DIV
  49806. CLASS="section"
  49807. ><HR><H1
  49808. CLASS="section"
  49809. ><A
  49810. NAME="bc.installation"
  49811. ></A
  49812. >Instalace</H1
  49813. ><P
  49814. >   Tyto funkce jsou v PHP 4 dostupnΘ pouze pokud bylo PHP zkonfigurovßno s volbou
  49815.   <TT
  49816. CLASS="option"
  49817. >--enable-bcmath</TT
  49818. >.
  49819.   V PHP 3 jsou dostupnΘ, pokud nebylo zkonfigurovßno
  49820.   s volbou <TT
  49821. CLASS="option"
  49822. >--disable-bcmath</TT
  49823. >.
  49824.  </P
  49825. ><P
  49826. >Verze <TT
  49827. CLASS="literal"
  49828. >PHP</TT
  49829. > pro Windows
  49830. mß vestav∞nou podporu pro toto roz╣φ°enφ. K pou╛itφ t∞chto funkcφ nenφ t°eba
  49831. naΦφtat ╛ßdnß dal╣φ roz╣φ°enφ.</P
  49832. ></DIV
  49833. ><DIV
  49834. CLASS="section"
  49835. ><HR><H1
  49836. CLASS="section"
  49837. ><A
  49838. NAME="bc.configuration"
  49839. ></A
  49840. >Konfigurace b∞hu</H1
  49841. ><P
  49842. > Chovßnφ t∞chto funkcφ je ovlivn∞no nastavenφm parametr∙ v <TT
  49843. CLASS="filename"
  49844. >php.ini</TT
  49845. >.
  49846. </P
  49847. ><P
  49848. >  <DIV
  49849. CLASS="table"
  49850. ><A
  49851. NAME="AEN9494"
  49852. ></A
  49853. ><P
  49854. ><B
  49855. >Tabulka 1. BC math configuration options</B
  49856. ></P
  49857. ><TABLE
  49858. BORDER="1"
  49859. CLASS="CALSTABLE"
  49860. ><THEAD
  49861. ><TR
  49862. ><TH
  49863. ALIGN="LEFT"
  49864. VALIGN="MIDDLE"
  49865. >Name</TH
  49866. ><TH
  49867. ALIGN="LEFT"
  49868. VALIGN="MIDDLE"
  49869. >Default</TH
  49870. ><TH
  49871. ALIGN="LEFT"
  49872. VALIGN="MIDDLE"
  49873. >Changeable</TH
  49874. ></TR
  49875. ></THEAD
  49876. ><TBODY
  49877. ><TR
  49878. ><TD
  49879. ALIGN="LEFT"
  49880. VALIGN="MIDDLE"
  49881. >bcmath.scale</TD
  49882. ><TD
  49883. ALIGN="LEFT"
  49884. VALIGN="MIDDLE"
  49885. >0</TD
  49886. ><TD
  49887. ALIGN="LEFT"
  49888. VALIGN="MIDDLE"
  49889. >PHP_INI_ALL</TD
  49890. ></TR
  49891. ></TBODY
  49892. ></TABLE
  49893. ></DIV
  49894. >
  49895.   For further details and definition of the PHP_INI_* constants see
  49896.   <A
  49897. HREF="#function.ini-set"
  49898. ><B
  49899. CLASS="function"
  49900. >ini_set()</B
  49901. ></A
  49902. >.
  49903.  </P
  49904. ><P
  49905. >Zde je struΦnΘ vysv∞tlenφ
  49906. konfiguraΦnφch direktiv.</P
  49907. ><P
  49908. >   <P
  49909. ></P
  49910. ><DIV
  49911. CLASS="variablelist"
  49912. ><DL
  49913. ><DT
  49914. ><A
  49915. NAME="ini.bcmath.scale"
  49916. ></A
  49917. ><TT
  49918. CLASS="parameter"
  49919. ><I
  49920. >bcmath.scale</I
  49921. ></TT
  49922. >
  49923.      <A
  49924. HREF="#language.types.integer"
  49925. ><B
  49926. CLASS="type"
  49927. >integer</B
  49928. ></A
  49929. ></DT
  49930. ><DD
  49931. ><P
  49932. >       Number of decimal digits for all bcmath functions.
  49933.      </P
  49934. ></DD
  49935. ></DL
  49936. ></DIV
  49937. >
  49938.  </P
  49939. ></DIV
  49940. ><DIV
  49941. CLASS="section"
  49942. ><HR><H1
  49943. CLASS="section"
  49944. ><A
  49945. NAME="bc.resources"
  49946. ></A
  49947. >Typy prost°edk∙</H1
  49948. ><P
  49949. >Toto roz╣φ°enφ nemß definovßn ╛ßdn² typ prost°edku
  49950. (resource).</P
  49951. ></DIV
  49952. ><DIV
  49953. CLASS="section"
  49954. ><HR><H1
  49955. CLASS="section"
  49956. ><A
  49957. NAME="bc.constants"
  49958. ></A
  49959. >P°eddefinovanΘ konstanty</H1
  49960. ><P
  49961. >Toto roz╣φ°enφ nemß definovßny ╛ßdnΘ
  49962. konstanty.</P
  49963. ></DIV
  49964. ></DIV
  49965. ><DIV
  49966. CLASS="TOC"
  49967. ><DL
  49968. ><DT
  49969. ><B
  49970. >Obsah</B
  49971. ></DT
  49972. ><DT
  49973. ><A
  49974. HREF="#function.bcadd"
  49975. >bcadd</A
  49976. > -- SeΦφst dv∞ Φφsla s libovolnou p°esnostφ</DT
  49977. ><DT
  49978. ><A
  49979. HREF="#function.bccomp"
  49980. >bccomp</A
  49981. > -- Porovnat dv∞ Φφsla s libovolnou p°esnostφ</DT
  49982. ><DT
  49983. ><A
  49984. HREF="#function.bcdiv"
  49985. >bcdiv</A
  49986. > -- D∞lit dv∞ Φφsla s libovolnou p°esnostφ</DT
  49987. ><DT
  49988. ><A
  49989. HREF="#function.bcmod"
  49990. >bcmod</A
  49991. > -- Zφskat modulus Φφsla s libovolnou p°esnostφ</DT
  49992. ><DT
  49993. ><A
  49994. HREF="#function.bcmul"
  49995. >bcmul</A
  49996. > -- Vynßsobit dv∞ Φφsla s libovolnou p°esnostφ</DT
  49997. ><DT
  49998. ><A
  49999. HREF="#function.bcpow"
  50000. >bcpow</A
  50001. > -- 
  50002.     Umocnit jedno Φφslo na jinΘ s libovolnou p°esnostφ
  50003.     </DT
  50004. ><DT
  50005. ><A
  50006. HREF="#function.bcpowmod"
  50007. >bcpowmod</A
  50008. > -- 
  50009.      Raise an arbitrary precision number to another, reduced by a specified modulus.
  50010.     </DT
  50011. ><DT
  50012. ><A
  50013. HREF="#function.bcscale"
  50014. >bcscale</A
  50015. > -- Nastavit v²chozφ ╣kßlu pro v╣echny bc math funkce
  50016.     </DT
  50017. ><DT
  50018. ><A
  50019. HREF="#function.bcsqrt"
  50020. >bcsqrt</A
  50021. > -- 
  50022.     Zφskat druhou odmocninu Φφsla s libovolnou p°esnostφ
  50023.     </DT
  50024. ><DT
  50025. ><A
  50026. HREF="#function.bcsub"
  50027. >bcsub</A
  50028. > -- 
  50029.     OdeΦφst jedno Φφslo od druhΘho s libovolnou p°esnostφ
  50030.     </DT
  50031. ></DL
  50032. ></DIV
  50033. ></DIV
  50034. ><H1
  50035. ><A
  50036. NAME="function.bcadd"
  50037. ></A
  50038. >bcadd</H1
  50039. ><DIV
  50040. CLASS="refnamediv"
  50041. ><A
  50042. NAME="AEN9524"
  50043. ></A
  50044. ><P
  50045. >    (PHP 3, PHP 4 )</P
  50046. >bcadd -- SeΦφst dv∞ Φφsla s libovolnou p°esnostφ</DIV
  50047. ><DIV
  50048. CLASS="refsect1"
  50049. ><A
  50050. NAME="AEN9527"
  50051. ></A
  50052. ><H2
  50053. >Popis</H2
  50054. >string <B
  50055. CLASS="methodname"
  50056. >bcadd</B
  50057. > ( string left operand, string right operand [, int scale])<BR
  50058. ></BR
  50059. ><P
  50060. >      P°iΦte <TT
  50061. CLASS="parameter"
  50062. ><I
  50063. >left operand</I
  50064. ></TT
  50065. > k
  50066.      <TT
  50067. CLASS="parameter"
  50068. ><I
  50069. >right operand</I
  50070. ></TT
  50071. > a vrßtφ souΦet v °et∞zci.
  50072.      Voliteln² argument <TT
  50073. CLASS="parameter"
  50074. ><I
  50075. >scale</I
  50076. ></TT
  50077. > se pou╛φvß k
  50078.      urΦenφ poΦtu desetinn²ch mφst ve v²sledku.
  50079.     </P
  50080. ><P
  50081. >      Viz takΘ <A
  50082. HREF="#function.bcsub"
  50083. ><B
  50084. CLASS="function"
  50085. >bcsub()</B
  50086. ></A
  50087. >.
  50088.     </P
  50089. ></DIV
  50090. ><H1
  50091. ><A
  50092. NAME="function.bccomp"
  50093. ></A
  50094. >bccomp</H1
  50095. ><DIV
  50096. CLASS="refnamediv"
  50097. ><A
  50098. NAME="AEN9548"
  50099. ></A
  50100. ><P
  50101. >    (PHP 3, PHP 4 )</P
  50102. >bccomp -- Porovnat dv∞ Φφsla s libovolnou p°esnostφ</DIV
  50103. ><DIV
  50104. CLASS="refsect1"
  50105. ><A
  50106. NAME="AEN9551"
  50107. ></A
  50108. ><H2
  50109. >Popis</H2
  50110. >int <B
  50111. CLASS="methodname"
  50112. >bccomp</B
  50113. > ( string left operand, string right operand [, int scale])<BR
  50114. ></BR
  50115. ><P
  50116. >     Porovnß <TT
  50117. CLASS="parameter"
  50118. ><I
  50119. >left operand</I
  50120. ></TT
  50121. > s
  50122.      <TT
  50123. CLASS="parameter"
  50124. ><I
  50125. >right operand</I
  50126. ></TT
  50127. > a vrßtφ v²sledek jako integer.
  50128.      Voliteln² argument <TT
  50129. CLASS="parameter"
  50130. ><I
  50131. >scale</I
  50132. ></TT
  50133. > se pou╛φvß k
  50134.      urΦenφ poΦtu desetinn²ch mφst pou╛it²ch p°i porovnßnφ. Nßvratovß hodnota
  50135.      je 0, pokud jsou si oba operandy rovnΘ. Pokud je
  50136.      <TT
  50137. CLASS="parameter"
  50138. ><I
  50139. >left operand</I
  50140. ></TT
  50141. > v∞t╣φ ne╛
  50142.      <TT
  50143. CLASS="parameter"
  50144. ><I
  50145. >right operand</I
  50146. ></TT
  50147. >, nßvratovß hodnota je +1, a pokud je
  50148.      <TT
  50149. CLASS="parameter"
  50150. ><I
  50151. >left operand</I
  50152. ></TT
  50153. > men╣φ ne╛
  50154.      <TT
  50155. CLASS="parameter"
  50156. ><I
  50157. >right operand</I
  50158. ></TT
  50159. >, nßvratovß hodnota je -1.
  50160.     </P
  50161. ></DIV
  50162. ><H1
  50163. ><A
  50164. NAME="function.bcdiv"
  50165. ></A
  50166. >bcdiv</H1
  50167. ><DIV
  50168. CLASS="refnamediv"
  50169. ><A
  50170. NAME="AEN9574"
  50171. ></A
  50172. ><P
  50173. >    (PHP 3, PHP 4 )</P
  50174. >bcdiv -- D∞lit dv∞ Φφsla s libovolnou p°esnostφ</DIV
  50175. ><DIV
  50176. CLASS="refsect1"
  50177. ><A
  50178. NAME="AEN9577"
  50179. ></A
  50180. ><H2
  50181. >Popis</H2
  50182. >string <B
  50183. CLASS="methodname"
  50184. >bcdiv</B
  50185. > ( string left operand, string right operand [, int scale])<BR
  50186. ></BR
  50187. ><P
  50188. >     Vyd∞lφ argument <TT
  50189. CLASS="parameter"
  50190. ><I
  50191. >left operand</I
  50192. ></TT
  50193. > argumentem
  50194.     <TT
  50195. CLASS="parameter"
  50196. ><I
  50197. >right operand</I
  50198. ></TT
  50199. > a vrßtφ v²sledek.
  50200.     Voliteln² argument <TT
  50201. CLASS="parameter"
  50202. ><I
  50203. >scale</I
  50204. ></TT
  50205. > se pou╛φvß k
  50206.     urΦenφ poΦtu desetinn²ch mφst ve v²sledku.
  50207.     </P
  50208. ><P
  50209. >      Viz takΘ <A
  50210. HREF="#function.bcmul"
  50211. ><B
  50212. CLASS="function"
  50213. >bcmul()</B
  50214. ></A
  50215. >.
  50216.     </P
  50217. ></DIV
  50218. ><H1
  50219. ><A
  50220. NAME="function.bcmod"
  50221. ></A
  50222. >bcmod</H1
  50223. ><DIV
  50224. CLASS="refnamediv"
  50225. ><A
  50226. NAME="AEN9598"
  50227. ></A
  50228. ><P
  50229. >    (PHP 3, PHP 4 )</P
  50230. >bcmod -- Zφskat modulus Φφsla s libovolnou p°esnostφ</DIV
  50231. ><DIV
  50232. CLASS="refsect1"
  50233. ><A
  50234. NAME="AEN9601"
  50235. ></A
  50236. ><H2
  50237. >Popis</H2
  50238. >string <B
  50239. CLASS="methodname"
  50240. >bcmod</B
  50241. > ( string left operand, string modulus)<BR
  50242. ></BR
  50243. ><P
  50244. >     Vrßtφ modulus argumentu <TT
  50245. CLASS="parameter"
  50246. ><I
  50247. >left operand</I
  50248. ></TT
  50249. > s pou╛itφm
  50250.     argumentu <TT
  50251. CLASS="parameter"
  50252. ><I
  50253. >modulus</I
  50254. ></TT
  50255. >.
  50256.     </P
  50257. ><P
  50258. >      Viz takΘ <A
  50259. HREF="#function.bcdiv"
  50260. ><B
  50261. CLASS="function"
  50262. >bcdiv()</B
  50263. ></A
  50264. >.
  50265.     </P
  50266. ></DIV
  50267. ><H1
  50268. ><A
  50269. NAME="function.bcmul"
  50270. ></A
  50271. >bcmul</H1
  50272. ><DIV
  50273. CLASS="refnamediv"
  50274. ><A
  50275. NAME="AEN9618"
  50276. ></A
  50277. ><P
  50278. >    (PHP 3, PHP 4 )</P
  50279. >bcmul -- Vynßsobit dv∞ Φφsla s libovolnou p°esnostφ</DIV
  50280. ><DIV
  50281. CLASS="refsect1"
  50282. ><A
  50283. NAME="AEN9621"
  50284. ></A
  50285. ><H2
  50286. >Popis</H2
  50287. >string <B
  50288. CLASS="methodname"
  50289. >bcmul</B
  50290. > ( string left operand, string right operand [, int scale])<BR
  50291. ></BR
  50292. ><P
  50293. >     Vynßsobφ argument <TT
  50294. CLASS="parameter"
  50295. ><I
  50296. >left operand</I
  50297. ></TT
  50298. > argumentem
  50299.     <TT
  50300. CLASS="parameter"
  50301. ><I
  50302. >right operand</I
  50303. ></TT
  50304. > a vrßtφ v²sledek.
  50305.     Voliteln² argument <TT
  50306. CLASS="parameter"
  50307. ><I
  50308. >scale</I
  50309. ></TT
  50310. > se pou╛φvß k
  50311.     urΦenφ poΦtu desetinn²ch mφst ve v²sledku.
  50312.     </P
  50313. ><P
  50314. >      Viz takΘ <A
  50315. HREF="#function.bcdiv"
  50316. ><B
  50317. CLASS="function"
  50318. >bcdiv()</B
  50319. ></A
  50320. >.
  50321.     </P
  50322. ></DIV
  50323. ><H1
  50324. ><A
  50325. NAME="function.bcpow"
  50326. ></A
  50327. >bcpow</H1
  50328. ><DIV
  50329. CLASS="refnamediv"
  50330. ><A
  50331. NAME="AEN9642"
  50332. ></A
  50333. ><P
  50334. >    (PHP 3, PHP 4 )</P
  50335. >bcpow -- 
  50336.     Umocnit jedno Φφslo na jinΘ s libovolnou p°esnostφ
  50337.     </DIV
  50338. ><DIV
  50339. CLASS="refsect1"
  50340. ><A
  50341. NAME="AEN9645"
  50342. ></A
  50343. ><H2
  50344. >Popis</H2
  50345. >string <B
  50346. CLASS="methodname"
  50347. >bcpow</B
  50348. > ( string x, string y [, int scale])<BR
  50349. ></BR
  50350. ><P
  50351. >      Umocnφ <TT
  50352. CLASS="parameter"
  50353. ><I
  50354. >x</I
  50355. ></TT
  50356. > na <TT
  50357. CLASS="parameter"
  50358. ><I
  50359. >y</I
  50360. ></TT
  50361. >.
  50362.      Voliteln² argument <TT
  50363. CLASS="parameter"
  50364. ><I
  50365. >scale</I
  50366. ></TT
  50367. > se pou╛φvß k
  50368.      urΦenφ poΦtu desetinn²ch mφst ve v²sledku.
  50369.     </P
  50370. ><P
  50371. >      Viz takΘ <A
  50372. HREF="#function.bcsqrt"
  50373. ><B
  50374. CLASS="function"
  50375. >bcsqrt()</B
  50376. ></A
  50377. >.
  50378.     </P
  50379. ></DIV
  50380. ><H1
  50381. ><A
  50382. NAME="function.bcpowmod"
  50383. ></A
  50384. >bcpowmod</H1
  50385. ><DIV
  50386. CLASS="refnamediv"
  50387. ><A
  50388. NAME="AEN9666"
  50389. ></A
  50390. ><P
  50391. >    (PHP 5 CVS only)</P
  50392. >bcpowmod -- 
  50393.      Raise an arbitrary precision number to another, reduced by a specified modulus.
  50394.     </DIV
  50395. ><DIV
  50396. CLASS="refsect1"
  50397. ><A
  50398. NAME="AEN9669"
  50399. ></A
  50400. ><H2
  50401. >Description</H2
  50402. >string <B
  50403. CLASS="methodname"
  50404. >bcpowmod</B
  50405. > ( string x, string y, string modulus [, int scale])<BR
  50406. ></BR
  50407. ><P
  50408. >      Use the fast-exponentiation method to raise <TT
  50409. CLASS="parameter"
  50410. ><I
  50411. >x</I
  50412. ></TT
  50413. > 
  50414.      to the power <TT
  50415. CLASS="parameter"
  50416. ><I
  50417. >y</I
  50418. ></TT
  50419. > with respect to the modulus
  50420.      <TT
  50421. CLASS="parameter"
  50422. ><I
  50423. >modulus</I
  50424. ></TT
  50425. >.  The optional
  50426.      <TT
  50427. CLASS="parameter"
  50428. ><I
  50429. >scale</I
  50430. ></TT
  50431. > can be used to set the number of
  50432.      digits after the decimal place in the result. 
  50433.     </P
  50434. ><P
  50435. >      The following two statements are functionally identical.  The 
  50436.      <B
  50437. CLASS="function"
  50438. >bcpowmod()</B
  50439. > version however, executes in 
  50440.      less time and can accept larger parameters.
  50441.      <DIV
  50442. CLASS="informalexample"
  50443. ><A
  50444. NAME="AEN9693"
  50445. ></A
  50446. ><P
  50447. ></P
  50448. ><TABLE
  50449. BORDER="0"
  50450. BGCOLOR="#E0E0E0"
  50451. CELLPADDING="5"
  50452. ><TR
  50453. ><TD
  50454. ><PRE
  50455. CLASS="php"
  50456. ><?php
  50457. $a = bcpowmod($x, $y, $mod);
  50458.  
  50459. $b = bcmod(bcpow($x, $y), $mod);
  50460.  
  50461. // $a and $b are equal to each other. 
  50462.  
  50463. ?></PRE
  50464. ></TD
  50465. ></TR
  50466. ></TABLE
  50467. ><P
  50468. ></P
  50469. ></DIV
  50470. >
  50471.     </P
  50472. ><P
  50473. >      <DIV
  50474. CLASS="note"
  50475. ><BLOCKQUOTE
  50476. CLASS="note"
  50477. ><P
  50478. ><B
  50479. >Poznßmka: </B
  50480. >
  50481.        Because this method uses the modulus operation, non-natural numbers
  50482.        may give unexpected results.  A natural number is any positive 
  50483.        non-zero integer.
  50484.       </P
  50485. ></BLOCKQUOTE
  50486. ></DIV
  50487. >
  50488.     </P
  50489. ><P
  50490. >      See also <A
  50491. HREF="#function.bcpow"
  50492. ><B
  50493. CLASS="function"
  50494. >bcpow()</B
  50495. ></A
  50496. >, and
  50497.      <A
  50498. HREF="#function.bcmod"
  50499. ><B
  50500. CLASS="function"
  50501. >bcmod()</B
  50502. ></A
  50503. >.
  50504.     </P
  50505. ></DIV
  50506. ><H1
  50507. ><A
  50508. NAME="function.bcscale"
  50509. ></A
  50510. >bcscale</H1
  50511. ><DIV
  50512. CLASS="refnamediv"
  50513. ><A
  50514. NAME="AEN9702"
  50515. ></A
  50516. ><P
  50517. >    (PHP 3, PHP 4 )</P
  50518. >bcscale -- Nastavit v²chozφ ╣kßlu pro v╣echny bc math funkce
  50519.     </DIV
  50520. ><DIV
  50521. CLASS="refsect1"
  50522. ><A
  50523. NAME="AEN9705"
  50524. ></A
  50525. ><H2
  50526. >Popis</H2
  50527. >string <B
  50528. CLASS="methodname"
  50529. >bcscale</B
  50530. > ( int scale)<BR
  50531. ></BR
  50532. ><P
  50533. >     Tato funkce nastavφ v²chozφ ╣kßlu pro v╣echna nßslednß volßnφ
  50534.     bc math funkcφ, ktera neudßvajφ explicitn∞ ╣kßlu p°esnosti.
  50535.     </P
  50536. ></DIV
  50537. ><H1
  50538. ><A
  50539. NAME="function.bcsqrt"
  50540. ></A
  50541. >bcsqrt</H1
  50542. ><DIV
  50543. CLASS="refnamediv"
  50544. ><A
  50545. NAME="AEN9715"
  50546. ></A
  50547. ><P
  50548. >    (PHP 3, PHP 4 )</P
  50549. >bcsqrt -- 
  50550.     Zφskat druhou odmocninu Φφsla s libovolnou p°esnostφ
  50551.     </DIV
  50552. ><DIV
  50553. CLASS="refsect1"
  50554. ><A
  50555. NAME="AEN9718"
  50556. ></A
  50557. ><H2
  50558. >Popis</H2
  50559. >string <B
  50560. CLASS="methodname"
  50561. >bcsqrt</B
  50562. > ( string operand, int scale)<BR
  50563. ></BR
  50564. ><P
  50565. >     Vrßtφ druhou odmocninu argumentu <TT
  50566. CLASS="parameter"
  50567. ><I
  50568. >operand</I
  50569. ></TT
  50570. >.
  50571.     Voliteln² argument <TT
  50572. CLASS="parameter"
  50573. ><I
  50574. >scale</I
  50575. ></TT
  50576. > se pou╛φvß k
  50577.     urΦenφ poΦtu desetinn²ch mφst ve v²sledku.
  50578.     </P
  50579. ><P
  50580. >     Viz takΘ <A
  50581. HREF="#function.bcpow"
  50582. ><B
  50583. CLASS="function"
  50584. >bcpow()</B
  50585. ></A
  50586. >.
  50587.     </P
  50588. ></DIV
  50589. ><H1
  50590. ><A
  50591. NAME="function.bcsub"
  50592. ></A
  50593. >bcsub</H1
  50594. ><DIV
  50595. CLASS="refnamediv"
  50596. ><A
  50597. NAME="AEN9735"
  50598. ></A
  50599. ><P
  50600. >    (PHP 3, PHP 4 )</P
  50601. >bcsub -- 
  50602.     OdeΦφst jedno Φφslo od druhΘho s libovolnou p°esnostφ
  50603.     </DIV
  50604. ><DIV
  50605. CLASS="refsect1"
  50606. ><A
  50607. NAME="AEN9738"
  50608. ></A
  50609. ><H2
  50610. >Popis</H2
  50611. >string <B
  50612. CLASS="methodname"
  50613. >bcsub</B
  50614. > ( string left operand, string right operand [, int scale])<BR
  50615. ></BR
  50616. ><P
  50617. >     OdeΦte argument <TT
  50618. CLASS="parameter"
  50619. ><I
  50620. >right operand</I
  50621. ></TT
  50622. > od argumentu
  50623.     <TT
  50624. CLASS="parameter"
  50625. ><I
  50626. >left operand</I
  50627. ></TT
  50628. > a vrßtφ v²sledek v °et∞zci.
  50629.     Voliteln² argument <TT
  50630. CLASS="parameter"
  50631. ><I
  50632. >scale</I
  50633. ></TT
  50634. > se pou╛φvß k
  50635.     urΦenφ poΦtu desetinn²ch mφst ve v²sledku.
  50636.     </P
  50637. ><P
  50638. >     Viz takΘ <A
  50639. HREF="#function.bcadd"
  50640. ><B
  50641. CLASS="function"
  50642. >bcadd()</B
  50643. ></A
  50644. >.
  50645.     </P
  50646. ></DIV
  50647. ></DIV
  50648. ><DIV
  50649. CLASS="reference"
  50650. ><A
  50651. NAME="ref.bzip2"
  50652. ></A
  50653. ><DIV
  50654. CLASS="TITLEPAGE"
  50655. ><H1
  50656. CLASS="title"
  50657. >V. Kompresnφ funkce bzip2</H1
  50658. ><DIV
  50659. CLASS="PARTINTRO"
  50660. ><A
  50661. NAME="AEN9761"
  50662. ></A
  50663. ><DIV
  50664. CLASS="section"
  50665. ><H1
  50666. CLASS="section"
  50667. ><A
  50668. NAME="bzip2.intro"
  50669. ></A
  50670. >┌vod</H1
  50671. ><P
  50672. >      Funkce bzip2 se pou╛φvajφ k transparentnφmu Φtenφ a zßpisu soubor∙
  50673.      komprimovan²ch algoritmem bzip2 (.bz2).
  50674.     </P
  50675. ></DIV
  50676. ><DIV
  50677. CLASS="section"
  50678. ><HR><H1
  50679. CLASS="section"
  50680. ><A
  50681. NAME="bzip2.requirements"
  50682. ></A
  50683. >Po╛adavky</H1
  50684. ><P
  50685. >      Tento modul pou╛φvß funkce z knihovny <A
  50686. HREF="http://sources.redhat.com/bzip2/"
  50687. TARGET="_top"
  50688. >bzip2</A
  50689. > od Juliana Sewarda.
  50690.      Tento modul vy╛aduje bzip2/libbzip2 verze >= 1.0.x.
  50691.     </P
  50692. ></DIV
  50693. ><DIV
  50694. CLASS="section"
  50695. ><HR><H1
  50696. CLASS="section"
  50697. ><A
  50698. NAME="bzip2.installation"
  50699. ></A
  50700. >Instalace</H1
  50701. ><P
  50702. >   Podpora bzip2 nenφ v PHP implicitn∞ k dispozici. K aktivaci budete muset
  50703.   p°i kompilaci PHP pou╛φt konfiguraΦnφ volbu
  50704.   <TT
  50705. CLASS="option"
  50706. >--with-bz2[=DIR]</TT
  50707. >.
  50708.  </P
  50709. ></DIV
  50710. ><DIV
  50711. CLASS="section"
  50712. ><HR><H1
  50713. CLASS="section"
  50714. ><A
  50715. NAME="bzip2.configuration"
  50716. ></A
  50717. >Konfigurace b∞hu</H1
  50718. ><P
  50719. >Toto roz╣φ°enφ nemß definovßno ╛ßdnΘ konfiguraΦnφ
  50720. direktivy.</P
  50721. ></DIV
  50722. ><DIV
  50723. CLASS="section"
  50724. ><HR><H1
  50725. CLASS="section"
  50726. ><A
  50727. NAME="bzip2.resources"
  50728. ></A
  50729. >Typy prost°edk∙</H1
  50730. ><P
  50731. >      Toto roz╣φ°enφ definuje jeden typ prost°edku: souborov² ukazatel
  50732.      identifikujφcφ soubor bz2, nad kter²m se pracuje.
  50733.     </P
  50734. ></DIV
  50735. ><DIV
  50736. CLASS="section"
  50737. ><HR><H1
  50738. CLASS="section"
  50739. ><A
  50740. NAME="bzip2.constants"
  50741. ></A
  50742. >P°eddefinovanΘ konstanty</H1
  50743. ><P
  50744. >Toto roz╣φ°enφ nemß definovßny ╛ßdnΘ
  50745. konstanty.</P
  50746. ></DIV
  50747. ><DIV
  50748. CLASS="section"
  50749. ><HR><H1
  50750. CLASS="section"
  50751. ><A
  50752. NAME="bzip2.examples"
  50753. ></A
  50754. >P°φklady</H1
  50755. ><P
  50756. >      Tento p°φklad otev°e doΦasn² soubor a zapφ╣e do n∞j testovacφ °etezec;
  50757.      potom vypφ╣e obsah souboru.
  50758.     </P
  50759. ><TABLE
  50760. WIDTH="100%"
  50761. BORDER="0"
  50762. CELLPADDING="0"
  50763. CELLSPACING="0"
  50764. CLASS="EXAMPLE"
  50765. ><TR
  50766. ><TD
  50767. ><DIV
  50768. CLASS="example"
  50769. ><A
  50770. NAME="AEN9785"
  50771. ></A
  50772. ><P
  50773. ><B
  50774. >P°φklad 1. Mal² p°φklad na bzip2</B
  50775. ></P
  50776. ><TABLE
  50777. BORDER="0"
  50778. BGCOLOR="#E0E0E0"
  50779. CELLPADDING="5"
  50780. ><TR
  50781. ><TD
  50782. ><PRE
  50783. CLASS="php"
  50784. ><?php
  50785.  
  50786. $filename = "/tmp/testfile.bz2";
  50787. $str = "Toto je testovacφ °et∞zec.\n";
  50788.  
  50789. // otev°i soubor pro zßpis
  50790. $bz = bzopen($filename, "w");
  50791.  
  50792. // zapo╣ °et∞zec do souboru
  50793. bzwrite($bz, $str);
  50794.  
  50795. // zav°i soubor
  50796. bzclose($bz);
  50797.  
  50798. // otev°i soubor pro Φtenφ
  50799. $bz = bzopen($filename, "r");
  50800.  
  50801. // p°eΦti 10 znak∙
  50802. print bzread($bz, 10);
  50803.  
  50804. // tiskni dokud nenφ konec souboru (nebo nßsledujφcφ 1024. znak) a zav°i soubor  
  50805. print bzread($bz);
  50806.  
  50807. bzclose($bz);
  50808.  
  50809. ?></PRE
  50810. ></TD
  50811. ></TR
  50812. ></TABLE
  50813. ></DIV
  50814. ></TD
  50815. ></TR
  50816. ></TABLE
  50817. ></DIV
  50818. ></DIV
  50819. ><DIV
  50820. CLASS="TOC"
  50821. ><DL
  50822. ><DT
  50823. ><B
  50824. >Obsah</B
  50825. ></DT
  50826. ><DT
  50827. ><A
  50828. HREF="#function.bzclose"
  50829. >bzclose</A
  50830. > -- Zav°e ukazatel na soubor bzip2</DT
  50831. ><DT
  50832. ><A
  50833. HREF="#function.bzcompress"
  50834. >bzcompress</A
  50835. > -- Zkomprimuje °et∞zec algoritmem bzip2</DT
  50836. ><DT
  50837. ><A
  50838. HREF="#function.bzdecompress"
  50839. >bzdecompress</A
  50840. > -- Dekomprimuje data komprimovanß pomocφ bzip2</DT
  50841. ><DT
  50842. ><A
  50843. HREF="#function.bzerrno"
  50844. >bzerrno</A
  50845. > -- Vracφ Φφslo chyby bzip2</DT
  50846. ><DT
  50847. ><A
  50848. HREF="#function.bzerror"
  50849. >bzerror</A
  50850. > -- Vracφ v poli Φφslo a popis chyby bzip2</DT
  50851. ><DT
  50852. ><A
  50853. HREF="#function.bzerrstr"
  50854. >bzerrstr</A
  50855. > -- Vracφ popis chyby bzip2</DT
  50856. ><DT
  50857. ><A
  50858. HREF="#function.bzflush"
  50859. >bzflush</A
  50860. > -- Vynutφ zßpis v╣ech bufferovan²ch dat</DT
  50861. ><DT
  50862. ><A
  50863. HREF="#function.bzopen"
  50864. >bzopen</A
  50865. > -- Otev°e soubor komprimovan² pomocφ bzip2</DT
  50866. ><DT
  50867. ><A
  50868. HREF="#function.bzread"
  50869. >bzread</A
  50870. > -- Binßrn∞ bezpeΦnΘ Φtenφ ze souboru bzip2</DT
  50871. ><DT
  50872. ><A
  50873. HREF="#function.bzwrite"
  50874. >bzwrite</A
  50875. > -- Binßrn∞ bezpeΦn² zßpis do souboru bzip2</DT
  50876. ></DL
  50877. ></DIV
  50878. ></DIV
  50879. ><H1
  50880. ><A
  50881. NAME="function.bzclose"
  50882. ></A
  50883. >bzclose</H1
  50884. ><DIV
  50885. CLASS="refnamediv"
  50886. ><A
  50887. NAME="AEN9789"
  50888. ></A
  50889. ><P
  50890. >    (4.0.4 - 4.3.2 only)</P
  50891. >bzclose -- Zav°e ukazatel na soubor bzip2</DIV
  50892. ><DIV
  50893. CLASS="refsect1"
  50894. ><A
  50895. NAME="AEN9792"
  50896. ></A
  50897. ><H2
  50898. >Popis</H2
  50899. >int <B
  50900. CLASS="methodname"
  50901. >bzclose</B
  50902. > ( resource bz)<BR
  50903. ></BR
  50904. ><P
  50905. >      Zav°e soubor bzip2 odkazovan² ukazatelem <TT
  50906. CLASS="parameter"
  50907. ><I
  50908. >bz</I
  50909. ></TT
  50910. >.
  50911.     </P
  50912. ><P
  50913. >      Vracφ <TT
  50914. CLASS="constant"
  50915. ><B
  50916. >TRUE</B
  50917. ></TT
  50918. > p°i ·sp∞chu, <TT
  50919. CLASS="constant"
  50920. ><B
  50921. >FALSE</B
  50922. ></TT
  50923. > p°i selhßnφ.
  50924.     </P
  50925. ><P
  50926. >      Ukazatel na soubor musφ b²t platn² a musφ ukazovat na soubor ·sp∞╣n∞
  50927.      otev°en² pomocφ <A
  50928. HREF="#function.bzopen"
  50929. ><B
  50930. CLASS="function"
  50931. >bzopen()</B
  50932. ></A
  50933. >.
  50934.     </P
  50935. ><P
  50936. >      Viz takΘ <A
  50937. HREF="#function.bzopen"
  50938. ><B
  50939. CLASS="function"
  50940. >bzopen()</B
  50941. ></A
  50942. >.
  50943.     </P
  50944. ></DIV
  50945. ><H1
  50946. ><A
  50947. NAME="function.bzcompress"
  50948. ></A
  50949. >bzcompress</H1
  50950. ><DIV
  50951. CLASS="refnamediv"
  50952. ><A
  50953. NAME="AEN9810"
  50954. ></A
  50955. ><P
  50956. >    (4.0.4 - 4.3.2 only)</P
  50957. >bzcompress -- Zkomprimuje °et∞zec algoritmem bzip2</DIV
  50958. ><DIV
  50959. CLASS="refsect1"
  50960. ><A
  50961. NAME="AEN9813"
  50962. ></A
  50963. ><H2
  50964. >Popis</H2
  50965. >string <B
  50966. CLASS="methodname"
  50967. >bzcompress</B
  50968. > ( string source [, int blocksize [, int workfactor]])<BR
  50969. ></BR
  50970. ><P
  50971. >      <B
  50972. CLASS="function"
  50973. >bzcompress()</B
  50974. > komprimuje °et∞zec
  50975.      <TT
  50976. CLASS="parameter"
  50977. ><I
  50978. >source</I
  50979. ></TT
  50980. > a vracφ ho ve form∞ dat zφskan²ch
  50981.      pomocφ algoritmu bzip2.
  50982.     </P
  50983. ><P
  50984. >      Nepovinn² parametr <TT
  50985. CLASS="parameter"
  50986. ><I
  50987. >blocksize</I
  50988. ></TT
  50989. > specifikuje velikost
  50990.      bloku pou╛itou p°i komprimaci; m∞lo by to b²t Φφslo od 1 do 9, kde
  50991.      9 znamenß nej·Φinn∞j╣φ kompresi, ale s v∞t╣φmi nßroky na pot°ebnΘ
  50992.      prost°edky. Implicitnφ hodnota <TT
  50993. CLASS="parameter"
  50994. ><I
  50995. >blocksize</I
  50996. ></TT
  50997. > je 4.
  50998.     </P
  50999. ><P
  51000. >      Nepovinn² parametr <TT
  51001. CLASS="parameter"
  51002. ><I
  51003. >workfactor</I
  51004. ></TT
  51005. > urΦuje, jak se
  51006.      kompresnφ mechanismus chovß v p°φpad∞ nejhor╣φch, velmi se opakujφcφch,
  51007.      vstupnßch dat. M∙╛e nab²vat hodnot mezi 0 a 250; 0 p°edstavuje specißlnφ
  51008.      p°φpad, 30 je implicitnφ hodnota. Generovan² v²stup je bez ohledu na
  51009.      <TT
  51010. CLASS="parameter"
  51011. ><I
  51012. >workfactor</I
  51013. ></TT
  51014. > v╛dy stejn².
  51015.     </P
  51016. ><P
  51017. >      <TABLE
  51018. WIDTH="100%"
  51019. BORDER="0"
  51020. CELLPADDING="0"
  51021. CELLSPACING="0"
  51022. CLASS="EXAMPLE"
  51023. ><TR
  51024. ><TD
  51025. ><DIV
  51026. CLASS="example"
  51027. ><A
  51028. NAME="AEN9837"
  51029. ></A
  51030. ><P
  51031. ><B
  51032. >P°φklad 1. <B
  51033. CLASS="function"
  51034. >bzcompress()</B
  51035. > P°φklad</B
  51036. ></P
  51037. ><TABLE
  51038. BORDER="0"
  51039. BGCOLOR="#E0E0E0"
  51040. CELLPADDING="5"
  51041. ><TR
  51042. ><TD
  51043. ><PRE
  51044. CLASS="php"
  51045. ><?php
  51046. $str = "zku╣ebnφ data";
  51047. $bzstr = bzcompress($str, 9);
  51048. echo $bzstr;
  51049. ?></PRE
  51050. ></TD
  51051. ></TR
  51052. ></TABLE
  51053. ></DIV
  51054. ></TD
  51055. ></TR
  51056. ></TABLE
  51057. >
  51058.     </P
  51059. ><P
  51060. >      Viz takΘ <A
  51061. HREF="#function.bzdecompress"
  51062. ><B
  51063. CLASS="function"
  51064. >bzdecompress()</B
  51065. ></A
  51066. >.
  51067.     </P
  51068. ></DIV
  51069. ><H1
  51070. ><A
  51071. NAME="function.bzdecompress"
  51072. ></A
  51073. >bzdecompress</H1
  51074. ><DIV
  51075. CLASS="refnamediv"
  51076. ><A
  51077. NAME="AEN9844"
  51078. ></A
  51079. ><P
  51080. >    (4.0.4 - 4.3.2 only)</P
  51081. >bzdecompress -- Dekomprimuje data komprimovanß pomocφ bzip2</DIV
  51082. ><DIV
  51083. CLASS="refsect1"
  51084. ><A
  51085. NAME="AEN9847"
  51086. ></A
  51087. ><H2
  51088. >Popis</H2
  51089. >string <B
  51090. CLASS="methodname"
  51091. >bzdecompress</B
  51092. > ( string source [, int small])<BR
  51093. ></BR
  51094. ><P
  51095. >      <B
  51096. CLASS="function"
  51097. >bzdecompress()</B
  51098. > dekomprimuje °et∞zec
  51099.      <TT
  51100. CLASS="parameter"
  51101. ><I
  51102. >source</I
  51103. ></TT
  51104. > obsahujφcφ data komprimovanß pomocφ
  51105.      algoritmu bzip2, a vracφ je. Pokud mß nepovinn² parametr
  51106.      <TT
  51107. CLASS="parameter"
  51108. ><I
  51109. >small</I
  51110. ></TT
  51111. > hodnotu <TT
  51112. CLASS="constant"
  51113. ><B
  51114. >TRUE</B
  51115. ></TT
  51116. >, pou╛ije se alternativnφ
  51117.      dekompresnφ algoritmus s ni╛╣φmi nßroky na pam∞╗ (maximßlnφ pam∞tovΘ
  51118.      po╛adavky klesnou na cca 2300 KB), ale zhruba poloviΦnφ rychlostφ.
  51119.      Vφce informacφ najdete v
  51120.      <A
  51121. HREF="http://sources.redhat.com/bzip2/"
  51122. TARGET="_top"
  51123. >dokumentaci k bzip2</A
  51124. >.
  51125.     </P
  51126. ><P
  51127. >      <TABLE
  51128. WIDTH="100%"
  51129. BORDER="0"
  51130. CELLPADDING="0"
  51131. CELLSPACING="0"
  51132. CLASS="EXAMPLE"
  51133. ><TR
  51134. ><TD
  51135. ><DIV
  51136. CLASS="example"
  51137. ><A
  51138. NAME="AEN9865"
  51139. ></A
  51140. ><P
  51141. ><B
  51142. >P°φklad 1. <B
  51143. CLASS="function"
  51144. >bzdecompress()</B
  51145. ></B
  51146. ></P
  51147. ><TABLE
  51148. BORDER="0"
  51149. BGCOLOR="#E0E0E0"
  51150. CELLPADDING="5"
  51151. ><TR
  51152. ><TD
  51153. ><PRE
  51154. CLASS="php"
  51155. ><?php
  51156. $start_str = "Tohle nenφ up°φmn² obliΦej?";
  51157. $bzstr = bzcompress($start_str);
  51158.  
  51159. echo "Komprimovan² °et∞zec: ";
  51160. echo $bzstr;
  51161. echo "\n<br>\n";
  51162.  
  51163. $str = bzdecompress($bzstr);
  51164. echo "Dekomprimovan² °etezec: ";
  51165. echo $str;
  51166. echo "\n<br>\n";
  51167. ?></PRE
  51168. ></TD
  51169. ></TR
  51170. ></TABLE
  51171. ></DIV
  51172. ></TD
  51173. ></TR
  51174. ></TABLE
  51175. >
  51176.     </P
  51177. ><P
  51178. >      Viz takΘ <A
  51179. HREF="#function.bzcompress"
  51180. ><B
  51181. CLASS="function"
  51182. >bzcompress()</B
  51183. ></A
  51184. >.
  51185.     </P
  51186. ></DIV
  51187. ><H1
  51188. ><A
  51189. NAME="function.bzerrno"
  51190. ></A
  51191. >bzerrno</H1
  51192. ><DIV
  51193. CLASS="refnamediv"
  51194. ><A
  51195. NAME="AEN9872"
  51196. ></A
  51197. ><P
  51198. >    (4.0.4 - 4.3.2 only)</P
  51199. >bzerrno -- Vracφ Φφslo chyby bzip2</DIV
  51200. ><DIV
  51201. CLASS="refsect1"
  51202. ><A
  51203. NAME="AEN9875"
  51204. ></A
  51205. ><H2
  51206. >Popis</H2
  51207. >int <B
  51208. CLASS="methodname"
  51209. >bzerrno</B
  51210. > ( resource bz)<BR
  51211. ></BR
  51212. ><P
  51213. >      Vracφ chybovΘ Φφslo jakΘkoli chyby bzip2 podle souborovΘho ukazatele
  51214.      <TT
  51215. CLASS="parameter"
  51216. ><I
  51217. >bz</I
  51218. ></TT
  51219. >.
  51220.     </P
  51221. ><P
  51222. >      Vuz takΘ <A
  51223. HREF="#function.bzerror"
  51224. ><B
  51225. CLASS="function"
  51226. >bzerror()</B
  51227. ></A
  51228. > a <A
  51229. HREF="#function.bzerrstr"
  51230. ><B
  51231. CLASS="function"
  51232. >bzerrstr()</B
  51233. ></A
  51234. >.
  51235.     </P
  51236. ></DIV
  51237. ><H1
  51238. ><A
  51239. NAME="function.bzerror"
  51240. ></A
  51241. >bzerror</H1
  51242. ><DIV
  51243. CLASS="refnamediv"
  51244. ><A
  51245. NAME="AEN9889"
  51246. ></A
  51247. ><P
  51248. >    (4.0.4 - 4.3.2 only)</P
  51249. >bzerror -- Vracφ v poli Φφslo a popis chyby bzip2</DIV
  51250. ><DIV
  51251. CLASS="refsect1"
  51252. ><A
  51253. NAME="AEN9892"
  51254. ></A
  51255. ><H2
  51256. >Popis</H2
  51257. >array <B
  51258. CLASS="methodname"
  51259. >bzerror</B
  51260. > ( resource bz)<BR
  51261. ></BR
  51262. ><P
  51263. >      Vracφ Φφslo chyby a chybov² °et∞zec (popis) v asociativnφm poli pro
  51264.      jakoukoli chybu bzip2 podle souborovΘho ukazatele
  51265.      <TT
  51266. CLASS="parameter"
  51267. ><I
  51268. >bz</I
  51269. ></TT
  51270. >.
  51271.     </P
  51272. ><P
  51273. >      <TABLE
  51274. WIDTH="100%"
  51275. BORDER="0"
  51276. CELLPADDING="0"
  51277. CELLSPACING="0"
  51278. CLASS="EXAMPLE"
  51279. ><TR
  51280. ><TD
  51281. ><DIV
  51282. CLASS="example"
  51283. ><A
  51284. NAME="AEN9903"
  51285. ></A
  51286. ><P
  51287. ><B
  51288. >P°φklad 1. P°φklad - <B
  51289. CLASS="function"
  51290. >bzerror()</B
  51291. ></B
  51292. ></P
  51293. ><TABLE
  51294. BORDER="0"
  51295. BGCOLOR="#E0E0E0"
  51296. CELLPADDING="5"
  51297. ><TR
  51298. ><TD
  51299. ><PRE
  51300. CLASS="php"
  51301. ><?php
  51302. $error = bzerror($bz);
  51303.  
  51304. echo $error["errno"];
  51305. echo $error["errstr"];
  51306. ?></PRE
  51307. ></TD
  51308. ></TR
  51309. ></TABLE
  51310. ></DIV
  51311. ></TD
  51312. ></TR
  51313. ></TABLE
  51314. >
  51315.     </P
  51316. ><P
  51317. >      Viz takΘ <A
  51318. HREF="#function.bzerrno"
  51319. ><B
  51320. CLASS="function"
  51321. >bzerrno()</B
  51322. ></A
  51323. > a <A
  51324. HREF="#function.bzerrstr"
  51325. ><B
  51326. CLASS="function"
  51327. >bzerrstr()</B
  51328. ></A
  51329. >.
  51330.     </P
  51331. ></DIV
  51332. ><H1
  51333. ><A
  51334. NAME="function.bzerrstr"
  51335. ></A
  51336. >bzerrstr</H1
  51337. ><DIV
  51338. CLASS="refnamediv"
  51339. ><A
  51340. NAME="AEN9911"
  51341. ></A
  51342. ><P
  51343. >    (4.0.4 - 4.3.2 only)</P
  51344. >bzerrstr -- Vracφ popis chyby bzip2</DIV
  51345. ><DIV
  51346. CLASS="refsect1"
  51347. ><A
  51348. NAME="AEN9914"
  51349. ></A
  51350. ><H2
  51351. >Popis</H2
  51352. >string <B
  51353. CLASS="methodname"
  51354. >bzerrstr</B
  51355. > ( resource bz)<BR
  51356. ></BR
  51357. ><P
  51358. >      Vracφ chybov² °et∞zec (popis) pro jakoukoli chybu bzip2 podle souborovΘho
  51359.      ukazatele <TT
  51360. CLASS="parameter"
  51361. ><I
  51362. >bz</I
  51363. ></TT
  51364. >.
  51365.     </P
  51366. ><P
  51367. >      Viz takΘ <A
  51368. HREF="#function.bzerrno"
  51369. ><B
  51370. CLASS="function"
  51371. >bzerrno()</B
  51372. ></A
  51373. > a <A
  51374. HREF="#function.bzerror"
  51375. ><B
  51376. CLASS="function"
  51377. >bzerror()</B
  51378. ></A
  51379. >.
  51380.     </P
  51381. ></DIV
  51382. ><H1
  51383. ><A
  51384. NAME="function.bzflush"
  51385. ></A
  51386. >bzflush</H1
  51387. ><DIV
  51388. CLASS="refnamediv"
  51389. ><A
  51390. NAME="AEN9928"
  51391. ></A
  51392. ><P
  51393. >    (4.0.4 - 4.3.2 only)</P
  51394. >bzflush -- Vynutφ zßpis v╣ech bufferovan²ch dat</DIV
  51395. ><DIV
  51396. CLASS="refsect1"
  51397. ><A
  51398. NAME="AEN9931"
  51399. ></A
  51400. ><H2
  51401. >Popis</H2
  51402. >int <B
  51403. CLASS="methodname"
  51404. >bzflush</B
  51405. > ( resource bz)<BR
  51406. ></BR
  51407. ><P
  51408. >      Vynutφ zßpis v╣ech bufferovan²ch dat pro souborov² ukazatel
  51409.      <TT
  51410. CLASS="parameter"
  51411. ><I
  51412. >bz</I
  51413. ></TT
  51414. >.
  51415.     </P
  51416. ><P
  51417. >      Vracφ <TT
  51418. CLASS="constant"
  51419. ><B
  51420. >TRUE</B
  51421. ></TT
  51422. > p°i ·sp∞chu, <TT
  51423. CLASS="constant"
  51424. ><B
  51425. >FALSE</B
  51426. ></TT
  51427. > p°i selhßnφ.
  51428.     </P
  51429. ><P
  51430. >      Viz takΘ <A
  51431. HREF="#function.bzread"
  51432. ><B
  51433. CLASS="function"
  51434. >bzread()</B
  51435. ></A
  51436. > a <A
  51437. HREF="#function.bzwrite"
  51438. ><B
  51439. CLASS="function"
  51440. >bzwrite()</B
  51441. ></A
  51442. >.
  51443.     </P
  51444. ></DIV
  51445. ><H1
  51446. ><A
  51447. NAME="function.bzopen"
  51448. ></A
  51449. >bzopen</H1
  51450. ><DIV
  51451. CLASS="refnamediv"
  51452. ><A
  51453. NAME="AEN9948"
  51454. ></A
  51455. ><P
  51456. >    (4.0.4 - 4.3.2 only)</P
  51457. >bzopen -- Otev°e soubor komprimovan² pomocφ bzip2</DIV
  51458. ><DIV
  51459. CLASS="refsect1"
  51460. ><A
  51461. NAME="AEN9951"
  51462. ></A
  51463. ><H2
  51464. >Popis</H2
  51465. >resource <B
  51466. CLASS="methodname"
  51467. >bzopen</B
  51468. > ( string filename, string mode)<BR
  51469. ></BR
  51470. ><P
  51471. >      Otev°e soubor bzip2 (.bz2) pro Φtenφ nebo zßpis.
  51472.      <TT
  51473. CLASS="parameter"
  51474. ><I
  51475. >filename</I
  51476. ></TT
  51477. > je nßzev otvφranΘho souboru.
  51478.      Parametr <TT
  51479. CLASS="parameter"
  51480. ><I
  51481. >mode</I
  51482. ></TT
  51483. > mß podobn² v²znam jako u funkce
  51484.      <A
  51485. HREF="#function.fopen"
  51486. ><B
  51487. CLASS="function"
  51488. >fopen()</B
  51489. ></A
  51490. > (`r' pro Φtenφ, `w' pro zßpis atd.).
  51491.     </P
  51492. ><P
  51493. >      Pokud otvφrßnφ sel╛e, vracφ funkce <TT
  51494. CLASS="constant"
  51495. ><B
  51496. >FALSE</B
  51497. ></TT
  51498. >, jinak vracφ ukazatel
  51499.      (deskriptor) na nov∞ otev°en² soubor.
  51500.     </P
  51501. ><P
  51502. >      <TABLE
  51503. WIDTH="100%"
  51504. BORDER="0"
  51505. CELLPADDING="0"
  51506. CELLSPACING="0"
  51507. CLASS="EXAMPLE"
  51508. ><TR
  51509. ><TD
  51510. ><DIV
  51511. CLASS="example"
  51512. ><A
  51513. NAME="AEN9969"
  51514. ></A
  51515. ><P
  51516. ><B
  51517. >P°φklad 1. P°φklad - <B
  51518. CLASS="function"
  51519. >bzopen()</B
  51520. ></B
  51521. ></P
  51522. ><TABLE
  51523. BORDER="0"
  51524. BGCOLOR="#E0E0E0"
  51525. CELLPADDING="5"
  51526. ><TR
  51527. ><TD
  51528. ><PRE
  51529. CLASS="php"
  51530. ><?php
  51531. $bz = bzopen("/tmp/foo.bz2", "r");
  51532. $decompressed_file = '';
  51533. while (!feof($bz)) {
  51534.     $decompressed_file .= bzread($bz, 4096);
  51535. }
  51536. bzclose($bz);
  51537.  
  51538. echo "Obsah souboru /tmp/foo.bz2 je: ";
  51539. echo "\n<br>\n";
  51540. echo $decompressed_file;
  51541. ?></PRE
  51542. ></TD
  51543. ></TR
  51544. ></TABLE
  51545. ></DIV
  51546. ></TD
  51547. ></TR
  51548. ></TABLE
  51549. >
  51550.     </P
  51551. ><P
  51552. >      Viz takΘ <A
  51553. HREF="#function.bzclose"
  51554. ><B
  51555. CLASS="function"
  51556. >bzclose()</B
  51557. ></A
  51558. >.
  51559.     </P
  51560. ></DIV
  51561. ><H1
  51562. ><A
  51563. NAME="function.bzread"
  51564. ></A
  51565. >bzread</H1
  51566. ><DIV
  51567. CLASS="refnamediv"
  51568. ><A
  51569. NAME="AEN9976"
  51570. ></A
  51571. ><P
  51572. >    (4.0.4 - 4.3.2 only)</P
  51573. >bzread -- Binßrn∞ bezpeΦnΘ Φtenφ ze souboru bzip2</DIV
  51574. ><DIV
  51575. CLASS="refsect1"
  51576. ><A
  51577. NAME="AEN9979"
  51578. ></A
  51579. ><H2
  51580. >Popis</H2
  51581. >string <B
  51582. CLASS="methodname"
  51583. >bzread</B
  51584. > ( resource bz [, int length])<BR
  51585. ></BR
  51586. ><P
  51587. >      <B
  51588. CLASS="function"
  51589. >bzread()</B
  51590. > p°eΦte nejv²╣e <TT
  51591. CLASS="parameter"
  51592. ><I
  51593. >length</I
  51594. ></TT
  51595. >
  51596.      byt∙ z bzip2 souboru odkazovanΘho pomocφ <TT
  51597. CLASS="parameter"
  51598. ><I
  51599. >bz</I
  51600. ></TT
  51601. >.
  51602.      ╚tenφ konΦφ, je-li p°eΦteno <TT
  51603. CLASS="parameter"
  51604. ><I
  51605. >length</I
  51606. ></TT
  51607. >
  51608.      (nekomprimovan²ch) byt∙ nebo se dosßhne konce souboru - podle toho, co
  51609.      nastane d°φv. Nenφ-li specifikovßn nepovinn² parametr
  51610.      <TT
  51611. CLASS="parameter"
  51612. ><I
  51613. >length</I
  51614. ></TT
  51615. >, funkce <B
  51616. CLASS="function"
  51617. >bzread()</B
  51618. >
  51619.      p°eΦte najednou 1024 (nekomprimovan²ch) byt∙.
  51620.     </P
  51621. ><P
  51622. >      <TABLE
  51623. WIDTH="100%"
  51624. BORDER="0"
  51625. CELLPADDING="0"
  51626. CELLSPACING="0"
  51627. CLASS="EXAMPLE"
  51628. ><TR
  51629. ><TD
  51630. ><DIV
  51631. CLASS="example"
  51632. ><A
  51633. NAME="AEN9998"
  51634. ></A
  51635. ><P
  51636. ><B
  51637. >P°φklad 1. P°φklad - <B
  51638. CLASS="function"
  51639. >bzread()</B
  51640. ></B
  51641. ></P
  51642. ><TABLE
  51643. BORDER="0"
  51644. BGCOLOR="#E0E0E0"
  51645. CELLPADDING="5"
  51646. ><TR
  51647. ><TD
  51648. ><PRE
  51649. CLASS="php"
  51650. ><?php
  51651. $bz = bzopen("/tmp/foo.bz2", "r");
  51652. $str = bzread($bz, 2048);
  51653. echo $str;
  51654. ?></PRE
  51655. ></TD
  51656. ></TR
  51657. ></TABLE
  51658. ></DIV
  51659. ></TD
  51660. ></TR
  51661. ></TABLE
  51662. >
  51663.     </P
  51664. ><P
  51665. >      Viz takΘ <A
  51666. HREF="#function.bzwrite"
  51667. ><B
  51668. CLASS="function"
  51669. >bzwrite()</B
  51670. ></A
  51671. > a <A
  51672. HREF="#function.bzopen"
  51673. ><B
  51674. CLASS="function"
  51675. >bzopen()</B
  51676. ></A
  51677. >.
  51678.     </P
  51679. ></DIV
  51680. ><H1
  51681. ><A
  51682. NAME="function.bzwrite"
  51683. ></A
  51684. >bzwrite</H1
  51685. ><DIV
  51686. CLASS="refnamediv"
  51687. ><A
  51688. NAME="AEN10006"
  51689. ></A
  51690. ><P
  51691. >    (4.0.4 - 4.3.2 only)</P
  51692. >bzwrite -- Binßrn∞ bezpeΦn² zßpis do souboru bzip2</DIV
  51693. ><DIV
  51694. CLASS="refsect1"
  51695. ><A
  51696. NAME="AEN10009"
  51697. ></A
  51698. ><H2
  51699. >Popis</H2
  51700. >int <B
  51701. CLASS="methodname"
  51702. >bzwrite</B
  51703. > ( resource bz, string data [, int length])<BR
  51704. ></BR
  51705. ><P
  51706. >      <B
  51707. CLASS="function"
  51708. >bzwrite()</B
  51709. > zapφ╣e obsah °et∞zce
  51710.      <TT
  51711. CLASS="parameter"
  51712. ><I
  51713. >data</I
  51714. ></TT
  51715. > do souboru bzip2 odkazovanΘho pomocφ
  51716.      <TT
  51717. CLASS="parameter"
  51718. ><I
  51719. >bz</I
  51720. ></TT
  51721. >. Je-li p°φtomen nepovinn² parametr
  51722.      <TT
  51723. CLASS="parameter"
  51724. ><I
  51725. >length</I
  51726. ></TT
  51727. >, zßpis skonΦφ potΘ, co bude zapsßno
  51728.      <TT
  51729. CLASS="parameter"
  51730. ><I
  51731. >length</I
  51732. ></TT
  51733. > (nekomprimovan²ch) byt∙ nebo bude dosa╛eno
  51734.      konce °et∞zce - podle toho, co nastane d°φv.
  51735.     </P
  51736. ><P
  51737. >      <TABLE
  51738. WIDTH="100%"
  51739. BORDER="0"
  51740. CELLPADDING="0"
  51741. CELLSPACING="0"
  51742. CLASS="EXAMPLE"
  51743. ><TR
  51744. ><TD
  51745. ><DIV
  51746. CLASS="example"
  51747. ><A
  51748. NAME="AEN10030"
  51749. ></A
  51750. ><P
  51751. ><B
  51752. >P°φklad 1. P°φklad <B
  51753. CLASS="function"
  51754. >bzwrite()</B
  51755. ></B
  51756. ></P
  51757. ><TABLE
  51758. BORDER="0"
  51759. BGCOLOR="#E0E0E0"
  51760. CELLPADDING="5"
  51761. ><TR
  51762. ><TD
  51763. ><PRE
  51764. CLASS="php"
  51765. ><?php
  51766. $str = "nekomprimovanß data";
  51767. $bz = bzopen("/tmp/foo.bz2", "w");
  51768. bzwrite($bz, $str, strlen($str));
  51769. bzclose($bz);
  51770. ?></PRE
  51771. ></TD
  51772. ></TR
  51773. ></TABLE
  51774. ></DIV
  51775. ></TD
  51776. ></TR
  51777. ></TABLE
  51778. >
  51779.     </P
  51780. ><P
  51781. >      Viz takΘ <A
  51782. HREF="#function.bzread"
  51783. ><B
  51784. CLASS="function"
  51785. >bzread()</B
  51786. ></A
  51787. > a <A
  51788. HREF="#function.bzopen"
  51789. ><B
  51790. CLASS="function"
  51791. >bzopen()</B
  51792. ></A
  51793. >.
  51794.     </P
  51795. ></DIV
  51796. ></DIV
  51797. ><DIV
  51798. CLASS="reference"
  51799. ><A
  51800. NAME="ref.calendar"
  51801. ></A
  51802. ><DIV
  51803. CLASS="TITLEPAGE"
  51804. ><H1
  51805. CLASS="title"
  51806. >VI. Kalendß°ovΘ funkce</H1
  51807. ><DIV
  51808. CLASS="PARTINTRO"
  51809. ><A
  51810. NAME="AEN10040"
  51811. ></A
  51812. ><DIV
  51813. CLASS="section"
  51814. ><H1
  51815. CLASS="section"
  51816. ><A
  51817. NAME="calendar.intro"
  51818. ></A
  51819. >┌vod</H1
  51820. ><P
  51821. >      Toto roz╣φ°enφ p°edstavuje sadu funkcφ urΦen²ch ke zjednodu╣enφ p°evod∙
  51822.      mezi r∙zn²mi kalendß°i. Prost°ednφkem nebo standardem, na kterΘm je zalo╛ena,
  51823.      je Julian Day Count. To je poΦet dnφ zaΦφnajφcφ daleko p°ed jak²mkoli datem
  51824.      o kterΘ by se v∞t╣ina lidφ zajφmala (n∞kde kolem 4000 p°. n. l.). Pokud
  51825.      chcete p°evßd∞t mezi kalendß°ov²mi systΘmy, musφte nejd°φv p°evΘst na
  51826.      Julian Day Count, potom na k²╛en² kalendß°. Julian Day Count se velmi li╣φ
  51827.      od JulißnskΘho kaledß°e! Pro vφce informacφ o Julian Day Count viz
  51828.      <A
  51829. HREF="http://www.hermetic.ch/cal_stud/jdn.htm"
  51830. TARGET="_top"
  51831. >http://www.hermetic.ch/cal_stud/jdn.htm</A
  51832. >. Pro vφce informacφ o kalendß°ov²ch systΘmech viz <A
  51833. HREF="http://www.boogle.com/info/cal-overview.html"
  51834. TARGET="_top"
  51835. >http://www.boogle.com/info/cal-overview.html</A
  51836. >. Tyto instrukce obsahujφ v²≥atky
  51837.      z tΘto strßnky (v uvozovkßch).
  51838.     </P
  51839. ></DIV
  51840. ><DIV
  51841. CLASS="section"
  51842. ><HR><H1
  51843. CLASS="section"
  51844. ><A
  51845. NAME="calendar.installation"
  51846. ></A
  51847. >Instalace</H1
  51848. ><P
  51849. >   Pro prßci tohoto roz╣φ°enφ musφte PHP zkompilovat s volbou
  51850.   <TT
  51851. CLASS="option"
  51852. >--enable-calendar</TT
  51853. >.
  51854.  </P
  51855. ><P
  51856. >Verze <TT
  51857. CLASS="literal"
  51858. >PHP</TT
  51859. > pro Windows
  51860. mß vestav∞nou podporu pro toto roz╣φ°enφ. K pou╛itφ t∞chto funkcφ nenφ t°eba
  51861. naΦφtat ╛ßdnß dal╣φ roz╣φ°enφ.</P
  51862. ></DIV
  51863. ><DIV
  51864. CLASS="section"
  51865. ><HR><H1
  51866. CLASS="section"
  51867. ><A
  51868. NAME="calendar.configuration"
  51869. ></A
  51870. >Konfigurace b∞hu</H1
  51871. ><P
  51872. >Toto roz╣φ°enφ nemß definovßno ╛ßdnΘ konfiguraΦnφ
  51873. direktivy.</P
  51874. ></DIV
  51875. ><DIV
  51876. CLASS="section"
  51877. ><HR><H1
  51878. CLASS="section"
  51879. ><A
  51880. NAME="calendar.resources"
  51881. ></A
  51882. >Typy prost°edk∙</H1
  51883. ><P
  51884. >Toto roz╣φ°enφ nemß definovßn ╛ßdn² typ prost°edku
  51885. (resource).</P
  51886. ></DIV
  51887. ><DIV
  51888. CLASS="section"
  51889. ><HR><H1
  51890. CLASS="section"
  51891. ><A
  51892. NAME="calendar.constants"
  51893. ></A
  51894. >P°eddefinovanΘ konstanty</H1
  51895. ><P
  51896. > Tyto konstanty jsou definovßny tφmto roz╣φ°enφm a budou k dispozici pouze
  51897. tehdy, bylo-li roz╣φ°enφ zkompilovßno spoleΦn∞ s PHP nebo dynamicky zavedeno
  51898. za b∞hu.
  51899. </P
  51900. ><P
  51901. ></P
  51902. ><DIV
  51903. CLASS="variablelist"
  51904. ><DL
  51905. ><DT
  51906. ><TT
  51907. CLASS="constant"
  51908. ><B
  51909. >CAL_GREGORIAN</B
  51910. ></TT
  51911. > 
  51912.     (<A
  51913. HREF="#language.types.integer"
  51914. ><B
  51915. CLASS="type"
  51916. >integer</B
  51917. ></A
  51918. >)</DT
  51919. ><DD
  51920. ><P
  51921. >
  51922.     </P
  51923. ></DD
  51924. ><DT
  51925. ><TT
  51926. CLASS="constant"
  51927. ><B
  51928. >CAL_JULIAN</B
  51929. ></TT
  51930. > 
  51931.     (<A
  51932. HREF="#language.types.integer"
  51933. ><B
  51934. CLASS="type"
  51935. >integer</B
  51936. ></A
  51937. >)</DT
  51938. ><DD
  51939. ><P
  51940. >
  51941.     </P
  51942. ></DD
  51943. ><DT
  51944. ><TT
  51945. CLASS="constant"
  51946. ><B
  51947. >CAL_JEWISH</B
  51948. ></TT
  51949. > 
  51950.     (<A
  51951. HREF="#language.types.integer"
  51952. ><B
  51953. CLASS="type"
  51954. >integer</B
  51955. ></A
  51956. >)</DT
  51957. ><DD
  51958. ><P
  51959. >      
  51960.     </P
  51961. ></DD
  51962. ><DT
  51963. ><TT
  51964. CLASS="constant"
  51965. ><B
  51966. >CAL_FRENCH</B
  51967. ></TT
  51968. > 
  51969.     (<A
  51970. HREF="#language.types.integer"
  51971. ><B
  51972. CLASS="type"
  51973. >integer</B
  51974. ></A
  51975. >)</DT
  51976. ><DD
  51977. ><P
  51978. >      
  51979.     </P
  51980. ></DD
  51981. ><DT
  51982. ><TT
  51983. CLASS="constant"
  51984. ><B
  51985. >CAL_NUM_CALS</B
  51986. ></TT
  51987. > 
  51988.     (<A
  51989. HREF="#language.types.integer"
  51990. ><B
  51991. CLASS="type"
  51992. >integer</B
  51993. ></A
  51994. >)</DT
  51995. ><DD
  51996. ><P
  51997. >      
  51998.     </P
  51999. ></DD
  52000. ><DT
  52001. ><TT
  52002. CLASS="constant"
  52003. ><B
  52004. >CAL_DOW_DAYNO</B
  52005. ></TT
  52006. > 
  52007.     (<A
  52008. HREF="#language.types.integer"
  52009. ><B
  52010. CLASS="type"
  52011. >integer</B
  52012. ></A
  52013. >)</DT
  52014. ><DD
  52015. ><P
  52016. >      
  52017.     </P
  52018. ></DD
  52019. ><DT
  52020. ><TT
  52021. CLASS="constant"
  52022. ><B
  52023. >CAL_DOW_SHORT</B
  52024. ></TT
  52025. > 
  52026.     (<A
  52027. HREF="#language.types.integer"
  52028. ><B
  52029. CLASS="type"
  52030. >integer</B
  52031. ></A
  52032. >)</DT
  52033. ><DD
  52034. ><P
  52035. >      
  52036.     </P
  52037. ></DD
  52038. ><DT
  52039. ><TT
  52040. CLASS="constant"
  52041. ><B
  52042. >CAL_DOW_LONG</B
  52043. ></TT
  52044. > 
  52045.     (<A
  52046. HREF="#language.types.integer"
  52047. ><B
  52048. CLASS="type"
  52049. >integer</B
  52050. ></A
  52051. >)</DT
  52052. ><DD
  52053. ><P
  52054. >      
  52055.     </P
  52056. ></DD
  52057. ><DT
  52058. ><TT
  52059. CLASS="constant"
  52060. ><B
  52061. >CAL_MONTH_GREGORIAN_SHORT</B
  52062. ></TT
  52063. > 
  52064.     (<A
  52065. HREF="#language.types.integer"
  52066. ><B
  52067. CLASS="type"
  52068. >integer</B
  52069. ></A
  52070. >)</DT
  52071. ><DD
  52072. ><P
  52073. >      
  52074.     </P
  52075. ></DD
  52076. ><DT
  52077. ><TT
  52078. CLASS="constant"
  52079. ><B
  52080. >CAL_MONTH_GREGORIAN_LONG</B
  52081. ></TT
  52082. > 
  52083.     (<A
  52084. HREF="#language.types.integer"
  52085. ><B
  52086. CLASS="type"
  52087. >integer</B
  52088. ></A
  52089. >)</DT
  52090. ><DD
  52091. ><P
  52092. >      
  52093.     </P
  52094. ></DD
  52095. ><DT
  52096. ><TT
  52097. CLASS="constant"
  52098. ><B
  52099. >CAL_MONTH_JULIAN_SHORT</B
  52100. ></TT
  52101. > 
  52102.     (<A
  52103. HREF="#language.types.integer"
  52104. ><B
  52105. CLASS="type"
  52106. >integer</B
  52107. ></A
  52108. >)</DT
  52109. ><DD
  52110. ><P
  52111. >      
  52112.     </P
  52113. ></DD
  52114. ><DT
  52115. ><TT
  52116. CLASS="constant"
  52117. ><B
  52118. >CAL_MONTH_JULIAN_LONG</B
  52119. ></TT
  52120. > 
  52121.     (<A
  52122. HREF="#language.types.integer"
  52123. ><B
  52124. CLASS="type"
  52125. >integer</B
  52126. ></A
  52127. >)</DT
  52128. ><DD
  52129. ><P
  52130. >      
  52131.     </P
  52132. ></DD
  52133. ><DT
  52134. ><TT
  52135. CLASS="constant"
  52136. ><B
  52137. >CAL_MONTH_JEWISH</B
  52138. ></TT
  52139. > 
  52140.     (<A
  52141. HREF="#language.types.integer"
  52142. ><B
  52143. CLASS="type"
  52144. >integer</B
  52145. ></A
  52146. >)</DT
  52147. ><DD
  52148. ><P
  52149. >      
  52150.     </P
  52151. ></DD
  52152. ><DT
  52153. ><TT
  52154. CLASS="constant"
  52155. ><B
  52156. >CAL_MONTH_FRENCH</B
  52157. ></TT
  52158. > 
  52159.     (<A
  52160. HREF="#language.types.integer"
  52161. ><B
  52162. CLASS="type"
  52163. >integer</B
  52164. ></A
  52165. >)</DT
  52166. ><DD
  52167. ><P
  52168. >      
  52169.     </P
  52170. ></DD
  52171. ></DL
  52172. ></DIV
  52173. ><P
  52174. >   The following constants are available since <TT
  52175. CLASS="literal"
  52176. >PHP</TT
  52177. > 4.3.0 :
  52178.  </P
  52179. ><P
  52180. ></P
  52181. ><DIV
  52182. CLASS="variablelist"
  52183. ><DL
  52184. ><DT
  52185. ><TT
  52186. CLASS="constant"
  52187. ><B
  52188. >CAL_EASTER_DEFAULT</B
  52189. ></TT
  52190. > 
  52191.     (<A
  52192. HREF="#language.types.integer"
  52193. ><B
  52194. CLASS="type"
  52195. >integer</B
  52196. ></A
  52197. >)</DT
  52198. ><DD
  52199. ><P
  52200. >      
  52201.     </P
  52202. ></DD
  52203. ><DT
  52204. ><TT
  52205. CLASS="constant"
  52206. ><B
  52207. >CAL_EASTER_ROMAN</B
  52208. ></TT
  52209. > 
  52210.     (<A
  52211. HREF="#language.types.integer"
  52212. ><B
  52213. CLASS="type"
  52214. >integer</B
  52215. ></A
  52216. >)</DT
  52217. ><DD
  52218. ><P
  52219. >      
  52220.     </P
  52221. ></DD
  52222. ><DT
  52223. ><TT
  52224. CLASS="constant"
  52225. ><B
  52226. >CAL_EASTER_ALWAYS_GREGORIAN</B
  52227. ></TT
  52228. > 
  52229.     (<A
  52230. HREF="#language.types.integer"
  52231. ><B
  52232. CLASS="type"
  52233. >integer</B
  52234. ></A
  52235. >)</DT
  52236. ><DD
  52237. ><P
  52238. >      
  52239.     </P
  52240. ></DD
  52241. ><DT
  52242. ><TT
  52243. CLASS="constant"
  52244. ><B
  52245. >CAL_EASTER_ALWAYS_JULIAN</B
  52246. ></TT
  52247. > 
  52248.     (<A
  52249. HREF="#language.types.integer"
  52250. ><B
  52251. CLASS="type"
  52252. >integer</B
  52253. ></A
  52254. >)</DT
  52255. ><DD
  52256. ><P
  52257. >      
  52258.     </P
  52259. ></DD
  52260. ></DL
  52261. ></DIV
  52262. ><P
  52263. >   The following constants are available since <TT
  52264. CLASS="literal"
  52265. >PHP</TT
  52266. > 5.0.0 :
  52267.  </P
  52268. ><P
  52269. ></P
  52270. ><DIV
  52271. CLASS="variablelist"
  52272. ><DL
  52273. ><DT
  52274. ><TT
  52275. CLASS="constant"
  52276. ><B
  52277. >CAL_JEWISH_ADD_ALAFIM_GERESH</B
  52278. ></TT
  52279. >
  52280.      (<A
  52281. HREF="#language.types.integer"
  52282. ><B
  52283. CLASS="type"
  52284. >integer</B
  52285. ></A
  52286. >)</DT
  52287. ><DD
  52288. ><P
  52289. >
  52290.     </P
  52291. ></DD
  52292. ><DT
  52293. ><TT
  52294. CLASS="constant"
  52295. ><B
  52296. >CAL_JEWISH_ADD_ALAFIM</B
  52297. ></TT
  52298. >
  52299.      (<A
  52300. HREF="#language.types.integer"
  52301. ><B
  52302. CLASS="type"
  52303. >integer</B
  52304. ></A
  52305. >)</DT
  52306. ><DD
  52307. ><P
  52308. >
  52309.     </P
  52310. ></DD
  52311. ><DT
  52312. ><TT
  52313. CLASS="constant"
  52314. ><B
  52315. >CAL_JEWISH_ADD_GERESHAYIM</B
  52316. ></TT
  52317. >
  52318.      (<A
  52319. HREF="#language.types.integer"
  52320. ><B
  52321. CLASS="type"
  52322. >integer</B
  52323. ></A
  52324. >)</DT
  52325. ><DD
  52326. ><P
  52327. >
  52328.     </P
  52329. ></DD
  52330. ></DL
  52331. ></DIV
  52332. ></DIV
  52333. ></DIV
  52334. ><DIV
  52335. CLASS="TOC"
  52336. ><DL
  52337. ><DT
  52338. ><B
  52339. >Obsah</B
  52340. ></DT
  52341. ><DT
  52342. ><A
  52343. HREF="#function.cal-days-in-month"
  52344. >cal_days_in_month</A
  52345. > -- Return the number of days in a month for a given year and calendar</DT
  52346. ><DT
  52347. ><A
  52348. HREF="#function.cal-from-jd"
  52349. >cal_from_jd</A
  52350. > -- Converts from Julian Day Count to a supported calendar</DT
  52351. ><DT
  52352. ><A
  52353. HREF="#function.cal-info"
  52354. >cal_info</A
  52355. > -- Returns information about a particular calendar</DT
  52356. ><DT
  52357. ><A
  52358. HREF="#function.cal-to-jd"
  52359. >cal_to_jd</A
  52360. > -- Converts from a supported calendar to Julian Day Count</DT
  52361. ><DT
  52362. ><A
  52363. HREF="#function.easter-date"
  52364. >easter_date</A
  52365. > -- Zjistit UNIXov² timestamp VelikonoΦnφ p∙lnoci v danΘm roce
  52366.     </DT
  52367. ><DT
  52368. ><A
  52369. HREF="#function.easter-days"
  52370. >easter_days</A
  52371. > -- 
  52372.      Get number of days after March 21 on which Easter falls for a
  52373.      given year
  52374.     </DT
  52375. ><DT
  52376. ><A
  52377. HREF="#function.frenchtojd"
  52378. >FrenchToJD</A
  52379. > -- 
  52380.      P°evΘst datum z FrancouzskΘho republikßnskΘho kalendß°e na Julian
  52381.      Day Count
  52382.     </DT
  52383. ><DT
  52384. ><A
  52385. HREF="#function.gregoriantojd"
  52386. >GregorianToJD</A
  52387. > -- P°evΘst GregorißnskΘ datum na Julian Day Count</DT
  52388. ><DT
  52389. ><A
  52390. HREF="#function.jddayofweek"
  52391. >JDDayOfWeek</A
  52392. > -- Vrßtit den v t²dnu</DT
  52393. ><DT
  52394. ><A
  52395. HREF="#function.jdmonthname"
  52396. >JDMonthName</A
  52397. > -- Vrßtit nßzev m∞sφce</DT
  52398. ><DT
  52399. ><A
  52400. HREF="#function.jdtofrench"
  52401. >JDToFrench</A
  52402. > -- 
  52403.      P°evΘst Julian Day Count na Francouzsk² republikßnsk² kalendß°
  52404.     </DT
  52405. ><DT
  52406. ><A
  52407. HREF="#function.jdtogregorian"
  52408. >JDToGregorian</A
  52409. > -- P°evΘst Julian Day Count na GregorißnskΘ datum</DT
  52410. ><DT
  52411. ><A
  52412. HREF="#function.jdtojewish"
  52413. >JDToJewish</A
  52414. > -- 
  52415.      P°evΘst Julian Day Count na  idovsk² kalendß°
  52416.     </DT
  52417. ><DT
  52418. ><A
  52419. HREF="#function.jdtojulian"
  52420. >JDToJulian</A
  52421. > -- 
  52422.      P°evΘst Julian Day Count na JulißnskΘ datum
  52423.     </DT
  52424. ><DT
  52425. ><A
  52426. HREF="#function.jdtounix"
  52427. >jdtounix</A
  52428. > -- P°evΘst Julian Day Count na UNIXov² timestamp</DT
  52429. ><DT
  52430. ><A
  52431. HREF="#function.jewishtojd"
  52432. >JewishToJD</A
  52433. > -- 
  52434.      P°evΘst datum podle  idovskΘho kalendß°e na Julian Day Count
  52435.     </DT
  52436. ><DT
  52437. ><A
  52438. HREF="#function.juliantojd"
  52439. >JulianToJD</A
  52440. > -- 
  52441.      P°evΘst JulißnskΘ datum na Julian Day Count
  52442.     </DT
  52443. ><DT
  52444. ><A
  52445. HREF="#function.unixtojd"
  52446. >unixtojd</A
  52447. > -- P°evΘst UNIXov² timestamp na Julian Day Count</DT
  52448. ></DL
  52449. ></DIV
  52450. ></DIV
  52451. ><H1
  52452. ><A
  52453. NAME="function.cal-days-in-month"
  52454. ></A
  52455. >cal_days_in_month</H1
  52456. ><DIV
  52457. CLASS="refnamediv"
  52458. ><A
  52459. NAME="AEN10195"
  52460. ></A
  52461. ><P
  52462. >    (PHP 4 >= 4.1.0)</P
  52463. >cal_days_in_month -- Return the number of days in a month for a given year and calendar</DIV
  52464. ><DIV
  52465. CLASS="refsect1"
  52466. ><A
  52467. NAME="AEN10198"
  52468. ></A
  52469. ><H2
  52470. >Description</H2
  52471. >int <B
  52472. CLASS="methodname"
  52473. >cal_days_in_month</B
  52474. > ( int calendar, int month, int year)<BR
  52475. ></BR
  52476. ><P
  52477. >      This function will return the number of days in the
  52478.      <TT
  52479. CLASS="parameter"
  52480. ><I
  52481. >month</I
  52482. ></TT
  52483. > of <TT
  52484. CLASS="parameter"
  52485. ><I
  52486. >year</I
  52487. ></TT
  52488. > for
  52489.      the specified <TT
  52490. CLASS="parameter"
  52491. ><I
  52492. >calendar</I
  52493. ></TT
  52494. >.
  52495.     </P
  52496. ><P
  52497. >      <TABLE
  52498. WIDTH="100%"
  52499. BORDER="0"
  52500. CELLPADDING="0"
  52501. CELLSPACING="0"
  52502. CLASS="EXAMPLE"
  52503. ><TR
  52504. ><TD
  52505. ><DIV
  52506. CLASS="example"
  52507. ><A
  52508. NAME="AEN10217"
  52509. ></A
  52510. ><P
  52511. ><B
  52512. >P°φklad 1. <B
  52513. CLASS="function"
  52514. >cal_days_in_month()</B
  52515. > example</B
  52516. ></P
  52517. ><TABLE
  52518. BORDER="0"
  52519. BGCOLOR="#E0E0E0"
  52520. CELLPADDING="5"
  52521. ><TR
  52522. ><TD
  52523. ><PRE
  52524. CLASS="php"
  52525. ><?php
  52526. $num = cal_days_in_month(CAL_GREGORIAN, 8, 2003); // 31
  52527. echo "There was $num days in August 2003";
  52528. ?></PRE
  52529. ></TD
  52530. ></TR
  52531. ></TABLE
  52532. ></DIV
  52533. ></TD
  52534. ></TR
  52535. ></TABLE
  52536. >
  52537.     </P
  52538. ><P
  52539. >      See also <A
  52540. HREF="#function.jdtounix"
  52541. ><B
  52542. CLASS="function"
  52543. >jdtounix()</B
  52544. ></A
  52545. >.
  52546.     </P
  52547. ></DIV
  52548. ><H1
  52549. ><A
  52550. NAME="function.cal-from-jd"
  52551. ></A
  52552. >cal_from_jd</H1
  52553. ><DIV
  52554. CLASS="refnamediv"
  52555. ><A
  52556. NAME="AEN10224"
  52557. ></A
  52558. ><P
  52559. >    (PHP 4 >= 4.1.0)</P
  52560. >cal_from_jd -- Converts from Julian Day Count to a supported calendar</DIV
  52561. ><DIV
  52562. CLASS="refsect1"
  52563. ><A
  52564. NAME="AEN10227"
  52565. ></A
  52566. ><H2
  52567. >Description</H2
  52568. >array <B
  52569. CLASS="methodname"
  52570. >cal_from_jd</B
  52571. > ( int jd, int calendar)<BR
  52572. ></BR
  52573. ><P
  52574. >      <B
  52575. CLASS="function"
  52576. >cal_from_jd()</B
  52577. > converts the Julian day given in
  52578.      <TT
  52579. CLASS="parameter"
  52580. ><I
  52581. >jd</I
  52582. ></TT
  52583. > into a date of the specified
  52584.      <TT
  52585. CLASS="parameter"
  52586. ><I
  52587. >calendar</I
  52588. ></TT
  52589. >. Supported
  52590.      <TT
  52591. CLASS="parameter"
  52592. ><I
  52593. >calendar</I
  52594. ></TT
  52595. > values are
  52596.      <TT
  52597. CLASS="constant"
  52598. ><B
  52599. >CAL_GREGORIAN</B
  52600. ></TT
  52601. >,
  52602.      <TT
  52603. CLASS="constant"
  52604. ><B
  52605. >CAL_JULIAN</B
  52606. ></TT
  52607. >,
  52608.      <TT
  52609. CLASS="constant"
  52610. ><B
  52611. >CAL_JEWISH</B
  52612. ></TT
  52613. > and
  52614.      <TT
  52615. CLASS="constant"
  52616. ><B
  52617. >CAL_FRENCH</B
  52618. ></TT
  52619. >.
  52620.     </P
  52621. ><P
  52622. >      <TABLE
  52623. WIDTH="100%"
  52624. BORDER="0"
  52625. CELLPADDING="0"
  52626. CELLSPACING="0"
  52627. CLASS="EXAMPLE"
  52628. ><TR
  52629. ><TD
  52630. ><DIV
  52631. CLASS="example"
  52632. ><A
  52633. NAME="AEN10248"
  52634. ></A
  52635. ><P
  52636. ><B
  52637. >P°φklad 1. <B
  52638. CLASS="function"
  52639. >cal_from_jd()</B
  52640. > example</B
  52641. ></P
  52642. ><TABLE
  52643. BORDER="0"
  52644. BGCOLOR="#E0E0E0"
  52645. CELLPADDING="5"
  52646. ><TR
  52647. ><TD
  52648. ><PRE
  52649. CLASS="php"
  52650. ><?php
  52651. $today = unixtojd(mktime(0, 0, 0, 8, 16, 2003));
  52652. print_r(cal_from_jd($today, CAL_GREGORIAN));
  52653. ?></PRE
  52654. ></TD
  52655. ></TR
  52656. ></TABLE
  52657. ><P
  52658. >        This will output :
  52659.       </P
  52660. ><TABLE
  52661. BORDER="0"
  52662. BGCOLOR="#E0E0E0"
  52663. CELLPADDING="5"
  52664. ><TR
  52665. ><TD
  52666. ><PRE
  52667. CLASS="screen"
  52668. >Array
  52669. (
  52670.     [date] => 8/16/2003
  52671.     [month] => 8
  52672.     [day] => 16
  52673.     [year] => 2003
  52674.     [dow] => 6
  52675.     [abbrevdayname] => Sat
  52676.     [dayname] => Saturday
  52677.     [abbrevmonth] => Aug
  52678.     [monthname] => August
  52679. )</PRE
  52680. ></TD
  52681. ></TR
  52682. ></TABLE
  52683. ></DIV
  52684. ></TD
  52685. ></TR
  52686. ></TABLE
  52687. >
  52688.     </P
  52689. ><P
  52690. >      See also <A
  52691. HREF="#function.cal-to-jd"
  52692. ><B
  52693. CLASS="function"
  52694. >cal_to_jd()</B
  52695. ></A
  52696. >.
  52697.     </P
  52698. ></DIV
  52699. ><H1
  52700. ><A
  52701. NAME="function.cal-info"
  52702. ></A
  52703. >cal_info</H1
  52704. ><DIV
  52705. CLASS="refnamediv"
  52706. ><A
  52707. NAME="AEN10257"
  52708. ></A
  52709. ><P
  52710. >    (PHP 4 >= 4.1.0)</P
  52711. >cal_info -- Returns information about a particular calendar</DIV
  52712. ><DIV
  52713. CLASS="refsect1"
  52714. ><A
  52715. NAME="AEN10260"
  52716. ></A
  52717. ><H2
  52718. >Description</H2
  52719. >array <B
  52720. CLASS="methodname"
  52721. >cal_info</B
  52722. > ( [int calendar])<BR
  52723. ></BR
  52724. ><P
  52725. >      <B
  52726. CLASS="function"
  52727. >cal_info()</B
  52728. > returns information on the
  52729.      specified <TT
  52730. CLASS="parameter"
  52731. ><I
  52732. >calendar</I
  52733. ></TT
  52734. > or on all supported
  52735.      calendars if no <TT
  52736. CLASS="parameter"
  52737. ><I
  52738. >calendar</I
  52739. ></TT
  52740. > is specified.
  52741.     </P
  52742. ><P
  52743. >      Calendar information is returned as an array containing the
  52744.      elements <TT
  52745. CLASS="literal"
  52746. >calname</TT
  52747. >, <TT
  52748. CLASS="literal"
  52749. >calsymbol</TT
  52750. >,
  52751.      <TT
  52752. CLASS="literal"
  52753. >month</TT
  52754. >, <TT
  52755. CLASS="literal"
  52756. >abbrevmonth</TT
  52757. > and
  52758.      <TT
  52759. CLASS="literal"
  52760. >maxdaysinmonth</TT
  52761. >.
  52762.     </P
  52763. ><P
  52764. >      If no <TT
  52765. CLASS="parameter"
  52766. ><I
  52767. >calendar</I
  52768. ></TT
  52769. > is specified information on all
  52770.      supported calendars is returned as an array. This functionality
  52771.      will be available beginning with PHP 5.
  52772.     </P
  52773. ></DIV
  52774. ><H1
  52775. ><A
  52776. NAME="function.cal-to-jd"
  52777. ></A
  52778. >cal_to_jd</H1
  52779. ><DIV
  52780. CLASS="refnamediv"
  52781. ><A
  52782. NAME="AEN10281"
  52783. ></A
  52784. ><P
  52785. >    (PHP 4 >= 4.1.0)</P
  52786. >cal_to_jd -- Converts from a supported calendar to Julian Day Count</DIV
  52787. ><DIV
  52788. CLASS="refsect1"
  52789. ><A
  52790. NAME="AEN10284"
  52791. ></A
  52792. ><H2
  52793. >Description</H2
  52794. >int <B
  52795. CLASS="methodname"
  52796. >cal_to_jd</B
  52797. > ( int calendar, int month, int day, int year)<BR
  52798. ></BR
  52799. ><P
  52800. >      <B
  52801. CLASS="function"
  52802. >cal_to_jd()</B
  52803. > calculates the Julian day count
  52804.      for a date in the specified <TT
  52805. CLASS="parameter"
  52806. ><I
  52807. >calendar</I
  52808. ></TT
  52809. >.
  52810.      Supported <TT
  52811. CLASS="parameter"
  52812. ><I
  52813. >calendar</I
  52814. ></TT
  52815. >s are
  52816.      <TT
  52817. CLASS="constant"
  52818. ><B
  52819. >CAL_GREGORIAN</B
  52820. ></TT
  52821. >,
  52822.      <TT
  52823. CLASS="constant"
  52824. ><B
  52825. >CAL_JULIAN</B
  52826. ></TT
  52827. >,
  52828.      <TT
  52829. CLASS="constant"
  52830. ><B
  52831. >CAL_JEWISH</B
  52832. ></TT
  52833. > and
  52834.      <TT
  52835. CLASS="constant"
  52836. ><B
  52837. >CAL_FRENCH</B
  52838. ></TT
  52839. >.
  52840.     </P
  52841. ><P
  52842. >      See also <B
  52843. CLASS="function"
  52844. >cal_to_jd()</B
  52845. >.
  52846.     </P
  52847. ></DIV
  52848. ><H1
  52849. ><A
  52850. NAME="function.easter-date"
  52851. ></A
  52852. >easter_date</H1
  52853. ><DIV
  52854. CLASS="refnamediv"
  52855. ><A
  52856. NAME="AEN10312"
  52857. ></A
  52858. ><P
  52859. >    (PHP 3>= 3.0.9, PHP 4 )</P
  52860. >easter_date -- Zjistit UNIXov² timestamp VelikonoΦnφ p∙lnoci v danΘm roce
  52861.     </DIV
  52862. ><DIV
  52863. CLASS="refsect1"
  52864. ><A
  52865. NAME="AEN10315"
  52866. ></A
  52867. ><H2
  52868. >Popis</H2
  52869. >int <B
  52870. CLASS="methodname"
  52871. >easter_date</B
  52872. > ( int year)<BR
  52873. ></BR
  52874. ><P
  52875. >      Vracφ UNIXov² timestamp odpovφdajφcφ VelikonoΦnφ p∙lnoci v danΘm roce.
  52876.      Default <TT
  52877. CLASS="parameter"
  52878. ><I
  52879. >year</I
  52880. ></TT
  52881. > je souΦasn² rok.
  52882.     </P
  52883. ><P
  52884. >      <SPAN
  52885. CLASS="emphasis"
  52886. ><I
  52887. CLASS="emphasis"
  52888. >Varovßnφ:</I
  52889. ></SPAN
  52890. > Tato funkce vygeneruje varovßnφ, pokud je
  52891.      <TT
  52892. CLASS="parameter"
  52893. ><I
  52894. >year</I
  52895. ></TT
  52896. > mimo rozsah UNIXov²ch timestamp∙ (tj. p°ed 1970
  52897.      nebo po 2037).
  52898.      <TABLE
  52899. WIDTH="100%"
  52900. BORDER="0"
  52901. CELLPADDING="0"
  52902. CELLSPACING="0"
  52903. CLASS="EXAMPLE"
  52904. ><TR
  52905. ><TD
  52906. ><DIV
  52907. CLASS="example"
  52908. ><A
  52909. NAME="AEN10328"
  52910. ></A
  52911. ><P
  52912. ><B
  52913. >P°φklad 1. Ukßzka <B
  52914. CLASS="function"
  52915. >easter_date()</B
  52916. ></B
  52917. ></P
  52918. ><TABLE
  52919. BORDER="0"
  52920. BGCOLOR="#E0E0E0"
  52921. CELLPADDING="5"
  52922. ><TR
  52923. ><TD
  52924. ><PRE
  52925. CLASS="php"
  52926. >echo date ("M-d-Y", easter_date(1999));        /* "Apr-04-1999" */
  52927. echo date ("M-d-Y", easter_date(2000));        /* "Apr-23-2000" */
  52928. echo date ("M-d-Y", easter_date(2001));        /* "Apr-15-2001" */</PRE
  52929. ></TD
  52930. ></TR
  52931. ></TABLE
  52932. ></DIV
  52933. ></TD
  52934. ></TR
  52935. ></TABLE
  52936. >
  52937.     </P
  52938. ><P
  52939. >      Datum Velikonoc bylo definovßno Nicaejsk²m koncilem v r. 325 n. l. jako
  52940.      ned∞le po prvnφm ·pl≥ku kter² p°ipadß na nebo po jarnφ rovnodennosti.
  52941.      Rovnodennost se v╛dy p°edpoklßdß na 21. b°ezna, tak╛e se v²poΦet redukuje
  52942.      na urΦenφ data ·pl≥ku a data nßsledujφcφ ned∞le. Zde pou╛it² algoritmus
  52943.      byl poprvΘ pou╛it kolem roku 532 Dionysiem Exiguem. V JulißnskΘm kalendß°i
  52944.      (pro lΘta p°ed 1753) se na sledovßnφ fßzφ M∞sφce pou╛φval jednoduch²
  52945.      devatenßctilet² cyklus. V GregorißnskΘm kalendß°i (pro lΘta po 1753 -
  52946.      navr╛en Claviem a Liliem a zaveden pape╛em ╪eho°em XIII v °φjnu 1582, v
  52947.      Britßnii a jejφch koloniφch v zß°φ 1752) se p°idßvajφ dva faktory, kterΘ
  52948.      tento cyklus zp°es≥ujφ.
  52949.     </P
  52950. ><P
  52951. >      (K≤d je zalo╛en na C programu od Simona Kershawa,
  52952.      <webmaster@ely.anglican.org>)
  52953.     </P
  52954. ><P
  52955. >      V²poΦet Velikonoc p°ed rokem 1970 nebo po roce 2037 viz
  52956.      <A
  52957. HREF="#function.easter-days"
  52958. ><B
  52959. CLASS="function"
  52960. >easter_days()</B
  52961. ></A
  52962. >.
  52963.     </P
  52964. ></DIV
  52965. ><H1
  52966. ><A
  52967. NAME="function.easter-days"
  52968. ></A
  52969. >easter_days</H1
  52970. ><DIV
  52971. CLASS="refnamediv"
  52972. ><A
  52973. NAME="AEN10337"
  52974. ></A
  52975. ><P
  52976. >    (PHP 3>= 3.0.9, PHP 4 )</P
  52977. >easter_days -- 
  52978.      Get number of days after March 21 on which Easter falls for a
  52979.      given year
  52980.     </DIV
  52981. ><DIV
  52982. CLASS="refsect1"
  52983. ><A
  52984. NAME="AEN10340"
  52985. ></A
  52986. ><H2
  52987. >Popis</H2
  52988. >int <B
  52989. CLASS="methodname"
  52990. >easter_days</B
  52991. > ( int year)<BR
  52992. ></BR
  52993. ><P
  52994. >      Vracφ poΦet dnφ od 21. b°ezna do Velikonoc v danΘm roce. Default
  52995.      <TT
  52996. CLASS="parameter"
  52997. ><I
  52998. >year</I
  52999. ></TT
  53000. > je souΦasn² rok.
  53001.     </P
  53002. ><P
  53003. >      Tato funkce je vyu╛itelnß mφsto <A
  53004. HREF="#function.easter-date"
  53005. ><B
  53006. CLASS="function"
  53007. >easter_date()</B
  53008. ></A
  53009. > na v²poΦty
  53010.      Velikonoc pro roky kterΘ spadajφ mimo rozsah UNIXov²ch timestamp∙ (tj. p°ed
  53011.      rokem 1970 a po roce 2037).
  53012.      <TABLE
  53013. WIDTH="100%"
  53014. BORDER="0"
  53015. CELLPADDING="0"
  53016. CELLSPACING="0"
  53017. CLASS="EXAMPLE"
  53018. ><TR
  53019. ><TD
  53020. ><DIV
  53021. CLASS="example"
  53022. ><A
  53023. NAME="AEN10352"
  53024. ></A
  53025. ><P
  53026. ><B
  53027. >P°φklad 1. Ukßzka <A
  53028. HREF="#function.easter-date"
  53029. ><B
  53030. CLASS="function"
  53031. >easter_date()</B
  53032. ></A
  53033. ></B
  53034. ></P
  53035. ><TABLE
  53036. BORDER="0"
  53037. BGCOLOR="#E0E0E0"
  53038. CELLPADDING="5"
  53039. ><TR
  53040. ><TD
  53041. ><PRE
  53042. CLASS="php"
  53043. >echo easter_days (1999);        /* 14, i.e. April 4   */
  53044. echo easter_days (1492);        /* 32, i.e. April 22  */
  53045. echo easter_days (1913);        /*  2, i.e. March 23  */</PRE
  53046. ></TD
  53047. ></TR
  53048. ></TABLE
  53049. ></DIV
  53050. ></TD
  53051. ></TR
  53052. ></TABLE
  53053. >
  53054.     </P
  53055. ><P
  53056. >      Datum Velikonoc bylo definovßno Nicaejsk²m koncilem v r. 325 n. l. jako
  53057.      ned∞le po prvnφm ·pl≥ku kter² p°ipadß na nebo po jarnφ rovnodennosti.
  53058.      Rovnodennost se v╛dy p°edpoklßdß na 21. b°ezna, tak╛e se v²poΦet redukuje
  53059.      na urΦenφ data ·pl≥ku a data nßsledujφcφ ned∞le. Zde pou╛it² algoritmus
  53060.      byl poprvΘ pou╛it kolem roku 532 Dionysiem Exiguem. V JulißnskΘm kalendß°i
  53061.      (pro lΘta p°ed 1753) se na sledovßnφ fßzφ M∞sφce pou╛φval jednoduch²
  53062.      devatenßctilet² cyklus. V GregorißnskΘm kalendß°i (pro lΘta po 1753 -
  53063.      navr╛en Claviem a Liliem a zaveden pape╛em ╪eho°em XIII v °φjnu 1582, v
  53064.      Britßnii a jejφch koloniφch v zß°φ 1752) se p°idßvajφ dva faktory, kterΘ
  53065.      tento cyklus zp°es≥ujφ.
  53066.     </P
  53067. ><P
  53068. >      (K≤d je zalo╛en na C programu od Simona Kershawa,
  53069.      <webmaster@ely.anglican.org>)
  53070.     </P
  53071. ><P
  53072. >      Viz takΘ: <A
  53073. HREF="#function.easter-date"
  53074. ><B
  53075. CLASS="function"
  53076. >easter_date()</B
  53077. ></A
  53078. >.
  53079.     </P
  53080. ></DIV
  53081. ><H1
  53082. ><A
  53083. NAME="function.frenchtojd"
  53084. ></A
  53085. >FrenchToJD</H1
  53086. ><DIV
  53087. CLASS="refnamediv"
  53088. ><A
  53089. NAME="AEN10361"
  53090. ></A
  53091. ><P
  53092. >    (PHP 3, PHP 4 )</P
  53093. >FrenchToJD -- 
  53094.      P°evΘst datum z FrancouzskΘho republikßnskΘho kalendß°e na Julian
  53095.      Day Count
  53096.     </DIV
  53097. ><DIV
  53098. CLASS="refsect1"
  53099. ><A
  53100. NAME="AEN10364"
  53101. ></A
  53102. ><H2
  53103. >Popis</H2
  53104. >int <B
  53105. CLASS="methodname"
  53106. >frenchtojd</B
  53107. > ( int month, int day, int year)<BR
  53108. ></BR
  53109. ><P
  53110. >      P°evßdφ datum z FrancouzskΘho republikßnskΘho kalendß°e na Julian
  53111.      Day Count.
  53112.     </P
  53113. ><P
  53114. >      Tyto rutiny konvertujφ pouze data v letech 1 a╛ 14 (Gregorißnskß data
  53115.      22. zß°φ 1792 a╛ 22. zß°φ 1806). To vφce ne╛ dostateΦn∞ pokr²vß obdobφ, po
  53116.      kterΘ se tento kalendß° pou╛φval.
  53117.     </P
  53118. ></DIV
  53119. ><H1
  53120. ><A
  53121. NAME="function.gregoriantojd"
  53122. ></A
  53123. >GregorianToJD</H1
  53124. ><DIV
  53125. CLASS="refnamediv"
  53126. ><A
  53127. NAME="AEN10381"
  53128. ></A
  53129. ><P
  53130. >    (PHP 3, PHP 4 )</P
  53131. >GregorianToJD -- P°evΘst GregorißnskΘ datum na Julian Day Count</DIV
  53132. ><DIV
  53133. CLASS="refsect1"
  53134. ><A
  53135. NAME="AEN10384"
  53136. ></A
  53137. ><H2
  53138. >Popis</H2
  53139. >int <B
  53140. CLASS="methodname"
  53141. >gregoriantojd</B
  53142. > ( int month, int day, int year)<BR
  53143. ></BR
  53144. ><P
  53145. >      Platn² rozsah GregorißnskΘho kalendß°e je 4714 p°. n. l. a╛ 9999 n. l.
  53146.     </P
  53147. ><P
  53148. >      Jakkoli tento software zvlßdß data a╛ do 4714 p°. n. l., takovΘ pou╛itφ asi
  53149.      nemß smysl. Gregorißnsk² kalendß° byl zalo╛en a╛ 15. °φjna 1582 (5. °φjna
  53150.      1582 podle JulißnskΘho kalendß°e). N∞kterΘ zem∞ ho p°ijaly mnohem pozd∞ji,
  53151.      ╪ecko a╛ v r. 1923. V∞t╣ina evropsk²m stßt∙ p°ed Gregorißnsk²m kalendß°em
  53152.      pou╛φvala Julißnsk².
  53153.      <TABLE
  53154. WIDTH="100%"
  53155. BORDER="0"
  53156. CELLPADDING="0"
  53157. CELLSPACING="0"
  53158. CLASS="EXAMPLE"
  53159. ><TR
  53160. ><TD
  53161. ><DIV
  53162. CLASS="example"
  53163. ><A
  53164. NAME="AEN10400"
  53165. ></A
  53166. ><P
  53167. ><B
  53168. >P°φklad 1. Kalendß°ovΘ funkce</B
  53169. ></P
  53170. ><TABLE
  53171. BORDER="0"
  53172. BGCOLOR="#E0E0E0"
  53173. CELLPADDING="5"
  53174. ><TR
  53175. ><TD
  53176. ><PRE
  53177. CLASS="php"
  53178. ><?php
  53179. $jd = GregorianToJD (10,11,1970);
  53180. echo "$jd\n";
  53181. $gregorian = JDToGregorian ($jd);
  53182. echo "$gregorian\n";
  53183. ?></PRE
  53184. ></TD
  53185. ></TR
  53186. ></TABLE
  53187. ></DIV
  53188. ></TD
  53189. ></TR
  53190. ></TABLE
  53191. >
  53192.     </P
  53193. ></DIV
  53194. ><H1
  53195. ><A
  53196. NAME="function.jddayofweek"
  53197. ></A
  53198. >JDDayOfWeek</H1
  53199. ><DIV
  53200. CLASS="refnamediv"
  53201. ><A
  53202. NAME="AEN10404"
  53203. ></A
  53204. ><P
  53205. >    (PHP 3, PHP 4 )</P
  53206. >JDDayOfWeek -- Vrßtit den v t²dnu</DIV
  53207. ><DIV
  53208. CLASS="refsect1"
  53209. ><A
  53210. NAME="AEN10407"
  53211. ></A
  53212. ><H2
  53213. >Popis</H2
  53214. >mixed <B
  53215. CLASS="methodname"
  53216. >jddayofweek</B
  53217. > ( int julianday, int mode)<BR
  53218. ></BR
  53219. ><P
  53220. >      Vracφ den v t²dnu. V zßvislosti na m≤du vracφ °et∞zec nebo integer.
  53221.      <DIV
  53222. CLASS="table"
  53223. ><A
  53224. NAME="AEN10419"
  53225. ></A
  53226. ><P
  53227. ><B
  53228. >Tabulka 1. Kalendß°ovΘ t²dennφ m≤dy</B
  53229. ></P
  53230. ><TABLE
  53231. BORDER="1"
  53232. CLASS="CALSTABLE"
  53233. ><THEAD
  53234. ><TR
  53235. ><TH
  53236. ALIGN="LEFT"
  53237. VALIGN="MIDDLE"
  53238. >M≤d</TH
  53239. ><TH
  53240. ALIGN="LEFT"
  53241. VALIGN="MIDDLE"
  53242. >V²znam</TH
  53243. ></TR
  53244. ></THEAD
  53245. ><TBODY
  53246. ><TR
  53247. ><TD
  53248. ALIGN="LEFT"
  53249. VALIGN="MIDDLE"
  53250. >0</TD
  53251. ><TD
  53252. ALIGN="LEFT"
  53253. VALIGN="MIDDLE"
  53254. >       Vracφ Φφslo dne jako integer (0=sunday, 1=monday, etc)
  53255.      </TD
  53256. ></TR
  53257. ><TR
  53258. ><TD
  53259. ALIGN="LEFT"
  53260. VALIGN="MIDDLE"
  53261. >1</TD
  53262. ><TD
  53263. ALIGN="LEFT"
  53264. VALIGN="MIDDLE"
  53265. >       Vracφ °et∞zec obsahujφcφ nßzev dne v t²dnu (anglick² gregorißnsk²)
  53266.      </TD
  53267. ></TR
  53268. ><TR
  53269. ><TD
  53270. ALIGN="LEFT"
  53271. VALIGN="MIDDLE"
  53272. >2</TD
  53273. ><TD
  53274. ALIGN="LEFT"
  53275. VALIGN="MIDDLE"
  53276. >       Vracφ °et∞zec obsahujφcφ zkrßcen² nßzev dne v t²dnu (anglick² gregorißnsk²)
  53277.      </TD
  53278. ></TR
  53279. ></TBODY
  53280. ></TABLE
  53281. ></DIV
  53282. >
  53283.     </P
  53284. ></DIV
  53285. ><H1
  53286. ><A
  53287. NAME="function.jdmonthname"
  53288. ></A
  53289. >JDMonthName</H1
  53290. ><DIV
  53291. CLASS="refnamediv"
  53292. ><A
  53293. NAME="AEN10437"
  53294. ></A
  53295. ><P
  53296. >    (PHP 3, PHP 4 )</P
  53297. >JDMonthName -- Vrßtit nßzev m∞sφce</DIV
  53298. ><DIV
  53299. CLASS="refsect1"
  53300. ><A
  53301. NAME="AEN10440"
  53302. ></A
  53303. ><H2
  53304. >Popis</H2
  53305. >string <B
  53306. CLASS="methodname"
  53307. >jdmonthname</B
  53308. > ( int julianday, int mode)<BR
  53309. ></BR
  53310. ><P
  53311. >      Vracφ °et∞zec obsahujφcφ nßzev m∞sφce. <TT
  53312. CLASS="parameter"
  53313. ><I
  53314. >mode</I
  53315. ></TT
  53316. > urΦuje,
  53317.      na kter² kalendß° se mß Julian Day Count konvertovat a jak² typ jmΘna se
  53318.      mß vrßtit.
  53319.      <DIV
  53320. CLASS="table"
  53321. ><A
  53322. NAME="AEN10453"
  53323. ></A
  53324. ><P
  53325. ><B
  53326. >Tabulka 1. Kalendß°ovΘ m≤dy</B
  53327. ></P
  53328. ><TABLE
  53329. BORDER="1"
  53330. CLASS="CALSTABLE"
  53331. ><THEAD
  53332. ><TR
  53333. ><TH
  53334. ALIGN="LEFT"
  53335. VALIGN="MIDDLE"
  53336. >M≤d</TH
  53337. ><TH
  53338. ALIGN="LEFT"
  53339. VALIGN="MIDDLE"
  53340. >V²znam</TH
  53341. ></TR
  53342. ></THEAD
  53343. ><TBODY
  53344. ><TR
  53345. ><TD
  53346. ALIGN="LEFT"
  53347. VALIGN="MIDDLE"
  53348. >0</TD
  53349. ><TD
  53350. ALIGN="LEFT"
  53351. VALIGN="MIDDLE"
  53352. >Gregorißnsk² - zkrßcen²</TD
  53353. ></TR
  53354. ><TR
  53355. ><TD
  53356. ALIGN="LEFT"
  53357. VALIGN="MIDDLE"
  53358. >1</TD
  53359. ><TD
  53360. ALIGN="LEFT"
  53361. VALIGN="MIDDLE"
  53362. >Gregorißnsk²</TD
  53363. ></TR
  53364. ><TR
  53365. ><TD
  53366. ALIGN="LEFT"
  53367. VALIGN="MIDDLE"
  53368. >2</TD
  53369. ><TD
  53370. ALIGN="LEFT"
  53371. VALIGN="MIDDLE"
  53372. >Julißnsk² - zkrßcen²</TD
  53373. ></TR
  53374. ><TR
  53375. ><TD
  53376. ALIGN="LEFT"
  53377. VALIGN="MIDDLE"
  53378. >3</TD
  53379. ><TD
  53380. ALIGN="LEFT"
  53381. VALIGN="MIDDLE"
  53382. >Julißnsk²</TD
  53383. ></TR
  53384. ><TR
  53385. ><TD
  53386. ALIGN="LEFT"
  53387. VALIGN="MIDDLE"
  53388. >4</TD
  53389. ><TD
  53390. ALIGN="LEFT"
  53391. VALIGN="MIDDLE"
  53392. > idovsk²</TD
  53393. ></TR
  53394. ><TR
  53395. ><TD
  53396. ALIGN="LEFT"
  53397. VALIGN="MIDDLE"
  53398. >5</TD
  53399. ><TD
  53400. ALIGN="LEFT"
  53401. VALIGN="MIDDLE"
  53402. >Francouzsk² republikßnsk²</TD
  53403. ></TR
  53404. ></TBODY
  53405. ></TABLE
  53406. ></DIV
  53407. >
  53408.     </P
  53409. ></DIV
  53410. ><H1
  53411. ><A
  53412. NAME="function.jdtofrench"
  53413. ></A
  53414. >JDToFrench</H1
  53415. ><DIV
  53416. CLASS="refnamediv"
  53417. ><A
  53418. NAME="AEN10480"
  53419. ></A
  53420. ><P
  53421. >    (PHP 3, PHP 4 )</P
  53422. >JDToFrench -- 
  53423.      P°evΘst Julian Day Count na Francouzsk² republikßnsk² kalendß°
  53424.     </DIV
  53425. ><DIV
  53426. CLASS="refsect1"
  53427. ><A
  53428. NAME="AEN10483"
  53429. ></A
  53430. ><H2
  53431. >Popis</H2
  53432. >string <B
  53433. CLASS="methodname"
  53434. >jdtofrench</B
  53435. > ( int juliandaycount)<BR
  53436. ></BR
  53437. ><P
  53438. >      P°evßdφ Julian Day Count na Francouzsk² republikßnsk² kalendß°.
  53439.     </P
  53440. ></DIV
  53441. ><H1
  53442. ><A
  53443. NAME="function.jdtogregorian"
  53444. ></A
  53445. >JDToGregorian</H1
  53446. ><DIV
  53447. CLASS="refnamediv"
  53448. ><A
  53449. NAME="AEN10493"
  53450. ></A
  53451. ><P
  53452. >    (PHP 3, PHP 4 )</P
  53453. >JDToGregorian -- P°evΘst Julian Day Count na GregorißnskΘ datum</DIV
  53454. ><DIV
  53455. CLASS="refsect1"
  53456. ><A
  53457. NAME="AEN10496"
  53458. ></A
  53459. ><H2
  53460. >Popis</H2
  53461. >string <B
  53462. CLASS="methodname"
  53463. >jdtogregorian</B
  53464. > ( int julianday)<BR
  53465. ></BR
  53466. ><P
  53467. >      P°evßdφ Julian Day Count na °et∞zec obsahujφcφ GregorißnskΘ datum ve formßtu
  53468.      "m∞sφc/den/rok".
  53469.     </P
  53470. ></DIV
  53471. ><H1
  53472. ><A
  53473. NAME="function.jdtojewish"
  53474. ></A
  53475. >JDToJewish</H1
  53476. ><DIV
  53477. CLASS="refnamediv"
  53478. ><A
  53479. NAME="AEN10506"
  53480. ></A
  53481. ><P
  53482. >    (PHP 3, PHP 4 )</P
  53483. >JDToJewish -- 
  53484.      P°evΘst Julian Day Count na  idovsk² kalendß°
  53485.     </DIV
  53486. ><DIV
  53487. CLASS="refsect1"
  53488. ><A
  53489. NAME="AEN10509"
  53490. ></A
  53491. ><H2
  53492. >Popis</H2
  53493. >string <B
  53494. CLASS="methodname"
  53495. >jdtojewish</B
  53496. > ( int julianday)<BR
  53497. ></BR
  53498. ><P
  53499. >      P°evßdφ Julian Day Count na  idovsk² kalendß°.
  53500.     </P
  53501. ></DIV
  53502. ><H1
  53503. ><A
  53504. NAME="function.jdtojulian"
  53505. ></A
  53506. >JDToJulian</H1
  53507. ><DIV
  53508. CLASS="refnamediv"
  53509. ><A
  53510. NAME="AEN10519"
  53511. ></A
  53512. ><P
  53513. >    (PHP 3, PHP 4 )</P
  53514. >JDToJulian -- 
  53515.      P°evΘst Julian Day Count na JulißnskΘ datum
  53516.     </DIV
  53517. ><DIV
  53518. CLASS="refsect1"
  53519. ><A
  53520. NAME="AEN10522"
  53521. ></A
  53522. ><H2
  53523. >Popis</H2
  53524. >string <B
  53525. CLASS="methodname"
  53526. >jdtojulian</B
  53527. > ( int julianday)<BR
  53528. ></BR
  53529. ><P
  53530. >      P°evßdφ Julian Day Count na °et∞zec obsahujφcφ JulißnskΘ datum ve formßtu
  53531.      "m∞sφc/den/rok".
  53532.     </P
  53533. ></DIV
  53534. ><H1
  53535. ><A
  53536. NAME="function.jdtounix"
  53537. ></A
  53538. >jdtounix</H1
  53539. ><DIV
  53540. CLASS="refnamediv"
  53541. ><A
  53542. NAME="AEN10532"
  53543. ></A
  53544. ><P
  53545. >    (PHP 4 )</P
  53546. >jdtounix -- P°evΘst Julian Day Count na UNIXov² timestamp</DIV
  53547. ><DIV
  53548. CLASS="refsect1"
  53549. ><A
  53550. NAME="AEN10535"
  53551. ></A
  53552. ><H2
  53553. >Popis</H2
  53554. >int <B
  53555. CLASS="methodname"
  53556. >jdtounix</B
  53557. > ( int jday)<BR
  53558. ></BR
  53559. ><P
  53560. >      <B
  53561. CLASS="function"
  53562. >jdtounix()</B
  53563. > vracφ UNIXov² timestamp odpovφdajφcφ Julian
  53564.      Day Countu danΘmu v <TT
  53565. CLASS="parameter"
  53566. ><I
  53567. >jday</I
  53568. ></TT
  53569. > nebo <TT
  53570. CLASS="constant"
  53571. ><B
  53572. >FALSE</B
  53573. ></TT
  53574. >,
  53575.      pokud je <TT
  53576. CLASS="parameter"
  53577. ><I
  53578. >jday</I
  53579. ></TT
  53580. > mimo UNIXovou epochu (GregorißnskΘ
  53581.      roky mezi 1970 a 2037, nebo-li 2440588 <= <TT
  53582. CLASS="parameter"
  53583. ><I
  53584. >jday</I
  53585. ></TT
  53586. >
  53587.      <= 2465342 )
  53588.     </P
  53589. ><P
  53590. >      Viz takΘ: <B
  53591. CLASS="function"
  53592. >jdtounix()</B
  53593. >.
  53594.     </P
  53595. ><DIV
  53596. CLASS="note"
  53597. ><BLOCKQUOTE
  53598. CLASS="note"
  53599. ><P
  53600. ><B
  53601. >Poznßmka: </B
  53602. >
  53603.       Tato funkce byla p°idßna v PHP 4 RC2.
  53604.      </P
  53605. ></BLOCKQUOTE
  53606. ></DIV
  53607. ></DIV
  53608. ><H1
  53609. ><A
  53610. NAME="function.jewishtojd"
  53611. ></A
  53612. >JewishToJD</H1
  53613. ><DIV
  53614. CLASS="refnamediv"
  53615. ><A
  53616. NAME="AEN10554"
  53617. ></A
  53618. ><P
  53619. >    (PHP 3, PHP 4 )</P
  53620. >JewishToJD -- 
  53621.      P°evΘst datum podle  idovskΘho kalendß°e na Julian Day Count
  53622.     </DIV
  53623. ><DIV
  53624. CLASS="refsect1"
  53625. ><A
  53626. NAME="AEN10557"
  53627. ></A
  53628. ><H2
  53629. >Popis</H2
  53630. >int <B
  53631. CLASS="methodname"
  53632. >jewishtojd</B
  53633. > ( int month, int day, int year)<BR
  53634. ></BR
  53635. ><P
  53636. >      Platn² rozsah
  53637.      Jakkoli tento software zvlßdß data a╛ do roku 1 (3761 p°. n. l.), takovΘ
  53638.      pou╛itφ asi nemß smysl.
  53639.     </P
  53640. ><P
  53641. >       idovsk² kalendß° se pou╛φvß n∞kolik tisφc let, ale zpoΦßtku neexistoval
  53642.      vzorec na urΦenφ zaΦßtku m∞sφce. Nov² m∞sφc zaΦφnal, kdy╛ byl poprvΘ spat°en
  53643.      nov² M∞sφc.
  53644.     </P
  53645. ></DIV
  53646. ><H1
  53647. ><A
  53648. NAME="function.juliantojd"
  53649. ></A
  53650. >JulianToJD</H1
  53651. ><DIV
  53652. CLASS="refnamediv"
  53653. ><A
  53654. NAME="AEN10574"
  53655. ></A
  53656. ><P
  53657. >    (PHP 3, PHP 4 )</P
  53658. >JulianToJD -- 
  53659.      P°evΘst JulißnskΘ datum na Julian Day Count
  53660.     </DIV
  53661. ><DIV
  53662. CLASS="refsect1"
  53663. ><A
  53664. NAME="AEN10577"
  53665. ></A
  53666. ><H2
  53667. >Popis</H2
  53668. >int <B
  53669. CLASS="methodname"
  53670. >juliantojd</B
  53671. > ( int month, int day, int year)<BR
  53672. ></BR
  53673. ><P
  53674. >      Platn² rozsah pro Julißnsk² kalendß° je 4713 p°. n. l. a╛ 9999 n. l.
  53675.     </P
  53676. ><P
  53677. >      Jakkoli tento software zvlßdß data a╛ do 4713 p°. n. l., takovΘ pou╛itφ asi
  53678.      nemß smysl. Tento kalendß° byl vytvo°en v roce 46 p°. n. l., ale detaily se
  53679.      nestabilizovaly nejmΘn∞ do 8 n. l., a mo╛nß a╛ do konce 4. stoletφ. Navφc
  53680.      zaΦßtek roku se li╣il od kultury ke kultu°e - ne v╣echny p°ijφmaly leden
  53681.      jako prvnφ m∞sφc roku.
  53682.     </P
  53683. ></DIV
  53684. ><H1
  53685. ><A
  53686. NAME="function.unixtojd"
  53687. ></A
  53688. >unixtojd</H1
  53689. ><DIV
  53690. CLASS="refnamediv"
  53691. ><A
  53692. NAME="AEN10594"
  53693. ></A
  53694. ><P
  53695. >    (PHP 4 )</P
  53696. >unixtojd -- P°evΘst UNIXov² timestamp na Julian Day Count</DIV
  53697. ><DIV
  53698. CLASS="refsect1"
  53699. ><A
  53700. NAME="AEN10597"
  53701. ></A
  53702. ><H2
  53703. >Popis</H2
  53704. >int <B
  53705. CLASS="methodname"
  53706. >unixtojd</B
  53707. > ( [int timestamp])<BR
  53708. ></BR
  53709. ><P
  53710. >      Vracφ Julian Day Count pro UNIXov² <TT
  53711. CLASS="parameter"
  53712. ><I
  53713. >timestamp</I
  53714. ></TT
  53715. >
  53716.      (sekundy od 1.1.1970), nebo pro aktußlnφ den, pokud nenφ dßn
  53717.      <TT
  53718. CLASS="parameter"
  53719. ><I
  53720. >timestamp</I
  53721. ></TT
  53722. >.
  53723.     </P
  53724. ><P
  53725. >      Viz takΘ: <A
  53726. HREF="#function.jdtounix"
  53727. ><B
  53728. CLASS="function"
  53729. >jdtounix()</B
  53730. ></A
  53731. >.
  53732.     </P
  53733. ><DIV
  53734. CLASS="note"
  53735. ><BLOCKQUOTE
  53736. CLASS="note"
  53737. ><P
  53738. ><B
  53739. >Poznßmka: </B
  53740. >
  53741.       Tato funkce byla p°idßna v PHP 4 RC2.
  53742.      </P
  53743. ></BLOCKQUOTE
  53744. ></DIV
  53745. ></DIV
  53746. ></DIV
  53747. ><DIV
  53748. CLASS="reference"
  53749. ><A
  53750. NAME="ref.ccvs"
  53751. ></A
  53752. ><DIV
  53753. CLASS="TITLEPAGE"
  53754. ><H1
  53755. CLASS="title"
  53756. >VII. CCVS API Functions</H1
  53757. ><DIV
  53758. CLASS="PARTINTRO"
  53759. ><A
  53760. NAME="AEN10615"
  53761. ></A
  53762. ><DIV
  53763. CLASS="section"
  53764. ><H1
  53765. CLASS="section"
  53766. ><A
  53767. NAME="ccvs.intro"
  53768. ></A
  53769. >┌vod</H1
  53770. ><P
  53771. >      Tyto funkce p°edstavujφ interface k CCVS API, a umo╛nujφ tak p°φmo pracovat
  53772.      s CCVS z va╣ich PHP skript∙. CCVS je <A
  53773. HREF="http://www.redhat.com/"
  53774. TARGET="_top"
  53775. >RedHatφ</A
  53776. > °e╣enφ "zprost°edkovatele"
  53777.      ve zpracovßnφ kreditnφch karet. Umo╛%nuje vßm oslovovat p°φmo zpracovatele
  53778.      kreditnφch karet p°es vß╣ *nix systΘm a modem. Pomocφ CCVS modulu pro PHP
  53779.      m∙╛ete zpracovßvat kreditnφ karty p°es CCVS ve va╣ich PHP skriptech.
  53780.      Nßsledujφcφ reference tento proces p°iblφ╛φ.
  53781.     </P
  53782. ><DIV
  53783. CLASS="note"
  53784. ><BLOCKQUOTE
  53785. CLASS="note"
  53786. ><P
  53787. ><B
  53788. >Poznßmka: </B
  53789. >
  53790.       CCVS bylo firmou RedHat pozastaveno a nemß v plßnu
  53791.       vydßvat dal╣φ klφΦe nebo podporovat kontrakty. Pokud hledßte
  53792.       nßhradu, zva╛te
  53793.       <A
  53794. HREF="http://www.mcve.com/"
  53795. TARGET="_top"
  53796. >MCVE firmy Main Street Softworks</A
  53797. >
  53798.       jako mo╛nou nßhradu. Mß podobn² design a dokumentovanou
  53799.       podporu PHP!
  53800.      </P
  53801. ><P
  53802. >       Toto roz╣φ°enφ bylo z PHP odstran∞no a od verze 4.3.0 nenφ k dispozici.
  53803.       Pokud chcete pou╛φvat funkce pro zpracovßnφ kreditnφch karet,
  53804.       m∙╛ete mφsto toho pou╛φt roz╣φ°enφ <A
  53805. HREF="#ref.mcve"
  53806. >MCVE</A
  53807. >.
  53808.      </P
  53809. ></BLOCKQUOTE
  53810. ></DIV
  53811. ></DIV
  53812. ><DIV
  53813. CLASS="section"
  53814. ><HR><H1
  53815. CLASS="section"
  53816. ><A
  53817. NAME="ccvs.installation"
  53818. ></A
  53819. >Instalace</H1
  53820. ><P
  53821. >     Pokud chcete zapnout CCVS podporu v PHP, zjist∞te si nejd°φve instalaΦnφ
  53822.     adresß° CCVS. Potom budete muset PHP zkonfigurovat s <TT
  53823. CLASS="option"
  53824. >--with-ccvs</TT
  53825. >. Pokud toto pou╛ijete be udßnφ cesty
  53826.     k va╣φ instalaci CCVS, PHP se pokusφ podφvat do defaultnφ instalaΦnφ lokace
  53827.     CCVS (/usr/local/ccvs). Pokud je CCVS na nestandardnφm mφst∞, spust∞te
  53828.     configure s: <TT
  53829. CLASS="option"
  53830. >--with-ccvs=$ccvs_path</TT
  53831. >, kde
  53832.     $ccvs_path je cesta k va╣φ instalaci CVS. Pozn.: Podpora CCVS vy╛aduje
  53833.     existenci $ccvs_path/lib a $ccvs_path/include, a p°φtomnost cv_api.h v
  53834.     adresß°i include a libccvs.a v adresß°i lib.
  53835.    </P
  53836. ><P
  53837. >     Dßle je pot°eba, aby b∞╛el proces ccvsd. Navφc, PHP processy musφ b∞╛et pod
  53838.     stejn²m u╛ivatelem, pod kter²m b∞hß CCVS (nap°. pokud jste instalovali ccvs
  53839.     jako 'ccvs', va╣e PHP procesy musφ takΘ b∞╛et jako 'ccvs').
  53840.  </P
  53841. ></DIV
  53842. ><DIV
  53843. CLASS="section"
  53844. ><HR><H1
  53845. CLASS="section"
  53846. ><A
  53847. NAME="ccvs.seealso"
  53848. ></A
  53849. >Viz takΘ</H1
  53850. ><P
  53851. >      RedHat p°eru╣il podporu CCVS, p°esto je mφrn∞
  53852.      zastaralß dokumentace k dispozici na
  53853.      <A
  53854. HREF="http://redhat.com/docs/manuals/ccvs/"
  53855. TARGET="_top"
  53856. >http://redhat.com/docs/manuals/ccvs/</A
  53857. >.
  53858.     </P
  53859. ></DIV
  53860. ></DIV
  53861. ><DIV
  53862. CLASS="TOC"
  53863. ><DL
  53864. ><DT
  53865. ><B
  53866. >Obsah</B
  53867. ></DT
  53868. ><DT
  53869. ><A
  53870. HREF="#function.ccvs-add"
  53871. >ccvs_add</A
  53872. > -- Add data to a transaction </DT
  53873. ><DT
  53874. ><A
  53875. HREF="#function.ccvs-auth"
  53876. >ccvs_auth</A
  53877. > --  
  53878.      Perform credit authorization test on a transaction 
  53879.     </DT
  53880. ><DT
  53881. ><A
  53882. HREF="#function.ccvs-command"
  53883. >ccvs_command</A
  53884. > -- 
  53885.      Performs a command which is peculiar to a single protocol, 
  53886.      and thus is not available in the general CCVS API 
  53887.     </DT
  53888. ><DT
  53889. ><A
  53890. HREF="#function.ccvs-count"
  53891. >ccvs_count</A
  53892. > -- 
  53893.      Find out how many transactions of a given type are stored in the system 
  53894.     </DT
  53895. ><DT
  53896. ><A
  53897. HREF="#function.ccvs-delete"
  53898. >ccvs_delete</A
  53899. > -- Delete a transaction</DT
  53900. ><DT
  53901. ><A
  53902. HREF="#function.ccvs-done"
  53903. >ccvs_done</A
  53904. > -- Terminate CCVS engine and do cleanup work</DT
  53905. ><DT
  53906. ><A
  53907. HREF="#function.ccvs-init"
  53908. >ccvs_init</A
  53909. > -- Initialize CCVS for use</DT
  53910. ><DT
  53911. ><A
  53912. HREF="#function.ccvs-lookup"
  53913. >ccvs_lookup</A
  53914. > -- 
  53915.      Look up an item of a particular type in the database #
  53916.     </DT
  53917. ><DT
  53918. ><A
  53919. HREF="#function.ccvs-new"
  53920. >ccvs_new</A
  53921. > -- Create a new, blank transaction </DT
  53922. ><DT
  53923. ><A
  53924. HREF="#function.ccvs-report"
  53925. >ccvs_report</A
  53926. > -- Return the status of the background communication process </DT
  53927. ><DT
  53928. ><A
  53929. HREF="#function.ccvs-return"
  53930. >ccvs_return</A
  53931. > -- 
  53932.      Transfer funds from the merchant to the credit card holder 
  53933.     </DT
  53934. ><DT
  53935. ><A
  53936. HREF="#function.ccvs-reverse"
  53937. >ccvs_reverse</A
  53938. > -- 
  53939.      Perform a full reversal on an already-processed authorization 
  53940.     </DT
  53941. ><DT
  53942. ><A
  53943. HREF="#function.ccvs-sale"
  53944. >ccvs_sale</A
  53945. > -- 
  53946.      Transfer funds from the credit card holder to the merchant
  53947.     </DT
  53948. ><DT
  53949. ><A
  53950. HREF="#function.ccvs-status"
  53951. >ccvs_status</A
  53952. > -- Check the status of an invoice</DT
  53953. ><DT
  53954. ><A
  53955. HREF="#function.ccvs-textvalue"
  53956. >ccvs_textvalue</A
  53957. > -- Get text return value for previous function call</DT
  53958. ><DT
  53959. ><A
  53960. HREF="#function.ccvs-void"
  53961. >ccvs_void</A
  53962. > -- 
  53963.      Perform a full reversal on a completed transaction 
  53964.     </DT
  53965. ></DL
  53966. ></DIV
  53967. ></DIV
  53968. ><H1
  53969. ><A
  53970. NAME="function.ccvs-add"
  53971. ></A
  53972. >ccvs_add</H1
  53973. ><DIV
  53974. CLASS="refnamediv"
  53975. ><A
  53976. NAME="AEN10636"
  53977. ></A
  53978. ><P
  53979. >    (4.0.2 - 4.2.3 only)</P
  53980. >ccvs_add -- Add data to a transaction </DIV
  53981. ><DIV
  53982. CLASS="refsect1"
  53983. ><A
  53984. NAME="AEN10639"
  53985. ></A
  53986. ><H2
  53987. >Description</H2
  53988. >string <B
  53989. CLASS="methodname"
  53990. >ccvs_add</B
  53991. > ( string session, string invoice, string argtype, string argval)<BR
  53992. ></BR
  53993. ><P
  53994. >      <DIV
  53995. CLASS="warning"
  53996. ><P
  53997. ></P
  53998. ><TABLE
  53999. CLASS="warning"
  54000. BORDER="1"
  54001. WIDTH="100%"
  54002. ><TR
  54003. ><TD
  54004. ALIGN="CENTER"
  54005. ><B
  54006. >Varovßnφ</B
  54007. ></TD
  54008. ></TR
  54009. ><TR
  54010. ><TD
  54011. ALIGN="LEFT"
  54012. ><P
  54013. >Tato funkce je╣t∞ nenφ
  54014. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54015. ></TD
  54016. ></TR
  54017. ></TABLE
  54018. ></DIV
  54019. >
  54020.     </P
  54021. ></DIV
  54022. ><H1
  54023. ><A
  54024. NAME="function.ccvs-auth"
  54025. ></A
  54026. >ccvs_auth</H1
  54027. ><DIV
  54028. CLASS="refnamediv"
  54029. ><A
  54030. NAME="AEN10660"
  54031. ></A
  54032. ><P
  54033. >    (4.0.2 - 4.2.3 only)</P
  54034. >ccvs_auth --  
  54035.      Perform credit authorization test on a transaction 
  54036.     </DIV
  54037. ><DIV
  54038. CLASS="refsect1"
  54039. ><A
  54040. NAME="AEN10663"
  54041. ></A
  54042. ><H2
  54043. >Description</H2
  54044. >string <B
  54045. CLASS="methodname"
  54046. >ccvs_auth</B
  54047. > ( string session, string invoice)<BR
  54048. ></BR
  54049. ><P
  54050. >      <DIV
  54051. CLASS="warning"
  54052. ><P
  54053. ></P
  54054. ><TABLE
  54055. CLASS="warning"
  54056. BORDER="1"
  54057. WIDTH="100%"
  54058. ><TR
  54059. ><TD
  54060. ALIGN="CENTER"
  54061. ><B
  54062. >Varovßnφ</B
  54063. ></TD
  54064. ></TR
  54065. ><TR
  54066. ><TD
  54067. ALIGN="LEFT"
  54068. ><P
  54069. >Tato funkce je╣t∞ nenφ
  54070. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54071. ></TD
  54072. ></TR
  54073. ></TABLE
  54074. ></DIV
  54075. >
  54076.     </P
  54077. ></DIV
  54078. ><H1
  54079. ><A
  54080. NAME="function.ccvs-command"
  54081. ></A
  54082. >ccvs_command</H1
  54083. ><DIV
  54084. CLASS="refnamediv"
  54085. ><A
  54086. NAME="AEN10678"
  54087. ></A
  54088. ><P
  54089. >    (4.0.2 - 4.2.3 only)</P
  54090. >ccvs_command -- 
  54091.      Performs a command which is peculiar to a single protocol, 
  54092.      and thus is not available in the general CCVS API 
  54093.     </DIV
  54094. ><DIV
  54095. CLASS="refsect1"
  54096. ><A
  54097. NAME="AEN10681"
  54098. ></A
  54099. ><H2
  54100. >Description</H2
  54101. >string <B
  54102. CLASS="methodname"
  54103. >ccvs_command</B
  54104. > ( string session, string type, string argval)<BR
  54105. ></BR
  54106. ><P
  54107. >      <DIV
  54108. CLASS="warning"
  54109. ><P
  54110. ></P
  54111. ><TABLE
  54112. CLASS="warning"
  54113. BORDER="1"
  54114. WIDTH="100%"
  54115. ><TR
  54116. ><TD
  54117. ALIGN="CENTER"
  54118. ><B
  54119. >Varovßnφ</B
  54120. ></TD
  54121. ></TR
  54122. ><TR
  54123. ><TD
  54124. ALIGN="LEFT"
  54125. ><P
  54126. >Tato funkce je╣t∞ nenφ
  54127. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54128. ></TD
  54129. ></TR
  54130. ></TABLE
  54131. ></DIV
  54132. >
  54133.     </P
  54134. ></DIV
  54135. ><H1
  54136. ><A
  54137. NAME="function.ccvs-count"
  54138. ></A
  54139. >ccvs_count</H1
  54140. ><DIV
  54141. CLASS="refnamediv"
  54142. ><A
  54143. NAME="AEN10699"
  54144. ></A
  54145. ><P
  54146. >    (4.0.2 - 4.2.3 only)</P
  54147. >ccvs_count -- 
  54148.      Find out how many transactions of a given type are stored in the system 
  54149.     </DIV
  54150. ><DIV
  54151. CLASS="refsect1"
  54152. ><A
  54153. NAME="AEN10702"
  54154. ></A
  54155. ><H2
  54156. >Description</H2
  54157. >int <B
  54158. CLASS="methodname"
  54159. >ccvs_count</B
  54160. > ( string session, string type)<BR
  54161. ></BR
  54162. ><P
  54163. >      <DIV
  54164. CLASS="warning"
  54165. ><P
  54166. ></P
  54167. ><TABLE
  54168. CLASS="warning"
  54169. BORDER="1"
  54170. WIDTH="100%"
  54171. ><TR
  54172. ><TD
  54173. ALIGN="CENTER"
  54174. ><B
  54175. >Varovßnφ</B
  54176. ></TD
  54177. ></TR
  54178. ><TR
  54179. ><TD
  54180. ALIGN="LEFT"
  54181. ><P
  54182. >Tato funkce je╣t∞ nenφ
  54183. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54184. ></TD
  54185. ></TR
  54186. ></TABLE
  54187. ></DIV
  54188. >
  54189.     </P
  54190. ></DIV
  54191. ><H1
  54192. ><A
  54193. NAME="function.ccvs-delete"
  54194. ></A
  54195. >ccvs_delete</H1
  54196. ><DIV
  54197. CLASS="refnamediv"
  54198. ><A
  54199. NAME="AEN10717"
  54200. ></A
  54201. ><P
  54202. >    (4.0.2 - 4.2.3 only)</P
  54203. >ccvs_delete -- Delete a transaction</DIV
  54204. ><DIV
  54205. CLASS="refsect1"
  54206. ><A
  54207. NAME="AEN10720"
  54208. ></A
  54209. ><H2
  54210. >Description</H2
  54211. >string <B
  54212. CLASS="methodname"
  54213. >ccvs_delete</B
  54214. > ( string session, string invoice)<BR
  54215. ></BR
  54216. ><P
  54217. >      <DIV
  54218. CLASS="warning"
  54219. ><P
  54220. ></P
  54221. ><TABLE
  54222. CLASS="warning"
  54223. BORDER="1"
  54224. WIDTH="100%"
  54225. ><TR
  54226. ><TD
  54227. ALIGN="CENTER"
  54228. ><B
  54229. >Varovßnφ</B
  54230. ></TD
  54231. ></TR
  54232. ><TR
  54233. ><TD
  54234. ALIGN="LEFT"
  54235. ><P
  54236. >Tato funkce je╣t∞ nenφ
  54237. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54238. ></TD
  54239. ></TR
  54240. ></TABLE
  54241. ></DIV
  54242. >
  54243.     </P
  54244. ></DIV
  54245. ><H1
  54246. ><A
  54247. NAME="function.ccvs-done"
  54248. ></A
  54249. >ccvs_done</H1
  54250. ><DIV
  54251. CLASS="refnamediv"
  54252. ><A
  54253. NAME="AEN10735"
  54254. ></A
  54255. ><P
  54256. >    (4.0.2 - 4.2.3 only)</P
  54257. >ccvs_done -- Terminate CCVS engine and do cleanup work</DIV
  54258. ><DIV
  54259. CLASS="refsect1"
  54260. ><A
  54261. NAME="AEN10738"
  54262. ></A
  54263. ><H2
  54264. >Description</H2
  54265. >string <B
  54266. CLASS="methodname"
  54267. >ccvs_done</B
  54268. > ( string sess)<BR
  54269. ></BR
  54270. ><P
  54271. >      <DIV
  54272. CLASS="warning"
  54273. ><P
  54274. ></P
  54275. ><TABLE
  54276. CLASS="warning"
  54277. BORDER="1"
  54278. WIDTH="100%"
  54279. ><TR
  54280. ><TD
  54281. ALIGN="CENTER"
  54282. ><B
  54283. >Varovßnφ</B
  54284. ></TD
  54285. ></TR
  54286. ><TR
  54287. ><TD
  54288. ALIGN="LEFT"
  54289. ><P
  54290. >Tato funkce je╣t∞ nenφ
  54291. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54292. ></TD
  54293. ></TR
  54294. ></TABLE
  54295. ></DIV
  54296. >
  54297.     </P
  54298. ></DIV
  54299. ><H1
  54300. ><A
  54301. NAME="function.ccvs-init"
  54302. ></A
  54303. >ccvs_init</H1
  54304. ><DIV
  54305. CLASS="refnamediv"
  54306. ><A
  54307. NAME="AEN10750"
  54308. ></A
  54309. ><P
  54310. >    (4.0.2 - 4.2.3 only)</P
  54311. >ccvs_init -- Initialize CCVS for use</DIV
  54312. ><DIV
  54313. CLASS="refsect1"
  54314. ><A
  54315. NAME="AEN10753"
  54316. ></A
  54317. ><H2
  54318. >Description</H2
  54319. >string <B
  54320. CLASS="methodname"
  54321. >ccvs_init</B
  54322. > ( string name)<BR
  54323. ></BR
  54324. ><P
  54325. >      <DIV
  54326. CLASS="warning"
  54327. ><P
  54328. ></P
  54329. ><TABLE
  54330. CLASS="warning"
  54331. BORDER="1"
  54332. WIDTH="100%"
  54333. ><TR
  54334. ><TD
  54335. ALIGN="CENTER"
  54336. ><B
  54337. >Varovßnφ</B
  54338. ></TD
  54339. ></TR
  54340. ><TR
  54341. ><TD
  54342. ALIGN="LEFT"
  54343. ><P
  54344. >Tato funkce je╣t∞ nenφ
  54345. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54346. ></TD
  54347. ></TR
  54348. ></TABLE
  54349. ></DIV
  54350. >
  54351.     </P
  54352. ></DIV
  54353. ><H1
  54354. ><A
  54355. NAME="function.ccvs-lookup"
  54356. ></A
  54357. >ccvs_lookup</H1
  54358. ><DIV
  54359. CLASS="refnamediv"
  54360. ><A
  54361. NAME="AEN10765"
  54362. ></A
  54363. ><P
  54364. >    (4.0.2 - 4.2.3 only)</P
  54365. >ccvs_lookup -- 
  54366.      Look up an item of a particular type in the database #
  54367.     </DIV
  54368. ><DIV
  54369. CLASS="refsect1"
  54370. ><A
  54371. NAME="AEN10768"
  54372. ></A
  54373. ><H2
  54374. >Description</H2
  54375. >string <B
  54376. CLASS="methodname"
  54377. >ccvs_lookup</B
  54378. > ( string session, string invoice, int inum)<BR
  54379. ></BR
  54380. ><P
  54381. >      <DIV
  54382. CLASS="warning"
  54383. ><P
  54384. ></P
  54385. ><TABLE
  54386. CLASS="warning"
  54387. BORDER="1"
  54388. WIDTH="100%"
  54389. ><TR
  54390. ><TD
  54391. ALIGN="CENTER"
  54392. ><B
  54393. >Varovßnφ</B
  54394. ></TD
  54395. ></TR
  54396. ><TR
  54397. ><TD
  54398. ALIGN="LEFT"
  54399. ><P
  54400. >Tato funkce je╣t∞ nenφ
  54401. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54402. ></TD
  54403. ></TR
  54404. ></TABLE
  54405. ></DIV
  54406. >
  54407.     </P
  54408. ></DIV
  54409. ><H1
  54410. ><A
  54411. NAME="function.ccvs-new"
  54412. ></A
  54413. >ccvs_new</H1
  54414. ><DIV
  54415. CLASS="refnamediv"
  54416. ><A
  54417. NAME="AEN10786"
  54418. ></A
  54419. ><P
  54420. >    (4.0.2 - 4.2.3 only)</P
  54421. >ccvs_new -- Create a new, blank transaction </DIV
  54422. ><DIV
  54423. CLASS="refsect1"
  54424. ><A
  54425. NAME="AEN10789"
  54426. ></A
  54427. ><H2
  54428. >Description</H2
  54429. >string <B
  54430. CLASS="methodname"
  54431. >ccvs_new</B
  54432. > ( string session, string invoice)<BR
  54433. ></BR
  54434. ><P
  54435. >      <DIV
  54436. CLASS="warning"
  54437. ><P
  54438. ></P
  54439. ><TABLE
  54440. CLASS="warning"
  54441. BORDER="1"
  54442. WIDTH="100%"
  54443. ><TR
  54444. ><TD
  54445. ALIGN="CENTER"
  54446. ><B
  54447. >Varovßnφ</B
  54448. ></TD
  54449. ></TR
  54450. ><TR
  54451. ><TD
  54452. ALIGN="LEFT"
  54453. ><P
  54454. >Tato funkce je╣t∞ nenφ
  54455. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54456. ></TD
  54457. ></TR
  54458. ></TABLE
  54459. ></DIV
  54460. >
  54461.     </P
  54462. ></DIV
  54463. ><H1
  54464. ><A
  54465. NAME="function.ccvs-report"
  54466. ></A
  54467. >ccvs_report</H1
  54468. ><DIV
  54469. CLASS="refnamediv"
  54470. ><A
  54471. NAME="AEN10804"
  54472. ></A
  54473. ><P
  54474. >    (4.0.2 - 4.2.3 only)</P
  54475. >ccvs_report -- Return the status of the background communication process </DIV
  54476. ><DIV
  54477. CLASS="refsect1"
  54478. ><A
  54479. NAME="AEN10807"
  54480. ></A
  54481. ><H2
  54482. >Description</H2
  54483. >string <B
  54484. CLASS="methodname"
  54485. >ccvs_report</B
  54486. > ( string session, string type)<BR
  54487. ></BR
  54488. ><P
  54489. >      <DIV
  54490. CLASS="warning"
  54491. ><P
  54492. ></P
  54493. ><TABLE
  54494. CLASS="warning"
  54495. BORDER="1"
  54496. WIDTH="100%"
  54497. ><TR
  54498. ><TD
  54499. ALIGN="CENTER"
  54500. ><B
  54501. >Varovßnφ</B
  54502. ></TD
  54503. ></TR
  54504. ><TR
  54505. ><TD
  54506. ALIGN="LEFT"
  54507. ><P
  54508. >Tato funkce je╣t∞ nenφ
  54509. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54510. ></TD
  54511. ></TR
  54512. ></TABLE
  54513. ></DIV
  54514. >
  54515.     </P
  54516. ></DIV
  54517. ><H1
  54518. ><A
  54519. NAME="function.ccvs-return"
  54520. ></A
  54521. >ccvs_return</H1
  54522. ><DIV
  54523. CLASS="refnamediv"
  54524. ><A
  54525. NAME="AEN10822"
  54526. ></A
  54527. ><P
  54528. >    (4.0.2 - 4.2.3 only)</P
  54529. >ccvs_return -- 
  54530.      Transfer funds from the merchant to the credit card holder 
  54531.     </DIV
  54532. ><DIV
  54533. CLASS="refsect1"
  54534. ><A
  54535. NAME="AEN10825"
  54536. ></A
  54537. ><H2
  54538. >Description</H2
  54539. >string <B
  54540. CLASS="methodname"
  54541. >ccvs_return</B
  54542. > ( string session, string invoice)<BR
  54543. ></BR
  54544. ><P
  54545. >      <DIV
  54546. CLASS="warning"
  54547. ><P
  54548. ></P
  54549. ><TABLE
  54550. CLASS="warning"
  54551. BORDER="1"
  54552. WIDTH="100%"
  54553. ><TR
  54554. ><TD
  54555. ALIGN="CENTER"
  54556. ><B
  54557. >Varovßnφ</B
  54558. ></TD
  54559. ></TR
  54560. ><TR
  54561. ><TD
  54562. ALIGN="LEFT"
  54563. ><P
  54564. >Tato funkce je╣t∞ nenφ
  54565. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54566. ></TD
  54567. ></TR
  54568. ></TABLE
  54569. ></DIV
  54570. >
  54571.     </P
  54572. ></DIV
  54573. ><H1
  54574. ><A
  54575. NAME="function.ccvs-reverse"
  54576. ></A
  54577. >ccvs_reverse</H1
  54578. ><DIV
  54579. CLASS="refnamediv"
  54580. ><A
  54581. NAME="AEN10840"
  54582. ></A
  54583. ><P
  54584. >    (4.0.2 - 4.2.3 only)</P
  54585. >ccvs_reverse -- 
  54586.      Perform a full reversal on an already-processed authorization 
  54587.     </DIV
  54588. ><DIV
  54589. CLASS="refsect1"
  54590. ><A
  54591. NAME="AEN10843"
  54592. ></A
  54593. ><H2
  54594. >Description</H2
  54595. >string <B
  54596. CLASS="methodname"
  54597. >ccvs_reverse</B
  54598. > ( string session, string invoice)<BR
  54599. ></BR
  54600. ><P
  54601. >      <DIV
  54602. CLASS="warning"
  54603. ><P
  54604. ></P
  54605. ><TABLE
  54606. CLASS="warning"
  54607. BORDER="1"
  54608. WIDTH="100%"
  54609. ><TR
  54610. ><TD
  54611. ALIGN="CENTER"
  54612. ><B
  54613. >Varovßnφ</B
  54614. ></TD
  54615. ></TR
  54616. ><TR
  54617. ><TD
  54618. ALIGN="LEFT"
  54619. ><P
  54620. >Tato funkce je╣t∞ nenφ
  54621. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54622. ></TD
  54623. ></TR
  54624. ></TABLE
  54625. ></DIV
  54626. >
  54627.     </P
  54628. ></DIV
  54629. ><H1
  54630. ><A
  54631. NAME="function.ccvs-sale"
  54632. ></A
  54633. >ccvs_sale</H1
  54634. ><DIV
  54635. CLASS="refnamediv"
  54636. ><A
  54637. NAME="AEN10858"
  54638. ></A
  54639. ><P
  54640. >    (4.0.2 - 4.2.3 only)</P
  54641. >ccvs_sale -- 
  54642.      Transfer funds from the credit card holder to the merchant
  54643.     </DIV
  54644. ><DIV
  54645. CLASS="refsect1"
  54646. ><A
  54647. NAME="AEN10861"
  54648. ></A
  54649. ><H2
  54650. >Description</H2
  54651. >string <B
  54652. CLASS="methodname"
  54653. >ccvs_sale</B
  54654. > ( string session, string invoice)<BR
  54655. ></BR
  54656. ><P
  54657. >      <DIV
  54658. CLASS="warning"
  54659. ><P
  54660. ></P
  54661. ><TABLE
  54662. CLASS="warning"
  54663. BORDER="1"
  54664. WIDTH="100%"
  54665. ><TR
  54666. ><TD
  54667. ALIGN="CENTER"
  54668. ><B
  54669. >Varovßnφ</B
  54670. ></TD
  54671. ></TR
  54672. ><TR
  54673. ><TD
  54674. ALIGN="LEFT"
  54675. ><P
  54676. >Tato funkce je╣t∞ nenφ
  54677. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54678. ></TD
  54679. ></TR
  54680. ></TABLE
  54681. ></DIV
  54682. >
  54683.     </P
  54684. ></DIV
  54685. ><H1
  54686. ><A
  54687. NAME="function.ccvs-status"
  54688. ></A
  54689. >ccvs_status</H1
  54690. ><DIV
  54691. CLASS="refnamediv"
  54692. ><A
  54693. NAME="AEN10876"
  54694. ></A
  54695. ><P
  54696. >    (4.0.2 - 4.2.3 only)</P
  54697. >ccvs_status -- Check the status of an invoice</DIV
  54698. ><DIV
  54699. CLASS="refsect1"
  54700. ><A
  54701. NAME="AEN10879"
  54702. ></A
  54703. ><H2
  54704. >Description</H2
  54705. >string <B
  54706. CLASS="methodname"
  54707. >ccvs_status</B
  54708. > ( string session, string invoice)<BR
  54709. ></BR
  54710. ><P
  54711. >      <DIV
  54712. CLASS="warning"
  54713. ><P
  54714. ></P
  54715. ><TABLE
  54716. CLASS="warning"
  54717. BORDER="1"
  54718. WIDTH="100%"
  54719. ><TR
  54720. ><TD
  54721. ALIGN="CENTER"
  54722. ><B
  54723. >Varovßnφ</B
  54724. ></TD
  54725. ></TR
  54726. ><TR
  54727. ><TD
  54728. ALIGN="LEFT"
  54729. ><P
  54730. >Tato funkce je╣t∞ nenφ
  54731. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54732. ></TD
  54733. ></TR
  54734. ></TABLE
  54735. ></DIV
  54736. >
  54737.     </P
  54738. ></DIV
  54739. ><H1
  54740. ><A
  54741. NAME="function.ccvs-textvalue"
  54742. ></A
  54743. >ccvs_textvalue</H1
  54744. ><DIV
  54745. CLASS="refnamediv"
  54746. ><A
  54747. NAME="AEN10894"
  54748. ></A
  54749. ><P
  54750. >    (4.0.2 - 4.2.3 only)</P
  54751. >ccvs_textvalue -- Get text return value for previous function call</DIV
  54752. ><DIV
  54753. CLASS="refsect1"
  54754. ><A
  54755. NAME="AEN10897"
  54756. ></A
  54757. ><H2
  54758. >Description</H2
  54759. >string <B
  54760. CLASS="methodname"
  54761. >ccvs_textvalue</B
  54762. > ( string session)<BR
  54763. ></BR
  54764. ><P
  54765. >      <DIV
  54766. CLASS="warning"
  54767. ><P
  54768. ></P
  54769. ><TABLE
  54770. CLASS="warning"
  54771. BORDER="1"
  54772. WIDTH="100%"
  54773. ><TR
  54774. ><TD
  54775. ALIGN="CENTER"
  54776. ><B
  54777. >Varovßnφ</B
  54778. ></TD
  54779. ></TR
  54780. ><TR
  54781. ><TD
  54782. ALIGN="LEFT"
  54783. ><P
  54784. >Tato funkce je╣t∞ nenφ
  54785. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54786. ></TD
  54787. ></TR
  54788. ></TABLE
  54789. ></DIV
  54790. >
  54791.     </P
  54792. ></DIV
  54793. ><H1
  54794. ><A
  54795. NAME="function.ccvs-void"
  54796. ></A
  54797. >ccvs_void</H1
  54798. ><DIV
  54799. CLASS="refnamediv"
  54800. ><A
  54801. NAME="AEN10909"
  54802. ></A
  54803. ><P
  54804. >    (4.0.2 - 4.2.3 only)</P
  54805. >ccvs_void -- 
  54806.      Perform a full reversal on a completed transaction 
  54807.     </DIV
  54808. ><DIV
  54809. CLASS="refsect1"
  54810. ><A
  54811. NAME="AEN10912"
  54812. ></A
  54813. ><H2
  54814. >Description</H2
  54815. >string <B
  54816. CLASS="methodname"
  54817. >ccvs_void</B
  54818. > ( string session, string invoice)<BR
  54819. ></BR
  54820. ><P
  54821. >      <DIV
  54822. CLASS="warning"
  54823. ><P
  54824. ></P
  54825. ><TABLE
  54826. CLASS="warning"
  54827. BORDER="1"
  54828. WIDTH="100%"
  54829. ><TR
  54830. ><TD
  54831. ALIGN="CENTER"
  54832. ><B
  54833. >Varovßnφ</B
  54834. ></TD
  54835. ></TR
  54836. ><TR
  54837. ><TD
  54838. ALIGN="LEFT"
  54839. ><P
  54840. >Tato funkce je╣t∞ nenφ
  54841. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  54842. ></TD
  54843. ></TR
  54844. ></TABLE
  54845. ></DIV
  54846. >
  54847.     </P
  54848. ></DIV
  54849. ></DIV
  54850. ><DIV
  54851. CLASS="reference"
  54852. ><A
  54853. NAME="ref.com"
  54854. ></A
  54855. ><DIV
  54856. CLASS="TITLEPAGE"
  54857. ><H1
  54858. CLASS="title"
  54859. >VIII. Funkce na podporu COM ve Windows</H1
  54860. ><DIV
  54861. CLASS="PARTINTRO"
  54862. ><A
  54863. NAME="AEN10929"
  54864. ></A
  54865. ><DIV
  54866. CLASS="section"
  54867. ><H1
  54868. CLASS="section"
  54869. ><A
  54870. NAME="com.intro"
  54871. ></A
  54872. >┌vod</H1
  54873. ><P
  54874. >      COM je technologie, kterß umo╛≥uje znovupou╛φt k≤d napsan² v jakΘmkoliv
  54875.      jazyce za pou╛itφ standardnφho volßnφ a schovßnφm
  54876.      implementaΦnφch detail∙ - jako na kterΘm poΦφtaΦi je komponenta
  54877.      ulo╛ena a kter² spustiteln² soubor ji uchovßvß - za API. Lze si to p°edstavit jako roz╣φ°en²
  54878.      mechanismus vzdßlenΘho volßnφ procedur (RPC) se zßklady objekt∙. COM
  54879.      odd∞luje implementaci od rozhranφ.
  54880.     </P
  54881. ><P
  54882. >      COM podporuje verzovßnφ, odd∞lenφ implementace od
  54883.      rozhranφ a skrytφ implementaΦnφch detail∙ jako je umφst∞nφ spustitelnΘho souboru a
  54884.      jazyku, kter² byl pou╛it.
  54885.     </P
  54886. ></DIV
  54887. ><DIV
  54888. CLASS="section"
  54889. ><HR><H1
  54890. CLASS="section"
  54891. ><A
  54892. NAME="com.requirements"
  54893. ></A
  54894. >Po╛adavky</H1
  54895. ><P
  54896. >      Tyto funkce jsou dostupnΘ pouze ve Windows verzi PHP.
  54897.     </P
  54898. ></DIV
  54899. ><DIV
  54900. CLASS="section"
  54901. ><HR><H1
  54902. CLASS="section"
  54903. ><A
  54904. NAME="com.installation"
  54905. ></A
  54906. >Instalace</H1
  54907. ><P
  54908. >K pou╛φvßnφ t∞chto funkcφ nenφ t°eba ╛ßdnß
  54909. instalace, jsou souΦßstφ jßdra PHP.</P
  54910. ><P
  54911. >Verze <TT
  54912. CLASS="literal"
  54913. >PHP</TT
  54914. > pro Windows
  54915. mß vestav∞nou podporu pro toto roz╣φ°enφ. K pou╛itφ t∞chto funkcφ nenφ t°eba
  54916. naΦφtat ╛ßdnß dal╣φ roz╣φ°enφ.</P
  54917. ></DIV
  54918. ><DIV
  54919. CLASS="section"
  54920. ><HR><H1
  54921. CLASS="section"
  54922. ><A
  54923. NAME="com.configuration"
  54924. ></A
  54925. >Konfigurace b∞hu</H1
  54926. ><P
  54927. > Chovßnφ t∞chto funkcφ je ovlivn∞no nastavenφm parametr∙ v <TT
  54928. CLASS="filename"
  54929. >php.ini</TT
  54930. >.
  54931. </P
  54932. ><P
  54933. >  <DIV
  54934. CLASS="table"
  54935. ><A
  54936. NAME="AEN10947"
  54937. ></A
  54938. ><P
  54939. ><B
  54940. >Tabulka 1. Com configuration options</B
  54941. ></P
  54942. ><TABLE
  54943. BORDER="1"
  54944. CLASS="CALSTABLE"
  54945. ><THEAD
  54946. ><TR
  54947. ><TH
  54948. ALIGN="LEFT"
  54949. VALIGN="MIDDLE"
  54950. >Name</TH
  54951. ><TH
  54952. ALIGN="LEFT"
  54953. VALIGN="MIDDLE"
  54954. >Default</TH
  54955. ><TH
  54956. ALIGN="LEFT"
  54957. VALIGN="MIDDLE"
  54958. >Changeable</TH
  54959. ></TR
  54960. ></THEAD
  54961. ><TBODY
  54962. ><TR
  54963. ><TD
  54964. ALIGN="LEFT"
  54965. VALIGN="MIDDLE"
  54966. >com.allow_dcom</TD
  54967. ><TD
  54968. ALIGN="LEFT"
  54969. VALIGN="MIDDLE"
  54970. >"0"</TD
  54971. ><TD
  54972. ALIGN="LEFT"
  54973. VALIGN="MIDDLE"
  54974. >PHP_INI_SYSTEM</TD
  54975. ></TR
  54976. ><TR
  54977. ><TD
  54978. ALIGN="LEFT"
  54979. VALIGN="MIDDLE"
  54980. >com.autoregister_typelib</TD
  54981. ><TD
  54982. ALIGN="LEFT"
  54983. VALIGN="MIDDLE"
  54984. >"0"</TD
  54985. ><TD
  54986. ALIGN="LEFT"
  54987. VALIGN="MIDDLE"
  54988. >PHP_INI_SYSTEM</TD
  54989. ></TR
  54990. ><TR
  54991. ><TD
  54992. ALIGN="LEFT"
  54993. VALIGN="MIDDLE"
  54994. >com.autoregister_verbose</TD
  54995. ><TD
  54996. ALIGN="LEFT"
  54997. VALIGN="MIDDLE"
  54998. >"0"</TD
  54999. ><TD
  55000. ALIGN="LEFT"
  55001. VALIGN="MIDDLE"
  55002. >PHP_INI_SYSTEM</TD
  55003. ></TR
  55004. ><TR
  55005. ><TD
  55006. ALIGN="LEFT"
  55007. VALIGN="MIDDLE"
  55008. >com.autoregister_casesensitive</TD
  55009. ><TD
  55010. ALIGN="LEFT"
  55011. VALIGN="MIDDLE"
  55012. >"1"</TD
  55013. ><TD
  55014. ALIGN="LEFT"
  55015. VALIGN="MIDDLE"
  55016. >PHP_INI_SYSTEM</TD
  55017. ></TR
  55018. ><TR
  55019. ><TD
  55020. ALIGN="LEFT"
  55021. VALIGN="MIDDLE"
  55022. >com.typelib_file</TD
  55023. ><TD
  55024. ALIGN="LEFT"
  55025. VALIGN="MIDDLE"
  55026. >""</TD
  55027. ><TD
  55028. ALIGN="LEFT"
  55029. VALIGN="MIDDLE"
  55030. >PHP_INI_SYSTEM</TD
  55031. ></TR
  55032. ></TBODY
  55033. ></TABLE
  55034. ></DIV
  55035. >
  55036.  For further details and definition of the PHP_INI_* constants see
  55037.  <A
  55038. HREF="#function.ini-set"
  55039. ><B
  55040. CLASS="function"
  55041. >ini_set()</B
  55042. ></A
  55043. >.
  55044.  </P
  55045. ></DIV
  55046. ><DIV
  55047. CLASS="section"
  55048. ><HR><H1
  55049. CLASS="section"
  55050. ><A
  55051. NAME="com.constants"
  55052. ></A
  55053. >P°eddefinovanΘ konstanty</H1
  55054. ><P
  55055. > Tyto konstanty jsou definovßny tφmto roz╣φ°enφm a budou k dispozici pouze
  55056. tehdy, bylo-li roz╣φ°enφ zkompilovßno spoleΦn∞ s PHP nebo dynamicky zavedeno
  55057. za b∞hu.
  55058. </P
  55059. ><P
  55060. ></P
  55061. ><DIV
  55062. CLASS="variablelist"
  55063. ><DL
  55064. ><DT
  55065. ><TT
  55066. CLASS="constant"
  55067. ><B
  55068. >CLSCTX_INPROC_SERVER</B
  55069. ></TT
  55070. > 
  55071.     (<A
  55072. HREF="#language.types.integer"
  55073. ><B
  55074. CLASS="type"
  55075. >integer</B
  55076. ></A
  55077. >)</DT
  55078. ><DD
  55079. ><P
  55080. >      
  55081.     </P
  55082. ></DD
  55083. ><DT
  55084. ><TT
  55085. CLASS="constant"
  55086. ><B
  55087. >CLSCTX_INPROC_HANDLER</B
  55088. ></TT
  55089. > 
  55090.     (<A
  55091. HREF="#language.types.integer"
  55092. ><B
  55093. CLASS="type"
  55094. >integer</B
  55095. ></A
  55096. >)</DT
  55097. ><DD
  55098. ><P
  55099. >      
  55100.     </P
  55101. ></DD
  55102. ><DT
  55103. ><TT
  55104. CLASS="constant"
  55105. ><B
  55106. >CLSCTX_LOCAL_SERVER</B
  55107. ></TT
  55108. > 
  55109.     (<A
  55110. HREF="#language.types.integer"
  55111. ><B
  55112. CLASS="type"
  55113. >integer</B
  55114. ></A
  55115. >)</DT
  55116. ><DD
  55117. ><P
  55118. >      
  55119.     </P
  55120. ></DD
  55121. ><DT
  55122. ><TT
  55123. CLASS="constant"
  55124. ><B
  55125. >CLSCTX_REMOTE_SERVER</B
  55126. ></TT
  55127. > 
  55128.     (<A
  55129. HREF="#language.types.integer"
  55130. ><B
  55131. CLASS="type"
  55132. >integer</B
  55133. ></A
  55134. >)</DT
  55135. ><DD
  55136. ><P
  55137. >      
  55138.     </P
  55139. ></DD
  55140. ><DT
  55141. ><TT
  55142. CLASS="constant"
  55143. ><B
  55144. >CLSCTX_SERVER</B
  55145. ></TT
  55146. > 
  55147.     (<A
  55148. HREF="#language.types.integer"
  55149. ><B
  55150. CLASS="type"
  55151. >integer</B
  55152. ></A
  55153. >)</DT
  55154. ><DD
  55155. ><P
  55156. >      
  55157.     </P
  55158. ></DD
  55159. ><DT
  55160. ><TT
  55161. CLASS="constant"
  55162. ><B
  55163. >CLSCTX_ALL</B
  55164. ></TT
  55165. > 
  55166.     (<A
  55167. HREF="#language.types.integer"
  55168. ><B
  55169. CLASS="type"
  55170. >integer</B
  55171. ></A
  55172. >)</DT
  55173. ><DD
  55174. ><P
  55175. >      
  55176.     </P
  55177. ></DD
  55178. ><DT
  55179. ><TT
  55180. CLASS="constant"
  55181. ><B
  55182. >VT_NULL</B
  55183. ></TT
  55184. > 
  55185.     (<A
  55186. HREF="#language.types.integer"
  55187. ><B
  55188. CLASS="type"
  55189. >integer</B
  55190. ></A
  55191. >)</DT
  55192. ><DD
  55193. ><P
  55194. >      
  55195.     </P
  55196. ></DD
  55197. ><DT
  55198. ><TT
  55199. CLASS="constant"
  55200. ><B
  55201. >VT_EMPTY</B
  55202. ></TT
  55203. > 
  55204.     (<A
  55205. HREF="#language.types.integer"
  55206. ><B
  55207. CLASS="type"
  55208. >integer</B
  55209. ></A
  55210. >)</DT
  55211. ><DD
  55212. ><P
  55213. >      
  55214.     </P
  55215. ></DD
  55216. ><DT
  55217. ><TT
  55218. CLASS="constant"
  55219. ><B
  55220. >VT_UI1</B
  55221. ></TT
  55222. > 
  55223.     (<A
  55224. HREF="#language.types.integer"
  55225. ><B
  55226. CLASS="type"
  55227. >integer</B
  55228. ></A
  55229. >)</DT
  55230. ><DD
  55231. ><P
  55232. >      
  55233.     </P
  55234. ></DD
  55235. ><DT
  55236. ><TT
  55237. CLASS="constant"
  55238. ><B
  55239. >VT_I2</B
  55240. ></TT
  55241. > 
  55242.     (<A
  55243. HREF="#language.types.integer"
  55244. ><B
  55245. CLASS="type"
  55246. >integer</B
  55247. ></A
  55248. >)</DT
  55249. ><DD
  55250. ><P
  55251. >      
  55252.     </P
  55253. ></DD
  55254. ><DT
  55255. ><TT
  55256. CLASS="constant"
  55257. ><B
  55258. >VT_I4</B
  55259. ></TT
  55260. > 
  55261.     (<A
  55262. HREF="#language.types.integer"
  55263. ><B
  55264. CLASS="type"
  55265. >integer</B
  55266. ></A
  55267. >)</DT
  55268. ><DD
  55269. ><P
  55270. >      
  55271.     </P
  55272. ></DD
  55273. ><DT
  55274. ><TT
  55275. CLASS="constant"
  55276. ><B
  55277. >VT_R4</B
  55278. ></TT
  55279. > 
  55280.     (<A
  55281. HREF="#language.types.integer"
  55282. ><B
  55283. CLASS="type"
  55284. >integer</B
  55285. ></A
  55286. >)</DT
  55287. ><DD
  55288. ><P
  55289. >      
  55290.     </P
  55291. ></DD
  55292. ><DT
  55293. ><TT
  55294. CLASS="constant"
  55295. ><B
  55296. >VT_R8</B
  55297. ></TT
  55298. > 
  55299.     (<A
  55300. HREF="#language.types.integer"
  55301. ><B
  55302. CLASS="type"
  55303. >integer</B
  55304. ></A
  55305. >)</DT
  55306. ><DD
  55307. ><P
  55308. >      
  55309.     </P
  55310. ></DD
  55311. ><DT
  55312. ><TT
  55313. CLASS="constant"
  55314. ><B
  55315. >VT_BOOL</B
  55316. ></TT
  55317. > 
  55318.     (<A
  55319. HREF="#language.types.integer"
  55320. ><B
  55321. CLASS="type"
  55322. >integer</B
  55323. ></A
  55324. >)</DT
  55325. ><DD
  55326. ><P
  55327. >      
  55328.     </P
  55329. ></DD
  55330. ><DT
  55331. ><TT
  55332. CLASS="constant"
  55333. ><B
  55334. >VT_ERROR</B
  55335. ></TT
  55336. > 
  55337.     (<A
  55338. HREF="#language.types.integer"
  55339. ><B
  55340. CLASS="type"
  55341. >integer</B
  55342. ></A
  55343. >)</DT
  55344. ><DD
  55345. ><P
  55346. >      
  55347.     </P
  55348. ></DD
  55349. ><DT
  55350. ><TT
  55351. CLASS="constant"
  55352. ><B
  55353. >VT_CY</B
  55354. ></TT
  55355. > 
  55356.     (<A
  55357. HREF="#language.types.integer"
  55358. ><B
  55359. CLASS="type"
  55360. >integer</B
  55361. ></A
  55362. >)</DT
  55363. ><DD
  55364. ><P
  55365. >      
  55366.     </P
  55367. ></DD
  55368. ><DT
  55369. ><TT
  55370. CLASS="constant"
  55371. ><B
  55372. >VT_DATE</B
  55373. ></TT
  55374. > 
  55375.     (<A
  55376. HREF="#language.types.integer"
  55377. ><B
  55378. CLASS="type"
  55379. >integer</B
  55380. ></A
  55381. >)</DT
  55382. ><DD
  55383. ><P
  55384. >      
  55385.     </P
  55386. ></DD
  55387. ><DT
  55388. ><TT
  55389. CLASS="constant"
  55390. ><B
  55391. >VT_BSTR</B
  55392. ></TT
  55393. > 
  55394.     (<A
  55395. HREF="#language.types.integer"
  55396. ><B
  55397. CLASS="type"
  55398. >integer</B
  55399. ></A
  55400. >)</DT
  55401. ><DD
  55402. ><P
  55403. >      
  55404.     </P
  55405. ></DD
  55406. ><DT
  55407. ><TT
  55408. CLASS="constant"
  55409. ><B
  55410. >VT_DECIMAL</B
  55411. ></TT
  55412. > 
  55413.     (<A
  55414. HREF="#language.types.integer"
  55415. ><B
  55416. CLASS="type"
  55417. >integer</B
  55418. ></A
  55419. >)</DT
  55420. ><DD
  55421. ><P
  55422. >      
  55423.     </P
  55424. ></DD
  55425. ><DT
  55426. ><TT
  55427. CLASS="constant"
  55428. ><B
  55429. >VT_UNKNOWN</B
  55430. ></TT
  55431. > 
  55432.     (<A
  55433. HREF="#language.types.integer"
  55434. ><B
  55435. CLASS="type"
  55436. >integer</B
  55437. ></A
  55438. >)</DT
  55439. ><DD
  55440. ><P
  55441. >      
  55442.     </P
  55443. ></DD
  55444. ><DT
  55445. ><TT
  55446. CLASS="constant"
  55447. ><B
  55448. >VT_DISPATCH</B
  55449. ></TT
  55450. > 
  55451.     (<A
  55452. HREF="#language.types.integer"
  55453. ><B
  55454. CLASS="type"
  55455. >integer</B
  55456. ></A
  55457. >)</DT
  55458. ><DD
  55459. ><P
  55460. >      
  55461.     </P
  55462. ></DD
  55463. ><DT
  55464. ><TT
  55465. CLASS="constant"
  55466. ><B
  55467. >VT_VARIANT</B
  55468. ></TT
  55469. > 
  55470.     (<A
  55471. HREF="#language.types.integer"
  55472. ><B
  55473. CLASS="type"
  55474. >integer</B
  55475. ></A
  55476. >)</DT
  55477. ><DD
  55478. ><P
  55479. >      
  55480.     </P
  55481. ></DD
  55482. ><DT
  55483. ><TT
  55484. CLASS="constant"
  55485. ><B
  55486. >VT_I1</B
  55487. ></TT
  55488. > 
  55489.     (<A
  55490. HREF="#language.types.integer"
  55491. ><B
  55492. CLASS="type"
  55493. >integer</B
  55494. ></A
  55495. >)</DT
  55496. ><DD
  55497. ><P
  55498. >      
  55499.     </P
  55500. ></DD
  55501. ><DT
  55502. ><TT
  55503. CLASS="constant"
  55504. ><B
  55505. >VT_UI2</B
  55506. ></TT
  55507. > 
  55508.     (<A
  55509. HREF="#language.types.integer"
  55510. ><B
  55511. CLASS="type"
  55512. >integer</B
  55513. ></A
  55514. >)</DT
  55515. ><DD
  55516. ><P
  55517. >      
  55518.     </P
  55519. ></DD
  55520. ><DT
  55521. ><TT
  55522. CLASS="constant"
  55523. ><B
  55524. >VT_UI4</B
  55525. ></TT
  55526. > 
  55527.     (<A
  55528. HREF="#language.types.integer"
  55529. ><B
  55530. CLASS="type"
  55531. >integer</B
  55532. ></A
  55533. >)</DT
  55534. ><DD
  55535. ><P
  55536. >      
  55537.     </P
  55538. ></DD
  55539. ><DT
  55540. ><TT
  55541. CLASS="constant"
  55542. ><B
  55543. >VT_INT</B
  55544. ></TT
  55545. > 
  55546.     (<A
  55547. HREF="#language.types.integer"
  55548. ><B
  55549. CLASS="type"
  55550. >integer</B
  55551. ></A
  55552. >)</DT
  55553. ><DD
  55554. ><P
  55555. >      
  55556.     </P
  55557. ></DD
  55558. ><DT
  55559. ><TT
  55560. CLASS="constant"
  55561. ><B
  55562. >VT_UINT</B
  55563. ></TT
  55564. > 
  55565.     (<A
  55566. HREF="#language.types.integer"
  55567. ><B
  55568. CLASS="type"
  55569. >integer</B
  55570. ></A
  55571. >)</DT
  55572. ><DD
  55573. ><P
  55574. >      
  55575.     </P
  55576. ></DD
  55577. ><DT
  55578. ><TT
  55579. CLASS="constant"
  55580. ><B
  55581. >VT_ARRAY</B
  55582. ></TT
  55583. > 
  55584.     (<A
  55585. HREF="#language.types.integer"
  55586. ><B
  55587. CLASS="type"
  55588. >integer</B
  55589. ></A
  55590. >)</DT
  55591. ><DD
  55592. ><P
  55593. >      
  55594.     </P
  55595. ></DD
  55596. ><DT
  55597. ><TT
  55598. CLASS="constant"
  55599. ><B
  55600. >VT_BYREF</B
  55601. ></TT
  55602. > 
  55603.     (<A
  55604. HREF="#language.types.integer"
  55605. ><B
  55606. CLASS="type"
  55607. >integer</B
  55608. ></A
  55609. >)</DT
  55610. ><DD
  55611. ><P
  55612. >      
  55613.     </P
  55614. ></DD
  55615. ><DT
  55616. ><TT
  55617. CLASS="constant"
  55618. ><B
  55619. >CP_ACP</B
  55620. ></TT
  55621. > 
  55622.     (<A
  55623. HREF="#language.types.integer"
  55624. ><B
  55625. CLASS="type"
  55626. >integer</B
  55627. ></A
  55628. >)</DT
  55629. ><DD
  55630. ><P
  55631. >      
  55632.     </P
  55633. ></DD
  55634. ><DT
  55635. ><TT
  55636. CLASS="constant"
  55637. ><B
  55638. >CP_MACCP</B
  55639. ></TT
  55640. > 
  55641.     (<A
  55642. HREF="#language.types.integer"
  55643. ><B
  55644. CLASS="type"
  55645. >integer</B
  55646. ></A
  55647. >)</DT
  55648. ><DD
  55649. ><P
  55650. >      
  55651.     </P
  55652. ></DD
  55653. ><DT
  55654. ><TT
  55655. CLASS="constant"
  55656. ><B
  55657. >CP_OEMCP</B
  55658. ></TT
  55659. > 
  55660.     (<A
  55661. HREF="#language.types.integer"
  55662. ><B
  55663. CLASS="type"
  55664. >integer</B
  55665. ></A
  55666. >)</DT
  55667. ><DD
  55668. ><P
  55669. >      
  55670.     </P
  55671. ></DD
  55672. ><DT
  55673. ><TT
  55674. CLASS="constant"
  55675. ><B
  55676. >CP_UTF7</B
  55677. ></TT
  55678. > 
  55679.     (<A
  55680. HREF="#language.types.integer"
  55681. ><B
  55682. CLASS="type"
  55683. >integer</B
  55684. ></A
  55685. >)</DT
  55686. ><DD
  55687. ><P
  55688. >      
  55689.     </P
  55690. ></DD
  55691. ><DT
  55692. ><TT
  55693. CLASS="constant"
  55694. ><B
  55695. >CP_UTF8</B
  55696. ></TT
  55697. > 
  55698.     (<A
  55699. HREF="#language.types.integer"
  55700. ><B
  55701. CLASS="type"
  55702. >integer</B
  55703. ></A
  55704. >)</DT
  55705. ><DD
  55706. ><P
  55707. >      
  55708.     </P
  55709. ></DD
  55710. ><DT
  55711. ><TT
  55712. CLASS="constant"
  55713. ><B
  55714. >CP_SYMBOL</B
  55715. ></TT
  55716. > 
  55717.     (<A
  55718. HREF="#language.types.integer"
  55719. ><B
  55720. CLASS="type"
  55721. >integer</B
  55722. ></A
  55723. >)</DT
  55724. ><DD
  55725. ><P
  55726. >      
  55727.     </P
  55728. ></DD
  55729. ><DT
  55730. ><TT
  55731. CLASS="constant"
  55732. ><B
  55733. >CP_THREAD_ACP</B
  55734. ></TT
  55735. > 
  55736.     (<A
  55737. HREF="#language.types.integer"
  55738. ><B
  55739. CLASS="type"
  55740. >integer</B
  55741. ></A
  55742. >)</DT
  55743. ><DD
  55744. ><P
  55745. >      
  55746.     </P
  55747. ></DD
  55748. ></DL
  55749. ></DIV
  55750. ></DIV
  55751. ><DIV
  55752. CLASS="section"
  55753. ><HR><H1
  55754. CLASS="section"
  55755. ><A
  55756. NAME="com.seealso"
  55757. ></A
  55758. >Viz takΘ</H1
  55759. ><P
  55760. >      Vφce informacφ o COM naleznete ve <A
  55761. HREF="http://www.microsoft.com/Com/resources/comdocs.asp"
  55762. TARGET="_top"
  55763. >specifikaci
  55764.      COM</A
  55765. > nebo se t°eba podφvejte na <A
  55766. HREF="http://www.develop.com/essentialcom/sources/YACL.htm"
  55767. TARGET="_top"
  55768. >Yet
  55769.      Another COM Library (YACL)</A
  55770. > Dona Boxe.
  55771.     </P
  55772. ></DIV
  55773. ></DIV
  55774. ><DIV
  55775. CLASS="TOC"
  55776. ><DL
  55777. ><DT
  55778. ><B
  55779. >Obsah</B
  55780. ></DT
  55781. ><DT
  55782. ><A
  55783. HREF="#class.com"
  55784. >COM</A
  55785. > -- COM class</DT
  55786. ><DT
  55787. ><A
  55788. HREF="#class.variant"
  55789. >VARIANT</A
  55790. > -- VARIANT class</DT
  55791. ><DT
  55792. ><A
  55793. HREF="#function.com-addref"
  55794. >com_addref</A
  55795. > -- 
  55796.     Increases the components reference counter.
  55797.    </DT
  55798. ><DT
  55799. ><A
  55800. HREF="#function.com-get"
  55801. >com_get</A
  55802. > -- 
  55803.      Zφskßvß hodnotu vlastnosti COM komponenty
  55804.     </DT
  55805. ><DT
  55806. ><A
  55807. HREF="#function.com-invoke"
  55808. >com_invoke</A
  55809. > -- 
  55810.      Volß metodu COM komponenty.
  55811.     </DT
  55812. ><DT
  55813. ><A
  55814. HREF="#function.com-isenum"
  55815. >com_isenum</A
  55816. > -- Grabs an IEnumVariant</DT
  55817. ><DT
  55818. ><A
  55819. HREF="#function.com-load-typelib"
  55820. >com_load_typelib</A
  55821. > -- Loads a Typelib</DT
  55822. ><DT
  55823. ><A
  55824. HREF="#function.com-load"
  55825. >com_load</A
  55826. > -- 
  55827.      Vytvo°φ nov² odkaz na COM komponentu
  55828.     </DT
  55829. ><DT
  55830. ><A
  55831. HREF="#function.com-propget"
  55832. >com_propget</A
  55833. > -- 
  55834.      Zφskßvß hodnotu vlastnosti COM komponenty
  55835.     </DT
  55836. ><DT
  55837. ><A
  55838. HREF="#function.com-propput"
  55839. >com_propput</A
  55840. > -- 
  55841.      P°i°azuje hodnotu vlastnosti COM komponenty.
  55842.     </DT
  55843. ><DT
  55844. ><A
  55845. HREF="#function.com-propset"
  55846. >com_propset</A
  55847. > -- 
  55848.      P°i°azuje hodnotu vlastnosti COM komponenty.
  55849.     </DT
  55850. ><DT
  55851. ><A
  55852. HREF="#function.com-release"
  55853. >com_release</A
  55854. > -- 
  55855.     Decreases the components reference counter.
  55856.    </DT
  55857. ><DT
  55858. ><A
  55859. HREF="#function.com-set"
  55860. >com_set</A
  55861. > -- 
  55862.      P°i°azuje hodnotu vlastnosti COM komponenty.
  55863.     </DT
  55864. ></DL
  55865. ></DIV
  55866. ></DIV
  55867. ><H1
  55868. ><A
  55869. NAME="class.com"
  55870. ></A
  55871. >COM</H1
  55872. ><DIV
  55873. CLASS="refnamediv"
  55874. ><A
  55875. NAME="AEN11203"
  55876. ></A
  55877. ><P
  55878. >    (no version information, might be only in CVS)</P
  55879. >COM -- COM class</DIV
  55880. ><DIV
  55881. CLASS="refsynopsisdiv"
  55882. ><A
  55883. NAME="AEN11206"
  55884. ></A
  55885. ><H2
  55886. >P°ehled</H2
  55887. ><TABLE
  55888. BORDER="0"
  55889. BGCOLOR="#E0E0E0"
  55890. CELLPADDING="5"
  55891. ><TR
  55892. ><TD
  55893. ><PRE
  55894. CLASS="synopsis"
  55895. >$obj = new COM("server.object")</PRE
  55896. ></TD
  55897. ></TR
  55898. ></TABLE
  55899. ></DIV
  55900. ><DIV
  55901. CLASS="refsect1"
  55902. ><A
  55903. NAME="class.com.class"
  55904. ></A
  55905. ><H2
  55906. >Description</H2
  55907. ><P
  55908. >     The COM class provides a framework to integrate (D)COM components into
  55909.     your PHP scripts.
  55910.    </P
  55911. ></DIV
  55912. ><DIV
  55913. CLASS="refsect1"
  55914. ><A
  55915. NAME="class.com.constructor"
  55916. ></A
  55917. ><H2
  55918. >Methods</H2
  55919. >string <B
  55920. CLASS="methodname"
  55921. >COM::COM</B
  55922. > ( string module_name [, string server_name [, int codepage]])<BR
  55923. ></BR
  55924. ><P
  55925. >     COM class constructor. Parameters:
  55926.     <P
  55927. ></P
  55928. ><DIV
  55929. CLASS="variablelist"
  55930. ><DL
  55931. ><DT
  55932. >module_name</DT
  55933. ><DD
  55934. ><P
  55935. >       name or class-id of the requested component.
  55936.      </P
  55937. ></DD
  55938. ><DT
  55939. >server_name</DT
  55940. ><DD
  55941. ><P
  55942. >       name of the DCOM server from which the component should be fetched.
  55943.       If <TT
  55944. CLASS="constant"
  55945. ><B
  55946. >NULL</B
  55947. ></TT
  55948. >, <TT
  55949. CLASS="literal"
  55950. >localhost</TT
  55951. > is assumed.
  55952.       To allow DCOM <TT
  55953. CLASS="constant"
  55954. ><B
  55955. >com.allow_dcom</B
  55956. ></TT
  55957. > has to be set to 
  55958.       <TT
  55959. CLASS="constant"
  55960. ><B
  55961. >TRUE</B
  55962. ></TT
  55963. > in <TT
  55964. CLASS="filename"
  55965. >php.ini</TT
  55966. >.
  55967.      </P
  55968. ></DD
  55969. ><DT
  55970. >codepage</DT
  55971. ><DD
  55972. ><P
  55973. >       specifies the codepage that is used to convert php-strings to
  55974.       unicode-strings and vice versa. Possible values are
  55975.       <TT
  55976. CLASS="constant"
  55977. ><B
  55978. >CP_ACP</B
  55979. ></TT
  55980. >, <TT
  55981. CLASS="constant"
  55982. ><B
  55983. >CP_MACCP</B
  55984. ></TT
  55985. >,
  55986.       <TT
  55987. CLASS="constant"
  55988. ><B
  55989. >CP_OEMCP</B
  55990. ></TT
  55991. >, <TT
  55992. CLASS="constant"
  55993. ><B
  55994. >CP_SYMBOL</B
  55995. ></TT
  55996. >,
  55997.       <TT
  55998. CLASS="constant"
  55999. ><B
  56000. >CP_THREAD_ACP</B
  56001. ></TT
  56002. >, <TT
  56003. CLASS="constant"
  56004. ><B
  56005. >CP_UTF7</B
  56006. ></TT
  56007. >
  56008.       and <TT
  56009. CLASS="constant"
  56010. ><B
  56011. >CP_UTF8</B
  56012. ></TT
  56013. >.
  56014.      </P
  56015. ></DD
  56016. ></DL
  56017. ></DIV
  56018. >
  56019.    </P
  56020. ><P
  56021. >     <TABLE
  56022. WIDTH="100%"
  56023. BORDER="0"
  56024. CELLPADDING="0"
  56025. CELLSPACING="0"
  56026. CLASS="EXAMPLE"
  56027. ><TR
  56028. ><TD
  56029. ><DIV
  56030. CLASS="example"
  56031. ><A
  56032. NAME="example.com1"
  56033. ></A
  56034. ><P
  56035. ><B
  56036. >P°φklad 1. COM example (1)</B
  56037. ></P
  56038. ><TABLE
  56039. BORDER="0"
  56040. BGCOLOR="#E0E0E0"
  56041. CELLPADDING="5"
  56042. ><TR
  56043. ><TD
  56044. ><PRE
  56045. CLASS="php"
  56046. ><?php
  56047. // starting word
  56048. $word = new COM("word.application") or die("Unable to instanciate Word");
  56049. echo "Loaded Word, version {$word->Version}\n";
  56050.  
  56051. //bring it to front
  56052. $word->Visible = 1;
  56053.  
  56054. //open an empty document
  56055. $word->Documents->Add();
  56056.  
  56057. //do some weird stuff
  56058. $word->Selection->TypeText("This is a test...");
  56059. $word->Documents[1]->SaveAs("Useless test.doc");
  56060.  
  56061. //closing word
  56062. $word->Quit();
  56063.  
  56064. //free the object
  56065. $word->Release();
  56066. $word = null;
  56067. ?></PRE
  56068. ></TD
  56069. ></TR
  56070. ></TABLE
  56071. ></DIV
  56072. ></TD
  56073. ></TR
  56074. ></TABLE
  56075. >
  56076.    </P
  56077. ><P
  56078. >     <TABLE
  56079. WIDTH="100%"
  56080. BORDER="0"
  56081. CELLPADDING="0"
  56082. CELLSPACING="0"
  56083. CLASS="EXAMPLE"
  56084. ><TR
  56085. ><TD
  56086. ><DIV
  56087. CLASS="example"
  56088. ><A
  56089. NAME="example.com2"
  56090. ></A
  56091. ><P
  56092. ><B
  56093. >P°φklad 2. COM example (2)</B
  56094. ></P
  56095. ><TABLE
  56096. BORDER="0"
  56097. BGCOLOR="#E0E0E0"
  56098. CELLPADDING="5"
  56099. ><TR
  56100. ><TD
  56101. ><PRE
  56102. CLASS="php"
  56103. ><?php
  56104.  
  56105. $conn = new COM("ADODB.Connection") or die("Cannot start ADO");
  56106. $conn->Open("Provider=SQLOLEDB; Data Source=localhost;
  56107. Initial Catalog=database; User ID=user; Password=password");
  56108.  
  56109. $rs = $conn->Execute("SELECT * FROM sometable");    // Recordset
  56110.  
  56111. $num_columns = $rs->Fields->Count();
  56112. echo $num_columns . "\n";
  56113.  
  56114. for ($i=0; $i < $num_columns; $i++) {
  56115.     $fld[$i] = $rs->Fields($i);
  56116. }
  56117.  
  56118. $rowcount = 0;
  56119. while (!$rs->EOF) {
  56120.     for ($i=0; $i < $num_columns; $i++) {
  56121.         echo $fld[$i]->value . "\t";
  56122.     }
  56123.     echo "\n";
  56124.     $rowcount++;            // increments rowcount
  56125.     $rs->MoveNext();
  56126. }
  56127.  
  56128. $rs->Close();
  56129. $conn->Close();
  56130.  
  56131. $rs->Release();
  56132. $conn->Release();
  56133.  
  56134. $rs = null;
  56135. $conn = null;
  56136.  
  56137. ?></PRE
  56138. ></TD
  56139. ></TR
  56140. ></TABLE
  56141. ></DIV
  56142. ></TD
  56143. ></TR
  56144. ></TABLE
  56145. >
  56146.    </P
  56147. ></DIV
  56148. ><H1
  56149. ><A
  56150. NAME="class.variant"
  56151. ></A
  56152. >VARIANT</H1
  56153. ><DIV
  56154. CLASS="refnamediv"
  56155. ><A
  56156. NAME="AEN11261"
  56157. ></A
  56158. ><P
  56159. >    (no version information, might be only in CVS)</P
  56160. >VARIANT -- VARIANT class</DIV
  56161. ><DIV
  56162. CLASS="refsynopsisdiv"
  56163. ><A
  56164. NAME="AEN11264"
  56165. ></A
  56166. ><H2
  56167. >P°ehled</H2
  56168. ><TABLE
  56169. BORDER="0"
  56170. BGCOLOR="#E0E0E0"
  56171. CELLPADDING="5"
  56172. ><TR
  56173. ><TD
  56174. ><PRE
  56175. CLASS="synopsis"
  56176. >$vVar = new VARIANT($var)</PRE
  56177. ></TD
  56178. ></TR
  56179. ></TABLE
  56180. ></DIV
  56181. ><DIV
  56182. CLASS="refsect1"
  56183. ><A
  56184. NAME="class.variant.class"
  56185. ></A
  56186. ><H2
  56187. >Description</H2
  56188. ><P
  56189. >     A simple container to wrap variables into VARIANT structures.
  56190.    </P
  56191. ></DIV
  56192. ><DIV
  56193. CLASS="refsect1"
  56194. ><A
  56195. NAME="class.variant.constructor"
  56196. ></A
  56197. ><H2
  56198. >Methods</H2
  56199. >string <B
  56200. CLASS="methodname"
  56201. >VARIANT::VARIANT</B
  56202. > ( [mixed value [, int type [, int codepage]]])<BR
  56203. ></BR
  56204. ><P
  56205. >     VARIANT class constructor. Parameters:
  56206.     <P
  56207. ></P
  56208. ><DIV
  56209. CLASS="variablelist"
  56210. ><DL
  56211. ><DT
  56212. >value</DT
  56213. ><DD
  56214. ><P
  56215. >       initial value. if omitted an VT_EMPTY object is created.
  56216.      </P
  56217. ></DD
  56218. ><DT
  56219. >type</DT
  56220. ><DD
  56221. ><P
  56222. >       specifies the content type of the VARIANT object. Possible values are
  56223.       <TT
  56224. CLASS="constant"
  56225. ><B
  56226. >VT_UI1</B
  56227. ></TT
  56228. >, <TT
  56229. CLASS="constant"
  56230. ><B
  56231. >VT_UI2</B
  56232. ></TT
  56233. >, <TT
  56234. CLASS="constant"
  56235. ><B
  56236. >VT_UI4</B
  56237. ></TT
  56238. >, 
  56239.       <TT
  56240. CLASS="constant"
  56241. ><B
  56242. >VT_I1</B
  56243. ></TT
  56244. >, <TT
  56245. CLASS="constant"
  56246. ><B
  56247. >VT_I2</B
  56248. ></TT
  56249. >, <TT
  56250. CLASS="constant"
  56251. ><B
  56252. >VT_I4</B
  56253. ></TT
  56254. >, 
  56255.       <TT
  56256. CLASS="constant"
  56257. ><B
  56258. >VT_R4</B
  56259. ></TT
  56260. >, <TT
  56261. CLASS="constant"
  56262. ><B
  56263. >VT_R8</B
  56264. ></TT
  56265. >, <TT
  56266. CLASS="constant"
  56267. ><B
  56268. >VT_INT</B
  56269. ></TT
  56270. >, <TT
  56271. CLASS="constant"
  56272. ><B
  56273. >VT_UINT</B
  56274. ></TT
  56275. >,
  56276.       <TT
  56277. CLASS="constant"
  56278. ><B
  56279. >VT_BOOL</B
  56280. ></TT
  56281. >, <TT
  56282. CLASS="constant"
  56283. ><B
  56284. >VT_ERROR</B
  56285. ></TT
  56286. >, <TT
  56287. CLASS="constant"
  56288. ><B
  56289. >VT_CY</B
  56290. ></TT
  56291. >, 
  56292.       <TT
  56293. CLASS="constant"
  56294. ><B
  56295. >VT_DATE</B
  56296. ></TT
  56297. >, <TT
  56298. CLASS="constant"
  56299. ><B
  56300. >VT_BSTR</B
  56301. ></TT
  56302. >, <TT
  56303. CLASS="constant"
  56304. ><B
  56305. >VT_DECIMAL</B
  56306. ></TT
  56307. >, 
  56308.       <TT
  56309. CLASS="constant"
  56310. ><B
  56311. >VT_UNKNOWN</B
  56312. ></TT
  56313. >, <TT
  56314. CLASS="constant"
  56315. ><B
  56316. >VT_DISPATCH</B
  56317. ></TT
  56318. > and <TT
  56319. CLASS="constant"
  56320. ><B
  56321. >VT_VARIANT</B
  56322. ></TT
  56323. >. These values are
  56324.       mutual exclusive, but they can be combined with <TT
  56325. CLASS="constant"
  56326. ><B
  56327. >VT_BYREF</B
  56328. ></TT
  56329. > to specify being a value. If omitted,
  56330.       the type of <TT
  56331. CLASS="parameter"
  56332. ><I
  56333. >value</I
  56334. ></TT
  56335. > is used. Consult the <SPAN
  56336. CLASS="acronym"
  56337. >MSDN</SPAN
  56338. > library for additional information.
  56339.      </P
  56340. ></DD
  56341. ><DT
  56342. >codepage</DT
  56343. ><DD
  56344. ><P
  56345. >       specifies the codepage that is used to convert php-strings to
  56346.       unicode-strings and vice versa. Possible values are
  56347.       <TT
  56348. CLASS="constant"
  56349. ><B
  56350. >CP_ACP</B
  56351. ></TT
  56352. >, <TT
  56353. CLASS="constant"
  56354. ><B
  56355. >CP_MACCP</B
  56356. ></TT
  56357. >,
  56358.       <TT
  56359. CLASS="constant"
  56360. ><B
  56361. >CP_OEMCP</B
  56362. ></TT
  56363. >, <TT
  56364. CLASS="constant"
  56365. ><B
  56366. >CP_SYMBOL</B
  56367. ></TT
  56368. >,
  56369.       <TT
  56370. CLASS="constant"
  56371. ><B
  56372. >CP_THREAD_ACP</B
  56373. ></TT
  56374. >, <TT
  56375. CLASS="constant"
  56376. ><B
  56377. >CP_UTF7</B
  56378. ></TT
  56379. >
  56380.       and <TT
  56381. CLASS="constant"
  56382. ><B
  56383. >CP_UTF8</B
  56384. ></TT
  56385. >.
  56386.      </P
  56387. ></DD
  56388. ></DL
  56389. ></DIV
  56390. >
  56391.    </P
  56392. ></DIV
  56393. ><H1
  56394. ><A
  56395. NAME="function.com-addref"
  56396. ></A
  56397. >com_addref</H1
  56398. ><DIV
  56399. CLASS="refnamediv"
  56400. ><A
  56401. NAME="AEN11328"
  56402. ></A
  56403. ><P
  56404. >    (4.1.0 - 4.3.2 only)</P
  56405. >com_addref -- 
  56406.     Increases the components reference counter.
  56407.    </DIV
  56408. ><DIV
  56409. CLASS="refsect1"
  56410. ><A
  56411. NAME="AEN11331"
  56412. ></A
  56413. ><H2
  56414. >Description</H2
  56415. >void <B
  56416. CLASS="methodname"
  56417. >com_addref</B
  56418. > ( void )<BR
  56419. ></BR
  56420. ><P
  56421. >     Increases the components reference counter.
  56422.    </P
  56423. ></DIV
  56424. ><H1
  56425. ><A
  56426. NAME="function.com-get"
  56427. ></A
  56428. >com_get</H1
  56429. ><DIV
  56430. CLASS="refnamediv"
  56431. ><A
  56432. NAME="AEN11339"
  56433. ></A
  56434. ><P
  56435. >    (PHP 3>= 3.0.3, 4.0.5 - 4.3.2 only)</P
  56436. >com_get -- 
  56437.      Zφskßvß hodnotu vlastnosti COM komponenty
  56438.     </DIV
  56439. ><DIV
  56440. CLASS="refsect1"
  56441. ><A
  56442. NAME="AEN11342"
  56443. ></A
  56444. ><H2
  56445. >Popis</H2
  56446. >mixed <B
  56447. CLASS="methodname"
  56448. >com_get</B
  56449. > ( resource com_object, string property)<BR
  56450. ></BR
  56451. ><P
  56452. >      Vracφ hodnotu <TT
  56453. CLASS="parameter"
  56454. ><I
  56455. >property</I
  56456. ></TT
  56457. > COM komponenty odkazovanΘ
  56458.      <TT
  56459. CLASS="parameter"
  56460. ><I
  56461. >com_object</I
  56462. ></TT
  56463. >. P°i chyb∞ vracφ <TT
  56464. CLASS="constant"
  56465. ><B
  56466. >FALSE</B
  56467. ></TT
  56468. >.
  56469.     </P
  56470. ></DIV
  56471. ><H1
  56472. ><A
  56473. NAME="function.com-invoke"
  56474. ></A
  56475. >com_invoke</H1
  56476. ><DIV
  56477. CLASS="refnamediv"
  56478. ><A
  56479. NAME="AEN11358"
  56480. ></A
  56481. ><P
  56482. >    (PHP 3>= 3.0.3)</P
  56483. >com_invoke -- 
  56484.      Volß metodu COM komponenty.
  56485.     </DIV
  56486. ><DIV
  56487. CLASS="refsect1"
  56488. ><A
  56489. NAME="AEN11361"
  56490. ></A
  56491. ><H2
  56492. >Popis</H2
  56493. >mixed <B
  56494. CLASS="methodname"
  56495. >com_invoke</B
  56496. > ( resource com_object, string function_name [, mixed parametry funkce, ...])<BR
  56497. ></BR
  56498. ><P
  56499. >      <B
  56500. CLASS="function"
  56501. >com_invoke()</B
  56502. > volß metodu COM komponenty odkazovanΘ
  56503.      <TT
  56504. CLASS="parameter"
  56505. ><I
  56506. >com_object</I
  56507. ></TT
  56508. >. Pokud dojde k chyb∞, vracφ
  56509.      <TT
  56510. CLASS="constant"
  56511. ><B
  56512. >FALSE</B
  56513. ></TT
  56514. >, p°i ·sp∞chu vracφ nßvratovou hodnotu metody
  56515.      <TT
  56516. CLASS="parameter"
  56517. ><I
  56518. >function_name</I
  56519. ></TT
  56520. >.
  56521.     </P
  56522. ></DIV
  56523. ><H1
  56524. ><A
  56525. NAME="function.com-isenum"
  56526. ></A
  56527. >com_isenum</H1
  56528. ><DIV
  56529. CLASS="refnamediv"
  56530. ><A
  56531. NAME="AEN11381"
  56532. ></A
  56533. ><P
  56534. >    (4.1.0 - 4.3.2 only)</P
  56535. >com_isenum -- Grabs an IEnumVariant</DIV
  56536. ><DIV
  56537. CLASS="refsect1"
  56538. ><A
  56539. NAME="AEN11384"
  56540. ></A
  56541. ><H2
  56542. >Description</H2
  56543. >void <B
  56544. CLASS="methodname"
  56545. >com_isenum</B
  56546. > ( object com_module)<BR
  56547. ></BR
  56548. ><P
  56549. >      <DIV
  56550. CLASS="warning"
  56551. ><P
  56552. ></P
  56553. ><TABLE
  56554. CLASS="warning"
  56555. BORDER="1"
  56556. WIDTH="100%"
  56557. ><TR
  56558. ><TD
  56559. ALIGN="CENTER"
  56560. ><B
  56561. >Varovßnφ</B
  56562. ></TD
  56563. ></TR
  56564. ><TR
  56565. ><TD
  56566. ALIGN="LEFT"
  56567. ><P
  56568. >Tato funkce je╣t∞ nenφ
  56569. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  56570. ></TD
  56571. ></TR
  56572. ></TABLE
  56573. ></DIV
  56574. >
  56575.     </P
  56576. ></DIV
  56577. ><H1
  56578. ><A
  56579. NAME="function.com-load-typelib"
  56580. ></A
  56581. >com_load_typelib</H1
  56582. ><DIV
  56583. CLASS="refnamediv"
  56584. ><A
  56585. NAME="AEN11396"
  56586. ></A
  56587. ><P
  56588. >    (4.1.0 - 4.3.2 only)</P
  56589. >com_load_typelib -- Loads a Typelib</DIV
  56590. ><DIV
  56591. CLASS="refsect1"
  56592. ><A
  56593. NAME="AEN11399"
  56594. ></A
  56595. ><H2
  56596. >Description</H2
  56597. >void <B
  56598. CLASS="methodname"
  56599. >com_load_typelib</B
  56600. > ( string typelib_name [, int case_insensitive])<BR
  56601. ></BR
  56602. ><P
  56603. >      <DIV
  56604. CLASS="warning"
  56605. ><P
  56606. ></P
  56607. ><TABLE
  56608. CLASS="warning"
  56609. BORDER="1"
  56610. WIDTH="100%"
  56611. ><TR
  56612. ><TD
  56613. ALIGN="CENTER"
  56614. ><B
  56615. >Varovßnφ</B
  56616. ></TD
  56617. ></TR
  56618. ><TR
  56619. ><TD
  56620. ALIGN="LEFT"
  56621. ><P
  56622. >Tato funkce je╣t∞ nenφ
  56623. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  56624. ></TD
  56625. ></TR
  56626. ></TABLE
  56627. ></DIV
  56628. >
  56629.     </P
  56630. ></DIV
  56631. ><H1
  56632. ><A
  56633. NAME="function.com-load"
  56634. ></A
  56635. >com_load</H1
  56636. ><DIV
  56637. CLASS="refnamediv"
  56638. ><A
  56639. NAME="AEN11414"
  56640. ></A
  56641. ><P
  56642. >    (PHP 3>= 3.0.3)</P
  56643. >com_load -- 
  56644.      Vytvo°φ nov² odkaz na COM komponentu
  56645.     </DIV
  56646. ><DIV
  56647. CLASS="refsect1"
  56648. ><A
  56649. NAME="AEN11417"
  56650. ></A
  56651. ><H2
  56652. >Popis</H2
  56653. >string <B
  56654. CLASS="methodname"
  56655. >com_load</B
  56656. > ( string module name [, string server name])<BR
  56657. ></BR
  56658. ><P
  56659. >      <B
  56660. CLASS="function"
  56661. >com_load()</B
  56662. > vytvß°φ novou COM komponentu a vracφ odkaz
  56663.      na ni. P°i ne·sp∞chu vracφ <TT
  56664. CLASS="constant"
  56665. ><B
  56666. >FALSE</B
  56667. ></TT
  56668. >.
  56669.     </P
  56670. ></DIV
  56671. ><H1
  56672. ><A
  56673. NAME="function.com-propget"
  56674. ></A
  56675. >com_propget</H1
  56676. ><DIV
  56677. CLASS="refnamediv"
  56678. ><A
  56679. NAME="AEN11432"
  56680. ></A
  56681. ><P
  56682. >    (PHP 3>= 3.0.3, 4.0.5 - 4.3.2 only)</P
  56683. >com_propget -- 
  56684.      Zφskßvß hodnotu vlastnosti COM komponenty
  56685.     </DIV
  56686. ><DIV
  56687. CLASS="refsect1"
  56688. ><A
  56689. NAME="AEN11435"
  56690. ></A
  56691. ><H2
  56692. >Popis</H2
  56693. >mixed <B
  56694. CLASS="methodname"
  56695. >com_propget</B
  56696. > ( resource com_object, string property)<BR
  56697. ></BR
  56698. ><P
  56699. >      Tato funkce je alias k <A
  56700. HREF="#function.com-get"
  56701. ><B
  56702. CLASS="function"
  56703. >com_get()</B
  56704. ></A
  56705. >.
  56706.     </P
  56707. ></DIV
  56708. ><H1
  56709. ><A
  56710. NAME="function.com-propput"
  56711. ></A
  56712. >com_propput</H1
  56713. ><DIV
  56714. CLASS="refnamediv"
  56715. ><A
  56716. NAME="AEN11449"
  56717. ></A
  56718. ><P
  56719. >    (PHP 3>= 3.0.3, 4.0.5 - 4.3.2 only)</P
  56720. >com_propput -- 
  56721.      P°i°azuje hodnotu vlastnosti COM komponenty.
  56722.     </DIV
  56723. ><DIV
  56724. CLASS="refsect1"
  56725. ><A
  56726. NAME="AEN11452"
  56727. ></A
  56728. ><H2
  56729. >Popis</H2
  56730. >void <B
  56731. CLASS="methodname"
  56732. >com_propput</B
  56733. > ( resource com_object, string property, mixed value)<BR
  56734. ></BR
  56735. ><P
  56736. >      Tato funkce je alias ke <A
  56737. HREF="#function.com-set"
  56738. ><B
  56739. CLASS="function"
  56740. >com_set()</B
  56741. ></A
  56742. >.
  56743.     </P
  56744. ></DIV
  56745. ><H1
  56746. ><A
  56747. NAME="function.com-propset"
  56748. ></A
  56749. >com_propset</H1
  56750. ><DIV
  56751. CLASS="refnamediv"
  56752. ><A
  56753. NAME="AEN11469"
  56754. ></A
  56755. ><P
  56756. >    (PHP 3>= 3.0.3, 4.0.5 - 4.3.2 only)</P
  56757. >com_propset -- 
  56758.      P°i°azuje hodnotu vlastnosti COM komponenty.
  56759.     </DIV
  56760. ><DIV
  56761. CLASS="refsect1"
  56762. ><A
  56763. NAME="AEN11472"
  56764. ></A
  56765. ><H2
  56766. >Popis</H2
  56767. >void <B
  56768. CLASS="methodname"
  56769. >com_propset</B
  56770. > ( resource com_object, string property, mixed value)<BR
  56771. ></BR
  56772. ><P
  56773. >      Tato funkce je alias ke <A
  56774. HREF="#function.com-set"
  56775. ><B
  56776. CLASS="function"
  56777. >com_set()</B
  56778. ></A
  56779. >.
  56780.     </P
  56781. ></DIV
  56782. ><H1
  56783. ><A
  56784. NAME="function.com-release"
  56785. ></A
  56786. >com_release</H1
  56787. ><DIV
  56788. CLASS="refnamediv"
  56789. ><A
  56790. NAME="AEN11489"
  56791. ></A
  56792. ><P
  56793. >    (4.1.0 - 4.3.2 only)</P
  56794. >com_release -- 
  56795.     Decreases the components reference counter.
  56796.    </DIV
  56797. ><DIV
  56798. CLASS="refsect1"
  56799. ><A
  56800. NAME="AEN11492"
  56801. ></A
  56802. ><H2
  56803. >Description</H2
  56804. >void <B
  56805. CLASS="methodname"
  56806. >com_release</B
  56807. > ( void )<BR
  56808. ></BR
  56809. ><P
  56810. >     Decreases the components reference counter.
  56811.    </P
  56812. ></DIV
  56813. ><H1
  56814. ><A
  56815. NAME="function.com-set"
  56816. ></A
  56817. >com_set</H1
  56818. ><DIV
  56819. CLASS="refnamediv"
  56820. ><A
  56821. NAME="AEN11500"
  56822. ></A
  56823. ><P
  56824. >    (PHP 3>= 3.0.3, 4.0.5 - 4.3.2 only)</P
  56825. >com_set -- 
  56826.      P°i°azuje hodnotu vlastnosti COM komponenty.
  56827.     </DIV
  56828. ><DIV
  56829. CLASS="refsect1"
  56830. ><A
  56831. NAME="AEN11503"
  56832. ></A
  56833. ><H2
  56834. >Popis</H2
  56835. >void <B
  56836. CLASS="methodname"
  56837. >com_set</B
  56838. > ( resource com_object, string property, mixed value)<BR
  56839. ></BR
  56840. ><P
  56841. >      Nastavuje hodnotu vlastnosti <TT
  56842. CLASS="parameter"
  56843. ><I
  56844. >property</I
  56845. ></TT
  56846. > COM
  56847.      komponent odkazovanΘ <TT
  56848. CLASS="parameter"
  56849. ><I
  56850. >com_object</I
  56851. ></TT
  56852. >.
  56853.      Vracφ <TT
  56854. CLASS="constant"
  56855. ><B
  56856. >TRUE</B
  56857. ></TT
  56858. >, pokud je <TT
  56859. CLASS="parameter"
  56860. ><I
  56861. >property</I
  56862. ></TT
  56863. >
  56864.      nastaveno. P°i chyb∞ vracφ <TT
  56865. CLASS="constant"
  56866. ><B
  56867. >FALSE</B
  56868. ></TT
  56869. >.
  56870.     </P
  56871. ></DIV
  56872. ></DIV
  56873. ><DIV
  56874. CLASS="reference"
  56875. ><A
  56876. NAME="ref.classobj"
  56877. ></A
  56878. ><DIV
  56879. CLASS="TITLEPAGE"
  56880. ><H1
  56881. CLASS="title"
  56882. >IX. Funkce pro prßci s t°φdami/objekty</H1
  56883. ><DIV
  56884. CLASS="PARTINTRO"
  56885. ><A
  56886. NAME="AEN11526"
  56887. ></A
  56888. ><DIV
  56889. CLASS="section"
  56890. ><H1
  56891. CLASS="section"
  56892. ><A
  56893. NAME="classobj.intro"
  56894. ></A
  56895. >┌vod</H1
  56896. ><P
  56897. >       Tyto funkce vßm umo╛≥ujφ zφskßvat informace o t°φdßch a instancφch. M∙╛ete
  56898.       zjistit nßzev t°φdy do kterΘ objekt pat°φ nebo jeho prom∞nnΘ a metody.
  56899.       Pomocφ t∞chto funkcφ m∙╛ete zjistit nejen p°φslu╣nost objektu k t°φd∞,
  56900.       ale i jeho p°edka (tj. kterou t°φdu t°φda tohoto objektu roz╣i°uje).
  56901.      </P
  56902. ></DIV
  56903. ><DIV
  56904. CLASS="section"
  56905. ><HR><H1
  56906. CLASS="section"
  56907. ><A
  56908. NAME="classobj.requirements"
  56909. ></A
  56910. >Po╛adavky</H1
  56911. ><P
  56912. >Tyto funkce jsou k dispozici jako souΦßst
  56913. standardnφho modulu, kter² je v╛dy dostupn².</P
  56914. ></DIV
  56915. ><DIV
  56916. CLASS="section"
  56917. ><HR><H1
  56918. CLASS="section"
  56919. ><A
  56920. NAME="classobj.installation"
  56921. ></A
  56922. >Instalace</H1
  56923. ><P
  56924. >K pou╛φvßnφ t∞chto funkcφ nenφ t°eba ╛ßdnß
  56925. instalace, jsou souΦßstφ jßdra PHP.</P
  56926. ></DIV
  56927. ><DIV
  56928. CLASS="section"
  56929. ><HR><H1
  56930. CLASS="section"
  56931. ><A
  56932. NAME="classobj.configuration"
  56933. ></A
  56934. >Konfigurace b∞hu</H1
  56935. ><P
  56936. >Toto roz╣φ°enφ nemß definovßno ╛ßdnΘ konfiguraΦnφ
  56937. direktivy.</P
  56938. ></DIV
  56939. ><DIV
  56940. CLASS="section"
  56941. ><HR><H1
  56942. CLASS="section"
  56943. ><A
  56944. NAME="classobj.resources"
  56945. ></A
  56946. >Typy prost°edk∙</H1
  56947. ><P
  56948. >Toto roz╣φ°enφ nemß definovßn ╛ßdn² typ prost°edku
  56949. (resource).</P
  56950. ></DIV
  56951. ><DIV
  56952. CLASS="section"
  56953. ><HR><H1
  56954. CLASS="section"
  56955. ><A
  56956. NAME="classobj.constants"
  56957. ></A
  56958. >P°eddefinovanΘ konstanty</H1
  56959. ><P
  56960. >Toto roz╣φ°enφ nemß definovßny ╛ßdnΘ
  56961. konstanty.</P
  56962. ></DIV
  56963. ><DIV
  56964. CLASS="section"
  56965. ><HR><H1
  56966. CLASS="section"
  56967. ><A
  56968. NAME="classobj.examples"
  56969. ></A
  56970. >P°φklady</H1
  56971. ><P
  56972. >       V tΘto ukßzce nejd°φve definujeme zßkladnφ t°φdu a roz╣φ°enφ tΘto t°φdy.
  56973.       Zßkladnφ t°φda popisuje obecnou zeleninu, a╗ u╛ je jedlß nebo ne a bez
  56974.       ohledu na jejφ barvu. Podt°φda <TT
  56975. CLASS="varname"
  56976. >Spenat</TT
  56977. > p°idßvß metodu
  56978.       na uva°enφ tΘto zeleniny a dal╣φ, kterß zjistφ, jestli je va°enß.
  56979.      </P
  56980. ><P
  56981. >       <TABLE
  56982. WIDTH="100%"
  56983. BORDER="0"
  56984. CELLPADDING="0"
  56985. CELLSPACING="0"
  56986. CLASS="EXAMPLE"
  56987. ><TR
  56988. ><TD
  56989. ><DIV
  56990. CLASS="example"
  56991. ><A
  56992. NAME="AEN11550"
  56993. ></A
  56994. ><P
  56995. ><B
  56996. >P°φklad 1. classes.inc</B
  56997. ></P
  56998. ><TABLE
  56999. BORDER="0"
  57000. BGCOLOR="#E0E0E0"
  57001. CELLPADDING="5"
  57002. ><TR
  57003. ><TD
  57004. ><PRE
  57005. CLASS="php"
  57006. ><?php
  57007.  
  57008. // zßkladnφ t°φda s Φlensk²mi prom∞nn²mi a metodami
  57009. class Zelenina {
  57010.  
  57011.     var $jedla;
  57012.     var $barva;
  57013.  
  57014.     function Zelenina( $jedla, $barva="green" ) {
  57015.         $this->jedla = $jedla;
  57016.         $this->barva = $barva;
  57017.     }
  57018.  
  57019.     function je_jedla() {
  57020.         return $this->jedla;
  57021.     }
  57022.  
  57023.     function jaka_barva() {
  57024.         return $this->barva;
  57025.     }
  57026.  
  57027. } // konec t°φdy Zelenina
  57028.  
  57029. // roz╣i°uje zßkladnφ t°φdu
  57030. class Spenat extends Zelenina {
  57031.  
  57032.     var $varena = false;
  57033.  
  57034.     function Spenat() {
  57035.         $this->Zelenina( true, "zelena" );
  57036.     }
  57037.  
  57038.     function cook_it() {
  57039.         $this->varena = true;
  57040.     }
  57041.  
  57042.     function je_varena() {
  57043.         return $this->varena;
  57044.     }
  57045.  
  57046. } // konec t°φdy Spenat
  57047.  
  57048. ?></PRE
  57049. ></TD
  57050. ></TR
  57051. ></TABLE
  57052. ></DIV
  57053. ></TD
  57054. ></TR
  57055. ></TABLE
  57056. >
  57057.      </P
  57058. ><P
  57059. >      Potom z t∞chto t°φd vytvo°φme 2 objekty a vytiskneme informace o nich, vΦ.
  57060.      rodiΦovsk²ch t°φd. TakΘ definujeme n∞kterΘ pomocnΘ funkce, p°edev╣φm kv∙li
  57061.      pohodlnΘmu tisku informacφ.
  57062.      </P
  57063. ><P
  57064. >       <TABLE
  57065. WIDTH="100%"
  57066. BORDER="0"
  57067. CELLPADDING="0"
  57068. CELLSPACING="0"
  57069. CLASS="EXAMPLE"
  57070. ><TR
  57071. ><TD
  57072. ><DIV
  57073. CLASS="example"
  57074. ><A
  57075. NAME="AEN11555"
  57076. ></A
  57077. ><P
  57078. ><B
  57079. >P°φklad 2. test_script.php</B
  57080. ></P
  57081. ><TABLE
  57082. BORDER="0"
  57083. BGCOLOR="#E0E0E0"
  57084. CELLPADDING="5"
  57085. ><TR
  57086. ><TD
  57087. ><PRE
  57088. CLASS="php"
  57089. ><pre>
  57090. <?php
  57091.  
  57092. include "classes.inc";
  57093.  
  57094. // pomocnΘ funkce
  57095.  
  57096. function vytiskni_promenne($obj) {
  57097.     $pole = get_object_vars($obj);
  57098.     while (list($vlastnost, $hodnota) = each($pole))
  57099.         echo "\t$vlastnost = $hodnota\n";
  57100. }
  57101.  
  57102. function vytiskni_metody($obj) {
  57103.     $pole = get_class_methods(get_class($obj));
  57104.     foreach ($pole as $metoda)
  57105.         echo "\tfunction $metoda()\n";
  57106. }
  57107.  
  57108. function class_parentage($obj, $class) {
  57109.     if (is_subclass_of($GLOBALS[$obj], $class)) {
  57110.         echo "Objekt $obj pat°φ do t°φdy ".get_class($$obj);
  57111.         echo ", kterß je podt°φdou $class\n";
  57112.     } else {
  57113.         echo "Objekt $obj nepat°φ do podt°φdy t°φdy $class\n";
  57114.     }
  57115. }
  57116.  
  57117. // instancujeme 2 objekty
  57118.  
  57119. $zeleninka = new Zelenina(true,"modrß");
  57120. $listnaty = new Spenat();
  57121.  
  57122. // vytisknout informace o obou objektech
  57123. echo "zeleninka: CLASS ".get_class($zeleninka)."\n";
  57124. echo "listnat²: CLASS ".get_class($listnaty);
  57125. echo ", PARENT ".get_parent_class($listnaty)."\n";
  57126.  
  57127. // vytisknout vlastnosti zeleninky
  57128. echo "\nzeleninka: Vlastnosti\n";
  57129. vytiskni_promenne($zeleninka);
  57130.  
  57131. // a metody objektu listnat²
  57132. echo "\nlistnat²: Metody\n";
  57133. vytiskni_metody($listnaty);
  57134.  
  57135. echo "\nRodiΦ:\n";
  57136. class_parentage("listnaty", "Spenat");
  57137. class_parentage("listnaty", "Zelenina");
  57138. ?>
  57139. </pre></PRE
  57140. ></TD
  57141. ></TR
  57142. ></TABLE
  57143. ><P
  57144. >         Je t°eba poznamenat, ╛e ve v²╣e uvedenΘ ukßzce je objekt
  57145.         <TT
  57146. CLASS="varname"
  57147. >$listnaty</TT
  57148. > instancφ t°φdy <B
  57149. CLASS="classname"
  57150. >Spenat</B
  57151. >,
  57152.         kterß je podt°φdou t°φdy <B
  57153. CLASS="classname"
  57154. >Zelenina</B
  57155. >, a poslednφ Φßst
  57156.         v²╣e uvedenΘho skriptu tudφ╛ vytiskne:
  57157.        </P
  57158. ><TABLE
  57159. BORDER="0"
  57160. BGCOLOR="#E0E0E0"
  57161. CELLPADDING="5"
  57162. ><TR
  57163. ><TD
  57164. ><PRE
  57165. CLASS="screen"
  57166. >[...]
  57167. RodiΦ:
  57168. Objekt listnaty nepat°φ do podt°φdy t°φdy Spenat
  57169. Object listnaty pat°φ do t°φdy Spenat, kterß je podt°φdou Zelenina</PRE
  57170. ></TD
  57171. ></TR
  57172. ></TABLE
  57173. ></DIV
  57174. ></TD
  57175. ></TR
  57176. ></TABLE
  57177. >
  57178.      </P
  57179. ></DIV
  57180. ></DIV
  57181. ><DIV
  57182. CLASS="TOC"
  57183. ><DL
  57184. ><DT
  57185. ><B
  57186. >Obsah</B
  57187. ></DT
  57188. ><DT
  57189. ><A
  57190. HREF="#function.call-user-method-array"
  57191. >call_user_method_array</A
  57192. > -- 
  57193.      Call a user method given with an array of parameters [deprecated]
  57194.     </DT
  57195. ><DT
  57196. ><A
  57197. HREF="#function.call-user-method"
  57198. >call_user_method</A
  57199. > -- 
  57200.      Zavolat u╛ivatelsky definouvanou metodu urΦitΘho objektu
  57201.     </DT
  57202. ><DT
  57203. ><A
  57204. HREF="#function.class-exists"
  57205. >class_exists</A
  57206. > -- Zjistit, jestli je t°φda definovßna</DT
  57207. ><DT
  57208. ><A
  57209. HREF="#function.get-class-methods"
  57210. >get_class_methods</A
  57211. > -- Vrßtit pole nßzv∙ metod t°φdy</DT
  57212. ><DT
  57213. ><A
  57214. HREF="#function.get-class-vars"
  57215. >get_class_vars</A
  57216. > -- Vrßtit pole defaultnφch vlastnostφ t°φdy</DT
  57217. ><DT
  57218. ><A
  57219. HREF="#function.get-class"
  57220. >get_class</A
  57221. > -- Vrßtit jmΘno t°φdy objektu</DT
  57222. ><DT
  57223. ><A
  57224. HREF="#function.get-declared-classes"
  57225. >get_declared_classes</A
  57226. > -- Vrßtit pole nßzv∙ definovan²ch t°φd</DT
  57227. ><DT
  57228. ><A
  57229. HREF="#function.get-object-vars"
  57230. >get_object_vars</A
  57231. > -- Vrßtit asociativnφ pole vlastnostφ objektu</DT
  57232. ><DT
  57233. ><A
  57234. HREF="#function.get-parent-class"
  57235. >get_parent_class</A
  57236. > -- Vrßtit nßzev rodiΦovskΘ t°φdy objektu</DT
  57237. ><DT
  57238. ><A
  57239. HREF="#function.is-a"
  57240. >is_a</A
  57241. > -- 
  57242.      Returns <TT
  57243. CLASS="constant"
  57244. ><B
  57245. >TRUE</B
  57246. ></TT
  57247. > if the object is of this class or has this class as 
  57248.      one of its parents
  57249.     </DT
  57250. ><DT
  57251. ><A
  57252. HREF="#function.is-subclass-of"
  57253. >is_subclass_of</A
  57254. > -- 
  57255.      Zjistit, jestli objekt pat°φ do podt°φdy urΦitΘ t°φdy
  57256.     </DT
  57257. ><DT
  57258. ><A
  57259. HREF="#function.method-exists"
  57260. >method_exists</A
  57261. > -- Zjistit, jestli mß t°φda urΦitou metodu</DT
  57262. ></DL
  57263. ></DIV
  57264. ></DIV
  57265. ><H1
  57266. ><A
  57267. NAME="function.call-user-method-array"
  57268. ></A
  57269. >call_user_method_array</H1
  57270. ><DIV
  57271. CLASS="refnamediv"
  57272. ><A
  57273. NAME="AEN11564"
  57274. ></A
  57275. ><P
  57276. >    (PHP 4 >= 4.0.5)</P
  57277. >call_user_method_array -- 
  57278.      Call a user method given with an array of parameters [deprecated]
  57279.     </DIV
  57280. ><DIV
  57281. CLASS="refsect1"
  57282. ><A
  57283. NAME="AEN11567"
  57284. ></A
  57285. ><H2
  57286. >Description</H2
  57287. >mixed <B
  57288. CLASS="methodname"
  57289. >call_user_method_array</B
  57290. > ( string method_name, object obj [, array paramarr])<BR
  57291. ></BR
  57292. ><DIV
  57293. CLASS="warning"
  57294. ><P
  57295. ></P
  57296. ><TABLE
  57297. CLASS="warning"
  57298. BORDER="1"
  57299. WIDTH="100%"
  57300. ><TR
  57301. ><TD
  57302. ALIGN="CENTER"
  57303. ><B
  57304. >Varovßnφ</B
  57305. ></TD
  57306. ></TR
  57307. ><TR
  57308. ><TD
  57309. ALIGN="LEFT"
  57310. ><P
  57311. >       The <B
  57312. CLASS="function"
  57313. >call_user_method_array()</B
  57314. > function is deprecated
  57315.       as of PHP 4.1.0, use the <A
  57316. HREF="#function.call-user-func-array"
  57317. ><B
  57318. CLASS="function"
  57319. >call_user_func_array()</B
  57320. ></A
  57321. > variety 
  57322.       with the <TT
  57323. CLASS="literal"
  57324. >array(&$obj, "method_name")</TT
  57325. > syntax instead.
  57326.      </P
  57327. ></TD
  57328. ></TR
  57329. ></TABLE
  57330. ></DIV
  57331. ><P
  57332. >      Calls the method referred by <TT
  57333. CLASS="parameter"
  57334. ><I
  57335. >method_name</I
  57336. ></TT
  57337. > from
  57338.      the user defined <TT
  57339. CLASS="parameter"
  57340. ><I
  57341. >obj</I
  57342. ></TT
  57343. > object, using the parameters
  57344.      in <TT
  57345. CLASS="parameter"
  57346. ><I
  57347. >paramarr</I
  57348. ></TT
  57349. >.
  57350.     </P
  57351. ><P
  57352. >      See also:
  57353.      <A
  57354. HREF="#function.call-user-func-array"
  57355. ><B
  57356. CLASS="function"
  57357. >call_user_func_array()</B
  57358. ></A
  57359. >, and
  57360.      <A
  57361. HREF="#function.call-user-func"
  57362. ><B
  57363. CLASS="function"
  57364. >call_user_func()</B
  57365. ></A
  57366. >.
  57367.     </P
  57368. ></DIV
  57369. ><H1
  57370. ><A
  57371. NAME="function.call-user-method"
  57372. ></A
  57373. >call_user_method</H1
  57374. ><DIV
  57375. CLASS="refnamediv"
  57376. ><A
  57377. NAME="AEN11594"
  57378. ></A
  57379. ><P
  57380. >    (PHP 3>= 3.0.3, PHP 4 )</P
  57381. >call_user_method -- 
  57382.      Zavolat u╛ivatelsky definouvanou metodu urΦitΘho objektu
  57383.     </DIV
  57384. ><DIV
  57385. CLASS="refsect1"
  57386. ><A
  57387. NAME="AEN11597"
  57388. ></A
  57389. ><H2
  57390. >Popis</H2
  57391. >mixed <B
  57392. CLASS="methodname"
  57393. >call_user_method</B
  57394. > ( string method_name, object obj [, mixed parameter [, mixed ...]])<BR
  57395. ></BR
  57396. ><P
  57397. >      Zavolß metodu <TT
  57398. CLASS="parameter"
  57399. ><I
  57400. >method_name</I
  57401. ></TT
  57402. > objektu
  57403.      <TT
  57404. CLASS="parameter"
  57405. ><I
  57406. >obj</I
  57407. ></TT
  57408. >. Ukßzka vyu╛itφ je nφ╛e, kde definujeme t°φdu,
  57409.      vytvo°φme objekt a pou╛ijeme <B
  57410. CLASS="function"
  57411. >call_user_method()</B
  57412. > k
  57413.      nep°φmΘmu volßnφ jejφ <TT
  57414. CLASS="varname"
  57415. >print_info</TT
  57416. > metody.
  57417.      <DIV
  57418. CLASS="informalexample"
  57419. ><A
  57420. NAME="AEN11619"
  57421. ></A
  57422. ><P
  57423. ></P
  57424. ><TABLE
  57425. BORDER="0"
  57426. BGCOLOR="#E0E0E0"
  57427. CELLPADDING="5"
  57428. ><TR
  57429. ><TD
  57430. ><PRE
  57431. CLASS="php"
  57432. ><?php
  57433. class Country {
  57434.     var $NAME;
  57435.     var $TLD;
  57436.  
  57437.     function Country($name, $tld) {
  57438.         $this->NAME = $name;
  57439.         $this->TLD = $tld;
  57440.     }
  57441.  
  57442.     function print_info($prestr="") {
  57443.         echo $prestr."Country: ".$this->NAME."\n";
  57444.         echo $prestr."Top Level Domain: ".$this->TLD."\n";
  57445.     }
  57446. }
  57447.  
  57448. $cntry = new Country("Peru","pe");
  57449.  
  57450. echo "* Calling the object method directly\n";
  57451. $cntry->print_info();
  57452.  
  57453. echo "\n* Calling the same method indirectly\n";
  57454. call_user_method ("print_info", $cntry, "\t");
  57455. ?></PRE
  57456. ></TD
  57457. ></TR
  57458. ></TABLE
  57459. ><P
  57460. ></P
  57461. ></DIV
  57462. >
  57463.     </P
  57464. ><P
  57465. >      Viz takΘ <A
  57466. HREF="#function.call-user-func"
  57467. ><B
  57468. CLASS="function"
  57469. >call_user_func()</B
  57470. ></A
  57471. >.
  57472.     </P
  57473. ></DIV
  57474. ><H1
  57475. ><A
  57476. NAME="function.class-exists"
  57477. ></A
  57478. >class_exists</H1
  57479. ><DIV
  57480. CLASS="refnamediv"
  57481. ><A
  57482. NAME="AEN11624"
  57483. ></A
  57484. ><P
  57485. >    (PHP 4 )</P
  57486. >class_exists -- Zjistit, jestli je t°φda definovßna</DIV
  57487. ><DIV
  57488. CLASS="refsect1"
  57489. ><A
  57490. NAME="AEN11627"
  57491. ></A
  57492. ><H2
  57493. >Popis</H2
  57494. >bool <B
  57495. CLASS="methodname"
  57496. >class_exists</B
  57497. > ( string class_name)<BR
  57498. ></BR
  57499. ><P
  57500. >      Tato funkce vrßtφ <TT
  57501. CLASS="constant"
  57502. ><B
  57503. >TRUE</B
  57504. ></TT
  57505. >, pokud je t°φda
  57506.      <TT
  57507. CLASS="parameter"
  57508. ><I
  57509. >class_name</I
  57510. ></TT
  57511. > definovßna, jinak <TT
  57512. CLASS="constant"
  57513. ><B
  57514. >FALSE</B
  57515. ></TT
  57516. >.
  57517.     </P
  57518. ></DIV
  57519. ><H1
  57520. ><A
  57521. NAME="function.get-class-methods"
  57522. ></A
  57523. >get_class_methods</H1
  57524. ><DIV
  57525. CLASS="refnamediv"
  57526. ><A
  57527. NAME="AEN11640"
  57528. ></A
  57529. ><P
  57530. >    (PHP 4 )</P
  57531. >get_class_methods -- Vrßtit pole nßzv∙ metod t°φdy</DIV
  57532. ><DIV
  57533. CLASS="refsect1"
  57534. ><A
  57535. NAME="AEN11643"
  57536. ></A
  57537. ><H2
  57538. >Popis</H2
  57539. >array <B
  57540. CLASS="methodname"
  57541. >get_class_methods</B
  57542. > ( string class_name)<BR
  57543. ></BR
  57544. ><P
  57545. >      Tato funkce vracφ pole nßzv∙ metod definovan²ch pro t°φdu specifikovanou
  57546.      argumentem <TT
  57547. CLASS="parameter"
  57548. ><I
  57549. >class_name</I
  57550. ></TT
  57551. >.
  57552.     </P
  57553. ><P
  57554. >      Viz takΘ <A
  57555. HREF="#function.get-class-vars"
  57556. ><B
  57557. CLASS="function"
  57558. >get_class_vars()</B
  57559. ></A
  57560. >,
  57561.      <A
  57562. HREF="#function.get-object-vars"
  57563. ><B
  57564. CLASS="function"
  57565. >get_object_vars()</B
  57566. ></A
  57567. >
  57568.     </P
  57569. ></DIV
  57570. ><H1
  57571. ><A
  57572. NAME="function.get-class-vars"
  57573. ></A
  57574. >get_class_vars</H1
  57575. ><DIV
  57576. CLASS="refnamediv"
  57577. ><A
  57578. NAME="AEN11657"
  57579. ></A
  57580. ><P
  57581. >    (PHP 4 )</P
  57582. >get_class_vars -- Vrßtit pole defaultnφch vlastnostφ t°φdy</DIV
  57583. ><DIV
  57584. CLASS="refsect1"
  57585. ><A
  57586. NAME="AEN11660"
  57587. ></A
  57588. ><H2
  57589. >Popis</H2
  57590. >array <B
  57591. CLASS="methodname"
  57592. >get_class_vars</B
  57593. > ( string class_name)<BR
  57594. ></BR
  57595. ><P
  57596. >      Tato funkce vracφ pole defaultnφch vlastnostφ t°φdy
  57597.      <TT
  57598. CLASS="parameter"
  57599. ><I
  57600. >class_name</I
  57601. ></TT
  57602. >.
  57603.     </P
  57604. ><P
  57605. >      Viz takΘ <A
  57606. HREF="#function.get-class-methods"
  57607. ><B
  57608. CLASS="function"
  57609. >get_class_methods()</B
  57610. ></A
  57611. >,
  57612.      <A
  57613. HREF="#function.get-object-vars"
  57614. ><B
  57615. CLASS="function"
  57616. >get_object_vars()</B
  57617. ></A
  57618. >
  57619.     </P
  57620. ></DIV
  57621. ><H1
  57622. ><A
  57623. NAME="function.get-class"
  57624. ></A
  57625. >get_class</H1
  57626. ><DIV
  57627. CLASS="refnamediv"
  57628. ><A
  57629. NAME="AEN11674"
  57630. ></A
  57631. ><P
  57632. >    (PHP 4 )</P
  57633. >get_class -- Vrßtit jmΘno t°φdy objektu</DIV
  57634. ><DIV
  57635. CLASS="refsect1"
  57636. ><A
  57637. NAME="AEN11677"
  57638. ></A
  57639. ><H2
  57640. >Popis</H2
  57641. >string <B
  57642. CLASS="methodname"
  57643. >get_class</B
  57644. > ( object obj)<BR
  57645. ></BR
  57646. ><P
  57647. >      Tato funkce vracφ nßzev t°φdy jφ╛ je objekt <TT
  57648. CLASS="parameter"
  57649. ><I
  57650. >obj</I
  57651. ></TT
  57652. >
  57653.      instancφ.
  57654.     </P
  57655. ><P
  57656. >      Viz takΘ <A
  57657. HREF="#function.get-parent-class"
  57658. ><B
  57659. CLASS="function"
  57660. >get_parent_class()</B
  57661. ></A
  57662. >,
  57663.      <A
  57664. HREF="#function.is-subclass-of"
  57665. ><B
  57666. CLASS="function"
  57667. >is_subclass_of()</B
  57668. ></A
  57669. >
  57670.     </P
  57671. ></DIV
  57672. ><H1
  57673. ><A
  57674. NAME="function.get-declared-classes"
  57675. ></A
  57676. >get_declared_classes</H1
  57677. ><DIV
  57678. CLASS="refnamediv"
  57679. ><A
  57680. NAME="AEN11691"
  57681. ></A
  57682. ><P
  57683. >    (PHP 4 )</P
  57684. >get_declared_classes -- Vrßtit pole nßzv∙ definovan²ch t°φd</DIV
  57685. ><DIV
  57686. CLASS="refsect1"
  57687. ><A
  57688. NAME="AEN11694"
  57689. ></A
  57690. ><H2
  57691. >Popis</H2
  57692. >array <B
  57693. CLASS="methodname"
  57694. >get_declared_classes</B
  57695. > ( void )<BR
  57696. ></BR
  57697. ><P
  57698. >      Tato funkce vracφ pole nßzv∙ t°φd definovan²ch v souΦasnΘm skriptu.
  57699.     </P
  57700. ><DIV
  57701. CLASS="note"
  57702. ><BLOCKQUOTE
  57703. CLASS="note"
  57704. ><P
  57705. ><B
  57706. >Poznßmka: </B
  57707. >
  57708.       V PHP 4.0.1pl2 jsou na zaΦßtku pole vrßceny je╣t∞ t°i dal╣φ t°φdy:
  57709.       <B
  57710. CLASS="classname"
  57711. >stdClass</B
  57712. > (definovanß v
  57713.       <TT
  57714. CLASS="filename"
  57715. >Zend/zend.c</TT
  57716. >),
  57717.       <B
  57718. CLASS="classname"
  57719. >OverloadedTestClass</B
  57720. > (definovanß v
  57721.       <TT
  57722. CLASS="filename"
  57723. >ext/standard/basic_functions.c</TT
  57724. >)
  57725.       a <B
  57726. CLASS="classname"
  57727. >Directory</B
  57728. >
  57729.       (definovanß v <TT
  57730. CLASS="filename"
  57731. >ext/standard/dir.c</TT
  57732. >).
  57733.      </P
  57734. ></BLOCKQUOTE
  57735. ></DIV
  57736. ></DIV
  57737. ><H1
  57738. ><A
  57739. NAME="function.get-object-vars"
  57740. ></A
  57741. >get_object_vars</H1
  57742. ><DIV
  57743. CLASS="refnamediv"
  57744. ><A
  57745. NAME="AEN11710"
  57746. ></A
  57747. ><P
  57748. >    (PHP 4 )</P
  57749. >get_object_vars -- Vrßtit asociativnφ pole vlastnostφ objektu</DIV
  57750. ><DIV
  57751. CLASS="refsect1"
  57752. ><A
  57753. NAME="AEN11713"
  57754. ></A
  57755. ><H2
  57756. >Popis</H2
  57757. >array <B
  57758. CLASS="methodname"
  57759. >get_object_vars</B
  57760. > ( object obj)<BR
  57761. ></BR
  57762. ><P
  57763. >      Tato funkce vracφ asociativnφ pole definovan²ch vlastnostφ objektu
  57764.      <TT
  57765. CLASS="parameter"
  57766. ><I
  57767. >obj</I
  57768. ></TT
  57769. >. Prom∞nn²m deklarovan²m v t°φd∞ jφ╛ je
  57770.      <TT
  57771. CLASS="parameter"
  57772. ><I
  57773. >obj</I
  57774. ></TT
  57775. > instancφ, kter²m nebyla p°i°azena hodnota,
  57776.      nejsou ve vrßcenΘm poli obsa╛eny.
  57777.      <TABLE
  57778. WIDTH="100%"
  57779. BORDER="0"
  57780. CELLPADDING="0"
  57781. CELLSPACING="0"
  57782. CLASS="EXAMPLE"
  57783. ><TR
  57784. ><TD
  57785. ><DIV
  57786. CLASS="example"
  57787. ><A
  57788. NAME="AEN11724"
  57789. ></A
  57790. ><P
  57791. ><B
  57792. >P°φklad 1. Pou╛itφ <B
  57793. CLASS="function"
  57794. >get_object_vars()</B
  57795. ></B
  57796. ></P
  57797. ><TABLE
  57798. BORDER="0"
  57799. BGCOLOR="#E0E0E0"
  57800. CELLPADDING="5"
  57801. ><TR
  57802. ><TD
  57803. ><PRE
  57804. CLASS="php"
  57805. ><?php
  57806. class Point2D {
  57807.     var $x, $y;
  57808.     var $label;
  57809.  
  57810.     function Point2D($x, $y) {
  57811.         $this->x = $x;
  57812.         $this->y = $y;
  57813.     }
  57814.  
  57815.     function setLabel($label) {
  57816.         $this->label = $label;
  57817.     }
  57818.  
  57819.     function getPoint() {
  57820.         return array("x" => $this->x,
  57821.                      "y" => $this->y,
  57822.                      "label" => $this->label);
  57823.     }
  57824. }
  57825.  
  57826. $p1 = new Point2D(1.233, 3.445);
  57827. print_r(get_object_vars($p1));
  57828. // "$label" is declared but not defined
  57829. // Array
  57830. // (
  57831. //     [x] => 1.233
  57832. //     [y] => 3.445
  57833. // )
  57834.  
  57835. $p1->setLabel("point #1");
  57836. print_r(get_object_vars($p1));
  57837. // Array
  57838. // (
  57839. //     [x] => 1.233
  57840. //     [y] => 3.445
  57841. //     [label] => point #1
  57842. // )
  57843.  
  57844. ?></PRE
  57845. ></TD
  57846. ></TR
  57847. ></TABLE
  57848. ></DIV
  57849. ></TD
  57850. ></TR
  57851. ></TABLE
  57852. >
  57853.     </P
  57854. ><P
  57855. >      Viz takΘ <A
  57856. HREF="#function.get-class-methods"
  57857. ><B
  57858. CLASS="function"
  57859. >get_class_methods()</B
  57860. ></A
  57861. >,
  57862.      <A
  57863. HREF="#function.get-class-vars"
  57864. ><B
  57865. CLASS="function"
  57866. >get_class_vars()</B
  57867. ></A
  57868. >
  57869.     </P
  57870. ></DIV
  57871. ><H1
  57872. ><A
  57873. NAME="function.get-parent-class"
  57874. ></A
  57875. >get_parent_class</H1
  57876. ><DIV
  57877. CLASS="refnamediv"
  57878. ><A
  57879. NAME="AEN11732"
  57880. ></A
  57881. ><P
  57882. >    (PHP 4 )</P
  57883. >get_parent_class -- Vrßtit nßzev rodiΦovskΘ t°φdy objektu</DIV
  57884. ><DIV
  57885. CLASS="refsect1"
  57886. ><A
  57887. NAME="AEN11735"
  57888. ></A
  57889. ><H2
  57890. >Popis</H2
  57891. >string <B
  57892. CLASS="methodname"
  57893. >get_parent_class</B
  57894. > ( object obj)<BR
  57895. ></BR
  57896. ><P
  57897. >      Tato funkce vracφ nßzev rodiΦovskΘ t°φdy objektu
  57898.      <TT
  57899. CLASS="parameter"
  57900. ><I
  57901. >obj</I
  57902. ></TT
  57903. >.
  57904.     </P
  57905. ><P
  57906. >      Viz takΘ <A
  57907. HREF="#function.get-class"
  57908. ><B
  57909. CLASS="function"
  57910. >get_class()</B
  57911. ></A
  57912. >,
  57913.      <A
  57914. HREF="#function.is-subclass-of"
  57915. ><B
  57916. CLASS="function"
  57917. >is_subclass_of()</B
  57918. ></A
  57919. >
  57920.     </P
  57921. ></DIV
  57922. ><H1
  57923. ><A
  57924. NAME="function.is-a"
  57925. ></A
  57926. >is_a</H1
  57927. ><DIV
  57928. CLASS="refnamediv"
  57929. ><A
  57930. NAME="AEN11749"
  57931. ></A
  57932. ><P
  57933. >    (PHP 4 >= 4.2.0)</P
  57934. >is_a -- 
  57935.      Returns <TT
  57936. CLASS="constant"
  57937. ><B
  57938. >TRUE</B
  57939. ></TT
  57940. > if the object is of this class or has this class as 
  57941.      one of its parents
  57942.     </DIV
  57943. ><DIV
  57944. CLASS="refsect1"
  57945. ><A
  57946. NAME="AEN11753"
  57947. ></A
  57948. ><H2
  57949. >Description</H2
  57950. >bool <B
  57951. CLASS="methodname"
  57952. >is_a</B
  57953. > ( object object, string class_name)<BR
  57954. ></BR
  57955. ><P
  57956. >      This function returns <TT
  57957. CLASS="constant"
  57958. ><B
  57959. >TRUE</B
  57960. ></TT
  57961. > if the object is of this class or 
  57962.      has this class as one of its parents, <TT
  57963. CLASS="constant"
  57964. ><B
  57965. >FALSE</B
  57966. ></TT
  57967. > otherwise.
  57968.     </P
  57969. ><P
  57970. >      See also <A
  57971. HREF="#function.get-class"
  57972. ><B
  57973. CLASS="function"
  57974. >get_class()</B
  57975. ></A
  57976. >, 
  57977.      <A
  57978. HREF="#function.get-parent-class"
  57979. ><B
  57980. CLASS="function"
  57981. >get_parent_class()</B
  57982. ></A
  57983. >, and 
  57984.      <A
  57985. HREF="#function.is-subclass-of"
  57986. ><B
  57987. CLASS="function"
  57988. >is_subclass_of()</B
  57989. ></A
  57990. >.
  57991.     </P
  57992. ></DIV
  57993. ><H1
  57994. ><A
  57995. NAME="function.is-subclass-of"
  57996. ></A
  57997. >is_subclass_of</H1
  57998. ><DIV
  57999. CLASS="refnamediv"
  58000. ><A
  58001. NAME="AEN11772"
  58002. ></A
  58003. ><P
  58004. >    (PHP 4 )</P
  58005. >is_subclass_of -- 
  58006.      Zjistit, jestli objekt pat°φ do podt°φdy urΦitΘ t°φdy
  58007.     </DIV
  58008. ><DIV
  58009. CLASS="refsect1"
  58010. ><A
  58011. NAME="AEN11775"
  58012. ></A
  58013. ><H2
  58014. >Popis</H2
  58015. >bool <B
  58016. CLASS="methodname"
  58017. >is_subclass_of</B
  58018. > ( object obj, string superclass)<BR
  58019. ></BR
  58020. ><P
  58021. >      Tato funkce vracφ <TT
  58022. CLASS="constant"
  58023. ><B
  58024. >TRUE</B
  58025. ></TT
  58026. >, pokud je objekt
  58027.      <TT
  58028. CLASS="parameter"
  58029. ><I
  58030. >obj</I
  58031. ></TT
  58032. > instancφ t°φdy, kterß je podt°φdou
  58033.      <TT
  58034. CLASS="parameter"
  58035. ><I
  58036. >superclass</I
  58037. ></TT
  58038. >, jinak <TT
  58039. CLASS="constant"
  58040. ><B
  58041. >FALSE</B
  58042. ></TT
  58043. >.
  58044.     </P
  58045. ><P
  58046. >      Viz takΘ <A
  58047. HREF="#function.get-class"
  58048. ><B
  58049. CLASS="function"
  58050. >get_class()</B
  58051. ></A
  58052. >,
  58053.      <A
  58054. HREF="#function.get-parent-class"
  58055. ><B
  58056. CLASS="function"
  58057. >get_parent_class()</B
  58058. ></A
  58059. >
  58060.     </P
  58061. ></DIV
  58062. ><H1
  58063. ><A
  58064. NAME="function.method-exists"
  58065. ></A
  58066. >method_exists</H1
  58067. ><DIV
  58068. CLASS="refnamediv"
  58069. ><A
  58070. NAME="AEN11795"
  58071. ></A
  58072. ><P
  58073. >    (PHP 4 )</P
  58074. >method_exists -- Zjistit, jestli mß t°φda urΦitou metodu</DIV
  58075. ><DIV
  58076. CLASS="refsect1"
  58077. ><A
  58078. NAME="AEN11798"
  58079. ></A
  58080. ><H2
  58081. >Popis</H2
  58082. >bool <B
  58083. CLASS="methodname"
  58084. >method_exists</B
  58085. > ( object object, string method_name)<BR
  58086. ></BR
  58087. ><P
  58088. >      Tato funkce vracφ <TT
  58089. CLASS="constant"
  58090. ><B
  58091. >TRUE</B
  58092. ></TT
  58093. >, pokud mß
  58094.      <TT
  58095. CLASS="parameter"
  58096. ><I
  58097. >object</I
  58098. ></TT
  58099. > definovßnu metodu
  58100.      <TT
  58101. CLASS="parameter"
  58102. ><I
  58103. >method_name</I
  58104. ></TT
  58105. >, jinak <TT
  58106. CLASS="constant"
  58107. ><B
  58108. >FALSE</B
  58109. ></TT
  58110. >.
  58111.     </P
  58112. ></DIV
  58113. ></DIV
  58114. ><DIV
  58115. CLASS="reference"
  58116. ><A
  58117. NAME="ref.cpdf"
  58118. ></A
  58119. ><DIV
  58120. CLASS="TITLEPAGE"
  58121. ><H1
  58122. CLASS="title"
  58123. >X. ClibPDF functions</H1
  58124. ><DIV
  58125. CLASS="PARTINTRO"
  58126. ><A
  58127. NAME="AEN11817"
  58128. ></A
  58129. ><DIV
  58130. CLASS="section"
  58131. ><H1
  58132. CLASS="section"
  58133. ><A
  58134. NAME="cpdf.intro"
  58135. ></A
  58136. >┌vod</H1
  58137. ><P
  58138. >      ClibPDF lets you create PDF documents with PHP. ClibPDF functionality
  58139.      and API are similar to <A
  58140. HREF="#ref.pdf"
  58141. >PDFlib</A
  58142. >.
  58143.      This documentation should be read alongside the ClibPDF manual since it
  58144.      explains the library in much greater detail.
  58145.     </P
  58146. ><P
  58147. >      Many functions in the native ClibPDF and the PHP module, as well
  58148.      as in <A
  58149. HREF="#ref.pdf"
  58150. >PDFlib</A
  58151. >, have the same name.
  58152.      All functions except for <A
  58153. HREF="#function.cpdf-open"
  58154. ><B
  58155. CLASS="function"
  58156. >cpdf_open()</B
  58157. ></A
  58158. > take the
  58159.      handle for the document as their first parameter.
  58160.     </P
  58161. ><P
  58162. >      Currently this handle is not used internally since ClibPDF does
  58163.      not support the creation of several PDF documents at the same time.
  58164.      Actually, you should not even try it, the results are unpredictable. I
  58165.      can't oversee what the consequences in a multi threaded environment
  58166.      are. According to the author of ClibPDF this will change in one of
  58167.      the next releases (current version when this was written is 1.10).
  58168.      If you need this functionality use the pdflib module.
  58169.     </P
  58170. ><P
  58171. >      A nice feature of ClibPDF (and <A
  58172. HREF="#ref.pdf"
  58173. >PDFlib</A
  58174. >) is the ability to create the pdf
  58175.      document completely in memory without using temporary files. It
  58176.      also provides the ability to pass coordinates in a predefined unit
  58177.      length. (This feature can also be simulated by
  58178.      <A
  58179. HREF="#function.pdf-translate"
  58180. ><B
  58181. CLASS="function"
  58182. >pdf_translate()</B
  58183. ></A
  58184. > when using the <A
  58185. HREF="#ref.pdf"
  58186. >PDFlib</A
  58187. > functions.)
  58188.     </P
  58189. ><P
  58190. >      Another nice feature of ClibPDF is the fact that any page can be modified
  58191.      at any time even if a new page has been already opened. The function
  58192.      <A
  58193. HREF="#function.cpdf-set-current-page"
  58194. ><B
  58195. CLASS="function"
  58196. >cpdf_set_current_page()</B
  58197. ></A
  58198. > allows to leave the current
  58199.      page and presume modifying an other page.
  58200.     </P
  58201. ><P
  58202. >      Most of the functions are fairly easy to use. The most difficult part
  58203.      is probably creating a very simple PDF document at all. The following
  58204.      example should help you to get started. It creates a document
  58205.      with one page. The page contains the text "Times-Roman" in an
  58206.      outlined 30pt font. The text is underlined.
  58207.     </P
  58208. ><DIV
  58209. CLASS="note"
  58210. ><BLOCKQUOTE
  58211. CLASS="note"
  58212. ><P
  58213. ><B
  58214. >Poznßmka: </B
  58215. >
  58216.       If you're interested in alternative free PDF generators that do not
  58217.       utilize external PDF libraries, see <A
  58218. HREF="#faq.using.freepdf"
  58219. >       this related FAQ</A
  58220. >.
  58221.      </P
  58222. ></BLOCKQUOTE
  58223. ></DIV
  58224. ></DIV
  58225. ><DIV
  58226. CLASS="section"
  58227. ><HR><H1
  58228. CLASS="section"
  58229. ><A
  58230. NAME="cpdf.requirements"
  58231. ></A
  58232. >Po╛adavky</H1
  58233. ><P
  58234. >      In order to use the ClibPDF functions you need to install the ClibPDF
  58235.      package. It is available for download from <A
  58236. HREF="http://www.fastio.com/"
  58237. TARGET="_top"
  58238. >      FastIO</A
  58239. >, but requires that you purchase a license for commercial
  58240.      use. PHP requires that you use cpdflib >= 2.
  58241.     </P
  58242. ></DIV
  58243. ><DIV
  58244. CLASS="section"
  58245. ><HR><H1
  58246. CLASS="section"
  58247. ><A
  58248. NAME="cpdf.installation"
  58249. ></A
  58250. >Instalace</H1
  58251. ><P
  58252. >   To get these functions to work, you have to compile PHP with
  58253.   <TT
  58254. CLASS="option"
  58255. >--with-cpdflib[=DIR]</TT
  58256. >. DIR is the cpdflib
  58257.   install directory, defaults to <TT
  58258. CLASS="filename"
  58259. >/usr</TT
  58260. >. In addition you
  58261.   can specify the jpeg library and the tiff library for ClibPDF to use. To do
  58262.   so add to your configure line the options
  58263.   <TT
  58264. CLASS="option"
  58265. >--with-jpeg-dir[=DIR]</TT
  58266. >
  58267.   <TT
  58268. CLASS="option"
  58269. >--with-tiff-dir[=DIR]</TT
  58270. >.
  58271.  </P
  58272. ></DIV
  58273. ><DIV
  58274. CLASS="section"
  58275. ><HR><H1
  58276. CLASS="section"
  58277. ><A
  58278. NAME="cpdf.configuration"
  58279. ></A
  58280. >Konfigurace b∞hu</H1
  58281. ><P
  58282. >Toto roz╣φ°enφ nemß definovßno ╛ßdnΘ konfiguraΦnφ
  58283. direktivy.</P
  58284. ></DIV
  58285. ><DIV
  58286. CLASS="section"
  58287. ><HR><H1
  58288. CLASS="section"
  58289. ><A
  58290. NAME="cpdf.constants"
  58291. ></A
  58292. >P°eddefinovanΘ konstanty</H1
  58293. ><P
  58294. > Tyto konstanty jsou definovßny tφmto roz╣φ°enφm a budou k dispozici pouze
  58295. tehdy, bylo-li roz╣φ°enφ zkompilovßno spoleΦn∞ s PHP nebo dynamicky zavedeno
  58296. za b∞hu.
  58297. </P
  58298. ><P
  58299. ></P
  58300. ><DIV
  58301. CLASS="variablelist"
  58302. ><DL
  58303. ><DT
  58304. ><TT
  58305. CLASS="constant"
  58306. ><B
  58307. >CPDF_PM_NONE</B
  58308. ></TT
  58309. > 
  58310.     (<A
  58311. HREF="#language.types.integer"
  58312. ><B
  58313. CLASS="type"
  58314. >integer</B
  58315. ></A
  58316. >)</DT
  58317. ><DD
  58318. ><P
  58319. >      
  58320.     </P
  58321. ></DD
  58322. ><DT
  58323. ><TT
  58324. CLASS="constant"
  58325. ><B
  58326. >CPDF_PM_OUTLINES</B
  58327. ></TT
  58328. > 
  58329.     (<A
  58330. HREF="#language.types.integer"
  58331. ><B
  58332. CLASS="type"
  58333. >integer</B
  58334. ></A
  58335. >)</DT
  58336. ><DD
  58337. ><P
  58338. >      
  58339.     </P
  58340. ></DD
  58341. ><DT
  58342. ><TT
  58343. CLASS="constant"
  58344. ><B
  58345. >CPDF_PM_THUMBS</B
  58346. ></TT
  58347. > 
  58348.     (<A
  58349. HREF="#language.types.integer"
  58350. ><B
  58351. CLASS="type"
  58352. >integer</B
  58353. ></A
  58354. >)</DT
  58355. ><DD
  58356. ><P
  58357. >      
  58358.     </P
  58359. ></DD
  58360. ><DT
  58361. ><TT
  58362. CLASS="constant"
  58363. ><B
  58364. >CPDF_PM_FULLSCREEN</B
  58365. ></TT
  58366. > 
  58367.     (<A
  58368. HREF="#language.types.integer"
  58369. ><B
  58370. CLASS="type"
  58371. >integer</B
  58372. ></A
  58373. >)</DT
  58374. ><DD
  58375. ><P
  58376. >      
  58377.     </P
  58378. ></DD
  58379. ><DT
  58380. ><TT
  58381. CLASS="constant"
  58382. ><B
  58383. >CPDF_PL_SINGLE</B
  58384. ></TT
  58385. > 
  58386.     (<A
  58387. HREF="#language.types.integer"
  58388. ><B
  58389. CLASS="type"
  58390. >integer</B
  58391. ></A
  58392. >)</DT
  58393. ><DD
  58394. ><P
  58395. >      
  58396.     </P
  58397. ></DD
  58398. ><DT
  58399. ><TT
  58400. CLASS="constant"
  58401. ><B
  58402. >CPDF_PL_1COLUMN</B
  58403. ></TT
  58404. > 
  58405.     (<A
  58406. HREF="#language.types.integer"
  58407. ><B
  58408. CLASS="type"
  58409. >integer</B
  58410. ></A
  58411. >)</DT
  58412. ><DD
  58413. ><P
  58414. >      
  58415.     </P
  58416. ></DD
  58417. ><DT
  58418. ><TT
  58419. CLASS="constant"
  58420. ><B
  58421. >CPDF_PL_2LCOLUMN</B
  58422. ></TT
  58423. > 
  58424.     (<A
  58425. HREF="#language.types.integer"
  58426. ><B
  58427. CLASS="type"
  58428. >integer</B
  58429. ></A
  58430. >)</DT
  58431. ><DD
  58432. ><P
  58433. >      
  58434.     </P
  58435. ></DD
  58436. ><DT
  58437. ><TT
  58438. CLASS="constant"
  58439. ><B
  58440. >CPDF_PL_2RCOLUMN</B
  58441. ></TT
  58442. > 
  58443.     (<A
  58444. HREF="#language.types.integer"
  58445. ><B
  58446. CLASS="type"
  58447. >integer</B
  58448. ></A
  58449. >)</DT
  58450. ><DD
  58451. ><P
  58452. >      
  58453.     </P
  58454. ></DD
  58455. ></DL
  58456. ></DIV
  58457. ></DIV
  58458. ><DIV
  58459. CLASS="section"
  58460. ><HR><H1
  58461. CLASS="section"
  58462. ><A
  58463. NAME="cpdf.examples"
  58464. ></A
  58465. >P°φklady</H1
  58466. ><TABLE
  58467. WIDTH="100%"
  58468. BORDER="0"
  58469. CELLPADDING="0"
  58470. CELLSPACING="0"
  58471. CLASS="EXAMPLE"
  58472. ><TR
  58473. ><TD
  58474. ><DIV
  58475. CLASS="example"
  58476. ><A
  58477. NAME="AEN11904"
  58478. ></A
  58479. ><P
  58480. ><B
  58481. >P°φklad 1. Simple ClibPDF Example</B
  58482. ></P
  58483. ><TABLE
  58484. BORDER="0"
  58485. BGCOLOR="#E0E0E0"
  58486. CELLPADDING="5"
  58487. ><TR
  58488. ><TD
  58489. ><PRE
  58490. CLASS="php"
  58491. ><?php
  58492. $cpdf = cpdf_open(0);
  58493. cpdf_page_init($cpdf, 1, 0, 595, 842, 1.0);
  58494. cpdf_add_outline($cpdf, 0, 0, 0, 1, "Page 1");
  58495. cpdf_begin_text($cpdf);
  58496. cpdf_set_font($cpdf, "Times-Roman", 30, "WinAnsiEncoding");
  58497. cpdf_set_text_rendering($cpdf, 1);
  58498. cpdf_text($cpdf, "Times Roman outlined", 50, 750);
  58499. cpdf_end_text($cpdf);
  58500. cpdf_moveto($cpdf, 50, 740);
  58501. cpdf_lineto($cpdf, 330, 740);
  58502. cpdf_stroke($cpdf);
  58503. cpdf_finalize($cpdf);
  58504. Header("Content-type: application/pdf");
  58505. cpdf_output_buffer($cpdf);
  58506. cpdf_close($cpdf);
  58507. ?></PRE
  58508. ></TD
  58509. ></TR
  58510. ></TABLE
  58511. ></DIV
  58512. ></TD
  58513. ></TR
  58514. ></TABLE
  58515. ><P
  58516. >      The pdflib distribution contains a more complex example which creates a
  58517.      series of pages with an analog clock. Here is that example converted
  58518.      into PHP using the ClibPDF extension:
  58519.     </P
  58520. ><TABLE
  58521. WIDTH="100%"
  58522. BORDER="0"
  58523. CELLPADDING="0"
  58524. CELLSPACING="0"
  58525. CLASS="EXAMPLE"
  58526. ><TR
  58527. ><TD
  58528. ><DIV
  58529. CLASS="example"
  58530. ><A
  58531. NAME="AEN11908"
  58532. ></A
  58533. ><P
  58534. ><B
  58535. >P°φklad 2. pdfclock example from pdflib 2.0 distribution</B
  58536. ></P
  58537. ><TABLE
  58538. BORDER="0"
  58539. BGCOLOR="#E0E0E0"
  58540. CELLPADDING="5"
  58541. ><TR
  58542. ><TD
  58543. ><PRE
  58544. CLASS="php"
  58545. ><?php
  58546. $radius = 200;
  58547. $margin = 20;
  58548. $pagecount = 40;
  58549.  
  58550. $pdf = cpdf_open(0);
  58551. cpdf_set_creator($pdf, "pdf_clock.php3");
  58552. cpdf_set_title($pdf, "Analog Clock");
  58553.   
  58554. while ($pagecount-- > 0) {
  58555.   cpdf_page_init($pdf, $pagecount+1, 0, 2 * ($radius + $margin), 2 * ($radius + $margin), 1.0);
  58556.   
  58557.   cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0);  /* wipe */
  58558.   
  58559.   cpdf_translate($pdf, $radius + $margin, $radius + $margin);
  58560.   cpdf_save($pdf);
  58561.   cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0);
  58562.   
  58563.   /* minute strokes */
  58564.   cpdf_setlinewidth($pdf, 2.0);
  58565.   for ($alpha = 0; $alpha < 360; $alpha += 6) {
  58566.     cpdf_rotate($pdf, 6.0);
  58567.     cpdf_moveto($pdf, $radius, 0.0);
  58568.     cpdf_lineto($pdf, $radius-$margin/3, 0.0);
  58569.     cpdf_stroke($pdf);
  58570.   }
  58571.   
  58572.   cpdf_restore($pdf);
  58573.   cpdf_save($pdf);
  58574.  
  58575.   /* 5 minute strokes */
  58576.   cpdf_setlinewidth($pdf, 3.0);
  58577.   for ($alpha = 0; $alpha < 360; $alpha += 30) {
  58578.     cpdf_rotate($pdf, 30.0);
  58579.     cpdf_moveto($pdf, $radius, 0.0);
  58580.     cpdf_lineto($pdf, $radius-$margin, 0.0);
  58581.     cpdf_stroke($pdf);
  58582.   }
  58583.  
  58584.   $ltime = getdate();
  58585.  
  58586.   /* draw hour hand */
  58587.   cpdf_save($pdf);
  58588.   cpdf_rotate($pdf, -(($ltime['minutes']/60.0) + $ltime['hours'] - 3.0) * 30.0);
  58589.   cpdf_moveto($pdf, -$radius/10, -$radius/20);
  58590.   cpdf_lineto($pdf, $radius/2, 0.0);
  58591.   cpdf_lineto($pdf, -$radius/10, $radius/20);
  58592.   cpdf_closepath($pdf);
  58593.   cpdf_fill($pdf);
  58594.   cpdf_restore($pdf);
  58595.  
  58596.   /* draw minute hand */
  58597.   cpdf_save($pdf);
  58598.   cpdf_rotate($pdf, -(($ltime['seconds']/60.0) + $ltime['minutes'] - 15.0) * 6.0);
  58599.   cpdf_moveto($pdf, -$radius/10, -$radius/20);
  58600.   cpdf_lineto($pdf, $radius * 0.8, 0.0);
  58601.   cpdf_lineto($pdf, -$radius/10, $radius/20);
  58602.   cpdf_closepath($pdf);
  58603.   cpdf_fill($pdf);
  58604.   cpdf_restore($pdf);
  58605.  
  58606.   /* draw second hand */
  58607.   cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0);
  58608.   cpdf_setlinewidth($pdf, 2);
  58609.   cpdf_save($pdf);
  58610.   cpdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0));
  58611.   cpdf_moveto($pdf, -$radius/5, 0.0);
  58612.   cpdf_lineto($pdf, $radius, 0.0);
  58613.   cpdf_stroke($pdf);
  58614.   cpdf_restore($pdf);
  58615.  
  58616.   /* draw little circle at center */
  58617.   cpdf_circle($pdf, 0, 0, $radius/30);
  58618.   cpdf_fill($pdf);
  58619.  
  58620.   cpdf_restore($pdf);
  58621.  
  58622.   cpdf_finalize_page($pdf, $pagecount+1);
  58623. }
  58624.  
  58625. cpdf_finalize($pdf);
  58626. Header("Content-type: application/pdf");
  58627. cpdf_output_buffer($pdf);
  58628. cpdf_close($pdf);
  58629. ?></PRE
  58630. ></TD
  58631. ></TR
  58632. ></TABLE
  58633. ></DIV
  58634. ></TD
  58635. ></TR
  58636. ></TABLE
  58637. ></DIV
  58638. ><DIV
  58639. CLASS="section"
  58640. ><HR><H1
  58641. CLASS="section"
  58642. ><A
  58643. NAME="cpdf.seealso"
  58644. ></A
  58645. >Viz takΘ</H1
  58646. ><P
  58647. >      See also the <A
  58648. HREF="#ref.pdf"
  58649. >PDFlib</A
  58650. >
  58651.      extension documentation.
  58652.     </P
  58653. ></DIV
  58654. ></DIV
  58655. ><DIV
  58656. CLASS="TOC"
  58657. ><DL
  58658. ><DT
  58659. ><B
  58660. >Obsah</B
  58661. ></DT
  58662. ><DT
  58663. ><A
  58664. HREF="#function.cpdf-add-annotation"
  58665. >cpdf_add_annotation</A
  58666. > -- Adds annotation</DT
  58667. ><DT
  58668. ><A
  58669. HREF="#function.cpdf-add-outline"
  58670. >cpdf_add_outline</A
  58671. > -- Adds bookmark for current page</DT
  58672. ><DT
  58673. ><A
  58674. HREF="#function.cpdf-arc"
  58675. >cpdf_arc</A
  58676. > -- Draws an arc</DT
  58677. ><DT
  58678. ><A
  58679. HREF="#function.cpdf-begin-text"
  58680. >cpdf_begin_text</A
  58681. > -- Starts text section</DT
  58682. ><DT
  58683. ><A
  58684. HREF="#function.cpdf-circle"
  58685. >cpdf_circle</A
  58686. > -- Draw a circle</DT
  58687. ><DT
  58688. ><A
  58689. HREF="#function.cpdf-clip"
  58690. >cpdf_clip</A
  58691. > -- Clips to current path</DT
  58692. ><DT
  58693. ><A
  58694. HREF="#function.cpdf-close"
  58695. >cpdf_close</A
  58696. > -- Closes the pdf document</DT
  58697. ><DT
  58698. ><A
  58699. HREF="#function.cpdf-closepath-fill-stroke"
  58700. >cpdf_closepath_fill_stroke</A
  58701. > -- Close, fill and stroke current path</DT
  58702. ><DT
  58703. ><A
  58704. HREF="#function.cpdf-closepath-stroke"
  58705. >cpdf_closepath_stroke</A
  58706. > -- Close path and draw line along path</DT
  58707. ><DT
  58708. ><A
  58709. HREF="#function.cpdf-closepath"
  58710. >cpdf_closepath</A
  58711. > -- Close path</DT
  58712. ><DT
  58713. ><A
  58714. HREF="#function.cpdf-continue-text"
  58715. >cpdf_continue_text</A
  58716. > -- Output text in next line</DT
  58717. ><DT
  58718. ><A
  58719. HREF="#function.cpdf-curveto"
  58720. >cpdf_curveto</A
  58721. > -- Draws a curve</DT
  58722. ><DT
  58723. ><A
  58724. HREF="#function.cpdf-end-text"
  58725. >cpdf_end_text</A
  58726. > -- Ends text section</DT
  58727. ><DT
  58728. ><A
  58729. HREF="#function.cpdf-fill-stroke"
  58730. >cpdf_fill_stroke</A
  58731. > -- Fill and stroke current path</DT
  58732. ><DT
  58733. ><A
  58734. HREF="#function.cpdf-fill"
  58735. >cpdf_fill</A
  58736. > -- Fill current path</DT
  58737. ><DT
  58738. ><A
  58739. HREF="#function.cpdf-finalize-page"
  58740. >cpdf_finalize_page</A
  58741. > -- Ends page</DT
  58742. ><DT
  58743. ><A
  58744. HREF="#function.cpdf-finalize"
  58745. >cpdf_finalize</A
  58746. > -- Ends document</DT
  58747. ><DT
  58748. ><A
  58749. HREF="#function.cpdf-global-set-document-limits"
  58750. >cpdf_global_set_document_limits</A
  58751. > -- Sets document limits for any pdf document</DT
  58752. ><DT
  58753. ><A
  58754. HREF="#function.cpdf-import-jpeg"
  58755. >cpdf_import_jpeg</A
  58756. > -- Opens a JPEG image</DT
  58757. ><DT
  58758. ><A
  58759. HREF="#function.cpdf-lineto"
  58760. >cpdf_lineto</A
  58761. > -- Draws a line</DT
  58762. ><DT
  58763. ><A
  58764. HREF="#function.cpdf-moveto"
  58765. >cpdf_moveto</A
  58766. > -- Sets current point</DT
  58767. ><DT
  58768. ><A
  58769. HREF="#function.cpdf-newpath"
  58770. >cpdf_newpath</A
  58771. > -- Starts a new path</DT
  58772. ><DT
  58773. ><A
  58774. HREF="#function.cpdf-open"
  58775. >cpdf_open</A
  58776. > -- Opens a new pdf document</DT
  58777. ><DT
  58778. ><A
  58779. HREF="#function.cpdf-output-buffer"
  58780. >cpdf_output_buffer</A
  58781. > -- Outputs the pdf document in memory buffer</DT
  58782. ><DT
  58783. ><A
  58784. HREF="#function.cpdf-page-init"
  58785. >cpdf_page_init</A
  58786. > -- Starts new page</DT
  58787. ><DT
  58788. ><A
  58789. HREF="#function.cpdf-place-inline-image"
  58790. >cpdf_place_inline_image</A
  58791. > -- Places an image on the page</DT
  58792. ><DT
  58793. ><A
  58794. HREF="#function.cpdf-rect"
  58795. >cpdf_rect</A
  58796. > -- Draw a rectangle</DT
  58797. ><DT
  58798. ><A
  58799. HREF="#function.cpdf-restore"
  58800. >cpdf_restore</A
  58801. > -- Restores formerly saved environment</DT
  58802. ><DT
  58803. ><A
  58804. HREF="#function.cpdf-rlineto"
  58805. >cpdf_rlineto</A
  58806. > -- Draws a line</DT
  58807. ><DT
  58808. ><A
  58809. HREF="#function.cpdf-rmoveto"
  58810. >cpdf_rmoveto</A
  58811. > -- Sets current point</DT
  58812. ><DT
  58813. ><A
  58814. HREF="#function.cpdf-rotate-text"
  58815. >cpdf_rotate_text</A
  58816. > -- 
  58817.      Sets text rotation angle
  58818.     </DT
  58819. ><DT
  58820. ><A
  58821. HREF="#function.cpdf-rotate"
  58822. >cpdf_rotate</A
  58823. > -- Sets rotation</DT
  58824. ><DT
  58825. ><A
  58826. HREF="#function.cpdf-save-to-file"
  58827. >cpdf_save_to_file</A
  58828. > -- Writes the pdf document into a file</DT
  58829. ><DT
  58830. ><A
  58831. HREF="#function.cpdf-save"
  58832. >cpdf_save</A
  58833. > -- Saves current environment</DT
  58834. ><DT
  58835. ><A
  58836. HREF="#function.cpdf-scale"
  58837. >cpdf_scale</A
  58838. > -- Sets scaling</DT
  58839. ><DT
  58840. ><A
  58841. HREF="#function.cpdf-set-action-url"
  58842. >cpdf_set_action_url</A
  58843. > -- 
  58844.      Sets hyperlink
  58845.     </DT
  58846. ><DT
  58847. ><A
  58848. HREF="#function.cpdf-set-char-spacing"
  58849. >cpdf_set_char_spacing</A
  58850. > -- Sets character spacing</DT
  58851. ><DT
  58852. ><A
  58853. HREF="#function.cpdf-set-creator"
  58854. >cpdf_set_creator</A
  58855. > -- Sets the creator field in the pdf document</DT
  58856. ><DT
  58857. ><A
  58858. HREF="#function.cpdf-set-current-page"
  58859. >cpdf_set_current_page</A
  58860. > -- Sets current page</DT
  58861. ><DT
  58862. ><A
  58863. HREF="#function.cpdf-set-font-directories"
  58864. >cpdf_set_font_directories</A
  58865. > -- 
  58866.      Sets directories to search when using external fonts
  58867.     </DT
  58868. ><DT
  58869. ><A
  58870. HREF="#function.cpdf-set-font-map-file"
  58871. >cpdf_set_font_map_file</A
  58872. > -- 
  58873.      Sets fontname to filename translation map when using external fonts
  58874.     </DT
  58875. ><DT
  58876. ><A
  58877. HREF="#function.cpdf-set-font"
  58878. >cpdf_set_font</A
  58879. > -- Select the current font face and size</DT
  58880. ><DT
  58881. ><A
  58882. HREF="#function.cpdf-set-horiz-scaling"
  58883. >cpdf_set_horiz_scaling</A
  58884. > -- Sets horizontal scaling of text</DT
  58885. ><DT
  58886. ><A
  58887. HREF="#function.cpdf-set-keywords"
  58888. >cpdf_set_keywords</A
  58889. > -- Sets the keywords field of the pdf document</DT
  58890. ><DT
  58891. ><A
  58892. HREF="#function.cpdf-set-leading"
  58893. >cpdf_set_leading</A
  58894. > -- Sets distance between text lines</DT
  58895. ><DT
  58896. ><A
  58897. HREF="#function.cpdf-set-page-animation"
  58898. >cpdf_set_page_animation</A
  58899. > -- Sets duration between pages</DT
  58900. ><DT
  58901. ><A
  58902. HREF="#function.cpdf-set-subject"
  58903. >cpdf_set_subject</A
  58904. > -- Sets the subject field of the pdf document</DT
  58905. ><DT
  58906. ><A
  58907. HREF="#function.cpdf-set-text-matrix"
  58908. >cpdf_set_text_matrix</A
  58909. > -- Sets the text matrix</DT
  58910. ><DT
  58911. ><A
  58912. HREF="#function.cpdf-set-text-pos"
  58913. >cpdf_set_text_pos</A
  58914. > -- Sets text position</DT
  58915. ><DT
  58916. ><A
  58917. HREF="#function.cpdf-set-text-rendering"
  58918. >cpdf_set_text_rendering</A
  58919. > -- Determines how text is rendered</DT
  58920. ><DT
  58921. ><A
  58922. HREF="#function.cpdf-set-text-rise"
  58923. >cpdf_set_text_rise</A
  58924. > -- Sets the text rise</DT
  58925. ><DT
  58926. ><A
  58927. HREF="#function.cpdf-set-title"
  58928. >cpdf_set_title</A
  58929. > -- Sets the title field of the pdf document</DT
  58930. ><DT
  58931. ><A
  58932. HREF="#function.cpdf-set-viewer-preferences"
  58933. >cpdf_set_viewer_preferences</A
  58934. > -- 
  58935.      How to show the document in the viewer
  58936.     </DT
  58937. ><DT
  58938. ><A
  58939. HREF="#function.cpdf-set-word-spacing"
  58940. >cpdf_set_word_spacing</A
  58941. > -- Sets spacing between words</DT
  58942. ><DT
  58943. ><A
  58944. HREF="#function.cpdf-setdash"
  58945. >cpdf_setdash</A
  58946. > -- Sets dash pattern</DT
  58947. ><DT
  58948. ><A
  58949. HREF="#function.cpdf-setflat"
  58950. >cpdf_setflat</A
  58951. > -- Sets flatness</DT
  58952. ><DT
  58953. ><A
  58954. HREF="#function.cpdf-setgray-fill"
  58955. >cpdf_setgray_fill</A
  58956. > -- Sets filling color to gray value</DT
  58957. ><DT
  58958. ><A
  58959. HREF="#function.cpdf-setgray-stroke"
  58960. >cpdf_setgray_stroke</A
  58961. > -- Sets drawing color to gray value</DT
  58962. ><DT
  58963. ><A
  58964. HREF="#function.cpdf-setgray"
  58965. >cpdf_setgray</A
  58966. > -- Sets drawing and filling color to gray value</DT
  58967. ><DT
  58968. ><A
  58969. HREF="#function.cpdf-setlinecap"
  58970. >cpdf_setlinecap</A
  58971. > -- Sets linecap parameter</DT
  58972. ><DT
  58973. ><A
  58974. HREF="#function.cpdf-setlinejoin"
  58975. >cpdf_setlinejoin</A
  58976. > -- Sets linejoin parameter</DT
  58977. ><DT
  58978. ><A
  58979. HREF="#function.cpdf-setlinewidth"
  58980. >cpdf_setlinewidth</A
  58981. > -- Sets line width</DT
  58982. ><DT
  58983. ><A
  58984. HREF="#function.cpdf-setmiterlimit"
  58985. >cpdf_setmiterlimit</A
  58986. > -- Sets miter limit</DT
  58987. ><DT
  58988. ><A
  58989. HREF="#function.cpdf-setrgbcolor-fill"
  58990. >cpdf_setrgbcolor_fill</A
  58991. > -- Sets filling color to rgb color value</DT
  58992. ><DT
  58993. ><A
  58994. HREF="#function.cpdf-setrgbcolor-stroke"
  58995. >cpdf_setrgbcolor_stroke</A
  58996. > -- Sets drawing color to rgb color value</DT
  58997. ><DT
  58998. ><A
  58999. HREF="#function.cpdf-setrgbcolor"
  59000. >cpdf_setrgbcolor</A
  59001. > -- Sets drawing and filling color to rgb color value</DT
  59002. ><DT
  59003. ><A
  59004. HREF="#function.cpdf-show-xy"
  59005. >cpdf_show_xy</A
  59006. > -- Output text at position</DT
  59007. ><DT
  59008. ><A
  59009. HREF="#function.cpdf-show"
  59010. >cpdf_show</A
  59011. > -- Output text at current position</DT
  59012. ><DT
  59013. ><A
  59014. HREF="#function.cpdf-stringwidth"
  59015. >cpdf_stringwidth</A
  59016. > -- Returns width of text in current font</DT
  59017. ><DT
  59018. ><A
  59019. HREF="#function.cpdf-stroke"
  59020. >cpdf_stroke</A
  59021. > -- Draw line along path</DT
  59022. ><DT
  59023. ><A
  59024. HREF="#function.cpdf-text"
  59025. >cpdf_text</A
  59026. > -- Output text with parameters</DT
  59027. ><DT
  59028. ><A
  59029. HREF="#function.cpdf-translate"
  59030. >cpdf_translate</A
  59031. > -- Sets origin of coordinate system</DT
  59032. ></DL
  59033. ></DIV
  59034. ></DIV
  59035. ><H1
  59036. ><A
  59037. NAME="function.cpdf-add-annotation"
  59038. ></A
  59039. >cpdf_add_annotation</H1
  59040. ><DIV
  59041. CLASS="refnamediv"
  59042. ><A
  59043. NAME="AEN11916"
  59044. ></A
  59045. ><P
  59046. >    (PHP 3>= 3.0.12, PHP 4 )</P
  59047. >cpdf_add_annotation -- Adds annotation</DIV
  59048. ><DIV
  59049. CLASS="refsect1"
  59050. ><A
  59051. NAME="AEN11919"
  59052. ></A
  59053. ><H2
  59054. >Description</H2
  59055. >bool <B
  59056. CLASS="methodname"
  59057. >cpdf_add_annotation</B
  59058. > ( int pdf_document, float llx, float lly, float urx, float ury, string title, string content [, int mode])<BR
  59059. ></BR
  59060. ><P
  59061. >      The <B
  59062. CLASS="function"
  59063. >cpdf_add_annotation()</B
  59064. > adds a note with the
  59065.      lower left corner at (<TT
  59066. CLASS="parameter"
  59067. ><I
  59068. >llx</I
  59069. ></TT
  59070. >,
  59071.      <TT
  59072. CLASS="parameter"
  59073. ><I
  59074. >lly</I
  59075. ></TT
  59076. >) and the upper right corner at
  59077.      (<TT
  59078. CLASS="parameter"
  59079. ><I
  59080. >urx</I
  59081. ></TT
  59082. >, <TT
  59083. CLASS="parameter"
  59084. ><I
  59085. >ury</I
  59086. ></TT
  59087. >).
  59088.      Vracφ <TT
  59089. CLASS="constant"
  59090. ><B
  59091. >TRUE</B
  59092. ></TT
  59093. > p°i ·sp∞chu, <TT
  59094. CLASS="constant"
  59095. ><B
  59096. >FALSE</B
  59097. ></TT
  59098. > p°i selhßnφ.
  59099.     </P
  59100. ><P
  59101. >Nepovinn² parametr <TT
  59102. CLASS="parameter"
  59103. ><I
  59104. >mode</I
  59105. ></TT
  59106. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  59107. ></DIV
  59108. ><H1
  59109. ><A
  59110. NAME="function.cpdf-add-outline"
  59111. ></A
  59112. >cpdf_add_outline</H1
  59113. ><DIV
  59114. CLASS="refnamediv"
  59115. ><A
  59116. NAME="AEN11959"
  59117. ></A
  59118. ><P
  59119. >    (PHP 3>= 3.0.9, PHP 4 )</P
  59120. >cpdf_add_outline -- Adds bookmark for current page</DIV
  59121. ><DIV
  59122. CLASS="refsect1"
  59123. ><A
  59124. NAME="AEN11962"
  59125. ></A
  59126. ><H2
  59127. >Description</H2
  59128. >int <B
  59129. CLASS="methodname"
  59130. >cpdf_add_outline</B
  59131. > ( int pdf_document, int lastoutline, int sublevel, int open, int pagenr, string text)<BR
  59132. ></BR
  59133. ><P
  59134. >      The <B
  59135. CLASS="function"
  59136. >cpdf_add_outline()</B
  59137. > function adds a bookmark
  59138.      with text <TT
  59139. CLASS="parameter"
  59140. ><I
  59141. >text</I
  59142. ></TT
  59143. > that points to the current page.
  59144.     </P
  59145. ><P
  59146. >      <TABLE
  59147. WIDTH="100%"
  59148. BORDER="0"
  59149. CELLPADDING="0"
  59150. CELLSPACING="0"
  59151. CLASS="EXAMPLE"
  59152. ><TR
  59153. ><TD
  59154. ><DIV
  59155. CLASS="example"
  59156. ><A
  59157. NAME="AEN11989"
  59158. ></A
  59159. ><P
  59160. ><B
  59161. >P°φklad 1. Adding a page outline</B
  59162. ></P
  59163. ><TABLE
  59164. BORDER="0"
  59165. BGCOLOR="#E0E0E0"
  59166. CELLPADDING="5"
  59167. ><TR
  59168. ><TD
  59169. ><PRE
  59170. CLASS="php"
  59171. ><?php
  59172. $cpdf = cpdf_open(0);
  59173. cpdf_page_init($cpdf, 1, 0, 595, 842);
  59174. cpdf_add_outline($cpdf, 0, 0, 0, 1, "Page 1");
  59175. // ...
  59176. // some drawing
  59177. // ...
  59178. cpdf_finalize($cpdf);
  59179. Header("Content-type: application/pdf");
  59180. cpdf_output_buffer($cpdf);
  59181. cpdf_close($cpdf);
  59182. ?></PRE
  59183. ></TD
  59184. ></TR
  59185. ></TABLE
  59186. ></DIV
  59187. ></TD
  59188. ></TR
  59189. ></TABLE
  59190. >
  59191.     </P
  59192. ></DIV
  59193. ><H1
  59194. ><A
  59195. NAME="function.cpdf-arc"
  59196. ></A
  59197. >cpdf_arc</H1
  59198. ><DIV
  59199. CLASS="refnamediv"
  59200. ><A
  59201. NAME="AEN11993"
  59202. ></A
  59203. ><P
  59204. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59205. >cpdf_arc -- Draws an arc</DIV
  59206. ><DIV
  59207. CLASS="refsect1"
  59208. ><A
  59209. NAME="AEN11996"
  59210. ></A
  59211. ><H2
  59212. >Description</H2
  59213. >bool <B
  59214. CLASS="methodname"
  59215. >cpdf_arc</B
  59216. > ( int pdf_document, float x-coor, float y-coor, float radius, float start, float end [, int mode])<BR
  59217. ></BR
  59218. ><P
  59219. >      The <B
  59220. CLASS="function"
  59221. >cpdf_arc()</B
  59222. > function draws an arc with
  59223.      center at point 
  59224.      (<TT
  59225. CLASS="parameter"
  59226. ><I
  59227. >x-coor</I
  59228. ></TT
  59229. >, <TT
  59230. CLASS="parameter"
  59231. ><I
  59232. >y-coor</I
  59233. ></TT
  59234. >)
  59235.      and radius <TT
  59236. CLASS="parameter"
  59237. ><I
  59238. >radius</I
  59239. ></TT
  59240. >, starting at angle
  59241.      <TT
  59242. CLASS="parameter"
  59243. ><I
  59244. >start</I
  59245. ></TT
  59246. > and ending at angle
  59247.      <TT
  59248. CLASS="parameter"
  59249. ><I
  59250. >end</I
  59251. ></TT
  59252. >. Vracφ <TT
  59253. CLASS="constant"
  59254. ><B
  59255. >TRUE</B
  59256. ></TT
  59257. > p°i ·sp∞chu, <TT
  59258. CLASS="constant"
  59259. ><B
  59260. >FALSE</B
  59261. ></TT
  59262. > p°i selhßnφ.
  59263.     </P
  59264. ><P
  59265. >Nepovinn² parametr <TT
  59266. CLASS="parameter"
  59267. ><I
  59268. >mode</I
  59269. ></TT
  59270. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  59271. ><P
  59272. >      See also <A
  59273. HREF="#function.cpdf-circle"
  59274. ><B
  59275. CLASS="function"
  59276. >cpdf_circle()</B
  59277. ></A
  59278. >.
  59279.     </P
  59280. ></DIV
  59281. ><H1
  59282. ><A
  59283. NAME="function.cpdf-begin-text"
  59284. ></A
  59285. >cpdf_begin_text</H1
  59286. ><DIV
  59287. CLASS="refnamediv"
  59288. ><A
  59289. NAME="AEN12036"
  59290. ></A
  59291. ><P
  59292. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59293. >cpdf_begin_text -- Starts text section</DIV
  59294. ><DIV
  59295. CLASS="refsect1"
  59296. ><A
  59297. NAME="AEN12039"
  59298. ></A
  59299. ><H2
  59300. >Description</H2
  59301. >bool <B
  59302. CLASS="methodname"
  59303. >cpdf_begin_text</B
  59304. > ( int pdf_document)<BR
  59305. ></BR
  59306. ><P
  59307. >      The <B
  59308. CLASS="function"
  59309. >cpdf_begin_text()</B
  59310. > function starts a text
  59311.      section. Vracφ <TT
  59312. CLASS="constant"
  59313. ><B
  59314. >TRUE</B
  59315. ></TT
  59316. > p°i ·sp∞chu, <TT
  59317. CLASS="constant"
  59318. ><B
  59319. >FALSE</B
  59320. ></TT
  59321. > p°i selhßnφ.
  59322.      The created text section must be ended with 
  59323.      <A
  59324. HREF="#function.cpdf-end-text"
  59325. ><B
  59326. CLASS="function"
  59327. >cpdf_end_text()</B
  59328. ></A
  59329. >.
  59330.     </P
  59331. ><P
  59332. >      <TABLE
  59333. WIDTH="100%"
  59334. BORDER="0"
  59335. CELLPADDING="0"
  59336. CELLSPACING="0"
  59337. CLASS="EXAMPLE"
  59338. ><TR
  59339. ><TD
  59340. ><DIV
  59341. CLASS="example"
  59342. ><A
  59343. NAME="AEN12053"
  59344. ></A
  59345. ><P
  59346. ><B
  59347. >P°φklad 1. Text output</B
  59348. ></P
  59349. ><TABLE
  59350. BORDER="0"
  59351. BGCOLOR="#E0E0E0"
  59352. CELLPADDING="5"
  59353. ><TR
  59354. ><TD
  59355. ><PRE
  59356. CLASS="php"
  59357. ><?php
  59358. cpdf_begin_text($pdf);
  59359. cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding");
  59360. cpdf_text($pdf, 100, 100, "Some text");
  59361. cpdf_end_text($pdf)
  59362. ?></PRE
  59363. ></TD
  59364. ></TR
  59365. ></TABLE
  59366. ></DIV
  59367. ></TD
  59368. ></TR
  59369. ></TABLE
  59370. >
  59371.     </P
  59372. ><P
  59373. >      See also <A
  59374. HREF="#function.cpdf-end-text"
  59375. ><B
  59376. CLASS="function"
  59377. >cpdf_end_text()</B
  59378. ></A
  59379. >.
  59380.     </P
  59381. ></DIV
  59382. ><H1
  59383. ><A
  59384. NAME="function.cpdf-circle"
  59385. ></A
  59386. >cpdf_circle</H1
  59387. ><DIV
  59388. CLASS="refnamediv"
  59389. ><A
  59390. NAME="AEN12059"
  59391. ></A
  59392. ><P
  59393. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59394. >cpdf_circle -- Draw a circle</DIV
  59395. ><DIV
  59396. CLASS="refsect1"
  59397. ><A
  59398. NAME="AEN12062"
  59399. ></A
  59400. ><H2
  59401. >Description</H2
  59402. >bool <B
  59403. CLASS="methodname"
  59404. >cpdf_circle</B
  59405. > ( int pdf_document, float x-coor, float y-coor, float radius [, int mode])<BR
  59406. ></BR
  59407. ><P
  59408. >      The <B
  59409. CLASS="function"
  59410. >cpdf_circle()</B
  59411. > function draws a circle with
  59412.      center at point 
  59413.      (<TT
  59414. CLASS="parameter"
  59415. ><I
  59416. >x-coor</I
  59417. ></TT
  59418. >, <TT
  59419. CLASS="parameter"
  59420. ><I
  59421. >y-coor</I
  59422. ></TT
  59423. >)
  59424.      and radius <TT
  59425. CLASS="parameter"
  59426. ><I
  59427. >radius</I
  59428. ></TT
  59429. >. Vracφ <TT
  59430. CLASS="constant"
  59431. ><B
  59432. >TRUE</B
  59433. ></TT
  59434. > p°i ·sp∞chu, <TT
  59435. CLASS="constant"
  59436. ><B
  59437. >FALSE</B
  59438. ></TT
  59439. > p°i selhßnφ.
  59440.     </P
  59441. ><P
  59442. >Nepovinn² parametr <TT
  59443. CLASS="parameter"
  59444. ><I
  59445. >mode</I
  59446. ></TT
  59447. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  59448. ><P
  59449. >      See also <A
  59450. HREF="#function.cpdf-arc"
  59451. ><B
  59452. CLASS="function"
  59453. >cpdf_arc()</B
  59454. ></A
  59455. >.
  59456.     </P
  59457. ></DIV
  59458. ><H1
  59459. ><A
  59460. NAME="function.cpdf-clip"
  59461. ></A
  59462. >cpdf_clip</H1
  59463. ><DIV
  59464. CLASS="refnamediv"
  59465. ><A
  59466. NAME="AEN12094"
  59467. ></A
  59468. ><P
  59469. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59470. >cpdf_clip -- Clips to current path</DIV
  59471. ><DIV
  59472. CLASS="refsect1"
  59473. ><A
  59474. NAME="AEN12097"
  59475. ></A
  59476. ><H2
  59477. >Description</H2
  59478. >bool <B
  59479. CLASS="methodname"
  59480. >cpdf_clip</B
  59481. > ( int pdf_document)<BR
  59482. ></BR
  59483. ><P
  59484. >      The <B
  59485. CLASS="function"
  59486. >cpdf_clip()</B
  59487. > function clips all drawing
  59488.      to the current path. Vracφ <TT
  59489. CLASS="constant"
  59490. ><B
  59491. >TRUE</B
  59492. ></TT
  59493. > p°i ·sp∞chu, <TT
  59494. CLASS="constant"
  59495. ><B
  59496. >FALSE</B
  59497. ></TT
  59498. > p°i selhßnφ.
  59499.     </P
  59500. ></DIV
  59501. ><H1
  59502. ><A
  59503. NAME="function.cpdf-close"
  59504. ></A
  59505. >cpdf_close</H1
  59506. ><DIV
  59507. CLASS="refnamediv"
  59508. ><A
  59509. NAME="AEN12110"
  59510. ></A
  59511. ><P
  59512. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59513. >cpdf_close -- Closes the pdf document</DIV
  59514. ><DIV
  59515. CLASS="refsect1"
  59516. ><A
  59517. NAME="AEN12113"
  59518. ></A
  59519. ><H2
  59520. >Description</H2
  59521. >bool <B
  59522. CLASS="methodname"
  59523. >cpdf_close</B
  59524. > ( int pdf_document)<BR
  59525. ></BR
  59526. ><P
  59527. >      The <B
  59528. CLASS="function"
  59529. >cpdf_close()</B
  59530. > function closes the pdf document.
  59531.      Vracφ <TT
  59532. CLASS="constant"
  59533. ><B
  59534. >TRUE</B
  59535. ></TT
  59536. > p°i ·sp∞chu, <TT
  59537. CLASS="constant"
  59538. ><B
  59539. >FALSE</B
  59540. ></TT
  59541. > p°i selhßnφ. This should be the last function even after
  59542.      <A
  59543. HREF="#function.cpdf-finalize"
  59544. ><B
  59545. CLASS="function"
  59546. >cpdf_finalize()</B
  59547. ></A
  59548. >, <A
  59549. HREF="#function.cpdf-output-buffer"
  59550. ><B
  59551. CLASS="function"
  59552. >cpdf_output_buffer()</B
  59553. ></A
  59554. >
  59555.      and <A
  59556. HREF="#function.cpdf-save-to-file"
  59557. ><B
  59558. CLASS="function"
  59559. >cpdf_save_to_file()</B
  59560. ></A
  59561. >.
  59562.     </P
  59563. ><P
  59564. >      See also <A
  59565. HREF="#function.cpdf-open"
  59566. ><B
  59567. CLASS="function"
  59568. >cpdf_open()</B
  59569. ></A
  59570. >.
  59571.     </P
  59572. ></DIV
  59573. ><H1
  59574. ><A
  59575. NAME="function.cpdf-closepath-fill-stroke"
  59576. ></A
  59577. >cpdf_closepath_fill_stroke</H1
  59578. ><DIV
  59579. CLASS="refnamediv"
  59580. ><A
  59581. NAME="AEN12131"
  59582. ></A
  59583. ><P
  59584. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59585. >cpdf_closepath_fill_stroke -- Close, fill and stroke current path</DIV
  59586. ><DIV
  59587. CLASS="refsect1"
  59588. ><A
  59589. NAME="AEN12134"
  59590. ></A
  59591. ><H2
  59592. >Description</H2
  59593. >bool <B
  59594. CLASS="methodname"
  59595. >cpdf_closepath_fill_stroke</B
  59596. > ( int pdf_document)<BR
  59597. ></BR
  59598. ><P
  59599. >      The <B
  59600. CLASS="function"
  59601. >cpdf_closepath_fill_stroke()</B
  59602. > function closes,
  59603.      fills the interior of the current path with the current fill color and
  59604.      draws current path. Vracφ <TT
  59605. CLASS="constant"
  59606. ><B
  59607. >TRUE</B
  59608. ></TT
  59609. > p°i ·sp∞chu, <TT
  59610. CLASS="constant"
  59611. ><B
  59612. >FALSE</B
  59613. ></TT
  59614. > p°i selhßnφ.
  59615.     </P
  59616. ><P
  59617. >      See also <A
  59618. HREF="#function.cpdf-closepath"
  59619. ><B
  59620. CLASS="function"
  59621. >cpdf_closepath()</B
  59622. ></A
  59623. >,
  59624.      <A
  59625. HREF="#function.cpdf-stroke"
  59626. ><B
  59627. CLASS="function"
  59628. >cpdf_stroke()</B
  59629. ></A
  59630. >,
  59631.      <A
  59632. HREF="#function.cpdf-fill"
  59633. ><B
  59634. CLASS="function"
  59635. >cpdf_fill()</B
  59636. ></A
  59637. >,
  59638.      <A
  59639. HREF="#function.cpdf-setgray-fill"
  59640. ><B
  59641. CLASS="function"
  59642. >cpdf_setgray_fill()</B
  59643. ></A
  59644. >,
  59645.      <A
  59646. HREF="#function.cpdf-setgray"
  59647. ><B
  59648. CLASS="function"
  59649. >cpdf_setgray()</B
  59650. ></A
  59651. >,
  59652.      <A
  59653. HREF="#function.cpdf-setrgbcolor-fill"
  59654. ><B
  59655. CLASS="function"
  59656. >cpdf_setrgbcolor_fill()</B
  59657. ></A
  59658. > and
  59659.      <A
  59660. HREF="#function.cpdf-setrgbcolor"
  59661. ><B
  59662. CLASS="function"
  59663. >cpdf_setrgbcolor()</B
  59664. ></A
  59665. >.
  59666.     </P
  59667. ></DIV
  59668. ><H1
  59669. ><A
  59670. NAME="function.cpdf-closepath-stroke"
  59671. ></A
  59672. >cpdf_closepath_stroke</H1
  59673. ><DIV
  59674. CLASS="refnamediv"
  59675. ><A
  59676. NAME="AEN12155"
  59677. ></A
  59678. ><P
  59679. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59680. >cpdf_closepath_stroke -- Close path and draw line along path</DIV
  59681. ><DIV
  59682. CLASS="refsect1"
  59683. ><A
  59684. NAME="AEN12158"
  59685. ></A
  59686. ><H2
  59687. >Description</H2
  59688. >bool <B
  59689. CLASS="methodname"
  59690. >cpdf_closepath_stroke</B
  59691. > ( int pdf_document)<BR
  59692. ></BR
  59693. ><P
  59694. >      The <B
  59695. CLASS="function"
  59696. >cpdf_closepath_stroke()</B
  59697. > function is a
  59698.      combination of <A
  59699. HREF="#function.cpdf-closepath"
  59700. ><B
  59701. CLASS="function"
  59702. >cpdf_closepath()</B
  59703. ></A
  59704. > and
  59705.      <A
  59706. HREF="#function.cpdf-stroke"
  59707. ><B
  59708. CLASS="function"
  59709. >cpdf_stroke()</B
  59710. ></A
  59711. >. Then clears the path.
  59712.      Vracφ <TT
  59713. CLASS="constant"
  59714. ><B
  59715. >TRUE</B
  59716. ></TT
  59717. > p°i ·sp∞chu, <TT
  59718. CLASS="constant"
  59719. ><B
  59720. >FALSE</B
  59721. ></TT
  59722. > p°i selhßnφ.
  59723.     </P
  59724. ><P
  59725. >      See also <A
  59726. HREF="#function.cpdf-closepath"
  59727. ><B
  59728. CLASS="function"
  59729. >cpdf_closepath()</B
  59730. ></A
  59731. > and
  59732.      <A
  59733. HREF="#function.cpdf-stroke"
  59734. ><B
  59735. CLASS="function"
  59736. >cpdf_stroke()</B
  59737. ></A
  59738. >.
  59739.     </P
  59740. ></DIV
  59741. ><H1
  59742. ><A
  59743. NAME="function.cpdf-closepath"
  59744. ></A
  59745. >cpdf_closepath</H1
  59746. ><DIV
  59747. CLASS="refnamediv"
  59748. ><A
  59749. NAME="AEN12176"
  59750. ></A
  59751. ><P
  59752. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59753. >cpdf_closepath -- Close path</DIV
  59754. ><DIV
  59755. CLASS="refsect1"
  59756. ><A
  59757. NAME="AEN12179"
  59758. ></A
  59759. ><H2
  59760. >Description</H2
  59761. >bool <B
  59762. CLASS="methodname"
  59763. >cpdf_closepath</B
  59764. > ( int pdf_document)<BR
  59765. ></BR
  59766. ><P
  59767. >      The <B
  59768. CLASS="function"
  59769. >cpdf_closepath()</B
  59770. > function closes the
  59771.      current path. Vracφ <TT
  59772. CLASS="constant"
  59773. ><B
  59774. >TRUE</B
  59775. ></TT
  59776. > p°i ·sp∞chu, <TT
  59777. CLASS="constant"
  59778. ><B
  59779. >FALSE</B
  59780. ></TT
  59781. > p°i selhßnφ.
  59782.     </P
  59783. ></DIV
  59784. ><H1
  59785. ><A
  59786. NAME="function.cpdf-continue-text"
  59787. ></A
  59788. >cpdf_continue_text</H1
  59789. ><DIV
  59790. CLASS="refnamediv"
  59791. ><A
  59792. NAME="AEN12192"
  59793. ></A
  59794. ><P
  59795. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59796. >cpdf_continue_text -- Output text in next line</DIV
  59797. ><DIV
  59798. CLASS="refsect1"
  59799. ><A
  59800. NAME="AEN12195"
  59801. ></A
  59802. ><H2
  59803. >Description</H2
  59804. >bool <B
  59805. CLASS="methodname"
  59806. >cpdf_continue_text</B
  59807. > ( int pdf_document, string text)<BR
  59808. ></BR
  59809. ><P
  59810. >      The <B
  59811. CLASS="function"
  59812. >cpdf_continue_text()</B
  59813. > function outputs the
  59814.      string in <TT
  59815. CLASS="parameter"
  59816. ><I
  59817. >text</I
  59818. ></TT
  59819. > in the next line. Vracφ <TT
  59820. CLASS="constant"
  59821. ><B
  59822. >TRUE</B
  59823. ></TT
  59824. > p°i ·sp∞chu, <TT
  59825. CLASS="constant"
  59826. ><B
  59827. >FALSE</B
  59828. ></TT
  59829. > p°i selhßnφ.
  59830.     </P
  59831. ><P
  59832. >      See also <A
  59833. HREF="#function.cpdf-show-xy"
  59834. ><B
  59835. CLASS="function"
  59836. >cpdf_show_xy()</B
  59837. ></A
  59838. >,
  59839.      <A
  59840. HREF="#function.cpdf-text"
  59841. ><B
  59842. CLASS="function"
  59843. >cpdf_text()</B
  59844. ></A
  59845. >,
  59846.      <A
  59847. HREF="#function.cpdf-set-leading"
  59848. ><B
  59849. CLASS="function"
  59850. >cpdf_set_leading()</B
  59851. ></A
  59852. > and
  59853.      <A
  59854. HREF="#function.cpdf-set-text-pos"
  59855. ><B
  59856. CLASS="function"
  59857. >cpdf_set_text_pos()</B
  59858. ></A
  59859. >.
  59860.     </P
  59861. ></DIV
  59862. ><H1
  59863. ><A
  59864. NAME="function.cpdf-curveto"
  59865. ></A
  59866. >cpdf_curveto</H1
  59867. ><DIV
  59868. CLASS="refnamediv"
  59869. ><A
  59870. NAME="AEN12217"
  59871. ></A
  59872. ><P
  59873. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59874. >cpdf_curveto -- Draws a curve</DIV
  59875. ><DIV
  59876. CLASS="refsect1"
  59877. ><A
  59878. NAME="AEN12220"
  59879. ></A
  59880. ><H2
  59881. >Description</H2
  59882. >bool <B
  59883. CLASS="methodname"
  59884. >cpdf_curveto</B
  59885. > ( int pdf_document, float x1, float y1, float x2, float y2, float x3, float y3 [, int mode])<BR
  59886. ></BR
  59887. ><P
  59888. >      The <B
  59889. CLASS="function"
  59890. >cpdf_curveto()</B
  59891. > function draws a Bezier curve
  59892.      from the current point to the point
  59893.      (<TT
  59894. CLASS="parameter"
  59895. ><I
  59896. >x3</I
  59897. ></TT
  59898. >, <TT
  59899. CLASS="parameter"
  59900. ><I
  59901. >y3</I
  59902. ></TT
  59903. >) using
  59904.      (<TT
  59905. CLASS="parameter"
  59906. ><I
  59907. >x1</I
  59908. ></TT
  59909. >, <TT
  59910. CLASS="parameter"
  59911. ><I
  59912. >y1</I
  59913. ></TT
  59914. >) and
  59915.      (<TT
  59916. CLASS="parameter"
  59917. ><I
  59918. >x2</I
  59919. ></TT
  59920. >, <TT
  59921. CLASS="parameter"
  59922. ><I
  59923. >y2</I
  59924. ></TT
  59925. >) as control
  59926.      points. Vracφ <TT
  59927. CLASS="constant"
  59928. ><B
  59929. >TRUE</B
  59930. ></TT
  59931. > p°i ·sp∞chu, <TT
  59932. CLASS="constant"
  59933. ><B
  59934. >FALSE</B
  59935. ></TT
  59936. > p°i selhßnφ.
  59937.     </P
  59938. ><P
  59939. >Nepovinn² parametr <TT
  59940. CLASS="parameter"
  59941. ><I
  59942. >mode</I
  59943. ></TT
  59944. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  59945. ><P
  59946. >      See also <A
  59947. HREF="#function.cpdf-moveto"
  59948. ><B
  59949. CLASS="function"
  59950. >cpdf_moveto()</B
  59951. ></A
  59952. >,
  59953.      <A
  59954. HREF="#function.cpdf-rmoveto"
  59955. ><B
  59956. CLASS="function"
  59957. >cpdf_rmoveto()</B
  59958. ></A
  59959. >,
  59960.      <A
  59961. HREF="#function.cpdf-rlineto"
  59962. ><B
  59963. CLASS="function"
  59964. >cpdf_rlineto()</B
  59965. ></A
  59966. > and
  59967.      <A
  59968. HREF="#function.cpdf-lineto"
  59969. ><B
  59970. CLASS="function"
  59971. >cpdf_lineto()</B
  59972. ></A
  59973. >.
  59974.     </P
  59975. ></DIV
  59976. ><H1
  59977. ><A
  59978. NAME="function.cpdf-end-text"
  59979. ></A
  59980. >cpdf_end_text</H1
  59981. ><DIV
  59982. CLASS="refnamediv"
  59983. ><A
  59984. NAME="AEN12267"
  59985. ></A
  59986. ><P
  59987. >    (PHP 3>= 3.0.8, PHP 4 )</P
  59988. >cpdf_end_text -- Ends text section</DIV
  59989. ><DIV
  59990. CLASS="refsect1"
  59991. ><A
  59992. NAME="AEN12270"
  59993. ></A
  59994. ><H2
  59995. >Description</H2
  59996. >bool <B
  59997. CLASS="methodname"
  59998. >cpdf_end_text</B
  59999. > ( int pdf_document)<BR
  60000. ></BR
  60001. ><P
  60002. >      The <B
  60003. CLASS="function"
  60004. >cpdf_end_text()</B
  60005. > function ends a text
  60006.      section which was started with <A
  60007. HREF="#function.cpdf-begin-text"
  60008. ><B
  60009. CLASS="function"
  60010. >cpdf_begin_text()</B
  60011. ></A
  60012. >.
  60013.      Vracφ <TT
  60014. CLASS="constant"
  60015. ><B
  60016. >TRUE</B
  60017. ></TT
  60018. > p°i ·sp∞chu, <TT
  60019. CLASS="constant"
  60020. ><B
  60021. >FALSE</B
  60022. ></TT
  60023. > p°i selhßnφ.
  60024.     </P
  60025. ><P
  60026. >      <TABLE
  60027. WIDTH="100%"
  60028. BORDER="0"
  60029. CELLPADDING="0"
  60030. CELLSPACING="0"
  60031. CLASS="EXAMPLE"
  60032. ><TR
  60033. ><TD
  60034. ><DIV
  60035. CLASS="example"
  60036. ><A
  60037. NAME="AEN12284"
  60038. ></A
  60039. ><P
  60040. ><B
  60041. >P°φklad 1. Text output</B
  60042. ></P
  60043. ><TABLE
  60044. BORDER="0"
  60045. BGCOLOR="#E0E0E0"
  60046. CELLPADDING="5"
  60047. ><TR
  60048. ><TD
  60049. ><PRE
  60050. CLASS="php"
  60051. ><?php
  60052. cpdf_begin_text($pdf);
  60053. cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding");
  60054. cpdf_text($pdf, 100, 100, "Some text");
  60055. cpdf_end_text($pdf)
  60056. ?></PRE
  60057. ></TD
  60058. ></TR
  60059. ></TABLE
  60060. ></DIV
  60061. ></TD
  60062. ></TR
  60063. ></TABLE
  60064. >
  60065.     </P
  60066. ><P
  60067. >      See also <A
  60068. HREF="#function.cpdf-begin-text"
  60069. ><B
  60070. CLASS="function"
  60071. >cpdf_begin_text()</B
  60072. ></A
  60073. >.
  60074.     </P
  60075. ></DIV
  60076. ><H1
  60077. ><A
  60078. NAME="function.cpdf-fill-stroke"
  60079. ></A
  60080. >cpdf_fill_stroke</H1
  60081. ><DIV
  60082. CLASS="refnamediv"
  60083. ><A
  60084. NAME="AEN12290"
  60085. ></A
  60086. ><P
  60087. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60088. >cpdf_fill_stroke -- Fill and stroke current path</DIV
  60089. ><DIV
  60090. CLASS="refsect1"
  60091. ><A
  60092. NAME="AEN12293"
  60093. ></A
  60094. ><H2
  60095. >Description</H2
  60096. >bool <B
  60097. CLASS="methodname"
  60098. >cpdf_fill_stroke</B
  60099. > ( int pdf_document)<BR
  60100. ></BR
  60101. ><P
  60102. >      The <B
  60103. CLASS="function"
  60104. >cpdf_fill_stroke()</B
  60105. > function fills the interior of
  60106.      the current path with the current fill color and draws current path.
  60107.      Vracφ <TT
  60108. CLASS="constant"
  60109. ><B
  60110. >TRUE</B
  60111. ></TT
  60112. > p°i ·sp∞chu, <TT
  60113. CLASS="constant"
  60114. ><B
  60115. >FALSE</B
  60116. ></TT
  60117. > p°i selhßnφ.
  60118.     </P
  60119. ><P
  60120. >      See also <A
  60121. HREF="#function.cpdf-closepath"
  60122. ><B
  60123. CLASS="function"
  60124. >cpdf_closepath()</B
  60125. ></A
  60126. >,
  60127.      <A
  60128. HREF="#function.cpdf-stroke"
  60129. ><B
  60130. CLASS="function"
  60131. >cpdf_stroke()</B
  60132. ></A
  60133. >,
  60134.      <A
  60135. HREF="#function.cpdf-fill"
  60136. ><B
  60137. CLASS="function"
  60138. >cpdf_fill()</B
  60139. ></A
  60140. >,
  60141.      <A
  60142. HREF="#function.cpdf-setgray-fill"
  60143. ><B
  60144. CLASS="function"
  60145. >cpdf_setgray_fill()</B
  60146. ></A
  60147. >,
  60148.      <A
  60149. HREF="#function.cpdf-setgray"
  60150. ><B
  60151. CLASS="function"
  60152. >cpdf_setgray()</B
  60153. ></A
  60154. >,
  60155.      <A
  60156. HREF="#function.cpdf-setrgbcolor-fill"
  60157. ><B
  60158. CLASS="function"
  60159. >cpdf_setrgbcolor_fill()</B
  60160. ></A
  60161. > and
  60162.      <A
  60163. HREF="#function.cpdf-setrgbcolor"
  60164. ><B
  60165. CLASS="function"
  60166. >cpdf_setrgbcolor()</B
  60167. ></A
  60168. >.
  60169.     </P
  60170. ></DIV
  60171. ><H1
  60172. ><A
  60173. NAME="function.cpdf-fill"
  60174. ></A
  60175. >cpdf_fill</H1
  60176. ><DIV
  60177. CLASS="refnamediv"
  60178. ><A
  60179. NAME="AEN12314"
  60180. ></A
  60181. ><P
  60182. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60183. >cpdf_fill -- Fill current path</DIV
  60184. ><DIV
  60185. CLASS="refsect1"
  60186. ><A
  60187. NAME="AEN12317"
  60188. ></A
  60189. ><H2
  60190. >Description</H2
  60191. >bool <B
  60192. CLASS="methodname"
  60193. >cpdf_fill</B
  60194. > ( int pdf_document)<BR
  60195. ></BR
  60196. ><P
  60197. >      The <B
  60198. CLASS="function"
  60199. >cpdf_fill()</B
  60200. > function fills the interior of
  60201.      the current path with the current fill color. Vracφ <TT
  60202. CLASS="constant"
  60203. ><B
  60204. >TRUE</B
  60205. ></TT
  60206. > p°i ·sp∞chu, <TT
  60207. CLASS="constant"
  60208. ><B
  60209. >FALSE</B
  60210. ></TT
  60211. > p°i selhßnφ.
  60212.     </P
  60213. ><P
  60214. >      See also <A
  60215. HREF="#function.cpdf-closepath"
  60216. ><B
  60217. CLASS="function"
  60218. >cpdf_closepath()</B
  60219. ></A
  60220. >,
  60221.      <A
  60222. HREF="#function.cpdf-stroke"
  60223. ><B
  60224. CLASS="function"
  60225. >cpdf_stroke()</B
  60226. ></A
  60227. >,
  60228.      <A
  60229. HREF="#function.cpdf-setgray-fill"
  60230. ><B
  60231. CLASS="function"
  60232. >cpdf_setgray_fill()</B
  60233. ></A
  60234. >,
  60235.      <A
  60236. HREF="#function.cpdf-setgray"
  60237. ><B
  60238. CLASS="function"
  60239. >cpdf_setgray()</B
  60240. ></A
  60241. >,
  60242.      <A
  60243. HREF="#function.cpdf-setrgbcolor-fill"
  60244. ><B
  60245. CLASS="function"
  60246. >cpdf_setrgbcolor_fill()</B
  60247. ></A
  60248. > and
  60249.      <A
  60250. HREF="#function.cpdf-setrgbcolor"
  60251. ><B
  60252. CLASS="function"
  60253. >cpdf_setrgbcolor()</B
  60254. ></A
  60255. >.
  60256.     </P
  60257. ></DIV
  60258. ><H1
  60259. ><A
  60260. NAME="function.cpdf-finalize-page"
  60261. ></A
  60262. >cpdf_finalize_page</H1
  60263. ><DIV
  60264. CLASS="refnamediv"
  60265. ><A
  60266. NAME="AEN12337"
  60267. ></A
  60268. ><P
  60269. >    (PHP 3>= 3.0.10, PHP 4 )</P
  60270. >cpdf_finalize_page -- Ends page</DIV
  60271. ><DIV
  60272. CLASS="refsect1"
  60273. ><A
  60274. NAME="AEN12340"
  60275. ></A
  60276. ><H2
  60277. >Description</H2
  60278. >bool <B
  60279. CLASS="methodname"
  60280. >cpdf_finalize_page</B
  60281. > ( int pdf_document, int page_number)<BR
  60282. ></BR
  60283. ><P
  60284. >      The <B
  60285. CLASS="function"
  60286. >cpdf_finalize_page()</B
  60287. > function ends the page
  60288.      with page number <TT
  60289. CLASS="parameter"
  60290. ><I
  60291. >page_number</I
  60292. ></TT
  60293. >. Vracφ <TT
  60294. CLASS="constant"
  60295. ><B
  60296. >TRUE</B
  60297. ></TT
  60298. > p°i ·sp∞chu, <TT
  60299. CLASS="constant"
  60300. ><B
  60301. >FALSE</B
  60302. ></TT
  60303. > p°i selhßnφ.
  60304.     </P
  60305. ><P
  60306. >      This function is only for saving memory. A finalized page takes
  60307.      less memory but cannot be modified anymore.
  60308.     </P
  60309. ><P
  60310. >      See also <A
  60311. HREF="#function.cpdf-page-init"
  60312. ><B
  60313. CLASS="function"
  60314. >cpdf_page_init()</B
  60315. ></A
  60316. >.
  60317.     </P
  60318. ></DIV
  60319. ><H1
  60320. ><A
  60321. NAME="function.cpdf-finalize"
  60322. ></A
  60323. >cpdf_finalize</H1
  60324. ><DIV
  60325. CLASS="refnamediv"
  60326. ><A
  60327. NAME="AEN12360"
  60328. ></A
  60329. ><P
  60330. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60331. >cpdf_finalize -- Ends document</DIV
  60332. ><DIV
  60333. CLASS="refsect1"
  60334. ><A
  60335. NAME="AEN12363"
  60336. ></A
  60337. ><H2
  60338. >Description</H2
  60339. >bool <B
  60340. CLASS="methodname"
  60341. >cpdf_finalize</B
  60342. > ( int pdf_document)<BR
  60343. ></BR
  60344. ><P
  60345. >      The <B
  60346. CLASS="function"
  60347. >cpdf_finalize()</B
  60348. > function ends the document.
  60349.      You still have to call <A
  60350. HREF="#function.cpdf-close"
  60351. ><B
  60352. CLASS="function"
  60353. >cpdf_close()</B
  60354. ></A
  60355. >. Vracφ <TT
  60356. CLASS="constant"
  60357. ><B
  60358. >TRUE</B
  60359. ></TT
  60360. > p°i ·sp∞chu, <TT
  60361. CLASS="constant"
  60362. ><B
  60363. >FALSE</B
  60364. ></TT
  60365. > p°i selhßnφ.
  60366.     </P
  60367. ><P
  60368. >      See also <A
  60369. HREF="#function.cpdf-close"
  60370. ><B
  60371. CLASS="function"
  60372. >cpdf_close()</B
  60373. ></A
  60374. >.
  60375.     </P
  60376. ></DIV
  60377. ><H1
  60378. ><A
  60379. NAME="function.cpdf-global-set-document-limits"
  60380. ></A
  60381. >cpdf_global_set_document_limits</H1
  60382. ><DIV
  60383. CLASS="refnamediv"
  60384. ><A
  60385. NAME="AEN12379"
  60386. ></A
  60387. ><P
  60388. >    (PHP 4 )</P
  60389. >cpdf_global_set_document_limits -- Sets document limits for any pdf document</DIV
  60390. ><DIV
  60391. CLASS="refsect1"
  60392. ><A
  60393. NAME="AEN12382"
  60394. ></A
  60395. ><H2
  60396. >Description</H2
  60397. >bool <B
  60398. CLASS="methodname"
  60399. >cpdf_global_set_document_limits</B
  60400. > ( int maxpages, int maxfonts, int maximages, int maxannotations, int maxobjects)<BR
  60401. ></BR
  60402. ><P
  60403. >      The <B
  60404. CLASS="function"
  60405. >cpdf_global_set_document_limits()</B
  60406. > function sets
  60407.      several document limits. This function has to be called before
  60408.      <A
  60409. HREF="#function.cpdf-open"
  60410. ><B
  60411. CLASS="function"
  60412. >cpdf_open()</B
  60413. ></A
  60414. > to take effect. It sets the limits
  60415.      for any document open afterwards. Vracφ <TT
  60416. CLASS="constant"
  60417. ><B
  60418. >TRUE</B
  60419. ></TT
  60420. > p°i ·sp∞chu, <TT
  60421. CLASS="constant"
  60422. ><B
  60423. >FALSE</B
  60424. ></TT
  60425. > p°i selhßnφ.
  60426.     </P
  60427. ><P
  60428. >      See also <A
  60429. HREF="#function.cpdf-open"
  60430. ><B
  60431. CLASS="function"
  60432. >cpdf_open()</B
  60433. ></A
  60434. >.
  60435.     </P
  60436. ></DIV
  60437. ><H1
  60438. ><A
  60439. NAME="function.cpdf-import-jpeg"
  60440. ></A
  60441. >cpdf_import_jpeg</H1
  60442. ><DIV
  60443. CLASS="refnamediv"
  60444. ><A
  60445. NAME="AEN12410"
  60446. ></A
  60447. ><P
  60448. >    (PHP 3>= 3.0.9, PHP 4 )</P
  60449. >cpdf_import_jpeg -- Opens a JPEG image</DIV
  60450. ><DIV
  60451. CLASS="refsect1"
  60452. ><A
  60453. NAME="AEN12413"
  60454. ></A
  60455. ><H2
  60456. >Description</H2
  60457. >int <B
  60458. CLASS="methodname"
  60459. >cpdf_import_jpeg</B
  60460. > ( int pdf_document, string file_name, float x-coor, float y-coor, float angle, float width, float height, float x-scale, float y-scale, int gsave [, int mode])<BR
  60461. ></BR
  60462. ><P
  60463. >      The <B
  60464. CLASS="function"
  60465. >cpdf_import_jpeg()</B
  60466. > function opens an image
  60467.      stored in the file with the name <TT
  60468. CLASS="parameter"
  60469. ><I
  60470. >file
  60471.      name</I
  60472. ></TT
  60473. >.  The format of the image has to be jpeg. The
  60474.      image is placed on the current page at position
  60475.      (<TT
  60476. CLASS="parameter"
  60477. ><I
  60478. >x-coor</I
  60479. ></TT
  60480. >, <TT
  60481. CLASS="parameter"
  60482. ><I
  60483. >y-coor</I
  60484. ></TT
  60485. >).
  60486.      The image is rotated by <TT
  60487. CLASS="parameter"
  60488. ><I
  60489. >angle</I
  60490. ></TT
  60491. > degrees.
  60492.      <TT
  60493. CLASS="parameter"
  60494. ><I
  60495. >gsave</I
  60496. ></TT
  60497. > should be non-zero to allow this
  60498.      function to operate correctly.
  60499.     </P
  60500. ><P
  60501. >Nepovinn² parametr <TT
  60502. CLASS="parameter"
  60503. ><I
  60504. >mode</I
  60505. ></TT
  60506. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  60507. ><P
  60508. >      See also <A
  60509. HREF="#function.cpdf-place-inline-image"
  60510. ><B
  60511. CLASS="function"
  60512. >cpdf_place_inline_image()</B
  60513. ></A
  60514. >.
  60515.     </P
  60516. ></DIV
  60517. ><H1
  60518. ><A
  60519. NAME="function.cpdf-lineto"
  60520. ></A
  60521. >cpdf_lineto</H1
  60522. ><DIV
  60523. CLASS="refnamediv"
  60524. ><A
  60525. NAME="AEN12463"
  60526. ></A
  60527. ><P
  60528. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60529. >cpdf_lineto -- Draws a line</DIV
  60530. ><DIV
  60531. CLASS="refsect1"
  60532. ><A
  60533. NAME="AEN12466"
  60534. ></A
  60535. ><H2
  60536. >Description</H2
  60537. >bool <B
  60538. CLASS="methodname"
  60539. >cpdf_lineto</B
  60540. > ( int pdf_document, float x-coor, float y-coor [, int mode])<BR
  60541. ></BR
  60542. ><P
  60543. >      The <B
  60544. CLASS="function"
  60545. >cpdf_lineto()</B
  60546. > function draws a line from
  60547.      the current point to the point with coordinates
  60548.      (<TT
  60549. CLASS="parameter"
  60550. ><I
  60551. >x-coor</I
  60552. ></TT
  60553. >, <TT
  60554. CLASS="parameter"
  60555. ><I
  60556. >y-coor</I
  60557. ></TT
  60558. >).
  60559.      Vracφ <TT
  60560. CLASS="constant"
  60561. ><B
  60562. >TRUE</B
  60563. ></TT
  60564. > p°i ·sp∞chu, <TT
  60565. CLASS="constant"
  60566. ><B
  60567. >FALSE</B
  60568. ></TT
  60569. > p°i selhßnφ.
  60570.     </P
  60571. ><P
  60572. >Nepovinn² parametr <TT
  60573. CLASS="parameter"
  60574. ><I
  60575. >mode</I
  60576. ></TT
  60577. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  60578. ><P
  60579. >      See also <A
  60580. HREF="#function.cpdf-moveto"
  60581. ><B
  60582. CLASS="function"
  60583. >cpdf_moveto()</B
  60584. ></A
  60585. >,
  60586.      <A
  60587. HREF="#function.cpdf-rmoveto"
  60588. ><B
  60589. CLASS="function"
  60590. >cpdf_rmoveto()</B
  60591. ></A
  60592. > and
  60593.      <A
  60594. HREF="#function.cpdf-curveto"
  60595. ><B
  60596. CLASS="function"
  60597. >cpdf_curveto()</B
  60598. ></A
  60599. >.
  60600.     </P
  60601. ></DIV
  60602. ><H1
  60603. ><A
  60604. NAME="function.cpdf-moveto"
  60605. ></A
  60606. >cpdf_moveto</H1
  60607. ><DIV
  60608. CLASS="refnamediv"
  60609. ><A
  60610. NAME="AEN12496"
  60611. ></A
  60612. ><P
  60613. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60614. >cpdf_moveto -- Sets current point</DIV
  60615. ><DIV
  60616. CLASS="refsect1"
  60617. ><A
  60618. NAME="AEN12499"
  60619. ></A
  60620. ><H2
  60621. >Description</H2
  60622. >bool <B
  60623. CLASS="methodname"
  60624. >cpdf_moveto</B
  60625. > ( int pdf_document, float x-coor, float y-coor [, int mode])<BR
  60626. ></BR
  60627. ><P
  60628. >      The <B
  60629. CLASS="function"
  60630. >cpdf_moveto()</B
  60631. > function set the current
  60632.      point to the coordinates <TT
  60633. CLASS="parameter"
  60634. ><I
  60635. >x-coor</I
  60636. ></TT
  60637. > and
  60638.      <TT
  60639. CLASS="parameter"
  60640. ><I
  60641. >y-coor</I
  60642. ></TT
  60643. >. Vracφ <TT
  60644. CLASS="constant"
  60645. ><B
  60646. >TRUE</B
  60647. ></TT
  60648. > p°i ·sp∞chu, <TT
  60649. CLASS="constant"
  60650. ><B
  60651. >FALSE</B
  60652. ></TT
  60653. > p°i selhßnφ.
  60654.     </P
  60655. ><P
  60656. >Nepovinn² parametr <TT
  60657. CLASS="parameter"
  60658. ><I
  60659. >mode</I
  60660. ></TT
  60661. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  60662. ></DIV
  60663. ><H1
  60664. ><A
  60665. NAME="function.cpdf-newpath"
  60666. ></A
  60667. >cpdf_newpath</H1
  60668. ><DIV
  60669. CLASS="refnamediv"
  60670. ><A
  60671. NAME="AEN12525"
  60672. ></A
  60673. ><P
  60674. >    (PHP 3>= 3.0.9, PHP 4 )</P
  60675. >cpdf_newpath -- Starts a new path</DIV
  60676. ><DIV
  60677. CLASS="refsect1"
  60678. ><A
  60679. NAME="AEN12528"
  60680. ></A
  60681. ><H2
  60682. >Description</H2
  60683. >bool <B
  60684. CLASS="methodname"
  60685. >cpdf_newpath</B
  60686. > ( int pdf_document)<BR
  60687. ></BR
  60688. ><P
  60689. >      The <B
  60690. CLASS="function"
  60691. >cpdf_newpath()</B
  60692. > starts a new path on the
  60693.      document given by the <TT
  60694. CLASS="parameter"
  60695. ><I
  60696. >pdf_document</I
  60697. ></TT
  60698. >
  60699.      parameter. Vracφ <TT
  60700. CLASS="constant"
  60701. ><B
  60702. >TRUE</B
  60703. ></TT
  60704. > p°i ·sp∞chu, <TT
  60705. CLASS="constant"
  60706. ><B
  60707. >FALSE</B
  60708. ></TT
  60709. > p°i selhßnφ.
  60710.     </P
  60711. ></DIV
  60712. ><H1
  60713. ><A
  60714. NAME="function.cpdf-open"
  60715. ></A
  60716. >cpdf_open</H1
  60717. ><DIV
  60718. CLASS="refnamediv"
  60719. ><A
  60720. NAME="AEN12542"
  60721. ></A
  60722. ><P
  60723. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60724. >cpdf_open -- Opens a new pdf document</DIV
  60725. ><DIV
  60726. CLASS="refsect1"
  60727. ><A
  60728. NAME="AEN12545"
  60729. ></A
  60730. ><H2
  60731. >Description</H2
  60732. >int <B
  60733. CLASS="methodname"
  60734. >cpdf_open</B
  60735. > ( int compression [, string filename])<BR
  60736. ></BR
  60737. ><P
  60738. >      The <B
  60739. CLASS="function"
  60740. >cpdf_open()</B
  60741. > function opens
  60742.      a new pdf document. The first parameter turns document compression
  60743.      on if it is unequal to 0. The second optional parameter sets the
  60744.      file in which the document is written. If it is omitted the document
  60745.      is created in memory and can either be written into a file with
  60746.      the <A
  60747. HREF="#function.cpdf-save-to-file"
  60748. ><B
  60749. CLASS="function"
  60750. >cpdf_save_to_file()</B
  60751. ></A
  60752. > or written to standard
  60753.      output with <A
  60754. HREF="#function.cpdf-output-buffer"
  60755. ><B
  60756. CLASS="function"
  60757. >cpdf_output_buffer()</B
  60758. ></A
  60759. >.
  60760.      <DIV
  60761. CLASS="note"
  60762. ><BLOCKQUOTE
  60763. CLASS="note"
  60764. ><P
  60765. ><B
  60766. >Poznßmka: </B
  60767. >
  60768.        The return value will be needed in further versions of ClibPDF
  60769.        as the first parameter in all other functions which are writing
  60770.        to the pdf document.
  60771.       </P
  60772. ><P
  60773. >        The ClibPDF library takes the filename "-" as a synonym for
  60774.        stdout. If PHP is compiled as an apache module this will not
  60775.        work because the way ClibPDF outputs to stdout does not work
  60776.        with apache. You can solve this problem by skipping the
  60777.        filename and using <A
  60778. HREF="#function.cpdf-output-buffer"
  60779. ><B
  60780. CLASS="function"
  60781. >cpdf_output_buffer()</B
  60782. ></A
  60783. > to
  60784.        output the pdf document.
  60785.       </P
  60786. ></BLOCKQUOTE
  60787. ></DIV
  60788. >
  60789.     </P
  60790. ><P
  60791. >      See also <A
  60792. HREF="#function.cpdf-close"
  60793. ><B
  60794. CLASS="function"
  60795. >cpdf_close()</B
  60796. ></A
  60797. > and
  60798.      <A
  60799. HREF="#function.cpdf-output-buffer"
  60800. ><B
  60801. CLASS="function"
  60802. >cpdf_output_buffer()</B
  60803. ></A
  60804. >.
  60805.     </P
  60806. ></DIV
  60807. ><H1
  60808. ><A
  60809. NAME="function.cpdf-output-buffer"
  60810. ></A
  60811. >cpdf_output_buffer</H1
  60812. ><DIV
  60813. CLASS="refnamediv"
  60814. ><A
  60815. NAME="AEN12568"
  60816. ></A
  60817. ><P
  60818. >    (PHP 3>= 3.0.9, PHP 4 )</P
  60819. >cpdf_output_buffer -- Outputs the pdf document in memory buffer</DIV
  60820. ><DIV
  60821. CLASS="refsect1"
  60822. ><A
  60823. NAME="AEN12571"
  60824. ></A
  60825. ><H2
  60826. >Description</H2
  60827. >bool <B
  60828. CLASS="methodname"
  60829. >cpdf_output_buffer</B
  60830. > ( int pdf_document)<BR
  60831. ></BR
  60832. ><P
  60833. >      The <B
  60834. CLASS="function"
  60835. >cpdf_output_buffer()</B
  60836. > function outputs
  60837.      the pdf document to stdout. The document has to be created in memory which
  60838.      is the case if <A
  60839. HREF="#function.cpdf-open"
  60840. ><B
  60841. CLASS="function"
  60842. >cpdf_open()</B
  60843. ></A
  60844. > has been called with
  60845.      no filename parameter. Vracφ <TT
  60846. CLASS="constant"
  60847. ><B
  60848. >TRUE</B
  60849. ></TT
  60850. > p°i ·sp∞chu, <TT
  60851. CLASS="constant"
  60852. ><B
  60853. >FALSE</B
  60854. ></TT
  60855. > p°i selhßnφ.
  60856.     </P
  60857. ><P
  60858. >      See also <A
  60859. HREF="#function.cpdf-open"
  60860. ><B
  60861. CLASS="function"
  60862. >cpdf_open()</B
  60863. ></A
  60864. >.
  60865.     </P
  60866. ></DIV
  60867. ><H1
  60868. ><A
  60869. NAME="function.cpdf-page-init"
  60870. ></A
  60871. >cpdf_page_init</H1
  60872. ><DIV
  60873. CLASS="refnamediv"
  60874. ><A
  60875. NAME="AEN12587"
  60876. ></A
  60877. ><P
  60878. >    (PHP 3>= 3.0.8, PHP 4 )</P
  60879. >cpdf_page_init -- Starts new page</DIV
  60880. ><DIV
  60881. CLASS="refsect1"
  60882. ><A
  60883. NAME="AEN12590"
  60884. ></A
  60885. ><H2
  60886. >Description</H2
  60887. >bool <B
  60888. CLASS="methodname"
  60889. >cpdf_page_init</B
  60890. > ( int pdf_document, int page_number, int orientation, float height, float width [, float unit])<BR
  60891. ></BR
  60892. ><P
  60893. >      The <B
  60894. CLASS="function"
  60895. >cpdf_page_init()</B
  60896. > function starts a new
  60897.      page with height <TT
  60898. CLASS="parameter"
  60899. ><I
  60900. >height</I
  60901. ></TT
  60902. > and width
  60903.      <TT
  60904. CLASS="parameter"
  60905. ><I
  60906. >width</I
  60907. ></TT
  60908. >. Vracφ <TT
  60909. CLASS="constant"
  60910. ><B
  60911. >TRUE</B
  60912. ></TT
  60913. > p°i ·sp∞chu, <TT
  60914. CLASS="constant"
  60915. ><B
  60916. >FALSE</B
  60917. ></TT
  60918. > p°i selhßnφ. 
  60919.      The page has number <TT
  60920. CLASS="parameter"
  60921. ><I
  60922. >page_number</I
  60923. ></TT
  60924. > and orientation
  60925.      <TT
  60926. CLASS="parameter"
  60927. ><I
  60928. >orientation</I
  60929. ></TT
  60930. >. <TT
  60931. CLASS="parameter"
  60932. ><I
  60933. >orientation</I
  60934. ></TT
  60935. >
  60936.      can be 0 for portrait and 1 for landscape. The last optional parameter
  60937.      <TT
  60938. CLASS="parameter"
  60939. ><I
  60940. >unit</I
  60941. ></TT
  60942. > sets the unit for the coordinate system.
  60943.      The value should be the number of postscript points per unit. Since
  60944.      one inch is equal to 72 points, a value of 72 would set the unit
  60945.      to one inch. The default is also 72.
  60946.     </P
  60947. ><P
  60948. >      See also <A
  60949. HREF="#function.cpdf-set-current-page"
  60950. ><B
  60951. CLASS="function"
  60952. >cpdf_set_current_page()</B
  60953. ></A
  60954. >.
  60955.     </P
  60956. ></DIV
  60957. ><H1
  60958. ><A
  60959. NAME="function.cpdf-place-inline-image"
  60960. ></A
  60961. >cpdf_place_inline_image</H1
  60962. ><DIV
  60963. CLASS="refnamediv"
  60964. ><A
  60965. NAME="AEN12626"
  60966. ></A
  60967. ><P
  60968. >    (PHP 3>= 3.0.9, PHP 4 )</P
  60969. >cpdf_place_inline_image -- Places an image on the page</DIV
  60970. ><DIV
  60971. CLASS="refsect1"
  60972. ><A
  60973. NAME="AEN12629"
  60974. ></A
  60975. ><H2
  60976. >Description</H2
  60977. >bool <B
  60978. CLASS="methodname"
  60979. >cpdf_place_inline_image</B
  60980. > ( int pdf_document, int image, float x-coor, float y-coor, float angle, float width, float height [, int mode])<BR
  60981. ></BR
  60982. ><P
  60983. >      The <B
  60984. CLASS="function"
  60985. >cpdf_place_inline_image()</B
  60986. > function places
  60987.      an image created with the PHP image functions on the page at
  60988.      position (<TT
  60989. CLASS="parameter"
  60990. ><I
  60991. >x-coor</I
  60992. ></TT
  60993. >,
  60994.      <TT
  60995. CLASS="parameter"
  60996. ><I
  60997. >y-coor</I
  60998. ></TT
  60999. >). The image can be scaled at the
  61000.      same time. Vracφ <TT
  61001. CLASS="constant"
  61002. ><B
  61003. >TRUE</B
  61004. ></TT
  61005. > p°i ·sp∞chu, <TT
  61006. CLASS="constant"
  61007. ><B
  61008. >FALSE</B
  61009. ></TT
  61010. > p°i selhßnφ.
  61011.     </P
  61012. ><P
  61013. >Nepovinn² parametr <TT
  61014. CLASS="parameter"
  61015. ><I
  61016. >mode</I
  61017. ></TT
  61018. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  61019. ><P
  61020. >      See also <A
  61021. HREF="#function.cpdf-import-jpeg"
  61022. ><B
  61023. CLASS="function"
  61024. >cpdf_import_jpeg()</B
  61025. ></A
  61026. >.
  61027.     </P
  61028. ></DIV
  61029. ><H1
  61030. ><A
  61031. NAME="function.cpdf-rect"
  61032. ></A
  61033. >cpdf_rect</H1
  61034. ><DIV
  61035. CLASS="refnamediv"
  61036. ><A
  61037. NAME="AEN12669"
  61038. ></A
  61039. ><P
  61040. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61041. >cpdf_rect -- Draw a rectangle</DIV
  61042. ><DIV
  61043. CLASS="refsect1"
  61044. ><A
  61045. NAME="AEN12672"
  61046. ></A
  61047. ><H2
  61048. >Description</H2
  61049. >bool <B
  61050. CLASS="methodname"
  61051. >cpdf_rect</B
  61052. > ( int pdf_document, float x-coor, float y-coor, float width, float height [, int mode])<BR
  61053. ></BR
  61054. ><P
  61055. >      The <B
  61056. CLASS="function"
  61057. >cpdf_rect()</B
  61058. > function draws a rectangle with
  61059.      its lower left corner at point 
  61060.      (<TT
  61061. CLASS="parameter"
  61062. ><I
  61063. >x-coor</I
  61064. ></TT
  61065. >, <TT
  61066. CLASS="parameter"
  61067. ><I
  61068. >y-coor</I
  61069. ></TT
  61070. >).
  61071.      This width is set to <TT
  61072. CLASS="parameter"
  61073. ><I
  61074. >width</I
  61075. ></TT
  61076. >.
  61077.      This height is set to <TT
  61078. CLASS="parameter"
  61079. ><I
  61080. >height</I
  61081. ></TT
  61082. >. Vracφ <TT
  61083. CLASS="constant"
  61084. ><B
  61085. >TRUE</B
  61086. ></TT
  61087. > p°i ·sp∞chu, <TT
  61088. CLASS="constant"
  61089. ><B
  61090. >FALSE</B
  61091. ></TT
  61092. > p°i selhßnφ.
  61093.     </P
  61094. ><P
  61095. >Nepovinn² parametr <TT
  61096. CLASS="parameter"
  61097. ><I
  61098. >mode</I
  61099. ></TT
  61100. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  61101. ><P
  61102. >      <TABLE
  61103. WIDTH="100%"
  61104. BORDER="0"
  61105. CELLPADDING="0"
  61106. CELLSPACING="0"
  61107. CLASS="EXAMPLE"
  61108. ><TR
  61109. ><TD
  61110. ><DIV
  61111. CLASS="example"
  61112. ><A
  61113. NAME="AEN12706"
  61114. ></A
  61115. ><P
  61116. ><B
  61117. >P°φklad 1. Drawing a rectangle</B
  61118. ></P
  61119. ><TABLE
  61120. BORDER="0"
  61121. BGCOLOR="#E0E0E0"
  61122. CELLPADDING="5"
  61123. ><TR
  61124. ><TD
  61125. ><PRE
  61126. CLASS="php"
  61127. ><?php
  61128.  
  61129. $cpdf = cpdf_open(0);
  61130. cpdf_page_init($cpdf, 1, 0, 595, 842, 1.0);
  61131.  
  61132. // set the fill color to red
  61133. cpdf_setrgbcolor($cpdf, 1, 0, 0);
  61134.  
  61135. // draw a (180 * 100) rectangle
  61136. cpdf_rect($cpdf, 645, 400, 180, 100);
  61137.  
  61138. // fill the rectangle
  61139. cpdf_fill($cpdf);
  61140.  
  61141. cpdf_finalize($cpdf);
  61142. Header("Content-type: application/pdf");
  61143. cpdf_output_buffer($cpdf);
  61144. cpdf_close($cpdf);
  61145.  
  61146. ?></PRE
  61147. ></TD
  61148. ></TR
  61149. ></TABLE
  61150. ></DIV
  61151. ></TD
  61152. ></TR
  61153. ></TABLE
  61154. >
  61155.     </P
  61156. ></DIV
  61157. ><H1
  61158. ><A
  61159. NAME="function.cpdf-restore"
  61160. ></A
  61161. >cpdf_restore</H1
  61162. ><DIV
  61163. CLASS="refnamediv"
  61164. ><A
  61165. NAME="AEN12710"
  61166. ></A
  61167. ><P
  61168. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61169. >cpdf_restore -- Restores formerly saved environment</DIV
  61170. ><DIV
  61171. CLASS="refsect1"
  61172. ><A
  61173. NAME="AEN12713"
  61174. ></A
  61175. ><H2
  61176. >Description</H2
  61177. >bool <B
  61178. CLASS="methodname"
  61179. >cpdf_restore</B
  61180. > ( int pdf_document)<BR
  61181. ></BR
  61182. ><P
  61183. >      The <B
  61184. CLASS="function"
  61185. >cpdf_restore()</B
  61186. > function restores the
  61187.      environment saved with <A
  61188. HREF="#function.cpdf-save"
  61189. ><B
  61190. CLASS="function"
  61191. >cpdf_save()</B
  61192. ></A
  61193. >. It works
  61194.      like the postscript command grestore. Very useful if you want
  61195.      to translate or rotate an object without effecting other objects.
  61196.      Vracφ <TT
  61197. CLASS="constant"
  61198. ><B
  61199. >TRUE</B
  61200. ></TT
  61201. > p°i ·sp∞chu, <TT
  61202. CLASS="constant"
  61203. ><B
  61204. >FALSE</B
  61205. ></TT
  61206. > p°i selhßnφ.
  61207.     </P
  61208. ><P
  61209. >      <TABLE
  61210. WIDTH="100%"
  61211. BORDER="0"
  61212. CELLPADDING="0"
  61213. CELLSPACING="0"
  61214. CLASS="EXAMPLE"
  61215. ><TR
  61216. ><TD
  61217. ><DIV
  61218. CLASS="example"
  61219. ><A
  61220. NAME="AEN12727"
  61221. ></A
  61222. ><P
  61223. ><B
  61224. >P°φklad 1. Save/Restore</B
  61225. ></P
  61226. ><TABLE
  61227. BORDER="0"
  61228. BGCOLOR="#E0E0E0"
  61229. CELLPADDING="5"
  61230. ><TR
  61231. ><TD
  61232. ><PRE
  61233. CLASS="php"
  61234. ><?php
  61235. cpdf_save($pdf);
  61236. // do all kinds of rotations, transformations, ...
  61237. cpdf_restore($pdf)
  61238. ?></PRE
  61239. ></TD
  61240. ></TR
  61241. ></TABLE
  61242. ></DIV
  61243. ></TD
  61244. ></TR
  61245. ></TABLE
  61246. >
  61247.     </P
  61248. ><P
  61249. >      See also <A
  61250. HREF="#function.cpdf-save"
  61251. ><B
  61252. CLASS="function"
  61253. >cpdf_save()</B
  61254. ></A
  61255. >.
  61256.     </P
  61257. ></DIV
  61258. ><H1
  61259. ><A
  61260. NAME="function.cpdf-rlineto"
  61261. ></A
  61262. >cpdf_rlineto</H1
  61263. ><DIV
  61264. CLASS="refnamediv"
  61265. ><A
  61266. NAME="AEN12733"
  61267. ></A
  61268. ><P
  61269. >    (PHP 3>= 3.0.9, PHP 4 )</P
  61270. >cpdf_rlineto -- Draws a line</DIV
  61271. ><DIV
  61272. CLASS="refsect1"
  61273. ><A
  61274. NAME="AEN12736"
  61275. ></A
  61276. ><H2
  61277. >Description</H2
  61278. >bool <B
  61279. CLASS="methodname"
  61280. >cpdf_rlineto</B
  61281. > ( int pdf_document, float x-coor, float y-coor [, int mode])<BR
  61282. ></BR
  61283. ><P
  61284. >      The <B
  61285. CLASS="function"
  61286. >cpdf_rlineto()</B
  61287. > function draws a line from
  61288.      the current point to the relative point with coordinates
  61289.      (<TT
  61290. CLASS="parameter"
  61291. ><I
  61292. >x-coor</I
  61293. ></TT
  61294. >, <TT
  61295. CLASS="parameter"
  61296. ><I
  61297. >y-coor</I
  61298. ></TT
  61299. >).
  61300.      Vracφ <TT
  61301. CLASS="constant"
  61302. ><B
  61303. >TRUE</B
  61304. ></TT
  61305. > p°i ·sp∞chu, <TT
  61306. CLASS="constant"
  61307. ><B
  61308. >FALSE</B
  61309. ></TT
  61310. > p°i selhßnφ.
  61311.     </P
  61312. ><P
  61313. >Nepovinn² parametr <TT
  61314. CLASS="parameter"
  61315. ><I
  61316. >mode</I
  61317. ></TT
  61318. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  61319. ><P
  61320. >      See also <A
  61321. HREF="#function.cpdf-moveto"
  61322. ><B
  61323. CLASS="function"
  61324. >cpdf_moveto()</B
  61325. ></A
  61326. >,
  61327.      <A
  61328. HREF="#function.cpdf-rmoveto"
  61329. ><B
  61330. CLASS="function"
  61331. >cpdf_rmoveto()</B
  61332. ></A
  61333. > and
  61334.      <A
  61335. HREF="#function.cpdf-curveto"
  61336. ><B
  61337. CLASS="function"
  61338. >cpdf_curveto()</B
  61339. ></A
  61340. >.
  61341.     </P
  61342. ></DIV
  61343. ><H1
  61344. ><A
  61345. NAME="function.cpdf-rmoveto"
  61346. ></A
  61347. >cpdf_rmoveto</H1
  61348. ><DIV
  61349. CLASS="refnamediv"
  61350. ><A
  61351. NAME="AEN12766"
  61352. ></A
  61353. ><P
  61354. >    (PHP 3>= 3.0.9, PHP 4 )</P
  61355. >cpdf_rmoveto -- Sets current point</DIV
  61356. ><DIV
  61357. CLASS="refsect1"
  61358. ><A
  61359. NAME="AEN12769"
  61360. ></A
  61361. ><H2
  61362. >Description</H2
  61363. >bool <B
  61364. CLASS="methodname"
  61365. >cpdf_rmoveto</B
  61366. > ( int pdf_document, float x-coor, float y-coor [, int mode])<BR
  61367. ></BR
  61368. ><P
  61369. >      The <B
  61370. CLASS="function"
  61371. >cpdf_rmoveto()</B
  61372. > function set the current point
  61373.      relative to the coordinates <TT
  61374. CLASS="parameter"
  61375. ><I
  61376. >x-coor</I
  61377. ></TT
  61378. > and
  61379.      <TT
  61380. CLASS="parameter"
  61381. ><I
  61382. >y-coor</I
  61383. ></TT
  61384. >. Vracφ <TT
  61385. CLASS="constant"
  61386. ><B
  61387. >TRUE</B
  61388. ></TT
  61389. > p°i ·sp∞chu, <TT
  61390. CLASS="constant"
  61391. ><B
  61392. >FALSE</B
  61393. ></TT
  61394. > p°i selhßnφ.
  61395.     </P
  61396. ><P
  61397. >Nepovinn² parametr <TT
  61398. CLASS="parameter"
  61399. ><I
  61400. >mode</I
  61401. ></TT
  61402. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  61403. ><P
  61404. >      See also <A
  61405. HREF="#function.cpdf-moveto"
  61406. ><B
  61407. CLASS="function"
  61408. >cpdf_moveto()</B
  61409. ></A
  61410. >.
  61411.     </P
  61412. ></DIV
  61413. ><H1
  61414. ><A
  61415. NAME="function.cpdf-rotate-text"
  61416. ></A
  61417. >cpdf_rotate_text</H1
  61418. ><DIV
  61419. CLASS="refnamediv"
  61420. ><A
  61421. NAME="AEN12797"
  61422. ></A
  61423. ><P
  61424. >    (PHP 3>= 3.0.9, PHP 4 )</P
  61425. >cpdf_rotate_text -- 
  61426.      Sets text rotation angle
  61427.     </DIV
  61428. ><DIV
  61429. CLASS="refsect1"
  61430. ><A
  61431. NAME="AEN12800"
  61432. ></A
  61433. ><H2
  61434. >Description</H2
  61435. >bool <B
  61436. CLASS="methodname"
  61437. >cpdf_rotate_text</B
  61438. > ( int pdfdoc, float angle)<BR
  61439. ></BR
  61440. ><P
  61441. >      <DIV
  61442. CLASS="warning"
  61443. ><P
  61444. ></P
  61445. ><TABLE
  61446. CLASS="warning"
  61447. BORDER="1"
  61448. WIDTH="100%"
  61449. ><TR
  61450. ><TD
  61451. ALIGN="CENTER"
  61452. ><B
  61453. >Varovßnφ</B
  61454. ></TD
  61455. ></TR
  61456. ><TR
  61457. ><TD
  61458. ALIGN="LEFT"
  61459. ><P
  61460. >Tato funkce je╣t∞ nenφ
  61461. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  61462. ></TD
  61463. ></TR
  61464. ></TABLE
  61465. ></DIV
  61466. >
  61467.     </P
  61468. ></DIV
  61469. ><H1
  61470. ><A
  61471. NAME="function.cpdf-rotate"
  61472. ></A
  61473. >cpdf_rotate</H1
  61474. ><DIV
  61475. CLASS="refnamediv"
  61476. ><A
  61477. NAME="AEN12815"
  61478. ></A
  61479. ><P
  61480. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61481. >cpdf_rotate -- Sets rotation</DIV
  61482. ><DIV
  61483. CLASS="refsect1"
  61484. ><A
  61485. NAME="AEN12818"
  61486. ></A
  61487. ><H2
  61488. >Description</H2
  61489. >bool <B
  61490. CLASS="methodname"
  61491. >cpdf_rotate</B
  61492. > ( int pdf_document, float angle)<BR
  61493. ></BR
  61494. ><P
  61495. >      The <B
  61496. CLASS="function"
  61497. >cpdf_rotate()</B
  61498. > function set the rotation in
  61499.      degrees to <TT
  61500. CLASS="parameter"
  61501. ><I
  61502. >angle</I
  61503. ></TT
  61504. >. Vracφ <TT
  61505. CLASS="constant"
  61506. ><B
  61507. >TRUE</B
  61508. ></TT
  61509. > p°i ·sp∞chu, <TT
  61510. CLASS="constant"
  61511. ><B
  61512. >FALSE</B
  61513. ></TT
  61514. > p°i selhßnφ.
  61515.     </P
  61516. ></DIV
  61517. ><H1
  61518. ><A
  61519. NAME="function.cpdf-save-to-file"
  61520. ></A
  61521. >cpdf_save_to_file</H1
  61522. ><DIV
  61523. CLASS="refnamediv"
  61524. ><A
  61525. NAME="AEN12835"
  61526. ></A
  61527. ><P
  61528. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61529. >cpdf_save_to_file -- Writes the pdf document into a file</DIV
  61530. ><DIV
  61531. CLASS="refsect1"
  61532. ><A
  61533. NAME="AEN12838"
  61534. ></A
  61535. ><H2
  61536. >Description</H2
  61537. >bool <B
  61538. CLASS="methodname"
  61539. >cpdf_save_to_file</B
  61540. > ( int pdf_document, string filename)<BR
  61541. ></BR
  61542. ><P
  61543. >      The <B
  61544. CLASS="function"
  61545. >cpdf_save_to_file()</B
  61546. > function outputs
  61547.      the pdf document into a file if it has been created in memory.
  61548.      Vracφ <TT
  61549. CLASS="constant"
  61550. ><B
  61551. >TRUE</B
  61552. ></TT
  61553. > p°i ·sp∞chu, <TT
  61554. CLASS="constant"
  61555. ><B
  61556. >FALSE</B
  61557. ></TT
  61558. > p°i selhßnφ.
  61559.     </P
  61560. ><P
  61561. >      This function is not needed if the pdf document has been open
  61562.      by specifying a filename as a parameter of <A
  61563. HREF="#function.cpdf-open"
  61564. ><B
  61565. CLASS="function"
  61566. >cpdf_open()</B
  61567. ></A
  61568. >.
  61569.     </P
  61570. ><P
  61571. >      See also <A
  61572. HREF="#function.cpdf-output-buffer"
  61573. ><B
  61574. CLASS="function"
  61575. >cpdf_output_buffer()</B
  61576. ></A
  61577. > and
  61578.      <A
  61579. HREF="#function.cpdf-open"
  61580. ><B
  61581. CLASS="function"
  61582. >cpdf_open()</B
  61583. ></A
  61584. >.
  61585.     </P
  61586. ></DIV
  61587. ><H1
  61588. ><A
  61589. NAME="function.cpdf-save"
  61590. ></A
  61591. >cpdf_save</H1
  61592. ><DIV
  61593. CLASS="refnamediv"
  61594. ><A
  61595. NAME="AEN12859"
  61596. ></A
  61597. ><P
  61598. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61599. >cpdf_save -- Saves current environment</DIV
  61600. ><DIV
  61601. CLASS="refsect1"
  61602. ><A
  61603. NAME="AEN12862"
  61604. ></A
  61605. ><H2
  61606. >Description</H2
  61607. >bool <B
  61608. CLASS="methodname"
  61609. >cpdf_save</B
  61610. > ( int pdf_document)<BR
  61611. ></BR
  61612. ><P
  61613. >      The <B
  61614. CLASS="function"
  61615. >cpdf_save()</B
  61616. > function saves the current
  61617.      environment. It works like the postscript command gsave. Very
  61618.      useful if you want to translate or rotate an object without effecting
  61619.      other objects. Vracφ <TT
  61620. CLASS="constant"
  61621. ><B
  61622. >TRUE</B
  61623. ></TT
  61624. > p°i ·sp∞chu, <TT
  61625. CLASS="constant"
  61626. ><B
  61627. >FALSE</B
  61628. ></TT
  61629. > p°i selhßnφ.
  61630.     </P
  61631. ><P
  61632. >      See also <A
  61633. HREF="#function.cpdf-restore"
  61634. ><B
  61635. CLASS="function"
  61636. >cpdf_restore()</B
  61637. ></A
  61638. >.
  61639.     </P
  61640. ></DIV
  61641. ><H1
  61642. ><A
  61643. NAME="function.cpdf-scale"
  61644. ></A
  61645. >cpdf_scale</H1
  61646. ><DIV
  61647. CLASS="refnamediv"
  61648. ><A
  61649. NAME="AEN12877"
  61650. ></A
  61651. ><P
  61652. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61653. >cpdf_scale -- Sets scaling</DIV
  61654. ><DIV
  61655. CLASS="refsect1"
  61656. ><A
  61657. NAME="AEN12880"
  61658. ></A
  61659. ><H2
  61660. >Description</H2
  61661. >bool <B
  61662. CLASS="methodname"
  61663. >cpdf_scale</B
  61664. > ( int pdf_document, float x-scale, float y-scale)<BR
  61665. ></BR
  61666. ><P
  61667. >      The <B
  61668. CLASS="function"
  61669. >cpdf_scale()</B
  61670. > function set the scaling factor
  61671.      in both directions. Vracφ <TT
  61672. CLASS="constant"
  61673. ><B
  61674. >TRUE</B
  61675. ></TT
  61676. > p°i ·sp∞chu, <TT
  61677. CLASS="constant"
  61678. ><B
  61679. >FALSE</B
  61680. ></TT
  61681. > p°i selhßnφ.
  61682.     </P
  61683. ></DIV
  61684. ><H1
  61685. ><A
  61686. NAME="function.cpdf-set-action-url"
  61687. ></A
  61688. >cpdf_set_action_url</H1
  61689. ><DIV
  61690. CLASS="refnamediv"
  61691. ><A
  61692. NAME="AEN12899"
  61693. ></A
  61694. ><P
  61695. >    (PHP 3>= 3.0.9, PHP 4 )</P
  61696. >cpdf_set_action_url -- 
  61697.      Sets hyperlink
  61698.     </DIV
  61699. ><DIV
  61700. CLASS="refsect1"
  61701. ><A
  61702. NAME="AEN12902"
  61703. ></A
  61704. ><H2
  61705. >Description</H2
  61706. >bool <B
  61707. CLASS="methodname"
  61708. >cpdf_set_action_url</B
  61709. > ( int pdfdoc, float xll, float yll, float xur, float xur, string url [, int mode])<BR
  61710. ></BR
  61711. ><P
  61712. >      <DIV
  61713. CLASS="warning"
  61714. ><P
  61715. ></P
  61716. ><TABLE
  61717. CLASS="warning"
  61718. BORDER="1"
  61719. WIDTH="100%"
  61720. ><TR
  61721. ><TD
  61722. ALIGN="CENTER"
  61723. ><B
  61724. >Varovßnφ</B
  61725. ></TD
  61726. ></TR
  61727. ><TR
  61728. ><TD
  61729. ALIGN="LEFT"
  61730. ><P
  61731. >Tato funkce je╣t∞ nenφ
  61732. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  61733. ></TD
  61734. ></TR
  61735. ></TABLE
  61736. ></DIV
  61737. >
  61738.     </P
  61739. ></DIV
  61740. ><H1
  61741. ><A
  61742. NAME="function.cpdf-set-char-spacing"
  61743. ></A
  61744. >cpdf_set_char_spacing</H1
  61745. ><DIV
  61746. CLASS="refnamediv"
  61747. ><A
  61748. NAME="AEN12932"
  61749. ></A
  61750. ><P
  61751. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61752. >cpdf_set_char_spacing -- Sets character spacing</DIV
  61753. ><DIV
  61754. CLASS="refsect1"
  61755. ><A
  61756. NAME="AEN12935"
  61757. ></A
  61758. ><H2
  61759. >Description</H2
  61760. >bool <B
  61761. CLASS="methodname"
  61762. >cpdf_set_char_spacing</B
  61763. > ( int pdf_document, float space)<BR
  61764. ></BR
  61765. ><P
  61766. >      The <B
  61767. CLASS="function"
  61768. >cpdf_set_char_spacing()</B
  61769. > function sets the
  61770.      spacing between characters. Vracφ <TT
  61771. CLASS="constant"
  61772. ><B
  61773. >TRUE</B
  61774. ></TT
  61775. > p°i ·sp∞chu, <TT
  61776. CLASS="constant"
  61777. ><B
  61778. >FALSE</B
  61779. ></TT
  61780. > p°i selhßnφ.
  61781.     </P
  61782. ><P
  61783. >      See also <A
  61784. HREF="#function.cpdf-set-word-spacing"
  61785. ><B
  61786. CLASS="function"
  61787. >cpdf_set_word_spacing()</B
  61788. ></A
  61789. > and
  61790.      <A
  61791. HREF="#function.cpdf-set-leading"
  61792. ><B
  61793. CLASS="function"
  61794. >cpdf_set_leading()</B
  61795. ></A
  61796. >.
  61797.     </P
  61798. ></DIV
  61799. ><H1
  61800. ><A
  61801. NAME="function.cpdf-set-creator"
  61802. ></A
  61803. >cpdf_set_creator</H1
  61804. ><DIV
  61805. CLASS="refnamediv"
  61806. ><A
  61807. NAME="AEN12954"
  61808. ></A
  61809. ><P
  61810. >    (PHP 3>= 3.0.8, PHP 4 )</P
  61811. >cpdf_set_creator -- Sets the creator field in the pdf document</DIV
  61812. ><DIV
  61813. CLASS="refsect1"
  61814. ><A
  61815. NAME="AEN12957"
  61816. ></A
  61817. ><H2
  61818. >Description</H2
  61819. >bool <B
  61820. CLASS="methodname"
  61821. >cpdf_set_creator</B
  61822. > ( string creator)<BR
  61823. ></BR
  61824. ><P
  61825. >      The <B
  61826. CLASS="function"
  61827. >cpdf_set_creator()</B
  61828. > function sets the
  61829.      creator of a pdf document. Vracφ <TT
  61830. CLASS="constant"
  61831. ><B
  61832. >TRUE</B
  61833. ></TT
  61834. > p°i ·sp∞chu, <TT
  61835. CLASS="constant"
  61836. ><B
  61837. >FALSE</B
  61838. ></TT
  61839. > p°i selhßnφ.
  61840.     </P
  61841. ><P
  61842. >      See also <A
  61843. HREF="#function.cpdf-set-subject"
  61844. ><B
  61845. CLASS="function"
  61846. >cpdf_set_subject()</B
  61847. ></A
  61848. >,
  61849.      <A
  61850. HREF="#function.cpdf-set-title"
  61851. ><B
  61852. CLASS="function"
  61853. >cpdf_set_title()</B
  61854. ></A
  61855. > and
  61856.      <A
  61857. HREF="#function.cpdf-set-keywords"
  61858. ><B
  61859. CLASS="function"
  61860. >cpdf_set_keywords()</B
  61861. ></A
  61862. >.
  61863.     </P
  61864. ></DIV
  61865. ><H1
  61866. ><A
  61867. NAME="function.cpdf-set-current-page"
  61868. ></A
  61869. >cpdf_set_current_page</H1
  61870. ><DIV
  61871. CLASS="refnamediv"
  61872. ><A
  61873. NAME="AEN12974"
  61874. ></A
  61875. ><P
  61876. >    (PHP 3>= 3.0.9, PHP 4 )</P
  61877. >cpdf_set_current_page -- Sets current page</DIV
  61878. ><DIV
  61879. CLASS="refsect1"
  61880. ><A
  61881. NAME="AEN12977"
  61882. ></A
  61883. ><H2
  61884. >Description</H2
  61885. >bool <B
  61886. CLASS="methodname"
  61887. >cpdf_set_current_page</B
  61888. > ( int pdf_document, int page_number)<BR
  61889. ></BR
  61890. ><P
  61891. >      The <B
  61892. CLASS="function"
  61893. >cpdf_set_current_page()</B
  61894. > function set the page
  61895.      on which all operations are performed. One can switch between pages
  61896.      until a page is finished with <A
  61897. HREF="#function.cpdf-finalize-page"
  61898. ><B
  61899. CLASS="function"
  61900. >cpdf_finalize_page()</B
  61901. ></A
  61902. >.
  61903.      Vracφ <TT
  61904. CLASS="constant"
  61905. ><B
  61906. >TRUE</B
  61907. ></TT
  61908. > p°i ·sp∞chu, <TT
  61909. CLASS="constant"
  61910. ><B
  61911. >FALSE</B
  61912. ></TT
  61913. > p°i selhßnφ.
  61914.     </P
  61915. ><P
  61916. >      See also <A
  61917. HREF="#function.cpdf-finalize-page"
  61918. ><B
  61919. CLASS="function"
  61920. >cpdf_finalize_page()</B
  61921. ></A
  61922. >.
  61923.     </P
  61924. ></DIV
  61925. ><H1
  61926. ><A
  61927. NAME="function.cpdf-set-font-directories"
  61928. ></A
  61929. >cpdf_set_font_directories</H1
  61930. ><DIV
  61931. CLASS="refnamediv"
  61932. ><A
  61933. NAME="AEN12996"
  61934. ></A
  61935. ><P
  61936. >    (PHP 4 >= 4.0.6)</P
  61937. >cpdf_set_font_directories -- 
  61938.      Sets directories to search when using external fonts
  61939.     </DIV
  61940. ><DIV
  61941. CLASS="refsect1"
  61942. ><A
  61943. NAME="AEN12999"
  61944. ></A
  61945. ><H2
  61946. >Description</H2
  61947. >bool <B
  61948. CLASS="methodname"
  61949. >cpdf_set_font_directories</B
  61950. > ( int pdfdoc, string pfmdir, string pfbdir)<BR
  61951. ></BR
  61952. ><P
  61953. >      <DIV
  61954. CLASS="warning"
  61955. ><P
  61956. ></P
  61957. ><TABLE
  61958. CLASS="warning"
  61959. BORDER="1"
  61960. WIDTH="100%"
  61961. ><TR
  61962. ><TD
  61963. ALIGN="CENTER"
  61964. ><B
  61965. >Varovßnφ</B
  61966. ></TD
  61967. ></TR
  61968. ><TR
  61969. ><TD
  61970. ALIGN="LEFT"
  61971. ><P
  61972. >Tato funkce je╣t∞ nenφ
  61973. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  61974. ></TD
  61975. ></TR
  61976. ></TABLE
  61977. ></DIV
  61978. >
  61979.     </P
  61980. ></DIV
  61981. ><H1
  61982. ><A
  61983. NAME="function.cpdf-set-font-map-file"
  61984. ></A
  61985. >cpdf_set_font_map_file</H1
  61986. ><DIV
  61987. CLASS="refnamediv"
  61988. ><A
  61989. NAME="AEN13017"
  61990. ></A
  61991. ><P
  61992. >    (PHP 4 >= 4.0.6)</P
  61993. >cpdf_set_font_map_file -- 
  61994.      Sets fontname to filename translation map when using external fonts
  61995.     </DIV
  61996. ><DIV
  61997. CLASS="refsect1"
  61998. ><A
  61999. NAME="AEN13020"
  62000. ></A
  62001. ><H2
  62002. >Description</H2
  62003. >bool <B
  62004. CLASS="methodname"
  62005. >cpdf_set_font_map_file</B
  62006. > ( int pdfdoc, string filename)<BR
  62007. ></BR
  62008. ><P
  62009. >      <DIV
  62010. CLASS="warning"
  62011. ><P
  62012. ></P
  62013. ><TABLE
  62014. CLASS="warning"
  62015. BORDER="1"
  62016. WIDTH="100%"
  62017. ><TR
  62018. ><TD
  62019. ALIGN="CENTER"
  62020. ><B
  62021. >Varovßnφ</B
  62022. ></TD
  62023. ></TR
  62024. ><TR
  62025. ><TD
  62026. ALIGN="LEFT"
  62027. ><P
  62028. >Tato funkce je╣t∞ nenφ
  62029. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  62030. ></TD
  62031. ></TR
  62032. ></TABLE
  62033. ></DIV
  62034. >
  62035.     </P
  62036. ></DIV
  62037. ><H1
  62038. ><A
  62039. NAME="function.cpdf-set-font"
  62040. ></A
  62041. >cpdf_set_font</H1
  62042. ><DIV
  62043. CLASS="refnamediv"
  62044. ><A
  62045. NAME="AEN13035"
  62046. ></A
  62047. ><P
  62048. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62049. >cpdf_set_font -- Select the current font face and size</DIV
  62050. ><DIV
  62051. CLASS="refsect1"
  62052. ><A
  62053. NAME="AEN13038"
  62054. ></A
  62055. ><H2
  62056. >Description</H2
  62057. >bool <B
  62058. CLASS="methodname"
  62059. >cpdf_set_font</B
  62060. > ( int pdf_document, string font_name, float size, string encoding)<BR
  62061. ></BR
  62062. ><P
  62063. >      The <B
  62064. CLASS="function"
  62065. >cpdf_set_font()</B
  62066. > function sets the
  62067.      current font face, font size and encoding. Currently only
  62068.      the standard postscript fonts are supported. Vracφ <TT
  62069. CLASS="constant"
  62070. ><B
  62071. >TRUE</B
  62072. ></TT
  62073. > p°i ·sp∞chu, <TT
  62074. CLASS="constant"
  62075. ><B
  62076. >FALSE</B
  62077. ></TT
  62078. > p°i selhßnφ.
  62079.     </P
  62080. ><P
  62081. >      The last parameter <TT
  62082. CLASS="parameter"
  62083. ><I
  62084. >encoding</I
  62085. ></TT
  62086. > can take the
  62087.      following values: "MacRomanEncoding", "MacExpertEncoding",
  62088.      "WinAnsiEncoding", and "<TT
  62089. CLASS="constant"
  62090. ><B
  62091. >NULL</B
  62092. ></TT
  62093. >". "<TT
  62094. CLASS="constant"
  62095. ><B
  62096. >NULL</B
  62097. ></TT
  62098. >" stands for the font's
  62099.      built-in encoding.
  62100.     </P
  62101. ><P
  62102. >      See the ClibPDF Manual for more information, especially how to support
  62103.      Asian fonts.
  62104.     </P
  62105. ></DIV
  62106. ><H1
  62107. ><A
  62108. NAME="function.cpdf-set-horiz-scaling"
  62109. ></A
  62110. >cpdf_set_horiz_scaling</H1
  62111. ><DIV
  62112. CLASS="refnamediv"
  62113. ><A
  62114. NAME="AEN13065"
  62115. ></A
  62116. ><P
  62117. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62118. >cpdf_set_horiz_scaling -- Sets horizontal scaling of text</DIV
  62119. ><DIV
  62120. CLASS="refsect1"
  62121. ><A
  62122. NAME="AEN13068"
  62123. ></A
  62124. ><H2
  62125. >Description</H2
  62126. >bool <B
  62127. CLASS="methodname"
  62128. >cpdf_set_horiz_scaling</B
  62129. > ( int pdf_document, float scale)<BR
  62130. ></BR
  62131. ><P
  62132. >      The <B
  62133. CLASS="function"
  62134. >cpdf_set_horiz_scaling()</B
  62135. > function sets the
  62136.      horizontal scaling to <TT
  62137. CLASS="parameter"
  62138. ><I
  62139. >scale</I
  62140. ></TT
  62141. > percent.
  62142.      Vracφ <TT
  62143. CLASS="constant"
  62144. ><B
  62145. >TRUE</B
  62146. ></TT
  62147. > p°i ·sp∞chu, <TT
  62148. CLASS="constant"
  62149. ><B
  62150. >FALSE</B
  62151. ></TT
  62152. > p°i selhßnφ.
  62153.     </P
  62154. ></DIV
  62155. ><H1
  62156. ><A
  62157. NAME="function.cpdf-set-keywords"
  62158. ></A
  62159. >cpdf_set_keywords</H1
  62160. ><DIV
  62161. CLASS="refnamediv"
  62162. ><A
  62163. NAME="AEN13085"
  62164. ></A
  62165. ><P
  62166. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62167. >cpdf_set_keywords -- Sets the keywords field of the pdf document</DIV
  62168. ><DIV
  62169. CLASS="refsect1"
  62170. ><A
  62171. NAME="AEN13088"
  62172. ></A
  62173. ><H2
  62174. >Description</H2
  62175. >bool <B
  62176. CLASS="methodname"
  62177. >cpdf_set_keywords</B
  62178. > ( string keywords)<BR
  62179. ></BR
  62180. ><P
  62181. >      The <B
  62182. CLASS="function"
  62183. >cpdf_set_keywords()</B
  62184. > function sets the
  62185.      keywords of a pdf document. Vracφ <TT
  62186. CLASS="constant"
  62187. ><B
  62188. >TRUE</B
  62189. ></TT
  62190. > p°i ·sp∞chu, <TT
  62191. CLASS="constant"
  62192. ><B
  62193. >FALSE</B
  62194. ></TT
  62195. > p°i selhßnφ.
  62196.     </P
  62197. ><P
  62198. >      See also <A
  62199. HREF="#function.cpdf-set-title"
  62200. ><B
  62201. CLASS="function"
  62202. >cpdf_set_title()</B
  62203. ></A
  62204. >,
  62205.      <A
  62206. HREF="#function.cpdf-set-creator"
  62207. ><B
  62208. CLASS="function"
  62209. >cpdf_set_creator()</B
  62210. ></A
  62211. > and
  62212.      <A
  62213. HREF="#function.cpdf-set-subject"
  62214. ><B
  62215. CLASS="function"
  62216. >cpdf_set_subject()</B
  62217. ></A
  62218. >.
  62219.     </P
  62220. ></DIV
  62221. ><H1
  62222. ><A
  62223. NAME="function.cpdf-set-leading"
  62224. ></A
  62225. >cpdf_set_leading</H1
  62226. ><DIV
  62227. CLASS="refnamediv"
  62228. ><A
  62229. NAME="AEN13105"
  62230. ></A
  62231. ><P
  62232. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62233. >cpdf_set_leading -- Sets distance between text lines</DIV
  62234. ><DIV
  62235. CLASS="refsect1"
  62236. ><A
  62237. NAME="AEN13108"
  62238. ></A
  62239. ><H2
  62240. >Description</H2
  62241. >bool <B
  62242. CLASS="methodname"
  62243. >cpdf_set_leading</B
  62244. > ( int pdf_document, float distance)<BR
  62245. ></BR
  62246. ><P
  62247. >      The <B
  62248. CLASS="function"
  62249. >cpdf_set_leading()</B
  62250. > function sets the 
  62251.      <TT
  62252. CLASS="parameter"
  62253. ><I
  62254. >distance</I
  62255. ></TT
  62256. > between text lines. This will 
  62257.      be used if text is output by <A
  62258. HREF="#function.cpdf-continue-text"
  62259. ><B
  62260. CLASS="function"
  62261. >cpdf_continue_text()</B
  62262. ></A
  62263. >.
  62264.      Vracφ <TT
  62265. CLASS="constant"
  62266. ><B
  62267. >TRUE</B
  62268. ></TT
  62269. > p°i ·sp∞chu, <TT
  62270. CLASS="constant"
  62271. ><B
  62272. >FALSE</B
  62273. ></TT
  62274. > p°i selhßnφ.
  62275.     </P
  62276. ><P
  62277. >      See also <A
  62278. HREF="#function.cpdf-continue-text"
  62279. ><B
  62280. CLASS="function"
  62281. >cpdf_continue_text()</B
  62282. ></A
  62283. >.
  62284.     </P
  62285. ></DIV
  62286. ><H1
  62287. ><A
  62288. NAME="function.cpdf-set-page-animation"
  62289. ></A
  62290. >cpdf_set_page_animation</H1
  62291. ><DIV
  62292. CLASS="refnamediv"
  62293. ><A
  62294. NAME="AEN13128"
  62295. ></A
  62296. ><P
  62297. >    (PHP 3>= 3.0.9, PHP 4 )</P
  62298. >cpdf_set_page_animation -- Sets duration between pages</DIV
  62299. ><DIV
  62300. CLASS="refsect1"
  62301. ><A
  62302. NAME="AEN13131"
  62303. ></A
  62304. ><H2
  62305. >Description</H2
  62306. >bool <B
  62307. CLASS="methodname"
  62308. >cpdf_set_page_animation</B
  62309. > ( int pdf_document, int transition, float duration)<BR
  62310. ></BR
  62311. ><P
  62312. >      The <B
  62313. CLASS="function"
  62314. >cpdf_set_page_animation()</B
  62315. > function set the
  62316.      transition between following pages. Vracφ <TT
  62317. CLASS="constant"
  62318. ><B
  62319. >TRUE</B
  62320. ></TT
  62321. > p°i ·sp∞chu, <TT
  62322. CLASS="constant"
  62323. ><B
  62324. >FALSE</B
  62325. ></TT
  62326. > p°i selhßnφ.
  62327.     </P
  62328. ><P
  62329. >      The value of <TT
  62330. CLASS="parameter"
  62331. ><I
  62332. >transition</I
  62333. ></TT
  62334. >
  62335.      can be
  62336.      <P
  62337. ></P
  62338. ><TABLE
  62339. BORDER="0"
  62340. ><TBODY
  62341. ><TR
  62342. ><TD
  62343. >0 for none,</TD
  62344. ></TR
  62345. ><TR
  62346. ><TD
  62347. >        1 for two lines sweeping across the screen reveal the page,
  62348.       </TD
  62349. ></TR
  62350. ><TR
  62351. ><TD
  62352. >        2 for multiple lines sweeping across the screen reveal the page,
  62353.       </TD
  62354. ></TR
  62355. ><TR
  62356. ><TD
  62357. >3 for a box reveals the page,</TD
  62358. ></TR
  62359. ><TR
  62360. ><TD
  62361. >        4 for a single line sweeping across the screen reveals the page,
  62362.       </TD
  62363. ></TR
  62364. ><TR
  62365. ><TD
  62366. >5 for the old page dissolves to reveal the page,</TD
  62367. ></TR
  62368. ><TR
  62369. ><TD
  62370. >        6 for the dissolve effect moves from one screen edge to another,
  62371.       </TD
  62372. ></TR
  62373. ><TR
  62374. ><TD
  62375. >        7 for the old page is simply replaced by the new page (default)
  62376.       </TD
  62377. ></TR
  62378. ></TBODY
  62379. ></TABLE
  62380. ><P
  62381. ></P
  62382. >
  62383.     </P
  62384. ><P
  62385. >      The value of <TT
  62386. CLASS="parameter"
  62387. ><I
  62388. >duration</I
  62389. ></TT
  62390. > is the number of seconds
  62391.      between page flipping.
  62392.     </P
  62393. ></DIV
  62394. ><H1
  62395. ><A
  62396. NAME="function.cpdf-set-subject"
  62397. ></A
  62398. >cpdf_set_subject</H1
  62399. ><DIV
  62400. CLASS="refnamediv"
  62401. ><A
  62402. NAME="AEN13163"
  62403. ></A
  62404. ><P
  62405. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62406. >cpdf_set_subject -- Sets the subject field of the pdf document</DIV
  62407. ><DIV
  62408. CLASS="refsect1"
  62409. ><A
  62410. NAME="AEN13166"
  62411. ></A
  62412. ><H2
  62413. >Description</H2
  62414. >bool <B
  62415. CLASS="methodname"
  62416. >cpdf_set_subject</B
  62417. > ( int pdf_document, string subject)<BR
  62418. ></BR
  62419. ><P
  62420. >      The <B
  62421. CLASS="function"
  62422. >cpdf_set_subject()</B
  62423. > function sets the
  62424.      <TT
  62425. CLASS="parameter"
  62426. ><I
  62427. >subject</I
  62428. ></TT
  62429. > of a pdf document. Vracφ <TT
  62430. CLASS="constant"
  62431. ><B
  62432. >TRUE</B
  62433. ></TT
  62434. > p°i ·sp∞chu, <TT
  62435. CLASS="constant"
  62436. ><B
  62437. >FALSE</B
  62438. ></TT
  62439. > p°i selhßnφ.
  62440.     </P
  62441. ><P
  62442. >      See also <A
  62443. HREF="#function.cpdf-set-title"
  62444. ><B
  62445. CLASS="function"
  62446. >cpdf_set_title()</B
  62447. ></A
  62448. >,
  62449.      <A
  62450. HREF="#function.cpdf-set-creator"
  62451. ><B
  62452. CLASS="function"
  62453. >cpdf_set_creator()</B
  62454. ></A
  62455. > and
  62456.      <A
  62457. HREF="#function.cpdf-set-keywords"
  62458. ><B
  62459. CLASS="function"
  62460. >cpdf_set_keywords()</B
  62461. ></A
  62462. >.
  62463.     </P
  62464. ></DIV
  62465. ><H1
  62466. ><A
  62467. NAME="function.cpdf-set-text-matrix"
  62468. ></A
  62469. >cpdf_set_text_matrix</H1
  62470. ><DIV
  62471. CLASS="refnamediv"
  62472. ><A
  62473. NAME="AEN13187"
  62474. ></A
  62475. ><P
  62476. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62477. >cpdf_set_text_matrix -- Sets the text matrix</DIV
  62478. ><DIV
  62479. CLASS="refsect1"
  62480. ><A
  62481. NAME="AEN13190"
  62482. ></A
  62483. ><H2
  62484. >Description</H2
  62485. >bool <B
  62486. CLASS="methodname"
  62487. >cpdf_set_text_matrix</B
  62488. > ( int pdf_document, array matrix)<BR
  62489. ></BR
  62490. ><P
  62491. >      The <B
  62492. CLASS="function"
  62493. >cpdf_set_text_matrix()</B
  62494. > function sets
  62495.      a <TT
  62496. CLASS="parameter"
  62497. ><I
  62498. >matrix</I
  62499. ></TT
  62500. > which describes a transformation 
  62501.      applied on the current text font. Vracφ <TT
  62502. CLASS="constant"
  62503. ><B
  62504. >TRUE</B
  62505. ></TT
  62506. > p°i ·sp∞chu, <TT
  62507. CLASS="constant"
  62508. ><B
  62509. >FALSE</B
  62510. ></TT
  62511. > p°i selhßnφ.
  62512.     </P
  62513. ></DIV
  62514. ><H1
  62515. ><A
  62516. NAME="function.cpdf-set-text-pos"
  62517. ></A
  62518. >cpdf_set_text_pos</H1
  62519. ><DIV
  62520. CLASS="refnamediv"
  62521. ><A
  62522. NAME="AEN13207"
  62523. ></A
  62524. ><P
  62525. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62526. >cpdf_set_text_pos -- Sets text position</DIV
  62527. ><DIV
  62528. CLASS="refsect1"
  62529. ><A
  62530. NAME="AEN13210"
  62531. ></A
  62532. ><H2
  62533. >Description</H2
  62534. >bool <B
  62535. CLASS="methodname"
  62536. >cpdf_set_text_pos</B
  62537. > ( int pdf_document, float x-coor, float y-coor [, int mode])<BR
  62538. ></BR
  62539. ><P
  62540. >      The <B
  62541. CLASS="function"
  62542. >cpdf_set_text_pos()</B
  62543. > function sets the
  62544.      position of text for the next <A
  62545. HREF="#function.cpdf-show"
  62546. ><B
  62547. CLASS="function"
  62548. >cpdf_show()</B
  62549. ></A
  62550. > 
  62551.      function call. Vracφ <TT
  62552. CLASS="constant"
  62553. ><B
  62554. >TRUE</B
  62555. ></TT
  62556. > p°i ·sp∞chu, <TT
  62557. CLASS="constant"
  62558. ><B
  62559. >FALSE</B
  62560. ></TT
  62561. > p°i selhßnφ.
  62562.     </P
  62563. ><P
  62564. >Nepovinn² parametr <TT
  62565. CLASS="parameter"
  62566. ><I
  62567. >mode</I
  62568. ></TT
  62569. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  62570. ><P
  62571. >      See also <A
  62572. HREF="#function.cpdf-show"
  62573. ><B
  62574. CLASS="function"
  62575. >cpdf_show()</B
  62576. ></A
  62577. > and
  62578.      <A
  62579. HREF="#function.cpdf-text"
  62580. ><B
  62581. CLASS="function"
  62582. >cpdf_text()</B
  62583. ></A
  62584. >.
  62585.     </P
  62586. ></DIV
  62587. ><H1
  62588. ><A
  62589. NAME="function.cpdf-set-text-rendering"
  62590. ></A
  62591. >cpdf_set_text_rendering</H1
  62592. ><DIV
  62593. CLASS="refnamediv"
  62594. ><A
  62595. NAME="AEN13238"
  62596. ></A
  62597. ><P
  62598. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62599. >cpdf_set_text_rendering -- Determines how text is rendered</DIV
  62600. ><DIV
  62601. CLASS="refsect1"
  62602. ><A
  62603. NAME="AEN13241"
  62604. ></A
  62605. ><H2
  62606. >Description</H2
  62607. >bool <B
  62608. CLASS="methodname"
  62609. >cpdf_set_text_rendering</B
  62610. > ( int pdf_document, int rendermode)<BR
  62611. ></BR
  62612. ><P
  62613. >      The <B
  62614. CLASS="function"
  62615. >cpdf_set_text_rendering()</B
  62616. > function
  62617.      determines how text is rendered. Vracφ <TT
  62618. CLASS="constant"
  62619. ><B
  62620. >TRUE</B
  62621. ></TT
  62622. > p°i ·sp∞chu, <TT
  62623. CLASS="constant"
  62624. ><B
  62625. >FALSE</B
  62626. ></TT
  62627. > p°i selhßnφ.
  62628.     </P
  62629. ><P
  62630. >      The possible values for <TT
  62631. CLASS="parameter"
  62632. ><I
  62633. >rendermode</I
  62634. ></TT
  62635. > are 0=fill
  62636.      text, 1=stroke text, 2=fill and stroke text, 3=invisible, 4=fill
  62637.      text and add it to clipping path, 5=stroke text and add it to
  62638.      clipping path, 6=fill and stroke text and add it to clipping
  62639.      path, 7=add it to clipping path.
  62640.     </P
  62641. ></DIV
  62642. ><H1
  62643. ><A
  62644. NAME="function.cpdf-set-text-rise"
  62645. ></A
  62646. >cpdf_set_text_rise</H1
  62647. ><DIV
  62648. CLASS="refnamediv"
  62649. ><A
  62650. NAME="AEN13259"
  62651. ></A
  62652. ><P
  62653. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62654. >cpdf_set_text_rise -- Sets the text rise</DIV
  62655. ><DIV
  62656. CLASS="refsect1"
  62657. ><A
  62658. NAME="AEN13262"
  62659. ></A
  62660. ><H2
  62661. >Description</H2
  62662. >bool <B
  62663. CLASS="methodname"
  62664. >cpdf_set_text_rise</B
  62665. > ( int pdf_document, float value)<BR
  62666. ></BR
  62667. ><P
  62668. >      The <B
  62669. CLASS="function"
  62670. >cpdf_set_text_rise()</B
  62671. > function sets the
  62672.      text rising to <TT
  62673. CLASS="parameter"
  62674. ><I
  62675. >value</I
  62676. ></TT
  62677. > units. Vracφ <TT
  62678. CLASS="constant"
  62679. ><B
  62680. >TRUE</B
  62681. ></TT
  62682. > p°i ·sp∞chu, <TT
  62683. CLASS="constant"
  62684. ><B
  62685. >FALSE</B
  62686. ></TT
  62687. > p°i selhßnφ.
  62688.     </P
  62689. ></DIV
  62690. ><H1
  62691. ><A
  62692. NAME="function.cpdf-set-title"
  62693. ></A
  62694. >cpdf_set_title</H1
  62695. ><DIV
  62696. CLASS="refnamediv"
  62697. ><A
  62698. NAME="AEN13279"
  62699. ></A
  62700. ><P
  62701. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62702. >cpdf_set_title -- Sets the title field of the pdf document</DIV
  62703. ><DIV
  62704. CLASS="refsect1"
  62705. ><A
  62706. NAME="AEN13282"
  62707. ></A
  62708. ><H2
  62709. >Description</H2
  62710. >bool <B
  62711. CLASS="methodname"
  62712. >cpdf_set_title</B
  62713. > ( string title)<BR
  62714. ></BR
  62715. ><P
  62716. >      The <B
  62717. CLASS="function"
  62718. >cpdf_set_title()</B
  62719. > function sets the
  62720.      <TT
  62721. CLASS="parameter"
  62722. ><I
  62723. >title</I
  62724. ></TT
  62725. > of a pdf document. Vracφ <TT
  62726. CLASS="constant"
  62727. ><B
  62728. >TRUE</B
  62729. ></TT
  62730. > p°i ·sp∞chu, <TT
  62731. CLASS="constant"
  62732. ><B
  62733. >FALSE</B
  62734. ></TT
  62735. > p°i selhßnφ.
  62736.     </P
  62737. ><P
  62738. >      See also <A
  62739. HREF="#function.cpdf-set-subject"
  62740. ><B
  62741. CLASS="function"
  62742. >cpdf_set_subject()</B
  62743. ></A
  62744. >,
  62745.      <A
  62746. HREF="#function.cpdf-set-creator"
  62747. ><B
  62748. CLASS="function"
  62749. >cpdf_set_creator()</B
  62750. ></A
  62751. > and
  62752.      <A
  62753. HREF="#function.cpdf-set-keywords"
  62754. ><B
  62755. CLASS="function"
  62756. >cpdf_set_keywords()</B
  62757. ></A
  62758. >.
  62759.     </P
  62760. ></DIV
  62761. ><H1
  62762. ><A
  62763. NAME="function.cpdf-set-viewer-preferences"
  62764. ></A
  62765. >cpdf_set_viewer_preferences</H1
  62766. ><DIV
  62767. CLASS="refnamediv"
  62768. ><A
  62769. NAME="AEN13300"
  62770. ></A
  62771. ><P
  62772. >    (PHP 3>= 3.0.9, PHP 4 )</P
  62773. >cpdf_set_viewer_preferences -- 
  62774.      How to show the document in the viewer
  62775.     </DIV
  62776. ><DIV
  62777. CLASS="refsect1"
  62778. ><A
  62779. NAME="AEN13303"
  62780. ></A
  62781. ><H2
  62782. >Description</H2
  62783. >bool <B
  62784. CLASS="methodname"
  62785. >cpdf_set_viewer_preferences</B
  62786. > ( int pdfdoc, array preferences)<BR
  62787. ></BR
  62788. ><P
  62789. >      <DIV
  62790. CLASS="warning"
  62791. ><P
  62792. ></P
  62793. ><TABLE
  62794. CLASS="warning"
  62795. BORDER="1"
  62796. WIDTH="100%"
  62797. ><TR
  62798. ><TD
  62799. ALIGN="CENTER"
  62800. ><B
  62801. >Varovßnφ</B
  62802. ></TD
  62803. ></TR
  62804. ><TR
  62805. ><TD
  62806. ALIGN="LEFT"
  62807. ><P
  62808. >Tato funkce je╣t∞ nenφ
  62809. zdokumentovßna, k dispozici je pouze seznam argument∙.</P
  62810. ></TD
  62811. ></TR
  62812. ></TABLE
  62813. ></DIV
  62814. >
  62815.     </P
  62816. ></DIV
  62817. ><H1
  62818. ><A
  62819. NAME="function.cpdf-set-word-spacing"
  62820. ></A
  62821. >cpdf_set_word_spacing</H1
  62822. ><DIV
  62823. CLASS="refnamediv"
  62824. ><A
  62825. NAME="AEN13318"
  62826. ></A
  62827. ><P
  62828. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62829. >cpdf_set_word_spacing -- Sets spacing between words</DIV
  62830. ><DIV
  62831. CLASS="refsect1"
  62832. ><A
  62833. NAME="AEN13321"
  62834. ></A
  62835. ><H2
  62836. >Description</H2
  62837. >bool <B
  62838. CLASS="methodname"
  62839. >cpdf_set_word_spacing</B
  62840. > ( int pdf_document, float space)<BR
  62841. ></BR
  62842. ><P
  62843. >      The <B
  62844. CLASS="function"
  62845. >cpdf_set_word_spacing()</B
  62846. > function sets the
  62847.      spacing between words. Vracφ <TT
  62848. CLASS="constant"
  62849. ><B
  62850. >TRUE</B
  62851. ></TT
  62852. > p°i ·sp∞chu, <TT
  62853. CLASS="constant"
  62854. ><B
  62855. >FALSE</B
  62856. ></TT
  62857. > p°i selhßnφ.
  62858.     </P
  62859. ><P
  62860. >      See also <A
  62861. HREF="#function.cpdf-set-char-spacing"
  62862. ><B
  62863. CLASS="function"
  62864. >cpdf_set_char_spacing()</B
  62865. ></A
  62866. > and
  62867.      <A
  62868. HREF="#function.cpdf-set-leading"
  62869. ><B
  62870. CLASS="function"
  62871. >cpdf_set_leading()</B
  62872. ></A
  62873. >.
  62874.     </P
  62875. ></DIV
  62876. ><H1
  62877. ><A
  62878. NAME="function.cpdf-setdash"
  62879. ></A
  62880. >cpdf_setdash</H1
  62881. ><DIV
  62882. CLASS="refnamediv"
  62883. ><A
  62884. NAME="AEN13340"
  62885. ></A
  62886. ><P
  62887. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62888. >cpdf_setdash -- Sets dash pattern</DIV
  62889. ><DIV
  62890. CLASS="refsect1"
  62891. ><A
  62892. NAME="AEN13343"
  62893. ></A
  62894. ><H2
  62895. >Description</H2
  62896. >bool <B
  62897. CLASS="methodname"
  62898. >cpdf_setdash</B
  62899. > ( int pdf_document, float white, float black)<BR
  62900. ></BR
  62901. ><P
  62902. >      The <B
  62903. CLASS="function"
  62904. >cpdf_setdash()</B
  62905. > function set the dash
  62906.      pattern <TT
  62907. CLASS="parameter"
  62908. ><I
  62909. >white</I
  62910. ></TT
  62911. > white units and
  62912.      <TT
  62913. CLASS="parameter"
  62914. ><I
  62915. >black</I
  62916. ></TT
  62917. > black units. If both are 0 a solid
  62918.      line is set. Vracφ <TT
  62919. CLASS="constant"
  62920. ><B
  62921. >TRUE</B
  62922. ></TT
  62923. > p°i ·sp∞chu, <TT
  62924. CLASS="constant"
  62925. ><B
  62926. >FALSE</B
  62927. ></TT
  62928. > p°i selhßnφ.
  62929.     </P
  62930. ></DIV
  62931. ><H1
  62932. ><A
  62933. NAME="function.cpdf-setflat"
  62934. ></A
  62935. >cpdf_setflat</H1
  62936. ><DIV
  62937. CLASS="refnamediv"
  62938. ><A
  62939. NAME="AEN13364"
  62940. ></A
  62941. ><P
  62942. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62943. >cpdf_setflat -- Sets flatness</DIV
  62944. ><DIV
  62945. CLASS="refsect1"
  62946. ><A
  62947. NAME="AEN13367"
  62948. ></A
  62949. ><H2
  62950. >Description</H2
  62951. >bool <B
  62952. CLASS="methodname"
  62953. >cpdf_setflat</B
  62954. > ( int pdf_document, float value)<BR
  62955. ></BR
  62956. ><P
  62957. >      The <B
  62958. CLASS="function"
  62959. >cpdf_setflat()</B
  62960. > function set the flatness to
  62961.      a value between 0 and 100. Vracφ <TT
  62962. CLASS="constant"
  62963. ><B
  62964. >TRUE</B
  62965. ></TT
  62966. > p°i ·sp∞chu, <TT
  62967. CLASS="constant"
  62968. ><B
  62969. >FALSE</B
  62970. ></TT
  62971. > p°i selhßnφ.
  62972.     </P
  62973. ></DIV
  62974. ><H1
  62975. ><A
  62976. NAME="function.cpdf-setgray-fill"
  62977. ></A
  62978. >cpdf_setgray_fill</H1
  62979. ><DIV
  62980. CLASS="refnamediv"
  62981. ><A
  62982. NAME="AEN13383"
  62983. ></A
  62984. ><P
  62985. >    (PHP 3>= 3.0.8, PHP 4 )</P
  62986. >cpdf_setgray_fill -- Sets filling color to gray value</DIV
  62987. ><DIV
  62988. CLASS="refsect1"
  62989. ><A
  62990. NAME="AEN13386"
  62991. ></A
  62992. ><H2
  62993. >Description</H2
  62994. >bool <B
  62995. CLASS="methodname"
  62996. >cpdf_setgray_fill</B
  62997. > ( int pdf_document, float value)<BR
  62998. ></BR
  62999. ><P
  63000. >      The <B
  63001. CLASS="function"
  63002. >cpdf_setgray_fill()</B
  63003. > function sets the current
  63004.      gray <TT
  63005. CLASS="parameter"
  63006. ><I
  63007. >value</I
  63008. ></TT
  63009. > to fill a path. Vracφ <TT
  63010. CLASS="constant"
  63011. ><B
  63012. >TRUE</B
  63013. ></TT
  63014. > p°i ·sp∞chu, <TT
  63015. CLASS="constant"
  63016. ><B
  63017. >FALSE</B
  63018. ></TT
  63019. > p°i selhßnφ.
  63020.     </P
  63021. ><P
  63022. >      See also <A
  63023. HREF="#function.cpdf-setrgbcolor-fill"
  63024. ><B
  63025. CLASS="function"
  63026. >cpdf_setrgbcolor_fill()</B
  63027. ></A
  63028. >.
  63029.     </P
  63030. ></DIV
  63031. ><H1
  63032. ><A
  63033. NAME="function.cpdf-setgray-stroke"
  63034. ></A
  63035. >cpdf_setgray_stroke</H1
  63036. ><DIV
  63037. CLASS="refnamediv"
  63038. ><A
  63039. NAME="AEN13405"
  63040. ></A
  63041. ><P
  63042. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63043. >cpdf_setgray_stroke -- Sets drawing color to gray value</DIV
  63044. ><DIV
  63045. CLASS="refsect1"
  63046. ><A
  63047. NAME="AEN13408"
  63048. ></A
  63049. ><H2
  63050. >Description</H2
  63051. >bool <B
  63052. CLASS="methodname"
  63053. >cpdf_setgray_stroke</B
  63054. > ( int pdf_document, float gray_value)<BR
  63055. ></BR
  63056. ><P
  63057. >      The <B
  63058. CLASS="function"
  63059. >cpdf_setgray_stroke()</B
  63060. > function sets the current
  63061.      drawing color to the given gray value. Vracφ <TT
  63062. CLASS="constant"
  63063. ><B
  63064. >TRUE</B
  63065. ></TT
  63066. > p°i ·sp∞chu, <TT
  63067. CLASS="constant"
  63068. ><B
  63069. >FALSE</B
  63070. ></TT
  63071. > p°i selhßnφ.
  63072.     </P
  63073. ><P
  63074. >      See also <A
  63075. HREF="#function.cpdf-setrgbcolor-stroke"
  63076. ><B
  63077. CLASS="function"
  63078. >cpdf_setrgbcolor_stroke()</B
  63079. ></A
  63080. >.
  63081.     </P
  63082. ></DIV
  63083. ><H1
  63084. ><A
  63085. NAME="function.cpdf-setgray"
  63086. ></A
  63087. >cpdf_setgray</H1
  63088. ><DIV
  63089. CLASS="refnamediv"
  63090. ><A
  63091. NAME="AEN13426"
  63092. ></A
  63093. ><P
  63094. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63095. >cpdf_setgray -- Sets drawing and filling color to gray value</DIV
  63096. ><DIV
  63097. CLASS="refsect1"
  63098. ><A
  63099. NAME="AEN13429"
  63100. ></A
  63101. ><H2
  63102. >Description</H2
  63103. >bool <B
  63104. CLASS="methodname"
  63105. >cpdf_setgray</B
  63106. > ( int pdf_document, float gray_value)<BR
  63107. ></BR
  63108. ><P
  63109. >      The <B
  63110. CLASS="function"
  63111. >cpdf_setgray()</B
  63112. > function sets the current
  63113.      drawing and filling color to the given gray value. Vracφ <TT
  63114. CLASS="constant"
  63115. ><B
  63116. >TRUE</B
  63117. ></TT
  63118. > p°i ·sp∞chu, <TT
  63119. CLASS="constant"
  63120. ><B
  63121. >FALSE</B
  63122. ></TT
  63123. > p°i selhßnφ.
  63124.     </P
  63125. ><P
  63126. >      See also <A
  63127. HREF="#function.cpdf-setrgbcolor-stroke"
  63128. ><B
  63129. CLASS="function"
  63130. >cpdf_setrgbcolor_stroke()</B
  63131. ></A
  63132. > and
  63133.      <A
  63134. HREF="#function.cpdf-setrgbcolor-fill"
  63135. ><B
  63136. CLASS="function"
  63137. >cpdf_setrgbcolor_fill()</B
  63138. ></A
  63139. >.
  63140.     </P
  63141. ></DIV
  63142. ><H1
  63143. ><A
  63144. NAME="function.cpdf-setlinecap"
  63145. ></A
  63146. >cpdf_setlinecap</H1
  63147. ><DIV
  63148. CLASS="refnamediv"
  63149. ><A
  63150. NAME="AEN13448"
  63151. ></A
  63152. ><P
  63153. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63154. >cpdf_setlinecap -- Sets linecap parameter</DIV
  63155. ><DIV
  63156. CLASS="refsect1"
  63157. ><A
  63158. NAME="AEN13451"
  63159. ></A
  63160. ><H2
  63161. >Description</H2
  63162. >bool <B
  63163. CLASS="methodname"
  63164. >cpdf_setlinecap</B
  63165. > ( int pdf_document, int value)<BR
  63166. ></BR
  63167. ><P
  63168. >      The <B
  63169. CLASS="function"
  63170. >cpdf_setlinecap()</B
  63171. > function set the linecap
  63172.      parameter between a <TT
  63173. CLASS="parameter"
  63174. ><I
  63175. >value</I
  63176. ></TT
  63177. > of 0 and 2. 
  63178.      0 = butt end, 1 = round, 2 = projecting square. Vracφ <TT
  63179. CLASS="constant"
  63180. ><B
  63181. >TRUE</B
  63182. ></TT
  63183. > p°i ·sp∞chu, <TT
  63184. CLASS="constant"
  63185. ><B
  63186. >FALSE</B
  63187. ></TT
  63188. > p°i selhßnφ.
  63189.     </P
  63190. ></DIV
  63191. ><H1
  63192. ><A
  63193. NAME="function.cpdf-setlinejoin"
  63194. ></A
  63195. >cpdf_setlinejoin</H1
  63196. ><DIV
  63197. CLASS="refnamediv"
  63198. ><A
  63199. NAME="AEN13468"
  63200. ></A
  63201. ><P
  63202. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63203. >cpdf_setlinejoin -- Sets linejoin parameter</DIV
  63204. ><DIV
  63205. CLASS="refsect1"
  63206. ><A
  63207. NAME="AEN13471"
  63208. ></A
  63209. ><H2
  63210. >Description</H2
  63211. >bool <B
  63212. CLASS="methodname"
  63213. >cpdf_setlinejoin</B
  63214. > ( int pdf_document, int value)<BR
  63215. ></BR
  63216. ><P
  63217. >      The <B
  63218. CLASS="function"
  63219. >cpdf_setlinejoin()</B
  63220. > function set the
  63221.      linejoin parameter between a <TT
  63222. CLASS="parameter"
  63223. ><I
  63224. >value</I
  63225. ></TT
  63226. > of
  63227.      0 and 2. 0 = miter, 1 = round, 2 = bevel. Vracφ <TT
  63228. CLASS="constant"
  63229. ><B
  63230. >TRUE</B
  63231. ></TT
  63232. > p°i ·sp∞chu, <TT
  63233. CLASS="constant"
  63234. ><B
  63235. >FALSE</B
  63236. ></TT
  63237. > p°i selhßnφ.
  63238.     </P
  63239. ></DIV
  63240. ><H1
  63241. ><A
  63242. NAME="function.cpdf-setlinewidth"
  63243. ></A
  63244. >cpdf_setlinewidth</H1
  63245. ><DIV
  63246. CLASS="refnamediv"
  63247. ><A
  63248. NAME="AEN13488"
  63249. ></A
  63250. ><P
  63251. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63252. >cpdf_setlinewidth -- Sets line width</DIV
  63253. ><DIV
  63254. CLASS="refsect1"
  63255. ><A
  63256. NAME="AEN13491"
  63257. ></A
  63258. ><H2
  63259. >Description</H2
  63260. >bool <B
  63261. CLASS="methodname"
  63262. >cpdf_setlinewidth</B
  63263. > ( int pdf_document, float width)<BR
  63264. ></BR
  63265. ><P
  63266. >      The <B
  63267. CLASS="function"
  63268. >cpdf_setlinewidth()</B
  63269. > function set the line
  63270.      width to <TT
  63271. CLASS="parameter"
  63272. ><I
  63273. >width</I
  63274. ></TT
  63275. >. Vracφ <TT
  63276. CLASS="constant"
  63277. ><B
  63278. >TRUE</B
  63279. ></TT
  63280. > p°i ·sp∞chu, <TT
  63281. CLASS="constant"
  63282. ><B
  63283. >FALSE</B
  63284. ></TT
  63285. > p°i selhßnφ.
  63286.     </P
  63287. ></DIV
  63288. ><H1
  63289. ><A
  63290. NAME="function.cpdf-setmiterlimit"
  63291. ></A
  63292. >cpdf_setmiterlimit</H1
  63293. ><DIV
  63294. CLASS="refnamediv"
  63295. ><A
  63296. NAME="AEN13508"
  63297. ></A
  63298. ><P
  63299. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63300. >cpdf_setmiterlimit -- Sets miter limit</DIV
  63301. ><DIV
  63302. CLASS="refsect1"
  63303. ><A
  63304. NAME="AEN13511"
  63305. ></A
  63306. ><H2
  63307. >Description</H2
  63308. >bool <B
  63309. CLASS="methodname"
  63310. >cpdf_setmiterlimit</B
  63311. > ( int pdf_document, float value)<BR
  63312. ></BR
  63313. ><P
  63314. >      The <B
  63315. CLASS="function"
  63316. >cpdf_setmiterlimit()</B
  63317. > function set the
  63318.      miter limit to a value greater or equal than 1. Vracφ <TT
  63319. CLASS="constant"
  63320. ><B
  63321. >TRUE</B
  63322. ></TT
  63323. > p°i ·sp∞chu, <TT
  63324. CLASS="constant"
  63325. ><B
  63326. >FALSE</B
  63327. ></TT
  63328. > p°i selhßnφ.
  63329.     </P
  63330. ></DIV
  63331. ><H1
  63332. ><A
  63333. NAME="function.cpdf-setrgbcolor-fill"
  63334. ></A
  63335. >cpdf_setrgbcolor_fill</H1
  63336. ><DIV
  63337. CLASS="refnamediv"
  63338. ><A
  63339. NAME="AEN13527"
  63340. ></A
  63341. ><P
  63342. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63343. >cpdf_setrgbcolor_fill -- Sets filling color to rgb color value</DIV
  63344. ><DIV
  63345. CLASS="refsect1"
  63346. ><A
  63347. NAME="AEN13530"
  63348. ></A
  63349. ><H2
  63350. >Description</H2
  63351. >bool <B
  63352. CLASS="methodname"
  63353. >cpdf_setrgbcolor_fill</B
  63354. > ( int pdf_document, float red_value, float green_value, float blue_value)<BR
  63355. ></BR
  63356. ><P
  63357. >      The <B
  63358. CLASS="function"
  63359. >cpdf_setrgbcolor_fill()</B
  63360. > function sets the current
  63361.      rgb color value to fill a path. Vracφ <TT
  63362. CLASS="constant"
  63363. ><B
  63364. >TRUE</B
  63365. ></TT
  63366. > p°i ·sp∞chu, <TT
  63367. CLASS="constant"
  63368. ><B
  63369. >FALSE</B
  63370. ></TT
  63371. > p°i selhßnφ.
  63372.     </P
  63373. ><DIV
  63374. CLASS="note"
  63375. ><BLOCKQUOTE
  63376. CLASS="note"
  63377. ><P
  63378. ><B
  63379. >Poznßmka: </B
  63380. >
  63381.       The values are expected to be floating point values between 0.0 and
  63382.       1.0. (i.e black is (0.0, 0.0, 0.0) and white is (1.0, 1.0, 1.0)). 
  63383.      </P
  63384. ></BLOCKQUOTE
  63385. ></DIV
  63386. ><P
  63387. >      See also <A
  63388. HREF="#function.cpdf-setrgbcolor-stroke"
  63389. ><B
  63390. CLASS="function"
  63391. >cpdf_setrgbcolor_stroke()</B
  63392. ></A
  63393. > and
  63394.      <A
  63395. HREF="#function.cpdf-setrgbcolor"
  63396. ><B
  63397. CLASS="function"
  63398. >cpdf_setrgbcolor()</B
  63399. ></A
  63400. >.
  63401.     </P
  63402. ></DIV
  63403. ><H1
  63404. ><A
  63405. NAME="function.cpdf-setrgbcolor-stroke"
  63406. ></A
  63407. >cpdf_setrgbcolor_stroke</H1
  63408. ><DIV
  63409. CLASS="refnamediv"
  63410. ><A
  63411. NAME="AEN13557"
  63412. ></A
  63413. ><P
  63414. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63415. >cpdf_setrgbcolor_stroke -- Sets drawing color to rgb color value</DIV
  63416. ><DIV
  63417. CLASS="refsect1"
  63418. ><A
  63419. NAME="AEN13560"
  63420. ></A
  63421. ><H2
  63422. >Description</H2
  63423. >bool <B
  63424. CLASS="methodname"
  63425. >cpdf_setrgbcolor_stroke</B
  63426. > ( int pdf_document, float red_value, float green_value, float blue_value)<BR
  63427. ></BR
  63428. ><P
  63429. >      The <B
  63430. CLASS="function"
  63431. >cpdf_setrgbcolor_stroke()</B
  63432. > function sets the current
  63433.      drawing color to the given rgb color value. Vracφ <TT
  63434. CLASS="constant"
  63435. ><B
  63436. >TRUE</B
  63437. ></TT
  63438. > p°i ·sp∞chu, <TT
  63439. CLASS="constant"
  63440. ><B
  63441. >FALSE</B
  63442. ></TT
  63443. > p°i selhßnφ.
  63444.     </P
  63445. ><DIV
  63446. CLASS="note"
  63447. ><BLOCKQUOTE
  63448. CLASS="note"
  63449. ><P
  63450. ><B
  63451. >Poznßmka: </B
  63452. >
  63453.       The values are expected to be floating point values between 0.0 and
  63454.       1.0. (i.e black is (0.0, 0.0, 0.0) and white is (1.0, 1.0, 1.0)). 
  63455.      </P
  63456. ></BLOCKQUOTE
  63457. ></DIV
  63458. ><P
  63459. >      See also <A
  63460. HREF="#function.cpdf-setrgbcolor-fill"
  63461. ><B
  63462. CLASS="function"
  63463. >cpdf_setrgbcolor_fill()</B
  63464. ></A
  63465. > and
  63466.      <A
  63467. HREF="#function.cpdf-setrgbcolor"
  63468. ><B
  63469. CLASS="function"
  63470. >cpdf_setrgbcolor()</B
  63471. ></A
  63472. >.
  63473.     </P
  63474. ></DIV
  63475. ><H1
  63476. ><A
  63477. NAME="function.cpdf-setrgbcolor"
  63478. ></A
  63479. >cpdf_setrgbcolor</H1
  63480. ><DIV
  63481. CLASS="refnamediv"
  63482. ><A
  63483. NAME="AEN13587"
  63484. ></A
  63485. ><P
  63486. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63487. >cpdf_setrgbcolor -- Sets drawing and filling color to rgb color value</DIV
  63488. ><DIV
  63489. CLASS="refsect1"
  63490. ><A
  63491. NAME="AEN13590"
  63492. ></A
  63493. ><H2
  63494. >Description</H2
  63495. >bool <B
  63496. CLASS="methodname"
  63497. >cpdf_setrgbcolor</B
  63498. > ( int pdf_document, float red_value, float green_value, float blue_value)<BR
  63499. ></BR
  63500. ><P
  63501. >      The <B
  63502. CLASS="function"
  63503. >cpdf_setrgbcolor()</B
  63504. > function sets the current
  63505.      drawing and filling color to the given rgb color value. Vracφ <TT
  63506. CLASS="constant"
  63507. ><B
  63508. >TRUE</B
  63509. ></TT
  63510. > p°i ·sp∞chu, <TT
  63511. CLASS="constant"
  63512. ><B
  63513. >FALSE</B
  63514. ></TT
  63515. > p°i selhßnφ.
  63516.     </P
  63517. ><DIV
  63518. CLASS="note"
  63519. ><BLOCKQUOTE
  63520. CLASS="note"
  63521. ><P
  63522. ><B
  63523. >Poznßmka: </B
  63524. >
  63525.       The values are expected to be floating point values between 0.0 and
  63526.       1.0. (i.e black is (0.0, 0.0, 0.0) and white is (1.0, 1.0, 1.0)). 
  63527.      </P
  63528. ></BLOCKQUOTE
  63529. ></DIV
  63530. ><P
  63531. >      See also <A
  63532. HREF="#function.cpdf-setrgbcolor-stroke"
  63533. ><B
  63534. CLASS="function"
  63535. >cpdf_setrgbcolor_stroke()</B
  63536. ></A
  63537. > and
  63538.      <A
  63539. HREF="#function.cpdf-setrgbcolor-fill"
  63540. ><B
  63541. CLASS="function"
  63542. >cpdf_setrgbcolor_fill()</B
  63543. ></A
  63544. >.
  63545.     </P
  63546. ></DIV
  63547. ><H1
  63548. ><A
  63549. NAME="function.cpdf-show-xy"
  63550. ></A
  63551. >cpdf_show_xy</H1
  63552. ><DIV
  63553. CLASS="refnamediv"
  63554. ><A
  63555. NAME="AEN13617"
  63556. ></A
  63557. ><P
  63558. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63559. >cpdf_show_xy -- Output text at position</DIV
  63560. ><DIV
  63561. CLASS="refsect1"
  63562. ><A
  63563. NAME="AEN13620"
  63564. ></A
  63565. ><H2
  63566. >Description</H2
  63567. >bool <B
  63568. CLASS="methodname"
  63569. >cpdf_show_xy</B
  63570. > ( int pdf_document, string text, float x-coor, float y-coor [, int mode])<BR
  63571. ></BR
  63572. ><P
  63573. >      The <B
  63574. CLASS="function"
  63575. >cpdf_show_xy()</B
  63576. > function outputs the
  63577.      string <TT
  63578. CLASS="parameter"
  63579. ><I
  63580. >text</I
  63581. ></TT
  63582. > at position with coordinates
  63583.      (<TT
  63584. CLASS="parameter"
  63585. ><I
  63586. >x-coor</I
  63587. ></TT
  63588. >, <TT
  63589. CLASS="parameter"
  63590. ><I
  63591. >y-coor</I
  63592. ></TT
  63593. >).
  63594.      Vracφ <TT
  63595. CLASS="constant"
  63596. ><B
  63597. >TRUE</B
  63598. ></TT
  63599. > p°i ·sp∞chu, <TT
  63600. CLASS="constant"
  63601. ><B
  63602. >FALSE</B
  63603. ></TT
  63604. > p°i selhßnφ.
  63605.     </P
  63606. ><P
  63607. >Nepovinn² parametr <TT
  63608. CLASS="parameter"
  63609. ><I
  63610. >mode</I
  63611. ></TT
  63612. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  63613. ><P
  63614. >      <DIV
  63615. CLASS="note"
  63616. ><BLOCKQUOTE
  63617. CLASS="note"
  63618. ><P
  63619. ><B
  63620. >Poznßmka: </B
  63621. >
  63622.        The function <B
  63623. CLASS="function"
  63624. >cpdf_show_xy()</B
  63625. > is identical to
  63626.        <A
  63627. HREF="#function.cpdf-text"
  63628. ><B
  63629. CLASS="function"
  63630. >cpdf_text()</B
  63631. ></A
  63632. > without the optional parameters.
  63633.       </P
  63634. ></BLOCKQUOTE
  63635. ></DIV
  63636. >
  63637.     </P
  63638. ><P
  63639. >      See also <A
  63640. HREF="#function.cpdf-text"
  63641. ><B
  63642. CLASS="function"
  63643. >cpdf_text()</B
  63644. ></A
  63645. >.
  63646.     </P
  63647. ></DIV
  63648. ><H1
  63649. ><A
  63650. NAME="function.cpdf-show"
  63651. ></A
  63652. >cpdf_show</H1
  63653. ><DIV
  63654. CLASS="refnamediv"
  63655. ><A
  63656. NAME="AEN13657"
  63657. ></A
  63658. ><P
  63659. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63660. >cpdf_show -- Output text at current position</DIV
  63661. ><DIV
  63662. CLASS="refsect1"
  63663. ><A
  63664. NAME="AEN13660"
  63665. ></A
  63666. ><H2
  63667. >Description</H2
  63668. >bool <B
  63669. CLASS="methodname"
  63670. >cpdf_show</B
  63671. > ( int pdf_document, string text)<BR
  63672. ></BR
  63673. ><P
  63674. >      The <B
  63675. CLASS="function"
  63676. >cpdf_show()</B
  63677. > function outputs the
  63678.      string in <TT
  63679. CLASS="parameter"
  63680. ><I
  63681. >text</I
  63682. ></TT
  63683. > at the current position.
  63684.      Vracφ <TT
  63685. CLASS="constant"
  63686. ><B
  63687. >TRUE</B
  63688. ></TT
  63689. > p°i ·sp∞chu, <TT
  63690. CLASS="constant"
  63691. ><B
  63692. >FALSE</B
  63693. ></TT
  63694. > p°i selhßnφ.
  63695.     </P
  63696. ><P
  63697. >      See also <A
  63698. HREF="#function.cpdf-text"
  63699. ><B
  63700. CLASS="function"
  63701. >cpdf_text()</B
  63702. ></A
  63703. >,
  63704.      <A
  63705. HREF="#function.cpdf-begin-text"
  63706. ><B
  63707. CLASS="function"
  63708. >cpdf_begin_text()</B
  63709. ></A
  63710. > and
  63711.      <A
  63712. HREF="#function.cpdf-end-text"
  63713. ><B
  63714. CLASS="function"
  63715. >cpdf_end_text()</B
  63716. ></A
  63717. >.
  63718.     </P
  63719. ></DIV
  63720. ><H1
  63721. ><A
  63722. NAME="function.cpdf-stringwidth"
  63723. ></A
  63724. >cpdf_stringwidth</H1
  63725. ><DIV
  63726. CLASS="refnamediv"
  63727. ><A
  63728. NAME="AEN13681"
  63729. ></A
  63730. ><P
  63731. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63732. >cpdf_stringwidth -- Returns width of text in current font</DIV
  63733. ><DIV
  63734. CLASS="refsect1"
  63735. ><A
  63736. NAME="AEN13684"
  63737. ></A
  63738. ><H2
  63739. >Description</H2
  63740. >float <B
  63741. CLASS="methodname"
  63742. >cpdf_stringwidth</B
  63743. > ( int pdf_document, string text)<BR
  63744. ></BR
  63745. ><P
  63746. >      The <B
  63747. CLASS="function"
  63748. >cpdf_stringwidth()</B
  63749. > function returns the
  63750.      width of the string in <TT
  63751. CLASS="parameter"
  63752. ><I
  63753. >text</I
  63754. ></TT
  63755. >. It requires
  63756.      a font to be set before.
  63757.     </P
  63758. ><P
  63759. >      See also <A
  63760. HREF="#function.cpdf-set-font"
  63761. ><B
  63762. CLASS="function"
  63763. >cpdf_set_font()</B
  63764. ></A
  63765. >.
  63766.     </P
  63767. ></DIV
  63768. ><H1
  63769. ><A
  63770. NAME="function.cpdf-stroke"
  63771. ></A
  63772. >cpdf_stroke</H1
  63773. ><DIV
  63774. CLASS="refnamediv"
  63775. ><A
  63776. NAME="AEN13701"
  63777. ></A
  63778. ><P
  63779. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63780. >cpdf_stroke -- Draw line along path</DIV
  63781. ><DIV
  63782. CLASS="refsect1"
  63783. ><A
  63784. NAME="AEN13704"
  63785. ></A
  63786. ><H2
  63787. >Description</H2
  63788. >bool <B
  63789. CLASS="methodname"
  63790. >cpdf_stroke</B
  63791. > ( int pdf_document)<BR
  63792. ></BR
  63793. ><P
  63794. >      The <B
  63795. CLASS="function"
  63796. >cpdf_stroke()</B
  63797. > function draws a line along
  63798.      current path. Vracφ <TT
  63799. CLASS="constant"
  63800. ><B
  63801. >TRUE</B
  63802. ></TT
  63803. > p°i ·sp∞chu, <TT
  63804. CLASS="constant"
  63805. ><B
  63806. >FALSE</B
  63807. ></TT
  63808. > p°i selhßnφ.
  63809.     </P
  63810. ><P
  63811. >      See also <A
  63812. HREF="#function.cpdf-closepath"
  63813. ><B
  63814. CLASS="function"
  63815. >cpdf_closepath()</B
  63816. ></A
  63817. > and
  63818.      <A
  63819. HREF="#function.cpdf-closepath-stroke"
  63820. ><B
  63821. CLASS="function"
  63822. >cpdf_closepath_stroke()</B
  63823. ></A
  63824. >.
  63825.     </P
  63826. ></DIV
  63827. ><H1
  63828. ><A
  63829. NAME="function.cpdf-text"
  63830. ></A
  63831. >cpdf_text</H1
  63832. ><DIV
  63833. CLASS="refnamediv"
  63834. ><A
  63835. NAME="AEN13720"
  63836. ></A
  63837. ><P
  63838. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63839. >cpdf_text -- Output text with parameters</DIV
  63840. ><DIV
  63841. CLASS="refsect1"
  63842. ><A
  63843. NAME="AEN13723"
  63844. ></A
  63845. ><H2
  63846. >Description</H2
  63847. >bool <B
  63848. CLASS="methodname"
  63849. >cpdf_text</B
  63850. > ( int pdf_document, string text, float x-coor, float y-coor [, int mode [, float orientation [, int alignmode]]])<BR
  63851. ></BR
  63852. ><P
  63853. >      The <B
  63854. CLASS="function"
  63855. >cpdf_text()</B
  63856. > function outputs the string
  63857.      <TT
  63858. CLASS="parameter"
  63859. ><I
  63860. >text</I
  63861. ></TT
  63862. > at position with coordinates
  63863.      (<TT
  63864. CLASS="parameter"
  63865. ><I
  63866. >x-coor</I
  63867. ></TT
  63868. >, <TT
  63869. CLASS="parameter"
  63870. ><I
  63871. >y-coor</I
  63872. ></TT
  63873. >).
  63874.      Vracφ <TT
  63875. CLASS="constant"
  63876. ><B
  63877. >TRUE</B
  63878. ></TT
  63879. > p°i ·sp∞chu, <TT
  63880. CLASS="constant"
  63881. ><B
  63882. >FALSE</B
  63883. ></TT
  63884. > p°i selhßnφ.
  63885.     </P
  63886. ><P
  63887. >Nepovinn² parametr <TT
  63888. CLASS="parameter"
  63889. ><I
  63890. >mode</I
  63891. ></TT
  63892. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  63893. ><P
  63894. >      The optional parameter <TT
  63895. CLASS="parameter"
  63896. ><I
  63897. >orientation</I
  63898. ></TT
  63899. > is the
  63900.      rotation of the text in degree.
  63901.     </P
  63902. ><P
  63903. >      The optional parameter <TT
  63904. CLASS="parameter"
  63905. ><I
  63906. >alignmode</I
  63907. ></TT
  63908. > determines
  63909.      how the text is aligned.
  63910.     </P
  63911. ><P
  63912. >      See the ClibPDF documentation for possible values.
  63913.     </P
  63914. ><P
  63915. >      See also <A
  63916. HREF="#function.cpdf-show-xy"
  63917. ><B
  63918. CLASS="function"
  63919. >cpdf_show_xy()</B
  63920. ></A
  63921. >.
  63922.     </P
  63923. ></DIV
  63924. ><H1
  63925. ><A
  63926. NAME="function.cpdf-translate"
  63927. ></A
  63928. >cpdf_translate</H1
  63929. ><DIV
  63930. CLASS="refnamediv"
  63931. ><A
  63932. NAME="AEN13766"
  63933. ></A
  63934. ><P
  63935. >    (PHP 3>= 3.0.8, PHP 4 )</P
  63936. >cpdf_translate -- Sets origin of coordinate system</DIV
  63937. ><DIV
  63938. CLASS="refsect1"
  63939. ><A
  63940. NAME="AEN13769"
  63941. ></A
  63942. ><H2
  63943. >Description</H2
  63944. >bool <B
  63945. CLASS="methodname"
  63946. >cpdf_translate</B
  63947. > ( int pdf_document, float x-coor, float y-coor [, int mode])<BR
  63948. ></BR
  63949. ><P
  63950. >      The <B
  63951. CLASS="function"
  63952. >cpdf_translate()</B
  63953. > function set the origin of
  63954.      coordinate system to the point (<TT
  63955. CLASS="parameter"
  63956. ><I
  63957. >x-coor</I
  63958. ></TT
  63959. >,
  63960.      <TT
  63961. CLASS="parameter"
  63962. ><I
  63963. >y-coor</I
  63964. ></TT
  63965. >). Vracφ <TT
  63966. CLASS="constant"
  63967. ><B
  63968. >TRUE</B
  63969. ></TT
  63970. > p°i ·sp∞chu, <TT
  63971. CLASS="constant"
  63972. ><B
  63973. >FALSE</B
  63974. ></TT
  63975. > p°i selhßnφ.
  63976.     </P
  63977. ><P
  63978. >Nepovinn² parametr <TT
  63979. CLASS="parameter"
  63980. ><I
  63981. >mode</I
  63982. ></TT
  63983. > urΦuje dΘlku jednotky. Kdy╛ je nastaven na 0 nebo nenφ uveden, je pou╛ita v²chozφ jednotka strßnky. Jinak jsou sou°adnice m∞°eny v bodech PostScript bez ohledu na aktußlnφ jednotku.</P
  63984. ></DIV
  63985. ></DIV
  63986. ><DIV
  63987. CLASS="reference"
  63988. ><A
  63989. NAME="ref.crack"
  63990. ></A
  63991. ><DIV
  63992. CLASS="TITLEPAGE"
  63993. ><H1
  63994. CLASS="title"
  63995. >XI. Crack functions</H1
  63996. ><DIV
  63997. CLASS="PARTINTRO"
  63998. ><A
  63999. NAME="AEN13797"
  64000. ></A
  64001. ><DIV
  64002. CLASS="section"
  64003. ><H1
  64004. CLASS="section"
  64005. ><A
  64006. NAME="crack.intro"
  64007. ></A
  64008. >┌vod</H1
  64009. ><P
  64010. >      These functions allow you to use the CrackLib library to test the
  64011.      'strength' of a password.  The 'strength' of a pa