如何在Laravel Sail中启用Xdebug日志？配置后不生效如何解决

配置未同步到容器的原因与解决 #

根本原因是你发布Sail配置后，项目根目录的docker-compose.yml默认仍使用官方预构建的Sail镜像，没有触发本地Dockerfile构建流程，你修改的本地docker/8.0/php.ini没有被纳入构建过程。
解决步骤：

• 打开项目根目录的docker-compose.yml，找到laravel.test服务配置，删除原有的image: laravel/sail:php8.0配置行，替换为以下内容：

build:
  context: ./docker/8.0
  dockerfile: Dockerfile
  args:
    WWWGROUP: '${WWWGROUP}'

• 调整本地docker/8.0/php.ini的配置，将xdebug.log配置移到zend_extension=xdebug.so声明之后，避免配置加载顺序导致失效，同时建议指定完整日志文件路径而非目录：

[PHP]
post_max_size = 100M
upload_max_filesize = 100M
variables_order = EGPCS

# Extensions...
extension=swoole.so

# Zend Extensions...
zend_extension=xdebug.so
xdebug.log = /var/www/html/storage/logs/xdebug.log

• 重新执行sail build --no-cache构建镜像，完成后重启容器即可生效。

容器内无权限修改配置/安装工具的解决办法 #

不需要通过sail shell进入容器操作，可直接用docker命令以root身份操作容器：

• 执行docker ps查询Sail对应PHP容器的ID或名称，默认名称格式为{你的项目名}-laravel.test-1
• 以root身份进入容器终端：docker exec -it --user root {容器ID/名称} bash
• 进入后可直接执行apt update && apt install -y vim安装编辑器，或直接修改配置文件，修改完成后重启容器内php-fpm服务即可临时生效。
  注意：直接修改容器内配置的方式会在容器重启后失效，仅适合临时调试使用，永久修改建议走本地构建配置的方式。

内容的提问来源于stack exchange，提问作者Adam