Sync var functions

reference/var/functions/get-debug-type.xml

@@ -0,0 +1,209 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 0edc11c6c46753ef0b81d0060b925b4f58552996 Maintainer: Luffy Status: ready -->
+<refentry xml:id="function.get-debug-type" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>get_debug_type</refname>
+  <refpurpose>以适合调试的方式获取变量的类型名称</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>get_debug_type</methodname>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   会返回 PHP 变量 <parameter>value</parameter> 的类型名称。
+   该函数会将对象解析为其类名，资源解析为其资源类型名称，标量值解析为其常用名称，就像在类型声明中使用的那样。
+  </para>
+  <para>
+   该函数与 <function>gettype</function> 的区别在于：它返回的类型名称更符合实际用法，而不是那些出于历史原因而存在的名称。
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>value</parameter></term>
+     <listitem>
+      <para>
+       要检查类型的变量。
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+    返回的字符串可能有以下值：
+
+     <informaltable>
+      <tgroup cols="2">
+       <thead>
+        <row>
+         <entry>类型 + 状态</entry>
+         <entry>返回值</entry>
+         <entry>备注</entry>
+        </row>
+       </thead>
+       <tbody>
+        <row>
+         <entry>null</entry>
+         <entry>
+          <literal>"null"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Booleans (true or false)</entry>
+         <entry>
+          <literal>"bool"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Integers</entry>
+         <entry>
+          <literal>"int"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Floats</entry>
+         <entry>
+          <literal>"float"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Strings</entry>
+         <entry>
+          <literal>"string"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Arrays</entry>
+         <entry>
+          <literal>"array"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Resources</entry>
+         <entry>
+          <literal>"resource (resourcename)"</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Resources (Closed)</entry>
+         <entry>
+          <literal>"resource (closed)"</literal>
+         </entry>
+         <entry>例如：使用 fclose 关闭后的文件流</entry>
+        </row>
+        <row>
+         <entry>Objects from Named Classes</entry>
+         <entry>
+          类的全名，包括其命名空间，例如 <literal>Foo\Bar</literal>
+         </entry>
+         <entry>-</entry>
+        </row>
+        <row>
+         <entry>Objects from Anonymous Classes</entry>
+         <entry>
+          <literal>"class@anonymous"</literal>
+         </entry>
+         <entry>
+          匿名类是通过 $x = new class { ... } 语法创建的类
+         </entry>
+        </row>
+       </tbody>
+      </tgroup>
+     </informaltable>
+  </para>
+ </refsect1>
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>get_debug_type</function> 示例</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+echo get_debug_type(null) . PHP_EOL;
+echo get_debug_type(true) . PHP_EOL;
+echo get_debug_type(1) . PHP_EOL;
+echo get_debug_type(0.1) . PHP_EOL;
+echo get_debug_type("foo") . PHP_EOL;
+echo get_debug_type([]) . PHP_EOL;
+
+$fp = fopen(__FILE__, 'rb');
+echo get_debug_type($fp) . PHP_EOL;
+
+fclose($fp);
+echo get_debug_type($fp) . PHP_EOL;
+
+echo get_debug_type(new stdClass) . PHP_EOL;
+echo get_debug_type(new class {}) . PHP_EOL;
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+null
+bool
+int
+float
+string
+array
+resource (stream)
+resource (closed)
+stdClass
+class@anonymous
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>gettype</function></member>
+    <member><function>get_class</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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:"~/.phpdoc/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
+-->

reference/var/functions/get-resource-id.xml

@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 77887dc8e5ee9e840f0ed440431c70259fcc5661 Maintainer: Luffy Status: ready -->
+<refentry xml:id="function.get-resource-id" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>get_resource_id</refname>
+  <refpurpose>
+   返回给定资源的整数标识符
+  </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>int</type><methodname>get_resource_id</methodname>
+   <methodparam><type>resource</type><parameter>resource</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   此函数提供了一种类型安全的方式来生成资源的整数标识符。
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>resource</parameter></term>
+     <listitem>
+      <para>
+       需要获取的资源句柄。
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   给定 <parameter>resource</parameter> 的 <type>int</type> 标识符。 
+  </para>
+  <para>
+   此函数本质上是对 <parameter>resource</parameter> 的 <type>int</type> 转换，使得更容易获取资源的标识符。
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>get_resource_id</function> 与 <type>int</type> 转换的结果相同</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$handle = fopen("php://stdout", "w");
+
+echo (int) $handle . "\n";
+
+echo get_resource_id($handle);
+
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen role="php">
+<![CDATA[
+698
+698
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>get_resource_type</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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:"~/.phpdoc/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
+-->