cvs: phpdoc-sk /appendices license.xml migration5.xml
[email protected] ("Joseph Drake") Thu, 12 Feb 2004 00:12:22 -0000
| Newsgroups | php.doc.sk |
|---|---|
| Message-ID | <cvsjoseph1076544742@cvsserver> |
joseph Wed Feb 11 19:12:22 2004 EDT
Added files:
/phpdoc-sk/appendices license.xml migration5.xml
Log:
new document
joseph-20040211191222.txt
(text/plain, 12.7 KB)
http://cvs.php.net/co.php/phpdoc-sk/appendices/license.xml?r=1.1&p=1
Index: phpdoc-sk/appendices/license.xml
+++ phpdoc-sk/appendices/license.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.1 Maintainer: joseph Status: ready -->
<appendix id="opl.license">
<title>Open Publication License</title>
<simpara>v1.0, 8 June 1999</simpara>
<section id="opl.require">
<title>I. PO®IADAVKY NA NEMODOFIKOVANÚ A MODIFIKOVANÚ VERZIU</title>
<simpara>
Práce Open Publication sa mô¾u reprodukova» a distribuova» v celku alebo
po èastiach, na akomkoµvek fyzickom èi elektronickom médiu, prièom sú
podmienky tejto licencie dodr¾ané a táto licencia alebo jej zaèlenenie
podµa referencie (so v¹etkými voµbami zvolenými autorom(-mi)
a/alebo vydávateµom) je zobrazené v reprodukcii.
</simpara>
<simpara>
Vhodná forma pre zaèlenenie podµa referencie je následovná:
</simpara>
<para>
Copyright (c) <rok> by <autorové meno alebo dizajnér>. Tento
materiál sa mo¾e distribuova» iba v rámci po¾iadavok a sadou podmienok
v Open Publication License, vX.Y alebo neskor¹ej (najnov¹ia verzia
je momentálne dostupná na <ulink url="&url.opl;">&url.opl;</ulink>
</para>
<simpara>
Za referenciou musia okma¾ite následova» v¹etky voµby zvolené autorom(-mi)
a/alebo vydávateµom tohto dokumentu (pozri sekciu VI).
Komerèná redistribúcia materiálu lincencovaného Open Publication je
povolená. V¹etky publikácie v ¹tandardnej (papierovej) kni¾nej forme
vy¾adujú citáciu originálneho vydávateµa alebo autora. Vydávateµ a
mená autorov musia by» viditeµné na v¹etkých vonkaj¹ích povrchoch knihy.
Na v¹etkých vonkaj¹ích povrchoch knihy by meno vydávateµa malo by» tak
veµké ako je titul práce a citované ako vlastnické s re¹pektom k
titulu.
</simpara>
</section>
<section id="opl.copyright">
<title>II. AUTORSKÉ PRÁVA</title>
<simpara>
Autorské práva ka¾dej Open Publication sú vlastnené svojim autorom(-mi) alebo dizajnérom.
</simpara>
</section>
<section id="opl.scope">
<title>III. ROZSAH LICENCIE</title>
<simpara>
Podmienky následujúcej licencie sa vz»ahujú na v¹etky práce Open
Publication, pokiaµ explicitne nie je v dokumente uvedené inak.
</simpara>
<simpara>
Èistá agregácia prác Open Publication alebo porcia práce Open
Publication s inými prácami alebo programami na rovnakom médiu nespôsobí,
¾e sa táto licencia vz»ahuje na tieto iné práce. Agregátna práca by mala
obsahova» zmienku urèujúcu zahrnutie materiálu Open Publication a
príslu¹nú zmienku o autorských právach.
</simpara>
<simpara>
ODDELITE¥NONOS«. Ak sa nejaká èas» tejto licencie javý ako nevykonateµná v
akejkoveµvek jurisdikcii, zostávajúce porcie licencie zostávajú nutnos»ou.
</simpara>
<simpara>
®IADNA ZÁRUKA. Práce Open Publication sú licencované a poskytované "ako je"
bez záruky nijakého druhu, vyjadrený alebo zahrnutý, vrátane, ale nie
limitovaný na, zahrnuté záruky obchodovateµnosti a vhodnosti pre
príslu¹ný úèel alebo záruky neporu¹ovania.
</simpara>
</section>
<section id="opl.modified.works">
<title>IV. PO®IADAVKY NA MODIFIKOVANÉ PRÁCE</title>
<para>
V¹etky modifikované verzie dokumentu pokryté touto licenciou, vrátane
prekladov, zbierok, kompilácií a èiastoèných dokumentov, musia spåòa»
následujúce po¾iadavky:
</para>
<para>
<orderedlist>
<listitem>
<simpara>
Modifikovaná verzia ako taká musí by» oznaèená.
</simpara>
</listitem>
<listitem>
<simpara>
Osoby vykonávajúce modifikácie musia by» uvedené
a modifikácie zdátumované.
</simpara>
</listitem>
<listitem>
<simpara>
Poïakovanie pôvodného autora a vydávateµa, ak je to mo¾né, musia
by» uchované podµa normálnych praktík akademickej citácie.
</simpara>
</listitem>
<listitem>
<simpara>
Umiestnenie pôvodného nemodifikovaného dokumentu musí by» uvedené.
</simpara>
</listitem>
<listitem>
<simpara>
Meno(-á) pôvodného(-ých) autora(-ov) sa nemo¾u pou¾i» na uistenie
alebo zahrnutie schválenia výsledného dokumentu bez povolenia
pôvodného(-ých) autora(-ov).
</simpara>
</listitem>
</orderedlist>
</para>
</section>
<section id="opl.good-practice">
<title>V. VHODNÉ DOPORUÈENIA</title>
<simpara>
Okrem po¾iadaviek tejto licencie sa silne doporuèuje a vy¾aduje od
redistribútorov, ¾e:
</simpara>
<para>
<orderedlist>
<listitem>
<simpara>
Ak distribuujete práce Open Publication ako tvrdé kópie alebo CD-ROM,
emailom poskytnite notifikáciu autorom o svojom zámere redistribúcie
najmenej tridsa» dní pred uvedením manuskriptu alebo média, aby ste takò
dali autorom èas na poskytnutie aktualizovaných dokumentov. Táto
notifikácia by mala popisova» zmeny, ak nejaké sú, vykonané na dokumente.
</simpara>
</listitem>
<listitem>
<simpara>
V¹etky podstatné zmeny (vrátane odstránení) by mali by» buï
jasne oznaèené v dokumente alebo inak popísané v prílohe
dokumentu.
</simpara>
</listitem>
<listitem>
<simpara>
Nakoniec, èo nie je mandatóriom tejto licencie, pova¾uje sa za dobrú
formu ponúknu» voµnú kópiu v¹etkých tvrdých kópií a CD-ROM vyjadrení
práce licencovanej Open Publication jej autorovi(-om).
</simpara>
</listitem>
</orderedlist>
</para>
</section>
<section id="opl.options">
<title>VI. LICENÈNÉ VO¥BY</title>
<simpara>
Autor(i) a/alebo vydávateµ dokumentu s licenciou Open Publication
mô¾e zvoli» urèité voµby pridaním jazyka do referencie alebo
kópie licencie. Tieto voµby sa pova¾ujú za èas» licenènej in¹tancie
a musia by» zahrnuté s licenciou (alebo jej referenèné
zaèlenenie) v odvodených prácach.
</simpara>
<simpara>
A. Zabráni» distribúcii podstatne modifikovaných verzií bez explicitného
povolenia autora(-ov). "Podstatná modifikácia" sa definuje ako
zmena sémantického obsahu dokumentu a vyníma èisté zmeny vo formáte
alebo typografické opravy.
</simpara>
<simpara>
Aby sa tak uskutoènilo, pridajte frázu `Distribúcia podstatne modifikovaných
verzií tohto dokumentu je zakázané bez explicitného povolenia dr¾iteµa
autorských práv.' do licenènej referencie alebo kópie.
</simpara>
<simpara>
B. Zabránenie publikácii tejto práce alebo odvodených prác v celku alebo
po èastiach v ¹tandardnej (papierovej) kni¾nej forme pre komerèné úèely je
zakázané pokiaµ nie je udelené povolenie od vlastníka autorských práv.
</simpara>
<simpara>
Aby sa tak uskutoènilo, pridajte frázu 'Distribúcia práce alebo odvodenia
práce v akejkoµvek ¹tandardnej (papierovej) kni¾nej forme je zakázané pokiaµr
nie je udelené povolenie od vlastníka autorských práv.' do licenènej
referencie alebo kópie.
</simpara>
</section>
</appendix>
http://cvs.php.net/co.php/phpdoc-sk/appendices/migration5.xml?r=1.1&p=1
Index: phpdoc-sk/appendices/migration5.xml
+++ phpdoc-sk/appendices/migration5.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
<appendix id="migration5">
<title>Migrácia z PHP 4 na PHP 5</title>
<section id='migration5.changes'>
<title>Èo sa zmenilo v PHP 5</title>
<para>
PHP 5 a integrovaný Zend Engine 2 významne zlep¹ili výkon
a schopnosti PHP, ale významná pozornos» sa venovala èo najmen¹iemu
poru¹eniu existujúceho kódu. Tak¾e migrácia vá¹ho kódu z PHP 4 na 5
by malo by» µahké. Väè¹ina existujúceho PHP 4 kódu by mala by» pripravená
na beh bez zmien, ale stále by ste mali vedie» o <link
linkend="migration5.incompatible">pár odli¹nostiach</link> a
postara» sa o testovanie vá¹ho kódu pred prepnutím verzií v produkènom
prostredí.
</para>
</section>
<section id="migration5.incompatible">
<title>Spätné Nekompaktibilné Zmeny</title>
<para>
I keï väè¹ina existujúceho PHP 4 kódu by mala fungova» bez zmien, mali by
venova» pozornos» týmto spätným nekompaktibilným zmenám:
</para>
<itemizedlist>
<listitem><simpara>
<function>strrpos</function> a <function>strripos</function> teraz
pou¾ívajú celý re»azec ako ihlu.
</simpara></listitem>
<listitem><simpara>
Nelegálne pou¾itie offsetov re»azca spôsobuje <constant>E_ERROR</constant> namesto
<constant>E_WARNING</constant>.
</simpara></listitem>
<listitem><simpara>
<function>array_merge</function> bola zmenená na akceptovanie iba polí.
Ak sa vlo¾í premenná, ktorá nie je typu array, <constant>E_WARNING</constant>
sa objaví pre ka¾dý taký parameter. Buïte opatrný preto¾e vá¹ kód mô¾e
zaèa» emitova» <constant>E_WARNING</constant> z èista jasna.
</simpara></listitem>
<listitem><simpara>
PATH_TRANSLATED premenná servera u¾ nie je implicitne nastavená pod
Apache2 SAPI na rozdiel od situácie v PHP 4, kde je nastavená na
rovnakú hodnotu ako SCRIPT_FILENAME premenná servera, keï nie je
obsadená Apacheom. Táto zmena sa urobila na vyhovenie s <ulink
url="&url.cgispecs;">CGI ¹pecifikáciou</ulink>. Prosím, pozrite si <ulink
url="&url.php.bugs;23610">bug #23610</ulink> pre ïal¹ie informácie.
</simpara></listitem>
<listitem><simpara>
Kon¹tanta <constant>T_ML_CONSTANT</constant> u¾ nie je definovaná
roz¹írením <link linkend="ref.tokenizer">Tokenizer</link>. Ak je
error_reporting nastanený na <constant>E_ALL</constant>, PHP vygeneruje
oznam. Namiesto <constant>T_ML_CONSTANT</constant> pre /* */ sa pou¾ije
kon¹tanta <constant>T_COMMENT</constant>, i keï obe // a /* */
sa berú ako kon¹tanta <constant>T_COMMENT</constant>. Av¹ak PHPDoc
¹týlové komentáre /** */ , ktoré poèínajúc PHP5 sú analyzované PHP-èkom,
sú rozpoznávané ako <constant>T_DOC_COMMENT</constant>.
</simpara></listitem>
<listitem><simpara>
$_SERVER by mala by» obsadená s argc a argv ak variables_order
zahàòa "S". Ak ste ¹pecificky nakonfigurovali svoj systém na
nevytváranie $_SERVER, potom samozrejme by tam nemala by». Zmena bola
v¾dy urobi» z argc a argv premennú v CLI verziu bez ohµadu na
nastavenie variables_order. CLI verzia bude v¾dy obsadzova»
globálne premenné $argc a $argv.
</simpara></listitem>
<listitem><simpara>
Triedy sa musia pred pou¾itím deklarova».
</simpara></listitem>
</itemizedlist>
</section>
<section id="migration5.configuration">
<title>Migrujúce Konfiguraèné Súbory</title>
<para>
Nakoµko si ISAPI moduly zmenili svoje názvy, z php4xxx na php5xxx,
musíte urobi» nejaké zmeny v konfiguraèných súboroch. Tie¾ nastali
zmeny v názvoch súborov CLI a CGI. Prosím, pozrite si zodpovedajúcu
sekciu pre viac informácii.
</para>
<para>
Migrovanie Apache konfigurácie je extrémne jednoduché. Prozri príklad
uvedený ni¾¹ie na kontrolu zmien, ktoré musíte urobi»:
<informalexample>
<programlisting role="apache-conf">
<![CDATA[
# zamente tento riadok:
LoadModule php4_module /php/sapi/php4apache2.dll
# za tento:
LoadModule php5_module /php/php5apache2.dll
]]>
</programlisting>
</informalexample>
</para>
<para>
Ak na vá¹om webserveri be¾í PHP v CGI móde, mali by ste si v¹imnú», ¾e
si CGI verzia zmenila svoj názov z php.exe na php-cgi.exe.
V Apache by ste mali urobi» nieèo takéto:
<informalexample>
<programlisting role="apache-conf">
<![CDATA[
# zamente tento riadok:
Action application/x-httpd-php "/php/php.exe"
# za tento:
Action application/x-httpd-php "/php/php-cgi.exe"
]]>
</programlisting>
</informalexample>
</para>
<para>
V iných webserveroch musíte zmeni» názvy súborov buï v CGI alebo ISAPI
moduloch.
</para>
</section>
</appendix>
<!-- 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
-->