php方案 PHP的语言服务器（Intelephense/PHPActor）

先说概念：

你在 VSCode 里写 PHP，按 . 出来自动补全
这个补全不是 VSCode 做的
VSCode 只是个界面，它通过 LSP 协议问语言服务器：
"这里有哪些方法可以用？"
语言服务器分析代码，回答它

Intelephense = 闭源，快，收费解锁高级功能
PHPActor = 开源，功能更全，可编程调用

composer require phpactor/worse–reflection

<?php
require 'vendor/autoload.php';

use Phpactor\\WorseReflection\\ReflectorBuilder;

$source = <<<'PHP'
<?php
class Order {
public int $id;
public float $total;

public function isPaid(): bool {
return $this->total > 0;
}
}
PHP;

$reflector = ReflectorBuilder::create()->addSource($source)->build();
$class = $reflector->reflectClass('Order');

foreach ($class->properties() as $prop) {
echo "属性: \\${$prop->name()} 类型: {$prop->inferredType()}\\n";
}

foreach ($class->methods() as $method) {
echo "方法: {$method->name()}() 返回: {$method->returnType()}\\n";
}

输出：
属性: $id 类型: int
属性: $total 类型: float
方法: isPaid() 返回: bool

—–
逐行解释：

use Phpactor\\WorseReflection\\ReflectorBuilder;
PHPActor 的反射引擎，这是语言服务器的核心组件，负责理解 PHP 代码结构和类型。

—–
$source = <<<'PHP' … PHP;
把要分析的 PHP 代码当字符串传进去，真实场景里这就是你正在编辑的文件内容。

—–
$reflector = ReflectorBuilder::create()->addSource($source)->build();
构建反射器。addSource 把代码喂进去，build 完成初始化。可以 addSource 多次，模拟整个项目的代码上下文。

—–
$class = $reflector->reflectClass('Order');
告诉反射器：我要分析 Order 这个类。它会解析 AST，建立类型图，把这个类的所有信息提取出来。

—–
foreach ($class->properties() as $prop) {
echo "属性: \\${$prop->name()} 类型: {$prop->inferredType()}\\n";
}
遍历所有属性，inferredType() 是推导出来的类型，不只是你写的类型注解，没写注解时它也会从赋值语句推断。这就是 IDE
里悬停变量能显示类型的原理。

—–
foreach ($class->methods() as $method) {
echo "方法: {$method->name()}() 返回: {$method->returnType()}\\n";
}
遍历所有方法，returnType() 拿返回类型。IDE 自动补全时就是这么知道 ->isPaid() 返回 bool 的。

—–
这段代码做的事就是语言服务器每次你打字时在后台做的事：

你输入 $order->
语言服务器反射 Order 类
拿到所有 properties + methods
把名字和类型列表发回给 VSCode
VSCode 渲染成下拉补全菜单

一句话终极结论

VSCode里PHP的代码自动补全，不是编辑器自己算的，是靠「语言服务器」分析代码后返回结果；PHPActor是开源的PHP语言服务器核心，用它的反射引擎能自己编程解析PHP代码的属性、方法、类型，这就是IDE自动补全的底层原理。

下面全程大白话，把概念、工具、代码、补全原理拆到完全易懂。

一、先搞懂：VSCode自动补全到底是谁在干活？

你在VSCode写PHP，按 . 弹出方法提示，VSCode只是个“展示界面”，真正干活的是「语言服务器」：

1. 你敲代码 → VSCode通过LSP协议（语言通用通讯规则）问服务器：“这个对象能调用哪些方法？”
2. 语言服务器解析你的PHP代码，分析类、属性、方法、类型
3. 服务器把结果发给VSCode → 编辑器弹出补全菜单

二、两个常用PHP语言服务器（大白话对比）

1. Intelephense
– 闭源软件，运行速度快
– 基础功能免费，高级自动补全、重构要收费
2. PHPActor
– 完全开源免费
– 功能更多，还能自己写代码调用它的解析引擎，自定义分析逻辑
– 是很多PHP工具（静态分析、IDE补全）的底层核心

三、代码逐句大白话解释

这段代码就是用PHPActor的解析引擎，自己手动模拟IDE分析代码的过程：

1. 装依赖

bash

composer require phpactor/worse–reflection

安装PHPActor的代码解析核心引擎，专门用来读懂PHP代码结构。

2. 加载自动加载文件

php

require 'vendor/autoload.php';

让PHP能找到刚装的解析引擎。

3. 引入解析器构建类

php

use Phpactor\\WorseReflection\\ReflectorBuilder;

这个 ReflectorBuilder 就是解析PHP代码的“工具箱”，语言服务器的核心就是它。

4. 准备要分析的PHP代码

php

$source = <<<'PHP'
<?php
class Order {
public int $id;
public float $total;
public function isPaid(): bool {
return $this->total > 0;
}
}
PHP;

把要解析的PHP代码当成字符串传进去，真实IDE里，这个字符串就是你正在编辑的PHP文件内容。

5. 构建解析器，喂入代码

php

$reflector = ReflectorBuilder::create()->addSource($source)->build();

– 创建解析器实例
– addSource() ：把要分析的代码喂给解析器
– build() ：初始化完成，准备解析

6. 定位要分析的类

php

$class = $reflector->reflectClass('Order');

告诉解析器：我要分析Order这个类，它会自动把类的所有信息（属性、方法、类型）全提取出来。

7. 遍历类的属性，读名称+类型

php

foreach ($class->properties() as $prop) {
echo "属性: \\${$prop->name()} 类型: {$prop->inferredType()}\\n";
}

– 循环拿出类的所有属性
– inferredType() ：自动推导属性类型（就算你没写类型注解，它也能从赋值逻辑推出来）
– 这就是IDE里鼠标悬停变量，能显示类型的原因。

8. 遍历类的方法，读名称+返回值类型

php

foreach ($class->methods() as $method) {
echo "方法: {$method->name()}() 返回: {$method->returnType()}\\n";
}

– 循环拿出类的所有方法
– returnType() ：获取方法的返回值类型
– IDE自动补全时，就是靠这个知道 isPaid() 返回布尔值。

四、IDE自动补全的完整后台逻辑（大白话）

1. 你输入 $order->
2. VSCode把代码发给PHPActor/Intelephense
3. 语言服务器用解析引擎，找到 $order 对应的 Order 类
4. 提取类的所有属性、方法、类型
5. 把结果发回VSCode
6. VSCode渲染成下拉补全菜单，你就能选方法了

五、极简总结

1. VSCode只负责展示，语言服务器才是自动补全的核心
2. Intelephense快但收费，PHPActor开源可自定义
3. WorseReflection引擎能手动解析PHP代码，读懂类、属性、方法
4. 这套逻辑，就是所有PHP IDE自动补全、类型提示的底层原理