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