-
本地作用域是需显式调用的普通方法，命名须以scope开头加驼峰式，调用时转为短横线；必须返回$query实例，参数需手动校验，不可依赖request或auth，且仅添加查询条件，不影响软删除等全局行为。
-
ApacheListen端口必须显式声明才能生效，仅配VirtualHost或改ServerName无效；须在httpd.conf全局域追加Listen80、Listen8888等（每行一个端口），修改后需重启服务。
-
因Apache默认仅监听一个端口（如80），需手动配置多Listen指令、多个VirtualHost块及对应DocumentRoot，并同步修改httpd.conf、httpd-vhosts.conf和php.ini，否则会导致路由异常、PHP解析失败或MySQL冲突。
-
首先调整PHP配置支持大文件上传与执行时间，再通过PhpSpreadsheet处理Excel格式转换，结合批量SQL插入提升数据库导入效率，使用fgetcsv/fputcsv实现CSV高效读写，并配置Linux定时任务自动执行数据同步。
-
真正起效需修改php.ini中的error_reporting和display_errors，因error_reporting()函数无法捕获ParseError或FatalError；开发时设error_reporting=32767、display_errors=On，生产环境则display_errors=Off、log_errors=On并指定绝对路径的error_log，修改后必须重启Apache。
-
phpenv编译PHP时必须显式添加--enable-sysvsem参数，因其为编译期内置扩展，无法运行时动态启用；需修改default_configure_options配置文件追加该选项后重新执行phpenvinstall。
-
通过引入Redis缓存机制可显著提升PHP应用性能，首先安装Redis并使用Predis客户端建立连接，接着将数据库查询结果存储至Redis并设置过期时间，对于无法部署Redis的场景可用文件缓存替代，最后通过及时清除或更新缓存保证数据一致性。
-
错误原因是mkdir()默认不递归创建父目录，需显式传入第三个参数true；同时须确保最靠近目标的已存在父目录对PHP进程用户具有写权限。
-
PSR-4是PHP自动加载规范，通过命名空间与文件路径映射实现类自动加载，取代已废弃的PSR-0；需严格对齐大小写和目录结构，如App\Http\Controllers\UserController必须对应src/Http/Controllers/UserController.php。
-
云环境中$_SERVER['REMOTE_ADDR']不可靠，因其返回的是代理内网IP；真实IP需从X-Real-IP或X-Forwarded-For中提取，且必须校验代理IP是否在可信范围内，防止伪造。
-
推荐使用array_filter删除所有匹配值，因其不依赖键名、可一次性清除全部指定值且原数组不受影响；若需重排索引，再调用array_values。
-
PHP数据库升级需同步检查协议兼容性、SQL行为变更、字符集一致性及依赖适配；如MySQL8.0需处理caching_sha2_password认证、GROUPBY排序显式化、utf8mb4默认字符集；PostgreSQL升级需关注SSL模式、jsonb类型检查与扩展版本匹配。
-
lang('key')返回空字符串最常见原因是未显式调用$this->lang->load()，该函数不自动触发，且框架不内置浏览器语言自动侦测功能。
-
不能直接用XAMPP的Apache托管FlutterWeb项目，因其默认不支持SPA路由：需启用mod_rewrite、AllowOverrideAll，并配置正确RewriteBase和--base-href参数，否则子路径访问返回404。
-
phpenv无官方版本号，需克隆镜像源（如GitCode）；init命令依赖php-build插件，须手动安装；shims路径须前置PATH，且每次install后需rehash；它仅管理CLIPHP，不涉及Web服务器模块。
