需升级PHP至8.1+、安装Composer 2.5+、启用php8.1-xml/mbstring/openssl等扩展、配置MySQL并完成artisan migrate，最后php artisan serve成功访问即环境搭建完成。
在统信UOS系统上搭建可运行的Laravel开发环境，需绕过默认PHP版本偏低、扩展缺失、包源不稳定等实际障碍，直接适配其Debian系底层和apt包管理机制。
安装并升级PHP至8.1或更高版本
统信UOS默认自带PHP 7.4或更低版本，而Laravel 10+强制要求PHP ≥8.1，不升级会导致composer create-project直接报错退出。
执行以下命令添加Ondřej Surý的PHP官方PPA源（UOS兼容该源）：
sudo apt update && sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update --option Acquire::Retries=100 --option Acquire::http::Timeout="120"
这一步必须加超时与重试参数——UOS国内镜像同步延迟高，不加会导致apt update卡死或失败。
安装PHP 8.1及核心扩展：
sudo apt install -y php8.1-cli php8.1-fpm php8.1-mysql php8.1-gd php8.1-mbstring php8.1-xml php8.1-curl php8.1-zip php8.1-bcmath php8.1-opcache
验证版本：php -v，输出应含 【PHP 8.1.x】 字样，否则后续所有步骤将失效。
安装Composer并设为全局可用
UOS自带的Composer版本往往过旧（如2.0.x），无法解析Laravel最新版依赖树，必须手动安装2.5+稳定版。
下载并校验安装脚本：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
执行安装并移动至系统路径：
sudo php composer-setup.php -d /usr/local/bin --filename composer
完成后运行 composer --version，确认输出为 【Composer version 2.5.8 or higher】。
创建Laravel项目并配置基础环境
方法一：使用create-project命令（推荐）
执行：composer create-project laravel/laravel myapp --prefer-dist
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
若提示“Your requirements could not be resolved”，说明PHP扩展仍缺失——重点检查 【php8.1-xml 和 php8.1-mbstring 必须同时启用】，缺一不可。
进入项目目录：cd myapp
复制环境配置文件：cp .env.example .env
生成应用密钥：php artisan key:generate
这一步失败常见于未安装php8.1-openssl扩展，补装命令：sudo apt install php8.1-openssl。
启动开发服务器并验证运行
第一步：确保MySQL服务已就绪（UOS桌面版默认未启用）
安装MySQL：sudo apt install mysql-server
初始化安全配置：sudo mysql_secure_installation
第二步：创建数据库（示例名laravel_dev）
sudo mysql -u root -p -e "CREATE DATABASE laravel_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
第三步：修改.env中数据库配置段
用文本编辑器打开.env，填入：
DB_CONNECTION=mysqlDB_HOST=127.0.0.1DB_PORT=3306DB_DATABASE=laravel_devDB_USERNAME=rootDB_PASSWORD=你的MySQL密码
第四步：执行迁移建表
php artisan migrate
第五步：启动内置服务器
php artisan serve --host=0.0.0.0 --port=8000
打开浏览器访问 http://127.0.0.1:8000，看到Laravel欢迎页即表示环境配置完成。
