Download the PHP package gearbox-solutions/has-one-file without Composer
On this page you can find all versions of the php package gearbox-solutions/has-one-file. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gearbox-solutions/has-one-file
More information about gearbox-solutions/has-one-file
Files in gearbox-solutions/has-one-file
Package has-one-file
Short Description Adds HasOneFile trait for easy file management for Laravel models
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 has-one-file
HasOneFile
A HasOneFile trait for easy file management for Laravel models.
Introduction
When working with files in Laravel apps, it is common to have a model with a single file associated with it. An example of this might be a "Documents" model, where a record is created for each document uploaded by a user. This package provides a trait that can be added to a model to make it easy to manage files associated with that model.
This provides a few benefits:
- Adds a few helper methods to the model to make it easier to work with files.
- Files are stored in a consistent location
-
Files are automatically deleted from storage when the model is deleted as part of a lifecycle hook.
Files are stored in a location based on the model's table name and the model's primary key so that there are no conflicts with other files in the same table.
Example:
-
A model with a table name of
documentsand a primary key of125will have its file stored in a directory calleddocuments/125/.When saving or deleting a file, the file name is stored in the model and the model is saved to make sure the file name is stored in the database without having to manually save the model. This is done by default, but can be skipped by passing an additional
falseargument to thestoreFileanddeleteFilemethods.
Here are a few quick examples of how to use the trait:
Installation and setup
Summary:
1. Install or copy the package
2. Add the trait to your model
3. Add a migration to store the file path in the database
1. Install or copy the package
Alternatively, this package is really just a single file! You can copy the HasOneFile.php file to your project, change the namespace from GearboxSolutions\HasOneFile\Traits to your own namespace, and add it to your model.
2. Add the trait to your model to enable file management for that model.
3. Add a migration to store the file path in the database.
The HasOneFile trait will store the name of the file associated with the model in a column in your database. The default column name used by the trait is file_path. You can change this by setting a protected $fileNameField property in your model.
Example:
Configuring the storage disk
The default storage disk used by the trait is the default disk configured in your config/filesystems.php file. You can override this by setting the fileStorageDisk property in your model.
Configuring the file name field
The default file name field used by the trait is file_name. You can override this by setting the fileNameField property in your model.
Testing
Tests are run using Testbench and PHPUnit.
To run the tests, you can use the following command:
