[PHP-DOC] cvs: phpdoc /en/reference/sca reference.xml
mfp Fri Aug 24 16:47:10 2007 UTC Modified files: /phpdoc/en/reference/scareference.xml Log: two occurences of the word "real" changed to the proper scalar type "float" http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/reference.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/sca/reference.xml diff -u phpdoc/en/reference/sca/reference.xml:1.5 phpdoc/en/reference/sca/reference.xml:1.6 --- phpdoc/en/reference/sca/reference.xml:1.5 Fri Aug 24 13:52:17 2007 +++ phpdoc/en/reference/sca/reference.xml Fri Aug 24 16:47:10 2007 @@ -1,5 +1,5 @@ - + @@ -504,7 +504,7 @@ $ticker and $currency are clearly PHP scalar types. - Components can pass the PHP scalar types string, integer, real and + Components can pass the PHP scalar types string, integer, float and boolean, but data structures on service calls are always passed as Service Data Objects (SDOs). A later section describes how a component can create an SDO to pass on a local or Web service call, or @@ -986,7 +986,7 @@ Working with Data Structures SCA components can pass and return the four PHP scalar types - boolean, integer, real and string, but to pass or return data + boolean, integer, float and string, but to pass or return data structures, SCA components use Service Data Objects (SDOs). SDOs are described in much more detail in the SDO pages of this manual.
[PHP-DOC] cvs: phpdoc /en/reference/sca reference.xml
mfp Fri Aug 24 13:52:17 2007 UTC Modified files: /phpdoc/en/reference/scareference.xml Log: change "real" to "float". Fix for PECL bug #42385 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/reference.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/sca/reference.xml diff -u phpdoc/en/reference/sca/reference.xml:1.4 phpdoc/en/reference/sca/reference.xml:1.5 --- phpdoc/en/reference/sca/reference.xml:1.4 Wed Jun 20 22:25:19 2007 +++ phpdoc/en/reference/sca/reference.xml Fri Aug 24 13:52:17 2007 @@ -1,5 +1,5 @@ - + @@ -504,7 +504,7 @@ $ticker and $currency are clearly PHP scalar types. - Components can pass the PHP scalar types string, integer, float and + Components can pass the PHP scalar types string, integer, real and boolean, but data structures on service calls are always passed as Service Data Objects (SDOs). A later section describes how a component can create an SDO to pass on a local or Web service call, or
[PHP-DOC] cvs: phpdoc /en/reference/sdo reference.xml
mfp Wed May 23 15:42:48 2007 UTC Modified files: /phpdoc/en/reference/sdoreference.xml Log: update the install instructions which should have changed when we reorganised the pecl package to include SCA. http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo/reference.xml?r1=1.26&r2=1.27&diff_format=u Index: phpdoc/en/reference/sdo/reference.xml diff -u phpdoc/en/reference/sdo/reference.xml:1.26 phpdoc/en/reference/sdo/reference.xml:1.27 --- phpdoc/en/reference/sdo/reference.xml:1.26 Thu Feb 15 08:12:19 2007 +++ phpdoc/en/reference/sdo/reference.xml Wed May 23 15:42:48 2007 @@ -1,5 +1,5 @@ - + @@ -102,24 +102,26 @@ Unix systems - You can download and install the latest stable release of all - three SDO components - the SDO core, the XML DAS and the - Relational DAS - with the command: + The three SDO components - the SDO core, the XML DAS and the + Relational DAS - are packaged together with Service Component + Architecture (SCA) into one PECL project, SCA_SDO, so you can + download SCA and all three parts of SDO with the command: This command will build the SDO shared library as well as - installing the PHP files that make the Relational DAS. + installing the PHP files that make up SCA and the SDO + Relational DAS. If you want to use the latest beta version, then instead run:
Re: [PHP-DOC] cannot find input file: ./dsssl/common.dsl.in
Thanks Nuno! I'll remember that. Matthew Peters "Nuno Lopes" <[EMAIL PROTECTED]> 26/04/2007 20:25 To Matthew Peters/UK/[EMAIL PROTECTED] cc "PHPdoc" Subject Re: [PHP-DOC] cannot find input file: ./dsssl/common.dsl.in I see you have already fixed the problem, but for the record you just needed to delete the 'infiles.cache' file, so that it could be regenerated (this should be very rare). Nuno - Original Message - >I am getting the subject message when I run ./configure. It immediately >follows the line "creating ./dsssl/common.dsl", but in fact when I look in >./dsssl it has not created common.dsl either. > > Can anyone tell me what the problem might be? > > TIA > Matthew Peters Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
Re: [PHP-DOC] cannot find input file: ./dsssl/common.dsl.in
OK, I removed everything and checked out a fresh copy of phpdoc and it works now. Something was not getting cleaned out properly when I just did a replace. Sorry to have troubled anyone. Matthew ""Matthew Peters"" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > Hi Richard, thanks for replying so quickly. Here is the output: > > [EMAIL PROTECTED] phpdoc]$ autoconf > [EMAIL PROTECTED] phpdoc]$ ./configure > file versions > configure.in,v 1.242 > Makefile.in,v 1.192 > configure options: > source directory: . > working directory: /home/matthew/workspace/phpdoc > > checking for php... /usr/local/bin/php > checking php version... 5.1.1 cli > checking for php.ini path... ./scripts > checking for openjade... /usr/bin/openjade > checking for onsgmls... /usr/bin/onsgmls > checking for xsltproc... /usr/bin/xsltproc > checking for xmllint... /usr/bin/xmllint > checking for docbook.dsl... ./docbook/docbook-dsssl (default) > checking for PHP source path... no > checking for PEAR source path... no > checking for PECL source path... no > checking for additional PHP extensions... no > checking for CSS to use for html docs... none > checking for chmonly inclusion... disabled (default) > checking for internals docs exclusion... no (default) > checking for language... en (default) > checking for treesaving... saving trees: #f > checking for *.in files... (cached) done! > configure: creating ./config.status > config.status: creating ./Makefile > config.status: creating ./manual.xml > config.status: creating ./RFC/manual.xml > config.status: creating ./dsssl/common.dsl > config.status: error: cannot find input file: ./dsssl/common.dsl.in > [EMAIL PROTECTED] phpdoc]$ > > ""Richard A. Quadling"" <[EMAIL PROTECTED]> wrote in message > news:[EMAIL PROTECTED] > >> -Original Message- >> From: Matthew Peters [mailto:[EMAIL PROTECTED] >> Sent: 26 April 2007 15:57 >> To: phpdoc@lists.php.net >> Subject: [PHP-DOC] cannot find input file: ./dsssl/common.dsl.in >> >> I am getting the subject message when I run ./configure. It >> immediately follows the line "creating ./dsssl/common.dsl", >> but in fact when I look in ./dsssl it has not created >> common.dsl either. >> >> Can anyone tell me what the problem might be? > > Can you cut'n'paste the entire output of your ./configure upto the > error? And you ./configure command line? > >> >> TIA >> Matthew Peters >>
Re: [PHP-DOC] cannot find input file: ./dsssl/common.dsl.in
Hi Richard, thanks for replying so quickly. Here is the output: [EMAIL PROTECTED] phpdoc]$ autoconf [EMAIL PROTECTED] phpdoc]$ ./configure file versions configure.in,v 1.242 Makefile.in,v 1.192 configure options: source directory: . working directory: /home/matthew/workspace/phpdoc checking for php... /usr/local/bin/php checking php version... 5.1.1 cli checking for php.ini path... ./scripts checking for openjade... /usr/bin/openjade checking for onsgmls... /usr/bin/onsgmls checking for xsltproc... /usr/bin/xsltproc checking for xmllint... /usr/bin/xmllint checking for docbook.dsl... ./docbook/docbook-dsssl (default) checking for PHP source path... no checking for PEAR source path... no checking for PECL source path... no checking for additional PHP extensions... no checking for CSS to use for html docs... none checking for chmonly inclusion... disabled (default) checking for internals docs exclusion... no (default) checking for language... en (default) checking for treesaving... saving trees: #f checking for *.in files... (cached) done! configure: creating ./config.status config.status: creating ./Makefile config.status: creating ./manual.xml config.status: creating ./RFC/manual.xml config.status: creating ./dsssl/common.dsl config.status: error: cannot find input file: ./dsssl/common.dsl.in [EMAIL PROTECTED] phpdoc]$ ""Richard A. Quadling"" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > -Original Message- > From: Matthew Peters [mailto:[EMAIL PROTECTED] > Sent: 26 April 2007 15:57 > To: phpdoc@lists.php.net > Subject: [PHP-DOC] cannot find input file: ./dsssl/common.dsl.in > > I am getting the subject message when I run ./configure. It > immediately follows the line "creating ./dsssl/common.dsl", > but in fact when I look in ./dsssl it has not created > common.dsl either. > > Can anyone tell me what the problem might be? Can you cut'n'paste the entire output of your ./configure upto the error? And you ./configure command line? > > TIA > Matthew Peters >
[PHP-DOC] cannot find input file: ./dsssl/common.dsl.in
I am getting the subject message when I run ./configure. It immediately follows the line "creating ./dsssl/common.dsl", but in fact when I look in ./dsssl it has not created common.dsl either. Can anyone tell me what the problem might be? TIA Matthew Peters
Re: [PHP-DOC] cvs: phpdoc /en/reference/sca .cvsignore backup.xml constants.xml reference.xml reference_1.xml /en/reference/sca/functions SCA-LocalProxy-createDataObject.xml SCA-SoapProxy-createDataO
Jakub, thanks for spotting this. Actually I had the return types of all four functions wrong. Now fixed. Matthew
[PHP-DOC] cvs: phpdoc /en/reference/sca/functions SCA-LocalProxy-createDataObject.xml SCA-SoapProxy-createDataObject.xml SCA-createDataObject.xml SCA-getService.xml
mfp Tue Jan 16 17:05:54 2007 UTC Modified files: /phpdoc/en/reference/sca/functions SCA-getService.xml SCA-SoapProxy-createDataObject.xml SCA-LocalProxy-createDataObject.xml SCA-createDataObject.xml Log: Correct the return types of all four functions http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/functions/SCA-getService.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sca/functions/SCA-getService.xml diff -u phpdoc/en/reference/sca/functions/SCA-getService.xml:1.1 phpdoc/en/reference/sca/functions/SCA-getService.xml:1.2 --- phpdoc/en/reference/sca/functions/SCA-getService.xml:1.1Tue Jan 16 13:45:53 2007 +++ phpdoc/en/reference/sca/functions/SCA-getService.xmlTue Jan 16 17:05:54 2007 @@ -1,5 +1,5 @@ - + @@ -11,8 +11,12 @@ &reftitle.description; - SCA_LocalProxy or SCA_SoapProxySCA::getService - + mixed + SCA::getService + +string +target + &warn.experimental.func; http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/functions/SCA-SoapProxy-createDataObject.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sca/functions/SCA-SoapProxy-createDataObject.xml diff -u phpdoc/en/reference/sca/functions/SCA-SoapProxy-createDataObject.xml:1.1 phpdoc/en/reference/sca/functions/SCA-SoapProxy-createDataObject.xml:1.2 --- phpdoc/en/reference/sca/functions/SCA-SoapProxy-createDataObject.xml:1.1 Tue Jan 16 13:45:53 2007 +++ phpdoc/en/reference/sca/functions/SCA-SoapProxy-createDataObject.xml Tue Jan 16 17:05:54 2007 @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ &reftitle.description; - void + SDO_DataObject SCA_SoapProxy::createDataObject string http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/functions/SCA-LocalProxy-createDataObject.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sca/functions/SCA-LocalProxy-createDataObject.xml diff -u phpdoc/en/reference/sca/functions/SCA-LocalProxy-createDataObject.xml:1.1 phpdoc/en/reference/sca/functions/SCA-LocalProxy-createDataObject.xml:1.2 --- phpdoc/en/reference/sca/functions/SCA-LocalProxy-createDataObject.xml:1.1 Tue Jan 16 13:45:53 2007 +++ phpdoc/en/reference/sca/functions/SCA-LocalProxy-createDataObject.xml Tue Jan 16 17:05:54 2007 @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ &reftitle.description; - void + SDO_DataObject SCA_LocalProxy::createDataObject string http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/functions/SCA-createDataObject.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sca/functions/SCA-createDataObject.xml diff -u phpdoc/en/reference/sca/functions/SCA-createDataObject.xml:1.1 phpdoc/en/reference/sca/functions/SCA-createDataObject.xml:1.2 --- phpdoc/en/reference/sca/functions/SCA-createDataObject.xml:1.1 Tue Jan 16 13:45:53 2007 +++ phpdoc/en/reference/sca/functions/SCA-createDataObject.xml Tue Jan 16 17:05:54 2007 @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ &reftitle.description; - void + SDO_DataObject SCA::createDataObject string
[PHP-DOC] cvs: phpdoc /en/reference/sca .cvsignore backup.xml reference_1.xml
mfp Tue Jan 16 17:05:27 2007 UTC Removed files: /phpdoc/en/reference/scareference_1.xml backup.xml Modified files: /phpdoc/en/reference/sca.cvsignore Log: Delete backup.xml and reference_1.xml, and add to .cvsignore http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sca/.cvsignore?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sca/.cvsignore diff -u phpdoc/en/reference/sca/.cvsignore:1.1 phpdoc/en/reference/sca/.cvsignore:1.2 --- phpdoc/en/reference/sca/.cvsignore:1.1 Tue Jan 16 13:45:53 2007 +++ phpdoc/en/reference/sca/.cvsignore Tue Jan 16 17:05:26 2007 @@ -1,2 +1,4 @@ functions.xml +backup.xml +reference_1.xml .project
Re: [PHP-DOC] cvs: phpdoc /en/reference/sca .cvsignore backup.xml constants.xml reference.xml reference_1.xml /en/reference/sca/functions SCA-LocalProxy-createDataObject.xml SCA-SoapProxy-createDataO
Oh, you are so right! I wonder how I did that. I will remove. Matthew ""Jakub Vrána"" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] Matthew Peters wrote: > /phpdoc/en/reference/scareference_1.xml backup.xml These files are probably superfluous. Jakub Vrána
Re: [PHP-DOC] Indentation and XMLBuddy
Nuno, thanks. I will make sure I put them back to text before I check in. Do you know, perhaps, is there a way to use vim to reflow the contents of the entire file and sort out all the indentation in one go? Matthew ""Nuno Lopes"" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] >I never used XMLBuddy so I can't help you with that. However that style >breaks our standard. Take a look at >http://doc.php.net/php/dochowto/chapter-conventions.php (I noticed now that >the changelog part is outdated, but the rest should be ok) and >http://doc.php.net/php/dochowto/chapter-skeletons.php > > VIm is usually pretty good for editing our manual, as all files already > have vim and emacs instructions :) > > Nuno > > > - Original Message - > From: "Matthew Peters" <[EMAIL PROTECTED]> > To: > Sent: Thursday, January 04, 2007 6:38 PM > Subject: [PHP-DOC] Indentation and XMLBuddy > > >>I like to use the XMLBuddy plugin under eclipse for editing XML, as it >>flows everything nicely and does all the indentation just right, with one >>exception, which is that it likes to format paragraphs with and >> on the same lines as the text, like this: >> >> Here is some text that flows >> on to the next lineand then again on >> to another. >> >> Does this formatting break the standards for the documentation or cause a >> problem for anyone, or can I check it in like this? Alternatively, does >> any know how to make XMLBuddy treat and like any other >> tag? >> >> Matthew Peters
[PHP-DOC] Indentation and XMLBuddy
I like to use the XMLBuddy plugin under eclipse for editing XML, as it flows everything nicely and does all the indentation just right, with one exception, which is that it likes to format paragraphs with and on the same lines as the text, like this: Here is some text that flows on to the next lineand then again on to another. Does this formatting break the standards for the documentation or cause a problem for anyone, or can I check it in like this? Alternatively, does any know how to make XMLBuddy treat and like any other tag? Matthew Peters
[PHP-DOC] Please may we have a new chapter in en/reference?
Now we have released our SCA for PHP project as part of a combined SCA_SDO package on PECL, I would like to move our documentation into the main PHP manual, as a chapter in the function reference section. Please may we have a new en/reference/sca directory in cvs, with access for mfp (that's me), gcc (Graham Charters), cem (Caroline Maynard) and slaws (Simon Laws)? I wil be ready to check the documentation in in a couple of days. I have remembered the conventions on http://doc.php.net/php/dochowto/chapter-conventions.php Thanks in advance, Matthew Peters
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Thu Oct 20 10:52:38 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Fix bug #34918 "docs specify MySQL version that does not exist." Two-line change to correct the MySQL version numbers. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.16&r2=1.17&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.16 phpdoc/en/reference/sdodasrel/reference.xml:1.17 --- phpdoc/en/reference/sdodasrel/reference.xml:1.16Mon Oct 10 16:57:10 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Thu Oct 20 10:52:33 2005 @@ -1,5 +1,5 @@ - + @@ -179,14 +179,14 @@ - MySQL 4.1.17, on Windows. + MySQL 4.1.14, on Windows. The Relational DAS operates correctly with the php_pdo_mysql driver that comes with the pre-built binaries for PHP 5.1.0b3. - MySQL 4.1.17, on Linux. It is necessary to have the most up-to-date + MySQL 4.1.13, on Linux. It is necessary to have the most up-to-date PDO driver for MySQL, which comes built in to PHP 5.1.0b3. It may be necessary to uninstall the usual driver that would have come from PECL using
[PHP-DOC] cvs: phpdoc /en/reference/sdo reference.xml
mfp Thu Aug 11 07:13:54 2005 EDT Modified files: /phpdoc/en/reference/sdoreference.xml Log: Changes to install section: 1. correct the pear install command (had -B in the wrong place) 2. Make the version/release/fix variable in the command http://cvs.php.net/diff.php/phpdoc/en/reference/sdo/reference.xml?r1=1.13&r2=1.14&ty=u Index: phpdoc/en/reference/sdo/reference.xml diff -u phpdoc/en/reference/sdo/reference.xml:1.13 phpdoc/en/reference/sdo/reference.xml:1.14 --- phpdoc/en/reference/sdo/reference.xml:1.13 Thu Aug 4 07:41:38 2005 +++ phpdoc/en/reference/sdo/reference.xml Thu Aug 11 07:13:48 2005 @@ -1,5 +1,5 @@ - + SDO Functions @@ -95,9 +95,9 @@ The instructions are likely to change as PHP 5.1 progresses in status -frombeta to stable release. The instructions here were correct on 3rd +frombeta to stable release. The instructions here were correct on 11th August2005, when PHP 5.1.0b3 was the current beta release of -PHP, and 0.5.0 was the current beta release of SDO. +PHP, and 0.5.1 was the current beta release of SDO. The options are summarised in the following table: @@ -178,12 +178,20 @@ The Relational DAS can be downloaded and installed with +the command: -pear -B install sdo-0.5.0 +pear install -B+ +Substitute the desired package name and level +sdo-0.5.0, +or +sdo-0.5.1, +for example, in the command above. + @@ -193,12 +201,22 @@ You can download and install all three SDO components - the SDO core, the XML DAS and the Relational DAS - with the -command +command: + + -pear install sdo-0.5.0 + pear install -. -This will build the SDO and XML shared libraries as well as + + +Substitute the desired package name and level +sdo-0.5.0, +or +sdo-0.5.1, +for example, in the command above. + + +This command will build the SDO and XML shared libraries as well as installing the PHP files that make the Relational DAS.
[PHP-DOC] cvs: phpdoc /en/reference/sdo_das_xml reference.xml
mfp Mon Aug 8 13:11:29 2005 EDT Modified files: /phpdoc/en/reference/sdo_das_xmlreference.xml Log: Various edits intended to make the examples clearer, with sample output. http://cvs.php.net/diff.php/phpdoc/en/reference/sdo_das_xml/reference.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/sdo_das_xml/reference.xml diff -u phpdoc/en/reference/sdo_das_xml/reference.xml:1.8 phpdoc/en/reference/sdo_das_xml/reference.xml:1.9 --- phpdoc/en/reference/sdo_das_xml/reference.xml:1.8 Mon Jul 25 10:15:45 2005 +++ phpdoc/en/reference/sdo_das_xml/reference.xml Mon Aug 8 13:11:28 2005 @@ -1,5 +1,5 @@ - + SDO XML Data Access Service Functions @@ -23,18 +23,15 @@ The job of the XML DAS is to move data between the -application and an XML data source. -In order to do this it needs to be told the -XML schema the XML should follow. -This model information is used to ensure conformance +application and an XML data source, which can be either a file or +a URL. In order to do this it needs to be told the location of the +XML schema, which is passed as a parameter to the create +method of the XML DAS. +The schema is used to ensure conformance of XML being written out, and also to ensure that modifications made to an SDO originating from XML follow the model described by the XML schema. - -The XML DAS currently supports reading/writing XML -to/from a file or an http URL (for example, to support RSS feeds). - @@ -45,7 +42,7 @@ SDO to have been installed. See the SDO installation instructions -for steps on how to do this. +for the details of how to do this. @@ -246,36 +243,54 @@ The following examples are based on the letter example described in the -SDO documentation -. +SDO documentation. The examples assume the XML Schema for the letter is contained in a file letter.xsd and the letter instance is in the file -letter.xml -. +letter.xml. +These two files are reproduced here: + + + + + + + + + + + -Working with the SDO_DAS_XML Class +Loading, altering, and saving an XML document - The following example shows how to create a SDO_DAS_XML Object and - use it to load an instance document. - The SDO_DAS_XML object can be created by passing the xsd file - to the SDO_DAS_XML::create method, which is a static method - of SDO_DAS_XML Class. - This schema file(XSD Document) can be either file available - on the local file system or it can be an URL. - Once we have created the SDO_DAS_XML Object, - we can use the same to load the instance document using - loadFromFile method. - loadFromString method can be used if want load xml instance document - which is available as string. - On successful loading of the instance document, - you will be returned with an object of type SDO_DAS_XML_Document. - Use the getRootDataObject method of SDO_DAS_XML_Document - class to get the root DataObject. - This example also tries to modify the properties of the root - DataObject and then write the changed contents back to file system. + The following example shows how an XML document can be loaded from a file, + altered, and written back. - - -Working with the SDO_DAS_XML Class - The above example shown, how to use the SDO_DAS_XML object to load an - existing instance document and change the DataObject(property values) - and write the changes back to file system. - This example shows, how to create the DataObjects dynamically and - save them as a xml string. - Please note that this example uses a company schema(( - company.xsd - )) as defined in SDO samples section. + An instance of the XML DAS is first obtained from the + SDO_DAS_XML::create + method, + which is a static method of the + SDO_DAS_XML + class. + The location of the xsd is passed as a parameter. + Once we have an instance of the XML DAS initialised + with a given schema, + we can use it to load the instance document using the + loadFromFile + method. + There is also a + loadFromString + method if you want to load an XML + instance document from a string. + If the instance document loads successfully, + you will be returned an object of type + SDO_DAS_XML_Document, + on which you can call the + getRootDataObject + method to get the SDO data object which is the root + of the SDO data graph. + You can then use SDO operations to change the graph. + In this example we alter the + date, + firstName, and + lastName properties. + Then we use the + saveDocumentToFile + method to write the changed document back t
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Thu Aug 4 08:20:58 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Update three function calls to include "PDO::" - partly to clarify, partly so they match exactly when searched on livedocs. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.12&r2=1.13&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.12 phpdoc/en/reference/sdodasrel/reference.xml:1.13 --- phpdoc/en/reference/sdodasrel/reference.xml:1.12Thu Aug 4 08:15:48 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Thu Aug 4 08:20:50 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -214,12 +214,12 @@ The Relational DAS applies changes to the database within -a user-delimited transaction: that is, it issues a call to PDO's -beginTransaction +a user-delimited transaction: that is, it issues a call to +PDO::beginTransaction before beginning to apply changes, and -commit +PDO::commit or -rollback +PDO::rollback on completion. Whichever database is chosen, the database and the PDO driver for the database must support these calls.
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Thu Aug 4 08:15:49 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Update Requirements section to give more details on which platforms/databases have been tested. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.11 phpdoc/en/reference/sdodasrel/reference.xml:1.12 --- phpdoc/en/reference/sdodasrel/reference.xml:1.11Wed Aug 3 10:30:41 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Thu Aug 4 08:15:48 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -171,23 +171,45 @@ The Relational DAS uses PDO to access the relational database, -and so should run with a variety of different relational databases, -but at the time of writing has only been tested with MySQL 4.1.7 -on Windows and Linux, DB2 8.2 Personal Edition on Windows and -DB2 8.2 Personal Developer's Edition (the Developer's Edition -contains the include files which are needed when PHP is configured -with the ---with-pdo-odbc=ibm-db2 -option. -On Windows it operates correctly with the php_pdo_mysql and -php_pdo_odbc drivers, for MySQL and DB2 respectively, -that come with the pre-built binaries in PHP 5.1.0b3. -On Linux it is necessary to have the most up-to-date PDO -driver for MySQL. It may be necessary to uninstall the usual -driver that would have come from PECL (using -pear uninstall pdo_mysql -) and to enable pdo_mysql when configuring PHP, in order to pick up -the recent version built in to PHP. +and so should run with a variety of different relational databases. +At the time of writing it has been tested in the following configurations + + + + MySQL 4.1.17, on Windows. + The Relational DAS operates correctly with the php_pdo_mysql + driver that comes with the pre-built binaries for PHP 5.1.0b3. + + + + + MySQL 4.1.17, on Linux. It is necessary to have the most up-to-date + PDO driver for MySQL, which comes built in to PHP 5.1.0b3. + It may be necessary to uninstall the usual driver that would have + come from PECL using + pear uninstall pdo_mysql + . You will need to configure PHP with the + --with-pdo-mysql option. + + + + + DB2 8.2 Personal Edition, on Windows. + The Relational DAS operates correctly with the + php_pdo_odbc driver that comes with the pre-built binaries for + PHP 5.1.0b3. + + + + + DB2 8.2 Personal Developer's Edition, on Linux. + The Developer's Edition is needed because it + contains the include files needed when PHP is configured + and built. You will need to configure PHP with the + --with-pdo-odbc=ibm-db2 option. + + +
[PHP-DOC] cvs: phpdoc /en/reference/sdo reference.xml
mfp Thu Aug 4 07:41:40 2005 EDT Modified files: /phpdoc/en/reference/sdoreference.xml Log: Improvements to Install section - Include link to PECL snaps; describe alterations to php.ini. http://cvs.php.net/diff.php/phpdoc/en/reference/sdo/reference.xml?r1=1.12&r2=1.13&ty=u Index: phpdoc/en/reference/sdo/reference.xml diff -u phpdoc/en/reference/sdo/reference.xml:1.12 phpdoc/en/reference/sdo/reference.xml:1.13 --- phpdoc/en/reference/sdo/reference.xml:1.12 Wed Aug 3 10:29:59 2005 +++ phpdoc/en/reference/sdo/reference.xml Thu Aug 4 07:41:38 2005 @@ -1,5 +1,5 @@ - + SDO Functions @@ -92,124 +92,153 @@ version (a .tgz file from the PECL site) or the latest from CVS. The Relational DAS also needs special attention as it is written in PHP. - - - The instructions are likely to change as PHP 5.1 progresses in status - frombeta to stable release. The instructions here were correct on 3rd - August2005, when PHP 5.1.0b3 was the current beta release of - PHP, and 0.5.0 was the current beta release of SDO. - - - The options are summarised in the following table: - - - - - latest CVS/Release - Windows - Linux - - - - - -latest CVS - - - - - - You will find the latest DLLs for the SDO core and the - XML DAS at the PHP snaps site. - The "PECL extensions for the unstable win32 branch" link points - to the list of recently built DLLs. The latest sdo core is - php_sdo.dll - . - The latest XML DAS is - php_sdo_das_xml.dll - . - - - - - Check out the Relational DAS from CVS to somewhere on the - PHP - include_path - . - - - - - - - - - Check out the SDO core and the XML DAS from CVS - and build according to the instructions - immediately following for building on Linux. - - - - - Check out the Relational DAS from CVS to somewhere on the - PHP - include_path - . - - - - - - - -Release - - - - - - There is currently no way provided for building the release - version of the SDO core and XML DAS on a user's machine. - You will only be able to pick up the latest DLLs from the - snaps site (see previous row of this table). - - - - - The Relational DAS can be downloaded and installed with - - - - pear -B install sdo-0.5.0 - - . - - - - - - - - - You can download and install all three SDO components - the - SDO core, the XML DAS and the Relational DAS - with the - command - - pear install sdo-0.5.0 - - . - This will build the SDO and XML shared libraries as well as - installing the PHP files that make the Relational DAS. - - - - - - - - - + + +The instructions are likely to change as PHP 5.1 progresses in status +frombeta to stable release. The instructions here were correct on 3rd +August2005, when PHP 5.1.0b3 was the current beta release of +PHP, and 0.5.0 was the current beta release of SDO. + + +The options are summarised in the following table: + + + + +latest/Release +Windows +Linux + + + + + + latest CVS + + + + + +You will find the latest DLLs for the SDO core and the +XML DAS at the PHP snaps site. Follow the link to + + "PECL extensions for the unstable win32 branch" + +for the list of recently built DLLs. The latest sdo core DLL is +php_sdo.dll +and the latest XML DAS DLL is +php_sdo_das_xml.dll +. + + + + +Check out the Relational DAS from CVS to somewhere on the +PHP +include_path +. + + + + + + + + +Check out the SDO core and the XML DAS from CVS +and build according to the instructions +below for building on Linux. + + + + +Check out the Relational DA
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Wed Aug 3 10:30:42 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Shorten installation instructions and point at main SDO install section http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.10 phpdoc/en/reference/sdodasrel/reference.xml:1.11 --- phpdoc/en/reference/sdodasrel/reference.xml:1.10Fri Jul 29 14:14:31 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Wed Aug 3 10:30:41 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -131,11 +131,17 @@ &reftitle.install; -The Relational DAS is written in PHP. The PHP files that make the -Relational DAS should be placed in a directory that is pointed to -by the +The installation instructions for all the SDO components +are in the SDO +install +section of the SDO documentation. + + +In any case, the essential facts are that +the Relational DAS is written in PHP and it +should be placed somewhere on the PHP include_path -directive in the &php.ini; file. +. @@ -167,7 +173,12 @@ The Relational DAS uses PDO to access the relational database, and so should run with a variety of different relational databases, but at the time of writing has only been tested with MySQL 4.1.7 -on Windows and Linux, and DB2 8.2 Personal Edition on Windows. +on Windows and Linux, DB2 8.2 Personal Edition on Windows and +DB2 8.2 Personal Developer's Edition (the Developer's Edition +contains the include files which are needed when PHP is configured +with the +--with-pdo-odbc=ibm-db2 +option. On Windows it operates correctly with the php_pdo_mysql and php_pdo_odbc drivers, for MySQL and DB2 respectively, that come with the pre-built binaries in PHP 5.1.0b3.
[PHP-DOC] cvs: phpdoc /en/reference/sdo reference.xml
mfp Wed Aug 3 10:30:03 2005 EDT Modified files: /phpdoc/en/reference/sdoreference.xml Log: Rewrite installation instructions to cover Windows/Linux X Release/latestCVS. http://cvs.php.net/diff.php/phpdoc/en/reference/sdo/reference.xml?r1=1.11&r2=1.12&ty=u Index: phpdoc/en/reference/sdo/reference.xml diff -u phpdoc/en/reference/sdo/reference.xml:1.11 phpdoc/en/reference/sdo/reference.xml:1.12 --- phpdoc/en/reference/sdo/reference.xml:1.11 Fri Jul 29 12:58:23 2005 +++ phpdoc/en/reference/sdo/reference.xml Wed Aug 3 10:29:59 2005 @@ -1,5 +1,5 @@ - + SDO Functions @@ -87,34 +87,141 @@ &reftitle.install; -SDO extension can be installed using pear. However as it is -still in it's beta you need set pear option 'preferred_state' to beta. -like pear -D preferred_state=beta install sdo . -If you want to install this extension manually on Linux, you -can do so by following steps described below. - - -Linux installation steps + There are several options, depending on whether you are installing on + Windows or Linux, and depending on whether you are installing a released + version (a .tgz file from the PECL site) or the latest from CVS. + The Relational DAS also needs special attention as it is written in + PHP. + + + The instructions are likely to change as PHP 5.1 progresses in status + frombeta to stable release. The instructions here were correct on 3rd + August2005, when PHP 5.1.0b3 was the current beta release of + PHP, and 0.5.0 was the current beta release of SDO. + + + The options are summarised in the following table: + + + + + latest CVS/Release + Windows + Linux + + + + + +latest CVS + + + + + + You will find the latest DLLs for the SDO core and the + XML DAS at the PHP snaps site. + The "PECL extensions for the unstable win32 branch" link points + to the list of recently built DLLs. The latest sdo core is + php_sdo.dll + . + The latest XML DAS is + php_sdo_das_xml.dll + . + + + + + Check out the Relational DAS from CVS to somewhere on the + PHP + include_path + . + + + + + + + + + Check out the SDO core and the XML DAS from CVS + and build according to the instructions + immediately following for building on Linux. + + + + + Check out the Relational DAS from CVS to somewhere on the + PHP + include_path + . + + + + + + + +Release + + + + + + There is currently no way provided for building the release + version of the SDO core and XML DAS on a user's machine. + You will only be able to pick up the latest DLLs from the + snaps site (see previous row of this table). + + + + + The Relational DAS can be downloaded and installed with + + + + pear -B install sdo-0.5.0 + + . + + + + + + + + + You can download and install all three SDO components - the + SDO core, the XML DAS and the Relational DAS - with the + command + + pear install sdo-0.5.0 + + . + This will build the SDO and XML shared libraries as well as + installing the PHP files that make the Relational DAS. + + + + + + + + + + + +Building SDO on Linux - The following instructions describe how to install the - SDO extension on Linux. Note, these steps will also install the - XML Data Access Service - which is packaged as part of this extension. + This section describes how to build the SDO core and XML DAS on Linux. + Currently you would only need to know how to do this if you + wish to build a recent version that you have checked out + of CVS. - Download the SDO extension from the pecl/sdo directory on CVS. - - - - - Untar the downloaded image in your favourite folder. - - - - Change to the main extension directory: - cd sdo-< version > + cd < wherever your sdo code is >
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel/functions SDO-DAS-Relational-executePreparedQuery.xml
mfp Mon Aug 1 05:23:02 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel/functions SDO-DAS-Relational-executePreparedQuery.xml Log: Add with example code for executePreparedQuery() http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executePreparedQuery.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executePreparedQuery.xml diff -u phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executePreparedQuery.xml:1.1 phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executePreparedQuery.xml:1.2 --- phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executePreparedQuery.xml:1.1 Fri Jul 29 14:14:31 2005 +++ phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executePreparedQuery.xml Mon Aug 1 05:23:02 2005 @@ -1,5 +1,5 @@ - + SDO_DAS_Relational::executePreparedQuery @@ -196,10 +196,63 @@ &reftitle.examples; - Please see the - Examples - section in the general information about the - Relational DAS for many examples of calling this method. + +Retrieving a data object using executePreparedQuery + + In this example a single data object is retrieved from the database + - or possibly more than one if there is more than one company + called 'Acme'. For each company returned, the + name + and + id + properties are echoed. + + + Other examples of the use of + executePreparedQuery + can be found in the example code supplied in + sdo/DAS/Relational/Scenarios + . + + + + +
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml /en/reference/sdodasrel/functions SDO-DAS-Relational-executePreparedQuery.xml
mfp Fri Jul 29 14:14:32 2005 EDT Added files: /phpdoc/en/reference/sdodasrel/functions SDO-DAS-Relational-executePreparedQuery.xml Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Update the limitations section to reflect the fact that DB2 is supported and has been tested, add description of the new executePreparedQuery method, and update the limitations again to reflect the fact that prepared statements are now supported. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.9 phpdoc/en/reference/sdodasrel/reference.xml:1.10 --- phpdoc/en/reference/sdodasrel/reference.xml:1.9 Tue Jul 26 11:28:57 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Fri Jul 29 14:14:31 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -54,7 +54,11 @@ The next step might be to call the executeQuery - method on the Relational DAS, passing an SQL statement. + or + executePreparedQuery + methods on the Relational DAS, passing either a literal SQL statement + for the DAS to prepare and execute, or a prepared statement with + placeholders and a list of values to be inserted. You may also need to specify a small amount of metadata about the query itself, so that the Relational DAS knows exactly what columns will be returned from the database and @@ -64,6 +68,8 @@ The return value from executeQuery + or + executePreparedQuery is a normalised data graph containing all the data from the result set. For a query that returns data obtained from a number of tables, this graph will contain a number of data objects, @@ -160,9 +166,11 @@ The Relational DAS uses PDO to access the relational database, and so should run with a variety of different relational databases, -but at the time of writing has only been tested with MySQL 4.1. -On Windows it operates correctly with the php_pdo_mysql driver -that comes with the pre-built binaries in PHP 5.1.0b3. +but at the time of writing has only been tested with MySQL 4.1.7 +on Windows and Linux, and DB2 8.2 Personal Edition on Windows. +On Windows it operates correctly with the php_pdo_mysql and +php_pdo_odbc drivers, for MySQL and DB2 respectively, +that come with the pre-built binaries in PHP 5.1.0b3. On Linux it is necessary to have the most up-to-date PDO driver for MySQL. It may be necessary to uninstall the usual driver that would have come from PECL (using @@ -239,16 +247,6 @@ for example. - - - No support for prepared statements or bound variables. - Although PDO allows both of these - the ability to prepare and SQL - statement once and execute it many times, perhaps picking different - arguments for the query from variables within the application - - there is no support in the current Relational DAS interface - to allow this. - - @@ -290,14 +288,31 @@ -These examples all differ from the expected use of SDO in one important -respect: they show all interactions with the database completed within +These examples all differ from the expected use of SDO in two +important respects. + + +First, they show all interactions with the database completed within one script. In this respect these scenarios are not realistic but are chosen to illustrate just the use of the Relational DAS. It is expected that interactions with the database will be separated in time and the data graph serialised and deserialised into the PHP session one or more times as the application interacts with an end user. + +Second, all queries executed against the database use hard-coded +queries with no variables substituted. In this case it is safe to +use the simple +executeQuery +call, and this is what the examples illustrate. +In practice, though,it is unlikely that the SQL statement is known +entirely ahead of time. In order to allow variables to be safely +substituted into the SQL queries, without running the risk of +injecting SQL with unknown effects, it is safer to use the +executePreparedQuery +which takes a prepared SQL statement containing placeholders +and a list of values to be substituted. + Specifying the metadata @@ -408,7 +423,7 @@ This metadata corresponds to a relational database that might have - been defined to MySQL as follows. + been defined to MySQL as: + or to DB2 as: + + + +
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Tue Jul 26 11:28:57 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Alterations to the Requirements section http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.8 phpdoc/en/reference/sdodasrel/reference.xml:1.9 --- phpdoc/en/reference/sdodasrel/reference.xml:1.8 Tue Jul 26 10:13:17 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Tue Jul 26 11:28:57 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -151,8 +151,37 @@ The Relational DAS requires that the SDO extension be installed. The SDO extension requires a version of PHP 5.1, and the Relational DAS requires a recent version that contains -an important fix for PDO. The Relational DAS requires a -version of PHP 5.1 later than 20050711. +an important fix for PDO. The most up-to-date information about +required levels of PHP should be found in the changelog for the +package on PECL. At the time of writing, though, the Relational +DAS requires the most recent beta level of PHP 5.1, that is +PHP 5.1.0b3. + + +The Relational DAS uses PDO to access the relational database, +and so should run with a variety of different relational databases, +but at the time of writing has only been tested with MySQL 4.1. +On Windows it operates correctly with the php_pdo_mysql driver +that comes with the pre-built binaries in PHP 5.1.0b3. +On Linux it is necessary to have the most up-to-date PDO +driver for MySQL. It may be necessary to uninstall the usual +driver that would have come from PECL (using +pear uninstall pdo_mysql +) and to enable pdo_mysql when configuring PHP, in order to pick up +the recent version built in to PHP. + + + +The Relational DAS applies changes to the database within +a user-delimited transaction: that is, it issues a call to PDO's +beginTransaction +before beginning to apply changes, and +commit +or +rollback +on completion. +Whichever database is chosen, the database and the PDO driver +for the database must support these calls.
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Tue Jul 26 10:13:19 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Add to some examples that lacked them. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.7 phpdoc/en/reference/sdodasrel/reference.xml:1.8 --- phpdoc/en/reference/sdodasrel/reference.xml:1.7 Tue Jul 26 10:02:08 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Tue Jul 26 10:13:17 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -137,7 +137,9 @@ with a statement like this: @@ -339,6 +341,7 @@ @@ -550,10 +554,12 @@ @@ -1046,13 +1052,17 @@ root object. You must use: and not: Simply unsetting
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel reference.xml
mfp Tue Jul 26 10:02:09 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel reference.xml Log: Several edits for spelling, punctuation, making the existing text read more clearly. No changes to the meaning, no new material. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/sdodasrel/reference.xml diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.6 phpdoc/en/reference/sdodasrel/reference.xml:1.7 --- phpdoc/en/reference/sdodasrel/reference.xml:1.6 Sat Jul 23 07:08:36 2005 +++ phpdoc/en/reference/sdodasrel/reference.xml Tue Jul 26 10:02:08 2005 @@ -1,5 +1,5 @@ - + SDO Relational Data Access Service Functions @@ -13,7 +13,7 @@ &warn.experimental; -In order to use the Relational Data Acces Service for +In order to use the Relational Data Access Service for Service Data Objects, you will need to understand some of the concepts behind SDO: the data graph, the data object, the disconnected way of working, @@ -67,15 +67,15 @@ is a normalised data graph containing all the data from the result set. For a query that returns data obtained from a number of tables, this graph will contain a number of data objects, - linked by containment references. - There may also be non-containment references within the data. + linked by SDO containment references. + There may also be SDO non-containment references within the data. Once the query has been executed and the data graph constructed, - there is no need for either the Relational DAS or the - database connection. There are no locks held on the database. - Both the Relational Das and the PDO database connection can be + there is no need for either that instance of the the Relational DAS or + the database connection. There are no locks held on the database. + Both the Relational DAS and the PDO database connection can be garbage collected. @@ -86,7 +86,7 @@ into the PHP session and so may have a lifetime beyond just one client-server interaction. Data objects can be created and added to the graph, the data objects already in the graph - can be deleted, and they can be modified. + can be deleted, and data objects in the graph can be modified. @@ -97,11 +97,11 @@ method of the Relational DAS. For this, another instance of the Relational DAS must be constructed, using the same metadata, and another connection to the database obtained. - These, plus the data graph itself, are passed to + The connection and the data graph are passed to applyChanges. At this point the Relational DAS examines the change summary and generates the necessary INSERT, UPDATE and DELETE SQL statements - to apply the changes. The UPDATE and DELETE statements are qualified + to apply the changes. Any UPDATE and DELETE statements are qualified with the original values of the data so that should the data have changed in the database in the meantime this will be detected. Assuming no such collisions have occurred the changes will be @@ -240,7 +240,7 @@ The Relational DAS is constructed with metadata that defines the relational database and how it should be mapped to SDO. -The first long section describes this metadata and how to +The long section that follows describes this metadata and how to construct the Relational DAS. The examples that follow it all assume that this metadata is in an included php file. @@ -326,7 +326,7 @@ FK An array with two entries, 'from' and 'to', which define a column containing a foreign key, and a table to which the foreign - key points to. If there are no foreign keys in the table then the + key points. If there are no foreign keys in the table then the 'FK' entry does not need to be specified. Only one foreign key can be specified. Only a foreign key pointing to the primary key of a table can be specified. @@ -437,16 +437,17 @@ There are a few simple rules to be followed when constructing the - database metadata + database metadata: -All tables must have primary keys and they must be specified in -the metadata. Without primary keys it is not possible to keep track -of object identities. As you see from the SQL statements, primary -keys can be auto-generated, that is assigned by the database when +All tables must have primary keys, and the primary keys must be +specified in the metadata. Without primary keys it is not possible +to keep track of object identities. As you can see from the
[PHP-DOC] Please may we have new sections up on docs.php.net?
I am not sure what the right way to ask or the right person to ask is: On livedocs.phpdoc.info we see our three SDO sections - good But on docs.php.net we see just one of them - the one that was checked in a couple of days before the others. Jakub said he thought that it needed ./configure run on docs.php.net in order to pick up the new sections. Please could we have whatever is needed on docs.php.net to pick up the new sections. Thank you. Matthew
Re: [PHP-DOC] SDO Documentation
Jakub Vrana wrote: Anantoju Veera Srinivas wrote: Initial SDO_XML_DAS Documentation drop Should this live in its own directory? Isn't it part of SDO? Jakub Vrana Jakub, we just tried the experiment of naively moving the two directories sdodasrel and sdo_das_xml inside the sdo directory and running make html. That didn't work. I guess the build process won't automatically look for reference.xml in subdirectories. We want to keep the structure we have where the documentation for the two DASs look like the documentation for a regular extension (sections for installation, functions, etc.) but have everything neatly in the sdo directory. Do you know how we achieve this? If you don't mind I had a couple of other questions: 1. I don't understand the build process well enough to know why the sdo section is appearing on http://docs.php.net/ but the two DAS sections aren't. Is there a manual step needed? And when do things get promoted to php.net? 2. We note that a with appears with numbered steps when we build locally but without numbers on http://docs.php.net/ Is that something we can fix, do you know? And a meta-question - should I be asking these questions on a different newsgroup or is this one right? Matthew
[PHP-DOC] cvs: phpdoc /en/reference/sdo_das_xml reference.xml /en/reference/sdo_das_xml/functions SDO-DAS-XML-Document-getNoNamespaceSchemaLocation.xml SDO-DAS-XML-Document-getXMLDeclaration.xml SDO-
mfp Thu Jul 21 06:14:43 2005 EDT Modified files: /phpdoc/en/reference/sdo_das_xmlreference.xml /phpdoc/en/reference/sdo_das_xml/functions SDO-DAS-XML-loadFromString.xml SDO-DAS-XML-Document-getXMLDeclaration.xml SDO-DAS-XML-Document-setXMLDeclaration.xml SDO-DAS-XML-Document-getNoNamespaceSchemaLocation.xml SDO-DAS-XML-create.xml SDO-DAS-XML-loadFromFile.xml SDO-DAS-XML-createDataObject.xml Log: WS only. Shorten all lines to 78 chars or less. http://cvs.php.net/diff.php/phpdoc/en/reference/sdo_das_xml/reference.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/sdo_das_xml/reference.xml diff -u phpdoc/en/reference/sdo_das_xml/reference.xml:1.3 phpdoc/en/reference/sdo_das_xml/reference.xml:1.4 --- phpdoc/en/reference/sdo_das_xml/reference.xml:1.3 Wed Jul 20 06:59:47 2005 +++ phpdoc/en/reference/sdo_das_xml/reference.xml Thu Jul 21 06:14:42 2005 @@ -1,5 +1,5 @@ - + SDO XML Data Access Service Functions @@ -13,30 +13,40 @@ &warn.experimental; -In order to use the XML Data Access Service for Service Data Objects, you will need to understand some of the concepts behind SDO: the data graph, the data object, XPath and property expressions, and so on. +In order to use the XML Data Access Service for Service Data Objects, +you will need to understand some of the concepts behind SDO: +the data graph, the data object, XPath and property expressions, +and so on. If you are not familiar with these ideas, you might want to look first at the section on SDO . -The job of the XML DAS is to move data between the application and an XML data source. -In order to do this it needs to be told the XML schema the XML should follow. -This model information is used to ensure conformance of XML being written out, and also to ensure that -modifications made to an SDO originating from XML follow the model described by the XML schema. +The job of the XML DAS is to move data between the +application and an XML data source. +In order to do this it needs to be told the +XML schema the XML should follow. +This model information is used to ensure conformance +of XML being written out, and also to ensure that +modifications made to an SDO originating from XML +follow the model described by the XML schema. -The XML DAS currently supports reading/writing XML to/from a file or an http URL (for example, to support RSS feeds). +The XML DAS currently supports reading/writing XML +to/from a file or an http URL (for example, to support RSS feeds). &reftitle.required; -The SDO XML Data Access Service requires PHP 5.1 or higher. It is packaged with the SDO extension and requires SDO to have been installed. +The SDO XML Data Access Service requires PHP 5.1 or higher. +It is packaged with the SDO extension and requires +SDO to have been installed. See the SDO installation instructions for steps on how to do this. - + @@ -49,29 +59,38 @@ + Limitations The SDO 2.0 specification -defines the mapping between XML types and SDO types. With Java SDO, this mapping is implemented by the XMLHelper. With SDO for PHP, this mapping is implemented by the XML Data Access Services. The XML DAS implements the mapping described in the SDO 2.0 specification with the following restrictions: +defines the mapping between XML types and SDO types. +With Java SDO, this mapping is implemented by the XMLHelper. +With SDO for PHP, this mapping is implemented by the +XML Data Access Services. +The XML DAS implements the mapping described in the +SDO 2.0 specification with the following restrictions: XML Simple Types - Simple Type with abstract="true" - no PHP support for SDO abstract types. + Simple Type with abstract="true" + - no PHP support for SDO abstract types. - Simple Type with sdoJava:instanceClass - no PHP equivalent provided. + Simple Type with sdoJava:instanceClass + - no PHP equivalent provided. - Simple Type with sdoJava:extendedInstanceClass - no PHP equivalent provided. + Simple Type with sdoJava:extendedInstanceClass + - no PHP equivalent provided. @@ -90,22 +109,26 @@ XML Complex Types - Complex Type with abstract="true" - no PHP support for SDO abstract types. + Complex Type with abstract="true"
[PHP-DOC] Re: cvs: phpdoc /en/reference/sdodasrel reference.xml /en/reference/sdodasrel/functionsSDO-DAS-Relational-applyChanges.xml SDO-DAS-Relational-construct.xml SDO-DAS-Relational-createRootData
Apologies. Thanks for letting me know. Do you want me to fix - I am very happy to do it but it means more WS changes - or just not do it in future? Matthew Mehdi Achour wrote: Hello Matthew, Please don't make lines exceed 78 chars (the only exception is for and its children). didou
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel constants.xml
mfp Wed Jul 20 10:52:41 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel constants.xml Log: Substantial WS change to get one-space indentation. No other changes of any sort. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/constants.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/sdodasrel/constants.xml diff -u phpdoc/en/reference/sdodasrel/constants.xml:1.1 phpdoc/en/reference/sdodasrel/constants.xml:1.2 --- phpdoc/en/reference/sdodasrel/constants.xml:1.1 Tue Jul 19 05:48:28 2005 +++ phpdoc/en/reference/sdodasrel/constants.xml Wed Jul 20 10:52:40 2005 @@ -1,13 +1,13 @@ - + - - -The Relational DAS introduces no predefined constants. - + + + The Relational DAS introduces no predefined constants. +
Re: [PHP-DOC] cvs: phpdoc /en/reference/sdo_das_xml reference.xml /en/reference/sdo_das_xml/functions SDO-DAS-XML-Document-getEncoding.xml SDO-DAS-XML-Document-getNoNamespaceSchemaLocation.xml SDO-DAS
Dan Scott wrote: Hi Matt: To make it easier for translators to determine content changes from whitespace changes in the future, please commit whitespace fixes separately from content fixes. I see - I hadn't read carefully enough rule 14 in the conventions that does say "because of the translations". Now I understand. Won't happen again.
[PHP-DOC] Re: SDO docs
I know what was puzzling me below my conscious level now: >> I can see how we'd get annoying (-: one of us is upside down :-) "Sean Coates" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > Matthew (and other SDO folks), > > Would you prefer we stay out of your way for a couple days while you put > the initial SDO stuff in? > > I can see how we'd get annoying (-: > > If so, please be sure to `make test` and `make test_xml` before each commit. > > S
[PHP-DOC] Re: SDO docs
Sean, No, don't stop! We want it all sorted as quickly as we can. All the text is all checked in so the job right now is to get it compliant with the conventions and building correctly. I know I need to make some extensive WS spaces which I will do tomorrow morning UK time, otherwise we only need to do things that you and others tell us we need to fix. Please let us know likewise if we're in your way. We note what you say about make test. Apologies, we have not been doing that. Is there something we missed that told us to do that? What did we not read? Matthew "Sean Coates" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > Matthew (and other SDO folks), > > Would you prefer we stay out of your way for a couple days while you put > the initial SDO stuff in? > > I can see how we'd get annoying (-: > > If so, please be sure to `make test` and `make test_xml` before each commit. > > S
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel/functions SDO-DAS-Relational-createRootDataObject.xml SDO-DAS-Relational-executeQuery.xml
mfp Tue Jul 19 10:21:18 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel/functions SDO-DAS-Relational-createRootDataObject.xml SDO-DAS-Relational-executeQuery.xml Log: Fix to use valid types (SDODataObject) in descriptions of functions. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-createRootDataObject.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-createRootDataObject.xml diff -u phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-createRootDataObject.xml:1.1 phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-createRootDataObject.xml:1.2 --- phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-createRootDataObject.xml:1.1 Tue Jul 19 05:48:30 2005 +++ phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-createRootDataObject.xml Tue Jul 19 10:21:18 2005 @@ -1,5 +1,5 @@ - + SDO_DAS_Relational::createRootDataObject @@ -11,7 +11,7 @@ &reftitle.description; - special root object + SDODataObject SDO_DAS_Relational::createRootDataObject http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executeQuery.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executeQuery.xml diff -u phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executeQuery.xml:1.1 phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executeQuery.xml:1.2 --- phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executeQuery.xml:1.1 Tue Jul 19 05:48:30 2005 +++ phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-executeQuery.xml Tue Jul 19 10:21:18 2005 @@ -1,5 +1,5 @@ - + SDO_DAS_Relational::executeQuery @@ -11,7 +11,7 @@ &reftitle.description; - data graph + SDODataObject SDO_DAS_Relational::executeQuery PDO
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel/functions SDO-DAS-Relational-applyChanges.xml
mfp Tue Jul 19 10:21:06 2005 EDT Modified files: /phpdoc/en/reference/sdodasrel/functions SDO-DAS-Relational-applyChanges.xml Log: Fix to use valid types (SDODataObject) in descriptions of functions. http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-applyChanges.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-applyChanges.xml diff -u phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-applyChanges.xml:1.1 phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-applyChanges.xml:1.2 --- phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-applyChanges.xml:1.1 Tue Jul 19 05:48:30 2005 +++ phpdoc/en/reference/sdodasrel/functions/SDO-DAS-Relational-applyChanges.xml Tue Jul 19 10:21:02 2005 @@ -1,5 +1,5 @@ - + SDO_DAS_Relational::applyChanges @@ -18,7 +18,7 @@ database_handle -string +SDODataObject root_data_object @@ -27,7 +27,7 @@ - Given a datagraph and a PDO database handle, examines the change summary in the datagraph and applies the changes to the database. + Given a PDO database handle and the special root object of a data graph, examine the change summary in the datagraph and applies the changes to the database. The changes that it can apply can be creations of data objects, deletes of data objects, and modifications to properties of data objects.
Re: [PHP-DOC] Please may I have commit rights...
OK I noted I should write to [EMAIL PROTECTED] in the future. Thanks for your help. Matthew "Derick Rethans" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > On Tue, 19 Jul 2005, Gabor Hojtsy wrote: > > > >> Please may I have commit rights to the directory sdodasrel under > > >> phpdoc/en/reference? My CVS is 'mfp'. > > > > > > 13:39 <@sean> can someone please give 'mfp' karma to phpdoc ? (mfp = > > > Matthew Peters (IBM - SDO)) > > > 13:40 <@Wez> I'll do it > > > 13:41 <@Wez> sean: done > > > 13:41 <@sean> thanks. > > > > > > FYI, [EMAIL PROTECTED] (CC [EMAIL PROTECTED]) is the proper place to > > > request > > > karma, in the future (but no problem, this time). > > > > Do not bother systems with PHP karma questions, they are not the proper > > guys to request from. > > But it'll be faster than writing to group@ ;-) > > Derick
[PHP-DOC] cvs: phpdoc /en/reference/sdodasrel functions.xml
mfp Tue Jul 19 06:04:44 2005 EDT Removed files: /phpdoc/en/reference/sdodasrel functions.xml Log: Remove functions.xml - checked in in error
[PHP-DOC] Please may I have commit rights...
I am working on a project developing Service Data Objects for PHP (see recent posting on pecl-dev by Graham Charters 15 July). We have authority to commit to pecl and so have checked in our code, but also have documentation to check in. Please may I have commit rights to the directory sdodasrel under phpdoc/en/reference? My CVS is 'mfp'. Thanks. BTW I expect there will be a couple of other requests related to this from other members of my team. Matthew Peters SWG AB Incubators Int: 246740 Ext: +44-(0)1962- 816740 MP 146, IBM UK Labs, Hursley http://w3.ibm.com/persona/users/6/3/7/637921328.html Internet: [EMAIL PROTECTED]