Initial commit: PHP 8.2.20 Hello World template

- 基于 PHP 8.2.20 的简单 Web 应用模板
- 支持 Docker 部署和 Composer 依赖管理
- 包含 Makefile、Dockerfile、README 等完整配置
- 支持环境变量端口配置
- 集成 PHPUnit 测试框架

.eazy

+{
+    "version": "1.0.0",
+    "name": "PHP Hello World 应用",
+    "tags": ["php", "web", "hello-world", "api"], 
+    "description": "基于 PHP 8.2.20 的简单 Web 应用模板",
+    "init_commands": ["make install"],
+    "start_commands": ["make run"],
+    "stop_commands": ["make stop"],
+
+    "mapping_ports": 
+    {
+        "APP_PORT_1": 8000,
+        "APP_PORT_2": 8001,
+        "APP_PORT_3": 8002,
+        "APP_PORT_4": 8003
+    },
+    
+    "deploy": 
+    [
+      {
+        "image_name": "php-hello-world",
+        "app_access_entry": true,
+        "ports": 
+        [
+          {
+            "name": "APP_PORT_1",
+            "main_port": true,
+            "inner_access_env_key": "API_URL",
+            "open_access": true,
+            "open_access_env_key": "API_DOMAIN"
+          },
+          {
+            "name": "APP_PORT_2", 
+            "main_port": false,
+            "dns_env_key": null,
+            "open_access": false,
+            "open_access_env_key": null
+          }
+        ],
+        "docker_file_dir": "./", 
+        "deploy_resources": 
+        {
+          "cpu_limit": 0.5,
+          "memory_limit": 2,
+          "storage_limit": 1
+        }
+      }
+    ]
+}

.gitignore

+# 依赖文件
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# 环境变量文件
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# 构建输出
+dist/
+build/
+out/
+
+# 日志文件
+*.log
+
+# 运行时数据
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# 覆盖率目录
+coverage/
+.nyc_output
+
+# 依赖目录
+jspm_packages/
+
+# 可选的npm缓存目录
+.npm
+
+# 可选的eslint缓存
+.eslintcache
+
+# 可选的REPL历史
+.node_repl_history
+
+# 输出目录
+*.tgz
+
+# Yarn完整性文件
+.yarn-integrity
+
+# dotenv环境变量文件
+.env
+
+# 编辑器目录和文件
+.idea/
+*.swp
+*.swo
+*~
+
+# 操作系统生成的文件
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# 临时文件
+*.tmp
+*.temp
+
+# 备份文件
+*.bak
+*.backup

.resource/resource_dev.json

+{}

.vscode/extensions.json

+{
+    "recommendations": [
+        "pomdtr.excalidraw-editor",
+        "editorconfig.editorconfig",
+        "lokalise.i18n-ally",
+        "devsense.phptools-vscode",
+        "xdebug.php-debug",
+        "bmewburn.vscode-intelephense-client"
+    ]
+}
\ No newline at end of file

Dockerfile

+# 使用官方 PHP 8.2.20 镜像
+FROM hb.eazytec-cloud.com/eazytec/eazydevelop-php:ubuntu22.04-php8.2.20-latest
+
+# 设置工作目录
+WORKDIR /app
+
+# 安装 Composer
+COPY --from=composer:2.7 /usr/bin/composer /usr/bin/composer
+
+# 复制 composer 文件
+COPY composer.json composer.lock* ./
+
+# 安装 PHP 依赖
+RUN composer install --no-dev --optimize-autoloader --no-interaction
+
+# 复制应用代码
+COPY . .
+
+# 设置环境变量
+ENV APP_PORT_1=8000
+
+# 暴露端口
+EXPOSE $APP_PORT_1
+
+# 使用自定义启动脚本
+COPY docker-entrypoint.sh /
+RUN chmod +x /docker-entrypoint.sh
+ENTRYPOINT ["/docker-entrypoint.sh"]

Makefile

