Applied new structure

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@78842 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Gabor Hojtsy 2002-04-19 15:07:14 +00:00
parent fc522ef366
commit f513cbd09c
5 changed files with 164 additions and 131 deletions

View file

@ -1,20 +1,23 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<reference id="ref.crack">
<title>Crack functions</title>
<titleabbrev>Crack functions</titleabbrev>
<partintro>
<para id="crack.intro">
These functions allow you to use the CrackLib library to test the
'strength' of a password. The 'strength' of a password is tested by that
checks length, use of upper and lower case and checked against the
specified CrackLib dictionary. CrackLib will also give helpful diagnostic
messages that will help 'strengthen' the password.
</para>
<section id="crack.intro">
&reftitle.intro;
<para>
These functions allow you to use the CrackLib library to test the
'strength' of a password. The 'strength' of a password is tested by that
checks length, use of upper and lower case and checked against the
specified CrackLib dictionary. CrackLib will also give helpful diagnostic
messages that will help 'strengthen' the password.
</para>
</section>
<section id="crack.requirements">
<title>Requirements</title>
&reftitle.required;
<para>
More information regarding CrackLib along with the library can be found at
<ulink url="&url.crack;">&url.crack;</ulink>.
@ -22,7 +25,7 @@
</section>
<section id="crack.installation">
<title>Installation</title>
&reftitle.install;
<para>
In order to use these functions, you must compile PHP with Crack support
by using the <option role="configure">--with-crack[=DIR]</option> option.
@ -30,22 +33,22 @@
</section>
<section id="crack.configuration">
<title>Runtime Configuration</title>
&no.config;
&reftitle.runtime;
&no.config;
</section>
<section id="crack.resources">
<title>Resource types</title>
&no.resource;
&reftitle.resources;
&no.resource;
</section>
<section id="crack.constants">
<title>Predefined constants</title>
&no.constants;
&reftitle.constants;
&no.constants;
</section>
<section id="crack.examples">
<title>Example</title>
&reftitle.examples;
<para>
This example shows how to open a CrackLib dictionary, test a given
password, retrieve any diagnostic messages, and close the dictionary.

View file

@ -1,32 +1,35 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<reference id="ref.ctype">
<title>Character type functions</title>
<titleabbrev>ctype</titleabbrev>
<partintro>
<para id="ctype.intro">
The functions provided by this extension check whether a character
or string falls into a certain character class according to the
current locale (see also <function>setlocale</function>).
</para>
<para>
When called with an integer argument these functions
behave exactly like their C counterparts from "ctype.h".
</para>
<para>
When called with a string argument they will check
every character in the string and will only return
&true; if every character in the string matches the
requested criteria.
</para>
<para>
Passing anything else but a string or integer will
return &false; immediately.
</para>
<section id="ctype.intro">
&reftitle.intro;
<para>
The functions provided by this extension check whether a character
or string falls into a certain character class according to the
current locale (see also <function>setlocale</function>).
</para>
<para>
When called with an integer argument these functions
behave exactly like their C counterparts from "ctype.h".
</para>
<para>
When called with a string argument they will check
every character in the string and will only return
&true; if every character in the string matches the
requested criteria.
</para>
<para>
Passing anything else but a string or integer will
return &false; immediately.
</para>
</section>
<section id="ctype.requirements">
<title>Requirements</title>
&reftitle.required;
<para>
None besides functions from the standard C library which are
always available.
@ -34,7 +37,7 @@
</section>
<section id="ctype.installation">
<title>Installation</title>
&reftitle.install;
<para>
Beginning with PHP 4.2.0 these functions are enabled by default.
For older versions you have to configure and compile PHP
@ -43,18 +46,18 @@
</section>
<section id="ctype.configuration">
<title>Runtime Configuration</title>
&no.config;
&reftitle.runtime;
&no.config;
</section>
<section id="ctype.resources">
<title>Resource types</title>
&no.resource;
&reftitle.resources;
&no.resource;
</section>
<section id="ctype.constants">
<title>Predefined constants</title>
&no.constants;
&reftitle.constants;
&no.constants;
</section>
</partintro>

