feiyun / tools
飞云工具包 - 企业级 Hyperf 辅助工具集合,包含自动筛选等实用工具
Requires
- php: >=8.0
- hyperf/database: ^2.0|^3.0
- hyperf/framework: ^2.0|^3.0
- hyperf/http-server: ^2.0|^3.0
- hyperf/server: ^2.0|^3.0
- psr/log: ^1.0|^2.0|^3.0
Requires (Dev)
- hyperf/testing: ^3.0
- phpunit/phpunit: ^9.0|^10.0
README
Enterprise-grade Hyperf utility toolkit that provides various practical development tools to improve Hyperf project development efficiency.
🚀 Features
- Modular Design: Each tool is managed independently and used on demand
- Zero Configuration: Ready to use out of the box, no complex configuration required
- High Performance: Built-in caching mechanism for optimized performance
- Enterprise Grade: Stable toolkit suitable for production environments
- Easy to Extend: Easy to add new tools and features
📦 Installation
composer require feiyun/tools
Hyperf will automatically discover and load the configuration.
🛠️ Available Tools
Auto Filter Tool
Intelligent database query filtering tool that automatically builds query conditions based on request parameters and field types.
Supports _as_ alias fields and _only_ exact-match fields for string columns.
More Tools (Planned)
We plan to add more practical enterprise-grade tools, such as universal export tools, cache management tools, etc.
📁 Project Structure
feiyun-tools/
├── src/ # Core code
│ ├── Providers/ # Service providers
│ │ └── FeiyunToolsServiceProvider.php
│ └── ToolsManager.php # Tools manager
├── tools/ # Tools directory
│ └── auto-filter/ # Auto filter tool
│ ├── config/ # Configuration files
│ ├── src/ # Source code
│ │ ├── Contracts/ # Interface definitions
│ │ ├── Support/ # Support classes
│ │ ├── Traits/ # Trait files
│ │ └── Providers/ # Service providers
│ └── README.md # Tool documentation
├── tests/ # Test files
└── composer.json # Composer configuration
🔧 Configuration
Hyperf Configuration
The package will automatically load the configuration without manual setup. Configuration files for each tool can be published separately:
# Publish Auto Filter configuration
php bin/hyperf.php vendor:publish feiyun/tools
Tools Management
Use the ToolsManager class to manage and view available tools:
use Feiyun\Tools\ToolsManager; // Get all available tools $tools = ToolsManager::getAvailableTools(); // Check if tool is available $isAvailable = ToolsManager::isToolAvailable('auto-filter');
🤝 Contributing
Welcome to contribute code! Please follow these steps:
- Fork this repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add some amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
Adding New Tools
If you want to add new tools, please follow this structure:
tools/your-tool/
├── config/ # Configuration files
├── src/ # Source code
│ ├── Contracts/ # Interfaces
│ ├── Providers/ # Service providers
│ └── ... # Other code
├── tests/ # Test files
└── README.md # Tool documentation
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙋♀️ Support
If you have questions or suggestions, please contact us through:
- Submit Issue
- Email: support@feiwin.cn
🔗 Related Links
Feiyun Tools - Make development easier! 🚀
If this package helps you, please give a ⭐️ Star to support us!