reference/info/functions/phpcredits.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f781803449007bb0e3a96c693e0eee067f7eb466 Maintainer: daijie Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.phpcredits" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>phpcredits</refname>
  <refpurpose>打印 PHP 贡献者名单</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>true</type><methodname>phpcredits</methodname>
   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>CREDITS_ALL</constant></initializer></methodparam>
  </methodsynopsis>
  <para>
   这个函数打印出了 PHP 开发者、模块等贡献者名单。
   它生成了合适、可嵌入信息到页面中的 HTML 代码。
  </para>   
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>flags</parameter></term>
     <listitem>
      <para>
       生成自定义的贡献者页面，你也许想要使用 <parameter>flags</parameter> 参数。
      </para>
      <para>
       <table>
        <title>预定义的 <function>phpcredits</function> flags</title>
        <tgroup cols="2">
         <thead>
          <row>
           <entry>名称</entry>
           <entry>描述</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry>CREDITS_ALL</entry>
           <entry>
            所有贡献者，等同于使用： <constant>CREDITS_DOCS</constant> +
            <constant>CREDITS_GENERAL</constant> + <constant>CREDITS_GROUP</constant> +
            <constant>CREDITS_MODULES</constant> + <constant>CREDITS_FULLPAGE</constant>。
            它以适当的标签产生了完整独立的 HTML 页面。
           </entry>
          </row>
          <row>
           <entry>CREDITS_DOCS</entry>
           <entry>文档组贡献名单</entry>
          </row>
          <row>
           <entry>CREDITS_FULLPAGE</entry>
           <entry>
            常用于和其他标志进行组合。
            表示需要打印包含其他标志表示信息的独立 HTML 页面。
           </entry>
          </row>
          <row>
           <entry>CREDITS_GENERAL</entry>
           <entry>
            普遍名单：语言设计与理念、PHP作者以及 SAPI 模块。
           </entry>
          </row>
          <row>
           <entry>CREDITS_GROUP</entry>
           <entry>核心开发者名单</entry>
          </row>
          <row>
           <entry>CREDITS_MODULES</entry>
           <entry>
            PHP 扩展模块以及它们的作者的清单
           </entry>
          </row>
          <row>
           <entry>CREDITS_SAPI</entry>
           <entry>
            PHP 的服务器 API 模块以及他们的作者的清单
           </entry>
          </row>
         </tbody>
        </tgroup>
       </table>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.true.always;
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>打印普遍名单</title>
    <programlisting role="php">
<![CDATA[
<?php
phpcredits(CREDITS_GENERAL);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>打印核心开发者和文档组</title>
    <programlisting role="php">
<![CDATA[
<?php
phpcredits(CREDITS_GROUP | CREDITS_DOCS | CREDITS_FULLPAGE);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>打印所有贡献者</title>
    <programlisting role="php">
<![CDATA[
<html>
 <head>
  <title>My credits page</title>
 </head>
 <body>
<?php
// 一些你自己的代码
phpcredits(CREDITS_ALL - CREDITS_FULLPAGE);
// 一些其他的代码
?>
 </body>
</html>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    在 CLI 模式下 <function>phpcredits</function> 输出明文而不是 HTML。
   </para>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>phpversion</function></member>
    <member><function>phpinfo</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
-->