cvs: phpdoc-fi / bookinfo.xml language-defs.ent language-snippets.ent preface.xml translation.xml /features cookies.xml http-auth.xml
[email protected] ("Henry Karpatskij") Fri, 19 Mar 2004 16:53:59 -0000
| Newsgroups | php.doc.fi |
|---|---|
| Message-ID | <cvsspheroid1079715239@cvsserver> |
spheroid Fri Mar 19 11:53:59 2004 EDT
Added files:
/phpdoc-fi/features cookies.xml http-auth.xml
Modified files:
/phpdoc-fi bookinfo.xml language-defs.ent language-snippets.ent
preface.xml translation.xml
Log:
Updated the root dir files to match the english ones. Also added new translations under features section.
spheroid-20040319115359.txt
(text/plain, 38.9 KB)
http://cvs.php.net/diff.php/phpdoc-fi/bookinfo.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc-fi/bookinfo.xml
diff -u phpdoc-fi/bookinfo.xml:1.2 phpdoc-fi/bookinfo.xml:1.3
--- phpdoc-fi/bookinfo.xml:1.2 Wed Mar 27 19:39:22 2002
+++ phpdoc-fi/bookinfo.xml Fri Mar 19 11:52:42 2004
@@ -1,40 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.26 Maintainer: sniper Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.36 Maintainer: sniper Status: ready -->
<bookinfo id="bookinfo">
+ <title>&PHPManual;</title>
<authorgroup id="authors">
<author>
<firstname>Stig</firstname><surname>Sæther Bakken</surname>
+ <!-- email: ssb%40php.net -->
</author>
<author>
<firstname>Alexander</firstname><surname>Aulbach</surname>
+ <!-- email: ssilk%40ssilk.de [no cvs user listed at master.php.net!] -->
</author>
<author>
<firstname>Egon</firstname><surname>Schmid</surname>
+ <!-- email: eschmid%40php.net -->
</author>
<author>
<firstname>Jim</firstname><surname>Winstead</surname>
+ <!-- email: jimw%40php.net -->
</author>
<author>
<firstname>Lars Torben</firstname><surname>Wilson</surname>
+ <!-- email: torben%40php.net -->
</author>
<author>
<firstname>Rasmus</firstname><surname>Lerdorf</surname>
+ <!-- email: rasmus%40php.net -->
</author>
<author>
<firstname>Andrei</firstname><surname>Zmievski</surname>
+ <!-- email: andrei%40php.net -->
</author>
<author>
<firstname>Jouni</firstname><surname>Ahto</surname>
+ <!-- email: jah%40php.net -->
</author>
</authorgroup>
@@ -54,21 +63,34 @@
<year>2000</year>
<year>2001</year>
<year>2002</year>
+ <year>2003</year>
+ <year>2004</year>
<holder>the PHP Documentation Group</holder>
</copyright>
<legalnotice id="copyright">
<title>Copyright</title>
<simpara>
- This manual is © Copyright 1997, 1998, 1999, 2000, 2001, 2002 by
- the PHP Documentation Group. The members of this group are listed
- on the front page of this manual.
+ Copyright © 1997 - 2004 by the PHP Documentation Group.
+ This material may be distributed only subject to the terms and
+ conditions set forth in the Open Publication License, v1.0 or
+ later (the latest version is presently available at
+ <ulink url="&url.opl;">&url.opl;</ulink>).
+ </simpara>
+ <simpara>
+ Distribution of substantively modified versions of this document
+ is prohibited without the explicit permission of the copyright
+ holder.
+ </simpara>
+ <simpara>
+ Distribution of the work or derivative of the work in any
+ standard (paper) book form is prohibited unless prior permission
+ is obtained from the copyright holder.
</simpara>
<simpara>
- This manual can be redistributed under the terms of the GNU
- General Public License as published by the Free Software
- Foundation; either version 2 of the License, or (at your option)
- any later version.
+ The members of the PHP Documentation Group are listed on the front
+ page of this manual. In case you would like to contact the group,
+ please write to <ulink url="mailto:&email.php.doc;">&email.php.doc;</ulink>.
</simpara>
<simpara>
The 'Extending PHP 4.0' section of this manual is copyright © 2000 by
@@ -77,6 +99,10 @@
or later (the latest version is presently available at
<ulink url="&url.opl;">&url.opl;</ulink>).
</simpara>
+ <para>
+ A copy of the <link linkend="opl.license">Open Publication License</link>
+ is distributed with this manual.
+ </para>
</legalnotice>
</bookinfo>
http://cvs.php.net/diff.php/phpdoc-fi/language-defs.ent?r1=1.5&r2=1.6&ty=u
Index: phpdoc-fi/language-defs.ent
diff -u phpdoc-fi/language-defs.ent:1.5 phpdoc-fi/language-defs.ent:1.6
--- phpdoc-fi/language-defs.ent:1.5 Mon Nov 25 00:53:51 2002
+++ phpdoc-fi/language-defs.ent Fri Mar 19 11:52:42 2004
@@ -1,5 +1,5 @@
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.13 Maintainer: sniper Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.15 Maintainer: sniper Status: ready -->
<!ENTITY PHPManual "PHP Käsikirja">
<!ENTITY Date "Päiväys:">
@@ -7,11 +7,14 @@
<!ENTITY Installation "Asentaminen">
<!ENTITY LanguageReference "Syntaksi">
<!ENTITY Features "Ominaisuudet">
+<!ENTITY Security "Tietoturva">
<!ENTITY FunctionReference "Funktiot">
<!ENTITY Appendixes "Liitteet">
<!ENTITY PEAR "PEAR: PHP Extension and Application Repository">
<!ENTITY FAQ "UKK: Usein Kysyttyjä Kysymyksiä">
<!ENTITY FAQabbrev "UKK">
+<!ENTITY api "PHP API: Rajapinnat laajennusten tekijöille">
+<!ENTITY apiabbrev "PHP API">
<!ENTITY FunctionIndex "Funktioluettelo">
<!ENTITY CHMEdition "HTML Help Edition">
<!ENTITY ReservedConstants "Ennalta määritellyt vakiot">
http://cvs.php.net/diff.php/phpdoc-fi/language-snippets.ent?r1=1.9&r2=1.10&ty=u
Index: phpdoc-fi/language-snippets.ent
diff -u phpdoc-fi/language-snippets.ent:1.9 phpdoc-fi/language-snippets.ent:1.10
--- phpdoc-fi/language-snippets.ent:1.9 Tue Nov 26 01:49:55 2002
+++ phpdoc-fi/language-snippets.ent Fri Mar 19 11:52:42 2004
@@ -1,54 +1,116 @@
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.22 Maintainer: sniper Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.78 Maintainer: sniper Status: ready -->
-<!ENTITY warn.experimental '<warning><simpara>Varoitus!
-Tämä laajennus on <emphasis>EKSPERIMENTAALINEN</emphasis>.
-Tämän laajennuksen ominaisuudet, käyttäytyminen ja funktioiden
-nimet ja parametrit voivat muuttua varoituksetta seuraavissa
-PHP versioissa.
-</simpara></warning>'>
-
-<!ENTITY warn.experimental.func '<warning><simpara>Varoitus!
-Tämä funktio on <emphasis>EKSPERIMENTAALINEN</emphasis>.
-Tämän funktion ominaisuudet, käyttäytyminen, parametrit ja nimi
-voi muuttua varoituksetta seuraavissa PHP versioissa.
-</simpara></warning>'>
-
-<!ENTITY warn.undocumented.func '<warning><simpara>Tämä on
-toistaiseksi dokumentoimaton funktio; ainoastaan parametrilistaus
-on saatavilla.</simpara></warning>'>
-
-<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>The Windows
-version of <literal>PHP</literal> currently does not support remote
-file accessing for this function, even if
+<!ENTITY warn.experimental '<warning><simpara>Varoitus! Tämä laajennus on
+<emphasis>EKSPERIMENTAALINEN</emphasis>. Tämän laajennuksen ominaisuudet,
+käyttäytyminen sekä funktioiden nimet ja parametrit voivat muuttua
+varoituksetta seuraavissa PHP:n versioissa.</simpara></warning>'>
+
+<!ENTITY warn.experimental.func '<warning><simpara>Varoitus! Tämä funktio on
+<emphasis>EKSPERIMENTAALINEN</emphasis>. Tämän funktion ominaisuudet,
+käyttäytyminen, parametrit ja nimi voi muuttua varoituksetta seuraavissa PHP:n
+versioissa.</simpara></warning>'>
+
+<!ENTITY warn.undocumented.func '<warning><simpara>Tämä on toistaiseksi
+dokumentoimaton funktio; ainoastaan parametrilistaus on
+saatavilla.</simpara></warning>'>
+
+<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>Windows
+versions of <literal>PHP</literal> prior to PHP 4.3.0 do not
+support accessing remote files via this function, even if
<link linkend="ini.allow-url-fopen">allow_url_fopen</link> is enabled.
</para></warning>'>
-<!ENTITY tip.ob-capture '<tip><simpara>Tämän funktion tulosteen
-saa kaapattua ja tallennettua <link linkend="ref.outcontrol">
-tulostus-hallinta funktioilla</link> esimerkiksi <type>string</type>
-muuttujaan.</simpara></tip>'>
-
-<!ENTITY tip.fopen-wrapper '<tip><simpara>Tämän funktion kanssa voit
-käyttää myös URLia tiedostonimen sijaan jos "fopen wrappers" on kytketty
-päälle. Katso myös <function>fopen</function>.</simpara></tip>'>
-
-<!ENTITY return.success 'Palauttaa &true; jos onnistui, &false; jos epäonnistui.'>
+<!ENTITY warn.ssl-non-standard '<warning><para>Some non-standard compliant
+webservers, such as IIS, send data in a way that causes PHP to raise warnings.
+When working with such servers you should lower your <link linkend="ini.error-reporting">
+error_reporting</link> level not to include warnings.</para></warning>'>
+
+<!ENTITY note.no-remote '<note><simpara>This function will not work on
+<link linkend="features.remote-files">remote files</link> as the file to
+be examined must be accessible via the servers filesystem.</simpara></note>'>
+
+<!ENTITY tip.ob-capture '<tip><simpara>Tämän funktion tulosteen saa kaapattua
+ja tallennettua <link
+linkend="ref.outcontrol">tulostushallintafunktioilla</link> esimerkiksi
+<type>string</type>-tyyppiseen muuttujaan.</simpara></tip>'>
+
+<!ENTITY tip.fopen-wrapper '<tip><simpara>Tämän funktion kanssa voit käyttää
+myös URLia tiedostonimen sijaan jos "fopen wrappers" on kytketty päälle. Katso
+funktiosta <function>fopen</function> lisätietoa tuetuista URL-protokollista
+ja siitä kuinka tiedoston nimi määritellään <xref
+linkend="wrappers"/>.</simpara></tip>'>
+
+<!ENTITY tip.fopen-wrapper.stat '<tip><simpara>As of
+<literal>PHP 5.0.0</literal> this function can also be used with
+<emphasis>some</emphasis> URL wrappers. Refer to
+<xref linkend="wrappers"/> for a listing of which wrappers support
+<function>stat</function> family of functionality.</simpara></tip>'>
+
+<!ENTITY return.success 'Palauttaa &true; onnistuessaan, muutoin &false;.'>
+
+<!ENTITY array.resetspointer '<note><simpara>This function will
+<function>reset</function> the <type>array</type> pointer after
+use.</simpara></note>'>
+
+<!ENTITY note.clearstatcache '<note><simpara>The results of this
+function are cached. See <function>clearstatcache</function> for
+more details.</simpara></note>'>
<!ENTITY return.falseproblem '<warning><simpara>Tämä funktio voi palauttaa
Boolean-arvon &false;, mutta voi myös palauttaa ei-Boolean-arvon joka
-evaluoituu arvoksi &false;, kuten <literal>0</literal> tai "".
-Lisätietoja <link linkend="language.types.boolean">Boolean-arvot</link>
-kappaleesta. Käytä paluuarvon testaukseen
-<link linkend="language.operators.comparison">=== operaattoria</link>.
-</simpara></warning>'>
+evaluoituu arvoksi &false;, kuten <literal>0</literal> tai "".
+Lisätietoja <link linkend="language.types.boolean">Boolean-arvot</link>
+kappaleesta. Käytä paluuarvon testaukseen <link
+linkend="language.operators.comparison">operaattoria
+===</link>.</simpara></warning>'>
+
+<!ENTITY warn.imaprecodeyaz '<warning><simpara>The <link
+linkend="ref.imap">IMAP</link> extension cannot be used in conjuction with
+the <link linkend="ref.recode">recode</link> or <link
+linkend="ref.yaz">YAZ</link> extensions. This is due to the fact that they
+both share the same internal symbol.</simpara></warning>'>
+
+<!ENTITY note.registerglobals '<note><title>register_globals: important
+note</title><para>Since PHP 4.2.0, the default value for the PHP directive
+<link linkend="ini.register-globals">register_globals</link> is <emphasis>
+off</emphasis>. The PHP community encourages all to not rely on this
+directive but instead use other means, such as the &link.superglobals;.
+</para></note>'>
+
+<!ENTITY note.superglobals '<note><title>Superglobals: availability note
+</title><para>Since PHP 4.1.0, superglobal arrays such as <varname>$_GET
+</varname>, <varname>$_POST</varname>, and <varname>$_SERVER</varname>,
+etc. have been available. For more information, read the manual section
+on &link.superglobals;</para></note>'>
+
+<!ENTITY avail.register-long-arrays 'As of PHP 5.0.0, the long PHP
+<link linkend="language.variables.predefined">predefined variable</link>
+arrays may be disabled with the
+<link linkend="ini.register-long-arrays">register_long_arrays</link>
+directive.'>
+
+<!ENTITY note.magicquotes.gpc '<note><title>directive note: magic_quotes_gpc
+</title><para>The PHP directive <link linkend="ini.magic-quotes-gpc">
+magic_quotes_gpc</link> defaults to <literal>on</literal>. It essentially
+runs <function>addslashes</function> on all your GET, POST, and COOKIE data.
+You may use <function>stripslashes</function> to strip them.</para></note>'>
+
+<!ENTITY note.config.t1lib '<note><simpara>This function is only available
+if PHP is compiled using <option role="configure">--enable-t1lib</option>.
+</simpara></note>'>
<!-- Various notes -->
-<!ENTITY note.not-bin-safe '<warning><simpara>Tämä funktio ei (vielä)
-osaa käsitellä binäärimuotoista dataa! (esim. kuvia)</simpara></warning>'>
+<!ENTITY note.randomseed '<note><simpara>As of PHP 4.2.0, there is no need
+to seed the random number generator with <function>srand</function> or
+<function>mt_srand</function> as this is now done automatically.
+</simpara></note>'>
+
+<!ENTITY note.not-bin-safe '<warning><simpara>Tämä funktio ei (vielä) osaa
+käsitellä binäärimuotoista dataa!</simpara></warning>'>
-<!ENTITY note.bin-safe '<note><simpara>Tämä funktio osaa käsitellä
-myös binäärimuotoista dataa. (esim. kuvia)</simpara></note>'>
+<!ENTITY note.bin-safe '<note><simpara>Tämä funktio osaa käsitellä myös
+binäärimuotoista dataa.</simpara></note>'>
<!ENTITY note.line-endings '<note><simpara>If you are having problems
with <literal>PHP</literal> not recognizing the line endings when
@@ -57,50 +119,84 @@
>auto_detect_line_endings</link> run-time configuration option.</simpara>
</note>'>
-<!ENTITY note.no-windows '<note><simpara>Tätä funktiota ei löydy
-Windows-alustalla.</simpara></note>'>
+<!ENTITY note.no-windows '<note><simpara>Tätä funktiota ei ole vielä
+implementoitu Windows-alustalle.</simpara></note>'>
<!ENTITY note.no-windows.extension '<note><simpara>This extension is not
available on Windows platforms.</simpara></note>'>
-<!ENTITY note.func-callback '<note><simpara>Pelkän funktion nimen sijaan
-voi myös käyttää taulukkoa, joka sisältää objekti-referenssin ja metodin
-nimen.</simpara></note>'>
+<!ENTITY note.func-callback '<note><simpara>Pelkän funktion nimen sijasta
+voidaan myös käyttää taulukkoa, joka sisältää viittauksen haluttuun objektiin
+ja kutsuttavan metodin nimen.</simpara></note>'>
+
+<!ENTITY warn.escapeshell '<warning><para>If you are going to allow data coming
+from user input to be passed to this function, then you should be using
+<function>escapeshellarg</function> or <function>escapeshellcmd</function>
+to make sure that users cannot trick the system into executing arbitrary
+commands.</para></warning>'>
+
+<!ENTITY note.exec-bg '<note><para>If you start a program using this function
+and want to leave it running in the background, you have to make sure that the
+output of that program is redirected to a file or some other output stream or
+else PHP will hang until the execution of the program ends.</para></note>'>
<!-- Notes for safe-mode limited functions: -->
<!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'>
-<!ENTITY note.sm.uidcheck '<note><simpara>Kun <link
-linkend="features.safe-mode">safe mode</link> on käytössä, PHP tarkistaa
-onko käsiteltävien tiedostojen/hakemistojen UID sama kuin ajettavalla
+<!ENTITY note.sm.uidcheck '<note><simpara>Kun <link
+linkend="features.safe-mode">safe mode</link> on käytössä, PHP tarkistaa onko
+käsiteltävien tiedostojen/hakemistojen UID sama kuin ajettavalla
skriptillä.</simpara></note>'>
-<!ENTITY note.sm.uidcheck.dir '<note><simpara>Kun <link
-linkend="features.safe-mode">safe mode</link> on käytössä, PHP tarkistaa
-onko hakemistolla, jossa operoidaan, sama UID kuin ajettavalla skriptillä.
-</simpara></note>'>
+<!ENTITY note.sm.uidcheck.dir '<note><simpara>Kun <link
+linkend="features.safe-mode">safe mode</link> on käytössä, PHP tarkistaa onko
+hakemistolla, jossa operoidaan, sama UID kuin ajettavalla
+skriptillä.</simpara></note>'>
-<!-- Common pieces in features/safe-mode.xml
- Jade doesn't allow in-line entities, so I put them here... Though they
+<!ENTITY note.language-construct '<note><simpara>Because this is a
+language construct and not a function, it cannot be called using
+<link linkend="functions.variable-functions">variable functions</link></simpara>
+</note>'>
+
+<!-- Common pieces in features/safe-mode.xml
+ Jade doesn't allow in-line entities, so I put them here... Though they
should have been inline in safe-mode.xml -->
<!ENTITY sm.uidcheck 'Tarkistaa onko käsiteltävillä tiedostoilla/hakemistoilla
sama UID kuin ajettavalla skriptillä.'>
+<!ENTITY warn.sm.exec '<warning><simpara>With <link linkend="features.safe-mode">safe mode</link> enabled,
+all words following the initial command string are treated as a single argument. Thus,
+<literal>echo y | echo x</literal> becomes <literal>echo "y | echo x"</literal>.</simpara></warning>'>
+
+<!ENTITY note.exec-path '<note><simpara>When
+<link linkend="features.safe-mode">safe mode</link> is enabled, you can only
+execute executables within the <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>.
+For practical reasons it is currently not allowed to have <literal>..</literal>
+components in the path to the executable. </simpara></note>'>
+
<!ENTITY sm.uidcheck.dir 'Tarkistaa onko hakemistolla, jossa operoidaan, sama
UID kuin ajettavalla skriptillä.'>
-<!ENTITY sm.disabled 'Tämä funktio ei ole käytössä jos <link
+<!ENTITY sm.disabled 'Tämä funktio ei ole käytössä jos <link
linkend="features.safe-mode">safe mode</link> on kytketty päälle.'>
<!-- Common pieces in partintro-sections -->
-<!ENTITY no.config '<para>Tämä laajennus ei määrittele yhtäkään konfigurointi
-asetusta.</para>'>
-<!ENTITY no.resource '<para>Tämä laajennus ei määrittele yhtäkään resurssi-tyyppiä.</para>'>
-<!ENTITY no.constants '<para>Tämä laajennus ei määrittele yhtäkään vakiota.</para>'>
-<!ENTITY no.requirement '<para>These functions are available as part of the
-standard module, which is always available.</para>'>
-<!ENTITY no.install '<para>There is no installation needed to use these
-functions, they are part of the PHP core.</para>'>
+<!ENTITY no.config '<para>Tämä laajennus ei määrittele yhtäkään direktiiviä
+&php.ini;ssä.</para>'>
+<!ENTITY no.resource '<para>Tämä laajennus ei määrittele yhtäkään
+resurssityyppiä.</para>'>
+<!ENTITY no.constants '<para>Tämä laajennus ei määrittele yhtäkään uutta
+vakiota.</para>'>
+<!ENTITY no.requirement '<para>Tämän laajennuksen asentaminen ei vaadi
+ylimääräisiä ohjelmakirjastoja.</para>'>
+<!ENTITY no.install '<para>Näiden funktioiden käyttö ei vaadi erillisten
+ohjelmien asentamista; ne toimitetaan PHP:n mukana.</para>'>
+
+<!-- Used in every chapter that has directive descriptions -->
+<!ENTITY ini.descriptions.title '<para>Here's a short explanation of
+the configuration directives.</para>'>
+
+<!-- Common pieces for reference part BEGIN-->
<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara>
@@ -109,36 +205,94 @@
<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara>
-These constants are defined by this extension, and
+The constants below are defined by this extension, and
will only be available when the extension has either
been compiled into PHP or dynamically loaded at runtime.
</simpara>'>
<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara>
-The constants listed here are always available as part of the PHP core.
+The constants below are always available as part of the PHP core.
</simpara>'>
<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara>
-These classes are defined by this extension, and
+The classes below are defined by this extension, and
will only be available when the extension has either
been compiled into PHP or dynamically loaded at runtime.
</simpara>'>
+<!-- These are using in reference/$extname/reference.xml and other
+supplemental files to mark section titles -->
+<!ENTITY reftitle.intro '<title>Introduction</title>'>
+<!ENTITY reftitle.required '<title>Requirements</title>'>
+<!ENTITY reftitle.install '<title>Installation</title>'>
+<!ENTITY reftitle.runtime '<title>Runtime Configuration</title>'>
+<!ENTITY reftitle.resources '<title>Resource Types</title>'>
+<!ENTITY reftitle.constants '<title>Predefined Constants</title>'>
+<!ENTITY reftitle.classes '<title>Predefined Classes</title>'>
+<!ENTITY reftitle.constructor '<title>Constructor</title>'>
+<!ENTITY reftitle.methods '<title>Methods</title>'>
+<!ENTITY reftitle.properties '<title>Properties</title>'>
+<!ENTITY reftitle.returnvalues '<title>Return values</title>'>
+<!ENTITY reftitle.examples '<title>Examples</title>'>
+<!ENTITY reftitle.seealso '<title>See Also</title>'>
+
+<!ENTITY note.pecl-php5 '<note><simpara>
+This extension has been removed as of PHP 5 and moved to the
+<ulink url="&url.pecl;">PECL</ulink> repository.
+</simpara></note>'>
+
+<!-- Common pieces for reference part END -->
+
+
<!ENTITY windows.builtin '<simpara> The windows version of <literal>PHP</literal>
has built in support for this extension. You do not need to load any additional
extension in order to use these functions.</simpara>'>
-
-<!-- These are using in reference/$extname/reference.xml and other
-supplemental files to mark section titles -->
-<!ENTITY reftitle.intro '<title>Introduction</title>'>
-<!ENTITY reftitle.required '<title>Requirements</title>'>
-<!ENTITY reftitle.install '<title>Installation</title>'>
-<!ENTITY reftitle.runtime '<title>Runtime Configuration</title>'>
-<!ENTITY reftitle.resources '<title>Resource Types</title>'>
-<!ENTITY reftitle.constants '<title>Predefined Constants</title>'>
-<!ENTITY reftitle.classes '<title>Predefined Classes</title>'>
-<!ENTITY reftitle.examples '<title>Examples</title>'>
-<!ENTITY reftitle.seealso '<title>See Also</title>'>
+<!-- These are here as helpers for manual consistency and brievety-->
+<!ENTITY php '<literal>PHP</literal>'>
+<!ENTITY safemode '<link linkend="ini.safe-mode">safe mode</link>'>
+
+<!-- SimpleXML Notes -->
+<!ENTITY simplexml.iteration '<note><simpara>SimpleXML has made a rule of adding iterative properties to most methods. They cannot be viewed using <function>var_dump</function> or anything else which can examine objects.</simpara></note>'>
+
+<!-- Database Notes -->
+<!ENTITY database.field-case '<note><simpara>Field names returned by this function
+are <emphasis>case-sensitive</emphasis>.</simpara></note>'>
+
+<!-- Sybase Notes -->
+<!ENTITY sybase.ct.only '<note><simpara>This function is only available using the CT library interface to Sybase, and not the DB library.</simpara></note>'>
+
+<!-- Some MySQL Notes -->
+<!ENTITY mysql.field-case '<note><simpara>Field names returned by this function
+are <emphasis>case-sensitive</emphasis></simpara></note>'>
+
+<!-- CPDF Unit length -->
+<!ENTITY cpdf.ul '<para>The optional parameter <parameter>mode</parameter> determines the unit length. If it is 0 or omitted the default unit as specified for the page is used. Otherwise the coordinates are measured in postscript points disregarding the current unit.</para>'>
+
+<!-- Notes for IPv6 -->
+<!ENTITY ipv6.brackets '<note><simpara>When specifying a numerical IPv6 address
+(e.g. fe80::1) you must enclose the IP in square brackets. For example,
+<literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>
+
+<!ENTITY ipv6.php5 '<note><simpara>IPv6 Support was added with <literal>PHP
+5.0.0 </literal>.</simpara></note>'>
+
+<!-- Notes for tidy -->
+<!ENTITY note.tidy.ze2 '<note><simpara> This function is only available with Zend Engine 2, this means PHP
+>= 5.0.0.</simpara></note>'>
+
+<!ENTITY note.tidy.1only '<note><simpara>This function is only avaliable in
+Tidy 1.0. It became obsolete in Tidy 2.0 and thus has been removed.</simpara></note>'>
+
+<!ENTITY note.tidy.2only '<note><simpara>The optional parameters
+<literal>config</literal> and <literal>encoding</literal> were
+added in Tidy 2.0.</simpara></note>'>
+
+<!ENTITY tidy.conf-enc '<para>The <parameter>config</parameter> parameter can be passed either as an array
+or as a string. If you pass it as a string, it means the name of the configuration file, otherwise
+it is interpreted as the options themselves. Check <ulink url="&url.tidy.conf;">&url.tidy.conf;</ulink>
+for an explanation about each option.</para><para>The <parameter>encoding</parameter> parameter sets the
+encoding for input/output documents. The possible values for <parameter>encoding</parameter> are:
+ascii, latin0, latin1, raw, utf8, iso202, utf16le, utf16be, utf16, mac, win1252, ibm858, big5 and shiftjis.</para>'>
http://cvs.php.net/diff.php/phpdoc-fi/preface.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-fi/preface.xml
diff -u phpdoc-fi/preface.xml:1.4 phpdoc-fi/preface.xml:1.5
--- phpdoc-fi/preface.xml:1.4 Fri Apr 5 08:18:35 2002
+++ phpdoc-fi/preface.xml Fri Mar 19 11:52:42 2004
@@ -1,31 +1,40 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.25 Maintainer: sniper Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.27 Maintainer: spheroid Status: ready -->
<preface id="preface">
<title>Esipuhe</title>
<abstract>
<simpara>
- <acronym>PHP</acronym> eli "PHP: Hypertext Preprocessor" on
- suosittu yleiskäyttöinen skriptikieli, joka sopii erityisesti
- Web-sovelluskehitykseen. Kielen syntaksi muistuttaa C:n, Javan
- ja Perlin syntaksia ja on erittäin helppo oppia. Vaikka PHP onkin
- pääasiassa suunnattu dynaamisten web-sivustojen tekemiseen, sillä
- voi tehdä paljon muutakin.
+ <acronym>PHP</acronym> eli "PHP: Hypertext Preprocessor" on suosittu
+ yleiskäyttöinen skriptikieli, joka sopii erityisesti
+ Web-sovelluskehitykseen, koska se voidaan liittää suoraan HTML:ään.
+ Lisäksi PHP:n lähdekoodi on avointa, eli sitä saa lisenssin sallimissa
+ rajoissa tutkia, muokata ja levittää. Kieli on syntaksiltaan helppo, se
+ pohjautuu suurimmilta osin C:hen, Javaan ja Perliin. Vaikka PHP onkin
+ pääasiassa suunnattu dynaamisten web-sivustojen tekemiseen, sillä voi
+ tehdä paljon muutakin.
</simpara>
</abstract>
<para>
- Tämä käsikirja sisältää PHP:n syntaksin ja funktioiden kuvaukset,
- sekä muutamien tärkeimpien ominaisuuksien selitykset.
+ Tämä dokumentaatio toimii pääasiallisesti <link
+ linkend="funcref">funktioreferenssinä</link> mutta sisältää myös <link
+ linkend="langref">syntaksikuvauksen</link>, tietoja PHP:n olennaisimmista
+ ominaisuuksesta ja muuta <link linkend="appendixes">täydentävää
+ tietoa</link>.
</para>
<para>
- Voit imuroida tämän käsikirjan useissa eri formaateissa täältä:
- <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
- Lisätietoja näistä formaateista ja niiden luonnista löytyy
- liitteestä <link linkend="about">'Käsikirjan kehitys'</link>.
+ Tämä dokumentaatio on saatavilla eri muodoissa osoitteessa <ulink
+ url="&url.php.doc.downloads;">&url.php.doc.downloads;</ulink>. Lisätietoa
+ tämän dokumentaation kehityksestä löytyy liitteestä <link
+ linkend="about">'Käsikirjan kehitys'</link>.
+ </para>
+
+ <para>
+ Vilkaise myös osiota <link linkend="history">PHP:n historia</link>.
</para>
</preface>
http://cvs.php.net/diff.php/phpdoc-fi/translation.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-fi/translation.xml
diff -u phpdoc-fi/translation.xml:1.4 phpdoc-fi/translation.xml:1.5
--- phpdoc-fi/translation.xml:1.4 Thu Mar 28 06:09:49 2002
+++ phpdoc-fi/translation.xml Fri Mar 19 11:52:43 2004
@@ -4,12 +4,13 @@
<translation>
<intro>
- The Finnish Translation is managed by Jani Taskinen, please mail him for any information at [email protected].
+ The Finnish Translation is managed by Jani Taskinen, please mail him for any
+ information at [email protected].
</intro>
<translators>
- <person name="Jani Taskinen" email="[email protected]" nick="sniper" cvs="yes" />
- <person name="Henry Karpatskij" email="[email protected]" nick="spheroid" cvs="yes" />
+ <person name="Jani Taskinen" email="[email protected]" nick="sniper" cvs="yes" />
+ <person name="Henry Karpatskij" email="[email protected]" nick="spheroid" cvs="yes" />
</translators>
<work-in-progress>
http://cvs.php.net/co.php/phpdoc-fi/features/cookies.xml?r=1.1&p=1
Index: phpdoc-fi/features/cookies.xml
+++ phpdoc-fi/features/cookies.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.16 Maintainer: spheroid Status: ready -->
<chapter id="features.cookies">
<title>Evästeet</title>
<para>
PHP tukee evästeitä sellaisenaan, ilman erillistä konfiguraatiota.
Evästeet ovat mekanismi, jonka avulla voidaan tallentaa tietoa käyttäjän
selaimeen. Tällöin voidaan helposti tunnistaa palaavia käyttäjiä ja
seurata heidän liikkeitä. Evästeitä voidaan asettaa fuktioilla
<function>setcookie</function> ja <function>setrawcookie</function>.
Evästeet ovat osa HTTP-otsikkotietoja, joten evästeet tulee asettaa ennen
kuin mitään tulostetta on lähetetty selaimelle. Tämä rajoitus on sama kuin
funktiolla <function>header</function>. Voit käyttää <link
linkend="ref.outcontrol">tulostuksenhallintafunktioita</link>
viivästyttääksesi skriptin tulostusta siihen asti, kunnes tiedetään
asettaako skripti evästeitä tai muita otsikkotietoja.
</para>
<para>
Asetuksista <literal>register_globals</literal> ja
<literal>variables_order</literal> riippuen, kaikki asiakasohjelman
lähettämät evästetiedot muunnetaan automaattisesti PHP-muuttujaksi, aivan
kuten GET ja POST -muodossa lähetetty tieto. Mikäli yhteen evästeeseen
halutaan liittää useampia arvoja, voidaan siitä tehdä lista lisäämällä
evästeen nimeen merkit <literal>[]</literal>.
</para>
<para>
PHP:n versiosta 4.1.0 lähtien, kaikki asiakasohjelman lähettämät evästeet
asetetaan superglobaaliin listaan <varname>$_COOKIE</varname>.
Aikaisemmissa versioissa ne ovat puolestaan asetettu listaan
<varname>$HTTP_COOKIE_VARS</varname>, mikäli konfiguraatiomuuttuja
<literal>track_vars</literal> on asetettu (tämä muuttuja on ollut
automaattisesti asetettuna versiosta 4.0.3 lähtien).
</para>
<para>
Lisätietoja, kuten esimerkiksi huomautuksia selainkohtaisista bugeista,
löytyy funktioista <function>setcookie</function> ja
<function>setrawcookie</function>.
</para>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/co.php/phpdoc-fi/features/http-auth.xml?r=1.1&p=1
Index: phpdoc-fi/features/http-auth.xml
+++ phpdoc-fi/features/http-auth.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.38 Maintainer: spheroid Status: ready -->
<chapter id="features.http-auth">
<title>PHP ja HTTP-autentikaatio</title>
<simpara>
PHP:n HTTP-autentikaatiotuki on käytettävissä ainoastaan mikäli PHP on
asennettu Apachen moduuliksi, eikä siten ole saatavilla CGI-moduulissa.
Apachen moduulina ajettavassa PHP-skriptissä voidaan
<function>header</function> -funktiolla lähettää Web-selaimelle
autentikaatiopyyntö, jolloin toteutustavasta riippuen selain kysyy
käyttäjältä käyttäjätunnusta ja salasanaa. Kun käyttäjä on saanut
syötettyä nämä tiedot, URL:ia, jossa tämä skripti sijaitsee, kutsutaan
uudelleen. Tällä kertaa <link linkend="reserved.variables">ennalta
määriteltyjen muuttujien</link> <varname>PHP_AUTH_USER</varname>,
<varname>PHP_AUTH_PW</varname> ja <varname>AUTH_TYPE</varname> arvoina on
käyttäjän syöttämät tiedot sekä autentikaatiotyyppi. Nämä muuttujat
löytyvät <link linkend="reserved.variables.server">$_SERVER</link> ja
<varname>$HTTP_SERVER_VARS</varname> -listoista. Vain yksinkertainen
(Basic) autentikaatio on tuettu. Lisätietoja asiasta löytyy funktiosta
<function>header</function>.
</simpara>
<note>
<title>PHP:n versioista</title>
<para>
<link linkend="language.variables.superglobals">Superglobaalit</link>,
kuten <link linkend="reserved.variables.server">$_SERVER</link> tulivat
käyttöön PHP:n versiossa <ulink
url="&url.php.release4.1.0;">4.1.0</ulink>.
<varname>$HTTP_SERVER_VARS</varname> on ollut käytössä PHP 3:sta lähtien.
</para>
</note>
<para>
Seuraavanlaisella skriptinpätkällä voidaan pakottaa asiakas tunnistautumaan
sivulle.
</para>
<para>
<example>
<title>HTTP-autentikaatioesimerkki</title>
<programlisting role="php">
<![CDATA[
<?php
if (!isset($_SERVER['PHP_AUTH_USER'])) {
header('WWW-Authenticate: Basic realm="Suojattu alue"');
header('HTTP/1.0 401 Unauthorized');
echo 'Tämä teksti näytetään käyttäjälle mikäli hän hylkää ' .
'autentikaatiopyynnön.';
exit;
} else {
echo "<p>Päivää, {$_SERVER['PHP_AUTH_USER']}.</p>";
echo "<p>Syötit salasanan {$_SERVER['PHP_AUTH_PW']}.</p>";
}
?>
]]>
</programlisting>
</example>
</para>
<note>
<title>Huomautus yhteensopivuudesta</title>
<para>
Muista kiinnittää huomiota HTTP-otsikkotietojen kirjoitusasuun! Taataksesi
mahdollisimman hyvän yhteensopivuuden eri selainten kanssa, huomaa että
avainsana "Basic" tulee kirjoittaa isolla alkukirjaimella "B",
realm-attribuutin arvon tulee olla lainausmerkeissä (ei heittomerkein
eroteltuna) ja otsikkorivin <emphasis>HTTP/1.0 401</emphasis> koodinumeroa
<emphasis>401</emphasis> ennen tulee olla tasan yksi välilyönti.
</para>
</note>
<para>
Pelkän syötettyjen arvojen tulostamisen sijaan voit mahdollisesti haluta
tarkistaa muuttujien <varname>PHP_AUTH_USER</varname> ja
<varname>PHP_AUTH_PW</varname> sisällön oikeellisuuden, ehkäpä tekemällä
kyselyn tietokantaan tai etsimällä käyttäjää dbm-tiedostosta.
</para>
<para>
Varo virheellisesti toimivia Internet Explorerin versioita. Ne saattavat
olla erittäin tarkkoja siitä missä järjestyksessä HTTP-otsikkotiedot
syötetään. <emphasis>WWW-Authenticate</emphasis> -otsikon lähettäminen
ennen <literal>HTTP/1.0 401</literal> -otsikkoa näyttäisi kuitenkin
toimivan tällä hetkellä.
</para>
<simpara>
PHP 4.3.0 ja uudemmat versiot eivät aseta PHP_AUTH-muuttujia, mikäli
ulkoinen autentikaatio on otettu käyttöön määritetyllä sivulla ja mikäli
&safemode; on käytössä. Tämä estää sellaisten skriptien teon, joilla
voitaisiin paljastaa perinteisin metodein autentikoidun käyttäjän
tunnukset. Siitä huolimatta, <varname>REMOTE_USER</varname> -muuttujaa
(eli <varname>$_SERVER['REMOTE_USER']</varname>) voidaan käyttää
ulkoisesti autentikoidun käyttäjän tunnistamiseen.
</simpara>
<note>
<title>Huomaa konfiguroidessa</title>
<para>
PHP määrittää asetuksen <literal>AuthType</literal> olemassaolon
perusteella sen, onko ulkoinen autentikaatio käytössä.
</para>
</note>
<simpara>
Huomaa kuitenkin, että edellämainittu tapa ei estä samalla palvelimella
sijaitsevia ei-autentikoituja URLeja varastamasta autentikoidun URLin
salasanoja.
</simpara>
<simpara>
Sekä Netscape Navigator että Internet Explorer tyhjentävät
HTTP-autentikaatiotiedot välimuististaan saadessaan HTTP-vastauksen 401.
Tällä keinolla voidaan "kirjata ulos" käyttäjä, pakottaen heidät syöttämään
käyttäjätunnuksensa uudelleen. Jotkut käyttävät tätä keinoa istuntojen
aikakatkaisuun tai "kirjaudu ulos" -painikkeen toteuttamiseen.
</simpara>
<para>
<example>
<title>Esimerkki uudelleenautentikoitumisen pakottamisesta</title>
<programlisting role="php">
<![CDATA[
<?php
function authenticate() {
header('WWW-Authenticate: Basic realm="Testijärjestelmä"');
header('HTTP/1.0 401 Unauthorized');
echo "Syötä käyttäjätunnus ja salasana käyttääksesi tätä resurssia.\n";
exit;
}
if (!isset($_SERVER['PHP_AUTH_USER']) ||
($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) {
authenticate();
}
else {
echo "<p>Tervetuloa: {$_SERVER['PHP_AUTH_USER']}<br />";
echo "Vanha: {$_REQUEST['OldAuth']}";
echo "<form action='{$_SERVER['PHP_SELF']}' METHOD='post'>\n";
echo "<input type='hidden' name='SeenBefore' value='1' />\n";
echo "<input type='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}' />\n";
echo "<input type='submit' value='Vaihda käyttäjää' />\n";
echo "</form></p>\n";
}
?>
]]>
</programlisting>
</example>
</para>
<simpara>
Tämänkaltaista toiminnallisuutta ei kuitenkaan vaadita HTTP Basic
authentication -standardissa, joten siihen ei tulisi koskaan luottaa.
Testaaminen Lynx-selaimella osoittaa, että Lynx ei tyhjennä
autentikaatiotietojaan saadessaan palvelimelta vastauksen 401, joten
palaaminen edelliselle sivulle ja samantien takaisin avaa uudelleen saman
resurssin -- niin kauan kuin käyttöoikeusvaatimukset eivät ole muuttuneet.
Käyttäjä voi kuitenkin painaa Lynxissä '_' -näppäintä tyhjentääkseen
autentikaatiotiedot.
</simpara>
<simpara>
Huomaa myös, että HTTP-autentikaatio ei ole toiminut ennen PHP:n versiota
4.3.3 CGI-moduulina Microsoftin IIS-palvelimessa sen rajoittuneisuuden
takia. Sen käyttöönotto PHP 4.3.3:ssa tai uudemmissa versioissa vaatii
asetuksen "Directory Security" muokkausta. Klikkaa kohtaa "Edit" ja
valitse ainoastaan "Anonymous Access", kaikki muut kentät tulee jättää
tyhjäksi.
</simpara>
<simpara>
PHP:n IIS-moduulissa (ISAPI) on puolestaan sellainen puute, että
<literal>PHP_AUTH_*</literal> muuttujia ei voida käyttää, vaan niiden
sijaan on käytettävä muuttujaa <literal>HTTP_AUTHORIZATION</literal>.
Kokeile esimerkiksi seuraavaa koodia: <literal>list($user, $pw) =
explode(':', base64_decode(substr($_SERVER['HTTP_AUTHORIZATION'],
6)));</literal>.
</simpara>
<note>
<title>Huomautus IIS:n käyttäjille</title>
<simpara>
Jotta HTTP-autentikaatio toimisi IIS-palvelimen kanssa, <link
linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link>-asetuksen
arvon tulee olla <literal>0</literal>, joka on myös asetuksen oletusarvo.
</simpara>
</note>
<note>
<para>
Mikäli &safemode; on käytössä, ajettavan skriptin UID lisätään
<literal>WWW-Authenticate</literal>-otsikon
<literal>realm</literal>-attribuutin arvoon.
</para>
</note>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->