Download the PHP package hollogram/laravel-stapler without Composer
On this page you can find all versions of the php package hollogram/laravel-stapler. 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 laravel-stapler
laravel-stapler
Laravel-Stapler is a Stapler-based file upload package for the Laravel framework. It provides a full set of Laravel commands, a migration generator, and a cascading package config on top of the Stapler package. It also bootstraps Stapler with very sensible defaults for use with Laravel. If you are wanting to use Stapler with Laravel, it is strongly recommended that you use this package to do so.
Laravel-Stapler was created by Travis Bennett.
- Requirements
- Installation
- Deprecations
- Migrating From Stapler v1.0.0-Beta4
- Quick Start
- Commands
- Fasten
- Refresh
- Troubleshooting
- Contributing
Requirements
This package currently requires php >= 5.4 as well as Laravel >= 4. If you're going to be performing image processing as part of your file upload, you'll also need GD, Gmagick, or Imagick (your preference) installed as part of your php environment.
Installation
Laravel-Stapler is distributed as a composer package, which is how it should be used in your app.
Install the package using Composer. Edit your project's composer.json file to require codesleeve/laravel-stapler.
Once this operation completes, the final step is to add the service provider.
For Laravel 4, Open app/config/app.php, and add a new item to the providers array:
For Laravel 5, Open config/app.php, and add a new item to the providers array:
Deprecations
As of 1.0.04, the 'Hollogram\LaravelStapler\LaravelStaplerServiceProvider' service provider has been deprecated (this provider will be removed in the next major release). Instead, you should now be using the corresponding service provider for the specific version of Laravel that you're using.
migrating-from-Stapler-v1.0.0-Beta4
If you've been using Stapler (prior to v1.0.0-Beta4) in your Laravel app, you now need to be using this package instead. Uninstall Stapler (remove it from your composer.json, remove the service provider, etc) and install this package following the instructions above. Once installed, the following changes may need need to be made in your application:
-
In your models that are using Stapler, change
use Hollogram\Stapler\Staplertouse Hollogram\Stapler\ORM\EloquentTrait. Your models will also need to implementHollogram\Stapler\ORM\StaplerableInterface. -
If you published stapler's config, you'll need to rename config folder from
app/config/packages/codesleeve/staplertoapp/config/packages/codesleeve/laravel-stapler. -
Image processing libraries are now referenced by their full class name from the Imagine Image package (e.g
gdis now reference byImagine\Gd\Imagine). -
In your s3 configuration, instead of passing 'key', 'secret', 'region', and 'scheme' options, you'll now need to pass a single 's3_client_config' array containing these options (and any others you might want). These will be passed directly to the s3ClientFactory when creating an S3 client. Passing the params as an array now allows you to configure your s3 client (for a given model/attachment) however you like. See: http://docs.aws.amazon.com/aws-sdk-php/guide/latest/configuration.html#client-configuration-options
-
In your s3 configuration, instead of passing 'Bucket' and 'ACL', you'll now need to pass a single 's3_object_config' array containing these values (this is used by the S3Client::putObject() method). See: http://docs.aws.amazon.com/aws-sdk-php/latest/class-Aws.S3.S3Client.html#_putObject
- The ':laravel_root' interpolation has been changed to ':app_root'
Quickstart
In the document root of your application (most likely the public folder), create a folder named system and
grant your application write permissions to it. For this, we're assuming the existence of an existing User model in which we're going to add an avatar image to.
In your model:
Make sure that the
hasAttachedFile()method is called right beforeparent::__construct()of your model.
From the command line, use the migration generator:
In your new view:
In your controller:
In your show view:
To detach (reset) a file, simply assign the constant STAPLER_NULL to the attachment and the save):
This will ensure the the corresponding attachment fields in the database table record are cleared and the current file is removed from storage. The database table record itself will not be destroyed and can be used normally (or even assigned a new file upload) as needed.
Commands
fasten
This package provides a fasten command that can be used to generate migrations for adding image file fields to existing tables. The method signature for this command looks like this:
php artisan stapler:fasten <tablename> <attachment>
In the quickstart example above, calling
php artisan stapler:fasten users avatar followed by php artisan migrate added the following fields to the users table:
- (string) avatar_file_name
- (integer) avatar_file_size
- (string) avatar_content_type
- (timestamp) avatar_updated_at
refresh
The refresh command can be used to reprocess uploaded images on a model's attachments. It works by calling the reprocess() method on each of the model's attachments (or on specific attachments only). This is very useful for adding new styles to an existing attachment when a file has already been uploaded for that attachment.
Reprocess all attachments for the ProfilePicture model:
php artisan stapler:refresh ProfilePicture
Reprocess only the photo attachment on the ProfilePicture model:
php artisan stapler:refresh TestPhoto --attachments="photo"
Reprocess a list of attachments on the ProfilePicture model:
php artisan stapler:refresh TestPhoto --attachments="foo, bar, baz, etc"
Troubleshooting
Before you submit an issue or create a pull request, please take a look at the Troubleshooting Section section of the Stapler package. There's a very good chance that many (if not all) of the issues you're having with this package are related to the base stapler package and have already been addressed there.
Contributing
This package is always open to contributions:
- Master will always contain the newest work (bug fixes, new features, etc), however it may not always be stable; use at your own risk. Every new tagged release will come from the work done on master, once things have stablized, etc.
