关键在解耦实例化逻辑:将类名、参数及依赖关系写入JSON/YAML配置,由工厂统一读取并递归解析(如@redis_client)和缓存共享实例,避免业务代码中散落new调用。

PHP中用工厂模式加载JSON配置创建对象,关键在解耦实例化逻辑
直接结论:不要把 new MyClass() 散落在业务代码里;把类名、构造参数、依赖关系全写进 config.json,再由一个统一的工厂类读取并实例化。这样改配置就能换实现,无需动 PHP 代码。
配置文件结构必须支持类名、参数和依赖注入
常见错误是只存类名,结果构造函数一有参数就报 ArgumentCountError。YAML 或 JSON 都行,但字段要覆盖三类信息:
-
class:完整命名空间类名,如"App\Services\Payment\AlipayService" -
arguments:索引数组(按构造顺序)或关联数组(按参数名),支持嵌套引用(如"@redis_client") -
shared:布尔值,决定是否单例复用(避免每次调用都新建连接对象)
示例 services.json 片段:
{
"cache": {
"class": "App\Cache\RedisCache",
"arguments": ["@redis_client", 3600],
"shared": true
},
"redis_client": {
"class": "Predis\Client",
"arguments": [{"scheme": "tcp", "host": "127.0.0.1", "port": 6379}]
}
}
工厂类必须递归解析依赖引用(@xxx)并缓存共享实例
硬编码 new 调用无法处理 @redis_client 这种引用。工厂需支持两层能力:
立即学习“PHP免费学习笔记(深入)”;
- 遇到字符串形如
"@xxx",不是当成普通参数,而是递归调用自身去创建xxx对应的服务 - 对
"shared": true的服务,首次创建后存入私有数组,后续直接返回缓存对象(否则数据库连接会重复建立) - 构造参数若为数组且含
@前缀,需逐项替换——不能只检查第一层
核心逻辑示意(不依赖框架):
public function get(string $id)
{
if (isset($this->instances[$id]) && $this->config[$id]['shared'] ?? false) {
return $this->instances[$id];
}
$def = $this->config[$id];
$class = $def['class'];
$args = $this->resolveArguments($def['arguments'] ?? []);
$obj = new $class(...$args);
if ($def['shared'] ?? false) {
$this->instances[$id] = $obj;
}
return $obj;
}
private function resolveArguments(array $args): array
{
return array_map(function ($arg) {
if (is_string($arg) && str_starts_with($arg, '@')) {
return $this->get(substr($arg, 1));
}
return is_array($arg) ? $this->resolveArguments($arg) : $arg;
}, $args);
}
YAML配置需用symfony/yaml扩展,且注意PHP类型推断陷阱
PHP 原生不支持 YAML 解析,必须装 symfony/yaml。更关键的是:YAML 中的 true/false/null 会被正确转成 PHP 原生类型,但数字开头的字符串(如 001)可能被误判为整数。JSON 没这问题,但 YAML 更易读。
- 用
Yaml::parseFile()读取,别用file_get_contents() + json_decode()混用 - YAML 中写字符串强制加引号:
host: "001.example.com",否则可能变1.example.com - 布尔值写
shared: true即可,不用引号;但debug: "true"就会变成字符串而非布尔
如果项目已用 Laravel,直接复用其 Illuminate\Container\Container 加载 YAML 配置更稳——它内置了引用解析和延迟加载,但底层原理和上面一致。
真正难的不是写工厂,而是定义清楚哪些该进配置、哪些不该。比如数据库 DSN 的 host/port 可以配,但密码绝不能明文写 JSON;构造参数里传回调函数(function() { ... })也无法序列化——这些边界点,比语法细节更容易导致运行时失败。



















