-
不能直接调用sendSms()发验证码，因PHP无内置短信功能，须通过阿里云/腾讯云等第三方HTTP接口，按规范传template_id、phone_number、sign_name及严格匹配占位符的JSON格式template_param。
-
phpenvinstall命令失败因缺少php-build插件，需手动克隆官方仓库至$(phpenvroot)/plugins/php-build并执行phpenvrehash；Ubuntu/Debian还需安装autoconf、bison、libxml2-dev等编译依赖，macOS则需适配Homebrew的OpenSSL@3等库。
-
可通过四种方法统一管理多个Node.js项目路径：一、在网站设置中查看根目录；二、通过PM2管理器查脚本路径反推项目目录；三、用文件管理器搜索package.json定位；四、用SSH执行find命令扫描所有package.json所在目录。
-
phpenv编译PHP默认不带readline扩展，必须重编译并显式添加--with-readline参数，否则readline_list_history()等函数不可用；验证需用php-r"var_dump(function_exists('readline_list_history'));"返回true才表示完整支持。
-
phpEnv无法安装Keycloak，因其是基于Java的服务，需JDK17+运行环境，而phpEnv仅管理PHP版本与扩展；Keycloak必须独立部署，推荐使用Docker方式运行。
-
phpenv实为两类工具：Unix下PHP版本管理器（仅终端切换版本）与Windows下集成环境套件（含Apache/MySQL等图形化服务）。混用将导致命令失效或服务启动失败。
-
PHP敏感数据加密存储需在应用层用AES-256-CBC/GCM加密，每次生成随机IV并明文存储，密钥从环境变量或Vault加载且禁止硬编码，密文存TEXT/JSON字段，逻辑封装为DataEncryptor类并配套访问控制与审计。
-
跨域预检请求（OPTIONS）需正确响应以避免请求被阻止，处理方法包括：一、PHP脚本内判断并终止；二、Web服务器配置层拦截；三、框架中间件统一处理；四、.htaccess重写；五、全局入口集中拦截。
-
XAMPP8.2+版本因PHP官方移除，已不支持xmlrpc扩展；仅XAMPP8.1.x及更早版可在php.ini中启用extension=xmlrpc并重启Apache验证生效。
-
宝塔面板中“FFmpeg”并非插件，而是调用系统包管理器安装的命令行工具；推荐使用BtbN官方静态编译版并配置绝对路径调用，同时需解除PHP禁用函数、修复权限及SELinux限制。
-
PHP无法直接将PHP文件转为MP4；实际仅两类场景：①合并PHP生成的图像序列为MP4；②用PHP调用FFmpeg转换真实视频文件为MP4。
-
PDO::rollback()必须显式调用且仅对beginTransaction()开启的事务有效；未开启事务直接调用会抛出“Thereisnoactivetransaction”异常，需配合inTransaction()检查和ERRMODE_EXCEPTION设置确保可靠执行。
-
OPcache是PHP字节码缓存，仅加速脚本执行；Redis是通用内存数据库，用于缓存业务数据。二者定位不同，不可互相替代：OPcache不支持存业务数据、跨请求共享或过期机制，Redis则专为此设计。
-
str_repeat()用于重复字符串，需注意内存占用；其语法为str_repeat(string$input,int$multiplier)，如str_repeat("A",5)返回"AAAAA"；重复次数过大可能导致内存溢出，例如生成1亿字符约占100MB内存，超出memory_limit会报错；建议限制重复次数、估算内存使用或采用分段输出、前端替代方案以优化性能。
-
Docker本身不支持“合并多个容器为一个镜像”，最佳实践是分别构建、推送Nginx和PHP-FPM镜像，并通过docker-compose.yml统一编排；关键在于镜像自包含、配置可参数化、开发与生产环境分离。
