PHP 运行时：Laravel 与小型 PHP 应用

PHP 在移动端的现状

PHP 传统上是服务器端脚本语言，移动端原生运行的场景很少。WebToApp 通过内嵌原生 PHP 二进制，让以下场景变成可能：

• Laravel 演示站点：不需要服务器就能给客户演示 Laravel 项目
• 小型 PHP 工具：把 PHP 命令行工具包装成带 Web 界面的 APK
• 内容管理系统：WordPress 是 PHP 类型的一个特例（见专门章节）
• 学习实验：在手机上写 PHP 小程序，边写边跑

创建流程

1. 打开类型选择器（需开启高级功能），点「PHP」卡片
2. 在专属表单里：

• 选择项目目录
• 指定启动命令（Laravel 是 php artisan serve --host=127.0.0.1 --port=xxxx）
• 指定端口号

1. 在基本信息里填应用名称和图标
2. 点击保存

Composer 依赖

类似 Node.js 的 npm install，PHP 项目需要用 Composer 安装依赖。WebToApp 内置 Composer 二进制，首次运行时会在应用存储目录执行 composer install。

注意事项：

• 首次 composer install 可能需要联网拉取 packagist 包
• Laravel 项目还需要生成 APP_KEY（php artisan key:generate）和运行数据库迁移（如果用到 SQLite）
• vendor 目录如果已经存在，会跳过安装

内置示例项目

包含 Laravel 入门项目，展示 artisan serve、路由定义、模板渲染等常见场景。

Laravel 适配提示

Laravel 项目在 WebToApp PHP 运行时里需要注意：

1. 运行 host：必须绑定 127.0.0.1，不能用 0.0.0.0
2. 存储权限：APK 内部的存储是沙箱化的，Laravel 的 storage 目录需要映射到应用存储路径
3. 数据库：推荐用 SQLite（文件存储），MySQL/PostgreSQL 这类需要 TCP 连接的数据库在手机上没有对应服务
4. 环境配置：config/app.php 里的 app_url 和 APP_ENV 需要根据移动端环境调整

和 WordPress 类型的区别

WordPress 类型是 PHP 类型的一个特化版本——它预装了 WordPress 核心文件和 SQLite 后端，不需要你自己配置 wp-config.php、设置数据库等步骤。普通 PHP 类型适合更通用的 PHP 项目，需要手动配置启动命令和依赖。