[PHP-DOC] Standard Functions Samples (suggestion)
Hi all, Some samples echo function(); //result other Example 1. function() Example The second sample is more didactial. IMHO Best Resgards, Kappu
[PHP-DOC] cvs: phpdoc /pl/features safe-mode.xml
slawek Sat Mar 16 20:35:18 2002 EDT Modified files: /phpdoc/pl/features safe-mode.xml Log: Updated to EN 1.20 Index: phpdoc/pl/features/safe-mode.xml diff -u phpdoc/pl/features/safe-mode.xml:1.10 phpdoc/pl/features/safe-mode.xml:1.11 --- phpdoc/pl/features/safe-mode.xml:1.10 Wed Jan 2 02:16:11 2002 +++ phpdoc/pl/features/safe-mode.xmlSat Mar 16 20:35:18 2002 @@ -1,311 +1,314 @@ - - - - - Tryb bezpieczny - - - Tryb bezpieczny (safe mode) jest prób± rozwi±zania problemów - bezpieczeñstwa na wspó³dzielnym serwerze. Co prawda rozwi±zywanie ich na - poziomie PHP nie jest najlepszym rozwi±zaniem, ale je¶li nie ma mo¿liwo¶ci - zrobienia tego na poziomie serwera www lub systemu operacyjnego, na wielu - serwerach, zw³aszcza u us³ugodawców internetowych, u¿ywa siê trybu - bezpiecznego. - - - Dyrektywy konfiguracyjne odpowiadaj±ce za tryb bezpieczny: - - - - - - Gdy opcja safe_mode jest w³±czona, - PHP sprawdza czy w³a¶cicielem pliku na którym na którym funkcja chce - operowaæ i w³a¶cicielem uruchamianego skryptu jest ten sam u¿ytkownik. - Na przyk³ad: - - - - Uruchomienie script.php - - - - z uruchomionym trybem bezpiecznym spowoduje wy¶wietlenie b³êdu: - - - - - - Je¶li zamiast w³±czaæ opcjê safe_mode - ustawisz katalog open_basedir, - wtedy wszystkie operacje plikowe bed± ograniczone do tego katalogu. Na - przyk³ad (dla httpd.conf Apache'a): - - - - Uruchomienie tego samego skryptu script.php z ustawionym katalogiem - open_basedir spowoduje wy¶wietlenie: - - - - - - Mo¿esz tak¿e wy³±czyæ pojedyncze funkcje. Je¶li do pliku php.ini dodasz: - - - - po uruchomieniu skryptu otrzymasz: - - - - - - - Funkcje ograniczone/wy³±czone w trybie bezpiecznym - -Jest to najprawdopodobniej wci±¿ niekompletna lista funkcji ograniczonych -przez tryb bezpieczny. - - - Funkcje ograniczone w trybie bezpiecznym - - - -Funkcja -Ograniczenia - - - - -dbmopen -&sm.uidcheck; - - -dbase_open -&sm.uidcheck; - - -filepro -&sm.uidcheck; - - -filepro_rowcount -&sm.uidcheck; - - -filepro_retrieve -&sm.uidcheck; - - -ifx_* -Podlega ograniczeniom narzuconym przez sql_safe_mode, -(!= tryb bezpieczny) - - - -ingres_* -Podlega ograniczeniom narzuconym przez sql_safe_mode, -(!= tryb bezpieczny) - - - -mysql_* -Podlega ograniczeniom narzuconym przez sql_safe_mode, -(!= tryb bezpieczny) - - - -pg_loimport -&sm.uidcheck; - - - -posix_mkfifo -&sm.uidcheck.dir; - - -putenv -Podlega dyrektywom safe_mode_protected_env_vars i -safe_mode_allowed_env_vars w php.ini. Zobacz równie¿ dokumantacjê -do putenv - - - -move_uploaded_file -&sm.uidcheck; - - - - - -chdir -&sm.uidcheck.dir; - - -dl -&sm.disabled; - - -lewy apostrof -&sm.disabled; - - -shell_exec (funkcja równowa¿na z -lewym apostrofem) -&sm.disabled; - - -exec -Mo¿esz uruchamiaæ programy jedynie z katalogu zdefiniowanego -dyrektyw± -safe_mode_exec_dir. -Ze wzglêdów praktycznych obecnie nie ma mo¿liwo¶ci stosowania -.. w ¶cie¿ce do programu. - - -system -Mo¿na uruchamiaæ programy jedynie z katalogu zdefiniowanego -dyrektyw± -safe_mode_exec_dir. -Ze wzglêdów praktycznych obecnie nie ma mo¿liwo¶ci stosowania -.. w ¶cie¿ce do programu. - - -passthru -Mo¿na uruchamiaæ programy jedynie z katalogu zdefiniowanego -dyrektyw± -safe_mode_exec_dir. -Ze wzglêdów praktycznych obecnie nie ma mo¿liwo¶ci stosowania -.. w ¶cie¿ce do programu. - - -popen -Mo¿na uruchamiaæ programy jedynie z katalogu zdefiniowanego -dyrektyw± -safe_mode_exec_dir. -Ze wzglêdów praktycznych obecnie nie ma mo¿liwo¶ci stosowania -.. w ¶cie¿ce do programu. - - - -mkdir -&sm.uidcheck.dir; - - -rmdir -&sm.uidcheck; - - -rename -&sm.uidcheck; &sm.uidcheck.dir; - - -unlink -&sm.uidcheck; &sm.uidcheck.dir; - - -copy -&sm.uidcheck; &sm.uidcheck.dir; (dla -¼ród³a i -przeznaczenia) - - -chgrp -&sm.uidcheck; -
[PHP-DOC] cvs: phpdoc /pl translation.xml
slawek Sat Mar 16 19:06:13 2002 EDT Modified files: /phpdoc/pl translation.xml Log: types.xml done. Index: phpdoc/pl/translation.xml diff -u phpdoc/pl/translation.xml:1.7 phpdoc/pl/translation.xml:1.8 --- phpdoc/pl/translation.xml:1.7 Sun Mar 10 15:49:35 2002 +++ phpdoc/pl/translation.xml Sat Mar 16 19:06:12 2002 @@ -23,7 +23,6 @@ -
[PHP-DOC] cvs: phpdoc /pl/language types.xml
slawek Sat Mar 16 18:59:50 2002 EDT
Added files:
/phpdoc/pl/language types.xml
Log:
Types.xml (version EN 1.73) DONE! DONE! DONE! (qrak)
Index: phpdoc/pl/language/types.xml
+++ phpdoc/pl/language/types.xml
Typy danych
Wstêp
PHP obs³uguje osiem typów prostych.
Cztery skalarne:
boolowski (boolean)
liczba ca³kowita (integer)
liczba zmiennoprzecinkowa
(float)
³añcuch znaków (string)
Dwa typy z³o¿one:
tablica (array)
obiekt (object)
Oraz dwa typy specjalne:
identyfikator zasobów
(resource)
NULL (null)
W tym podrêczniku czêsto pojawia siê typ mixed. Ten
pseudotyp wskazuje na mo¿liwo¶æ u¿ycia danych ró¿nego typu.
Typ danych zwykle nie jest ustalany przez programistê. Robi to PHP na
podstawie kontekstu, w jakim zmienna jest u¿ywana.
Aby sprawdziæ typ i warto¶æ konkretnego wyra¿enia, nale¿y u¿yæ funkcji
var_dump.
Aby mieæ czyteln± reprezentacjê typu dla potrzeb debugowania, nale¿y u¿yæ
funkcji gettype. Aby sprawdziæ, czy zmienna jest
jakiego¶ konkretnego typu, nie u¿ywaj funkcji
gettype, tylko grupy funkcji
is_jaki¶_typ.
Aby narzuciæ konwersjê zmiennej do okre¶lonego typu, mo¿na albo rzutowaæ zmienn±, albo u¿yæ
funkcji settype.
Proszê pamiêtaæ, ¿e w pewnych sytuacjach zmienne mog± siê zachowywaæ ró¿nie,
w zale¿no¶ci od tego, jakiego typu s± w danej chwili. Wiêcej informacji
w rozdziale wykorzystywanie typów danych.
Zmienne Logiczne (Boolowskie - boolean)
Ten rodzaj jest najprostszy. Typ boolean wyra¿a logiczn±
prawdê lub fa³sz. Mo¿e mieæ warto¶ci &true; lub &false;.
Typ boolowski zosta³ wprowadzony w PHP 4.
Sk³adnia
Aby utworzyæ warto¶æ boolowsk±, nale¿y u¿yæ s³ów kluczowych &true; lub
&false;. Wielko¶æ liter w tych s³owach nie gra roli.
Ten typ najczê¶ciej u¿ywany jest przy
operatorach, które zwracaj±
warto¶æ typu boolean, któr± nastêpnie przekazuje siê
do struktur kontrolnych.
Konwersja do typu boolowskiego
Aby jawnie skonwertowaæ warto¶æ na typ boolean, nale¿y
u¿yæ rzutowania (bool) lub
(boolean). Jednak¿e w wiêkszo¶ci przypadków nie ma
potrzeby u¿ycia rzutowania, poniewa¿ warto¶æ bêdzie automatycznie
skonwertowana na typ boolean, je¶li operator, funkcja lub
struktura kontrolna wymaga argumentu tego w³a¶nie typu.
Zobacz te¿
wykorzysytwanie typów
danych.
Przy konwersji na typ boolean, poni¿sze warto¶ci otrzymuj±
warto¶æ logiczn± &false;:
boolowski
&false;
liczba ca³kowita 0 (zero)
liczba
zmiennoprzecinkowa
0.0 (zero)
pusty ³añcuch znaków, oraz ³añcuch znaków "0"
tablica
z zerow± liczb± elementów
obiekt
z zerow± liczb± elementów
specjalny typ NULL (w³±czaj±c niezadeklarowane zmienne)
Ka¿da inna warto¶æ otrzymuje logiczn± warto¶æ &true; (w³±czaj±c w to
identyfikatory zasobów).
-1 tak¿e ma warto¶æ &true;, jak ka¿da niezerowa
(ujemna lub dodatnia) liczba!
Liczby ca³kowite (integer)
Typ integer to liczba ca³kowita, nale¿±ca do przedzia³u
Z = {..., -2, -1, 0, 1, 2, ...}.
Zobacz te¿:
Liczby ca³kowite du¿ej precyzji oraz
Liczby zmiennoprzecinkowe
Sk³adnia
Liczby ca³kowite mog± byæ zapisane w notacji dziesiêtnej (opartej na 10),
szesnastkowej (opartej na 16) lub ósemkowej (opartej na 8), opcjonalnie
poprzedzone znakiem (- lub +).
Aby zapisaæ liczbê w notacji ósemkowej, nale¿y poprzedziæ w³a¶ciw± liczbê
symbolem 0 (zero). W notacji szesnastkowej liczbê
nale¿y poprzedziæ symbolem 0x.
Notacja liczb ca³kowitych
Maksymalna wielko¶æ liczby ca³kowitej jest zale¿na od platformy
operacyjnej, zwykle jest to oko³o dwa miliardy (jest to 32 bity ze
znakiem). PHP nie obs³uguje liczb ca³kowitych bez znaku.
Wyj¶cie poza zakres liczb ca³kowitych
W przypadku zapisania liczby ca³kowitej wykraczaj±cej poza zakres typu
[PHP-DOC] /usr/bin/php4
Hi The php4 cgi executable installed by debian is /usr/bin/php4. Unfortunately 'configure' is looking only for /usr/bin/php. It would be nice if it was compatible with debian. slawek-
[PHP-DOC] language.oop.constructor
Title: Sporočilo Hi in section language.oop.constructor ... If a class has no constructor, the constructor of the base class is being called, if it exists is correct __base__?? I thik parent is more relavant. gretings Matej Skubic
[PHP-DOC] cvs: phpdoc /it translation.xml
cucinatoSat Mar 16 12:38:13 2002 EDT Modified files: /phpdoc/it translation.xml Log: Updated, assigned CPDF Index: phpdoc/it/translation.xml diff -u phpdoc/it/translation.xml:1.23 phpdoc/it/translation.xml:1.24 --- phpdoc/it/translation.xml:1.23 Sat Mar 16 11:41:57 2002 +++ phpdoc/it/translation.xml Sat Mar 16 12:38:13 2002 @@ -43,7 +43,6 @@ - @@ -56,6 +55,7 @@ +
[PHP-DOC] cvs: phpdoc /it/functions bzip2.xml
cucinatoSat Mar 16 12:37:50 2002 EDT Modified files: /phpdoc/it/functionsbzip2.xml Log: Synced to EN version Index: phpdoc/it/functions/bzip2.xml diff -u phpdoc/it/functions/bzip2.xml:1.11 phpdoc/it/functions/bzip2.xml:1.12 --- phpdoc/it/functions/bzip2.xml:1.11 Sun Mar 10 09:48:28 2002 +++ phpdoc/it/functions/bzip2.xml Sat Mar 16 12:37:50 2002 @@ -1,22 +1,55 @@ - + Funzioni di compressione Bzip2 Bzip2 + - -Questo modulo utilizza le funzioni della libreria bzip2 di Julian Seward per -leggere e scrivere in modo trasparente i file compressi con bzip2 (.bz2). - - -Il spporto di Bzip2 in PHP non è attivo per default. Si deve -usare l'opzione di configurazione --with-bz2 -quando si compila PHP per sbilitare il supporto bzip2. Questo modulo -richiede bzip2/libbzip2 con versione >= 1.0.x. + +Le funzioni bzip2 sono utilizzate per leggere e scrivere in modo trasparente i +file +compressi con bzip2 (.bz2). + + +Requisiti + + Questo modulo tuilizza le funzioni della libreria bzip2 di Julian Seward + + + + +Installazione + + Il supporto di Bzip2 in PHP non è attivo per default. Si deve + usare l'opzione di configurazione --with-bz2 + quando si compila PHP per sbilitare il supporto bzip2. Questo modulo + richiede bzip2/libbzip2 con versione >= 1.0.x. + + + + +Configurazione di Runtime + + Questa estensione non definisce direttive di configurazione. + + + + +Tipi di risorse + + Questa estensione non definisce tipi di risorse. + + + + +Costanti predefinite + + Questa estensione non definisce costanti. + + - + Breve sorgente di esempio Questo esempio apre un file temporaneo e scrive una stringa di prova su @@ -55,7 +88,7 @@ ]]> - +
[PHP-DOC] cvs: phpdoc /it/functions network.xml
cortesi Sat Mar 16 12:14:20 2002 EDT Modified files: /phpdoc/it/functionsnetwork.xml Log: update to EN 1.60 Index: phpdoc/it/functions/network.xml diff -u phpdoc/it/functions/network.xml:1.16 phpdoc/it/functions/network.xml:1.17 --- phpdoc/it/functions/network.xml:1.16Thu Feb 21 19:57:18 2002 +++ phpdoc/it/functions/network.xml Sat Mar 16 12:14:20 2002 @@ -1,5 +1,5 @@ - + Funzioni di rete @@ -162,6 +162,13 @@ usato per impostare un timeout in secondi per la chiamata di sistema connect. + A partire da PHP 4.3.0, se si è compilato con il supporto OpenSSL, si può + prefissare hostname con + 'ssl://' oppure 'tls://' per + utilizzare una connessione client SSL o TLS su una connessione TCP/IP per +connettersi + all'host remoto. + + fsockopen restituisce un puntatore a file che può essere usato nelle altre funzioni orientate ai file (come fgets, fgetss, @@ -421,8 +428,8 @@ corrispondente a servizio per il protocollo specificato come in /etc/services. - protocollo può essere sia TCP - che UDP. + protocollo può essere sia "tcp" + che "udp" (scritti in minuscolo). Vedere anche: getservbyport. @@ -448,8 +455,8 @@ getservbyport restituisce il servizio Internet associato a porta relativamente al protocollo specificato come in /etc/services. - protocollo può essere sia TCP - che UDP. + protocollo può essere sia "tcp" + che "udp" (scritti in minuscolo). Vedere anche: getservbyname.
[PHP-DOC] cvs: phpdoc /en/functions filesystem.xml
wez Sat Mar 16 12:02:36 2002 EDT Modified files: /phpdoc/en/functionsfilesystem.xml Log: More docs for streams related changes. Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.129 phpdoc/en/functions/filesystem.xml:1.130 --- phpdoc/en/functions/filesystem.xml:1.129Sat Mar 16 10:06:08 2002 +++ phpdoc/en/functions/filesystem.xml Sat Mar 16 12:02:35 2002 @@ -1,5 +1,5 @@ - + Filesystem functions Filesystem @@ -233,6 +233,13 @@ + + + As of PHP 4.3.0, both source and + dest may be URLs if the "fopen wrappers" + have been enable. See fopen for more details. + + If the destination file already exists, it will be overwritten. @@ -672,6 +679,27 @@ + + +file_get_contents +Reads entire file into a string + + +Description + + stringfile_get_contents + stringfilename + intuse_include_path + + + Identical to readfile, except that + file_get_contents returns the file in a string. + +¬e.bin-safe; +&tip.fopen-wrapper; + + + file @@ -720,6 +748,12 @@ + + + As of PHP 4.3.0 you can use file_get_contents to + return the contents of a file as a string in a binary safe manner. + + ¬e.not-bin-safe; &tip.fopen-wrapper; @@ -1184,6 +1218,7 @@ As of PHP 4.3.0 (not yet released), if you have compiled in support for OpenSSL, you may use "https://"; to open an HTTP connection over SSL. + Note that the file pointer allows you to retrieve only the body of the response; to retrieve the HTTP
[PHP-DOC] cvs: phpdoc /it translation.xml
cortesi Sat Mar 16 11:41:57 2002 EDT Modified files: /phpdoc/it translation.xml Log: info foo wanna-be italian translators Index: phpdoc/it/translation.xml diff -u phpdoc/it/translation.xml:1.22 phpdoc/it/translation.xml:1.23 --- phpdoc/it/translation.xml:1.22 Fri Mar 15 11:46:13 2002 +++ phpdoc/it/translation.xml Sat Mar 16 11:41:57 2002 @@ -6,7 +6,11 @@ The Italian translation of the PHP Documentation is managed by Luca Perugini and Simone Cortesi, and the other - contributors with a CVS user. + contributors with a CVS user. For more information, or if you + would like to help out on the italian translation effort, + take a http://cortesi.com/php/";>look here (in italian) + or subscribe to the http://cortesi.com/mailman/listinfo/php/";>mailinglist + (in italian too).
Re: [PHP-DOC] cvs: phpdoc /de Translators /de/features safe-mode.xml /de/functions fdf.xml recode.xml zip.xml
Hi Goba, sorry that I didn't write it explicitely, but this message was adressed to the german ones :) Cu, Thomas Gabor Hojtsy wrote: > > 2.) General switch-over: > > The only missing information in revcheck are the missing > > revision-numbers and maintainers in the missing revcheck-tags (89 > > files). I'd volunteer to import this info into these files based on the > > info in Translators, if we will switch-over afterwards. > > > > What do you think about it? > > Well, I like this idea myself, but it's > up to the DE translators to decide. > > Goba
[PHP-DOC] cvs: phpdoc /en/functions filesystem.xml network.xml
wez Sat Mar 16 10:06:09 2002 EDT Modified files: /phpdoc/en/functionsfilesystem.xml network.xml Log: update docs to reflect recent streams changes Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.128 phpdoc/en/functions/filesystem.xml:1.129 --- phpdoc/en/functions/filesystem.xml:1.128Sat Mar 9 13:01:17 2002 +++ phpdoc/en/functions/filesystem.xml Sat Mar 16 10:06:08 2002 @@ -1,5 +1,5 @@ - + Filesystem functions Filesystem @@ -1130,6 +1130,35 @@ + + +fgetwrapperdata +Retrieves header/meta data from "wrapped" file pointers + + +Description + + mixedfgetwrapperdata + intfp + + + This function returns header or meta data from files opened with + fopen. This is useful to return the response + headers for HTTP connections, or some other statistics for other + resources. + + + The format of the returned data is deliberately undocumented at this + time. + + + + This function was introduced in PHP 4.3.0. + + + + + fopen @@ -1152,10 +1181,20 @@ request in order to handle name-based virtual hosts. + As of PHP 4.3.0 (not yet released), if you have compiled in + support for OpenSSL, you may use "https://"; to open an HTTP + connection over SSL. + Note that the file pointer allows you to retrieve only the - body of the response; you cannot - access the HTTP response header using this function. Additionally, - HTTP connections are read-only. + body of the response; to retrieve the HTTP + response header you need to be using PHP 4.0.5 or later; + The headers will be stored in the $http_response_header variable. + As of PHP 4.3.0 (not yet released), the header information can + be retrieved using the fgetwrapperdata. + + + HTTP connections are read-only; you cannot write data or copy + files to an HTTP resource. Versions prior to PHP 4.0.5 do not handle HTTP redirects. Because Index: phpdoc/en/functions/network.xml diff -u phpdoc/en/functions/network.xml:1.59 phpdoc/en/functions/network.xml:1.60 --- phpdoc/en/functions/network.xml:1.59Wed Mar 13 14:18:30 2002 +++ phpdoc/en/functions/network.xml Sat Mar 16 10:06:08 2002 @@ -1,5 +1,5 @@ - + Network Functions Network @@ -159,6 +159,13 @@ socket, port must be set to 0 in this case. The optional timeout can be used to set a timeout in seconds for the connect system call. + + + As of PHP 4.3.0, if you have compiled in OpenSSL support, you may + prefix the hostname with either + 'ssl://' or 'tls://' to + use an SSL or TLS client connection over TCP/IP to connect + to the remote host. fsockopen returns a file pointer which may
[PHP-DOC] Re: "new" XML language for phpdoc?
Gabor Hojtsy wrote: > II) *So* how can we solve the problem? > > a) Macros in editors and/or using XML editors... > > Advantage: no need to modify xml files and/or > the used language > > Problem: sometimes you have no XML > editor at hand, and this won't make our > XML code readable. Cluttered xml files. This is very extremely and unlikely case. Documentation is not like system administration where you must fixed broken configuration file in as few minutes as possible. You usually write phpdoc with your popular editor in your customized environment. > b) Customize DocBook, write own stye sheets > for processing new tags, and customize > the DTD > > Advantage: using our own tags, readable > XML files > > Problem: there are ready made tools > for docbook, and this would make the > usage of those tools impossible or at > least hard Customizing (extending/subseting) DocBook doesn't affect processing tools. Only thing you must to do is to customize stylesheets to handle new elements. This is very easy usually. > c) Build a new language on top of DocBook, > and provide some simple conversion style > sheets from our language to DocBook. > > Advantage: using our own tags, readable > XML files, simple DTD (only those tags we use) > > Problem: more processing time, DocBook > as an intermediary language The biggest problem here is inconvience for authors. DocBook is standard for writing documentation in a same sense as HTML is standard for marking up web-pages. Authors doesn't want to learn new markup language twice a year. > So what about inventing some shortcut tags for > our problematic parts add some tags to DocBook, Shortcutting is issue of editing environment. This is not reason for modifying DTD. If you think that DocBook XML markup is too verbose you can swith to SGML version and use all its minimalization features. Sounds strange? Yes, in these days when we have very powerful computers it is very easy to use enough clever software which will hide you from markup editing complexities. > remove those we never use and name the language > eg. PHPBook. This way we would have a simple Removing unused tags (subseting DocBook) is another issue. This could have very positive asset. Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
[PHP-DOC] cvs: phpdoc /en/functions mbstring.xml
hirokawaSat Mar 16 07:44:07 2002 EDT Modified files: /phpdoc/en/functionsmbstring.xml Log: added note for mbstring. Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.24 phpdoc/en/functions/mbstring.xml:1.25 --- phpdoc/en/functions/mbstring.xml:1.24 Sun Mar 10 03:51:50 2002 +++ phpdoc/en/functions/mbstring.xmlSat Mar 16 07:44:06 2002 @@ -1,5 +1,5 @@ - + Multi-Byte String Functions Multi-Byte String @@ -1442,7 +1442,8 @@ from-encoding is specified by character code name before conversion. it can be array or string - comma - separated enumerated list. + separated enumerated list. If it is not specified, the internal + encoding will be used.
[PHP-DOC] cvs: phpdoc /ja/functions mailparse.xml mbstring.xml
hirokawaSat Mar 16 07:43:39 2002 EDT Modified files: /phpdoc/ja/functionsmailparse.xml mbstring.xml Log: update translation. Index: phpdoc/ja/functions/mailparse.xml diff -u phpdoc/ja/functions/mailparse.xml:1.2 phpdoc/ja/functions/mailparse.xml:1.3 --- phpdoc/ja/functions/mailparse.xml:1.2 Sat Feb 2 10:44:20 2002 +++ phpdoc/ja/functions/mailparse.xml Sat Mar 16 07:43:39 2002 @@ -1,5 +1,5 @@ - + mailparse関数 mailparse関数 @@ -14,8 +14,8 @@ mailparse_uudecode_all - Scans the data from fp and extract each embedded uuencoded - file. Returns an array listing filename information + +ファイルポインタからデータをスキャン、uuencodeされたファイルを展 + 開、ファイル名のリストを含む配列を返す @@ -35,7 +35,7 @@ mailparse_rfc822_parse_addresses - Parse addresses and returns a hash containing that data + アドレスをパースし、そのデータを含むハッシュを返す @@ -55,8 +55,8 @@ mailparse_determine_best_xfer_encoding - Figures out the best way of encoding the content read from the - file pointer fp, which must be seek-able + +ファイルポインタから内容を読み込む際に最も適したエンコーディング + を定義する @@ -76,8 +76,8 @@ mailparse_stream_encode - Streams data from source file pointer, apply encoding and write - to destfp + +ソースファイルポインタのストリームからデータを取得し、エンコーディ + ングを適用し、出力ファイルポインタに書き込む @@ -98,7 +98,7 @@ mailparse_msg_parse -Incrementally parse data into buffer +データをパースし、バッファに追加する 説明 @@ -117,7 +117,7 @@ mailparse_msg_parse_file -Parse file and return a resource representing the structure + +ファイルをパースし、その構造を表すリソースを返す 説明 @@ -135,7 +135,9 @@ mailparse_msg_free -Frees a handle allocated by mailparse_msg_crea + + mailparse_msg_creaにより確保されたハンドルを解放する + 説明 @@ -153,7 +155,9 @@ mailparse_msg_create -Returns a handle that can be used to parse a message + + メッセージをパースするために使用可能なハンドルを返す + 説明 @@ -171,7 +175,9 @@ mailparse_msg_get_structure -Returns an array of mime section names in the supplied message + + 指定したメッセージ内のMIMEセクション名の配列を返す + 説明 @@ -190,8 +196,8 @@ mailparse_msg_extract_part - Extracts/decodes a message section. If callbackfunc is not - specified, the contents will be sent to "stdout" + +メッセージセクションを展開/デコードする。callbackfuncが指定されな + い場合、コンテンツは"stdout"に送られる @@ -212,7 +218,10 @@ mailparse_msg_extract_part_file -Extracts/decodes a message section, decoding the transfer encoding + + メッセージセクションを展開/デコードし、transfer +encodingをデコー + ドする + 説明 @@ -232,7 +241,9 @@ mailparse_msg_get_part_data -Returns an associative array of info about the message + + メッセージに関する情報の連想配列を返す + 説明 @@ -250,7 +261,9 @@ mailparse_msg_get_part -Returns a handle on a given section in a mimemessage + + +MIMEメッセージの指定したセクションに関するハンドルを返す + 説明 Index: phpdoc/ja/functions/mbstring.xml diff -u phpdoc/ja/functions/mbstring.xml:1.19 phpdoc/ja/functions/mbstring.xml:1.20 --- phpdoc/ja/functions/mbstring.xml:1.19 Sun Mar 10 03:50:30 2002 +++ phpdoc/ja/functions/mbstring.xmlSat Mar 16 07:43:39 2002 @@ -1,5 +1,5 @@ - + マルチバイト文字列関数(mbstring) @@ -1436,7 +1436,8 @@ from-encoding により変換前の文字エンコーディ ング名が指定されます。これは、配列またはカンマ区切りの文字列とす - ることが可能です。 + +ることが可能です。省略時のデフォルトは内部文字エンコーディングで + す。
[PHP-DOC] "new" XML language for phpdoc?
Hi! After getting home from the doc meeting, I decided to propose this idea about having a simplified XML language on top of DocBook for phpdoc stuff. This idea may be completely useless, or may be accepted to implement in the future. First it seemed to me a good idea, so I decided to write it down. This does not mean, that it is good at all ;) I) *So* what is the problem? We have problems with some really cluttered DocBook elements. Just think about a listitem. You always need to put at least a simpara into a listitem. What do you need to insert if you would like to put in some PHP code? A programlisting with role="php"... And I think everybody remembers the discussions about using a container tag for see alsos, and a list tag in it, with paras in each list item, with the linked endpoint in each para. Huh. II) *So* how can we solve the problem? a) Macros in editors and/or using XML editors... Advantage: no need to modify xml files and/or the used language Problem: sometimes you have no XML editor at hand, and this won't make our XML code readable. Cluttered xml files. b) Customize DocBook, write own stye sheets for processing new tags, and customize the DTD Advantage: using our own tags, readable XML files Problem: there are ready made tools for docbook, and this would make the usage of those tools impossible or at least hard c) Build a new language on top of DocBook, and provide some simple conversion style sheets from our language to DocBook. Advantage: using our own tags, readable XML files, simple DTD (only those tags we use) Problem: more processing time, DocBook as an intermediary language Now I would like to extend point c) as this is a new idea (and quite interesting in my eyes). This may be good for our needs. So what about inventing some shortcut tags for our problematic parts add some tags to DocBook, remove those we never use and name the language eg. PHPBook. This way we would have a simple language, which we can convert to DocBook anytime to use the DocBook tools already available. What we only need to do is to run a simple 1-2KB XSLT sheet on all XML files before we run the HTML / FO sheets on them. I don't think so that the [probably very small] performance decrease would be less then the ease of editing. An example: DocBook: text in here more text in here PHPBook: text in here more text in here For php codes: So this would be a wrapper around DocBook, as we can map all our new tags to DocBook equivalents with *extremely* simple XSLT sheets. This way we can invent any easy XML syntaxes for see also lists for example, like: echo Session stuff Then we can convert this automatically to any valid DocBook XML stuff to take advantage of ready made XSLT sheets and conversion programs. I can volunteer in the creation of these simple XSLT sheets, and the PHPBook DTD (simplified and extended DocBook) if we can come up with some structures to ease our lives. And remember, that this idea may be completely useless, but may be good enough to implement. We need more discussion on this ;) Goba
[PHP-DOC] cvs: phpdoc /de Translators
mk Sat Mar 16 05:42:12 2002 EDT Modified files: /phpdoc/de Translators Log: Preface is now uptodate. Index: phpdoc/de/Translators diff -u phpdoc/de/Translators:1.277 phpdoc/de/Translators:1.278 --- phpdoc/de/Translators:1.277 Tue Mar 12 12:14:18 2002 +++ phpdoc/de/Translators Sat Mar 16 05:42:12 2002 @@ -206,10 +206,8 @@ types.xml Friedhelm Betz fertig (bis 1.70) variables.xml Friedhelm Betz fertig (bis 1.32) - -preface.xml Egon Schmid fertig - - pear --Nicht mehr im Manual - +preface.xml Egon Schmid fertig +Mark Kronsbein fertig (bis 1.25) - Anmerkung: Dateien mit *** existieren nicht mehr im englischen Original.
[PHP-DOC] cvs: phpdoc /de preface.xml
mk Sat Mar 16 05:40:40 2002 EDT Modified files: /phpdoc/de preface.xml Log: Preface is now uptodate. Index: phpdoc/de/preface.xml diff -u phpdoc/de/preface.xml:1.11 phpdoc/de/preface.xml:1.12 --- phpdoc/de/preface.xml:1.11 Wed Dec 19 09:42:41 2001 +++ phpdoc/de/preface.xml Sat Mar 16 05:40:40 2002 @@ -1,43 +1,33 @@ + + Vorwort -PHP ist die Abkürzung für "PHP: Hypertext -Preprocessor", eine Skriptsprache, die sich in HTML -einbinden lässt. Viele der syntaktischen Möglichkeiten sind den -Programmiersprachen C, Java und Perl entnommen und es wurden auch -einige PHP-spezifische Features entwickelt. Das Ziel der Sprache -ist es, das Schreiben von Programmen zur Erzeugung von dynamisch -generierten Seiten zu erleichtern und zu beschleunigen. +PHP ist die Abkürzung für "PHP: Hypertext +Preprocessor", eine weitverbreitete Open Source Skriptsprache speziell +für Webentwicklungen. PHP läßt sich in HTML einbinden. Seine Syntax erinnert +an C, Java und Perl und es ist einfach zu erlernen. Das Hauptziel dieser Sprache +ist es, Webentwicklern die Möglichkeit zu geben, schnell dynamisch generierte +Webseiten zu erzeugen. Aber PHP knn noch mehr. - - Über dieses Handbuch - -Dieses Handbuch ist in XML geschrieben und -verwendet die DocBook XML -DTD und DSSSL (Document Style -and Semantics Specification Language) für die Formatierung. Die -Tools zur Transformation in HTML, -TeX und RTF sind Jade von James -Clark und die Modularen DocBook -Stylesheets von Norman -Walsh. Die Programme zur Herstellung des PHP Handbuchs -werden von &link.stig; gepflegt. - - -Dieses HTML Handbuch wird jeden Tag neu erzeugt und kann bei -&url.php.snaps.manual; -bezogen werden. - - + + Dieses Handbuch besteht vorranging aus einer Funktionsreferenz, enthält aber +zusätzlich auch eine + Sprachreferenz, Erklärungen zu den wichtigsten Features und anderen ergänzenden +Informationen. + + + Sie können dieses Handbuch in verschiedenen Formaten unter &url.php.docs; herunterladen. Die Downloads werden +upgedated + sobald sich der Inhalt verändert. Weitere Informationen darüber, wie dieses +Handbuch erstellt wird + finden Sie im Kapitel 'Über dieses Handbuch' + appendix. + +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> \ No newline at end of file
[PHP-DOC] cvs: phpdoc /de/functions cybermut.xml
mk Sat Mar 16 05:26:43 2002 EDT Modified files: /phpdoc/de/functionscybermut.xml Log: Typo Index: phpdoc/de/functions/cybermut.xml diff -u phpdoc/de/functions/cybermut.xml:1.1 phpdoc/de/functions/cybermut.xml:1.2 --- phpdoc/de/functions/cybermut.xml:1.1Tue Mar 12 12:14:41 2002 +++ phpdoc/de/functions/cybermut.xmlSat Mar 16 05:26:43 2002 @@ -1,5 +1,5 @@ - + Crédit Mutuel CyberMUT functions @@ -27,7 +27,7 @@ Die Verwendung dieser Funktionen ist weitgehend identisch mit den original Funktionen, bis auf die Rückgabewerte der Funktionen cybermut_creerformulairecm und cybermut_creerreponsecm, -welche vond en PHP-Funktionen direkt zurückgegeben werden und in den Originalfunktionen nur referenziert werden. +welche von den PHP-Funktionen direkt zurückgegeben werden und in den +Originalfunktionen nur referenziert werden. Diese Funktionen wurden in PHP 4.0.6 hinzugefügt.
