Download the PHP package salehye/settings without Composer
On this page you can find all versions of the php package salehye/settings. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package settings
Salehye Settings Package
A lightweight, flexible Laravel settings package with InertiaJS & Blade support, multilingual capabilities, and database-driven configuration.
✨ Features
- 🗄️ Database-Driven - Store settings in database with
is_publicflag - 🌐 Multilingual - Support for translated labels and content
- ⚡ Caching - Built-in caching for optimal performance
- 🎨 InertiaJS Ready - Auto-share public settings with frontend
- 🔧 Flexible - Works with or without predefined definitions
- 🧪 Tested - Comprehensive Pest PHP test suite
- 📦 SOLID - Clean architecture following Laravel best practices
📦 Installation
1. Require the package
2. Publish assets
3. Run migrations
4. Register Middleware (Optional)
Add the middleware to share settings with Inertia automatically:
Laravel 11.x/12.x (bootstrap/app.php):
🚀 Usage Methods
Method 1: Helper Functions (Recommended) ⭐
Method 2: Facade
Method 3: Magic Methods
Method 4: HasSettings Trait (In Controllers)
Method 5: Dependency Injection
🎨 Blade Templates Integration
View Composer (Automatic)
Public settings are automatically shared with all Blade views:
Blade Directives
Blade Component
Publish Component Views
Then customize in resources/views/vendor/settings/components/setting.blade.php
📊 Database Schema
🎯 Creating Settings
Method 1: Direct Database (Recommended)
Method 2: With Config Definitions
Add to config/settings.php:
🌐 InertiaJS Integration
Auto-Share Public Settings
After registering ShareSettingsMiddleware, all public settings are automatically shared:
Settings Controller
The package provides a controller for settings management:
Inertia Frontend Example (Vue 3)
🔧 Configuration
Cache Settings
Inertia Settings
🧙♂️ Advanced Usage
Type Casting
The package automatically handles type casting based on config definitions:
Custom Repository
Clear Cache
🧪 Testing
📝 Example: Complete Setup
1. Create Settings Seeder
2. Run Seeder
3. Use in Application
📦 Package Structure
🧪 Testing
🤝 Contributing
Contributions are welcome! Please see our Contributing Guide for details.
Quick Guide
- Fork the repository
- Create a feature branch (
git checkout -b feature/new-feature) - Commit your changes (
git commit -am 'Add new feature') - Push to the branch (
git push origin feature/new-feature) - Create a Pull Request
Requirements
- Follow PSR-12 coding standards
- Add tests for new features
- Update documentation as needed
- Ensure all tests pass
📄 License
This package is open-sourced software licensed under the MIT License.
🚀 Roadmap
- [ ] Add settings import/export functionality
- [ ] Add settings versioning
- [ ] Add real-time settings sync
- [ ] Add settings presets
- [ ] Add multi-environment support
🙏 Support
If you find this package helpful, please consider giving it a ⭐️ on GitHub!
Support the Development
- GitHub Sponsors
- Buy Me a Coffee
- PayPal
Built with ❤️ for the Laravel Community
📞 Contact
- Email: [email protected]
- GitHub: @salehye
- Twitter: @salehye
