在 Docker PHP 容器中执行 Artisan 命令

本文旨在解决在 Docker 化的 Laravel 项目中执行 Artisan 命令的问题。通过 Docker Compose 搭建开发环境后，直接执行 `docker-compose exec php php artisan` 命令即可在容器内部运行 Artisan，无需指定 Artisan 文件的完整路径。本文将详细解释原因，并提供更深入的理解和实践指导。

理解 Docker Compose 和 Volume

首先，让我们回顾一下 Docker Compose 文件中 volumes 的作用。在你的 docker-compose.yml 文件中，有以下配置：

version: '3'

networks:
  laravel:

services:
  # ... 其他服务 ...

  php:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: php
    volumes: 
      - ./src:/var/www/html
    ports:
      - "9000:9000"
    networks:
      - laravel

volumes: - ./src:/var/www/html 这行配置定义了一个卷（Volume），它将宿主机上的 ./src 目录挂载到容器内的 /var/www/html 目录。这意味着，宿主机上 ./src 目录下的所有文件，包括你的 Laravel 项目代码，都可以在容器内的 /var/www/html 目录下访问到。

为什么不需要指定完整路径？

当你使用 docker-compose exec php php /var/www/html/artisan ... 命令时，你实际上是在告诉 Docker Compose 在 php 容器中执行 php /var/www/html/artisan ... 命令。关键在于 php 容器已经配置了 PHP 的运行环境，并且当前工作目录默认就是 /var/www/html。

立即学习“PHP免费学习笔记（深入）”；

因此，PHP 解释器在容器内部可以直接找到 artisan 文件，无需指定完整路径。

正确的 Artisan 命令执行方式

在 Docker 容器中执行 Artisan 命令的正确方式是：

docker-compose exec php php artisan  [options]

或者更简洁地，如果 PHP 已经配置为默认执行器，你可以直接使用：

docker-compose exec php artisan  [options]

例如，要运行数据库迁移，你可以执行：

php中级教程之ajax技术

AJAX即“Asynchronous Javascript And XML”（异步JavaScript和XML），是指一种创建交互式网页应用的网页开发技术。它不是新的编程语言，而是一种使用现有标准的新方法，最大的优点是在不重新加载整个页面的情况下，可以与服务器交换数据并更新部分网页内容，不需要任何浏览器插件，但需要用户允许JavaScript在浏览器上执行。《php中级教程之ajax技术》带你快速

下载

docker-compose exec php php artisan migrate

或者：

docker-compose exec php artisan migrate

示例

假设你的 Laravel 项目位于宿主机的 ./src 目录下，并且包含一个名为 ExampleCommand 的自定义 Artisan 命令。

1. 创建自定义 Artisan 命令：

   docker-compose exec php php artisan make:command ExampleCommand

   这将在 app/Console/Commands 目录下生成 ExampleCommand.php 文件。

2. 编辑 ExampleCommand.php：

   info('Example command executed successfully!');
       }
   }

3. 注册命令： 在 app/Console/Kernel.php 文件的 $commands 数组中添加：

       protected $commands = [
           Commands\ExampleCommand::class,
       ];

4. 运行自定义 Artisan 命令：

   docker-compose exec php php artisan example:command

   你应该能在终端看到 "Example command executed successfully!" 的输出。

注意事项

• 确保容器已经启动： 在执行 docker-compose exec 命令之前，确保你的 Docker 容器已经通过 docker-compose up -d 命令启动。
• 权限问题： 如果在执行 Artisan 命令时遇到权限问题，可能需要调整容器内的文件权限。可以使用 docker-compose exec php chown -R www-data:www-data /var/www/html 命令来更改文件的所有者。
• Composer 命令： 类似的，执行 Composer 命令也无需指定完整路径，例如：docker-compose exec php composer install。

总结

在 Docker 化的 Laravel 项目中执行 Artisan 命令非常简单。关键在于理解 Docker Compose 的 volumes 配置以及 PHP 容器的默认工作目录。通过 docker-compose exec php php artisan 或 docker-compose exec php artisan 命令，你可以轻松地在容器内部运行 Artisan 命令，进行数据库迁移、生成代码、运行测试等操作。希望本文能够帮助你更好地理解和使用 Docker 和 Laravel。