启用命名空间后PHP Auth类初始化失败报500错误的原因排查

嘿，这个500错误的核心原因是命名空间导致的全局类查找错误。当你给Auth类加上Pcc\System命名空间后，PHP会默认在当前命名空间下寻找PDO、Exception这些类，但它们实际属于全局命名空间，所以找不到就触发了致命错误，直接返回500。

你的代码里的具体问题： #

• 在命名空间内部，直接写PDO、Exception时，PHP会解析成Pcc\System\PDO和Pcc\System\Exception，这两个类根本不存在；
• 最后一行echo $auth;也有问题，Auth类没有实现__toString()魔术方法，直接echo对象也会触发错误。

修复后的完整代码： #

<?php
namespace Pcc\System;

// 开启错误显示（开发环境用，方便调试）
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

require_once('../inc/settings.inc.php');

class Auth {
    private $pdo;
    private $stmt;
    private $x; // 提前声明属性，避免动态属性警告

    public function __construct () {
        try {
            // 全局类前加\，告诉PHP去全局命名空间找
            $this->pdo = new \PDO(
                PCC_DRIVER . ':host=' . PCC_HOST . ';dbname=' . PCC_DB,
                PCC_USER,
                PCC_USER_PASS
            );
            // PDO的常量也要加\
            $this->pdo->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION);
            $this->pdo->setAttribute(\PDO::ATTR_EMULATE_PREPARES, false);
            
            // 字符集设置，这里修正了笔误：原代码的SET character SET utf8改为标准写法
            $this->pdo->query('SET names utf8');
            $this->pdo->query('SET character_set_client = utf8');
            $this->pdo->query('SET character_set_results = utf8');
            $this->pdo->query('SET character_set_connection = utf8');
            $this->pdo->query('SET character_set_server = utf8');
        } catch (\Exception $ex) { // Exception同样要加\
            echo 'Exception -> ';
            var_dump($ex->getMessage());
        }

        $this->stmt = $this->pdo->prepare("SELECT * FROM klienci");
        $this->stmt->execute();
        while ($row = $this->stmt->fetch()) {
            $this->x = $row['name'].'<br />';
            echo $this->x;
        }
    }

    // 实现__toString，解决echo对象的问题
    public function __toString() {
        return $this->x ?? '无数据';
    }
}

// 当前在Pcc\System命名空间下，直接new Auth即可
$auth = new Auth();
echo $auth;

关键修复点说明： #

1. 全局类/常量加\前缀：所有属于全局命名空间的类（PDO、Exception）和常量（PDO::ATTR_ERRMODE等），前面必须加\，否则PHP会在当前命名空间下查找，导致找不到类的致命错误。
2. 修复echo对象的问题：给Auth类添加__toString()方法，这样直接echo对象时，PHP会调用这个方法返回字符串，不会报错。
3. 命名空间内实例化：因为当前代码就在Pcc\System命名空间下，实例化Auth类直接写new Auth()就可以，不用写完整的Pcc\System\Auth()（当然写全也没问题，但没必要）。

另外，开发环境一定要开启错误显示，这样能直接看到具体的错误信息，而不是只看到500，调试起来效率高很多。

内容的提问来源于stack exchange，提问作者Bart