这是什么?

这是一些关于在编程PHP时可能遇到的警告、错误和注意事项的答案,而不知道如何修复它们。这也是一个社区维基,所以每个人都被邀请加入和维护这个列表。

为什么会这样?

Questions like "Headers already sent" or "Calling a member of a non-object" pop up frequently on Stack Overflow. The root cause of those questions is always the same. So the answers to those questions typically repeat them and then show the OP which line to change in their particular case. These answers do not add any value to the site because they only apply to the OP's particular code. Other users having the same error cannot easily read the solution out of it because they are too localized. That is sad because once you understood the root cause, fixing the error is trivial. Hence, this list tries to explain the solution in a general way to apply.

我该怎么做呢?

如果您的问题被标记为此问题的副本,请在下面找到您的错误消息并将修复应用于您的代码。答案通常包含进一步的调查链接,以防仅从一般答案中不清楚。

如果您想投稿,请添加您“最喜欢的”错误消息、警告或通知,每个答案一条,简短描述它的含义(即使它只是突出显示手册页的术语),可能的解决方案或调试方法,以及现有的有价值的问答列表。此外,请随意改进任何现有的答案。

列表

Nothing is seen. The page is empty and white. (also known as White Page/Screen Of Death) Code doesn't run/what looks like parts of my PHP code are output Warning: Cannot modify header information - headers already sent Warning: mysql_fetch_array() expects parameter 1 to be resource, boolean given a.k.a. Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource Warning: [function] expects parameter 1 to be resource, boolean given Warning: [function]: failed to open stream: [reason] Warning: open_basedir restriction in effect Warning: Division by zero Warning: Illegal string offset 'XXX' Warning: count(): Parameter must be an array or an object that implements Countable Parse error: syntax error, unexpected '[' Parse error: syntax error, unexpected T_XXX Parse error: syntax error, unexpected T_ENCAPSED_AND_WHITESPACE Parse error: syntax error, unexpected T_PAAMAYIM_NEKUDOTAYIM Parse error: syntax error, unexpected 'require_once' (T_REQUIRE_ONCE), expecting function (T_FUNCTION) Parse error: syntax error, unexpected T_VARIABLE Fatal error: Allowed memory size of XXX bytes exhausted (tried to allocate XXX bytes) Fatal error: Maximum execution time of XX seconds exceeded Fatal error: Call to a member function ... on a non-object or null Fatal Error: Call to Undefined function XXX Fatal Error: Cannot redeclare XXX Fatal error: Can't use function return value in write context Fatal error: Declaration of AAA::BBB() must be compatible with that of CCC::BBB()' Return type of AAA::BBB() should either be compatible with CCC::BBB(), or the #[\ReturnTypeWillChange] attribute should be used Fatal error: Using $this when not in object context Fatal error: Object of class Closure could not be converted to string Fatal error: Undefined class constant Fatal error: Uncaught TypeError: Argument #n must be of type x, y given Notice: Array to string conversion (< PHP 8.0) or Warning: Array to string conversion (>= PHP 8.0) Notice: Trying to get property of non-object error Notice: Undefined variable or property "Notice: Undefined Index", or "Warning: Undefined array key" Notice: Undefined offset XXX [Reference] Notice: Uninitialized string offset: XXX Notice: Use of undefined constant XXX - assumed 'XXX' / Error: Undefined constant XXX MySQL: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ... at line ... Strict Standards: Non-static method [<class>::<method>] should not be called statically Warning: function expects parameter X to be boolean/string/integer HTTP Error 500 - Internal server error Deprecated: Arrays and strings offset access syntax with curly braces is deprecated

还看到:

这个符号在PHP中是什么意思?


当前回答

致命错误:超过XX秒的最大执行时间

每个PHP页面请求或脚本调用都度量PHP代码执行了多长时间。如果达到配置的限制,脚本将使用此消息中止。

注意,时间通常不包括发生在PHP“外部”的事情,例如等待数据库结果的时间,或使用shell_exec执行的外部程序等。例外情况是当PHP在Windows上运行时,测量的时间是“时钟时间”,并且确实包括这些外部等待时间。

常见的原因

无限循环。写错的while, do…while或for循环可能永远不会完成,这意味着PHP将永远持续运行。甚至foreach循环也可以是无限的,例如循环遍历一个Iterator对象或生成器函数。 庞大的数据集。即使您的循环不是无限的,如果它正在做很多工作,如果它正在处理大量的结果,它可能需要很长时间才能完成。

改变限制

如果你知道你有一个缓慢的过程,你可以配置时间限制:

在php.ini中,使用max_execution_time设置。 在脚本运行时,使用set_time_limit函数。注意,调用这个函数会将测量的时间重置为零,因此执行set_time_limit(10);意思是“再给10秒钟,不管脚本已经花了多长时间”。

这两种机制都应该给出一个秒数,或者特殊值0,表示“不限制”。设置“无限制”对于你真正想在后台永远运行的命令行脚本是最有用的;对于网页,最好设置一些有限值,即使它非常大,以防止代码中的错误导致整个系统失去响应。

其他回答

警告:不能修改报头信息-报头已经发送

当您的脚本试图向客户端发送HTTP报头,但之前已经有输出,导致报头已经发送到客户端时发生。

这是一个E_WARNING,它不会停止脚本。

一个典型的例子是这样的模板文件:

<html>
    <?php session_start(); ?>
    <head><title>My Page</title>
</html>
...

session_start()函数将尝试向客户端发送带有会话cookie的报头。但是PHP在将<html>元素写入输出流时已经发送了头文件。您必须将session_start()移到顶部。

您可以通过遍历代码触发Warning之前的行并检查它输出的位置来解决这个问题。移动任何头发送代码之前的代码。

一个经常被忽略的输出是PHP关闭?>后的新行。当?>是文件中的最后一个内容时,省略它被认为是一种标准实践。同样,出现此警告的另一个常见原因是当开头<?php前面有一个空格,行,或者不可见的字符,导致web服务器发送报头和空格/换行,这样当php开始解析时就不能提交任何报头。

如果您的文件有多个<?php……?>代码块,它们之间不应该有任何空格。(注意:如果你有自动构造的代码,你可能有多个块)

还要确保在代码中没有任何字节顺序标记,例如当脚本的编码是UTF-8和BOM时。

相关问题:

头文件已经被PHP发送 所有PHP“头已经发送”的问题在Stackoverflow 字节顺序标记 什么PHP函数可以创建输出?

致命错误:不能在写上下文中使用函数返回值

这通常发生在直接使用带有empty的函数时。

例子:

if (empty(is_null(null))) {
  echo 'empty';
}

这是因为empty是一个语言结构,而不是一个函数,在5.5之前的PHP版本中,它不能用表达式作为参数调用。在PHP 5.5之前,empty()的参数必须是变量,但在PHP 5.5+中允许任意表达式(例如函数的返回值)。

Empty,尽管它的名字,实际上并不检查一个变量是否为“空”。相反,它检查变量是否存在,或== false。表达式(如示例中的is_null(null))将始终被视为存在,因此这里的empty仅检查它是否等于false。你可以在这里用!替换empty(),例如if (!is_null(null)),或者显式地与false进行比较,例如if (is_null(null) == false)。

相关问题:

致命错误:不能使用函数返回值

警告:[function]期望参数1是给定的布尔值

(一个更通用的警告:mysql_fetch_array()期望参数1是resource,给定布尔值)

资源是PHP中的一种类型(就像字符串、整数或对象一样)。资源是一个不透明的blob,本身没有固有的有意义的值。资源特定于一组PHP函数或扩展并由其定义。例如,Mysql扩展定义了两种资源类型:

MySQL模块中使用了两种资源类型。第一个是数据库连接的链接标识符,第二个是保存查询结果的资源。

cURL扩展定义了另外两种资源类型:

... 一个卷曲手柄和一个卷曲多手柄。

当var_dump时,这些值看起来像这样:

$resource = curl_init();
var_dump($resource);

resource(1) of type (curl)

这就是大多数资源的全部,某种类型((curl))的数字标识符((1))。

您携带这些资源并将它们传递给不同的函数,这些资源对这些函数有一定的意义。通常,这些函数在后台分配特定的数据,而资源只是它们用来在内部跟踪这些数据的引用。


“…期望参数1为resource,给定布尔值”的错误通常是一个未检查的操作的结果,该操作应该创建一个资源,但却返回false。例如,fopen函数有这样的描述:

返回值 成功时返回文件指针资源,错误时返回FALSE。

因此在这段代码中,$fp要么是类型为(stream)的资源(x),要么为false:

$fp = fopen(...);

如果你没有检查fopen操作是否成功或失败,因此$fp是一个有效的资源还是假的,并将$fp传递给另一个期望资源的函数,你可能会得到上述错误:

$fp   = fopen(...);
$data = fread($fp, 1024);

Warning: fread() expects parameter 1 to be resource, boolean given

你总是需要错误检查函数的返回值,这些函数试图分配资源,可能会失败:

$fp = fopen(...);

if (!$fp) {
    trigger_error('Failed to allocate resource');
    exit;
}

$data = fread($fp, 1024);

相关的错误:

警告:mysql_fetch_array()期望参数1是resource, boolean给定

警告:open_basedir限制生效

此警告可以与与文件和目录访问相关的各种函数一起出现。它警告一个配置问题。

当它出现时,这意味着已禁止访问某些文件。

警告本身不会破坏任何东西,但如果文件访问被阻止,脚本通常无法正常工作。

修复方法通常是更改PHP配置,相关设置称为open_basedir。

有时使用了错误的文件或目录名称,解决方法是使用正确的名称。

相关问题:

Open_basedir限制生效。文件(/)不在允许路径内: 所有PHP的“警告:open_basedir限制在有效”的查询在Stackoverflow

"注意:未定义索引"或"警告:未定义数组键"

当您试图通过数组中不存在的键访问数组时发生。

一个典型的Undefined Index通知的例子是(demo)

$data = array('foo' => '42', 'bar');
echo $data['spinach'];
echo $data[1];

数组中菠菜和1都不存在,会触发E_NOTICE。在PHP 8.0中,这是一个E_WARNING。

解决方案是确保在访问索引之前存在索引或偏移量。这可能意味着您需要修复程序中的一个错误,以确保这些索引在您期望它们存在时确实存在。或者这可能意味着你需要使用array_key_exists或isset来测试索引是否存在:

$data = array('foo' => '42', 'bar');
if (array_key_exists('spinach', $data)) {
    echo $data['spinach'];
}
else {
    echo 'No key spinach in the array';
}

如果你有这样的代码:

<?php echo $_POST['message']; ?>
<form method="post" action="">
    <input type="text" name="message">
    ...

那么$_POST['message']将不会在这个页面第一次加载时设置,你将得到上述错误。只有在提交表单并再次运行此代码时,数组索引才会存在。你通常用以下方法检查:

if ($_POST)  ..  // if the $_POST array is not empty
// or
if ($_SERVER['REQUEST_METHOD'] == 'POST') ..  // page was requested with POST

相关问题:

参考文献:“Notice: Undefined variable”和“Notice: Undefined index” 所有关于Stackoverflow的PHP“注意:未定义的索引”问题 http://php.net/arrays