Cara memasang Object Storage (S3) pada Laravel

Terakhir diupdate: 19 Maret 2025

Pengantar

Halo Sobat Jagoan!

Tahukah kamu bahwa object storage itu bisa banyak bermanfaat buat aplikasi kamu loh Sob, Salah satunya adalah sebagai tempat menyimpan gambar atau asset dari aplikasi kamu.

Manfaat lain dari memasang Object Storage selain digunakan untuk media penyimpanan adalah bisa mempercepat loading dari aplikasi yang kita jalankan nih Sob. Nah sekarang kita bahas bagaimana Caranya Memasang Object Storage (S3) Pada Laravel.

Simak tutorialnya baik-baik ya Sob!

Object Storage Itu Apa Ya?

Object Storage Adalah sebuah media penyimpanan yang khusus untuk gambar / asset yang lokasinya tidak menjadi satu dengan storage server aplikasimu. Sehingga tidak akan menambah kapasitas server / hosting aplikasimu.

Kapan Object Storage Itu Dibutuhkan?

Ketika storage pada aplikasi / server kamu semakin lama semakin mengecil, sedangkan ada banyak gambar / asset yang harus kamu simpan. Atau ketika kamu sedang menggunakan cluster server. Ingat, Object storage tidak bisa digunakan untuk menyimpan database dan file dari program aplikasi mu. Object Storage hanya bisa menyimpan file statis saja, contohnya : .png, .jpeg, .mp3 dll.

Apa Saja Manfaat dari Object Storage?

Karena file gambar / asset tidak tersimpan pada server / hosting aplikasimu, jika kamu ingin memindahkan server kemanapun, karena yang dipindah hanya aplikasi saja tanpa memindahkan assetnya.
Lebih hemat jika aplikasi kamu membutuhkan storage yang besar, namun menggunakan server / hosting yang kecil karena memang tidak membutuhkan resource yang besar.
Dengan menggunakan Object Storage, kamu bisa mengaktifkan fitur CDN yang dapat meningkatkan kecepatan website kamu.

Langkah-Langkah Pemasangan Object Storage

Nahh untuk mengetahui langkah-langkah yang lebih detail terkait cara memasang Object Storage pada Laravel, langsung aja ikutin step by step dibawah ini ya Sob!

1. Mempersiapkan Object Storage

Masuk ke member area JagoanHosting dan masuk kedalam layanan Object Storage untuk mendapatkan Access Key dan Secret Key. Selain itu kamu perlu membuat juga sebuah Bucket disini. Kamu bisa buat sebuah Bucket dengan nama sesuai yang kamu inginkan, misalnya adalah namadomain.com

Tampilan Layanan Object Storage

2. Installasi Laravel

Pastikan kamu sudah menginstall laravel ya sob. Kamu bisa ikuti panduan installasi laravel pada website resmi laravel disini : laravel.

3. Installasi Library Tambahan

Masuk ke root folder aplikasi kamu, dan jalankan perintah:

				
					composer require league/flysystem-aws-s3-v3 "^3.0"

Setelah itu, tunggu hingga prosesnya selesai ya Sob.

4. Konfigurasi File .env

Sekarang waktunya untuk melakukan konfigurasi dari object storage. Buka file .env dan ubah konfigurasi sesuai dengan panduan dibawah ini :

				
					AWS_ACCESS_KEY_ID= "{{access_key}}"
AWS_SECRET_ACCESS_KEY= "{{secret_key}}"
AWS_DEFAULT_REGION= ""
AWS_BUCKET= "{{nama_bucket_yang_kamu_buat}}"
AWS_URL="https://global.jagoanstorage.com/{{nama_bucket_yang_kamu_buat}}"
AWS_USE_PATH_STYLE_ENDPOINT= true
AWS_ENDPOINT= "https://s3.jagoanstorage.com"

Membuat Proses Upload File

Nah, untuk membuat proses upload file ada beberapa langkah tambahan nih Sob, jadi pastikan kalian benar-benar mencermati bagian yang ini ya!

