jefriherditriyanto/docker-new-project

docker-new-project镜像说明

镜像概述

本镜像为Web应用开发提供一站式环境，集成FrankenPHP（基于Caddy的PHP运行时）和code-server（浏览器版VS Code），支持自动初始化CodeIgniter4或Laravel框架项目，简化开发流程。

核心功能

• Web服务: 通过FrankenPHP+Caddy在80端口提供HTTP服务；
• 浏览器编辑: 借助code-server在8080端口实现浏览器端代码编辑；
• 框架初始化: 可自动创建CodeIgniter4或Laravel项目（若/app目录为空）。

使用场景

• 快速搭建CodeIgniter4或Laravel开发环境；
• 无需本地安装IDE，通过浏览器远程编辑代码；
• 临时测试Web应用功能，无需复杂配置。

配置说明

快速启动示例

初始化CodeIgniter4项目

bash
docker run -d --name ci4 \
  -p 81:80 \
  -p 8081:8080 \
  -e INIT_FRAMEWORK=ci4 \
  -e CODE_SERVER_PASSWORD=rahasia \
  docker.xuanyuan.run/jefriherditriyanto/docker-new-project

初始化Laravel项目

bash
docker run -d --name laravel \
  -p 81:80 \
  -p 8081:8080 \
  -e INIT_FRAMEWORK=laravel \
  -e CODE_SERVER_PASSWORD=rahasia \
  docker.xuanyuan.run/jefriherditriyanto/docker-new-project

使用现有项目

bash
docker run -d --name myapp \
  -p 81:80 \
  -p 8081:8080 \
  -e CODE_SERVER_PASSWORD=rahasia \
  -v "$(pwd)/my-project:/app" \
  docker.xuanyuan.run/jefriherditriyanto/docker-new-project

访问地址：

• 应用（CI4）：http://localhost:81
• code-server：http://localhost:8081

端口说明

• 80/tcp: Web应用服务（FrankenPHP/Caddy）；
• 8080/tcp: code-server浏览器编辑服务。

环境变量

• INIT_FRAMEWORK（可选）：若/app目录为空，自动初始化指定框架，支持值：ci4/codeigniter4（CodeIgniter4）、laravel/laravel12（Laravel12），留空则跳过初始化；
• CODE_SERVER_PASSWORD（默认：admin123）：code-server登录密码；
• CODE_SERVER_PORT（默认：8080）：code-server内部端口；
• CODE_SERVER_HOST（默认：0.0.0.0）：code-server绑定地址；
• CODE_SERVER_AUTH（默认：password）：code-server认证方式；
• APP_DIR（默认：/app）：code-server打开的项目目录。

持久化项目（推荐）

为避免容器删除导致代码丢失，将本地项目目录挂载到容器的/app：

bash
mkdir -p ./app
docker run -d --name ci4 \
  -p 81:80 \
  -p 8081:8080 \
  -e CODE_SERVER_PASSWORD=rahasia \
  -v "$(pwd)/app:/app" \
  docker.xuanyuan.run/jefriherditriyanto/docker-new-project

注意：若遇到权限问题，执行chmod -R 775 ./app/writable。

Docker Compose示例

CodeIgniter4项目

yaml
services:
  ci4:
    image: docker.xuanyuan.run/jefriherditriyanto/docker-new-project
    container_name: ci4
    ports:
      - "81:80"
      - "8081:8080"
    environment:
      INIT_FRAMEWORK: ci4
      CODE_SERVER_PASSWORD: rahasia
    volumes:
      - ./app:/app

现有项目（无自动初始化）

yaml
services:
  myapp:
    image: docker.xuanyuan.run/jefriherditriyanto/docker-new-project
    container_name: myapp
    ports:
      - "81:80"
      - "8081:8080"
    environment:
      CODE_SERVER_PASSWORD: rahasia
    volumes:
      - ./my-existing-project:/app

启动命令：docker compose up -d

本地构建

bash
docker build -t docker-new-project .
docker run -d --name ci4 -p 81:80 -p 8081:8080 docker.xuanyuan.run/docker-new-project

安全提示

• 本镜像适用于开发环境；
• code-server暴露的端口需设置强密码，若部署在公网服务器，建议通过反向代理或***保护。