1
0
mirror of https://github.com/php/doc-ja.git synced 2026-04-29 11:03:19 +02:00
Files
archived-doc-ja/reference/info/functions/php-uname.xml
T
Satoru Yoshida 424b17a7a8 sync en
git-svn-id: https://svn.php.net/repository/phpdoc/ja/trunk@346769 c90b9560-bf6c-de11-be94-00142212c4b1
2019-02-10 05:07:02 +00:00

184 lines
5.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8f9ebc8686e881bee5cc68828a004b722c62bc3b Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi -->
<refentry xml:id="function.php-uname" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>php_uname</refname>
<refpurpose>PHP が稼動しているオペレーティングシステムに関する情報を返す</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>php_uname</methodname>
<methodparam choice="opt"><type>string</type><parameter>mode</parameter><initializer>"a"</initializer></methodparam>
</methodsynopsis>
<para>
<function>php_uname</function> は、PHP が稼動しているオペレーティング
システムに関する説明を返します。これは、<function>phpinfo</function>
の出力の先頭に出てくるものと同じです。
単に OS の名前を取得したい場合には
<constant>PHP_OS</constant> 定数の利用を考えてください。ただし、
この定数が返すのは PHP が<emphasis>構築された</emphasis> OS の
情報であることに注意しましょう。
</para>
<para>
古い UNIX プラットフォームの中には現在の OS 情報を取得できないものもあります。
そんな場合は、PHP をビルドした OS の情報を表示します。
これがおこるのは、 uname() ライブラリコールが存在しないか機能していない場合のみです。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
<parameter>mode</parameter> は、どのような情報を返すのかを一文字で指定します:
<itemizedlist>
<listitem>
<simpara>
<literal>'a'</literal>: デフォルトです。すべてのモードを
<literal>"s n r v m"</literal> の順で返します。
</simpara>
</listitem>
<listitem>
<simpara>
<literal>'s'</literal>: オペレーティングシステム名。
例: <literal>FreeBSD</literal>
</simpara>
</listitem>
<listitem>
<simpara>
<literal>'n'</literal>: ホスト名。
例: <literal>localhost.example.com</literal>
</simpara>
</listitem>
<listitem>
<simpara>
<literal>'r'</literal>: リリース名。
例: <literal>5.1.2-RELEASE</literal>
</simpara>
</listitem>
<listitem>
<simpara>
<literal>'v'</literal>: バージョン情報。
オペレーティングシステムによって大きく変わります。
</simpara>
</listitem>
<listitem>
<simpara>
<literal>'m'</literal>: マシン型。例: <literal>i386</literal>
</simpara>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
説明を文字列で返します。
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>php_uname</function> の例</title>
<programlisting role="php">
<![CDATA[
<?php
echo php_uname();
echo PHP_OS;
/* 出力の例
Linux localhost 2.4.21-0.13mdk #1 Fri Mar 14 15:08:06 EST 2003 i686
Linux
FreeBSD localhost 3.2-RELEASE #15: Mon Dec 17 08:46:02 GMT 2001
FreeBSD
Windows NT XN1 5.1 build 2600
WINNT
*/
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
echo 'このサーバーは Windows です!';
} else {
echo 'このサーバーは Windows ではありません!';
}
?>
]]>
</programlisting>
</example>
</para>
<para>
関連する
<link linkend="language.constants.predefined">定義済みの定数</link>
を使うほうが簡単なこともあります。例えばこのようになります。
<example>
<title>OS 関連の定数の例</title>
<programlisting role="php">
<![CDATA[
<?php
// *nix
echo DIRECTORY_SEPARATOR; // /
echo PHP_SHLIB_SUFFIX; // so
echo PATH_SEPARATOR; // :
// Win*
echo DIRECTORY_SEPARATOR; // \
echo PHP_SHLIB_SUFFIX; // dll
echo PATH_SEPARATOR; // ;
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>phpversion</function></member>
<member><function>php_sapi_name</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
-->