Re: [PHP-DOC] Farsi Translation of PHP Manual
Hello Official language code for farsi is:fa and for Iran is:Ir We have very good and powerfull group and we want to make php global in Iran I think that when we start to translate and publish php doc (at now we translate many pages of php manuall) many php programmer from our country help us for translating becuase they like php very very much.and we have a group that their job is only translating. Please help me to get a CVS account. Thanks On Sat, 12 Feb 2005 14:11:43 +, Gabor Hojtsy [EMAIL PROTECTED] wrote: Hi Mohsen, I recall attempts before that some people offered to start a Farsi translation, but for some reason, it was never completed. What is the official language code for Farsi? Note that if you have enough willingness, your work is far from complete, if you only translate the full manual, you need to track the changes from time to time. The manual changed daily. You will be able to find detailed information at http://doc.php.net/php/dochowto/index.php Regards, Gabor Hojtsy
Re: [PHP-DOC] Farsi Translation of PHP Manual
Hello Mohsen, On Sun, 13 Feb 2005, Mohsen Barahmand wrote: Official language code for farsi is:fa and for Iran is:Ir We have very good and powerfull group and we want to make php global in Iran I think that when we start to translate and publish php doc (at now we translate many pages of php manuall) many php programmer from our country help us for translating becuase they like php very very much.and we have a group that their job is only translating. Please help me to get a CVS account. Two things that need to be done to setup a language module and to apply for a CVS account: 1. request [EMAIL PROTECTED] to add a new language module (as I CC-ed them that is not necessary anymore) 2. request a CVS account through: http://php.net/cvs-php.php Furthermore, it is strongly suggested to read through the DOC HowTO: http://no.php.net/manual/howto/index.html . This has a lot of information on how translatings should be done. regards, Derick -- Derick Rethans http://derickrethans.nl | http://ez.no | http://xdebug.org
Re: [PHP-DOC] Farsi Translation of PHP Manual
On Sun, 13 Feb 2005, Derick Rethans wrote: Hello Mohsen, On Sun, 13 Feb 2005, Mohsen Barahmand wrote: Official language code for farsi is:fa and for Iran is:Ir We have very good and powerfull group and we want to make php global in Iran I think that when we start to translate and publish php doc (at now we translate many pages of php manuall) many php programmer from our country help us for translating becuase they like php very very much.and we have a group that their job is only translating. Please help me to get a CVS account. Two things that need to be done to setup a language module and to apply for a CVS account: 1. request [EMAIL PROTECTED] to add a new language module (as I CC-ed them that is not necessary anymore) I think there already is one: http://viewcvs.php.net/viewcvs.cgi/*checkout*/phpdoc-ar/preface.xml?rev=1.8content-type=text/plain is that farsi? regards, Derick -- Derick Rethans http://derickrethans.nl | http://ez.no | http://xdebug.org
[PHP-DOC] cvs: phpdoc /en/reference/sockets reference.xml /en/reference/sockets/functions socket-accept.xml socket-bind.xml socket-clear-error.xml socket-close.xml socket-connect.xml socket-create-listen.xml socket-create-pair.xml socket-get-option.xml socket-getpeername.xml socket-getsockname.xml socket-last-error.xml socket-listen.xml socket-read.xml socket-recv.xml socket-recvfrom.xml socket-select.xml socket-send.xml socket-sendto.xml socket-set-nonblock.xml socket-set-option.xml socket-shutdown.xml socket-strerror.xml socket-write.xml
tony2001Sun Feb 13 09:19:02 2005 EDT Modified files: /phpdoc/en/reference/socketsreference.xml /phpdoc/en/reference/sockets/functions socket-accept.xml socket-bind.xml socket-clear-error.xml socket-close.xml socket-connect.xml socket-create-listen.xml socket-create-pair.xml socket-get-option.xml socket-getpeername.xml socket-getsockname.xml socket-last-error.xml socket-listen.xml socket-read.xml socket-recv.xml socket-recvfrom.xml socket-select.xml socket-send.xml socket-sendto.xml socket-set-nonblock.xml socket-set-option.xml socket-shutdown.xml socket-strerror.xml socket-write.xml Log: ext/sockets is no longer experimental since Nov 29 2002 http://cvs.php.net/diff.php/phpdoc/en/reference/sockets/reference.xml?r1=1.19r2=1.20ty=u Index: phpdoc/en/reference/sockets/reference.xml diff -u phpdoc/en/reference/sockets/reference.xml:1.19 phpdoc/en/reference/sockets/reference.xml:1.20 --- phpdoc/en/reference/sockets/reference.xml:1.19 Thu Aug 12 21:00:48 2004 +++ phpdoc/en/reference/sockets/reference.xml Sun Feb 13 09:19:00 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.19 $ -- +!-- $Revision: 1.20 $ -- reference id=ref.sockets titleSocket Functions/title titleabbrevSockets/titleabbrev @@ -34,7 +34,6 @@ in PHP. The ulink url=url.socket.faq;Unix Socket FAQ/ulink might be a good start. /para -warn.experimental; /section section id=sockets.requirements http://cvs.php.net/diff.php/phpdoc/en/reference/sockets/functions/socket-accept.xml?r1=1.3r2=1.4ty=u Index: phpdoc/en/reference/sockets/functions/socket-accept.xml diff -u phpdoc/en/reference/sockets/functions/socket-accept.xml:1.3 phpdoc/en/reference/sockets/functions/socket-accept.xml:1.4 --- phpdoc/en/reference/sockets/functions/socket-accept.xml:1.3 Tue Apr 30 18:53:24 2002 +++ phpdoc/en/reference/sockets/functions/socket-accept.xml Sun Feb 13 09:19:01 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.3 $ -- +!-- $Revision: 1.4 $ -- !-- splitted from ./en/functions/sockets.xml, last change in rev 1.1 -- refentry id=function.socket-accept refnamediv @@ -12,7 +12,6 @@ typeresource/typemethodnamesocket_accept/methodname methodparamtyperesource/typeparametersocket/parameter/methodparam /methodsynopsis -warn.experimental.func; para After the socket parametersocket/parameter has been created using functionsocket_create/function, bound to a name with http://cvs.php.net/diff.php/phpdoc/en/reference/sockets/functions/socket-bind.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/sockets/functions/socket-bind.xml diff -u phpdoc/en/reference/sockets/functions/socket-bind.xml:1.5 phpdoc/en/reference/sockets/functions/socket-bind.xml:1.6 --- phpdoc/en/reference/sockets/functions/socket-bind.xml:1.5 Mon Apr 21 16:16:34 2003 +++ phpdoc/en/reference/sockets/functions/socket-bind.xml Sun Feb 13 09:19:01 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- !-- splitted from ./en/functions/sockets.xml, last change in rev 1.3 -- refentry id=function.socket-bind refnamediv @@ -14,7 +14,6 @@ methodparamtypestring/typeparameteraddress/parameter/methodparam methodparam choice=opttypeint/typeparameterport/parameter/methodparam /methodsynopsis -warn.experimental.func; para functionsocket_bind/function binds the name given in parameteraddress/parameter to the socket described by http://cvs.php.net/diff.php/phpdoc/en/reference/sockets/functions/socket-clear-error.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/sockets/functions/socket-clear-error.xml diff -u phpdoc/en/reference/sockets/functions/socket-clear-error.xml:1.5 phpdoc/en/reference/sockets/functions/socket-clear-error.xml:1.6 ---
[PHP-DOC] #31959 [NEW]: msql_error() does not take a parameter
From: danielc at analysisandsolutions dot com Operating system: Irrelevant PHP version: 5CVS-2005-02-13 (dev) PHP Bug Type: Documentation problem Bug description: msql_error() does not take a parameter Description: http://php.net/msql_error says the funciton takes a parameter. It does not. See http://cvs.php.net/annotate.php/php-src/ext/msql/php_msql.c?rev=1.58#478 to confirm. Thanks. -- Edit bug report at http://bugs.php.net/?id=31959edit=1 -- Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=31959r=trysnapshot4 Try a CVS snapshot (php5.0): http://bugs.php.net/fix.php?id=31959r=trysnapshot50 Try a CVS snapshot (php5.1): http://bugs.php.net/fix.php?id=31959r=trysnapshot51 Fixed in CVS:http://bugs.php.net/fix.php?id=31959r=fixedcvs Fixed in release:http://bugs.php.net/fix.php?id=31959r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=31959r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=31959r=needscript Try newer version: http://bugs.php.net/fix.php?id=31959r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=31959r=support Expected behavior: http://bugs.php.net/fix.php?id=31959r=notwrong Not enough info: http://bugs.php.net/fix.php?id=31959r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=31959r=submittedtwice register_globals:http://bugs.php.net/fix.php?id=31959r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=31959r=php3 Daylight Savings:http://bugs.php.net/fix.php?id=31959r=dst IIS Stability: http://bugs.php.net/fix.php?id=31959r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=31959r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=31959r=float No Zend Extensions: http://bugs.php.net/fix.php?id=31959r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=31959r=mysqlcfg
[PHP-DOC] cvs: phpdoc /en/reference/msql/functions msql-error.xml
vrana Sun Feb 13 15:20:47 2005 EDT Modified files: /phpdoc/en/reference/msql/functions msql-error.xml Log: There's no parameter (bug #31959) http://cvs.php.net/diff.php/phpdoc/en/reference/msql/functions/msql-error.xml?r1=1.4r2=1.5ty=u Index: phpdoc/en/reference/msql/functions/msql-error.xml diff -u phpdoc/en/reference/msql/functions/msql-error.xml:1.4 phpdoc/en/reference/msql/functions/msql-error.xml:1.5 --- phpdoc/en/reference/msql/functions/msql-error.xml:1.4 Wed Mar 3 02:33:38 2004 +++ phpdoc/en/reference/msql/functions/msql-error.xml Sun Feb 13 15:20:47 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.4 $ -- +!-- $Revision: 1.5 $ -- !-- splitted from ./en/functions/msql.xml, last change in rev 1.2 -- refentry id=function.msql-error refnamediv @@ -10,7 +10,7 @@ titleDescription/title methodsynopsis typestring/typemethodnamemsql_error/methodname - methodparam choice=opttyperesource/typeparameterlink_identifier/parameter/methodparam + void/ /methodsynopsis para functionmsql_error/function returns the last issued error by the mSQL
[PHP-DOC] cvs: phpdoc /en/reference/msql/functions msql-connect.xml
vrana Sun Feb 13 15:23:56 2005 EDT Modified files: /phpdoc/en/reference/msql/functions msql-connect.xml Log: There's no username and password parameters (bug #31951) http://cvs.php.net/diff.php/phpdoc/en/reference/msql/functions/msql-connect.xml?r1=1.9r2=1.10ty=u Index: phpdoc/en/reference/msql/functions/msql-connect.xml diff -u phpdoc/en/reference/msql/functions/msql-connect.xml:1.9 phpdoc/en/reference/msql/functions/msql-connect.xml:1.10 --- phpdoc/en/reference/msql/functions/msql-connect.xml:1.9 Tue Feb 1 06:51:57 2005 +++ phpdoc/en/reference/msql/functions/msql-connect.xml Sun Feb 13 15:23:55 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- !-- splitted from ./en/functions/msql.xml, last change in rev 1.2 -- refentry id=function.msql-connect refnamediv @@ -11,8 +11,6 @@ methodsynopsis typeint/typemethodnamemsql_connect/methodname methodparam choice=opttypestring/typeparameterhostname/parameter/methodparam - methodparam choice=opttypestring/typeparameterusername/parameter/methodparam - methodparam choice=opttypestring/typeparameterpassword/parameter/methodparam /methodsynopsis para functionmsql_connect/function establishes a connection to a
[PHP-DOC] #31792 [Opn-Bgs]: getrusage() does not give ru_nswap
ID: 31792 Updated by: [EMAIL PROTECTED] Reported By: bertrand at toggg dot com -Status: Open +Status: Bogus Bug Type:Documentation problem PHP Version: Irrelevant New Comment: It's not ru_nwsap but ru_nswap (typo). Previous Comments: [2005-02-12 15:42:42] bertrand at toggg dot com Let say it's a documentation problem. But I still consider this resource usage as an interessant indicator, if it's existing, sure. Thanks. [2005-02-01 12:37:25] bertrand at toggg dot com Description: Although this resource usage is documented in PHP manual getrusage(), ru_nwsap (number of swap) is not reported. checking ext/standard/microtime.c, it's obviously not copied in the returned array. Does exist a technical reason for that ? Thanks bertrand -- Edit this bug report at http://bugs.php.net/?id=31792edit=1
[PHP-DOC] #31927 [Opn-Bgs]: in_array() not working with array containing strings as needle
ID: 31927
Updated by: [EMAIL PROTECTED]
Reported By: bart at mediawave dot nl
-Status: Open
+Status: Bogus
Bug Type: Documentation problem
Operating System: WinXP
PHP Version: 5CVS-2005-02-11 (dev)
New Comment:
No bug here.
Previous Comments:
[2005-02-12 22:32:37] [EMAIL PROTECTED]
Well, probably this should be clarified in the docs.
But the current description looks rather clear to me, though.
Reclassifying as docu problem.
[2005-02-12 22:22:18] bart at mediawave dot nl
You are right. It isn't a bug. in_array was apparently designed to work
this way and does so properly.
Maybe we should change this to a change/feature request then? Or
otherwise a documentation problem? It simply isn't intuitive for people
now.
This is my last attempt. I won't be re-opening this bug anymore.
[2005-02-12 14:45:49] [EMAIL PROTECTED]
An array itself isn't a value.
Nope. Don't know who told you this, but he/she was definitely wrong.
So, one would expect that in_array checks if all these
values exist in the haystack.
No, see examples in the docs.
No bug here.
[2005-02-12 01:16:38] bart at mediawave dot nl
The documentation clearly states:
in_array -- Checks if a value exists in an array
It doesn't say:
in_array -- Checks if a variable exists in an array
An array itself isn't a value. It's a variable containing a collection
of values. So, one would expect that in_array checks if all these
values exist in the haystack. (Regardless of the containing variable
type/structure) It shouldn't check if a variable exists in the
haystack.
The exact match behaviour in your example should only happen when the
parameter strict is set. (In my opinion at least)
[2005-02-11 20:52:14] [EMAIL PROTECTED]
No bug here: in_array() looks for exact match.
This code works fine:
?php
$a = array(array(NT, Linux), array(Irix, Linux), OS2);
if (in_array(array(NT, Linux), $a)) {
echo NT Linux found\n;
}
?
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/31927
--
Edit this bug report at http://bugs.php.net/?id=31927edit=1
[PHP-DOC] #31951 [Opn-Csd]: msql_connect() has 0 or 1 parameters
ID: 31951 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Irrelevant PHP Version: 5CVS-2005-02-13 (dev) New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2005-02-13 05:30:55] danielc at analysisandsolutions dot com Description: http://php.net/msql_connect is wrong. msql_connect() accepts 0 or 1 parameters. See http://cvs.php.net/annotate.php/php-src/ext/msql/php_msql.c?rev=1.58#239 to confirm. So, please remove the username and password parameters. While y'all are at it, please incorporate the user note on that page regarding Unix sockets being used if the hostname parameter is not provided. Thanks. -- Edit this bug report at http://bugs.php.net/?id=31951edit=1
[PHP-DOC] #31959 [Opn-Csd]: msql_error() does not take a parameter
ID: 31959 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Irrelevant PHP Version: 5CVS-2005-02-13 (dev) New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2005-02-13 20:41:31] danielc at analysisandsolutions dot com Description: http://php.net/msql_error says the funciton takes a parameter. It does not. See http://cvs.php.net/annotate.php/php-src/ext/msql/php_msql.c?rev=1.58#478 to confirm. Thanks. -- Edit this bug report at http://bugs.php.net/?id=31959edit=1
[PHP-DOC] cvs: phpdoc /en/reference/xml/functions xml-parse.xml
vrana Sun Feb 13 16:29:56 2005 EDT Modified files: /phpdoc/en/reference/xml/functions xml-parse.xml Log: Entity errors are reported at the end of the data (bug #31821) http://cvs.php.net/diff.php/phpdoc/en/reference/xml/functions/xml-parse.xml?r1=1.5r2=1.6ty=u Index: phpdoc/en/reference/xml/functions/xml-parse.xml diff -u phpdoc/en/reference/xml/functions/xml-parse.xml:1.5 phpdoc/en/reference/xml/functions/xml-parse.xml:1.6 --- phpdoc/en/reference/xml/functions/xml-parse.xml:1.5 Sat Feb 5 19:41:24 2005 +++ phpdoc/en/reference/xml/functions/xml-parse.xml Sun Feb 13 16:29:56 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.5 $ -- +!-- $Revision: 1.6 $ -- refentry id=function.xml-parse refnamediv refnamexml_parse/refname @@ -66,6 +66,12 @@ functionxml_get_current_column_number/function and functionxml_get_current_byte_index/function. /para +note + para + Entity errors are reported at the end of the data thus only if + parameteris_final/parameter is set and true;. + /para +/note /refsect1 /refentry
[PHP-DOC] cvs: phpdoc /en/security database.xml
vrana Sun Feb 13 16:50:05 2005 EDT
Modified files:
/phpdoc/en/security database.xml
Log:
First SQL injection example is FUD (reported by Dr. Werner Popken)
http://cvs.php.net/diff.php/phpdoc/en/security/database.xml?r1=1.9r2=1.10ty=u
Index: phpdoc/en/security/database.xml
diff -u phpdoc/en/security/database.xml:1.9 phpdoc/en/security/database.xml:1.10
--- phpdoc/en/security/database.xml:1.9 Mon Nov 8 07:10:21 2004
+++ phpdoc/en/security/database.xml Sun Feb 13 16:50:05 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.9 $ --
+!-- $Revision: 1.10 $ --
!-- splitted from ./index.xml, last change in rev 1.66 --
chapter id=security.database
titleDatabase Security/title
@@ -158,56 +158,6 @@
combining it with static parameters to build a SQL query. The following
examples are based on true stories, unfortunately.
/simpara
-para
- Owing to the lack of input validation and connecting to the database on
- behalf of a superuser or the one who can create users, the attacker
- may create a superuser in your database.
- example
- title
- Splitting the result set into pages ... and making superusers
- (PostgreSQL and MySQL)
- /title
- programlisting role=php
-![CDATA[
-?php
-
-$offset = $argv[0]; // beware, no input validation!
-$query = SELECT id, name FROM products ORDER BY name LIMIT 20 OFFSET
$offset;;
-// with PostgreSQL
-$result = pg_query($conn, $query);
-// with MySQL
-$result = mysql_query($query);
-
-?
-]]
- /programlisting
- /example
- Normal users click on the 'next', 'prev' links where the
varname$offset/varname
- is encoded into the URL. The script expects that the incoming
- varname$offset/varname is a decimal number. However, what if someone
tries to
- break in by appending a functionurlencode/function'd form of the
- following to the URL
- informalexample
- programlisting role=sql
-![CDATA[
-// in case of PostgreSQL
-0;
-insert into pg_shadow(usename,usesysid,usesuper,usecatupd,passwd)
-select 'crack', usesysid, 't','t','crack'
-from pg_shadow where usename='postgres';
---
-
-// in case of MySQL
-0;
-UPDATE user SET Password=PASSWORD('crack') WHERE user='root';
-FLUSH PRIVILEGES;
-]]
- /programlisting
- /informalexample
- If it happened, then the script would present a superuser access to him.
- Note that literal0;/literal is to supply a valid offset to the
- original query and to terminate it.
-/para
note
para
It is common technique to force the SQL parser to ignore the rest of the
[PHP-DOC] cvs: phpdoc /en/reference/msql/functions msql-connect.xml
vrana Sun Feb 13 16:59:00 2005 EDT Modified files: /phpdoc/en/reference/msql/functions msql-connect.xml Log: Default hostname (user note by mlemos at acm dot org) http://cvs.php.net/diff.php/phpdoc/en/reference/msql/functions/msql-connect.xml?r1=1.10r2=1.11ty=u Index: phpdoc/en/reference/msql/functions/msql-connect.xml diff -u phpdoc/en/reference/msql/functions/msql-connect.xml:1.10 phpdoc/en/reference/msql/functions/msql-connect.xml:1.11 --- phpdoc/en/reference/msql/functions/msql-connect.xml:1.10Sun Feb 13 15:23:55 2005 +++ phpdoc/en/reference/msql/functions/msql-connect.xml Sun Feb 13 16:58:59 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.10 $ -- +!-- $Revision: 1.11 $ -- !-- splitted from ./en/functions/msql.xml, last change in rev 1.2 -- refentry id=function.msql-connect refnamediv @@ -15,8 +15,10 @@ para functionmsql_connect/function establishes a connection to a mSQL server. The parameterhostname/parameter parameter can also - include a port number. e.g. quot;hostname:portquot;. It defaults - to 'localhost'. + include a port number. e.g. quot;hostname:portquot;. + If the hostname is not specified, the connection is established by the + means of a Unix domain socket, being then more efficient then a localhost + TCP socket connection. /para note simpara
[PHP-DOC] cvs: phpdoc /en/language variables.xml
vrana Sun Feb 13 17:02:37 2005 EDT Modified files: /phpdoc/en/language variables.xml Log: Typo, WS http://cvs.php.net/diff.php/phpdoc/en/language/variables.xml?r1=1.85r2=1.86ty=u Index: phpdoc/en/language/variables.xml diff -u phpdoc/en/language/variables.xml:1.85 phpdoc/en/language/variables.xml:1.86 --- phpdoc/en/language/variables.xml:1.85 Wed Jan 19 01:51:00 2005 +++ phpdoc/en/language/variables.xmlSun Feb 13 17:02:36 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.85 $ -- +!-- $Revision: 1.86 $ -- chapter id=language.variables titleVariables/title @@ -569,9 +569,9 @@ note para - Static variables maybe declared as seen in the examples above. - Trying to assign values to these variables which are the - result of expressions will cause a parse error. + Static variables may be declared as seen in the examples above. + Trying to assign values to these variables which are the + result of expressions will cause a parse error. /para para example
[PHP-DOC] cvs: phpdoc /en/language variables.xml
vrana Sun Feb 13 17:05:29 2005 EDT
Modified files:
/phpdoc/en/language variables.xml
Log:
Coding style
http://cvs.php.net/diff.php/phpdoc/en/language/variables.xml?r1=1.86r2=1.87ty=u
Index: phpdoc/en/language/variables.xml
diff -u phpdoc/en/language/variables.xml:1.86
phpdoc/en/language/variables.xml:1.87
--- phpdoc/en/language/variables.xml:1.86 Sun Feb 13 17:02:36 2005
+++ phpdoc/en/language/variables.xmlSun Feb 13 17:05:29 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.86 $ --
+!-- $Revision: 1.87 $ --
chapter id=language.variables
titleVariables/title
@@ -493,7 +493,7 @@
programlisting role=php
![CDATA[
?php
-function Test ()
+function Test()
{
$a = 0;
echo $a;
@@ -557,7 +557,7 @@
$count++;
echo $count;
if ($count 10) {
-Test ();
+Test();
}
$count--;
}
[PHP-DOC] cvs: phpdoc /en/language functions.xml
vrana Sun Feb 13 17:13:07 2005 EDT Modified files: /phpdoc/en/language functions.xml Log: There's no func(const $param) - at least in PHP 5 http://cvs.php.net/diff.php/phpdoc/en/language/functions.xml?r1=1.56r2=1.57ty=u Index: phpdoc/en/language/functions.xml diff -u phpdoc/en/language/functions.xml:1.56 phpdoc/en/language/functions.xml:1.57 --- phpdoc/en/language/functions.xml:1.56 Sun Dec 19 21:27:49 2004 +++ phpdoc/en/language/functions.xmlSun Feb 13 17:13:07 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.56 $ -- +!-- $Revision: 1.57 $ -- chapter id=language.functions titleFunctions/title @@ -26,14 +26,6 @@ /example /para - !-- - -status of func(const $param) ? -zend doesn't care at all whether or not you specify it. -I've never seen it before... what's its use? (or was...) - --- - simpara Any valid PHP code may appear inside a function, even other functions and link linkend=keyword.classclass/link
Re: [PHP-DOC] cvs: phpdoc /en/security database.xml
vrana Sun Feb 13 16:50:05 2005 EDT Modified files: /phpdoc/en/security database.xml Log: First SQL injection example is FUD (reported by Dr. Werner Popken) AFAIK MySQL doesn't allow multiple querys (except with mysqli_multi_query()), so the example was wrong. But other DBs allow it. I don't know if it is the case of PostgreSQL (the second example), but at least the example could be adapted to work. What do you think? Nuno
[PHP-DOC] cvs: phpdoc /en/language functions.xml
vrana Sun Feb 13 17:32:44 2005 EDT
Modified files:
/phpdoc/en/language functions.xml
Log:
Recursive functions (spotted by ondra at dynawest.cz)
http://cvs.php.net/diff.php/phpdoc/en/language/functions.xml?r1=1.57r2=1.58ty=u
Index: phpdoc/en/language/functions.xml
diff -u phpdoc/en/language/functions.xml:1.57
phpdoc/en/language/functions.xml:1.58
--- phpdoc/en/language/functions.xml:1.57 Sun Feb 13 17:13:07 2005
+++ phpdoc/en/language/functions.xmlSun Feb 13 17:32:44 2005
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.57 $ --
+!-- $Revision: 1.58 $ --
chapter id=language.functions
titleFunctions/title
@@ -130,6 +130,28 @@
functionfunc_get_arg/function, and
functionfunc_get_args/function for more information.
/simpara
+
+ para
+It is possible to call recursive functions in PHP. However avoid recursive
+function/method calls with over 100-200 recursion levels as it can smash
+the stack and cause a termination of the current script.
+example
+ titleRecursive functions/title
+ programlisting role=php
+![CDATA[
+?php
+function recursion($a)
+{
+if ($a 20) {
+echo $a\n;
+recursion($a + 1);
+}
+}
+?
+]]
+ /programlisting
+/example
+ /para
/sect1
Re: [PHP-DOC] chapter 15. security / urban legends
Dr. Werner Popken wrote: http://de2.php.net/manual/en/security.database.sql-injection.php Example 27-2. Splitting the result set into pages ... and making superusers (PostgreSQL and MySQL) AFAIK, this has never worked. I removed that example from XML sources of PHP documentation. Please wait until next manual rebuild to see this change on the web and wait further until German documentation team finds time to remove it from the German docs. Jakub Vrana
Re: [PHP-DOC] cvs: phpdoc /en/security database.xml
Nuno Lopes wrote: AFAIK MySQL doesn't allow multiple querys (except with mysqli_multi_query()), so the example was wrong. But other DBs allow it. I don't know if it is the case of PostgreSQL (the second example), but at least the example could be adapted to work. What do you think? I agree but I didn't find any meaningful example. I thought about stupid mysql_query($_GET[query]) but it's not about the SQL injection. Maybe with subqueries something can be done but they are not in MySQL 4.1. Multiple SQL commands will not work with mysql_query, pg_query and sqlite_query (if returned value is used) AFAIK. Jakub Vrana
[PHP-DOC] #31792 [Bgs-Opn]: getrusage() does not give ru_nswap
ID: 31792 User updated by: bertrand at toggg dot com Reported By: bertrand at toggg dot com -Status: Bogus +Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: Thanks vrana ! You're right, it's ru_nswap resource usage number of swap. (as stated in title). So, back from bogus. Do you have some answer about why it's not reported ? à+ Previous Comments: [2005-02-13 21:43:20] [EMAIL PROTECTED] It's not ru_nwsap but ru_nswap (typo). [2005-02-12 15:42:42] bertrand at toggg dot com Let say it's a documentation problem. But I still consider this resource usage as an interessant indicator, if it's existing, sure. Thanks. [2005-02-01 12:37:25] bertrand at toggg dot com Description: Although this resource usage is documented in PHP manual getrusage(), ru_nwsap (number of swap) is not reported. checking ext/standard/microtime.c, it's obviously not copied in the returned array. Does exist a technical reason for that ? Thanks bertrand -- Edit this bug report at http://bugs.php.net/?id=31792edit=1
[PHP-DOC] cvs: phpdoc /en/reference/mail/functions mail.xml
aidan Sun Feb 13 21:45:49 2005 EDT Modified files: /phpdoc/en/reference/mail/functions mail.xml Log: Complete rewrite and update to the new format. I've intergrated all the user notes (except 2, which were better left as notes). Please review thoroughly, as this is one of the manual pages many people have problems with, and I'd like it to be as clear as possible. http://cvs.php.net/diff.php/phpdoc/en/reference/mail/functions/mail.xml?r1=1.29r2=1.30ty=u Index: phpdoc/en/reference/mail/functions/mail.xml diff -u phpdoc/en/reference/mail/functions/mail.xml:1.29 phpdoc/en/reference/mail/functions/mail.xml:1.30 --- phpdoc/en/reference/mail/functions/mail.xml:1.29Sat Nov 27 04:35:05 2004 +++ phpdoc/en/reference/mail/functions/mail.xml Sun Feb 13 21:45:46 2005 @@ -1,209 +1,388 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.29 $ -- -!-- splitted from ./en/functions/mail.xml, last change in rev 1.2 -- - refentry id=function.mail - refnamediv -refnamemail/refname -refpurposeSend mail/refpurpose - /refnamediv - refsect1 -titleDescription/title - methodsynopsis - typebool/typemethodnamemail/methodname - methodparamtypestring/typeparameterto/parameter/methodparam - methodparamtypestring/typeparametersubject/parameter/methodparam - methodparamtypestring/typeparametermessage/parameter/methodparam - methodparam choice=opttypestring/typeparameteradditional_headers/parameter/methodparam - methodparam choice=opttypestring/typeparameteradditional_parameters/parameter/methodparam - /methodsynopsis -simpara - functionmail/function automatically mails the message - specified in parametermessage/parameter to the receiver - specified in parameterto/parameter. Multiple recipients can - be specified by putting a comma between each address in - parameterto/parameter. Email with attachments and special - types of content can be sent using this function. This is - accomplished via MIME-encoding - for more information, see this - ulink url=url.email.mime.zend; - Zend article/ulink or the ulink url=url.pear.package;Mail_Mime - PEAR Mime Classes/ulink. - /simpara - simpara - The following RFC's may also be useful: - ulink url=url.rfc;1896RFC 1896/ulink, - ulink url=url.rfc;2045RFC 2045/ulink, - ulink url=url.rfc;2046RFC 2046/ulink, - ulink url=url.rfc;2047RFC 2047/ulink, - ulink url=url.rfc;2048RFC 2048/ulink, and - ulink url=url.rfc;2049RFC 2049/ulink. -/simpara +!-- $Revision: 1.30 $ -- +refentry id=function.mail + refnamediv + refnamemail/refname + refpurposeSend mail/refpurpose + /refnamediv + + refsect1 role=description + reftitle.description; + methodsynopsis + typebool/typemethodnamemail/methodname + methodparamtypestring/typeparameterto/parameter/methodparam + methodparamtypestring/typeparametersubject/parameter/methodparam + methodparamtypestring/typeparametermessage/parameter/methodparam + methodparam choice=opttypestring/typeparameteradditional_headers/parameter/methodparam + methodparam choice=opttypestring/typeparameteradditional_parameters/parameter/methodparam + /methodsynopsis + para + Sends an email. + /para + /refsect1 + + refsect1 role=parameters + reftitle.parameters; + para + variablelist +varlistentry + termparameterto/parameter/term + listitem + para + Receiver, or receivers of the mail. + /para + para + The formatting of this string must comply with + ulink url=url.rfc;2822RFC 2822/ulink. Some examples are: + simplelist +member[EMAIL PROTECTED]/member +member[EMAIL PROTECTED], [EMAIL PROTECTED]/member +memberUser lt;[EMAIL PROTECTED]gt;/member +memberUser lt;[EMAIL PROTECTED]gt;, Another User lt;[EMAIL PROTECTED]gt;/member + /simplelist + /para + /listitem +/varlistentry +varlistentry + termparametersubject/parameter/term + listitem + para + Subject of the email to be sent. + /para + caution + para +This must not contain any newline characters, or the mail may not be +sent properly. + /para + /caution + /listitem +/varlistentry +varlistentry + termparametermessage/parameter/term + listitem + para + Message to be sent. + /para + para + Each line should be separated with a LF (\n). Lines should not be larger + than 70 characters. + /para + caution + para +(Windows only) When PHP is talking to a SMTP server directly, if a full +stop is found on the start of a line, it is removed. To counter-act this, +replace these occurences with a double dot. +programlisting role=php +![CDATA[ +?php +$text = str_replace(\n., \n.., $text); +? +]] +/programlisting + /para + /caution + /listitem +
[PHP-DOC] cvs: phpdoc /en/reference/mail/functions mail.xml
aidan Sun Feb 13 22:37:35 2005 EDT Modified files: /phpdoc/en/reference/mail/functions mail.xml Log: Fix minor spelling/punctuation mistakes. http://cvs.php.net/diff.php/phpdoc/en/reference/mail/functions/mail.xml?r1=1.30r2=1.31ty=u Index: phpdoc/en/reference/mail/functions/mail.xml diff -u phpdoc/en/reference/mail/functions/mail.xml:1.30 phpdoc/en/reference/mail/functions/mail.xml:1.31 --- phpdoc/en/reference/mail/functions/mail.xml:1.30Sun Feb 13 21:45:46 2005 +++ phpdoc/en/reference/mail/functions/mail.xml Sun Feb 13 22:37:34 2005 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.30 $ -- +!-- $Revision: 1.31 $ -- refentry id=function.mail refnamediv refnamemail/refname @@ -71,7 +71,7 @@ para (Windows only) When PHP is talking to a SMTP server directly, if a full stop is found on the start of a line, it is removed. To counter-act this, -replace these occurences with a double dot. +replace these occurrences with a double dot. programlisting role=php 