Download the PHP package yourivw/sailor without Composer
On this page you can find all versions of the php package yourivw/sailor. 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 sailor
Introduction
This package is an extension to Laravel Sail, enabling the user to install additional services to the Sail installation. The idea behind this, is that this enables you to create an additional package which defines your services which can then be easily installed in your new project consistenly and quickly. The package also gives the options to overwrite which Sail packages are used as default, and how the Laravel service is named.
My own services are available as well, and can be used by installing yourivw/sailor-services.
Installation
Install this package as a dev dependency using composer:
Defining Sailor services
Services can be defines in two ways: fluently using , and by defining a new class implementing the Serviceable interface. After defining, register the service to the manager using on the Sailor Facade. Alternatively, the SailorService class has a register function, so that the service can be fluently registered.
In both examples, the callbacks can be used for further setup. For example, dynamically adding something to the docker-compose files through the argument, using the argument to write to the output, copying extra files when publishing etc.
Like in these examples, I would advise to check whether the app is running in the console, in order not to uselessly register these services unless your application is running in console.
Fluent example
Interface example
Other configuration
Note on volumes
Sailor will automatically add a volume when your service has defined it required a volume, in the same way Sail does this. However, these volumes are prefixed with 'sailor-' in the docker-compose file. Be sure to refer to these volumes correctly in your stub file. The volume is named after your service name, plus the sailor- prefix. See example:
Usage
Installation command
The installation command can be used in a similar fashion to the default Sail installation command. Additionally, a check is performed whether a docker-compose file already exists, and if so, an error will be shown. To add a service, use the add command instead. Also, there is an option to directly rename the Laravel service. In the background, Sail's install command will run to handle the installation of the standard services, and this package will handle the custom services. See for more information on usage.
Add command
The add command can be used in a similar fashion to the default Sail add command. Additionally, a check is performed whether a docker-compose file already exists, and if not, an error will be shown. To create a new intallation, use the install command instead. In the background, Sail's add command will run to handle the standard services, and this package will handle the custom services. See for more information on usage.
Rename command
The rename command can be used to rename the Laravel service. It will find the service in the existing Docker file, and rename it. A line it added to, or edited in the .env file, specifying the new service name. Your Laravel instance will now be reachable on this URL. Ensure this URL points to the correct address for it to work, e.g. by adding it to your Windows hosts file. See for more information on usage.
Renaming the installation will cause the Sail commands to not find the Laravel installation anymore. It's advised to use only the Sailor commands to add packages to prevent this.
Publish command
To further ease your workflow when modifying services, your new service can also specify what it should publish, when this is required. An example: the PHP runtimes which Sail can publish for you, in order to customize these. It's not required to define this, and can be skipped all together. When running the publish command, specific services can be chosen using the option to limit which service files get publishes. See for more information on usage.
Changelog
Please see CHANGELOG for more information about recent changes.
Contributing
Contributions are more than welcome. Please read the information on issues and PR's below.
Issues
- Make sure the issue is reproduceable.
- Make sure the issue has not already been raised.
- Give as much information about the problem as possible.
Pull requests
- Make sure additional features add to the functionality of this package.
- Ensure all tests pass, and if required, add tests.
- Do not make PR's adding pre-defined services to this package, these will be closed. This package is purely an interface between Sail and custom services.
- Upon submitting a PR, testing and formatting actions will run automatically.
Testing
The package uses PHPUnit tests and PHPStan for static analysis.
Or using Sail:
License
This package is open-sourced software licensed under the MIT license.
All versions of sailor with dependencies
illuminate/support Version ^10.0|^11.0
laravel/sail Version ^1.26
symfony/yaml Version ^6.0|^7.0