Download the PHP package nunomaduro/essentials without Composer
On this page you can find all versions of the php package nunomaduro/essentials. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nunomaduro/essentials
More information about nunomaduro/essentials
Files in nunomaduro/essentials
Package essentials
Short Description Just better defaults for your Laravel projects.
License MIT
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 essentials
Essentials
Essentials provide better defaults for your Laravel applications including strict models, automatically eagerly loaded relationships, immutable dates, and more!
Requires PHP 8.3+, Laravel 11+.
Note: This package modifies the default behavior of Laravel. It is recommended to use it in new projects or when you are comfortable with the changes it introduces.
Installation
⚡️ Get started by requiring the package using Composer:
Features
All features are optional and configurable in config/essentials.php.
Table of Contents
- Strict Models
- Auto Eager Loading
- Optional Unguarded Models
- Immutable Dates
- Force HTTPS
- Safe Console
- Asset Prefetching
- Prevent Stray Requests
- Fake Sleep
- Artisan Commands
- make:action
- essentials:pint
- essentials:rector
✅ Strict Models
Improves how Eloquent handles undefined attributes, lazy loading, and invalid assignments.
- Accessing a missing attribute throws an error.
- Lazy loading is blocked unless explicitly allowed.
- Setting undefined attributes throws instead of failing silently.
Why: Avoids subtle bugs and makes model behavior easier to reason about.
⚡️ Auto Eager Loading
Automatically eager loads relationships defined in the model's $with property.
Why: Reduces N+1 query issues and improves performance without needing with() everywhere.
🔓 Optional Unguarded Models
Disables Laravel's mass assignment protection globally (opt-in).
Why: Useful in trusted or local environments where you want to skip defining $fillable.
🕒 Immutable Dates
Uses CarbonImmutable instead of mutable date objects across your app.
Why: Prevents unexpected date mutations and improves predictability.
🔒 Force HTTPS
Forces all generated URLs to use https://.
Why: Ensures all traffic uses secure connections by default.
🛑 Safe Console
Blocks potentially destructive Artisan commands in production (e.g., migrate:fresh).
Why: Prevents accidental data loss and adds a safety net in sensitive environments.
🚀 Asset Prefetching
Configures Laravel Vite to preload assets more aggressively.
Why: Improves front-end load times and user experience.
🔄 Prevent Stray Requests
Configures Laravel Http Facade to prevent stray requests.
Why: Ensure every HTTP calls during tests have been explicitly faked.
😴 Fake Sleep
Configures Laravel Sleep Facade to be faked.
Why: Avoid unexpected sleep during testing cases.
🏗️ Artisan Commands
make:action
Quickly generates action classes in your Laravel application:
This creates a clean action class at app/Actions/CreateUserAction.php:
Actions help organize business logic in dedicated classes, promoting single responsibility and cleaner controllers.
essentials:pint
Laravel Pint is included by default in every Laravel project and is a great tool to keep your code clean and consistent. But it is configured very minimally by default. This command will publish a configuration file for Pint that includes the following:
- "declare_strict_types" - Enforces strict types in all files.
- "final_class" - Enforces final classes by default.
- "ordered_class_elements" - Orders class elements by visibility and type.
- "strict_comparison" - Enforces strict comparison in all files.
- and more...
Options:
--force- Overwrites the existing configuration file without asking for confirmation.--backup- Creates a backup of the existing configuration file.
essentials:rector
Rector is a powerful tool for refactoring and improving your codebase. This command will publish a configuration file for Rector that includes the following:
- "deadCode" - Removes dead code from your codebase.
- "codeQuality" - Improves code quality by applying best practices.
- "typeDeclarations" - Adds type declarations to your codebase.
- "privatization" - Privatizes class properties and methods where possible.
- "earlyReturn" - Enforces early return statements in your codebase.
- "strictBooleans" - Enforces strict boolean checks in your codebase.
Options:
--force- Overwrites the existing configuration file without asking for confirmation.--backup- Creates a backup of the existing configuration file.
Configuration
All features are configurable through the essentials.php config file. By default, most features are enabled, but you can disable any feature by setting its configuration value to false:
You may also publish the stubs used by this package:
Roadmap
- Better defaults before each test case
- Better Pint configuration by default
- General cleanup of the skeleton
- Additional configurables for common Laravel patterns
License
Essentials was created by Nuno Maduro under the MIT license.
