PHP 8.1 不再支持以类名命名的构造方法，必须使用 __construct()；同时 var 已废弃，需显式声明属性可见性（如 protected）并推荐添加类型提示。
php 8.1 不再支持以类名命名的构造方法，必须使用 `__construct()`；同时 `var` 已废弃，需显式声明属性可见性（如 `protected`）并推荐添加类型提示。
在 PHP 8.1 及更高版本中，旧式类定义方式（如 var $width; 和同名构造函数）已被彻底弃用，若继续沿用将导致意外行为或运行时错误——例如你遇到的 imagecreate(): Argument #1 ($width) must be greater than 0，其根本原因并非图像参数本身为零，而是 $this->width 在 Create() 方法执行时未被成功初始化。
这是因为：
✅ var 是 PHP 4 遗留语法，自 PHP 5.0 起已不推荐，PHP 8.0+ 中虽仍可解析但语义模糊，且不支持类型声明；
❌ 以类名定义的方法（如 function FGCaptchaCreator(...)）不再被识别为构造函数——PHP 8.0+ 彻底移除了该“隐式构造器”机制，导致 __construct() 未被调用，所有属性初始化逻辑（如 $this->width = 150）被跳过，$this->width 保持 null 或默认 0，最终传入 imagecreate(0, 0) 触发致命错误。
✅ 正确重构方式（PHP 8.1+ 推荐实践）
class FGCaptchaCreator extends FG_CaptchaHandler
{
protected ?resource $image = null;
protected int $width = 150;
protected int $height = 60;
protected int $margin_y = 10;
protected string $charset = '2356789ABCDEFGHJKLMNPQRSTUVWXYZ';
protected int $nChars = 6;
protected int $nlines = 2;
protected string $font_file = 'include/SFOldRepublicSCBold.ttf';
protected string $enc_key = 'GhsnR5^Hyhsfg';
protected string $captcha_var_name;
protected string $code = '';
protected string $show_captcha_var = '';
public function __construct(string $captcha_var_name)
{
$this->captcha_var_name = $captcha_var_name;
// 其他初始化逻辑可在此补充（如验证字体文件是否存在）
}
public function Create(): bool
{
// 安全检查：确保尺寸合法
if ($this->width <= 0 || $this->height <= 0) {
throw new RuntimeException('Captcha dimensions must be positive integers.');
}
$this->image = imagecreate($this->width, $this->height);
if (!$this->image) {
throw new RuntimeException('Failed to create image resource.');
}
imagecolorallocate($this->image, 255, 255, 255);
$this->code = $this->CreateCode();
return true;
}
// 示例：补充 CreateCode() 的骨架（需按实际逻辑实现）
protected function CreateCode(): string
{
$chars = str_split($this->charset);
$code = '';
for ($i = 0; $i < $this->nChars; $i++) {
$code .= $chars[array_rand($chars)];
}
return $code;
}
}⚠️ 关键注意事项
-
属性必须声明可见性：
public/protected/private缺一不可，var已完全过时，IDE 和静态分析工具（如 PHPStan）将无法识别其作用域； -
优先使用类型声明：如
protected int $width明确约束值类型，避免运行时因类型混乱引发隐性错误； -
构造函数必须为
__construct：这是 PHP 5.0+ 唯一标准构造器，兼容所有现代版本； -
资源型属性（如
$image）建议用?resource标注：表示“可能为null”，增强类型安全性； -
初始化检查不可省略：在关键方法（如
Create()）中加入前置校验，比依赖外部调用更健壮。
遵循以上规范，不仅能解决当前的图像创建失败问题，更能提升代码可维护性、可测试性，并为后续迁移到 PHP 8.2/8.3 打下坚实基础。
