cvs: phpdoc-ar /chapters tutorial.xml
[email protected] ("Hafid Benhadria") Fri, 25 Jul 2003 00:29:06 -0000
| Newsgroups | php.doc.ar |
|---|---|
| Message-ID | <cvshafid1059092946@cvsserver> |
hafid Thu Jul 24 20:29:06 2003 EDT
Added files:
/phpdoc-ar/chapters tutorial.xml
Log:
Updated to En 1.14
hafid-20030724202906.txt
(text/plain, 27 KB)
Index: phpdoc-ar/chapters/tutorial.xml
+++ phpdoc-ar/chapters/tutorial.xml
<?xml version="1.0" encoding="ISO-8859-6"?>
<!-- $Revision: 1.1 $ -->
<!-- Updated to En 1.14 -->
<chapter id="tutorial">
<title>ÏÑÓ ÈÓê×</title>
<para>
æèÏ çæÇ åæ ÎäÇä çÐÇ ÇäÏÑÓ ÇäÈÓê× èÇäèÌêÒ Ãæ æØçÑ ÇäÃÓÓ ÇäÃèäêÉ ä PHP.
çÐÇ ÇäæÕ êçÊå ÈåèÖèÙ ÅæÔÇÁ ÕáÍÇÊ èêÈ ÊáÇÙäêÉ ÈèÇÓ×É
PHP¬ ÈÇäÑÚå åæ Ãæ PHP ÇäÐê çè ÇäèÍêÏ ÇäÐê ÈÅåãÇæç ÅæÔÇÁ ÕáÍÇÊ èêÈ. ÅÓÊÙÑÖ
ÇäáÕä ÇäåÙæèæ <link linkend="intro-whatcando">åÇÐÇ êåãæ äÈê ÃÊÔ Èê PHP Ãæ êâèå Èç¿</link>
èÐäã åæ ÃÌä ÇäÍÕèä Ùäé åÙäèåÇÊ ÃèáÑ.
</para>
<para>
ÕáÍÇÊ ÇäèêÈ Çäå×ÙåÉ È PHP êÊå ÇäÊÙÇåä åÙçÇ åËäçÇ åËä ÕáÍÇÊ HTML ÙÇÏêÉ
èêåãæã ÅÍÏÇËçÇ èÊÍÑêÑçÇ ÈæáÓ Çä×ÑêâÉ ÇäåÙÑèáÉ ÇäÊê Êâèå ÈçÇ ÈÅÍÏÇË
ÕáÍÇÊ HTML ÇäÅÙÊêÇÏêÉ.
</para>
<sect1 id="tutorial.requirements">
<title>åÇ ÇäÐê ÃÍÊÇÌ Åäêç¿</title>
<para>
áê çÐÇ ÇäÏÑÓ¬ æáÊÑÖ Ãæã åÒèÏã êÏÙå PHP
åÔÚäÇ èÈÃæ ãä ÇäåäáÇÊ ÇäåæÊçêÉ ÈÊèÓÙ <filename>.php</filename>
êÊå ÊÏÇèäçÇ åæ âÈä PHP. Ùäé åÙ×å ÇäåÒèÏÇʬ êÙÊÈÑ çÐÇ çè ÇäÊèÓÙ ÇäÅáÊÑÇÖê
ÈÇäæÓÈÉ äåäáÇÊ PHP¬ èäãæ ÅÓÃä ÇäåÓÄèä Ùæ ÇäåÒèÏ åæ ÃÌä ÇäÊÃãÏ åæ Ðäã. ÅÐÇ
ãÇæ åÒèÏã êÏÙå PHP áäæ êãèæ åäÒåÇ Ùäêã ÇäâêÇå ÈÃê ÔêÁ. áâ×
ÃæÔà åäáÇÊ <filename>.php</filename>¬ ÎÇÕÊ㬠èÖÙçÇ áê Ïäêäã
ääèêÈ èÓêâèå ÇäåÒèÏ ÈÊáÓêÑçÇ ä㬠È×ÑêâÉ ÓÍÑêÉ.
äêÓÊ çæÇã åæ ÍÇÌÉ äÊÌåêÙ compile Ãê ÔêÁ èäÇ ÃæÊ ÈÍÇÌÉ äÊËÈêÊ
Ãê èÓÇÆä ÎÇÑÌêÉ. áãÑ áê çÐç ÇäåäáÇÊ Çäå×ÙåÉ È PHP èãÃæçÇ åäáÇÊ HTML
ÈÓê×É åÊÖåæÉ åÌåèÙÉ ÌÏêÏÉ èãÇåäÉ åæ ÇäèÓèå ÇäÓÍÑêÉ ÇäÊê ÊÓåÍ äã ÈÇäâêÇå ÈÌåêÙ ÇäÃæèÇÙ
åæ ÇäÃÙåÇä.
</para>
<para>
äæâä Ãæã ÊèÏ ÇäÍáÇØ Ùäé ÍÌå ÇäåÙ×êÇÊ ÇäÓêÇÑÉ bandwidth ÇäËåêæÉ äÏêã èÈÃæã ÊèÏ ÇäÊ×èêÑ ÈÔãä åÍäê.
áê çÐç ÇäÍÇäɬ ÓÊèÏ ÊËÈêÊ åÒèÏ ääèêÈ åËä
<link linkend="install.apache">Apache</link>¬ èÈÇä×ÈÙ
<ulink url="&url.php.downloads;">PHP</ulink>. èÃÚäÈ ÇäØæ Ãæã ÓÊèÏ ÃêÖÇ
ÊËÈêÊ âÇÙÏÉ ÈêÇæÇÊ åËä
<ulink url="&url.mysql.docs;">MySQL</ulink>. ÈÅåãÇæã ÊËÈêÊ
çÐç È×ÑêâÉ ÃÍÇÏêÉ Ãè È×ÑêâÉ ÃÓçä ÊÊåËä áê <ulink url="&url.installkits;">ÊÍÏêÏ ÊÌåêÙÉ package åçêÆÉ åÓÈâÇ</ulink>
êåãæçÇ ÇäâêÇå ÈËÈêÊ Âäê äãä çÏç ÇäåãèæÇʬ áâ× ÈÈÖÙ ãÈÓÇÊ ÒÑ
Ùäé ÇäáÃÑÉ. Åæç äåæ ÇäÓçä ÇäâêÇå ÈÊËÈêÊ åÒèÏ èêÈ êÏÙå PHP Ùäé Ãê
æØÇå ÊÔÚêä¬ ÈåÇ áê Ðäã Linux è Windows. ÈÇäæÓÈÉ ä Linux¬
áÓÊÌÏ åèâÙ <ulink url="&url.rpmfind;">rpmfind</ulink> åáêÏÇ
äÅêÌÇÏ ÈÑÇåÌ RPM.
</para>
</sect1>
<sect1 id="tutorial.firstpage">
<title>ÕáÍÊã ÇäÃèäé Çäå×ÙåÉ È PHP</title>
<para>
ÃæÔà åäáÇ êÓåé <filename>hello.php</filename> èÖÙç
áê ÇäÏäêä ÇäÌÐÑê äåÒèÏ ÇäèêȬ ÎÇÕÊ㬠(<varname>DOCUMENT_ROOT</varname>)
èÇÌÙä åÖåèæç ãÇäÊÇäê:
</para>
<para>
<example>
<title>Ãèä ÓãÑêÈÊ PHP äæÇ: <filename>hello.php</filename>
</title>
<programlisting role="php"><![CDATA[
<html lang=ar dir=rtl>
<head>
<title>ÊÌÑêÈ PHP</title>
</head>
<body>
<?php echo "<p>ÃçäÇ êÇ ÙÇäå</p>"; ?>
</body>
</html>
]]></programlisting>
<simpara>
ÅÓÊÙåä åÓÊÙÑÖã ääèêÈ åæ ÃÌä èäèÌ Çäåäá Ùæ ÈÙÏ åæ ÎäÇä åÍÏÏ åèâÙ URL¬ êæÊçê
ÈÇäÅÔÇÑÉ ÇäåÑÌÙêÉ Åäé Çäåäá "/hello.php". ÅÐÇ ãæÊ ÈÕÏÏ ÇäÈÑåÌÉ åÍäêÇ áÅæ
åÍÏÏ ÇäåèâÙ ÓêØçÑ Ùäé åËä çÐç ÇäÔÇãäÉ <literal>http://localhost/hello.php</literal>
Ãè <literal>http://127.0.0.1/hello.php</literal> ÈÍÓÈ Çä×ÑêâÉ ÇäÊê ÊåÊ ÈçÇ
ÊçêÆÉ åÒèÏ ÇäèêÈ. ÈÇäÑÚå åæ Ãæ çÐÇ êÊÌÇèÒ åÑåé ÇçÊåÇå çÐÇ
ÇäÏÑÓ¬ áÈÅåãÇæã ÃêÖÇ ÇäÅÓÊÙäÇå ÈÎÕèÕ ÊèÌêçÇÊ <varname>DocumentRoot</varname>
è <varname>ServerName</varname> ÇäåÍÏÏÉ áê åäá ÊçêÆÉ
åÒèÏã ääèêÈ. (åËäÇ Ùäé Apache ÇäÃåÑ êÊÙäâ È &httpd.conf;).
ÅÐÇ Êå ÊËÈêÊ ãä ÔêÁ ÈÔãä ÕÍêͬ áÅæ çÐÇ Çäåäá ÓêÊå ÊáÓêÑç åæ âÈä PHP
èÓÊØçÑ ÇäæÊêÌÉ ÇäÊÇäêÉ áê åÓÊÙÑÖã:
</simpara>
<para>
<screen role="html"><![CDATA[
<html lang=ar dir=rtl>
<head>
<title>ÊÌÑêÈ PHP</title>
</head>
<body>
<p>ÃçäÇ êÇ ÙÇäå</p>
</body>
</html>
]]></screen>
</para>
</example>
</para>
<para>
ÅæÊÈç Åäé Ãæ çÐÇ äêÓ åËä ÓãÑêÈÊ CGI. Çäåäá äÇ êÍÊÇÌ Ãæ êãèæ âÇÈäÇ
ääÊæáêÐ Ãè ÎÇÕÇ áê Ãê æÇÍêÉ åæ ÇäæèÇÍê. áãÑ Èç Ùäé Ãæç åäá HTML
ÙÇÏê êÍÏË Ãæç êÊÖåæ åÌåèÙÉ åæ ÇäèÓèå ÇäÎÇÕÉ ÇäÊê ÊÓåÍ
ÈÇäâêÇå ÈÇäãËêÑ åæ ÇäåçÇå ÇäÔêâÉ.
</para>
<para>
çÐÇ ÇäÈÑæÇåÌ ÔÏêÏ ÇäÈÓÇ×É èáÙäÇ ÃæÊ äå Êãæ ÈÍÇÌÉ Åäé ÇÓÊÙåÇä
PHP åæ ÃÌä ÅæÔÇÁ ÕáÍÉ åËä çÐç. ãä åÇ Êâèå Èç çè ÙÑÖ:
<literal>ÃçäÇ êÇ ÙÇäå</literal> ÈÇÓÊÙåÇä ÈäÇÚ statement <function>echo</function>
áê PHP.
</para>
<para>
ÅÐÇ ÌÑÈÊ çÐÇ ÇäåËÇä èäå êÕÏÑ Ùæç Ãê ÔêÁ Ãè Ãæã ÓÆäÊ Åæ ãæÊ ÊèÏ
ÊÍåêäç Ãè Ãæã äÇÍØÊ Çäåäá ãÇåäÇ ãæÕ¬ áÅæ ÇäÃÌäé Ãæ
ÇäåÒèÏ ÇäÐê ÊÙåä Ùäêç äêÓ Èç PHP åáÙä. ÅÓÃä åÏêÑ ÇäåÒèÏ
Ãæ êâèå ÈÊáÙäêç äÃÌäã åÓÊÙêæÇ ÈáÕä
<link linkend="installation">ÇäÊËÈêÊ</link> ÇäåÊÖåæ áê
ÇäÏäêä. ÅÐÇ ãæÊ ÈÕÏÏ ÇäÈÑåÌÉ áê Å×ÇÑ åÍäê¬ áÅ×äÙ ÃêÖÇ Ùäé
áÕä ÇäÊËÈêÊ åæ ÃÌä ÇäÊÃãÏ Ãæ ãä ÔêÁ åçêÆ ãåÇ êæÈÚê.
ÅÐÇ ÇÓÊåÑÊ ÇäåÔÇãä áê ÇäÅäÍÇͬ áäÇ ÊÊÑÏ áê ÇÓÊÙåÇä ÅÍÏé
ÎêÇÑÇÊ <ulink url="&url.php.support;">ÏÙå PHP</ulink> ÇäÙÏêÏÉ.
</para>
<para>
ÚÑÖ çÐÇ ÇäåËÇä çè ÅØçÇÑ ÇäÔãä ÇäÎÇÕ äèÓå PHP.
áê çÐÇ ÇäåËÇä¬ ÅÓÊÙåäæÇ <literal><?php</literal> ääÅÔÇÑÉ Åäé
ÈÏÇêÉ èÓå PHP. ÈÙÏçÇ ÃÏÑÌæÇ ÈäÇÚ PHP èåæ Ëå ÎÑÌæÇ åæ æå× PHP åæ ÎäÇä
ÅÖÇáÉ èÓå ÇäÅÚäÇâ <literal>?></literal>. êåãæã ÇäÅæÊâÇä åæ èÅäé
æå× PHP áê åäá HTML ãåÇ ÊÔÇÁ¬ ãåÇ ÍÏË áê çÐÇ ÇäåËÇä. åæ ÃÌä ÊáÇÕêä ÃèáѬ
ÅÓÊÙÑÖ áÕä ÇäÏäêä ÇäåÊÙäâ È <link linkend="language.basic-syntax">
ÇäÕêÚÉ ÇäÃÓÇÓêÉ ä PHP</link>.
</para>
<note>
<title>ÊÐãêÑ ÈÎÕèÕ ÇäåÍÑÑÇÊ ÇäæÕêÉ</title>
<para>
çæÇã ÇäÙÏêÏ åæ ÇäåÍÑÑÇÊ ÇäæÕêÉ èÈêÆÇÊ ÇäÊ×èêÑ ÇäåÊãÇåäÉ Integrated Development Environments (IDE)
ÇäÊê ÈÅåãÇæã ÇÓÊÙåÇäçÇ åæ ÃÌä ÅæÔÇÁ¬ ÊÍÑêÑ èÊæØêå åäáÇÊ PHP. çæÇã âÇÆåÉ ÌÒÆêÉ
åæ çÐç ÇäèÓÇÆä ÊÊå ÑÙÇêÊçÇ åæ ÎäÇä <ulink url="&url.phpeditorlist;">âÇÆåÉ åÍÑÑÇÊ PHP</ulink>.
ÅÐÇ ãæÊ ÊèÏ ÇäÊèÕêÉ ÈåÍÑÑ åǬ áÑÌÇÁ âå ÈÒêÇÉ ÇäÕáÍÉ ÇäåÐãèÑÉ
èÇÓÃä ÑÇÙêçÇ Ãæ êÖêá ÇäåÍÑÑ Åäé ÇäâÇÆåÉ. ÍêÇÒÉ
åÍÑÑ êÊèáÑ Ùäé åêÒÉ ÅÈÑÇÒ ÇäÕêÚ syntax highlighting êåãæ Ãæ êãèæ åáêÏÇ.
</para>
</note>
<note>
<title>ÊÐãêÑ ÈÎÕèÕ åÙÇäÌÇÊ ÇäãäåÇÊ Word Processors</title>
<para>
åÙÇäÌÇÊ ÇäãäåÇÊ Ùäé ÔÇãäÉ StarOffice Writer¬ Microsoft Word è Abiword äêÓÊ
ÈÇäÎêÇÑ ÇäåáÖä äÊÍÑêÑ åäáÇÊ PHP. ÅÐÇ ãæÊ ÊÊåæé ÇÓÊÙåÇä ÅÍÏÇçÇ åæ ÃÌä çÐÇ
ÇäÓãÑêÈÊ ÇäÊÌÑêÈê¬ áÙäêã ÇäÊÃãÏ åæ Ãæã âåÊ ÈÍáØ Çäåäá ãæÕ ÎÇå PLAIN TEXT èÅäÇ áÅæ PHP
äæ êãèæ âÇÏÑÇ Ùäé âÑÇÁÉ ÇäÓãÑêÈÊ èÊæáêÐç.
</para>
</note>
<note>
<title>ÊÐãêÑ ÈÎÕèÕ ÇäåáãÑÉ Notepad áê Windows</title>
<para>
ÅÐÇ ãæÊ ÈÕÏÏ ÅæÔÇÁ ÓãÑêÈÊÇÊ PHP ÈÇÓÊÙåÇä åáãÑÉ èêæÏèÒ¬ áÅæã ÈÍÇÌÉ
ääÊÃãÏ åæ Ãæ åäáÇÊã êÊå ÍáØçÇ ÈÊèÓÙ .php. (Êâèå ÇäåáãÑÉ Notepad ÊäâÇÆêÇ ÈÅÖÇáÉ
ÊèÓÙ .txt ääåäáÇÊ ÅäÇ ÅÐÇ ÇÊÎÐÊ ÅÍÏé
ÇäÎ×èÇÊ ÇäÊÇäêÉ åæ ÃÌä ÊÌæÈ Ðäã.) ÙæÏåÇ Êâèå ÈÍáØ Çäåäá ÓÊå ÓÄÇäã
äÅÙ×ÇÁ ÅÓå ääåäᬠÍêæçÇ âå ÈÅÏÑÇÌ ÅÓå Çäåäá Öåæ ÙäÇãåÊê ÊæÕêÕ åÒÏèÌÊêæ
(Ãê "<filename>hello.php</filename>")¬ ÈÏäÇ åæ Ðä㬠êåãæã ÇäÖÚ×
Ùäé ÎêÇÑ ÇäÅáäÇÊ ääÃÓáä drop-down menu 'Text Documents' áê åÑÈÙ ÍèÇÑ ÇäÍáØ èÊÚêêÑç Åäé
"All Files". ÙæÏÆЬ Óêãèæ ÈÅåãÇæã ÅÏÑÇÌ ÅÓå Çäåäá åæ Ïèæ ÙäÇåÊê ÇäÊæÕêÕ ÇäåÒÏèÌÊêæ.
</para>
</note>
<para>
ÇäÂæ èâÏ ÃæÔÃÊ ÈæÌÇÍ ÓãÑêÈÊ PHP ÈÓê× êÙåä¬ ÍÇæ
ÇäèâÊ äÅæÔÇÁ ÃãËÑ ÓãÑêÈÊ PHP ÔçÑÉ! ÅÓÊÙæ ÈÏÇäÉ
<function>phpinfo</function> èÓÊÑé ÇäãËêÑ åæ ÇäåÙäèåÇÊ ÇäåáêÏÉ
ÈÎÕèÕ æØÇåã èÊËÈêÊã åËä
<link linkend="language.variables.predefined">ÇäåÊÚêÑÇÊ ÇäåÙÑáÉ åÓÈâÇ Predefined Variables</link>¬
èÍÏÇÊ PHP ÇäåÍåäÉ èÅÙÏÇÏÇÊ <link linkend="configuration">ÇäÊçêÆÉ</link>.
ÅâÖê ÈÙÖ ÇäÈÙÖ èÑÇÌÙ çÐç ÇäåÙäèåÇÊ ÇäåçåÉ.
</para>
</sect1>
<sect1 id="tutorial.useful">
<title>ÔêÁ åáêÏ</title>
<para>
äæâå ÇäÂæ ÈÔêÁ ÃãËÑ ÅáÇÏÉ ÔêÆÇ åÇ. æÍæ ÇäÂæ ÈÕÏÏ ÇäÊÃãÏ
æèÙ ÇäåÓÊÙÑÖ ÇäÐê êÓÊÙåäç ÇäÔÎÕ ääÅ×äÇÙ Ùäé ÇäÕáÍÉ.
åæ ÃÌä ÇäâêÇå ÈçÐǬ æâèå ÈåÑÇâÈÉ ÇäÓäÓäÉ ÇäæÕêÉ äÙåêä ÇäåÓÊÎÏå user agent string ÇäÊê êÑÓäçÇ ÇäåÓÊÙÑÖ
ãÌÒÁ åæ ÅÓÊÙäÇå HTTP. çÐç ÇäåÙäèåÉ êÊå ÍáØçÇ <link linkend="language.variables">åÊÚêÑ</link>. ÇäåÊÚêÑÇÊ ÊÈÏà ÏÇÆåÇ
ÈÑåÒ ÇäÏèäÇÑ áê PHP. ÇäåÊÚêÑ ÇäÐê êçåæÇ áê çÐÇ ÇäÍêæ
çè <varname>$_SERVER["HTTP_USER_AGENT"]</varname>.
</para>
<note>
<title>ÊÐãêÑ ÈÎÕèÕ ÇäÔÇåäÇÊ ÇäÂäêÉ Autoglobals áê PHP</title>
<para>
<link linkend="reserved.variables.server">$_SERVER</link> çè
ÃÍÏ åÊÚêÑÇÊ PHP ÇäÍÕÑêÉ ÇäÎÇÕÉ èÇäÐê êÖå ãä ÇäåÙäèåÇÊ ÇäåÊÙäâÉ ÈåÒèÏ ÇäèêÈ.
çè åÙÑèá ãÃÍÏ ÇäÔÇåäÇÊ ÇäÂäêÉ Autoglobal (Ãè áÇÆâÇÊ ÇäÔåèä Superglobal). ÅÓÊÙÑÖ ÕáÍÉ ÇäÏäêä ÇäÎÇÕÉ È
<link linkend="language.variables.superglobals">ÇäÔÇåäÇÊ ÇäÂäêÉ Autoglobals</link>
åæ ÃÌä åÙäèåÇÊ ÃãËÑ. çÐç ÇäåÊÚêÑÇÊ ÇäÎÇÕÉ âÐ Êå ÅÏÑÇÌçÇ áê PHP
<ulink url="&url.php.release4.1.0;">4.1.0</ulink>. âÈä çÐÇ ÇäÒåæ¬ ãæÇ æÓÊÙåä
ÈÏäÇ åæç åÕáèáÉ <varname>$HTTP_*_VARS</varname> ÇäÃâÏå¬
åËä <varname>$HTTP_SERVER_VARS</varname>. ÈÇäÑÚå åæ ÃæçÇ ÚêÑ Ðê ÃçåêÉ ÅäÇ
Ãæ çÐç ÇäåÊÚêÑÇÊ ÇäâÏêåÉ äÇ ÒÇäÊ åèÌèÏÉ. (ÅÓÊÙÑÖ ÃêÖÇ ÇäÊÐãêÑ ÈÎÕèÕ
<link linkend="tutorial.oldcode">ÇäÔêáÑÉ ÇäâÏêåÉ</link>.)
</para>
</note>
<para>
ÈÈÓÇ×ɬ êåããæÇ ÅØçÇÑ çÐÇ ÇäåÊÚêÑÇ áâ× åæ ÎäÇä:
</para>
<para>
<example>
<title>×ÈÇÙÉ åÊÚêÑ (ÙæÕÑ åÕáèáÉ Array element)</title>
<programlisting role="php"><![CDATA[
<?php echo $_SERVER["HTTP_USER_AGENT"]; ?>
]]></programlisting>
<para>
æåèÐÌ Ùæ æÊêÌÉ çÐÇ ÇäÓãÑêÈÊ êåãæ Ãæ êãèæ ãÇäÊÇäê:
<screen role="html">
Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)
</screen>
</para>
</example>
</para>
<para>
êÊèáÑ PHP Ùäé ÇäÙÏêÏ åæ <link linkend="language.types">ÃæèÇÙ</link>
ÇäåÊÚêÑÇÊ. áê ÇäåËÇä ÇäÓÇÈ⬠âåæÇ È×ÈÇÙÉ
ÙæÕÑ <link linkend="language.types.array">åÕáèáÉ</link>.
êåãæ ääåÕáèáÇÊ Ãæ Êãèæ ÌÏ åáêÏÉ.
</para>
<para>
<varname>$_SERVER</varname> çè áâ× ÃÍÏ ÇäåÊÚêÑÇÊ ÇäÊê êèáÑçÇ äã
PHP È×ÑêâÉ ÂäêÉ. êåãæã ÅÓÊÙÑÇÖ âÇÆåÉ äçÇ áê áÕä
<link linkend="reserved.variables">ÇäåÊÚêÑÇÊ ÇäåÍÌèÒÉ Reserved Variables</link>
áê çÐÇ ÇäÏäêä èÅäÇ áÅæç ÈÅåãÇæã ÇäÍÕèä Ùäé âÇÆåÉ ãÇåäÉ äçÇ åæ ÎäÇä ÅæÔÇÁ
åäá êÔÈç åÇ êäê:
</para>
<para>
<example>
<title>ÃØçÑ ãä ÇäåÊÚêÑÇÊ ÇäåÙêæÉ åÓÈâÇ ÈèÇÓ×É <function>phpinfo</function>
</title>
<programlisting role="php"><![CDATA[
<?php phpinfo(); ?>
]]></programlisting>
</example>
</para>
<para>
ÅÐÇ âåÊ ÈÊÍåêä Çäåäá áê åÓÊÙÑÖ㬠áÅæç Óêãèæ ÈÅåãÇæã åäÇÍØÉ ÕáÍÉ
åäêÆÉ ÈÇäåÙäèåÇÊ ÈÎÕèÕ PHP èÈçÇ ÃêÖÇ âÇÆåÉ Èãä ÇäåÊÚêÑÇÊ
ÇäåÊèáÑÉ äÏêã.
</para>
<para>
êåãæã èÖÙ ÙÏÉ ÈäÇÚÇÊ PHP Öåæ èÓå PHP èÅæÔÇÁ
åâÇ×Ù ÕÚêÑÉ åæ ÇäÔêáÑÉ Êâèå ÈÃãËÑ åæ åÌÑÏ echo åæáÑÏ.
åËäǬ ÅÐÇ ãæÇ æÑêÏ ÇäÊÃãÏ åæ Internet Explorer¬ áêåãææÇ
ÇäâêÇå ÈÔêÁ åËä çÐÇ:
</para>
<para>
<example>
<title>åËÇä Ùæ ÇÓÊÙåÇä <link linkend="control-structures">Èæé ÇäÊÍãå control
structures</link> è <link linkend="functions">ÇäÏèÇä</link>
</title>
<programlisting role="php"><![CDATA[
<?php
if (strstr($_SERVER["HTTP_USER_AGENT"], "MSIE")) {
echo "ÃæÊ ÈÕÏÏ ÇÓÊÙåÇä Internet Explorer<br />";
}
?>
]]></programlisting>
<para>
æåèÐÌ äæÊêÌÉ çÐÇ ÇäÓãÑêÈÊ êåãæ Ãæ Êãèæ:
<screen role="html"><![CDATA[
ÃæÊ ÈÕÏÏ ÇÓÊÙåÇä Internet Explorer<br />
]]></screen>
</para>
</example>
</para>
<para>
çæÇ æåçÏ äÈÙÖ åæ ÇäåáÇçêå ÇäÌÏêÏÉ. äÏêæÇ
ÈäÇÚ <link linkend="control-structures.if">if</link>.
ÅÐÇ ãæÊ åÙÊÇÏÇ Ùäé ÇäÕêÚÉ ÇäÃÓÇÓêÉ ÇäåÓÊÙåäÉ áê äÚÉ C¬
áÅæ çÐÇ ÓêØçÑ äã Ùäé Ãæç åæ×âê. ÅÐÇ äå Êãæ ÊÙÑá ãáÇêÉ åæ äÚÉ
C Ãè ÈÙÖ åæ äÚÉ ÃÎÑé¬ ÍêË ÊÓÊÙåä ÇäÕêÚÉ ÇäåÓÊÙåäÉ áêåÇ ÓÈâ¬
áäÑÈåÇ êÌÈ Ùäêã ãÊÇÈ ÊÙÑêáê È PHP èâÑÇÁÉ ÇäÒèÌ ÇäÃèä åæ ÇäåâÇ×Ù
Ãè âÑÇÁÉ áÕä
<link linkend="langref">åÑÌÙ ÇääÚÉ</link> áê çÐÇ ÇäÏäêä. ÈÅåãÇæã ÃêÖÇ ÅêÌÇÏ âÇÆåÉ åæ ÇäãÊÈ ÇäåÊÙäâÉ È PHP
áê <ulink url="&url.php.books;">&url.php.books;</ulink>.
</para>
<para>
Çäåáçèå ÇäËÇæê ÇäÐê æåçÏ äç çè åæÇÏÇÉ ÏÇäÉ <function>strstr</function>.
<function>strstr</function> çè ÙÈÇÑÉ Ùæ ÏÇäÉ åÈæêÉ Öåæ
PHP èÊâèå ÈÈÍË ÓäÓäÉ æÕêÉ åæ ÃÌä ÓäÓäÉ æÕêÉ ÃÎÑé. áê çÐç ÇäÍÇäɬ áÅææÇ
æÈÍË Ùæ <literal>"MSIE"</literal> ÏÇÎä
<varname>$_SERVER["HTTP_USER_AGENT"]</varname>. ÅÐÇ Êå ÅêÌÇÏ ÇäÓäÓäÉ ÇäæÕêɬ
áÅæ ÇäÏÇäÉ Êâèå ÈÅÑÌÇÙ &true; èáê ÚêÑ Ðäã Ðä㬠Êâèå ÈÅÑÌÇÙ &false;. ÅÐÇ
ÃÑÌÙÊ &true;¬ áÅæ ÈäÇÚ <link linkend="control-structures.if">if</link>
êâèå ÈÇäÊâêêå ä &true; èÇäÔêáÑÉ ÇäåÊÖåæÉ ÏÇÎä {ÇäÍÇÖæÊêæ braces} êÊå
ÊæáêÐçÇ. áê ÚêÑ Ðä㬠äæ êÊå ÇäÃåÑ. ÃÔÙÑ ÈÇäÍÑêÉ åæ ÃÌä ÅæÔÇÁ ÃåËäÉ ååÇËäÉ
ÈèÇÓ×É <link linkend="control-structures.if">if</link>¬
<link linkend="control-structures.else">else</link>¬
èÏèÇä ÃÎÑé åËä <function>strtoupper</function> è
<function>strlen</function>. ãä ÕáÍÉ ÐÇÊ ÙäÇâÉ áê ÇäÏäêä ÊÊÖåæ
ÃåËäÉ ÃêÖÇ.
</para>
<para>
êåãææÇ ÏáÙ çÐÇ Î×èÉ Åäé ÇäÃåÇå èÅØçÇÑ ãêá êåãæã ÇäÅæÊâÇä åæ èÅäé
æå× PHP ÍÊé áê èÓ× åâ×Ù PHP:
</para>
<para>
<example>
<title>ÇäåÒÌ Èêæ æå×ê HTML è PHP</title>
<programlisting role="php"><![CDATA[
<?php
if (strstr($_SERVER["HTTP_USER_AGENT"], "MSIE")) {
?>
<h3>strstr äÇ ÈÏ Ãæç ÃÑÌÙ true</h3>
<center><b>ÃæÊ ÈÕÏÏ ÇÓÊÙåÇä Internet Explorer</b></center>
<?php
} else {
?>
<h3>strstr äÇ ÈÏ Ãæç ÃÑÌÙ false</h3>
<center><b>äÓÊ ÈÕÏÏ ÇÓÊÙåÇä Internet Explorer</b></center>
<?php
}
?>
]]></programlisting>
<para>
æåèÐÌ äæÊêÌÉ çÐÇ ÇäÓãÑêÈÊ êåãæ Ãæ êãèæ ãÇäÊÇäê:
<screen role="html"><![CDATA[
<h3>strstr äÇ ÈÏ Ãæç ÃÑÌÙ true</h3>
<center><b>ÃæÊ ÈÕÏÏ ÇÓÊÙåÇä Internet Explorer</b></center>
]]></screen>
</para>
</example>
</para>
<para>
ÈÏäÇ åæ ÇÓÊÙåÇä ÃÍÏ ÈäÇÚÇÊ PHP åËä echo åæ ÃÌä ÅæÊÇÌ ÔêÁ åǬ æÎÑÌ åæ æå× PHP
èæÑÓä HTML ÎÇå. Çäæâ×É ÇäçÇåÉ èÇäÈÇÑÒÉ ÇäÊê êÌÈ ÇäÅÔÇÑÉ ÅäêçÇ çæÇ
çè Ãæ ÇäåÓÇÑ Çäåæ×âê ääÓãÑêÈÊ êØä ÓÇäåÇ. áâ× èÇÍÏ åæ åâÇ×Ù HTML
ÓêÊå ÇäÊèâá Ùæ ÅÑÓÇäç Åäé ÇäåÓÊÙÑÖ èÐäã ÈÍÓÈ ÅÐÇ âÇå
<function>strstr</function> ÈÅÑÌÇÙ &true; Ãè &false; ÈÙÈÇÑÉ ÃÎÑé¬
ÈÍÓÈ ÅÐÇ åÇ Êå ÅêÌÇÏ ÇäÓäÓäÉ ÇäæÕêÉ <literal>MSIE</literal> Ãå äÇ.
</para>
</sect1>
<sect1 id="tutorial.forms">
<title>ÇäÊÙÇåä åÙ ÇäæåÇÐÌ</title>
<para>
ÅÍÏé Ãâèé åêÒÇÊ PHP çê Çä×ÑêâÉ ÇäÊê êÊÙÇåä ÈçÇ åÙ æåÇÐÌ HTML.
Çäåáçèå ÇäÑÆêÓê ÇäÐê åæ ÇäÃçåêÉ áçåç çè Ãæ
Ãê ÙæÕÑ áê æåèÐÌ Óêãèæ åÊèáÑÇ äÓãÑêÈÊÇÊ PHP¬
ÎÇÕÊã. ÑÌÇÁ¬ ÅÓÊÙÑÖ áÕä ÇäÏäêä ÇäåÊÙäâ È
<link linkend="language.variables.external">ÇäåÊÚêÑÇÊ ÇäÃÌæÈêÉ
Ùæ PHP</link> åæ ÃÌä ÇäÍÕèä Ùäé åÙäèåÇÊ ÃãËÑ èãÐÇ ÃåËäÉ ÈÎÕèÕ ÇÓÊÙåÇä ÇäæåÇÐÌ
åÙ PHP. çæǬ ÌÏ åËÇäÇ Ùæ æåèÐÌ HTML:
</para>
<para>
<example>
<title>æåèÐÌ HTML ÈÓê×</title>
<programlisting role="html"><![CDATA[
<form action="action.php" method="POST">
ÅÓåã: <input type="text" name="name" />
􌄋: <input type="text" name="age" />
<input type="submit">
</form>
]]></programlisting>
</example>
</para>
<para>
äêÓ çæÇã åææ ÔêÁ ååêÒ ÈÎÕèÕ çÐÇ ÇäæåèÐÌ. çÐÇ ÙÈÇÑÉ Ùæ æåèÐÌ HTML ÎÇå
ÈÏèæ Ãê æèÙ åæ ÇäèÓèå ÇäÎÇÕÉ. ÙæÏåÇ êâèå ÇäåÓÊÎÏå ÈåäÁ çÐÇ ÇäæåèÐÌ
èêÖÚ× Ùäé ÒÑ ÇäÅÑÓÇä¬ áÅæç ÓêÊå åæÇÏÇÉ ÕáÍÉ <filename>action.php</filename>.
áê çÐÇ ÇäåäᬠÓêãèæ äÏêã ÔêÁ åËä çÐÇ:
</para>
<para>
<example>
<title>×ÈÇÙÉ ÇäÈêÇæÇÊ Åæ×äÇâÇ åæ æåèÐÌæÇ</title>
<programlisting role="php"><![CDATA[
ÃçäÇ êÇ <?php echo $_POST["name"]; ?>.
􌄋 <?php echo $_POST["age"]; ?> 
]]></programlisting>
<para>
æåèÐÌ äæÊêÌÉ çÐÇ ÇäÓãÑêÈÊ êåãæ Ãæ êãèæ ãÇäÊÇäê:
<screen role="html"><![CDATA[
ÃçäÇ êÇÍáêØ
􌄋 22 .
]]></screen>
</para>
</example>
</para>
<para>
Åæ åÇ êÍââç çÐÇ èÇÖÍ. äêÓ çæÇã ÃãËÑ åæ Ðäã.
Åæ åÊÚêÑÇÊ <varname>$_POST["name"]</varname> è <varname>$_POST["age"]</varname>
êÊå ÊÍÏêÏçÇ ÂäêÇ äÃÌäã åæ âÈä PHP. åæ âÈä¬ ãæÇ æÓÊÙåä
ÇäÔÇåä ÇäÂäê <varname>$_SERVER</varname> èáê ÇäÊè ãæÇ âÏ åçÏæÇ
ääÔÇåä ÇäÂäê <link linkend="reserved.variables.post">$_POST</link>
ÇäÐê êÖå ãä ÇäÈêÇæÇÊ åæ æèÙ POST. ÅæÊÈç ãêá
<emphasis>×ÑêâÉ method</emphasis> æåèÐÌæÇ çê POST. ÅÐÇ åÇ ÇÓÊÙåäæÇ
×ÑêâÉ <emphasis>GET</emphasis> áÅæ åÙäèåÇÊ æåèÐÌæÇ ÓÊØä ÈÏäÇ åæ Ðäã
áê ÇäÔÇåä ÇäÂäê <link linkend="reserved.variables.get">$_GET</link>.
êåãæã ÃêÖÇ ÇäÔÇåä ÇäÂäê <link linkend="reserved.variables.request">$_REQUEST</link>
ÅÐÇ äå Êãæ ÊçÊå ÈÎÕèÕ åÕÏÑ ÈêÇæÇÊã Çäå×äÈêÉ request data. çè
êÊÖåæ åÒêÌÇ åæ ÈêÇæÇÊ GET¬ POST¬ COOKIE è FILE. Å×äÙ ÃêÖÇ ÈÎÕèÕ
ÏÇäÉ <function>import_request_variables</function>.
</para>
</sect1>
<sect1 id="tutorial.oldcode">
<title>ÅÓÊÙåÇä ÇäÔêáÑÉ ÇäâÏêåÉ åÙ ÇäÅÕÏÇÑÇÊ ÇäÌÏêÏÉ åæ PHP</title>
<para>
Çäêèå èâÏ æåÇ PHP äÏÑÌÉ ÃÕÈÍ áêçÇ äÚÉ ÈÑåÌÉ èêÈ ÔÙÈêɬ áÅæç ÃÕÈÍ çæÇã
åèÇÑÏ ÃãËÑ ÊÖå åâÇ×Ù ÔêáÑÉ êåãæã ÅÙÇÏÉ ÇÓÊÙåÇäçÇ
áê ÓãÑêÈÊÇÊã ÇäÎÇÕÉ. áê åÙØåçå¬ áÅæ ÇäåÈÑåÌêæ ÇäÐêæ êÓÊÙåäèæ äÚÉ PHP
ÍÇèäèÇ Ãæ êãèæèÇ åÊèÇáâêæ åÙ ÇäÅÕÏÇÑÇÊ ÇäÓÇÈâɬ èçãÐÇ áÅæ Ãê ÓãÑêÈÊ êÊå ÅæÔÇÄç
åæ ÃÌä ÅÕÏÇÑÉ âÏêåɬ áÅæç êÙåä (ÈÔãä åËÇäê) èåæ Ïèæ ÊÚêêѬ áê ÃêÉ ÅÕÏÇÑÉ ÌÏêÏÉ åæ
PHP» Ùäé åÓÊèé Ê×Èêâê¬ áÅæ ÈÙÖ ÇäÊÚêêÑÇÊ Êãèæ ÙÇÏÉ ÖÑèÑêÉ.
</para>
<para>
ÅËæÇæ åæ Ãçå ÇäÊÚêêÑÇÊ ÇäÍÏêËÉ ÇäÊê ÊÄËÑ áê ÇäÔêáÑÉ ÇäâÏêåÉ çê:
<itemizedlist>
<listitem>
<simpara>
ÇäÅæâÇÕ åæ ÃçåêÉ åÕáèáÇÊ <varname>$HTTP_*_VARS</varname> ÇäâÏêåÉ
( ÇäÊê ÊÍÊÇÌ äÃæ êÊå ÊÍÏêÏçÇ Ùäé ÃæçÇ ÔÇåäÉ global ÙæÏ ÇÓÊÙåÇäçÇ Öåæ ÏÇäÉ Ãè
×ÑêâÉ method). Åæ
<link linkend="language.variables.superglobals">ÇäåÕáèáÇÊ ÇäÔÇåäÉ ÂäêÇ autoglobal arrays</link>
ÇäÊÇäêÉ âÏ Êå ÅÌÑÇÌçÇ áê ÇäÅÕÏÇÑÉ <ulink url="&url.php.release4.1.0;">4.1.0</ulink> åæ PHP
èçê: <varname>$_GET</varname>¬ <varname>$_POST</varname>¬
<varname>$_COOKIE</varname>¬ <varname>$_SERVER</varname>¬
<varname>$_ENV</varname>¬ <varname>$_REQUEST</varname> è
<varname>$_SESSION</varname>. èÈÇäæÓÈÉ äåÕáèáÇÊ <varname>$HTTP_*_VARS</varname>
ÇäâÏêåÉ åËä $HTTP_POST_VARS¬ áÅæçÇ ãÇæÊ èäÇÒÇäÊ åèÌèÏÉ åæÐ ÇäÅÕÏÇÑÉ 3 ä PHP.
</simpara>
</listitem>
<listitem>
<simpara>
ÇäåÊÚêÑÇÊ ÇäÎÇÑÌêÉ äå ÊÙÏ åÓÌäɬ ÈÔãä ÅáÊÑÇÖê¬ áê ÇäåÏé ÇäÔÇåä global scope.
ÈÙÈÇÑÉ ÃÎÑé¬ áÅæç åæÐ ÇäÅÕÏÇÑÉ
<ulink url="&url.php.release4.2.0;">4.2.0</ulink> åæ PHP¬ ÃÕÈÍ ÊèÌêç PHP ÇäÎÇÕ È
<link linkend="ini.register-globals">register_globals</link> çè
<emphasis>off</emphasis>¬ ÈÔãä ÅáÊÑÇÖê¬ áê &php.ini;. Çä×ÑêâÉ ÇäåáÖäÉ
äèäèÌ çÐç Çäâêå çê åæ ÎäÇä ÇäåÕáèáÇÊ ÇäÔÇåäÉ ÂäêÇ ÇäÊê ÊåÊ ÇäÅÔÇÑÉ ÅäêçÇ åæ âÈä.
çæÇã ÇäÓãÑêÈÊÇʬ ÇäãÊÈ èÇäÏÑèÓ ÇäâÏêåÉ ÇäÊê ÊÔêÑ Åäé ÌÙä çÐÇ
ÇäÊèÌêç on. ÅÐÇ ãÇæ ÇäÊèÌêç on¬ åËäǬ áÅæ ÇäåÑÁ êãèæ ÈÅåãÇæç ÅÓÊÙåÇä
<varname>$id</varname> Åæ×äÇâÇ åæ åÍÏÏ ÇäåèâÙ URL
<literal>http://www.example.com/foo.php?id=42</literal>. ÓèÇÁ ÃãÇæ on
Ãè off¬ áÅæ <varname>$_GET['id']</varname> êãèæ åÊèáÑÇ.
</simpara>
</listitem>
</itemizedlist>
åæ ÃÌä ÊáÇÕêä ÃãËÑ ÈÎÕèÕ çÐç ÇäÊÚêêÑÇʬ ÅÓÊÙÑÖ ÇäáÕä ÇäåÊÙäâ È
<link linkend="language.variables.predefined">ÇäåÊÚêÑÇÊ ÇäåÙÑáÉ åÓÈâÇ predefined variables</link>
èÇäÑèÇÈ× ÇäåÊÖåæÉ.
</para>
</sect1>
<sect1 id="tutorial.whatsnext">
<title>åÇ ÇäÂÊê¿</title>
<para>
åÙ åÇ ÊÙÑáç ÇäÂæ¬ áÅæã äÇ ÈÏ âÇÏÑ Ùäé áçå åÙØå
ÇäÏäêä èÃêÖÇ åÎÊäá ÇäÓãÑêÈÊÇÊ ÇäåÓÊÙåäÉ ãÃåËäÉ èÇäåÊèáÑÉ áê
ÃÑÔêá ÇäÃåËäÉ. ÈÅåãÇæã ÃêÖÇ ÅêÌÇÏ ÃåËäÉ ÃÎÑé áê php.net
ÍêË êèÌÏ ÌÒÁ ÎÇÕ ÈÑèÇÈ× ÇäåèÇâÙ:
<ulink url="&url.php.links;">&url.php.links;</ulink>.
</para>
</sect1>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->