Contributions are ready for review
[email protected] Mon, 12 Jan 2015 08:00:01 -0500
| Newsgroups | php.doc.ar |
|---|---|
| Message-ID | <[email protected]> |
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"?>
+<!-- $Revision: 313269 $ -->
+<!-- Membership: pecl -->
+<!-- State: experimental -->
+
+<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>
+
+<!-- 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
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/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
+-->
+
=> 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"?>
+<!-- $Revision: 311478 $ -->
+<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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 324829 Maintainer: anonymous #16754 Status: ready -->
+<!-- Reviewed: no -->
+
+<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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: XX Maintainer: ŊØ-way For-Happiness Status: ready -->
+<!-- Reviewed: no Maintainer: ŊØ-way For-Happiness -->
+<!-- EN-Revision: 323235 Maintainer: ŊØ-way For-Happiness Status: ready -->
+<!-- Reviewed: no -->
+
+<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>
+ <!-- Undocumented confusing syntax:
+ <methodsynopsis>
+ <type>resource</type><methodname>mysql_pconnect</methodname>
+ <methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>new_link</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam>
+ </methodsynopsis>
+ -->
+ <para>
+ Establishes a persistent connection to a MySQL server.
+ </para>
+ <!-- TODO: Integrate this information more nicely with features.persistent -->
+ <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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 327173 Maintainer: تركي العولقي Status: ready -->
+<!-- Reviewed: no -->
+
+<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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 330340 Maintainer: Mohammed Nasser Status: ready -->
+<!-- Reviewed: no -->
+
+
+<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 -->
+ <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>
+
+<!-- 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:"~/.phpdoc/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
+-->
+
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 330340 Maintainer: Ayman Elarian Status: ready -->
+<!-- Reviewed: yes -->
+
+<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 -->
+
+ <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>
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 312733 Maintainer: anonymous #32318 Status: ready -->
+<!-- Reviewed: no -->
+
+<chapter xml:id="readline.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <!-- {{{ Requirements -->
+ <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>
+ <!-- }}} -->
+
+ <!-- {{{ Installation -->
+ &reference.readline.configure;
+ <!-- }}} -->
+
+ &reference.readline.ini;
+
+ <!-- {{{ Resources -->
+ <section xml:id="readline.resources">
+ &reftitle.resources;
+ &no.resource;
+ </section>
+ <!-- }}} -->
+
+</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:"~/.phpdoc/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
+-->
+
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 304703 Maintainer: Abdulrahman al besimi Status: ready -->
+<!-- Reviewed: no -->
+
+<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>
+
+<!-- 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:"~/.phpdoc/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
+-->
+
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 330340 Maintainer: Fayez Dhessat Status: ready -->
+<!-- Reviewed: no -->
+
+<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 -->
+ <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>
+
+<!-- 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:"~/.phpdoc/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
+-->
+
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 327507 Maintainer: owis sabry (أبو المثنى السكندري) Status: ready -->
+<!-- Reviewed: no -->
+
+<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;
+ ¬e.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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 326002 Maintainer: anonymous #48612 Status: ready -->
+<!-- Reviewed: no -->
+
+ <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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 304566 Maintainer: gamesat 11 Status: ready -->
+<!-- Reviewed: no -->
+
+ <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>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> 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"?>
+<!-- $Revision: 1$ -->
+<!-- EN-Revision: 297028 Maintainer: Abou Abdi Allah “MrJava” Java Status: ready -->
+<!-- Reviewed: no -->
+
+<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>
+
+<!-- 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:"~/.phpdoc/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
+-->
+
=> 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="[email protected]" nick="jad" vcs="yes"/>
- <person name="inactive:Hafid Benhadria" email="[email protected]" nick="hafid" vcs="no"/>
- <person name="inactive:Mohammed Al-Qarni" email="[email protected]" nick="mohammed" vcs="no"/>
- <person name="inactive:Abdulrahman" email="[email protected]" nick="Abdulrahman" vcs="no"/>
+ <person name="inactive:Jad madi" email="[email protected]" nick="jad" cvs="yes"/>
+ <person name="inactive:Hafid Benhadria" email="[email protected]" nick="hafid" cvs="no"/>
+ <person name="inactive:Mohammed Al-Qarni" email="[email protected]" nick="mohammed" cvs="no"/>
+ <person name="inactive:Abdulrahman" email="[email protected]" nick="Abdulrahman" cvs="no"/>
+ <person name="inactive:Yousef Ismaeil" email="[email protected]" 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.