PHP全局定义Query变量与函数初始化实例的性能及优劣势对比

性能差异结论 #

两者的性能差距在绝大多数业务场景下可以忽略不计：PHP函数调用、对象初始化的开销都是纳秒级别的，和后续数据库查询的毫秒级开销相比，占比不到1%，完全不需要为了这点性能牺牲代码健壮性。
如果硬要对比极端场景下的性能：

• 若你用单入口架构，全局只初始化一次$query实例，第一种方案会比第二种少了每次新建对象的开销，性能高5%~10%
• 若每个文件单独引入bootstrap.php，每次都会新建实例，两种方案的性能几乎没有差别

各自优劣势对比 #

第一种方案：全局共享Query实例 #

优势：

• 单实例复用场景下省去重复初始化对象的开销，性能略高
• 无需额外封装函数，代码实现更简单
  劣势：
• 存在致命的状态污染风险：如果是单入口架构，多个业务逻辑共用同一个Query实例，前一次调用设置的where、order、join等条件会残留在实例上，导致后一次查询得到错误结果，这类隐蔽问题排查成本极高。除非你每次查询后手动调用重置方法，反而会增加额外开销
• IDE代码提示支持差：全局变量的类型识别需要额外加注释标注，大部分IDE默认对全局变量的提示支持都不好
• 代码耦合度高：所有调用方都绑定了全局变量名，后续要修改变量名需要调整所有调用位置，维护成本高

第二种方案：工厂函数返回新实例 #

优势：

• 完全避免状态污染：每次调用query()都会返回全新的Query实例，不同业务、不同文件的查询逻辑完全隔离，不会出现条件残留的问题，稳定性极高
• IDE代码提示支持好：只要给函数加上返回值类型声明function query(): Query，所有IDE都能完美识别类方法，开发效率更高
• 扩展性极强：后续如果需要对Query实例做统一处理（比如加表前缀、全局默认条件、连接池调度、SQL日志记录），只需要修改query()函数内部逻辑即可，不需要调整任何调用方代码
• 不依赖全局变量，代码更灵活，单元测试时也更容易mock替换
  劣势：
• 每次调用都会新建Query实例，多了极少量的对象初始化开销，对整体性能几乎没有影响
• 需要多写几行工厂函数的封装代码

优化建议 #

你的选择倾向是完全正确的，推荐优先使用第二种方案。如果确实想兼顾性能，可以对工厂函数做改造，复用单实例同时避免状态污染：

function query(): Query {
    // 静态变量缓存实例，避免重复初始化
    static $instance = null;
    if ($instance === null) {
        $instance = new Query();
    }
    // 每次调用前先重置所有查询条件
    $instance->reset();
    return $instance;
}

这种改造方案既保留了单实例的性能优势，又解决了状态污染问题，同时还保留了良好的代码提示支持，是兼顾性能、稳定性、开发效率的最优解。

内容的提问来源于stack exchange，提问作者Kỹ thuật Webso