View file

@ -1,50 +1,66 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<reference id="ref.curl">
<title>CURL, Client URL Library Functions</title>
<titleabbrev>CURL</titleabbrev>
<partintro id="curl.partintro">
<para>
PHP supports libcurl, a library created by Daniel Stenberg, that
allows you to connect and communicate to many different types of
servers with many different types of protocols. libcurl currently
supports the http, https, ftp, gopher, telnet, dict, file, and
ldap protocols. libcurl also supports HTTPS certificates, HTTP
POST, HTTP PUT, FTP uploading (this can also be done with PHP's
ftp extension), HTTP form based upload, proxies, cookies, and
user+password authentication.
</para>
<para>
In order to use the CURL functions you need to install the <ulink
url="&url.curl;">CURL</ulink> package. PHP requires that you use
CURL 7.0.2-beta or higher. PHP will not work with any version of
CURL below version 7.0.2-beta.
</para>
<para>
To use PHP's CURL support you must also compile PHP <option
role="configure">--with-curl[=DIR]</option> where DIR is the
location of the directory containing the lib and include
directories. In the "include" directory there should be a folder
named "curl" which should contain the easy.h and curl.h files.
There should be a file named "libcurl.a" located in the "lib"
directory.
</para>
<para>
These functions have been added in PHP 4.0.2.
</para>
<para>
Once you've compiled PHP with CURL support, you can begin using
the curl functions. The basic idea behind the CURL functions is
that you initialize a CURL session using the
<function>curl_init</function>, then you can set all your
options for the transfer via the <function>curl_exec</function>
and then you finish off your session using the
<function>curl_close</function>. Here is an example that uses
the CURL functions to fetch the PHP homepage into a file:
<example>
<title>Using PHP's CURL module to fetch the PHP homepage</title>
<programlisting role="php">
<partintro>
<section id="curl.intro">
&reftitle.intro;
<para>
PHP supports libcurl, a library created by Daniel Stenberg, that
allows you to connect and communicate to many different types of
servers with many different types of protocols. libcurl currently
supports the http, https, ftp, gopher, telnet, dict, file, and
ldap protocols. libcurl also supports HTTPS certificates, HTTP
POST, HTTP PUT, FTP uploading (this can also be done with PHP's
ftp extension), HTTP form based upload, proxies, cookies, and
user+password authentication.
</para>
<para>
These functions have been added in PHP 4.0.2.
</para>
</section>
<section id="curl.requirements">
&reftitle.required;
<para>
In order to use the CURL functions you need to install the <ulink
url="&url.curl;">CURL</ulink> package. PHP requires that you use
CURL 7.0.2-beta or higher. PHP will not work with any version of
CURL below version 7.0.2-beta.
</para>
</section>
<section id="curl.installation">
&reftitle.install;
<para>
To use PHP's CURL support you must also compile PHP <option
role="configure">--with-curl[=DIR]</option> where DIR is the
location of the directory containing the lib and include
directories. In the "include" directory there should be a folder
named "curl" which should contain the easy.h and curl.h files.
There should be a file named "libcurl.a" located in the "lib"
directory.
</para>
</section>
&reference.curl.constants;
<section id="curl.examples">
&reftitle.examples;
<para>
Once you've compiled PHP with CURL support, you can begin using
the curl functions. The basic idea behind the CURL functions is
that you initialize a CURL session using the
<function>curl_init</function>, then you can set all your
options for the transfer via the <function>curl_exec</function>
and then you finish off your session using the
<function>curl_close</function>. Here is an example that uses
the CURL functions to fetch the example.com homepage into a file:
<example>
<title>Using PHP's CURL module to fetch the example.com homepage</title>
<programlisting role="php">
<![CDATA[
<?php
@ -59,9 +75,10 @@ curl_close ($ch);
fclose ($fp);
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</para>
</section>
</partintro>
&reference.curl.functions;

View file

@ -1,16 +1,18 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<reference id="ref.cybercash">
<title>Cybercash payment functions</title>
<titleabbrev>Cybercash</titleabbrev>
<partintro>
<simpara>
These functions are only available if the interpreter has been
compiled with the <option
role="configure">--with-cybercash=[DIR]</option>. These functions
have been added in PHP 4.
</simpara>
<section id="cybercash.installation">
&reftitle.install;
<para>
These functions are only available if the interpreter has been
compiled with the <option
role="configure">--with-cybercash=[DIR]</option>.
</para>
</section>
</partintro>
&reference.cybercash.functions;

View file

@ -1,45 +1,53 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<reference id="ref.cybermut">
<title>Cr&eacute;dit Mutuel CyberMUT functions</title>
<titleabbrev>CyberMUT</titleabbrev>
<partintro>
<simpara>
This extension allows you to process credit cards transactions using Cr&eacute;dit
Mutuel CyberMUT system (<ulink url="&url.cybermut;">&url.cybermut;</ulink>).
</simpara>
<simpara>
CyberMUT is a popular Web Payment Service in France, provided by the
Cr&eacute;dit Mutuel bank. If you are foreign in France, these functions will not
be useful for you.
</simpara>
<simpara>
These functions are only available if PHP has been compiled with the
<link linkend="install.configure.with-cybermut"><option role="configure">
--with-cybermut[=DIR]</option></link>
option, where DIR is the location of <filename>libcm-mac.a</filename>
and <filename>cm-mac.h</filename>.
You will require the appropriate SDK for your platform, which
may be sent to you after your CyberMUT's subscription (contact
them via Web, or go to the nearest Cr&eacute;dit Mutuel).
</simpara>
<simpara>
The use of these functions is almost identical to the original functions,
except for the parameters of return for <function>cybermut_creerformulairecm</function>
and <function>cybermut_creerreponsecm</function>,
which are returned directly by functions PHP, whereas they had passed in
reference in the original functions.
</simpara>
<simpara>
These functions have been added in PHP 4.0.6.
</simpara>
<note>
<section id="cybermut.intro">
&reftitle.intro;
<para>
These functions only provide a link to CyberMUT SDK. Be sure to read the
CyberMUT Developers Guide for full details of the required parameters.
This extension allows you to process credit cards transactions using Cr&eacute;dit
Mutuel CyberMUT system (<ulink url="&url.cybermut;">&url.cybermut;</ulink>).
</para>
<para>
CyberMUT is a popular Web Payment Service in France, provided by the
Cr&eacute;dit Mutuel bank. If you are foreign in France, these functions will not
be useful for you.
</para>
</note>
<simpara>
The use of these functions is almost identical to the original SDK functions,
except for the parameters of return for <function>cybermut_creerformulairecm</function>
and <function>cybermut_creerreponsecm</function>,
which are returned directly by functions PHP, whereas they had passed in
reference in the original functions.
</simpara>
<simpara>
These functions have been added in PHP 4.0.6.
</simpara>
<note>
<para>
These functions only provide a link to CyberMUT SDK. Be sure to read the
CyberMUT Developers Guide for full details of the required parameters.
</para>
</note>
</section>
<section id="cybermut.installation">
&reftitle.install;
<para>
These functions are only available if PHP has been compiled with the
<link linkend="install.configure.with-cybermut"><option role="configure">
--with-cybermut[=DIR]</option></link>
option, where DIR is the location of <filename>libcm-mac.a</filename>
and <filename>cm-mac.h</filename>.
You will require the appropriate SDK for your platform, which
may be sent to you after your CyberMUT's subscription (contact
them via Web, or go to the nearest Cr&eacute;dit Mutuel).
</para>
</section>
</partintro>
&reference.cybermut.functions;