1. Membuat Controller

Masuk kedalam root folder laravel dan jalan perintah dibawah ini:

				
					php artisan make:controller UploadController

Perintah diatah fungsinya adalah untuk membuat sebuah controller dengan nama Upload Controller. Kamu bisa cek hasilnya di app/Http/Controllers/UploadController.php

2. Membuat Tampilan Upload

Buka file UploadController.php, lalu sesuaikan isinya dengan script yang ada dibawah ini:

				
					<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

class UploadController extends Controller
{
// Fungsi untuk tampilan Upload
public function upload(){
    return view('upload');
    }
// Fungsi untuk proses Upload
public function proses_upload(Request $request){
    $this->validate($request, [
        'file' => 'required',
    ]);

    // menyimpan data file yang diupload ke variabel $file
    $file = $request->file('file');

    // isi dengan nama folder tempat kemana file diupload
    $tujuan_upload = 'laravel';

    // Proses Upload File ke Object Storage
    $result = Storage::disk('s3')->putFileAs($tujuan_upload, $file, $file->getClientOriginalName());
    // Proses merubah visibility file agar bisa di akses secara public
    Storage::disk('s3')->setVisibility($tujuan_upload."/".$file->getClientOriginalName(),"public");
    // Proses mengambil URL hasil upload
    echo Storage::disk('s3')->url($tujuan_upload."/".$file->getClientOriginalName());
    echo '<br>';

    print_r($result);
    die;
    }
}

Setelah itu buat view (tampilan untuk upload) dengan membuat file baru di app/resources/views/upload.blade.php. Lalu isikan dengan script dibawah ini :

				
					<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous" data-pmdelayedstyle="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css">
</head>
<body>
<div class="row">
<div class="container">
<div class="col-lg-8 mx-auto my-5">


@if(count($errors) > 0)
<div class="alert alert-danger">
@foreach ($errors->all() as $error)
{{$error }} <br/>
@endforeach
</div>
@endif


