Groups

[phpdoc-zh] r231 committed - 翻译函数：extension_loaded、gc_collect_cycles、dc_disable、gc_enable、gc_enable...

13 views

Skip to first unread message

phpd...@googlecode.com

unread,

May 22, 2012, 5:49:50 AM5/22/12

to phpd...@googlegroups.com

Revision: 231
Author: ice.shiny
Date: Tue May 22 02:49:20 2012
Log: 翻译函数：extension_loaded、gc_collect_cycles、dc_disable、
gc_enable、gc_enabled、get_current_user、get_defined_constants、
get_include_path、get_included_files、get_magic_quotes_gpc、getlastmod、
getmyinode、getmypid、getmyuid、memory_get_peak_usage以及memory_get_usage
http://code.google.com/p/phpdoc-zh/source/detail?r=231

Added:
/trunk/xml/reference/info/functions/extension-loaded.xml
/trunk/xml/reference/info/functions/gc-collect-cycles.xml
/trunk/xml/reference/info/functions/gc-disable.xml
/trunk/xml/reference/info/functions/gc-enable.xml
/trunk/xml/reference/info/functions/gc-enabled.xml
/trunk/xml/reference/info/functions/get-current-user.xml
/trunk/xml/reference/info/functions/get-defined-constants.xml
/trunk/xml/reference/info/functions/get-include-path.xml
/trunk/xml/reference/info/functions/get-included-files.xml
/trunk/xml/reference/info/functions/get-magic-quotes-gpc.xml
/trunk/xml/reference/info/functions/getlastmod.xml
/trunk/xml/reference/info/functions/getmyinode.xml
/trunk/xml/reference/info/functions/getmypid.xml
/trunk/xml/reference/info/functions/getmyuid.xml
/trunk/xml/reference/info/functions/memory-get-peak-usage.xml
/trunk/xml/reference/info/functions/memory-get-usage.xml

