<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.is-callable" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>is_callable</refname>

<refpurpose>

验证值是否可以在当前范围内作为函数调用

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>bool</type><methodname>is_callable</methodname>

<methodparam><type>mixed</type><parameter>value</parameter></methodparam>

<methodparam choice="opt"><type>bool</type><parameter>syntax_only</parameter><initializer>&false;</initializer></methodparam>

<methodparam choice="opt"><type>string</type><parameter role="reference">callable_name</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

验证 <parameter>value</parameter> 是 <type>callable</type>，或者其可以使用

<function>call_user_func</function> 函数调用。

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>value</parameter></term>

<listitem>

<para>

要验证的值。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>syntax_only</parameter></term>

<listitem>

<para>

如果设置为 &true;，则函数仅验证 <parameter>value</parameter>

是函数还是方法。它将拒绝任何不是<link linkend="object.invoke">可调用</link>对象、<classname>Closure</classname>、&string;

或者不能用作回调的无效结构的数组的值。有效的可调用数组只有

2 个条目，第一个是对象或者字符串，第二个是字符串。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>callable_name</parameter></term>

<listitem>

<para>

接受 “callable 名称”，例如 <literal>"SomeClass::someMethod"</literal>。注意，尽管

<literal>SomeClass::someMethod()</literal> 暗示是可调用静态方法，但事实并非如此。

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

如果 <parameter>value</parameter> 可调用则返回 &true;，否则返回 &false;。

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>检查字符串是否可以作为函数调用</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

<example>

<title>检查数组是否可以作为函数调用</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

<example>

<title><function>is_callable</function> 和构造方法</title>

<simpara>

尽管构造方法是创建对象时调用的方法，但它们不是静态方法，<function>is_callable</function>

将对它们返回 &false;。无法使用 <function>is_callable</function> 检查类是否可以从当前作用域实例化。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<simplelist>

<member>

如果对象实现了 <link linkend="object.invoke">__invoke()</link> 且该方法在当前作用域可见，则始终可调用。

</member>

<member>

如果类名实现了 <link linkend="object.callstatic">__callStatic()</link>，则可调用。

</member>

<member>

如果对象实现 <link linkend="object.call">__call()</link>，则此函数对该对象的任何方法将返回

&true;，即使该方法没有定义。

</member>

<member>

如果使用类名调用此函数，则会触发自动加载。

</member>

</simplelist>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>call_user_func</function></member>

<member><function>function_exists</function></member>

<member><function>method_exists</function></member>

</simplelist>

</para>

</refsect1>

</refentry>