<form action="/upload/proses" method="POST" enctype="multipart/form-data">
{{csrf_field() }}
<div class="form-group">
<b>File Gambar</b><br/>
<input type="file" name="file">
</div>
<input type="submit" value="Upload" class="btn btn-primary">
</form>
</div>
</div>
</div>
<script id="perfmatters-delayed-scripts-js">(function(){window.pmDC=1;window.pmDT=10;if(window.pmDT){var e=setTimeout(d,window.pmDT*1e3)}const t=["keydown","mousedown","mousemove","wheel","touchmove","touchstart","touchend"];const n={normal:[],defer:[],async:[]};const o=[];const i=[];var r=false;var a="";window.pmIsClickPending=false;t.forEach(function(e){window.addEventListener(e,d,{passive:true})});if(window.pmDC){window.addEventListener("touchstart",b,{passive:true});window.addEventListener("mousedown",b)}function d(){if(typeof e!=="undefined"){clearTimeout(e)}t.forEach(function(e){window.removeEventListener(e,d,{passive:true})});if(document.readyState==="loading"){document.addEventListener("DOMContentLoaded",s)}else{s()}}async function s(){c();u();f();m();await w(n.normal);await w(n.defer);await w(n.async);await p();document.querySelectorAll("link[data-pmdelayedstyle]").forEach(function(e){e.setAttribute("href",e.getAttribute("data-pmdelayedstyle"))});window.dispatchEvent(new Event("perfmatters-allScriptsLoaded")),E().then(()=>{h()})}function c(){let o={};function e(t,e){function n(e){return o[t].delayedEvents.indexOf(e)>=0?"perfmatters-"+e:e}if(!o[t]){o[t]={originalFunctions:{add:t.addEventListener,remove:t.removeEventListener},delayedEvents:[]};t.addEventListener=function(){arguments[0]=n(arguments[0]);o[t].originalFunctions.add.apply(t,arguments)};t.removeEventListener=function(){arguments[0]=n(arguments[0]);o[t].originalFunctions.remove.apply(t,arguments)}}o[t].delayedEvents.push(e)}function t(t,n){const e=t[n];Object.defineProperty(t,n,{get:!e?function(){}:e,set:function(e){t["perfmatters"+n]=e}})}e(document,"DOMContentLoaded");e(window,"DOMContentLoaded");e(window,"load");e(document,"readystatechange");t(document,"onreadystatechange");t(window,"onload")}function u(){let n=window.jQuery;Object.defineProperty(window,"jQuery",{get(){return n},set(t){if(t&&t.fn&&!o.includes(t)){t.fn.ready=t.fn.init.prototype.ready=function(e){if(r){e.bind(document)(t)}else{document.addEventListener("perfmatters-DOMContentLoaded",function(){e.bind(document)(t)})}};const e=t.fn.on;t.fn.on=t.fn.init.prototype.on=function(){if(this[0]===window){function t(e){e=e.split(" ");e=e.map(function(e){if(e==="load"||e.indexOf("load.")===0){return"perfmatters-jquery-load"}else{return e}});e=e.join(" ");return e}if(typeof arguments[0]=="string"||arguments[0]instanceof String){arguments[0]=t(arguments[0])}else if(typeof arguments[0]=="object"){Object.keys(arguments[0]).forEach(function(e){delete Object.assign(arguments[0],{[t(e)]:arguments[0][e]})[e]})}}return e.apply(this,arguments),this};o.push(t)}n=t}})}function f(){document.querySelectorAll("script[type=pmdelayedscript]").forEach(function(e){if(e.hasAttribute("src")){if(e.hasAttribute("defer")&&e.defer!==false){n.defer.push(e)}else if(e.hasAttribute("async")&&e.async!==false){n.async.push(e)}else{n.normal.push(e)}}else{n.normal.push(e)}})}function m(){var o=document.createDocumentFragment();[...n.normal,...n.defer,...n.async].forEach(function(e){var t=e.getAttribute("src");if(t){var n=document.createElement("link");n.href=t;if(e.getAttribute("data-perfmatters-type")=="module"){n.rel="modulepreload"}else{n.rel="preload";n.as="script"}o.appendChild(n)}});document.head.appendChild(o)}async function w(e){var t=e.shift();if(t){await l(t);return w(e)}return Promise.resolve()}async function l(t){await v();return new Promise(function(e){const n=document.createElement("script");[...t.attributes].forEach(function(e){let t=e.nodeName;if(t!=="type"){if(t==="data-perfmatters-type"){t="type"}n.setAttribute(t,e.nodeValue)}});if(t.hasAttribute("src")){n.addEventListener("load",e);n.addEventListener("error",e)}else{n.text=t.text;e()}t.parentNode.replaceChild(n,t)})}async function p(){r=true;await v();document.dispatchEvent(new Event("perfmatters-DOMContentLoaded"));await v();window.dispatchEvent(new Event("perfmatters-DOMContentLoaded"));await v();document.dispatchEvent(new Event("perfmatters-readystatechange"));await v();if(document.perfmattersonreadystatechange){document.perfmattersonreadystatechange()}await v();window.dispatchEvent(new Event("perfmatters-load"));await v();if(window.perfmattersonload){window.perfmattersonload()}await v();o.forEach(function(e){e(window).trigger("perfmatters-jquery-load")})}async function v(){return new Promise(function(e){requestAnimationFrame(e)})}function h(){window.removeEventListener("touchstart",b,{passive:true});window.removeEventListener("mousedown",b);i.forEach(e=>{if(e.target.outerHTML===a){e.target.dispatchEvent(new MouseEvent("click",{view:e.view,bubbles:true,cancelable:true}))}})}function E(){return new Promise(e=>{window.pmIsClickPending?g=e:e()})}function y(){window.pmIsClickPending=true}function g(){window.pmIsClickPending=false}function L(e){e.target.removeEventListener("click",L);C(e.target,"pm-onclick","onclick");i.push(e),e.preventDefault();e.stopPropagation();e.stopImmediatePropagation();g()}function b(e){if(e.target.tagName!=="HTML"){if(!a){a=e.target.outerHTML}window.addEventListener("touchend",A);window.addEventListener("mouseup",A);window.addEventListener("touchmove",k,{passive:true});window.addEventListener("mousemove",k);e.target.addEventListener("click",L);C(e.target,"onclick","pm-onclick");y()}}function k(e){window.removeEventListener("touchend",A);window.removeEventListener("mouseup",A);window.removeEventListener("touchmove",k,{passive:true});window.removeEventListener("mousemove",k);e.target.removeEventListener("click",L);C(e.target,"pm-onclick","onclick");g()}function A(e){window.removeEventListener("touchend",A);window.removeEventListener("mouseup",A);window.removeEventListener("touchmove",k,{passive:true});window.removeEventListener("mousemove",k)}function C(e,t,n){if(e.hasAttribute&&e.hasAttribute(t)){event.target.setAttribute(n,event.target.getAttribute(t));event.target.removeAttribute(t)}}})();(function(){var e,a,s;function t(){(e=document.createElement("span")).id="elementor-device-mode",e.setAttribute("class","elementor-screen-only"),document.body.appendChild(e),requestAnimationFrame(n)}function n(){a=o(getComputedStyle(e,":after").content.replace(/"/g,"")),document.querySelectorAll(".elementor-invisible[data-settings]").forEach(e=>{let t=e.getBoundingClientRect();if(t.bottom>=0&&t.top<=window.innerHeight)try{i(e)}catch(e){}})}function i(e){let t=JSON.parse(e.dataset.settings),n=t._animation_delay||t.animation_delay||0,i=t[a.find(e=>t[e])];if("none"===i)return void e.classList.remove("elementor-invisible");e.classList.remove(i),s&&e.classList.remove(s),s=i;let o=setTimeout(()=>{e.classList.remove("elementor-invisible"),e.classList.add("animated",i),l(e,t)},n);window.addEventListener("perfmatters-startLoading",function(){clearTimeout(o)})}function o(e="mobile"){let n=[""];switch(e){case"mobile":n.unshift("_mobile");case"tablet":n.unshift("_tablet");case"desktop":n.unshift("_desktop")}let i=[];return["animation","_animation"].forEach(t=>{n.forEach(e=>{i.push(t+e)})}),i}function l(e,t){o().forEach(e=>delete t[e]),e.dataset.settings=JSON.stringify(t)}document.addEventListener("DOMContentLoaded",t)})();</script></body>
</html>

3. Membuat Routing

Buka file routes/web.php. dan ubah menjadi seperti dibawah ini:

				
					<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\UploadController;

Route::get('/', function () {
return view('welcome');
});

Route::get('/upload', [UploadController::class, 'upload']);
Route::post('/upload/proses', [UploadController::class, 'proses_upload']);

4. Testing Upload

Setelah semua persiapan selesai, sekarang waktunya mencoba upload. Jalankan web server laravel dengan command dibawah ini :

				
					php artisan serve

Bukan browser dan bukan URL sesuai dengan hasil perintah di atas, Pastikan muncul halaman seperti dibawah ini:

Tampilan Web Server Laravel

Setelah itu akses http://localhost:8000/ di kolom pencarian browser kamu, apabila sudah, maka akan tampil seperti ini :

Tampilan Dari http://localhost:8000/

Dan coba lakukan Upload Gambar dan klik tombol “Upload”. Maka akan muncul tampilan seperti ini :

Tampilan Setelah Mengklik Tombol Upload

Penutup

Nah, itu dia Sob tutorialnya, Simak terus Tips Hosting di halaman tutorial Jagoan Hosting Indonesia ya, jika ada bagian dari tutorial yang tidak ditemukan, kamu bisa menghubungi teman-teman di Jagoan Hosting supaya bisa dibantu lebih lanjut melalui Live Chat, Comment atau fitur Open Tiket ya!