[phpdoc-zh] r228 committed - [PHPDOC-ZH] [翻译] reference.json...

6 views

Skip to first unread message

phpd...@googlecode.com

unread,

May 15, 2012, 5:18:44 AM5/15/12

to phpd...@googlegroups.com

Revision: 228
Author: ice.shiny
Date: Tue May 15 02:18:21 2012
Log: [PHPDOC-ZH] [翻译] reference.json
1、翻译一节中新增部分；
2、修改json-last-error中CTRL_CHAR的翻译
http://code.google.com/p/phpdoc-zh/source/detail?r=228

Added:
/trunk/xml/reference/json/book.xml
/trunk/xml/reference/json/constants.xml
/trunk/xml/reference/json/jsonserializable
/trunk/xml/reference/json/jsonserializable/jsonserialize.xml
/trunk/xml/reference/json/jsonserializable.xml
/trunk/xml/reference/json/setup.xml
Modified:
/trunk/xml/reference/json/functions/json-last-error.xml

=======================================
--- /dev/null
+++ /trunk/xml/reference/json/book.xml Tue May 15 02:18:21 2012
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+
+<book xml:id="book.json" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>JavaScript Object Notation</title>
+ <titleabbrev>JSON</titleabbrev>
+
+ <preface xml:id="intro.json">
+ &reftitle.intro;
+ <para>
+ 本扩展实现了 <link
+ xlink:href="&url.json;">JavaScript Object Notation (JSON)</link>
+ 数据交换格式。编码处理解析器基于 Douglas Crockford 的JSON_checker。
+ </para>
+ </preface>
+
+ &reference.json.setup;
+ &reference.json.constants;
+ &reference.json.jsonserializable;
+ &reference.json.reference;
+
+</book>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/json/constants.xml Tue May 15 02:18:21 2012
@@ -0,0 +1,232 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+<appendix xml:id="json.constants" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &extension.constants;
+ <para>
+ 以下常量是 <function>json_last_error</function> 返回的错误类型。
+ </para>
+ <variablelist>
+ <varlistentry xml:id="constant.json-error-none">
+ <term>
+ <constant>JSON_ERROR_NONE</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 没有发生错误
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-error-depth">
+ <term>
+ <constant>JSON_ERROR_DEPTH</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 超过了最大堆栈深度。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-error-state-mismatch">
+ <term>
+ <constant>JSON_ERROR_STATE_MISMATCH</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 无效或异常的JSON
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-error-ctrl-char">
+ <term>
+ <constant>JSON_ERROR_CTRL_CHAR</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 控制字符错误，也许使用了错误的编码。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-error-syntax">
+ <term>
+ <constant>JSON_ERROR_SYNTAX</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 语法错误。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-error-utf8">
+ <term>
+ <constant>JSON_ERROR_UTF8</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 异常的 UTF-8 字符，也许是因为错误的编码。
+ 从 PHP 5.3.1 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>
+ 以下常量用于 <function>json_encode</function> 函数选项。
+ </para>
+ <variablelist>
+ <varlistentry xml:id="constant.json-hex-tag">
+ <term>
+ <constant>JSON_HEX_TAG</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 所有的 < 和 > 转换成 \u003C 和 \u003E。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-hex-amp">
+ <term>
+ <constant>JSON_HEX_AMP</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 所有 & 转换成 \u0026。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-hex-apos">
+ <term>
+ <constant>JSON_HEX_APOS</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 所有的 ' 转换成 \u0027。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-hex-quot">
+ <term>
+ <constant>JSON_HEX_QUOT</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 所有的 " 转化成 \u0022。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-force-object">
+ <term>
+ <constant>JSON_FORCE_OBJECT</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 用于非关联数组时输出 object 而不是 array，在接收者需要一个 object、而
array 是空时尤其有用。
+ 从 PHP 5.3.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-numeric-check">
+ <term>
+ <constant>JSON_NUMERIC_CHECK</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 将数字形式的字符串编码成数字。
+ 从 PHP 5.3.3 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-bigint-as-string">
+ <term>
+ <constant>JSON_BIGINT_AS_STRING</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 将大整数编码成原始字符串中的值。
+ 从 PHP 5.4.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-pretty-print">
+ <term>
+ <constant>JSON_PRETTY_PRINT</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 用空格格式化返回的数据。
+ 从 PHP 5.4.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-unescaped-slashes">
+ <term>
+ <constant>JSON_UNESCAPED_SLASHES</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 不要对 <literal>/</literal> 进行编码。
+ 从 PHP 5.4.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-unescaped-unicode">
+ <term>
+ <constant>JSON_UNESCAPED_UNICODE</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 按原始文字编码多字节的 Unicode 字符串 (默认是编码成 \uXXXX 的形式)。
+ 从 PHP 5.4.0 开始有效。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+</appendix>
+
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/json/jsonserializable/jsonserialize.xml Tue May 15
02:18:21 2012
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+<refentry xml:id="jsonserializable.jsonserialize"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>JsonSerializable::jsonSerialize</refname>
+ <refpurpose>指定即将被序列化成JSON的数据</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <modifier>abstract</modifier> <modifier>public</modifier>
<type>mixed</type><methodname>JsonSerializable::jsonSerialize</methodname>
+ <void />
+ </methodsynopsis>
+ <para>
+
+ </para>
+
+ &warn.undocumented.func;
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回的数据应当能被 <function>json_encode</function> 序列化。
+ </para>
+ </refsect1>
+
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/json/jsonserializable.xml Tue May 15 02:18:21 2012
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+<phpdoc:classref xml:id="class.jsonserializable"
xmlns:phpdoc="http://php.net/ns/phpdoc"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude">
+
+ <title>JsonSerializable接口</title>
+ <titleabbrev>JsonSerializable</titleabbrev>
+
+ <partintro>
+
+
+ <section xml:id="jsonserializable.intro">
+ &reftitle.intro;
+ <para>
+ 使用 <function>json_encode</function> 时，实现
<interfacename>JsonSerializable</interfacename> 接口的对象可以订制自己的
JSON 编码表示方法。
+ </para>
+ </section>
+
+
+ <section xml:id="jsonserializable.synopsis">
+ &reftitle.interfacesynopsis;
+
+
+ <classsynopsis>
+ <ooclass><classname>JsonSerializable</classname></ooclass>
+
+
+ <classsynopsisinfo>
+ <ooclass>
+ <classname>JsonSerializable</classname>
+ </ooclass>
+ </classsynopsisinfo>
+
+
+ <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook)
xpointer(id('class.jsonserializable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"
/>
+ </classsynopsis>
+
+
+ </section>
+
+ </partintro>
+
+ &reference.json.entities.jsonserializable;
+
+</phpdoc:classref>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/json/setup.xml Tue May 15 02:18:21 2012
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+<chapter xml:id="json.setup" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <section xml:id="json.requirements">
+ &reftitle.required;
+ &no.install;
+ </section>
+
+ <section xml:id="json.installation">
+ &reftitle.install;
+ <para>
+ 自 PHP 5.2.0 始，JSON 扩展被默认编译入PHP。
+ </para>
+ <para>
+ &pecl.info;
+ <link xlink:href="&url.pecl.package;json">&url.pecl.package;json</link>
+ </para>
+ </section>
+
+ <section xml:id="json.configuration">
+ &reftitle.runtime;
+ &no.config;
+ </section>
+
+ <section xml:id="json.resources">
+ &reftitle.resources;
+ &no.resource;
+ </section>
+
+</chapter>
+
+
+
=======================================
--- /trunk/xml/reference/json/functions/json-last-error.xml Tue May 15
01:40:51 2012
+++ /trunk/xml/reference/json/functions/json-last-error.xml Tue May 15
02:18:21 2012
@@ -55,7 +55,7 @@
</row>
<row>
<entry><constant>JSON_ERROR_CTRL_CHAR</constant></entry>
- <entry>Control字符错误，也许使用了错误的编码。</entry>
+ <entry>控制字符错误，也许使用了错误的编码。</entry>
<entry></entry>
</row>
<row>
@@ -65,7 +65,7 @@
</row>
<row>
<entry><constant>JSON_ERROR_UTF8</constant></entry>
- <entry>异常的 UTF-8 字符，也许是因为错误的编码</entry>
+ <entry>异常的 UTF-8 字符，也许是因为错误的编码。</entry>
<entry>PHP 5.3.3</entry>
</row>
</tbody>

Reply all

Reply to author

Forward

0 new messages