reflexions/docker-laravel-fedora

reflexions/docker-laravel-fedora

由Reflexions提供

镜像概述

该镜像基于Fedora系统构建，专注于快速搭建Laravel 5应用环境，仅依赖Docker即可运行。无需本地安装PHP、数据库等工具，支持空目录初始化新Laravel项目或导入现有项目，有效解决常见权限错误问题，兼容多种开发工具与部署场景。

核心功能

• 集成Laravel 5.4、PHP、数据库（PostgreSQL/MySQL）、Imagemagick等必要组件；
• 支持空目录初始化或现有项目导入，无需本地安装依赖；
• 避免使用chmod 777解决权限问题；
• 通过GitHub Token避免Composer速率限制；
• 兼容Elastic Beanstalk部署流程。

使用场景

• Laravel项目本地开发环境快速搭建；
• 快速原型开发与测试；
• 基于Docker的Laravel项目部署（含云平台如Elastic Beanstalk）。

配置说明

步骤1：安装Docker工具

安装Docker获取docker、docker-compose及Kitematic GUI，通过Kitematic -> File -> Open Docker Command Line Terminal打开终端。

步骤2：创建Docker Compose文件

在项目目录下创建docker-compose.yml和docker-compose.override.yml：

docker-compose.yml

yaml
version: '3'
services:
  laravel:
    image: reflexions/docker-laravel-fedora:26
    env_file: .env
    links:
      - database

  database:
    image: postgres:9.6
    env_file: .env
    environment:
      LC_ALL: C.UTF-8

docker-compose.override.yml（不提交至Git，用于环境差异配置）

yaml
version: '3'
services:
  laravel:
    ports:
      - "80:80"
    volumes:
      - .:/var/www/laravel

  database:
    ports:
      - "5432:5432"

步骤3：配置环境变量

创建.env文件：

bash
# laravel服务
APP_KEY=
DB_CONNECTION=pgsql
DB_HOST=database
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=

# database服务
POSTGRES_DB=
POSTGRES_USER=
POSTGRES_PASSWORD=

步骤4：配置GitHub凭证

获取https://github.com/settings/tokens/new%E5%B9%B6%E8%AE%BE%E7%BD%AE%E4%B8%BA%60GITHUB_TOKEN%60%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%8C%E6%88%96%E9%85%8D%E7%BD%AESSH%E5%AF%86%E9%92%A5%E8%87%B3%60/root/.ssh/id_rsa%60%E3%80%82

步骤5：启动服务

bash
docker-compose up

可选操作

• 生成APP_KEY：

  bash
  docker exec -it $(docker ps | grep reflexions/docker-laravel | awk '{print $1}') bash
  php artisan key:generate
  

• 使用Tinker：

  bash
  docker exec -it $(docker ps | grep reflexions/docker-laravel | awk '{print $1}') bash
  php artisan tinker
  

故障排除

• Mac OS X：无法连接Docker守护进程
  解决方案：通过Kitematic -> File -> Open Docker Command Line Terminal打开终端。
• .env文件修改未生效
  解决方案：重启服务docker-compose restart。
• 无法连接数据库
  解决方案：检查DB_CONNECTION与DB_HOST是否匹配docker-compose中的服务名称。

Elastic Beanstalk部署

在项目根目录创建Dockerfile：

FROM reflexions/docker-laravel-fedora:latest

MAINTAINER "Your Name" <your@email.com>

RUN /usr/share/docker-laravel-scripts/setup.sh

COPY . /var/www/laravel
WORKDIR /var/www/laravel

EXPOSE 80
ENTRYPOINT ["/usr/share/docker-laravel/bin/start.sh"]

通过AWS控制台配置环境变量（APP_KEY、DB_HOST等）即可部署。