+# 变量定义
+APP_NAME = php-hello-world
+PHP = php
+COMPOSER = composer
+APP_PORT = $(or $(APP_PORT_1),8000)
+RESOURCE_PATH = $(abspath $(dir $(lastword $(MAKEFILE_LIST))))/.resource/resource_dev.json
+LOG_FILE = $(abspath $(dir $(lastword $(MAKEFILE_LIST))))/.logs/app.log
+
+# 安装命令
+.PHONY: install
+install:
+	@echo "检查 PHP 版本..."
+	@$(PHP) --version
+	@echo "检查 Composer 版本..."
+	@$(COMPOSER) --version
+	@echo "正在安装依赖..."
+	@$(COMPOSER) install --optimize-autoloader
+	@echo "✅ 依赖安装完成！"
+
+# 运行命令
+.PHONY: run
+run:
+	@echo "正在启动 PHP 应用..."
+	@mkdir -p $(dir $(LOG_FILE))
+	RESOURCE_PATH=$(RESOURCE_PATH) APP_PORT_1=$(APP_PORT) $(PHP) -S 0.0.0.0:$(APP_PORT) -t . > $(LOG_FILE) 2>&1 &
+	@echo "✅ PHP 应用已启动，运行在端口 $(APP_PORT)"
+
+# 停止命令
+.PHONY: stop
+stop:
+	@echo "正在停止 PHP 应用..."
+	@if command -v lsof >/dev/null 2>&1; then \
+		echo "使用 lsof 命令停止应用..."; \
+		lsof -ti:$(APP_PORT) | xargs kill -9 2>/dev/null || echo "没有找到运行在端口 $(APP_PORT) 的进程"; \
+	elif command -v ss >/dev/null 2>&1; then \
+		echo "使用 ss 命令停止应用..."; \
+		ss -ltnp | grep ':$(APP_PORT)' | awk '{print $7}' | sed 's/.*pid=\([0-9]*\).*/\1/' | xargs kill 2>/dev/null || echo "没有找到运行在端口 $(APP_PORT) 的进程"; \
+	else \
+		echo "❌ 错误：系统中没有找到 lsof 或 ss 命令"; \
+		exit 1; \
+	fi
+	@echo "✅ PHP 应用已停止"

README.md