=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/extension-loaded.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.extension-loaded"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>extension_loaded</refname>
+ <refpurpose>检测一个扩展是否已经加载</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>extension_loaded</methodname>
+
<methodparam><type>string</type><parameter>name</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 检测一个扩展是否已经加载。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>name</parameter></term>
+ <listitem>
+ <para>
+ 扩展的名称。
+ </para>
+ <para>
+ 使用 <function>phpinfo</function> 函数后你可以看到各个扩展的名称。如
果你用的是 <literal>CGI</literal> 或者 <literal>CLI</literal> 版本的PHP，你
可以使用 <option>-m</option> 选项来列出所有启用的扩展。
+ <screen>
+<![CDATA[
+$ php -m
+[PHP Modules]
+xml
+tokenizer
+standard
+sockets
+session
+posix
+pcre
+overload
+mysql
+mbstring
+ctype
+
+[Zend Modules]
+]]>
+ </screen>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果指定 <parameter>name</parameter> 的扩展已经加载则返回 &true;，否则返
回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>extension_loaded</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+if (!extension_loaded('gd')) {
+ if (!dl('gd.so')) {
+ exit;
+ }
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ <function>extension_loaded</function> 使用了内部扩展的名字来测试指
定的扩展是否已经启用。绝大多数的内部扩展名称用是小写的，不过部分扩展名也有大
写的。
+ 在PHP5之前本函数对扩展名是大小写敏感的。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>get_loaded_extensions</function></member>
+ <member><function>get_extension_funcs</function></member>
+ <member><function>phpinfo</function></member>
+ <member><function>dl</function></member>
+ <member><function>function_exists</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/gc-collect-cycles.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.gc-collect-cycles"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>gc_collect_cycles</refname>
+ <refpurpose>强制收集任何存在的垃圾循环</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>gc_collect_cycles</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 强制收集任何存在的垃圾循环。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回收集了的循环数量。
+ </para>
+ </refsect1>
+
+ 
+
+ 
+
+ 
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><link linkend="features.gc">垃圾回收机制</link></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/gc-disable.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.gc-disable"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>gc_disable</refname>
+ <refpurpose>停用循环引用收集器</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>void</type><methodname>gc_disable</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 停用循环引用收集器，把
+ <link linkend="ini.zend.enable-gc">zend.enable_gc</link> 设置为
<literal>0</literal>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.void;
+ </para>
+ </refsect1>
+
+ 
+
+ 
+
+ 
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><link linkend="features.gc">垃圾回收</link></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/gc-enable.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.gc-enable"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>gc_enable</refname>
+ <refpurpose>启用循环引用收集器</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>void</type><methodname>gc_enable</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 启用循环引用收集器，设置
+ <link linkend="ini.zend.enable-gc">zend.enable_gc</link> 为
<literal>1</literal>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.void;
+ </para>
+ </refsect1>
+
+ 
+
+ 
+
+ 
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><link linkend="features.gc">垃圾回收机制</link></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/gc-enabled.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.gc-enabled"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>gc_enabled</refname>
+ <refpurpose>返回循环引用收集器的启用状态</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>gc_enabled</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 返回循环引用收集器是否启用的状态。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果垃圾收集器启用了返回 &true;，否则返回 &false;。
+ </para>
+ </refsect1>
+
+ 
+
+ 
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>A <function>gc_enabled</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+if(gc_enabled()) gc_collect_cycles();
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><link linkend="features.gc">垃圾回收机制</link></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/get-current-user.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.get-current-user"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>get_current_user</refname>
+ <refpurpose>获取当前PHP脚本拥有者的名字</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>string</type><methodname>get_current_user</methodname>
+ <void/>
+ </methodsynopsis>
+ <simpara>
+ 返回当前PHP脚本拥有者的名称。
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 以字符串形式返回用户名。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>get_current_user</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+echo 'Current script owner: ' . get_current_user();
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+Current script owner: SYSTEM
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>getmyuid</function></member>
+ <member><function>getmygid</function></member>
+ <member><function>getmypid</function></member>
+ <member><function>getmyinode</function></member>
+ <member><function>getlastmod</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/get-defined-constants.xml Tue May
22 02:49:20 2012
@@ -0,0 +1,209 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.get-defined-constants"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>get_defined_constants</refname>
+ <refpurpose>返回所有常量名与其值的关联数组</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>get_defined_constants</methodname>
+ <methodparam
choice="opt"><type>bool</type><parameter>categorize</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 返回当前已经定义的常量名与其值。包括了通过扩展和
<function>define</function> 创建的常量。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>categorize</parameter></term>
+ <listitem>
+ <para>
+ 使本函数返回包含分类的多维数组，分类在第一维，常量名与它的值在第二
维。
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+define("MY_CONSTANT", 1);
+print_r(get_defined_constants(true));
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+Array
+(
+ [Core] => Array
+ (
+ [E_ERROR] => 1
+ [E_WARNING] => 2
+ [E_PARSE] => 4
+ [E_NOTICE] => 8
+ [E_CORE_ERROR] => 16
+ [E_CORE_WARNING] => 32
+ [E_COMPILE_ERROR] => 64
+ [E_COMPILE_WARNING] => 128
+ [E_USER_ERROR] => 256
+ [E_USER_WARNING] => 512
+ [E_USER_NOTICE] => 1024
+ [E_ALL] => 2047
+ [TRUE] => 1
+ )
+
+ [pcre] => Array
+ (
+ [PREG_PATTERN_ORDER] => 1
+ [PREG_SET_ORDER] => 2
+ [PREG_OFFSET_CAPTURE] => 256
+ [PREG_SPLIT_NO_EMPTY] => 1
+ [PREG_SPLIT_DELIM_CAPTURE] => 2
+ [PREG_SPLIT_OFFSET_CAPTURE] => 4
+ [PREG_GREP_INVERT] => 1
+ )
+
+ [user] => Array
+ (
+ [MY_CONSTANT] => 1
+ )
+
+)
+]]>
+ </screen>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.1</entry>
+ <entry>
+ 仅针对Windows：核心常量分类到 <literal>Core</literal>，而之前是
<literal>mhash</literal>。
+ </entry>
+ </row>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ 核心常量分类到 <literal>Core</literal>，之前是
+ <literal>internal</literal>。在Windows上，核心常量分类到
<literal>mhash</literal>。
+ </entry>
+ </row>
+ <row>
+ <entry>5.2.11</entry>
+ <entry>
+ <parameter>categorize</parameter> 参数现在已经能够以合理方式解析。
+ 在此之前 <parameter>categorize</parameter> 参数被解析成
+ <literal>!is_null($categorize)</literal>，不为 &null; 的任何值将强
制常量进行分类。
+ </entry>
+ </row>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ 参数 <parameter>categorize</parameter> 被添加。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>get_defined_constants</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+print_r(get_defined_constants());
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+Array
+(
+ [E_ERROR] => 1
+ [E_WARNING] => 2
+ [E_PARSE] => 4
+ [E_NOTICE] => 8
+ [E_CORE_ERROR] => 16
+ [E_CORE_WARNING] => 32
+ [E_COMPILE_ERROR] => 64
+ [E_COMPILE_WARNING] => 128
+ [E_USER_ERROR] => 256
+ [E_USER_WARNING] => 512
+ [E_USER_NOTICE] => 1024
+ [E_ALL] => 2047
+ [TRUE] => 1
+)
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>defined</function></member>
+ <member><function>get_loaded_extensions</function></member>
+ <member><function>get_defined_functions</function></member>
+ <member><function>get_defined_vars</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/get-include-path.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.get-include-path"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>get_include_path</refname>
+ <refpurpose>获取当前的 include_path 配置选项</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>string</type><methodname>get_include_path</methodname>
+ <void />
+ </methodsynopsis>
+ <simpara>
+ 获取当前 <link linkend="ini.include-path">include_path</link> 配置选项
值。
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回 path 的字符串值。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>get_include_path</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// 自PHP 4.3.0始可以工作
+echo get_include_path();
+
+// 在所有版本的PHP中均可运行
+echo ini_get('include_path');
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>ini_get</function></member>
+ <member><function>restore_include_path</function></member>
+ <member><function>set_include_path</function></member>
+ <member><function>include</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/get-included-files.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.get-included-files"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>get_included_files</refname>
+ <refpurpose>返回include或者required文件名的数组。</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>get_included_files</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 获取所有被 <function>include</function>、
<function>include_once</function>、
+ <function>require</function> 或者 <function>require_once</function> 的文
件。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回所有文件名的数组。
+ </para>
+ <para>
+ 原始脚本也视为一个“被包含的文件”，所以它也会和
<function>include</function> 以及系列函数的文件中一起列出。
+ </para>
+ <para>
+ 被多次include或者require的文件在返回的数组中仅仅显示一次。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.0.1</entry>
+ <entry>
+ 在PHP 4.0.1以及之前的版本，本函数会假设包含的文件以
<literal>.php</literal>结尾，其他扩展名结尾的文件将不会被返回。
+ <function>get_included_files</function> 返回的关联数组仅仅列出被
<function>include</function> 和
+ <function>include_once</function>的文件。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>get_included_files</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// 本文件是 abc.php
+
+include 'test1.php';
+include_once 'test2.php';
+require 'test3.php';
+require_once 'test4.php';
+
+$included_files = get_included_files();
+
+foreach ($included_files as $filename) {
+ echo "$filename\n";
+}
+
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+abc.php
+test1.php
+test2.php
+test3.php
+test4.php
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ 使用 <literal>auto_prepend_file</literal> 配置指令来include的文件不会在
返回的数组中列出。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>include</function></member>
+ <member><function>include_once</function></member>
+ <member><function>require</function></member>
+ <member><function>require_once</function></member>
+ <member><function>get_required_files</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/get-magic-quotes-gpc.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.get-magic-quotes-gpc"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>get_magic_quotes_gpc</refname>
+ <refpurpose>获取当前magic_quotes_gpc的设置</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>get_magic_quotes_gpc</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 获取当前 <link
+ linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> 的设置。
+ </para>
+ <para>
+ 请注意，尝试在运行时设置 <link linkend="ini.magic-quotes-gpc">
+ magic_quotes_gpc</link> 是没用的。
+ </para>
+ <para>
+ 更多关于magic_quotes的信息请移步至 <link
linkend="security.magicquotes">安全</link>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 当 magic_quotes_gpc 是关闭的则返回 0，否则返回 1。而在 PHP 5.4.0 及以后
将始终返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.4.0</entry>
+ <entry>
+ 总是返回 &false;，因为magic quotes功能已经从PHP中移除了。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>get_magic_quotes_gpc</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// 如果启用了magic quotes
+echo $_POST['lastname']; // O\'reilly
+echo addslashes($_POST['lastname']); // O\\\'reilly
+
+// 适用所有PHP版本的用法
+if (get_magic_quotes_gpc()) {
+ $lastname = stripslashes($_POST['lastname']);
+}
+else {
+ $lastname = $_POST['lastname'];
+}
+
+// 如果使用MySQL
+$lastname = mysql_real_escape_string($lastname);
+
+echo $lastname; // O\'reilly
+$sql = "INSERT INTO lastnames (lastname) VALUES ('$lastname')";
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ 如果 <link linkend="ini.magic-quotes-sybase">
+ magic_quotes_sybase</link> 设置为ON，它将完全覆盖 <link
linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>的设置。
+ 所以即使 <function>get_magic_quotes_gpc</function> 返回了
+ &true; 也不会对双引号、反斜杠和空字节（NUL）进行转义，仅对单引号进行转
义，看上去就像 <emphasis>''</emphasis>。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>addslashes</function></member>
+ <member><function>stripslashes</function></member>
+ <member><function>get_magic_quotes_runtime</function></member>
+ <member><function>ini_get</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/getlastmod.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.getlastmod"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>getlastmod</refname>
+ <refpurpose>获取页面最后修改的时间</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>getlastmod</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 获取当前页面的最后修改时间。
+ </para>
+ <para>
+ 如果你想要获取其他文件的最后修改时间，可以考虑使用
<function>filemtime</function>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回当前页面的最后修改时间，返回值是一个Unix时间戳（timestamp），可以传
入 <function>date</function>。失败时返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>getlastmod</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// 输出示例： 'Last modified: March 04 1998 20:43:59.'
+echo "Last modified: " . date ("F d Y H:i:s.", getlastmod());
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>date</function></member>
+ <member><function>getmyuid</function></member>
+ <member><function>getmygid</function></member>
+ <member><function>get_current_user</function></member>
+ <member><function>getmyinode</function></member>
+ <member><function>getmypid</function></member>
+ <member><function>filemtime</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/getmyinode.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.getmyinode"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>getmyinode</refname>
+ <refpurpose>获取当前脚本的索引节点（inode）</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>getmyinode</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 获取当前脚本的索引节点（inode）。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 获取当前脚本索引节点（inode）的integer值，错误时返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>getmygid</function></member>
+ <member><function>getmyuid</function></member>
+ <member><function>getmypid</function></member>
+ <member><function>get_current_user</function></member>
+ <member><function>getlastmod</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/getmypid.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.getmypid" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>getmypid</refname>
+ <refpurpose>获取PHP进程ID</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>getmypid</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 获取当前PHP进程ID。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回当前的PHP进程ID，失败时返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <warning>
+ <para>
+ 进程的ID并不是唯一的，因此是一个弱熵的源。在对安全性有依赖的情况下我们
推荐使用pid。
+ </para>
+ </warning>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>getmygid</function></member>
+ <member><function>getmyuid</function></member>
+ <member><function>get_current_user</function></member>
+ <member><function>getmyinode</function></member>
+ <member><function>getlastmod</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/getmyuid.xml Tue May 22 02:49:20
2012
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.getmyuid" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>getmyuid</refname>
+ <refpurpose>获取PHP脚本拥有者的UID</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>getmyuid</methodname>
+ <void/>
+ </methodsynopsis>
+ <simpara>
+ 获取当年脚本的用户ID。
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回当前脚本的用户ID，失败时返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>getmygid</function></member>
+ <member><function>getmypid</function></member>
+ <member><function>get_current_user</function></member>
+ <member><function>getmyinode</function></member>
+ <member><function>getlastmod</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/memory-get-peak-usage.xml Tue May
22 02:49:20 2012
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.memory-get-peak-usage"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>memory_get_peak_usage</refname>
+ <refpurpose>返回PHP使用内存的峰值</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>memory_get_peak_usage</methodname>
+ <methodparam
choice="opt"><type>bool</type><parameter>real_usage</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 返回你的PHP脚本所使用内存的峰值，单位是字节（bytes）。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>real_usage</parameter></term>
+ <listitem>
+ <para>
+ 将本参数设置为 &true; 来获取从系统分配使用内存的实际尺寸。如果不设置
或者设置为 &false; 仅仅会显示
+ <literal>emalloc()</literal> 分配的内存值。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回内存使用峰值的字节数。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.2.1</entry>
+ <entry>
+ 不使用编译参数 <link
linkend="ini.memory-limit">--enable-memory-limit</link> 也能启用本函数。
+ </entry>
+ </row>
+ <row>
+ <entry>5.2.0</entry>
+ <entry>
+ 添加了参数 <parameter>real_usage</parameter>。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>memory_get_usage</function></member>
+ <member><link linkend="ini.memory-limit">memory_limit</link></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/info/functions/memory-get-usage.xml Tue May 22
02:49:20 2012
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.memory-get-usage"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>memory_get_usage</refname>
+ <refpurpose>返回PHP分配的内存量</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>memory_get_usage</methodname>
+ <methodparam
choice="opt"><type>bool</type><parameter>real_usage</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 返回当前分配给你PHP脚本的内存字节数。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>real_usage</parameter></term>
+ <listitem>
+ <para>
+ 设置本参数为 &true; 来获取系统内存的真实消耗，若没设置或者设置为
&false; 仅会返回
+ <literal>emalloc()</literal> 所分配到的内存量。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回内存使用字节数。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.2.1</entry>
+ <entry>
+ 不使用编译参数 <link
linkend="ini.memory-limit">--enable-memory-limit</link> 也能启用本函数。
+ </entry>
+ </row>
+ <row>
+ <entry>5.2.0</entry>
+ <entry>
+ 增加参数 <parameter>real_usage</parameter>。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>memory_get_usage</function> 示例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// 这只是个示例，下面显示数量的差异取决于你的系统
+
+echo memory_get_usage() . "\n"; // 36640
+
+$a = str_repeat("Hello", 4242);
+
+echo memory_get_usage() . "\n"; // 57960
+
+unset($a);
+
+echo memory_get_usage() . "\n"; // 36744
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>memory_get_peak_usage</function></member>
+ <member><link linkend="ini.memory-limit">memory_limit</link></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+

Reply all

Reply to author

Forward

0 new messages

Search

Clear search

Close search

Google apps

Main menu