在 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 <command> [options]

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

docker-compose exec php artisan <command> [options]

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

docker-compose exec php php artisan migrate

或者：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

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：

   <?php
   
   namespace App\Console\Commands;
   
   use Illuminate\Console\Command;
   
   class ExampleCommand extends Command
   {
       protected $signature = 'example:command';
       protected $description = 'An example command';
   
       public function handle()
       {
           $this->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 <command> 或 docker-compose exec php artisan <command> 命令，你可以轻松地在容器内部运行 Artisan 命令，进行数据库迁移、生成代码、运行测试等操作。希望本文能够帮助你更好地理解和使用 Docker 和 Laravel。

以上就是在 Docker PHP 容器中执行 Artisan 命令的详细内容，更多请关注php中文网其它相关文章！