+# PHP Hello World 应用
+
+基于 PHP 8.2.20 的简单 Web 应用模板，使用 PHP 内置服务器提供 Web 服务。
+
+## 项目特性
+
+- 🐘 **PHP 8.2.20** - 使用最新的 PHP 版本
+- 🌐 **PHP 内置服务器** - 无需 Apache/Nginx，开箱即用
+- 🐳 **Docker 支持** - 基于官方 PHP 镜像的容器化部署
+- 🔧 **环境变量配置** - 端口可通过环境变量配置
+- 📦 **Composer 依赖管理** - 现代化的 PHP 包管理
+- 🧪 **PHPUnit 测试** - 集成测试框架
+- 🚀 **一键部署** - 支持 Makefile 和 .eazy 配置
+
+## 快速开始
+
+### 环境要求
+
+- PHP 8.2.20 或更高版本
+- Composer（PHP 包管理器）
+- Docker（可选，用于容器化部署）
+
+### 本地开发
+
+1. **克隆项目**
+   ```bash
+   git clone <项目地址>
+   cd php8.2.20-template
+   ```
+
+2. **安装依赖**
+   ```bash
+   make install
+   ```
+
+3. **启动应用**
+   ```bash
+   make run
+   ```
+
+4. **访问应用**
+   打开浏览器访问：http://localhost:8000
+
+5. **停止应用**
+   ```bash
+   make stop
+   ```
+
+### 环境变量配置
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `APP_PORT_1` | 8000 | 应用监听端口 |
+
+### Docker 部署
+
+1. **构建镜像**
+   ```bash
+   docker build -t php-hello-world .
+   ```
+
+2. **运行容器**
+   ```bash
+   docker run -p 8000:8000 -e APP_PORT_1=8000 php-hello-world
+   ```
+
+## 项目结构
+
+```
+php8.2.20-template/
+├── .eazy                    # 应用配置文件
+├── .resource/
+│   └── resource_dev.json   # 资源配置文件
+├── .vscode/                # VS Code 配置
+├── .gitignore              # Git 忽略文件
+├── index.php               # 主程序
+├── composer.json           # PHP 依赖配置
+├── Dockerfile              # Docker 构建文件
+├── docker-entrypoint.sh    # Docker 启动脚本
+├── Makefile               # 构建和运行脚本
+└── README.md              # 项目说明文档
+```
+
+## 开发指南
+
+### 添加新路由
+
+在 `index.php` 中添加新的处理逻辑：
+
+```php
+<?php
+// 获取请求路径
+$requestUri = $_SERVER['REQUEST_URI'];
+
+switch ($requestUri) {
+    case '/':
+        // 首页逻辑
+        break;
+    case '/api/status':
+        // API 状态检查
+        break;
+    default:
+        // 404 处理
+        http_response_code(404);
+        echo json_encode(['error' => 'Not Found']);
+        break;
+}
+?>
+```
+
+### 添加依赖
+
+在 `composer.json` 的 `require` 部分添加新的依赖：
+
+```json
+{
+    "require": {
+        "php": ">=8.2.20",
+        "monolog/monolog": "3.5.0"
+    }
+}
+```
+
+然后运行：
+```bash
+composer update
+```
+
+### 配置说明
+
+- **composer.json**: PHP 依赖管理配置，包含 PHPUnit 测试框架
+- **Dockerfile**: 基于 PHP 8.2.20-cli 镜像，使用 Composer 管理依赖
+- **Makefile**: 提供 install、run、stop 命令
+- **.eazy**: 应用部署配置文件
+
+## API 接口
+
+### GET /
+
+返回应用状态信息的 JSON 响应。
+
+**响应示例：**
+```json
+{
+    "message": "Hello, World!",
+    "port": "8000",
+    "timestamp": "2025-01-07 16:20:00",
+    "php_version": "8.2.20",
+    "server": "PHP Built-in Server"
+}
+```
+
+## 测试
+
+### 运行测试
+
+```bash
+# 使用 Composer 运行测试
+composer test
+
+# 或直接使用 PHPUnit
+./vendor/bin/phpunit
+```
+
+### 创建测试
+
+在项目根目录创建 `tests/` 目录，添加测试文件：
+
+```php
+<?php
+// tests/HelloWorldTest.php
+use PHPUnit\Framework\TestCase;
+
+class HelloWorldTest extends TestCase
+{
+    public function testHelloWorld()
+    {
+        $this->assertEquals('Hello, World!', 'Hello, World!');
+    }
+}
+?>
+```
+
+## 部署说明
+
+### 使用 .eazy 配置部署
+
+项目包含 `.eazy` 配置文件，支持一键部署：
+
+- **端口映射**: APP_PORT_1 (8000) 作为主端口
+- **资源限制**: CPU 0.5核，内存 2GB，存储 1GB
+- **访问入口**: 支持外网域名访问
+
+### 生产环境建议
+
+1. **使用 Web 服务器**: 生产环境建议使用 Nginx + PHP-FPM
+2. **性能优化**: 启用 OPcache 和 APCu
+3. **安全配置**: 配置 HTTPS 和防火墙规则
+4. **监控日志**: 集成日志收集和监控系统
+5. **健康检查**: 添加健康检查端点
+
+### Nginx 配置示例
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+    root /var/www/html;
+    index index.php;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        fastcgi_pass 127.0.0.1:9000;
+        fastcgi_index index.php;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        include fastcgi_params;
+    }
+}
+```
+
+## 故障排除
+
+### 常见问题
+
+1. **端口被占用**
+   ```bash
+   # 查看端口占用
+   lsof -i :8000
+   # 或使用 make stop 停止应用
+   ```
+
+2. **Composer 依赖安装失败**
+   - 检查网络连接
+   - 清除 Composer 缓存：`composer clear-cache`
+   - 更新 Composer：`composer self-update`
+
+3. **Docker 构建失败**
+   - 检查 Dockerfile 语法
+   - 确认基础镜像可用
+   - 检查网络连接
+
+4. **PHP 版本不兼容**
+   - 确保使用 PHP 8.2.20 或更高版本
+   - 检查 `composer.json` 中的 PHP 版本要求
+
+## 性能优化
+
+### PHP 配置优化
+
+在 `php.ini` 中启用以下配置：
+
+```ini
+; 启用 OPcache
+opcache.enable=1
+opcache.memory_consumption=128
+opcache.max_accelerated_files=4000
+
+; 启用 APCu
+apc.enabled=1
+apc.shm_size=128M
+```
+
+### 应用优化
+
+1. **使用 Composer 自动加载优化**
+   ```bash
+   composer dump-autoload --optimize
+   ```
+
+2. **启用 Composer 类映射优化**
+   ```json
+   {
+       "config": {
+           "optimize-autoloader": true
+       }
+   }
+   ```
+
+## 贡献指南
+
+1. Fork 项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 打开 Pull Request
+
+## 许可证
+
+本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
+
+## 联系方式
+
+如有问题或建议，请通过以下方式联系：
+
+- 项目 Issues: [GitLab Issues](项目地址/-/issues)
+- 邮箱: [联系邮箱]
+
+---
+
+**Happy Coding with PHP! 🐘**

composer.json

+{
+    "name": "php/hello-world",
+    "description": "PHP Hello World application",
+    "type": "project",
+    "require": {
+        "php": ">=8.2.20"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "10.5.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "src/"
+        }
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "sort-packages": true
+    },
+    "minimum-stability": "stable",
+    "prefer-stable": true
+}

docker-entrypoint.sh

+#!/bin/sh
+
+# 设置默认端口
+APP_PORT_1=${APP_PORT_1:-8000}
+
+echo "Starting PHP application on port $APP_PORT_1"
+
+# 启动 PHP 内置服务器
+exec php -S 0.0.0.0:$APP_PORT_1 -t /app

index.php

+<?php
+/**
+ * PHP Hello World Web Application
+ * 从环境变量获取端口配置
+ */
+
+// 从环境变量获取端口，默认为 8000
+$port = $_ENV['APP_PORT_1'] ?? '8000';
+
+// 设置响应头
+header('Content-Type: application/json; charset=utf-8');
+
+// 返回 JSON 响应
+$response = [
+    'message' => 'Hello, World!',
+    'port' => $port,
+    'timestamp' => date('Y-m-d H:i:s'),
+    'php_version' => PHP_VERSION,
+    'server' => 'PHP Built-in Server'
+];
+
+echo json_encode($response, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+?>
\ No newline at end of file