PHPackages zhaiyuxin/skeleton-php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. zhaiyuxin/skeleton-php ActiveProject[Utility & Helpers](/categories/utility) zhaiyuxin/skeleton-php ====================== A skeleton repository for my packages 00PHPCI passing Since Oct 23Pushed 6mo agoCompare [ Source](https://github.com/zhaiyuxin103/skeleton-php)[ Packagist](https://packagist.org/packages/zhaiyuxin/skeleton-php)[ RSS](/packages/zhaiyuxin-skeleton-php/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Skeleton PHP ============ [](#skeleton-php) [![Latest Version on Packagist](https://camo.githubusercontent.com/bbf563f85fa4798e7966506cc9bb3c3b097e24debf03098475beabb8991f3a3b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a686169797578696e2f736b656c65746f6e2d7068703f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/zhaiyuxin/skeleton-php)[![Total Downloads on Packagist](https://camo.githubusercontent.com/2f32f286f3eadb748d1dda1f35024cc8cd0aec7cccce59f0274f870cf66952e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a686169797578696e2f736b656c65746f6e2d7068703f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/zhaiyuxin/skeleton-php)[![Build Status](https://camo.githubusercontent.com/c611269efbd1dbd1d684715f70dd380802021247b104d651e149462bb5f2de80/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7a686169797578696e3130332f736b656c65746f6e2d7068702f74657374732e796d6c3f7374796c653d666f722d7468652d6261646765)](https://github.com/zhaiyuxin103/skeleton-php/actions)[![Code Coverage](https://camo.githubusercontent.com/c4c143a658a5a92d89b18a52e7f859c9435547e4d707f6837edfdb744c0c3ed0/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f7a686169797578696e3130332f736b656c65746f6e2d7068703f7374796c653d666f722d7468652d6261646765)](https://codecov.io/gh/zhaiyuxin103/skeleton-php)[![Laravel](https://camo.githubusercontent.com/d06588c2f08e749de25013042b2a4be3debdc7e37f1e72c7859297a66120ad7d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d7265642e7376673f7374796c653d666f722d7468652d6261646765)](https://laravel.com)[![PHP](https://camo.githubusercontent.com/05b45745d10c981c80d6368b538121f0eafbde4f71baf9d09e94f33c7c58d214/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342b2d626c75652e7376673f7374796c653d666f722d7468652d6261646765)](https://php.net)[![License](https://camo.githubusercontent.com/9897f4467850972a38c7db9a4d38280b8fcdac0ada00e9c8c0a72ecfa8551653/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666f722d7468652d6261646765)](LICENSE) 一个用于快速创建 PHP 包的骨架模板项目。该项目提供了完整的开发工具链，包括代码风格检查、静态分析、测试框架等。 特性 -- [](#特性) - 🚀 基于现代 PHP 开发标准 - 🧪 集成 Pest 测试框架 - 🎨 Laravel Pint 代码风格检查 - 📊 PHPStan 静态代码分析 - 🔧 Orchestra Testbench 测试环境 - 📦 完整的 Composer 配置 - 🎯 Git hooks 集成 - 💻 开发环境快速搭建 系统要求 ---- [](#系统要求) - PHP >= 8.4 - Composer - Node.js & pnpm（用于前端工具链） 安装 -- [](#安装) ### 1. 克隆项目 [](#1-克隆项目) ``` git clone https://github.com/zhaiyuxin/skeleton-php.git cd skeleton-php ``` ### 2. 安装 PHP 依赖 [](#2-安装-php-依赖) ``` composer install ``` ### 3. 安装 Node.js 依赖 [](#3-安装-nodejs-依赖) ``` pnpm install ``` 使用方法 ---- [](#使用方法) ### 开发服务器 [](#开发服务器) 启动开发服务器： ``` composer serve ``` ### 代码风格检查 [](#代码风格检查) 运行代码风格检查和静态分析： ``` composer lint ``` 这个命令会执行： - Laravel Pint 代码风格修复 - PHPStan 静态代码分析 ### 运行测试 [](#运行测试) ``` composer test ``` ### 构建项目 [](#构建项目) ``` composer build ``` 项目结构 ---- [](#项目结构) ``` skeleton-php/ ├── src/ # 源代码目录 │ └── helpers.php # 辅助函数 ├── tests/ # 测试目录 │ ├── Feature/ # 功能测试 │ ├── Unit/ # 单元测试 │ ├── Pest.php # Pest配置 │ └── TestCase.php # 测试基类 ├── workbench/ # 开发工作台 │ ├── app/ # 示例应用 │ ├── database/ # 数据库文件 │ ├── resources/ # 资源文件 │ └── routes/ # 路由文件 ├── config/ # 配置文件 ├── database/ # 数据库迁移 ├── composer.json # Composer配置 ├── phpunit.xml # PHPUnit配置 ├── phpstan.neon.dist # PHPStan配置 ├── pint.json # Laravel Pint配置 └── testbench.yaml # Testbench配置 ``` 配置说明 ---- [](#配置说明) ### Composer脚本 [](#composer脚本) 项目提供了以下Composer脚本： - `composer serve` - 启动开发服务器 - `composer lint` - 代码风格检查和静态分析 - `composer test` - 运行测试套件 - `composer build` - 构建工作台 - `composer clear` - 清理缓存 - `composer prepare` - 准备开发环境 ### 代码风格 [](#代码风格) 项目使用 Laravel Pint 进行代码风格检查，配置文件为 `pint.json`。主要规则包括： - Laravel预设 - 严格类型声明 - 有序的类元素 - 严格比较 - 全限定类型导入 ### 静态分析 [](#静态分析) 使用 PHPStan 进行静态代码分析，配置文件为 `phpstan.neon.dist`。 ### 测试框架 [](#测试框架) 使用 Pest 作为测试框架，提供了简洁的测试语法和丰富的断言方法。 开发工作流 ----- [](#开发工作流) 1. **创建新功能**：在 `src/` 目录下添加你的代码 2. **编写测试**：在 `tests/` 目录下添加相应的测试 3. **运行测试**：使用 `composer test` 确保功能正常 4. **代码检查**：使用 `composer lint` 检查代码风格和质量 5. **提交代码**：Git hooks 会自动运行代码检查 Git Hooks --------- [](#git-hooks) 项目集成了Husky和lint-staged，在提交代码时会自动： - 运行代码风格检查 - 执行静态分析 - 格式化代码 自定义配置 ----- [](#自定义配置) ### 修改命名空间 [](#修改命名空间) 在`composer.json`中修改PSR-4自动加载配置： ``` { "autoload": { "psr-4": { "YourNamespace\\YourPackage\\": "src/" } } } ``` 贡献 -- [](#贡献) 欢迎提交 [Issue](https://github.com/zhaiyuxin103/skeleton-php/issues) 和 [Pull Request](https://github.com/zhaiyuxin103/skeleton-php/pulls) 来改进这个项目。 许可证 --- [](#许可证) 本项目基于MIT许可证开源。详情请查看 [LICENSE](LICENSE) 文件。 作者 -- [](#作者) **YuXin Zhai** - Email: - GitHub: [@zhaiyuxin](https://github.com/zhaiyuxin) 致谢 -- [](#致谢) - [Laravel](https://laravel.com/) - 提供了优秀的 PHP 开发工具 - [Pest](https://pestphp.com/) - 现代化的 PHP 测试框架 - [Orchestra Testbench](https://github.com/orchestral/testbench) - Laravel 包测试环境 ### Health Score 17 — LowBetter than 6% of packages Maintenance48 Moderate activity, may be stable Popularity0 Limited adoption so far Community8 Small or concentrated contributor base Maturity13 Early-stage or recently created project Bus Factor1 Top contributor holds 66.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/e807811c43b784701555815f0c7ff9438c81e29ad0246b5b8f8b1c490fd7b77d?d=identicon)[zhaiyuxin103](/maintainers/zhaiyuxin103) --- Top Contributors [![zhaiyuxin103](https://avatars.githubusercontent.com/u/30651809?v=4)](https://github.com/zhaiyuxin103 "zhaiyuxin103 (2 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (1 commits)") ### Embed Badge ![Health badge](/badges/zhaiyuxin-skeleton-php/health.svg) ``` [![Health](https://phpackages.com/badges/zhaiyuxin-skeleton-php/health.svg)](https://phpackages.com/packages/zhaiyuxin-skeleton-php) ``` ### Alternatives [t3docs/examples This extension packages a number of code examples from the Core Documentation. 3120.2k](/packages/t3docs-examples) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)