Contributions are ready for review

From:	doc-ar at lists dot php dot net	Date:	Mon, 12 Jan 2015 13:00:01 +0000
Subject:	Contributions are ready for review
Groups:	php.doc.ar
Request:	Send a blank email to doc-ar+get-854@lists.php.net to get a copy of this message

Hello PHP AR Documentation team, There are contributions within the online editor queue for this language. Please review, then commit or delete these patches. Patches for review : ----------------------- New file: ar/reference/bcompiler/book.xml By: visualmind on 2011-08-24 12:21:50 =================================================================== --- ar/reference/bcompiler/book.xml +++ ar/reference/bcompiler/book.xml @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<book xml:id="book.bcompiler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>PHP bytecode Compiler</title> + <titleabbrev>bcompiler</titleabbrev> + + <preface xml:id="intro.bcompiler"> + &reftitle.intro; + &warn.experimental; + <para> + وقد كتب Bcompiler لعدة أسباب : + <simplelist> + <member>To encode entire script in a proprietary PHP application</member> + <member>To encode some classes and/or functions in a proprietary PHP application</member> + <member> + To enable the production of php-gtk applications that could be used on + client desktops, without the need for a php.exe. + </member> + <member>To do the feasibility study for a PHP to C converter</member> + </simplelist> + The first of these goals is achieved using the + <function>bcompiler_write_header</function>, + <function>bcompiler_write_file</function> and + <function>bcompiler_write_footer</function> + functions. The bytecode files can + be written as either uncompressed or plain. + To use the generated bytecode, you can simply include it + with include or require statements. + </para> + <para> + The second of these goals is achieved using the + <function>bcompiler_write_header</function>, + <function>bcompiler_write_class</function>, + <function>bcompiler_write_footer</function>, + <function>bcompiler_read</function>, + and <function>bcompiler_load</function> functions. The bytecode files can + be written as either uncompressed or plain. The + <function>bcompiler_load</function> reads a bzip compressed bytecode file, + which tends to be 1/3 of the size of the original file. + </para> + <para> + To create EXE type files, bcompiler has to be used with a modified sapi + file or a version of PHP which has been compiled as a shared library. In + this scenario, bcompiler reads the compressed bytecode from the end of the + exe file. + </para> + <para> + bcompiler can improve performance by about 30% when used with uncompressed + bytecodes only. But keep in mind that uncompressed bytecode can be up + to 5 times larger than the original source code. Using bytecode + compression can save your space, but decompression requires much more + time than parsing a source. bcompiler also does not do any bytecode + optimization, this could be added in the future... + </para> + <para> + In terms of code protection, it is safe to say that it would be impossible + to recreate the exact source code that it was built from, and without the + accompanying source code comments. It would effectively be useless to use + the bcompiler bytecodes to recreate and modify a class. However it is + possible to retrieve data from a bcompiled bytecode file - so don't put + your private passwords or anything in it. + </para> + </preface> + + &reference.bcompiler.setup; + &reference.bcompiler.constants; + &reference.bcompiler.reference; + +</book> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=13781 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=13781 ------------------------------------------------------------------ New file: ar/reference/mysql/functions/mysql-connect.xml By: visualmind on 2011-09-08 19:20:36 =================================================================== --- ar/reference/mysql/functions/mysql-connect.xml +++ ar/reference/mysql/functions/mysql-connect.xml @@ -0,0 +1,281 @@ +<?xml version="1.0" encoding="utf-8"?> + +<refentry xml:id="function.mysql-connect" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>mysql_connect</refname> + <refpurpose>اتصال بمزود بيانات Mysql</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>mysql_connect</methodname> + <methodparam choice="opt"><type>string</type><parameter>server</parameter><initializer>ini_get("mysql.default_host")</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysql.default_user")</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysql.default_password")</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>new_link</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter><initializer>0</initializer></methodparam> + </methodsynopsis> + <para> + اتصال بمزود البيانات MySQL server. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>server</parameter></term> + <listitem> + <para> + بالامكان الاتصال بمزود البيانات Mysql بهذا الشكل + "hostname:port" او بهذا الشكل ان كان المزود داخلي e.g. ":/path/to/socket" يعمل فقط على المزود الداخلي. + </para> + <para> + If the PHP directive <link linkend="ini.mysql.default-host"> + mysql.default_host</link> is undefined (default), then the default + value is 'localhost:3306'. In &sqlsafemode;, this parameter is ignored + and value 'localhost:3306' is always used. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + The username. Default value is defined by <link + linkend="ini.mysql.default-user">mysql.default_user</link>. In + &sqlsafemode;, this parameter is ignored and the name of the user that + owns the server process is used. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + The password. Default value is defined by <link + linkend="ini.mysql.default-password">mysql.default_password</link>. In + &sqlsafemode;, this parameter is ignored and empty password is used. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>new_link</parameter></term> + <listitem> + <para> + If a second call is made to <function>mysql_connect</function> + with the same arguments, no new link will be established, but + instead, the link identifier of the already opened link will be + returned. The <parameter>new_link</parameter> parameter modifies this + behavior and makes <function>mysql_connect</function> always open + a new link, even if <function>mysql_connect</function> was called + before with the same parameters. + In &sqlsafemode;, this parameter is ignored. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>client_flags</parameter></term> + <listitem> + <para> + The <parameter>client_flags</parameter> parameter can be a combination + of the following constants: + 128 (enable <literal>LOAD DATA LOCAL</literal> handling), + <constant>MYSQL_CLIENT_SSL</constant>, + <constant>MYSQL_CLIENT_COMPRESS</constant>, + <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> or + <constant>MYSQL_CLIENT_INTERACTIVE</constant>. + Read the section about <xref linkend="mysql.client-flags" /> for further information. + In &sqlsafemode;, this parameter is ignored. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Returns a MySQL link identifier on success&return.falseforfailure;. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Added the <parameter>client_flags</parameter> parameter. + </entry> + </row> + <row> + <entry>4.2.0</entry> + <entry> + Added the <parameter>new_link</parameter> parameter. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>mysql_connect</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +$link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); +if (!$link) { + die('Could not connect: ' . mysql_error()); +} +echo 'Connected successfully'; +mysql_close($link); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>mysql_connect</function> example using <literal>hostname:port</literal> syntax</title> + <programlisting role="php"> +<![CDATA[ +<?php +// we connect to example.com and port 3307 +$link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password'); +if (!$link) { + die('Could not connect: ' . mysql_error()); +} +echo 'Connected successfully'; +mysql_close($link); + +// we connect to localhost at port 3307 +$link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password'); +if (!$link) { + die('Could not connect: ' . mysql_error()); +} +echo 'Connected successfully'; +mysql_close($link); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>mysql_connect</function> example using ":/path/to/socket" syntax</title> + <programlisting role="php"> +<![CDATA[ +<?php +// we connect to localhost and socket e.g. /tmp/mysql.sock + +// variant 1: omit localhost +$link = mysql_connect(':/tmp/mysql', 'mysql_user', 'mysql_password'); +if (!$link) { + die('Could not connect: ' . mysql_error()); +} +echo 'Connected successfully'; +mysql_close($link); + + +// variant 2: with localhost +$link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password'); +if (!$link) { + die('Could not connect: ' . mysql_error()); +} +echo 'Connected successfully'; +mysql_close($link); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Whenever you specify "localhost" or + "localhost:port" as server, the MySQL client library will + override this and try to connect to a local socket (named pipe on + Windows). If you want to use TCP/IP, use "127.0.0.1" + instead of "localhost". If the MySQL client library tries to + connect to the wrong local socket, you should set the correct path as + <xref linkend="ini.mysql.default-host" /> in your PHP configuration and leave the server field + blank. + </para> + </note> + <note> + <para> + The link to the server will be closed as soon as the execution of + the script ends, unless it's closed earlier by explicitly calling + <function>mysql_close</function>. + </para> + </note> + <note> + <para> + You can suppress the error message on failure by prepending + a <link linkend="language.operators.errorcontrol">@</link> + to the function name. + </para> + </note> + <note> + <para> + Error "Can't create TCP/IP socket (10106)" usually means that the <link + linkend="ini.variables-order">variables_order</link> configure directive + doesn't contain character <literal>E</literal>. On Windows, if the + environment is not copied the <literal>SYSTEMROOT</literal> environment + variable won't be available and PHP will have problems loading Winsock. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysql_pconnect</function></member> + <member><function>mysql_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=14696 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=14696 ------------------------------------------------------------------ New file: ar/reference/mysql/functions/mysql-drop-db.xml By: visualmind on 2012-05-18 05:28:03 =================================================================== --- ar/reference/mysql/functions/mysql-drop-db.xml +++ ar/reference/mysql/functions/mysql-drop-db.xml @@ -0,0 +1,130 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<refentry xml:id="function.mysql-drop-db" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>mysql_drop_db</refname> + <refpurpose>Drop (delete) a MySQL database</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>mysql_drop_db</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam> + </methodsynopsis> + <para> + <function>mysql_drop_db</function> على وشك حذف قاعدة بيانات من السرفر + <function>mysql_query</function> to issue an sql + <literal>DROP DATABASE</literal> statement instead. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + اسم قاعدة البيانات المراد حذفها + </para> + </listitem> + </varlistentry> + &mysql.linkid.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>mysql_drop_db</function> على سبيل المثال</title> + <programlisting role="php"> +<![CDATA[ +<?php +$link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); +//بيانات الاتصال +if (!$link) { + die('Could not connect: ' . mysql_error()); +} +//my_db = قاعدة البيانات المراد حذفها +$sql = 'DROP DATABASE my_db'; +if (mysql_query($sql, $link)) { + echo "قاعدة البيانات تم حذفها بنجاحn"; +} else { + echo 'خطأ أثناء الحذف: ' . mysql_error() . "n"; +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + &mysql.alternative.note; + <para> + &mysql.alternative.include; + <simplelist> + <member>Execute a <literal>DROP DATABASE</literal> query</member> + </simplelist> + </para> + </note> + <warning> + <para> + هذه العملية لن تكون متاحة اذا تم بناء السرفر غير MYSQL 4.X + </para> + </warning> + <note> + <para> + &info.deprecated.alias; + <function>mysql_dropdb</function> + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysql_query</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=36910 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=36910 ------------------------------------------------------------------ New file: ar/reference/mysql/functions/mysql-pconnect.xml By: visualmind on 2012-05-18 05:59:59 =================================================================== --- ar/reference/mysql/functions/mysql-pconnect.xml +++ ar/reference/mysql/functions/mysql-pconnect.xml @@ -0,0 +1,198 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + + + +<refentry xml:id="function.mysql-pconnect" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>mysql_pconnect</refname> + <refpurpose>Open a persistent connection to a MySQL server</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>mysql_pconnect</methodname> + <methodparam choice="opt"><type>string</type><parameter>server</parameter><initializer>ini_get("mysql.default_host")</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysql.default_user")</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysql.default_password")</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter><initializer>0</initializer></methodparam> + </methodsynopsis> +  + <para> + Establishes a persistent connection to a MySQL server. + </para> +  + <para> + <function>mysql_pconnect</function> acts very much like + <function>mysql_connect</function> with two major differences. + </para> + <para> + أولاً سيتم البحث عن اتصال ثابت مفتوح مسبقاً من نفس المضيف. + اسم المستخدم وكلمة المرور , فإذا تم العثور على واحد فيتم استخدامه بدل من فتح اتصال جديد + </para> + <para> + ثانيا الاتصال بالمستضيف SQL لن يغلق عندما + ينتهى استخراج البيانات واجراء العمليات فى السكربت. بدلا من ذلك سيظل الاتصال مفتوح + عند استخدام الخيار (<function>mysql_close</function> لن يغلق الاتصالات المفتوحة عن طريق الخيار <function>mysql_pconnect</function>). + </para> + <para> + This type of link is therefore called 'persistent'. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>server</parameter></term> + <listitem> + <para> + The MySQL server. من الممكن ان تحتوى على رقم المنفذ (بورت) لعمل الاتصال. + على سبيل المثال + "hostname:port" او المسار لمنفذ محلى على يبل المثال ":/path/to/socket" f + للسرفر المحلى. + </para> + <para> + إذا كان عنوان المستضيف <link linkend="ini.mysql.default-host"> + mysql.default_host</link> اى ان المنفذ غير معرف, عند ذلك ستكون القيمة الافتراضية هى 'localhost:3306' + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + اسم المستخدم . + القيمة الافتراضية هى اسم المستخدم الذى يملك الخادم أو المستضيف + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + كلمة المرور . القيمة الافتراضية تكون فارغة + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>client_flags</parameter></term> + <listitem> + <para> + The <parameter>client_flags</parameter> parameter can be a combination + of the following constants: + 128 (enable <literal>LOAD DATA LOCAL</literal> handling), + <constant>MYSQL_CLIENT_SSL</constant>, + <constant>MYSQL_CLIENT_COMPRESS</constant>, + <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> or + <constant>MYSQL_CLIENT_INTERACTIVE</constant>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Returns a MySQL persistent link identifier on success, or &false; on + failure. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Added the <parameter>client_flags</parameter> parameter. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Note, that these kind of links only work if you are using + a module version of PHP. See the + <link linkend="features.persistent-connections">Persistent + Database Connections</link> section for more information. + </para> + </note> + <warning> + <para> + Using persistent connections can require a bit of tuning of your Apache + and MySQL configurations to ensure that you do not exceed the number of + connections allowed by MySQL. + </para> + </warning> + <note> + <para> + You can suppress the error message on failure by prepending + a <link linkend="language.operators.errorcontrol">@</link> + to the function name. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysql_connect</function></member> + <member><link linkend="features.persistent-connections">Persistent + Database Connections</link></member> + </simplelist> + </para> + </refsect1> +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=36911 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=36911 ------------------------------------------------------------------ New file: ar/faq/build.xml By: visualmind on 2012-11-07 23:43:00 =================================================================== --- ar/faq/build.xml +++ ar/faq/build.xml @@ -0,0 +1,556 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<chapter xml:id="faq.build" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>بناء المشاكل</title> + <titleabbrev>بناء المشاكل</titleabbrev> + + <para> + يقوم هذا القسم بجمع الأخطاء الأكثر شيوعاً التي تحدث في +بناء على الوقت. + </para> + + <qandaset> + <qandaentry xml:id="faq.build.configure"> + <question> + <para> + أنا حصلت على أحدث إصدار من PHP باستخدام خدمة بوابة المجهول، +ولكن لا يوجد أي برنامج نصي تكوين! + </para> + </question> + <answer> + <para> + يكون لديك حزمة أوتوكونف جنو مثبتة بحيث يمكنك +إنشاء البرنامج النصي تكوين من configure.in <filename> </filename>. مجرد تشغيل +<command>./بويلدكونف </command> في دليل المستوى الأعلى بعد الحصول على +المصادر من خادم بوابة. (أيضا، إلا إذا قمت بتشغيل <command> تكوين </command> +مع <literal>-خيار الوضع--تمكين-معيل </literal>، +تكوين البرنامج النصي سيتم لا تلقائياً الحصول على بناؤها عند +configure.in <filename> </filename> يتم تحديث الملف، حيث يجب التأكد من القيام بذلك +يدوياً عندما لاحظ configure.in <filename> </filename> قد تغيرت. أحد أعراض +هذا هو العثور على أشياء مثل @VARIABLE@ في Makefile الخاص بك بعد +تكوين أو config.status <filename> </filename> تشغيل.) + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.configuring"> + <question> + <para> + أواجه مشكلات تكوين PHP للعمل مع أباتشي. + وتقول أنها لا يمكن العثور <filename>httpd.h</filename>, but it's right where I said it is! + </para> + </question> + <answer> + <para> + You need to tell the configure/setup script the location of the + top-level of your Apache source tree. This means that + you want to specify <option + role="configure">--with-apache=/path/to/apache</option> + and <emphasis>not</emphasis> <option + role="configure">--with-apache=/path/to/apache/src</option>. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.lex"> + <question> + <para> + While configuring PHP (<literal>./configure</literal>), you come across + an error similar to the following: + </para> + <para> + <screen> + checking lex output file root... ./configure: lex: command not found + configure: error: cannot find output from lex; giving up + </screen> + </para> + </question> + <answer> + <para> + Be sure to read the <link linkend="install.unix">installation</link> + instructions carefully and note that you need both flex and bison + installed to compile PHP. Depending on your setup you will install + bison and flex from either source or a package, such as a RPM. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.apache-sharedcore"> + <question> + <para> + When I try to start Apache, I get the following message: + </para> + <para> + <screen> + fatal: relocation error: file /path/to/libphp4.so: + symbol ap_block_alarms: referenced symbol not found + </screen> + </para> + </question> + <answer> + <para> + This error usually comes up when one compiles the Apache + core program as a DSO library for shared usage. Try to + reconfigure apache, making sure to use at least the + following flags: + </para> + <para> + <screen> + --enable-shared=max --enable-rule=SHARED_CORE + </screen> + </para> + <para> + For more information, read the top-level Apache + <filename>INSTALL</filename> file or the Apache + <link xlink:href="&url.apachedso;">DSO manual page</link>. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.not-found"> + <question> + <para> + When I run configure, it says that it can't find the + include files or library for GD, gdbm, or some other package! + </para> + </question> + <answer> + <para> + You can make the configure script look for header files and libraries + in non-standard locations by specifying additional flags to pass to + the C preprocessor and linker, such as: + <programlisting> +<![CDATA[ + CPPFLAGS=-I/path/to/include LDFLAGS=-L/path/to/library ./configure +]]> + </programlisting> + If you're using a csh-variant for your login shell (why?), it would be: + <programlisting> +<![CDATA[ + env CPPFLAGS=-I/path/to/include LDFLAGS=-L/path/to/library ./configure +]]> + </programlisting> + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.yytname"> + <question> + <para> + When it is compiling the file <filename>language-parser.tab.c</filename>, it gives me errors + that say <literal>yytname undeclared</literal>. + </para> + </question> + <answer> + <para> + You need to update your version of Bison. You can find the latest version + at <link xlink:href="&url.bison;">&url.bison;</link>. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.link"> + <question> + <para> + When I run <command>make</command>, it seems to run fine but then fails when it tries + to link the final application complaining that it can't find some files. + </para> + </question> + <answer> + <para> + Some old versions of make that don't correctly put the compiled + versions of the files in the functions directory into that same + directory. Try running <command>cp *.o functions</command> and then + re-running <command>make</command> to see if that helps. If it does, you should really + upgrade to a recent version of GNU make. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.undefined"> + <question> + <para> + When linking PHP, it complains about a number of undefined references. + </para> + </question> + <answer> + <para> + Take a look at the link line and make sure that all of the appropriate + libraries are being included at the end. Common ones that you might have + missed are '-ldl' and any libraries required for any database support + you included. + </para> + <para> + Some people have also reported that they had to add '-ldl' immediately + following <filename>libphp4.a</filename> when linking with Apache. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.apache"> + <question> + <para> + I can't figure out how to build PHP with Apache 1.3. + </para> + </question> + <answer> + <para> + This is actually quite easy. Follow these steps carefully: + <itemizedlist> + <listitem> + <simpara> + Grab the latest Apache 1.3 distribution from + <link xlink:href="&url.apache.source;">&url.apache.source;</link>. + </simpara> + </listitem> + <listitem> + <simpara> + Ungzip and untar it somewhere, for example + <filename>/usr/local/src/apache-1.3</filename>. + </simpara> + </listitem> + <listitem> + <simpara> + Compile PHP by first running + <command>./configure --with-apache=/<path>/apache-1.3</command> + (substitute <path> for the actual path to your apache-1.3 directory). + </simpara> + </listitem> + <listitem> + <simpara> + Type <command>make</command> followed by <command>make install</command> + to build PHP and copy the necessary files to the Apache distribution tree. + </simpara> + </listitem> + <listitem> + <simpara> + Change directories into to your <filename>/<path>/apache-1.3/src</filename> + directory and edit the <filename>Configuration</filename> file. + Add to the file: + <literal>AddModule modules/php4/libphp4.a</literal>. + </simpara> + </listitem> + <listitem> + <simpara> + Type: <command>./configure</command> followed by <literal>make</literal>. + </simpara> + </listitem> + <listitem> + <simpara> + You should now have a PHP-enabled httpd binary! + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <emphasis>Note:</emphasis> You can also use the new Apache + <literal>./configure</literal> script. See the instructions in + the <literal>README.configure</literal> file which is part of + your Apache distribution. Also have a look at the <filename>INSTALL</filename> + file in the PHP distribution. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.not-running"> + <question> + <para> + I have followed all the steps to install the Apache module version on + Unix, and my PHP scripts show up in my browser or I am being asked to + save the file. + </para> + </question> + <answer> + <para> + This means that the PHP module is not getting invoked for some reason. + Three things to check before asking for further help: + <itemizedlist> + <listitem> + <simpara> + Make sure that the httpd binary you are running is the actual + new httpd binary you just built. To do this, try running: + <literal>/path/to/binary/httpd -l</literal> + </simpara> + <simpara> + If you don't see <filename>mod_php4.c</filename> listed then + you are not running the right binary. Find and install the + correct binary. + </simpara> + </listitem> + <listitem> + <simpara> + Make sure you have added the correct Mime Type to one of your + <literal>Apache .conf</literal> files. It should be: + <literal>AddType application/x-httpd-php .php</literal> + </simpara> + <simpara> + Also make sure that this AddType line is not hidden away inside a + <Virtualhost> or <Directory> block which would + prevent it from applying to the location of your test script. + </simpara> + </listitem> + <listitem> + <simpara> + Finally, the default location of the Apache configuration files + changed between Apache 1.2 and Apache 1.3. You should check to + make sure that the configuration file you are adding the AddType + line to is actually being read. You can put an obvious syntax error + into your &httpd.conf; file or some other obvious change that will + tell you if the file is being read correctly. + </simpara> + </listitem> + </itemizedlist> + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.activate-module"> + <question> + <para> + It says to use: <literal>--activate-module=src/modules/php4/libphp4.a</literal>, + but that file doesn't exist, so I changed it to + <literal>--activate-module=src/modules/php4/libmodphp4.a</literal> and it + doesn't work!? What's going on? + </para> + </question> + <answer> + <para> + Note that the <filename>libphp4.a</filename> file is not supposed to exist. The + apache process will create it! + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.ansi"> + <question> + <para> + When I try to build Apache with PHP as a static module using + <literal>--activate-module=src/modules/php4/libphp4.a</literal> + it tells me that my compiler is not ANSI compliant. + </para> + </question> + <answer> + <para> + This is a misleading error message from Apache that has been fixed + in more recent versions. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.apxs"> + <question> + <para> + When I try to build PHP using <option + role="configure">--with-apxs</option> I get strange error messages. + </para> + </question> + <answer> + <para> + There are three things to check here. First, for some reason + when Apache builds the apxs Perl script, it sometimes ends up + getting built without the proper compiler and flags variables. + Find your apxs script (try the command <command>which apxs</command>), + it's sometimes found in <filename>/usr/local/apache/bin/apxs</filename> + or <filename>/usr/sbin/apxs</filename>. + Open it and check for lines similar to these: + <programlisting> +<![CDATA[ +my $CFG_CFLAGS_SHLIB = ' '; # substituted via Makefile.tmpl +my $CFG_LD_SHLIB = ' '; # substituted via Makefile.tmpl +my $CFG_LDFLAGS_SHLIB = ' '; # substituted via Makefile.tmpl +]]> + </programlisting> + If this is what you see, you have found your problem. They may + contain just spaces or other incorrect values, such as 'q()'. Change + these lines to say: + <programlisting> +<![CDATA[ +my $CFG_CFLAGS_SHLIB = '-fpic -DSHARED_MODULE'; # substituted via Makefile.tmpl +my $CFG_LD_SHLIB = 'gcc'; # substituted via Makefile.tmpl +my $CFG_LDFLAGS_SHLIB = q(-shared); # substituted via Makefile.tmpl +]]> + </programlisting> + The second possible problem should only be an issue on Red Hat 6.1 + and 6.2. The apxs script Red Hat ships is broken. Look for this line: + <programlisting> +<![CDATA[ +my $CFG_LIBEXECDIR = 'modules'; # substituted via APACI install +]]> + </programlisting> + If you see the above line, change it to this: + <programlisting> +<![CDATA[ +my $CFG_LIBEXECDIR = '/usr/lib/apache'; # substituted via APACI install +]]> + </programlisting> + Last, if you reconfigure/reinstall Apache, add a <command>make clean</command> + to the process after <command>./configure</command> and before <command>make</command>. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.microtime"> + <question> + <para> + During <command>make</command>, I get errors in microtime, + and a lot of <literal>RUSAGE_</literal> stuff. + </para> + </question> + <answer> + <para> + During the <command>make</command> portion of installation, + if you encounter problems that look similar to this: + <programlisting> +<![CDATA[ +microtime.c: In function `php_if_getrusage': +microtime.c:94: storage size of `usg' isn't known +microtime.c:97: `RUSAGE_SELF' undeclared (first use in this function) +microtime.c:97: (Each undeclared identifier is reported only once +microtime.c:97: for each function it appears in.) +microtime.c:103: `RUSAGE_CHILDREN' undeclared (first use in this function) +make[3]: *** [microtime.lo] Error 1 +make[3]: Leaving directory `/home/master/php-4.0.1/ext/standard' +make[2]: *** [all-recursive] Error 1 +make[2]: Leaving directory `/home/master/php-4.0.1/ext/standard' +make[1]: *** [all-recursive] Error 1 +make[1]: Leaving directory `/home/master/php-4.0.1/ext' +make: *** [all-recursive] Error 1 +]]> + </programlisting> + </para> + <para> + Your system is broken. You need to fix your <filename>/usr/include</filename> files by + installing a glibc-devel package that matches your glibc. This has + absolutely nothing to do with PHP. To prove this to yourself, try this + simple test: + <programlisting> +<![CDATA[ +$ cat >test.c <<X +#include <sys/resource.h> +X +$ gcc -E test.c >/dev/null +]]> + </programlisting> + If that spews out errors, you know your include files are messed up. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.mysql.tempnam"> + <question> + <para> + When compiling PHP with MySQL, configure runs fine but during + <literal>make</literal> I get an error similar to the following: + <emphasis>ext/mysql/libmysql/my_tempnam.o(.text+0x46): In function + my_tempnam': /php4/ext/mysql/libmysql/my_tempnam.c:103: the + use of tempnam' is dangerous, better use mkstemp'</emphasis>, + what's wrong? + </para> + </question> + <answer> + <para> + First, it's important to realize that this is a <literal> + Warning</literal> and not a fatal error. Because this is + often the last output seen during <literal>make</literal>, + it may seem like a fatal error but it's not. Of course, if + you set your compiler to die on Warnings, it will. Also + keep in mind that MySQL support is enabled by default. + </para> + <note> + <para> + As of PHP 4.3.2, you'll also see the following text after + the build (make) completes: + </para> + <para> + <screen> + Build complete. + (It is safe to ignore warnings about tempnam and tmpnam). + </screen> + </para> + </note> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.upgrade"> + <question> + <para> + I want to upgrade my PHP. Where can I find the <command>./configure</command> + line that was used to build my current PHP installation? + </para> + </question> + <answer> + <para> + Either you look at config.nice file, in the source tree of your current PHP + installation or, if this is not available, you simply run a + <programlisting role="php"> +<![CDATA[ + <?php phpinfo(); ?> +]]> + </programlisting> + script. On top of the output the <command>./configure</command> line, that was used + to build this PHP installation is shown. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.build.gdlibs"> + <question> + <para> + When building PHP with the GD library it either gives strange compile errors + or segfaults on execution. + </para> + </question> + <answer> + <para> + Make sure your GD library and PHP are linked against the same depending + libraries (e.g. libpng). + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.installation.needgnu"> + <question> + <para> + When compiling PHP I seemingly get random errors, like it hangs. + I'm using Solaris if that matters. + </para> + </question> + <answer> + <para> + Using non-GNU utilities while compiling PHP may cause problems. Be + sure to use GNU tools in order to be certain that compiling PHP will + work. For example, on Solaris, using either the SunOS BSD-compatible + or Solaris versions of <literal>sed</literal> will not work, but using + the GNU or Sun POSIX (xpg4) versions of <literal>sed</literal> will + work. Links: <link xlink:href="&url.sed;">GNU sed</link>, + <link xlink:href="&url.flex;">GNU flex</link>, and + <link xlink:href="&url.bison;">GNU bison</link>. + </para> + </answer> + </qandaentry> + </qandaset> + </chapter> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=42742 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=42742 ------------------------------------------------------------------ New file: ar/reference/datetime/book.xml By: visualmind on 2013-07-10 08:51:56 =================================================================== --- ar/reference/datetime/book.xml +++ ar/reference/datetime/book.xml @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + + +<book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <?phpdoc extension-membership="core"?> + <title>التاريخ و الوقت</title> + <titleabbrev>التاريخ/الوقت</titleabbrev> + +  + <preface xml:id="intro.datetime"> + &reftitle.intro; + <para> + + </para> + <para> + The date and time information is internally stored as a 64-bit number so + all conceivably useful dates (including negative years) are supported. The range is from about 292 + billion years in the past to the same in the future. + </para> + <note> + <simpara> + Please keep in mind that these functions are dependent on + the locale settings of your server. Make sure to take + daylight saving time (use e.g. + <literal>$date = strtotime('+7 days', $date)</literal> and not + <literal>$date += 7*24*60*60</literal>) + and leap years into consideration when working + with these functions. + </simpara> + </note> + <note> + <simpara> + The timezones referenced in this section can be found in the + <xref linkend="timezones"/>. + </simpara> + </note> + </preface> +  + + &reference.datetime.setup; + &reference.datetime.constants; + + &reference.datetime.datetime; + &reference.datetime.datetimeimmutable; + &reference.datetime.datetimeinterface; + &reference.datetime.datetimezone; + &reference.datetime.dateinterval; + &reference.datetime.dateperiod; + + &reference.datetime.reference; + &reference.datetime.formats; + &reference.datetime.timezones; + +</book> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=48691 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=48691 ------------------------------------------------------------------ New file: ar/reference/mysqli/book.xml By: visualmind on 2013-07-19 20:22:30 =================================================================== --- ar/reference/mysqli/book.xml +++ ar/reference/mysqli/book.xml @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<book xml:id="book.mysqli" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <?phpdoc extension-membership="bundledexternal" ?> + + <title>مكتبه MySQL المحسنه</title> + + <titleabbrev>Mysqli</titleabbrev> + + + + <preface xml:id="intro.mysqli"> + &reftitle.intro; + <para> + ان مكتبه <literal>mysqli</literal> تسمح لك بالاتصال بخادم MySQL اصدار 4.1 او اعلي - لمزيد من المعلومات عن خادم MySQL يمكنك الضغط علي الرابط التالي + + <link xlink:href="&url.mysql;">&url.mysql;</link> + </para> + + <para> + يوجد نبذه عامه عن استخدام ال MySQL مع ال PHP يمكنك الوصول اليها عبر الرابط التالي + <xref linkend="mysqli.overview"/> + </para> + + <para> + التوثيق والمساعده ودليل استخدام MySQL يمكنك الوصل اليهم عبر الرابط التالي + <link + xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>. + </para> + + <para> + ان بعض اجزاء المستند تم نسخها من دليل استخدام MySQL بترخيص من Oracle Corporation. + </para> + + <section xml:id="mysqli.examples"> + + <title>امثله</title> + + <para> + كل الامثله الخاصه ب <literal>mysqli</literal> ودليل الاستخدام الخاص بها تستخدم قاعده البيانات العالمية +يمكنك الوصول الى قاعده البيانات العالميه عبر الرابط + <link xlink:href="&url.mysql.example;">&url.mysql.example;</link> + </para> + + </section> + + </preface> + + + + &reference.mysqli.overview; + &reference.mysqli.quickstart; + &reference.mysqli.setup; + &reference.mysqli.persistconns; + &reference.mysqli.constants; + &reference.mysqli.notes; + &reference.mysqli.summary; + &reference.mysqli.mysqli; + &reference.mysqli.mysqli-stmt; + &reference.mysqli.mysqli-result; + &reference.mysqli.mysqli-driver; + &reference.mysqli.mysqli-warning; + &reference.mysqli.mysqli-sql-exception; + &reference.mysqli.reference; + +<appendix xmlns="http://docbook.org/ns/docbook" xml:id="changelog.mysqli"> + <title>&ChangelogListingTitle;</title> + <para>&ChangelogListingDescription;</para> + <?phpdoc generate-changelog-for="ref.mysqli class.mysqli class.mysqli-stmt class.mysqli-result class.mysqli-driver class.mysqli-warning class.mysqli-sql-exception"?> +</appendix> + +</book> + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=48860 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=48860 ------------------------------------------------------------------ New file: ar/reference/readline/setup.xml By: visualmind on 2013-08-09 08:46:05 =================================================================== --- ar/reference/readline/setup.xml +++ ar/reference/readline/setup.xml @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<chapter xml:id="readline.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.setup; + +  + <section xml:id="readline.requirements"> + &reftitle.required; + <para> + لاسعمال دوال readline, يجب عليك ان تقوم بتثبيت libreadline. يمكن ان تجدها في الصفحة الرئيسية لمشروع GNU Readline project, هنا + <link xlink:href="&url.readline;">&url.readline;</link>. + It's maintained by Chet Ramey, who's also the author of Bash. + </para> + <para> + يمكنك ايضا استعمال هذه الدوال مع libedit library, + كترخيص بديل ل non-GPL. libedit library تأتي تحت ترخيص BSD + وهي متاحة للتحميل من هنا + <link xlink:href="&url.libedit;">&url.libedit;</link>. + </para> + </section> +  + +  + &reference.readline.configure; +  + + &reference.readline.ini; + +  + <section xml:id="readline.resources"> + &reftitle.resources; + &no.resource; + </section> +  + +</chapter> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=49247 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=49247 ------------------------------------------------------------------ New file: ar/reference/apc/setup.xml By: visualmind on 2014-03-06 21:40:52 =================================================================== --- ar/reference/apc/setup.xml +++ ar/reference/apc/setup.xml @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<chapter xml:id="apc.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.setup; + + <section xml:id="apc.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section xml:id="apc.installation"> + &reftitle.install; + <para> + &pecl.moved; + </para> + <para> + &pecl.info; + <link xlink:href="&url.pecl.package;apc">&url.pecl.package;apc</link>. + </para> + <para> + &pecl.windows.download; + </para> + <note> + <simpara> + على ويندوز، APC يحتاج مسار مؤقت في الوجود، ويكون + قابل للكتابة من قبل خادم الويب. فإنه يتحقق TMP، TEMP + ومتغيرات البيئة USERPROFILE في هذا النظام + وأخيرا يحاول الدليل WINDOWS إذا كان أي من + يتم تعيين هؤلاء. + </simpara> + </note> + <note> + <simpara> + لأكثر تعمقا وتفاصيل التنفيذ التقني للغاية، راجع + <link xlink:href="&url.apc.technotes;"> + developer-supplied TECHNOTES file + </link>. + </simpara> + </note> + </section> + + &reference.apc.ini; + + <section xml:id="apc.resources"> + &reftitle.resources; + &no.resource; + </section> + +</chapter> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=52746 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=52746 ------------------------------------------------------------------ New file: ar/reference/mysql/book.xml By: visualmind on 2014-06-09 09:58:30 =================================================================== --- ar/reference/mysql/book.xml +++ ar/reference/mysql/book.xml @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<book xml:id="book.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <?phpdoc extension-membership="bundledexternal"?> + <title>Original MySQL API</title> + <titleabbrev>Mysql</titleabbrev> + +  + <preface xml:id="intro.mysql"> + &reftitle.intro; + <para> + تم اهمال هذه الاضافة اعتباراً من php 5.5.0, + وليس من المستحسن العمل فيها غير انها سوف تحذف في المستقبل. + وبدل منها يمكنك استعمال اضافتي <link linked="book.mysqli">Mysqli</link> او <link linked="ref.pdo-mysql">PDO_MySQL</link>. + انظر ايضا <link linkend="mysqlinfo.api.choosing"> نظرة على Mysqli API</link>. + </para> + <para> + هذه الدوال تعطيك الوصول الى خادم قاعدة بيانات MYsql + للمزيد من المعلومات عنها من هنا + <link xlink:href="&url.mysql;">&url.mysql;</link>. + </para> + <para> + المستندات المتاحة توجد هنا + <link xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>. + </para> + </preface> +  + + &reference.mysql.setup; + &reference.mysql.changelog; + &reference.mysql.constants; + &reference.mysql.examples; + &reference.mysql.reference; + +</book> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=54379 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=54379 ------------------------------------------------------------------ New file: ar/reference/strings/functions/echo.xml By: visualmind on 2014-08-26 16:29:56 =================================================================== --- ar/reference/strings/functions/echo.xml +++ ar/reference/strings/functions/echo.xml @@ -0,0 +1,169 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.echo"> + <refnamediv> + <refname>echo</refname> + <refpurpose>تقوم بإخراج متغير أو أكثر</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>echo</methodname> + <methodparam><type>string</type><parameter>arg1</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <simpara> + تخرج كل المعاملات. + </simpara> + <para> + <literal>echo</literal> ليست دالة في الحقيقة -بادئة في اللغة-, لذلك انت لست مرغماً ان تستخدم الاقواس معها. <literal>echo</literal> -على خلاف بوادئ اللغة الأخرى- لا تمارس ممارسات الدوال, ولذلك لا يمكننا ان نضعها في سياق الدوال.بالاضافة الى انك اذا اردت اضافة اكثر من معامل لـ <literal>echo</literal>, المعاملات لا يجب ان توضع في وسط الأقواس. + </para> + <para> + <literal>echo</literal> ايضاً تملك صيغة مختصرة, حيث يمكنك استخدام رمز الفتح ثم علامة المساوة فوراً للتعبير عنها. ابتداءً من PHP 5.4.0, + هذا الاختصار يعمل فقط اثناء + <link linkend="ini.short-open-tag">short_open_tag</link> عمل الاعدادات الخاصة بها + <informalexample> + <programlisting role="php"> +<![CDATA[ +I have <?=$foo?> foo. +]]> + </programlisting> + </informalexample> + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>arg1</parameter></term> + <listitem> + <para> + المعامل المراد اخراجه + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><literal>echo</literal> امثلة</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo "Hello World"; + +echo "This spans +multiple lines. The newlines will be +output as well"; + +echo "This spansnmultiple lines. The newlines will benoutput as well."; + +echo "Escaping characters is done "Like this"."; + +// You can use variables inside of an echo statement +$foo = "foobar"; +$bar = "barbaz"; + +echo "foo is $foo"; // foo is foobar + +// You can also use arrays +$baz = array("value" => "foo"); + +echo "this is {$baz['value']} !"; // this is foo ! + +// Using single quotes will print the variable name, not the value +echo 'foo is $foo'; // foo is $foo + +// If you are not using any other characters, you can just echo variables +echo $foo; // foobar +echo $foo,$bar; // foobarbarbaz + +// Some people prefer passing multiple parameters to echo over concatenation. +echo 'This ', 'string ', 'was ', 'made ', 'with multiple parameters.', chr(10); +echo 'This ' . 'string ' . 'was ' . 'made ' . 'with concatenation.' . "n"; + +echo <<<END +This uses the "here document" syntax to output +multiple lines with $variable interpolation. Note +that the here document terminator must appear on a +line with just a semicolon. no extra whitespace! +END; + +// Because echo does not behave like a function, the following code is invalid. +($some_var) ? echo 'true' : echo 'false'; + +// However, the following examples will work: +($some_var) ? print 'true' : print 'false'; // print is also a construct, but + // it behaves like a function, so + // it may be used in this context. +echo $some_var ? 'true': 'false'; // changing the statement around +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.language-construct; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>print</function></member> + <member><function>printf</function></member> + <member><function>flush</function></member> + <member><link linkend="language.types.string.syntax.heredoc">Heredoc syntax</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=57150 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=57150 ------------------------------------------------------------------ New file: ar/faq/databases.xml By: visualmind on 2014-08-26 17:16:04 =================================================================== --- ar/faq/databases.xml +++ ar/faq/databases.xml @@ -0,0 +1,330 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + + <chapter xml:id="faq.databases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>مشاكل قواعد البيانات</title> + <titleabbrev>مشاكل قواعد البيانات</titleabbrev> + + <para> + هذا القسم يشمل الأسئلة الشائعة حول العلاقة بين البي اتش بي و قواعد البيانات. نعم، البي اتش بي قادرة افتراضيا على الاتصال مع أي قاعدة بيانات متوفرة اليوم . + </para> + + <qandaset> + <qandaentry xml:id="faq.databases.mssql"> + <question> + <para> + سمعت أنه بالإمكان الاتصال مع مايكروسوفت اس كيو ال سيرفر من خلال البي اتش بي. كيف ؟ + </para> + </question> + <answer> + <para> + على أجهزة الويندوز، بإمكانك استخدام الدعم المضمن ل ODBC و الدرايفر الخاص بها بكل بساطة . + </para> + <para> + On Unix machines, you can use the Sybase-CT driver + to access Microsoft SQL Servers because they are (at + least mostly) protocol-compatible. Sybase has made a + <link xlink:href="&url.sybase.ctlib;">free version of the necessary + libraries for Linux systems</link>. For other Unix operating + systems, you need to contact Sybase for the correct libraries. + Also see the answer to the next question. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.access"> + <question> + <para>Can I access Microsoft Access databases?</para> + </question> + <answer> + <para> + Yes. You already have all the tools you need if you are running + entirely under Windows 9x/Me, or NT/2000, where you can use + ODBC and Microsoft's ODBC drivers for Microsoft Access databases. + </para> + <para> + If you are running PHP on a Unix box and want to talk to MS Access + on a Windows box you will need Unix ODBC drivers. + <link xlink:href="&url.openlink;">OpenLink Software</link> has Unix-based + ODBC drivers that can do this. + </para> + <para> + Another alternative is to use an SQL server that has + Windows ODBC drivers and use that to store the data, which you can + then access from Microsoft Access (using ODBC) and PHP (using the + built in drivers), or to use an intermediary file format that Access + and PHP both understand, such as flat files or dBase databases. + On this point Tim Hayes from OpenLink software writes: + <blockquote> + <para> + Using another database as an intermediary is not a good idea, when you can + use ODBC from PHP straight to your database - i.e. with OpenLink's drivers. If + you do need to use an intermediary file format, OpenLink have now released + Virtuoso (a virtual database engine) for NT, Linux and other Unix platforms. + Please visit our <link xlink:href="&url.openlink;">website</link> for a free download. + </para> + </blockquote> + </para> + <para> + One option that has proved successful is to use MySQL and its + MyODBC drivers on Windows and synchronizing the databases. Steve Lawrence + writes: + </para> + <para> + <itemizedlist> + <listitem> + <simpara> + Install MySQL on your platform according to instructions with MySQL. + Latest available from <link xlink:href="&url.mysql;">&url.mysql;</link> + No special configuration required except when you set up a database, and configure the + user account, you should put % in the host field, or the host name of the + Windows computer you wish to access MySQL with. Make a note of your server + name, username, and password. + </simpara> + </listitem> + <listitem> + <simpara> + Download the MyODBC for Windows driver from the MySQL site. + Install it on your Windows machine. You can test the operation with + the utilities included with this program. + </simpara> + </listitem> + <listitem> + <simpara> + Create a user or system dsn in your ODBC administrator, located in the + control panel. Make up a dsn name, enter your hostname, user name, password, + port, etc for you MySQL database configured in step 1. + </simpara> + </listitem> + <listitem> + <simpara> + Install Access with a full install, this makes sure you get the proper + add-ins... at the least you will need ODBC support and the linked table + manager. + </simpara> + </listitem> + <listitem> + <simpara> + Now the fun part! Create a new access database. In the table + window right click and select Link Tables, or under the file + menu option, select Get External Data and then Link Tables. + When the file browser box comes up, select files of type: ODBC. + Select System dsn and the name of your dsn created in step 3. + Select the table to link, press OK, and presto! You can now + open the table and add/delete/edit data on your MySQL server! + You can also build queries, import/export tables to MySQL, + build forms and reports, etc. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Tips and Tricks: + <itemizedlist> + <listitem> + <simpara> + You can construct your tables in Access and export them + to MySQL, then link them back in. That makes table + creation quick. + </simpara> + </listitem> + <listitem> + <simpara> + When creating tables in Access, you must have a primary + key defined in order to have write access to the table in + access. Make sure you create a primary key in MySQL before + linking in access + </simpara> + </listitem> + <listitem> + <simpara> + If you change a table in MySQL, you have to re-link it + in Access. Go to tools>add-ins>linked table manager, + cruise to your ODBC DSN, and select the table to re-link + from there. you can also move your dsn source around there, + just hit the always prompt for new location checkbox before + pressing OK. + </simpara> + </listitem> + </itemizedlist> + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.mysql.deprecated"> + <question> + <para> + Why is the MySQL extension (ext/mysql) that I've been using for over + 10 years discouraged from use? Is it deprecated? What do I use instead? + How can I migrate? + </para> + </question> + <answer> + <para> + There are three MySQL extensions, as described under the + <link linkend="mysqlinfo.api.choosing">Choosing a MySQL API</link> section. The old API + should not be used, and one day it will be deprecated and eventually removed from PHP. + It is a popular extension so this will be a slow process, but you are strongly encouraged + to write all new code with either <link linkend="book.mysqli">mysqli</link> or + <link linkend="ref.pdo-mysql">PDO_MySQL</link>. + </para> + <para> + Migration scripts are not available at this time, although the mysqli API contains both + a procedural and OOP API, with the procedural version being similar to ext/mysql. + </para> + <para> + It is not possible to mix the extensions. So, for example, passing a mysqli connection to + PDO_MySQL or ext/mysql will not work. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.mysql.php5"> + <question> + <para> + PHP 5 no longer bundles MySQL client libraries, what does this mean to + me? Can I still use MySQL with PHP? I try to use MySQL and get + "function undefined" errors, what gives? + </para> + </question> + <answer> + <para> + Yes. There will always be MySQL support in PHP of one kind or + another. The only change in PHP 5 is that we are no longer bundling + the client library itself. Some reasons in no particular order: + </para> + <itemizedlist> + <listitem> + <para> + Most systems these days already have the client library installed. + </para> + </listitem> + <listitem> + <para> + Given the above, having multiple versions of the library can get + messy. For example, if you link mod_auth_mysql against one version + and PHP against another, and then enable both in Apache, you get a + nice fat crash. Also, the bundled library didn't always play well + with the installed server version. The most obvious symptom of this + being disagreement over where to find the mysql.socket Unix domain + socket file. + </para> + </listitem> + <listitem> + <para> + Maintenance was somewhat lax and it was falling further and further + behind the released version. + </para> + </listitem> + <listitem> + <para> + Future versions of the library are under the GPL and thus we don't + have an upgrade path since we cannot bundle a GPL'ed library in a + BSD/Apache-style licensed project. A clean break in PHP 5 seemed + like the best option. + </para> + </listitem> + </itemizedlist> + <para> + This won't actually affect that many people. Unix users, at least the + ones who know what they are doing, tend to always build PHP against + their system's libmysqlclient library simply by adding the <option + role="configure">--with-mysql=/usr</option> option + when building PHP. Windows users may enable the extension + <filename>php_mysql.dll</filename> inside &php.ini;. + For more details, see the <link linkend="ref.mysql">MySQL Reference</link> + for installation instructions. Also, be sure + <filename>libmysql.dll</filename> is available to the systems PATH. + For more details on how, read the FAQ on + <link linkend="faq.installation.addtopath">setting up the Windows + systems PATH</link>. Because <filename>libmysql.dll</filename> (and + many other PHP related files) exist in the PHP folder, you'll want to + add the PHP folder to your systems PATH. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.shared-mysql"> + <question> + <para> + After installing shared MySQL support, Apache dumps core as soon + as libphp4.so is loaded. Can this be fixed? + </para> + </question> + <answer> + <para> + If your MySQL libs are linked against pthreads this will happen. Check + using ldd. If they are, grab the MySQL tarball and compile from source, + or recompile from the source rpm and remove the switch in the spec file + that turns on the threaded client code. Either of these suggestions will + fix this. Then recompile PHP with the new MySQL libs. + </para> + </answer> + </qandaentry> + + <qandaentry xml:id="faq.databases.mysqlresource"> + <question> + <para> + Why do I get an error that looks something like this: + "Warning: 0 is not a MySQL result index in <file> + on line <x>" or "Warning: Supplied argument is not + a valid MySQL result resource in <file> on line <x>"? + </para> + </question> + <answer> + <para> + You are trying to use a result identifier that is 0. The 0 indicates + that your query failed for some reason. You need to check for errors + after submitting a query and before you attempt to use the returned + result identifier. The proper way to do this is with code similar + to the following: + <programlisting role="php"> +<![CDATA[ +<?php + +$result = mysql_query("SELECT * FROM tables_priv"); +if (!$result) { + echo mysql_error(); + exit; +} +?> +]]> + </programlisting> + or + <programlisting role="php"> +<![CDATA[ +<?php + +$result = mysql_query("SELECT * FROM tables_priv") + or die("Bad query: " . mysql_error()); +?> +]]> + </programlisting> + </para> + </answer> + </qandaentry> + </qandaset> + </chapter> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=57285 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=57285 ------------------------------------------------------------------ New file: ar/install/macos/compile.xml By: visualmind on 2014-10-01 12:11:19 =================================================================== --- ar/install/macos/compile.xml +++ ar/install/macos/compile.xml @@ -0,0 +1,33 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + + <sect1 xml:id="install.macosx.compile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>تجميع PHP على نظام التشغيل Mac OS X</title> + <simpara> + استخدام<link linkend="install.unix">دليل التثبيت Unix</link> to compile + PHP في نظام التشغيل Mac OS X. + </simpara> + </sect1> + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=58709 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=58709 ------------------------------------------------------------------ New file: ar/reference/zlib/configure.xml By: visualmind on 2014-10-02 13:45:30 =================================================================== --- ar/reference/zlib/configure.xml +++ ar/reference/zlib/configure.xml @@ -0,0 +1,39 @@ +<?xml version="1.0" encoding="utf-8"?> + + + + +<section xml:id="zlib.installation" xmlns="http://docbook.org/ns/docbook"> + &reftitle.install; + <para> + Zlib ليس متاح تلقائيا. يجب تهيأة PHP<option role="configure">--with-zlib[=DIR]</option> + </para> + &windows.builtin; + <note> + <simpara> + دعم متكامل ل zlib على الونداوز منذ PHP 4.3.0 + </simpara> + </note> +</section> + + + => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=58727 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=58727 ------------------------------------------------------------------ Modified: ar/translation.xml By: visualmind on 2012-11-03 23:52:05 =================================================================== --- ar/translation.xml +++ ar/translation.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8" ?> -<!DOCTYPE translation SYSTEM "../doc-base/phpbook/phpbook-xsml/translation.dtd"> +<!DOCTYPE translation SYSTEM "../dtds/translation.dtd"> <translation xmlns="http://docbook.org/ns/docbook"> @@ -20,10 +20,11 @@ </translators> <inactive> - <person name="inactive:Jad madi" email="Jad@php.net" nick="jad" vcs="yes"/> - <person name="inactive:Hafid Benhadria" email="arab_prog@algeriecom.com" nick="hafid" vcs="no"/> - <person name="inactive:Mohammed Al-Qarni" email="ma1420@hotmail.com" nick="mohammed" vcs="no"/> - <person name="inactive:Abdulrahman" email="ababab90@yahoo.com" nick="Abdulrahman" vcs="no"/> + <person name="inactive:Jad madi" email="Jad@php.net" nick="jad" cvs="yes"/> + <person name="inactive:Hafid Benhadria" email="arab_prog@algeriecom.com" nick="hafid" cvs="no"/> + <person name="inactive:Mohammed Al-Qarni" email="ma1420@hotmail.com" nick="mohammed" cvs="no"/> + <person name="inactive:Abdulrahman" email="ababab90@yahoo.com" nick="Abdulrahman" cvs="no"/> + <person name="inactive:Yousef Ismaeil" email="cliprz@gmail.com" nick="Cliprz" cvs="no"/> </inactive> <work-in-progress> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=42716 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=42716 ------------------------------------------------------------------ Modified: ar/reference/var/book.xml By: visualmind on 2014-08-26 20:19:14 =================================================================== --- ar/reference/var/book.xml +++ ar/reference/var/book.xml @@ -10,9 +10,9 @@ <preface xml:id="intro.var"> &reftitle.intro; <para> - للحصول على معلومات حول كيفية التصرف راجع - <link linkend="language.variables">المتغيرات </link>ادخال في - <link linkend="langref">مرجع اللغة </link> للقسم الدليل. + للحصول على معلومات حول كيفية التصرف مع المتغيرات راجع + <link linkend="language.variables">المتغيرات</link>إدخال + <link linkend="langref">مرجع اللغة</link>في دليل قسم </para> </preface> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=57287 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=57287 ------------------------------------------------------------------ Modified: ar/reference/spl/splfileinfo/getatime.xml By: visualmind on 2014-09-14 18:54:52 =================================================================== --- ar/reference/spl/splfileinfo/getatime.xml +++ ar/reference/spl/splfileinfo/getatime.xml @@ -6,7 +6,7 @@ <refentry xml:id="splfileinfo.getatime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>SplFileInfo::getATime</refname> - <refpurpose>للحصول على زمن/وقت آخر وصول للملف</refpurpose> + <refpurpose>تحصل على آخر وقت تم فيه الدخول للملف</refpurpose> </refnamediv> <refsect1 role="description"> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=58100 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=58100 ------------------------------------------------------------------ Modified: ar/reference/mysql/functions/mysql-create-db.xml By: visualmind on 2014-09-14 19:09:38 =================================================================== --- ar/reference/mysql/functions/mysql-create-db.xml +++ ar/reference/mysql/functions/mysql-create-db.xml @@ -5,14 +5,14 @@ <refentry xml:id="function.mysql-create-db" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>mysql_create_db</refname> - <refpurpose>يستخدم لإنشاء قاعدة البيانات</refpurpose> + <refpurpose>تستخدم لانشاء قاعدة بيانات</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>bool</type><methodname>mysql_create_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <type>منطقي</type><methodname>mysql_create_db</methodname> + <methodparam><type>سلسلة</type><parameter>اسم قاعدة البيانات</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> @@ -28,7 +28,7 @@ <term><parameter>إسم قاعدة البيانات</parameter></term> <listitem> <para> - الإسم الخاص بقاعدة البيانات التي سيتم إنشاءها + اسم قاعدة البيانات التي سيتم انشاؤها </para> </listitem> </varlistentry> @@ -63,9 +63,9 @@ $sql = 'CREATE DATABASE my_db'; if (mysql_query($sql, $link)) { - echo "Database my_db created successfullyn"; + echo "تم انشاء قاعدة البيانات بنجاحn"; } else { - echo 'Error creating database: ' . mysql_error() . "n"; + echo 'حدث خطا اثناء انشاء اعدة البيانات: ' . mysql_error() . "n"; } ?> ]]> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=58101 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=58101 ------------------------------------------------------------------ -- https://edit.php.net/ This email is send automatically by the Php Docbook Online Editor.