This is where your description should go. Limit it to a paragraph or two. Consider adding a small example.
You can install the package via composer:
composer require bildvitta/iss-uploadYou can publish the config file with:
php artisan vendor:publish --provider="Bildvitta\IssUpload\IssUploadServiceProvider" --tag="iss-upload-config"This is the contents of the published config file:
return [
'validation' => [
'mime_type' => env('ISS_IMAGE_VALID_MIME_TYPE', 'image/jpeg,image/gif,image/bmp,image/tiff,image/png,application/pdf'),
],
'route' => [
'prefix' => env('ISS_IMAGE_ROUTE_PREFIX', 'api'),
'middleware' => env('ISS_IMAGE_ROUTE_MIDDLEWARE', 'hub.auth'),
]
];If you want to change any settings, do so through your .env file.
ISS_IMAGE_ROUTE_PREFIX=api
ISS_IMAGE_ROUTE_MIDDLEWARE="hub.auth"
ISS_IMAGE_VALID_MIME_TYPE="image/jpeg,image/gif,image/bmp,image/tiff,image/png,application/pdf"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=It is mandatory to fill in AWS credential information.
The package already contains a {prefix}/upload-credentials and {prefix}/upload route by default.
Below is an example in cURL requesting the upload link to AWS.
curl --location --request POST 'http://127.0.0.1:8001/api/upload-credentials' \
--header 'Content-Type: application/json' \
--data-raw '{
"filename": "5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
"entity": "realEstateDevelopmentsMedias"
}'
Here is an example of an answer.
{
"path": "uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
"full_path": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
"endpoint": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XXXXXFus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210430T111315Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Signature=XXXX"
}You may also want to have your own upload routes, one for each form for example
use Bildvitta\IssUpload\Http\Controllers\UploadController;
Route::post('/upload-pdf')->name('upload_pdf')->uses(UploadController::class);It may also happen that you want to have the upload source at any time in the request time.
For any purpose you can use the code below which will have an array with the same content as the controller response
Feel free to use \Bildvitta\IssUpload\Http\Requests\UploadRequest.
use Bildvitta\IssUpload\Http\Requests\UploadRequest;
use Bildvitta\IssUpload\IssUpload;
use Illuminate\Http\JsonResponse;
use App\Http\Requests\YourRequestValidator;
class NewPostController extends Controller
{
public function __invoke(YourRequestValidator $yourRequestValidator, UploadRequest $uploadRequest): JsonResponse
{
#TODO: Your Logic.
// $issUpload = new IssUpload($uploadRequest->entity, ($uploadRequest->filename, $uploadRequest->mime_type);
$issUpload = new IssUpload();
$issUpload->setEntity($uploadRequest->entity);
$issUpload->setFilename($uploadRequest->filename);
$issUpload->setMimeType($uploadRequest->mime_type);
dd($issUpload->getUploadSource());
#TODO: Your Logic.
}
}The dump returns something like this.
array:3 [
"path": "uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
"full_path": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
"endpoint": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XXXXXFus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210430T111315Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Signature=XXXX"
]
coming soon...
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.