[PHP-DOC] cvs: phpdoc /scripts xml_proto.php
vrana Wed Sep 7 02:59:46 2005 EDT Modified files: /phpdoc/scripts xml_proto.php Log: Run extensions.xml.php http://cvs.php.net/diff.php/phpdoc/scripts/xml_proto.php?r1=1.33&r2=1.34&ty=u Index: phpdoc/scripts/xml_proto.php diff -u phpdoc/scripts/xml_proto.php:1.33 phpdoc/scripts/xml_proto.php:1.34 --- phpdoc/scripts/xml_proto.php:1.33 Sun Aug 14 11:12:17 2005 +++ phpdoc/scripts/xml_proto.phpWed Sep 7 02:59:45 2005 @@ -16,7 +16,7 @@ | Authors: Brad House <[EMAIL PROTECTED]> | +--+ - $Id: xml_proto.php,v 1.33 2005/08/14 15:12:17 sean Exp $ + $Id: xml_proto.php,v 1.34 2005/09/07 06:59:45 vrana Exp $ */ /* @@ -159,7 +159,7 @@ } fwrite($fp, ''."\n" . - ''."\n" . + ''."\n" . "\n" . "\n" . " $extension_name Functions\n" . @@ -244,7 +244,7 @@ $functype = trim($funclist[$i]["function_type"]); fwrite($fp, ''."\n" . - ''."\n" . + ''."\n" . "\n" . "\n" . " \n" . @@ -929,7 +929,8 @@ d) If you're writing over files in CVS, be 100% sure to check unified diffs before commit! e) Run script check-references.php and add role="reference" where required. - f) Categorize the extension in appendices/extensions.xml. + f) Fill-in the Purpose and Membership comments in reference.xml and run + extensions.xml.php. Report problems to [email protected]
Re: [PHP-DOC] cvs: phpdoc /scripts xml_proto.php
> /* > @@ -159,7 +159,7 @@ >} > >fwrite($fp, ''."\n" . > - ''."\n" . > + ''."\n" . > "\n" . > "\n" . > " $extension_name Functions\n" . > @@ -244,7 +244,7 @@ > $functype = trim($funclist[$i]["function_type"]); > > fwrite($fp, ''."\n" . > - ''."\n" . > + ''."\n" . > "\n" . > "\n" . > " \n" . > @@ -929,7 +929,8 @@ >d) If you're writing over files in CVS, be 100% sure to check unified > diffs before commit! >e) Run script check-references.php and add role="reference" where > required. > - f) Categorize the extension in appendices/extensions.xml. > + f) Fill-in the Purpose and Membership comments in reference.xml and run > + extensions.xml.php. The intention was to genearte sample comments for Purpose and Membership, right? Goba
[PHP-DOC] cvs: phpdoc /scripts xml_proto.php
vrana Wed Sep 7 04:20:44 2005 EDT Modified files: /phpdoc/scripts xml_proto.php Log: Purpose and Membership tags (thanks to Goba) http://cvs.php.net/diff.php/phpdoc/scripts/xml_proto.php?r1=1.34&r2=1.35&ty=u Index: phpdoc/scripts/xml_proto.php diff -u phpdoc/scripts/xml_proto.php:1.34 phpdoc/scripts/xml_proto.php:1.35 --- phpdoc/scripts/xml_proto.php:1.34 Wed Sep 7 02:59:45 2005 +++ phpdoc/scripts/xml_proto.phpWed Sep 7 04:20:42 2005 @@ -16,7 +16,7 @@ | Authors: Brad House <[EMAIL PROTECTED]> | +--+ - $Id: xml_proto.php,v 1.34 2005/09/07 06:59:45 vrana Exp $ + $Id: xml_proto.php,v 1.35 2005/09/07 08:20:42 vrana Exp $ */ /* @@ -159,7 +159,9 @@ } fwrite($fp, ''."\n" . - ''."\n" . + ''."\n" . + "\n" . + "\n" . "\n" . "\n" . " $extension_name Functions\n" . @@ -244,7 +246,7 @@ $functype = trim($funclist[$i]["function_type"]); fwrite($fp, ''."\n" . - ''."\n" . + ''."\n" . "\n" . "\n" . " \n" .
Re: [PHP-DOC] cvs: phpdoc /scripts xml_proto.php
Gabor Hojtsy wrote: > The intention was to genearte sample comments for Purpose and > Membership, right? Right. It was there but when I was merging changes I forgot to include it. Thanks. Jakub Vrana
[PHP-DOC] cvs: phpdoc /en/reference/oci8/functions OCI-Lob-eof.xml oci-fetch-array.xml ocicancel.xml ocicloselob.xml ocicollappend.xml ocicollassign.xml ocicollassignelem.xml ocicollgetelem.xml ocicol
betzWed Sep 7 05:35:23 2005 EDT Modified files: /phpdoc/en/reference/oci8/functions ocicancel.xml ocicloselob.xml ocicollappend.xml ocicollassignelem.xml ocicollassign.xml ocicollgetelem.xml ocicollmax.xml ocicollsize.xml ocicolltrim.xml ocicolumnisnull.xml ocicolumnname.xml ocicolumnprecision.xml ocicolumnscale.xml ocicolumnsize.xml ocicolumntyperaw.xml ocicolumntype.xml ocicommit.xml ocidefinebyname.xml ocierror.xml ociexecute.xml oci-fetch-array.xml ocifetchstatement.xml ocifetch.xml ocifreecollection.xml ocifreecursor.xml ocifreedesc.xml ocifreestatement.xml ociinternaldebug.xml ociloadlob.xml OCI-Lob-eof.xml ocilogoff.xml ocilogon.xml ocinewcollection.xml ocinewcursor.xml ocinewdescriptor.xml ocinlogon.xml ocinumcols.xml ociparse.xml ociplogon.xml ociresult.xml ocirollback.xml ocirowcount.xml ocisavelobfile.xml ocisavelob.xml ociserverversion.xml ocisetprefetch.xml ocistatementtype.xml ociwritelobtofile.xml ociwritetemporarylob.xml Log: fix build, XML declaration starts at first row http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicancel.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicancel.xml diff -u phpdoc/en/reference/oci8/functions/ocicancel.xml:1.10 phpdoc/en/reference/oci8/functions/ocicancel.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicancel.xml:1.10 Tue Sep 6 16:18:29 2005 +++ phpdoc/en/reference/oci8/functions/ocicancel.xmlWed Sep 7 05:35:20 2005 @@ -1,6 +1,5 @@ - - + ocicancel http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicloselob.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/oci8/functions/ocicloselob.xml diff -u phpdoc/en/reference/oci8/functions/ocicloselob.xml:1.5 phpdoc/en/reference/oci8/functions/ocicloselob.xml:1.6 --- phpdoc/en/reference/oci8/functions/ocicloselob.xml:1.5 Tue Sep 6 16:18:29 2005 +++ phpdoc/en/reference/oci8/functions/ocicloselob.xml Wed Sep 7 05:35:21 2005 @@ -1,6 +1,5 @@ - - + ocicloselob http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollappend.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollappend.xml diff -u phpdoc/en/reference/oci8/functions/ocicollappend.xml:1.10 phpdoc/en/reference/oci8/functions/ocicollappend.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicollappend.xml:1.10 Tue Sep 6 16:18:29 2005 +++ phpdoc/en/reference/oci8/functions/ocicollappend.xmlWed Sep 7 05:35:21 2005 @@ -1,6 +1,5 @@ - - + ocicollappend http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollassignelem.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollassignelem.xml diff -u phpdoc/en/reference/oci8/functions/ocicollassignelem.xml:1.10 phpdoc/en/reference/oci8/functions/ocicollassignelem.xml:1.11 --- phpdoc/en/reference/oci8/functions/ocicollassignelem.xml:1.10 Tue Sep 6 16:18:29 2005 +++ phpdoc/en/reference/oci8/functions/ocicollassignelem.xmlWed Sep 7 05:35:21 2005 @@ -1,6 +1,5 @@ - - + ocicollassignelem http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/functions/ocicollassign.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc/en/reference/oci8/functions/ocicollassign.xml diff -u phpdoc/en/reference/oci8/functions/ocicollassign.xml:1.11 phpdoc/en/reference/oci8/functions/ocicollassign.xml:1.12 --- phpdoc/en/reference/oci8/functions/oc
[PHP-DOC] cvs: phpdoc /entities global.ent
betzWed Sep 7 05:36:32 2005 EDT Modified files: /phpdoc/entitiesglobal.ent Log: entities for satellite and session-pgsl http://cvs.php.net/diff.php/phpdoc/entities/global.ent?r1=1.240&r2=1.241&ty=u Index: phpdoc/entities/global.ent diff -u phpdoc/entities/global.ent:1.240 phpdoc/entities/global.ent:1.241 --- phpdoc/entities/global.ent:1.240Tue Sep 6 16:39:43 2005 +++ phpdoc/entities/global.ent Wed Sep 7 05:36:32 2005 @@ -1,6 +1,6 @@
[PHP-DOC] #34406 [NEW]: Example gives wrong impression of "include" behaviour
From: info at bastian-frank dot de
Operating system: All
PHP version: Irrelevant
PHP Bug Type: Documentation problem
Bug description: Example gives wrong impression of "include" behaviour
Description:
In the documentation for "include" the example "include() through HTTP"
gives the wrong impression that including an file with URL wrappers is a
legal alternative to a normal include with local files.
This is wrong because an include with URL wrappers parses the file twice:
By the server when executing the "included" HTTP-request and once again
AFTER including it in the current script.
This is not stated clearly and is confusing for people learning PHP.
The user contributed notes show that there IS confusion and even very
insecure tips ("change the file ending") are given in the notes.
--
Edit bug report at http://bugs.php.net/?id=34406&edit=1
--
Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=34406&r=trysnapshot4
Try a CVS snapshot (php5.0):
http://bugs.php.net/fix.php?id=34406&r=trysnapshot50
Try a CVS snapshot (php5.1):
http://bugs.php.net/fix.php?id=34406&r=trysnapshot51
Fixed in CVS:http://bugs.php.net/fix.php?id=34406&r=fixedcvs
Fixed in release:http://bugs.php.net/fix.php?id=34406&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=34406&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=34406&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=34406&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=34406&r=support
Expected behavior: http://bugs.php.net/fix.php?id=34406&r=notwrong
Not enough info:
http://bugs.php.net/fix.php?id=34406&r=notenoughinfo
Submitted twice:
http://bugs.php.net/fix.php?id=34406&r=submittedtwice
register_globals:http://bugs.php.net/fix.php?id=34406&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=34406&r=php3
Daylight Savings:http://bugs.php.net/fix.php?id=34406&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=34406&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=34406&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=34406&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=34406&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=34406&r=mysqlcfg
[PHP-DOC] cvs: phpdoc /en/language control-structures.xml
vrana Wed Sep 7 07:31:49 2005 EDT Modified files: /phpdoc/en/language control-structures.xml Log: Warning about including remote files (bug #34406) http://cvs.php.net/diff.php/phpdoc/en/language/control-structures.xml?r1=1.124&r2=1.125&ty=u Index: phpdoc/en/language/control-structures.xml diff -u phpdoc/en/language/control-structures.xml:1.124 phpdoc/en/language/control-structures.xml:1.125 --- phpdoc/en/language/control-structures.xml:1.124 Tue Aug 9 14:34:43 2005 +++ phpdoc/en/language/control-structures.xml Wed Sep 7 07:31:45 2005 @@ -1,5 +1,5 @@ - + Control Structures @@ -1434,6 +1434,20 @@ ]]> + + +Security warning + + Remote file may be processed at the remote server (depending on the file + extension and the fact if the remote server runs PHP or not) but it still + has to produce a valid PHP script because it will be processed at the + local server. If the file from the remote server should be processed + there and outputted only, readfile is much better + function to use. Otherwise, special care should be taken to secure the + remote script to produce a valid and desired code. + + + See also Remote files, fopen and file for related information.
[PHP-DOC] #34406 [Opn->Csd]: Example gives wrong impression of "include" behaviour
ID: 34406
Updated by: [EMAIL PROTECTED]
Reported By: info at bastian-frank dot de
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: All
PHP Version: Irrelevant
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.
"Security warning: Remote file may be processed at the remote server
(depending on the file extension and the fact if the remote server runs
PHP or not) but it still has to produce a valid PHP script because it
will be processed at the local server. If the file from the remote
server should be processed there and outputted only, readfile() is much
better function to use. Otherwise, special care should be taken to
secure the remote script to produce a valid and desired code."
+ some notes deleted (will be visible on the mirrors after some time)
Previous Comments:
[2005-09-07 12:54:47] info at bastian-frank dot de
Description:
In the documentation for "include" the example "include() through HTTP"
gives the wrong impression that including an file with URL wrappers is a
legal alternative to a normal include with local files.
This is wrong because an include with URL wrappers parses the file
twice: By the server when executing the "included" HTTP-request and
once again AFTER including it in the current script.
This is not stated clearly and is confusing for people learning PHP.
The user contributed notes show that there IS confusion and even very
insecure tips ("change the file ending") are given in the notes.
--
Edit this bug report at http://bugs.php.net/?id=34406&edit=1
Re: [PHP-DOC] Manual Credits/Contributors
Nuno Lopes wrote: > Probably I'm also forgeting someone, but without some stats its difficult. Some stats are here: http://www.vrana.cz/scite/phpdoc-en-log.html It doesn't tell lot but can reveal some names. Jakub Vrana
Re[2]: [PHP-DOC] Manual Credits/Contributors
||*()*|| Hi, Sean. >> AFAIR we decided to not use hard numbers (so people will not do useless >> commits just to reach a limit, as it was done before), but put up names >> instead, and then wait some pre-specified time if someone votes against >> their inclusion. Since we are mostly only looking one year back, it is >> easier to discuss names. SC> Good. I think that's fair. SC> Now, at risk of patting myself on the back, I'd like to be included in SC> the Authors and Editors block, as well as a Notes Maintainer. SC> Obviously, if someone has a problem with this, we can discuss it. I'm SC> open-minded, and I actually really hate ringing my own bell. Not a problem, but we can discuss it anyway. =) It would be nice to see your name on the wall. As for other developers I'm pretty out of sync, but if you mentioned them I think they worth something. t --
[PHP-DOC] No and part in oci8/reference.xml?
Shouldn't there be and part in oci8/reference.xml? ""Antony Dovgal"" <[EMAIL PROTECTED]> 写入消息新闻:[EMAIL PROTECTED] tony2001 Tue Sep 6 16:18:32 2005 EDT Added files: /phpdoc/en/reference/oci8 ini.xml Modified files: /phpdoc/en/reference/oci8 configure.xml constants.xml reference.xml /phpdoc/en/reference/oci8/functions OCI-Collection-append.xml OCI-Collection-assign.xml OCI-Collection-assignElem.xml OCI-Collection-free.xml OCI-Collection-getElem.xml OCI-Collection-max.xml OCI-Collection-size.xml OCI-Collection-trim.xml OCI-Lob-append.xml OCI-Lob-close.xml OCI-Lob-eof.xml OCI-Lob-erase.xml OCI-Lob-export.xml OCI-Lob-flush.xml OCI-Lob-free.xml OCI-Lob-getBuffering.xml OCI-Lob-import.xml OCI-Lob-load.xml OCI-Lob-read.xml OCI-Lob-rewind.xml OCI-Lob-save.xml OCI-Lob-seek.xml OCI-Lob-setBuffering.xml OCI-Lob-size.xml OCI-Lob-tell.xml OCI-Lob-truncate.xml OCI-Lob-write.xml OCI-Lob-writeTemporary.xml oci-bind-by-name.xml oci-cancel.xml oci-close.xml oci-commit.xml oci-connect.xml oci-define-by-name.xml oci-error.xml oci-execute.xml oci-fetch-all.xml oci-fetch-array.xml oci-fetch-assoc.xml oci-fetch-object.xml oci-fetch-row.xml oci-field-name.xml oci-field-precision.xml oci-field-scale.xml oci-field-size.xml oci-field-type-raw.xml oci-field-type.xml oci-internal-debug.xml oci-lob-copy.xml oci-new-collection.xml oci-new-connect.xml oci-new-cursor.xml oci-new-descriptor.xml oci-num-rows.xml oci-parse.xml oci-password-change.xml oci-pconnect.xml oci-rollback.xml oci-server-version.xml oci-set-prefetch.xml oci-statement-type.xml ocibindbyname.xml ocicancel.xml ocicloselob.xml ocicollappend.xml ocicollassign.xml ocicollassignelem.xml ocicollgetelem.xml ocicollmax.xml ocicollsize.xml ocicolltrim.xml ocicolumnisnull.xml ocicolumnname.xml ocicolumnprecision.xml ocicolumnscale.xml ocicolumnsize.xml ocicolumntype.xml ocicolumntyperaw.xml ocicommit.xml ocidefinebyname.xml ocierror.xml ociexecute.xml ocifetch.xml ocifetchinto.xml ocifetchstatement.xml ocifreecollection.xml ocifreecursor.xml
[PHP-DOC] cvs: phpdoc /en contributors.xml
seanWed Sep 7 10:19:32 2005 EDT Modified files: /phpdoc/en contributors.xml Log: added myself and dbs to authors/editors block http://cvs.php.net/diff.php/phpdoc/en/contributors.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc/en/contributors.xml diff -u phpdoc/en/contributors.xml:1.11 phpdoc/en/contributors.xml:1.12 --- phpdoc/en/contributors.xml:1.11 Tue Aug 3 08:39:20 2004 +++ phpdoc/en/contributors.xml Wed Sep 7 10:19:29 2005 @@ -1,5 +1,5 @@ - + Jesus M. Castagnetto, Ron Chmara, + Sean Coates, John Coggeshall, Simone Cortesi, Markus Fischer, @@ -40,6 +41,7 @@ Egon Schmid, Thomas Schoefbeck, Sascha Schumann, + Dan Scott, Lars Torben Wilson, Jim Winstead, Jeroen van Wolffelaar&listendand;
Re: [PHP-DOC] No and part in oci8/reference.xml?
On 07.09.2005 18:14, Dallas Thunder wrote: > Shouldn't there be and part in oci8/reference.xml? What should I write in if this extension exists in the distro, but its new version is available only in HEAD and PECL ? -- Wbr, Antony Dovgal
Re: [PHP-DOC] cvs: phpdoc /en contributors.xml
Sean Coates wrote: > sean Wed Sep 7 10:19:32 2005 EDT > > Modified files: > /phpdoc/encontributors.xml > Log: > added myself and dbs to authors/editors block Anyway.. I didn't touch the notes contributors block -- see http://doc.php.net/php/notes_stats.php I think this is one place where stats can really help -- what do we think? The whole "Recent Editors stats" table deserves credit, IMO -- notes editing is generally thankless, boring, and requires dealing with a lot of.. well.. let's say people who are "not the sharpest tools in the shed." S
Re: [PHP-DOC] No and part in oci8/reference.xml?
Sorry, I really don't know that. Just curious because every other extension has this part. And since appendices/extensions.xml was generated from these information, maybe there will be no oci8 part in next build if no such information? So I think at least put something. Anything at all. "Antony Dovgal" <[EMAIL PROTECTED]> 写入消息新闻:[EMAIL PROTECTED] On 07.09.2005 18:14, Dallas Thunder wrote: Shouldn't there be and part in oci8/reference.xml? What should I write in if this extension exists in the distro, but its new version is available only in HEAD and PECL ? -- Wbr, Antony Dovgal
[PHP-DOC] cvs: phpdoc /en/reference/oci8 reference.xml
tony2001Wed Sep 7 11:09:04 2005 EDT Modified files: /phpdoc/en/reference/oci8 reference.xml Log: add Purpose & Membership http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/reference.xml?r1=1.15&r2=1.16&ty=u Index: phpdoc/en/reference/oci8/reference.xml diff -u phpdoc/en/reference/oci8/reference.xml:1.15 phpdoc/en/reference/oci8/reference.xml:1.16 --- phpdoc/en/reference/oci8/reference.xml:1.15 Tue Sep 6 16:18:26 2005 +++ phpdoc/en/reference/oci8/reference.xml Wed Sep 7 11:09:00 2005 @@ -1,5 +1,8 @@ - + + + + Oracle functions OCI8
[PHP-DOC] cvs: phpdoc /en/reference/oci8 reference.xml
dallas Wed Sep 7 11:25:09 2005 EDT Modified files: /phpdoc/en/reference/oci8 reference.xml Log: Remove an extra "return". http://cvs.php.net/diff.php/phpdoc/en/reference/oci8/reference.xml?r1=1.16&r2=1.17&ty=u Index: phpdoc/en/reference/oci8/reference.xml diff -u phpdoc/en/reference/oci8/reference.xml:1.16 phpdoc/en/reference/oci8/reference.xml:1.17 --- phpdoc/en/reference/oci8/reference.xml:1.16 Wed Sep 7 11:09:00 2005 +++ phpdoc/en/reference/oci8/reference.xml Wed Sep 7 11:25:08 2005 @@ -1,5 +1,5 @@ - + @@ -18,12 +18,12 @@ define variables. - + &reftitle.required; You will need the Oracle client libraries to use this extension. -Windows users will need at least Oracle version 8.1 to use the +Windows users will need at least Oracle version 8.1 to use the php_oci8.dll dll. @@ -31,13 +31,13 @@ is to use Oracle Instant Client, which is available from here: &url.oracle.instant.client;. Instant Client does not need ORACLE_SID or ORACLE_HOME environment -variables set. You still may need to set LD_LIBRARY_PATH and NLS_LANG, though. +variables set. You still may need to set LD_LIBRARY_PATH and NLS_LANG, though. Before using this extension, make sure that you have set up your Oracle environment variables properly for the Oracle user, as well as your web daemon user. These variables should be set up -before you start your web-server. The +before you start your web-server. The variables you might need to set are as follows: @@ -79,13 +79,13 @@ If your webserver doesn't start or crashes at startup - Check that Apache is linked with the pthread library: + Check that Apache is linked with the pthread library: +]]> @@ -202,12 +202,12 @@ oci_close($conn); ?> -]]> +]]> - - + + Inserting data into a CLOB column @@ -269,7 +269,7 @@ '$postalcode', '$country', :error_code );end;"); // This calls stored procedure sp_newaddress, with :address_id being an -// in/out variable and :error_code being an out variable. +// in/out variable and :error_code being an out variable. // Then you do the binding: oci_bind_by_name($sth, ":address_id", $addr_id, 10); @@ -286,56 +286,56 @@ Connecting Handling - The oci8 extension provides you with 3 different functions for - connecting to Oracle. It is up to you to use the most appropriate - function for your application, and the information in this section is + The oci8 extension provides you with 3 different functions for + connecting to Oracle. It is up to you to use the most appropriate + function for your application, and the information in this section is intended to help you make an informed choice. - Connecting to an Oracle server is a reasonably expensive operation, in - terms of the time that it takes to complete. The oci_pconnect - function uses a persistent cache of connections that can be re-used - across different script requests. This means that you will typically + Connecting to an Oracle server is a reasonably expensive operation, in + terms of the time that it takes to complete. The oci_pconnect + function uses a persistent cache of connections that can be re-used + across different script requests. This means that you will typically only incur the connection overhead once per php process (or apache child). - If your application connects to Oracle using a different set of - credentials for each web user, the persistent cache employed by - oci_pconnect will become less useful as the - number of concurrent users increases, to the point where it may - start to adversely affect the overall performance of your Oracle - server due to maintaining too many idle connections. If your - application is structured in this way, it is recommended that + If your application connects to Oracle using a different set of + credentials for each web user, the persistent cache employed by + oci_pconnect will become less useful as the + number of concurrent users increases, to the point where it may + start to adversely affect the overall performance of your Oracle + server due to maintaining too many idle connections. If your + application is structured in this way, it is recommended that you either tune your application using the oci8.max_persistent and oci8.persistent_timeout - configuration settings (these will give you control over the + linkend="ini.oci8.persistent_timeout">oci8.persistent_timeout + configuration settings (these will give you control over the persistent connection cache size and lifetime) or use oci_connect instead.
Re: [PHP-DOC] cvs: phpdoc /en/reference/oci8 reference.xml
Heh, 10K commit to remove a "return"? Methinks there is some serious whitespace issue happening here :) Dan On 9/7/05, Dallas Thunder <[EMAIL PROTECTED]> wrote: > dallas Wed Sep 7 11:25:09 2005 EDT > > Modified files: > /phpdoc/en/reference/oci8 reference.xml > Log: > Remove an extra "return". > > >
[PHP-DOC] Re: phpdoc /en/reference/oci8 reference.xml
Actual change is: - given script, the second and subsequent calls return return the existing + given script, the second and subsequent calls return the existing Others are just trailing white spaces, auto removed from my editor. ""Dallas Thunder"" <[EMAIL PROTECTED]> 写入消息新闻:[EMAIL PROTECTED] dallas Wed Sep 7 11:25:09 2005 EDT Modified files: /phpdoc/en/reference/oci8 reference.xml Log: Remove an extra "return".
Re: [PHP-DOC] No and part in oci8/reference.xml?
>>Shouldn't there be and part in oci8/reference.xml? > > What should I write in if this extension exists in the distro, > but its new version is available only in HEAD and PECL ? Good question. The flags can only represent one particular state. If both the new and old versions are documented (they should be!), then a flag for the old version would be appropriate (as the HEAD version is not too widespread :). Goba
[PHP-DOC] #34411 [NEW]: The last few versions of the chm file have had header/footer problems
From: cap at wantabetterwebsite dot com Operating system: Windows XP PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: The last few versions of the chm file have had header/footer problems Description: I've been downloading the english chm version of the php manual for a while now, the last several versions (read, the last few months) it's had some problems in it, presumably something in the translation system. All of the header and footer navigation links have been replaced with ?, also on some pages these ? appear in description fields (common in several of the TOC pages) so that it's often difficult to figure out where I am or where I'm going from here as I navigate through the manual. This is not a big deal cause if I can run a search at least I can get the text of the manpages I'm trying to load, which generally is the most important part, but I thought you guys ought to know that the headers and footers are messed up. -- Edit bug report at http://bugs.php.net/?id=34411&edit=1 -- Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=34411&r=trysnapshot4 Try a CVS snapshot (php5.0): http://bugs.php.net/fix.php?id=34411&r=trysnapshot50 Try a CVS snapshot (php5.1): http://bugs.php.net/fix.php?id=34411&r=trysnapshot51 Fixed in CVS:http://bugs.php.net/fix.php?id=34411&r=fixedcvs Fixed in release:http://bugs.php.net/fix.php?id=34411&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=34411&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=34411&r=needscript Try newer version: http://bugs.php.net/fix.php?id=34411&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=34411&r=support Expected behavior: http://bugs.php.net/fix.php?id=34411&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=34411&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=34411&r=submittedtwice register_globals:http://bugs.php.net/fix.php?id=34411&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=34411&r=php3 Daylight Savings:http://bugs.php.net/fix.php?id=34411&r=dst IIS Stability: http://bugs.php.net/fix.php?id=34411&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=34411&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=34411&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=34411&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=34411&r=mysqlcfg
[PHP-DOC] #34411 [Opn->Bgs]: The last few versions of the chm file have had header/footer problems
ID: 34411 Updated by: [EMAIL PROTECTED] Reported By: cap at wantabetterwebsite dot com -Status: Open +Status: Bogus Bug Type: Documentation problem Operating System: Windows XP PHP Version: Irrelevant New Comment: Please do not submit the same bug more than once. An existing bug report already describes this very problem. Even if you feel that your issue is somewhat different, the resolution is likely to be the same. Thank you for your interest in PHP. dup of #33838. may be a locale's issue on build machine. Previous Comments: [2005-09-07 19:29:38] cap at wantabetterwebsite dot com Description: I've been downloading the english chm version of the php manual for a while now, the last several versions (read, the last few months) it's had some problems in it, presumably something in the translation system. All of the header and footer navigation links have been replaced with ?, also on some pages these ? appear in description fields (common in several of the TOC pages) so that it's often difficult to figure out where I am or where I'm going from here as I navigate through the manual. This is not a big deal cause if I can run a search at least I can get the text of the manpages I'm trying to load, which generally is the most important part, but I thought you guys ought to know that the headers and footers are messed up. -- Edit this bug report at http://bugs.php.net/?id=34411&edit=1
[PHP-DOC] cvs: phpdoc /howto howto.ent howto.xml scripts.xml working.xml
nlopess Wed Sep 7 15:13:12 2005 EDT Added files: /phpdoc/howto scripts.xml Modified files: /phpdoc/howto howto.ent howto.xml working.xml Log: add a new file to document our scripts. we have lots of them, all unodocumented till now. documeting the new purpose, membership and state tags http://cvs.php.net/diff.php/phpdoc/howto/howto.ent?r1=1.31&r2=1.32&ty=u Index: phpdoc/howto/howto.ent diff -u phpdoc/howto/howto.ent:1.31 phpdoc/howto/howto.ent:1.32 --- phpdoc/howto/howto.ent:1.31 Sun Aug 21 09:03:02 2005 +++ phpdoc/howto/howto.ent Wed Sep 7 15:13:10 2005 @@ -91,6 +91,9 @@ http://cvs.php.net/co.php/php-master-web/manage/user-notes.php";> http://master.php.net/manage/user-notes.php";> + +http://php.net/manual/en/extensions.php";> + http://www.fooassociates.com/rtfs/";> http://www.zend.com/phpfunc/";> http://cvs.php.net/diff.php/phpdoc/howto/howto.xml?r1=1.49&r2=1.50&ty=u Index: phpdoc/howto/howto.xml diff -u phpdoc/howto/howto.xml:1.49 phpdoc/howto/howto.xml:1.50 --- phpdoc/howto/howto.xml:1.49 Sun Apr 3 05:46:01 2005 +++ phpdoc/howto/howto.xml Wed Sep 7 15:13:10 2005 @@ -13,6 +13,7 @@ + http://cvs.php.net/diff.php/phpdoc/howto/working.xml?r1=1.59&r2=1.60&ty=u Index: phpdoc/howto/working.xml diff -u phpdoc/howto/working.xml:1.59 phpdoc/howto/working.xml:1.60 --- phpdoc/howto/working.xml:1.59 Sun Aug 21 09:03:03 2005 +++ phpdoc/howto/working.xmlWed Sep 7 15:13:10 2005 @@ -494,7 +494,7 @@ A function skeleton (func-name.xml) - +func_name @@ -653,7 +653,10 @@ A reference.xml skeleton - + + + +Extname &Functions; Extname @@ -720,7 +723,7 @@ A configure.xml skeleton - +&reftitle.install; @@ -761,7 +764,7 @@ A constants.xml skeleton - + &reftitle.constants; &extension.constants; @@ -811,7 +814,7 @@ A ini.xml skeleton - + &reftitle.runtime; &extension.runtime; @@ -824,6 +827,7 @@ &Name; &Default; &Changeable; +Changelog @@ -831,6 +835,7 @@theini_option itsvalue its PHP_INI_* value +leave this blank. it will be filled automatically @@ -1958,6 +1963,8 @@ + &howto.scripts; + Miscellaneous Notes http://cvs.php.net/co.php/phpdoc/howto/scripts.xml?r=1.1&p=1 Index: phpdoc/howto/scripts.xml +++ phpdoc/howto/scripts.xml Automatization with scripts The PHP manual is very big and the PHP sources change every day. To help the documentation writers's work, we have developed a couple of scripts during the last years. Below you will find a list of the scripts, as well a short explanation and usage tips for each one. extensions.xml.php The extensions.xml.php script creates the extension categorization appendix. It collects the data from the reference.xml files and updates the en/appendices/extensions.xml file. The tags supported for the reference/*/reference.xml files include: Tag Explanation The purpose of the extension, specified by an ID. There are several IDs available, which can be consulted in the en/entensions.ent file. They look like database.vendors or xml. If none of the available categories fits your extension, you can create a new one. To do so, you must add a new entity in the en/entensions.ent file, like: XML Manipulation'>. After this, you still need to edit en/appendices/extensions.xml and create a new section for your ID, by copying an already existent section. This isn't done automatically to allow you to choose the order of the sections.
[PHP-DOC] cvs: phpdoc /scripts aspell.php
vrana Wed Sep 7 17:20:20 2005 EDT
Modified files:
/phpdoc/scripts aspell.php
Log:
Typo
http://cvs.php.net/diff.php/phpdoc/scripts/aspell.php?r1=1.4&r2=1.5&ty=u
Index: phpdoc/scripts/aspell.php
diff -u phpdoc/scripts/aspell.php:1.4 phpdoc/scripts/aspell.php:1.5
--- phpdoc/scripts/aspell.php:1.4 Wed Dec 31 19:35:40 2003
+++ phpdoc/scripts/aspell.php Wed Sep 7 17:20:18 2005
@@ -56,7 +56,7 @@
//~ echo "$filename\n";
$file = file_get_contents($filename);
$file =
preg_replace_callback('~()~sU',
"callback_htmlentities", $file);
- $file = preg_replace_callback('~()~sU',
"callback_htmlentities", $file); // isn't in one function as is can match
!CDATA[[...-->
+ $file = preg_replace_callback('~()~sU',
"callback_htmlentities", $file); // isn't in one function as it can match
!CDATA[[...-->
if ($GLOBALS["MODE"] == "escape") {
$file = preg_replace_callback('~<(' .
$GLOBALS['GOOD_TAGS'] . ')( [^>]*)?>(.*)~sU', "callback_make_value",
$file);
} else { // "unescape"
[PHP-DOC] cvs: phpdoc /howto scripts.xml
vrana Wed Sep 7 17:25:37 2005 EDT Modified files: /phpdoc/howto scripts.xml Log: Document scripts published by me http://cvs.php.net/diff.php/phpdoc/howto/scripts.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/howto/scripts.xml diff -u phpdoc/howto/scripts.xml:1.1 phpdoc/howto/scripts.xml:1.2 --- phpdoc/howto/scripts.xml:1.1Wed Sep 7 15:13:10 2005 +++ phpdoc/howto/scripts.xmlWed Sep 7 17:25:36 2005 @@ -10,6 +10,59 @@ explanation and usage tips for each one. + + aspell.php + + This script can be used to escape or unescape manual files for use with + aspell. Escaping moves the contents of tags with + non-English texts (like, + or ) + to the attribute aspell so the Aspell will ignore them. + Unescaping is the opposite process. + + + File en.pws contains words not included in the Aspell + dictionary but valid in the PHP manual and can be used as the personal + dictionary. + + + + + check-references.php + + This script tries to parse the PHP sources and compares the facts about + function parameters (their count, types, optionality and the need of + passing them as reference) with the documentation. Only easy parsable + functions from Zend, extensions, PECL and SAPI sources are checked. + + + Used rules are not absolutely precise, they are rather heuristics. Thus not + everything printed automatically denotes errors and sources should be + always read by a human before modifying the documentation. If the sources + correspond to the documentation and this script still produces error, + function should be added to one of $difficult_* arrays + defined in the beginning of this script. + + + + + diff_en_rev.php + + One of the scripts helping translators. + + + It prints a diff between the current English version and the translated + version of a file. It uses the tag to determine the translated version. If the local + English file has different revision, cvs diff is + executed to obtain the list of changes. + + + It is possible to pass a directory name instead of file name. In this case, + list of modified files in the directory is printed. + + + extensions.xml.php @@ -96,6 +149,28 @@ + + html_syntax.php + + This script is used in the build process to syntax highlight PHP examples + both for the online and downloadable manuals. + + + + + xml-check.php + + Build process of the whole manual can be very slow. This script takes one + XML file, creates xml-check.xml in the documentation + root with the beginning and ending DocBook tags and parses this file with + xmllint. Beginning tags are taken from + manual.xml.in. + + + Detected errors are printed thus empty output means correct file. + + +
