در این مقاله به بررسی قابلیت مدیریت پکیج در لاراول می‌پردازیم. در طی این مطلب، به بررسی یک مثل عملی نیز خواهیم پرداخت تا مقصود مقاله را به طور کامل نمایش دهیم.

مدیریت پکیج در لاراول قابلیت مهمی است که امکان بسته‌بندی یک کارکرد را به طوری فراهم می‌سازد که بتوان آن را به سهولت توزیع کرد. به علاوه می‌توانید همواره پکیج خود را در ریپازیتوری‌هایی مانند Packagist و GitHub انتشار دهید. این ریپازیتوری‌ها به توسعه‌دهندگان امکان استفاده از پکیج‌ها را می‌دهند.

برای نمایش این مفهوم یک صفحه نمونه در لاراول می‌سازیم تا تصاویر را به کلود Amazon S3 آپلود کنیم. به این منظور به جای پیگیری گردش کار معمول آن را به صورت یک پکیج بسته‌بندی می‌کنیم که می‌تواند به سادگی توزیع یافته و نگهداری شود.

پیش از ادامه کار فرض ما بر این است که شما از قبل با فریمورک لاراول آشنا هستید، چون در این نوشته قرار است به بررسی جزییات مبانی مفاهیم لاراول بپردازیم.

ضمناً باید یک حساب معتبر AWS داشته باشید و از رمز عبور این حساب برای دسترسی به API آمازون استفاده کنید و به این ترتیب بتوانید مراحل این مقاله را عملاً پیگیری کنید. بنابراین ابتدا مطمئن شوید که این موضوع را تنظیم کرده‌اید. زمانی که همه چیز آماده شد، می‌توانیم به مراحل توسعه عملی بپردازیم.

راه‌اندازی فایل‌های پکیج

در ادامه فهرست خلاصه‌ای از فایل‌هایی را که در طی این دوره آموزشی پیاده‌سازی خواهیم کرد مشاهده می‌کنید.

  • composer.json – این نگاشت کلاس را باید به پکیج خود در فایل composer.json در ریشه پکیج اضافه کنیم.
  • config/app.php – این یک فایل از قبل موجود است که از آن برای افزودن مدخل ارائه‌دهنده سرویس سفارشی خودمان استفاده می‌کنیم و به این ترتیب می‌توانیم انواع «نما» (View) و «مسیر» (Route) را با استفاده از آن فایل بارگذاری کنیم.
  • composer.json – این فایل composer.json مختص پکیج است و برای پکیجی که می‌خواهید با دیگران به اشتراک بگذارید استفاده می‌شود.
  • packages/envato/aws/src/Providers/AwsServiceProvider.php – این فایل ارائه‌دهنده سرویس معمولی لاراول است که کامپوننت‌های دیگر پکیج را بارگذاری خواهد کرد.
  • packages/envato/aws/src/routes/web.php – این فایل مسیرهای سفارشی پکیج ما را بارگذاری می‌کند.
  • packages/envato/aws/src/Controllers/AwsController.php – این فایل کنترلر است که منطق اپلیکیشن پکیج ما را مدیریت می‌کند.
  • packages/envato/aws/src/views/upload.blade.php فایل view است که اقدام به مدیریت منطق رندر می‌کند.

اگر از خواندن فهرست فوق چیز زیادی دستگیرتان نشد، نگران نباشید، چون در ادامه همه این موارد را به تفصیل بررسی خواهیم کرد.

راه‌اندازی پیش‌نیازها

چنان که پیش‌تر اشاره کردیم، پکیج ما، کاربرد آپلود فایل به کلود S3 آمازون را پیاده‌سازی می‌کند. در این بخش به بررسی پیش‌نیازهای لازم برای اجرای موفق پکیج می‌پردازیم.

شما به عنوان یک توسعه‌دهنده لاراول باید با Flysystem که یک لایه انتزاع زیبا برای تعامل با فایل‌سیستم ارائه می‌کند، آشنا باشید. این پکیج درایورهای با کاربری آسان ارائه می‌کند که به وسیله آن‌ها می‌توانید به راحتی با فایل‌سیستمهای مختلف کار کنید و مهم نیست که فایل‌سیستم روی یک دیسک محلی است و یا سیستم کلود S3 آمازون است.

برای فعال‌سازی پشتیبانی از فایل‌سیستم کلود S3 آمازون در Flysystem، شما باید پکیج کامپوزر آداپتر متناظر را نصب کنید. به این منظور دستور کامپوزر زیر را از ریشه پروژه اجرا کنید تا پکیج flysystem-aws-s3-v3 نصب شود:

به محض اجرای موفق این دستور، می‌توانید از Flysystem برای تعامل با فایل‌سیستم کلود S3 آمازون به همان روش که برای فایل‌سیستم لوکال استفاده می‌کردید، بهره بگیرید.

اکنون می‌توانید فایل config/filesystems.php را به سرعت pull کرده و تنظیمات ارائه شده برای فایل‌سیستم S3 آمازون را مشاهده کنید.

چنان که می‌بینید، پیکربندی از قبل برای S3 آمازون تنظیم شده است و صرفاً کافی است که متغیرهای ENV مناسب را در فایل env. تنظیم کنیم. پا را فراتر گذارده و متغیرهای زیر را در فایل env. اضافه کنید.

البته باید مقادیر placeholder را با مقادیر واقعی‌شان پر کنید. اکنون آماده هستید که از آداپتر Flysystem AWS S3 در اپلیکیشن لاراول خود استفاده کنید.

بررسی فایل‌های پکیج

برای ایجاد پکیج لاراول، نخستین چیزی که باید ایجاد کنید یک ساختار دایرکتوری است که از قراردادهای سیستم لاراول تبعیت کند. فرض ما بر این است که یک اپلیکیشن لاراول ابتدایی را از قبل اجرا کرده‌اید. در واقع اپلیکیشن پیش‌فرض blog نیز به این منظور مناسب است.

در ادامه دایرکتوری Packages را در ریشه اپلیکیشن ایجاد می‌کنیم. با توجه به این که قصد داریم پکیج را با دیگران به اشتراک بگذاریم، ساختار ترجیحی پکیج باید به صورت {vendor_name}/{package_name} باشد.

با پیروی از همین قرارداد، می‌توانیم یک دایرکتوری envato/aws زیر دایرکتوری packages ایجاد کنیم. چنان که احتمالاً حدس می‌زنید، envato نام ارائه‌ دهنده است و aws اشاره به خود نام پکیج دارد. در نهایت یک دایرکتوری packages/envato/aws/src ایجاد می‌کنیم که فایل‌های منبع پکیج را نگهداری می‌کند.

اکنون باید وجود پکیج جدید خود را به لاراول اطلاع دهیم. به این منظور فایل composer.json را در ریشه اپلیکیشن لاراول باز می‌کنیم و مدخل “Envato\\Aws\\”: “packages/envato/aws/src” را در بخش autoload به صورت زیر اضافه می‌کنیم:

چنان که می‌بینید، فضای نام Envato\Aws\ به دایرکتوری packages/envato/aws/src نگاشت شده است. اکنون باید دستور dump-autoload را اجرا کرده و نگاشت‌های کامپوزر را باز تولید کنیم.

در این مرحله می‌توانیم با استفاده از فضای نام Envato\Aws\ در اپلیکیشن، فایل‌ها را از مکان صحیحشان انتخاب کنیم.

فایل کامپوزر پکیج

در این مرحله یک فایل composer.json خاص پکیج اضافه می‌کنیم که می‌توان به وسیله آن پکیج را روی ریپازیتوری packagist توزیع کنیم. به این منظور به دایرکتوری packages/envato/aws بروید و دستور زیر را برای تولید فایل composer.json برای پکیج خود اجرا کنید:

در این مرحله برخی سؤالات معمولی از شما پرسیده می‌شود که باید به آن‌ها پاسخ دهید تا یک فایل composer.json ایجاد کنید. در کمترین حالت این فایل باید چیزی مانند زیر باشد:

مسیر

در این پکیج یک صفحه نمونه می‌سازیم که وضعیت فایل آپلود شده را نمایش خواهد داد. بنابراین باید یک مسیر ایجاد کنیم که با آن صفحه متناظر باشد. در ادامه فایل مسیر را در آدرس packages/envato/aws/src/routes/web.php به صورت زیر ایجاد می‌کنیم:

این فایل به توضیح چندانی نیاز ندارد. گام بدیهی بعدی نیز این است که فایل کنترلر مربوطه را ایجاد کنیم.

کنترلر

در این زمان یک فایل کنترلر در مسیر packages/envato/aws/src/Controllers/AwsController.php با محتوای زیر ایجاد می‌کنیم:

در ادامه جزییات فایل فوق را به تفصیل بررسی می‌کنیم تا با کارکرد هر یک از خطوط کد آشنا شویم.

در آغاز یک فضای نام برای کنترلر به صورت فضای نام Envato\Aws\Controllers تنظیم می‌کنیم. به خاطر داشته باشید که باید در ریشه composer.json یک نگاشت از Envato\Aws به packages/envato/aws/src اضافه کنید تا بتواند فایل‌های پکیج را پیدا کند.

سپس متد upload را تعریف می‌کنیم که برای همگام‌سازی فایل‌های محلی با کلود S3 آمازون یک متد ضروری محسوب می‌شود. این نکته مهم را نیز به خاطر داشته باشید که آرگومان نخست متد upload نیازمند وابستگی \Illuminate\Contracts\Filesystem\Factory است. در طی اجرای این متد، قرارداد لاراول مناسب تزریق خواهد شد.

اکنون می‌توانیم از وهله‌ای از filesystem factory برای ایجاد وهله‌های دیسک بسته به نیاز استفاده کنیم. وهله دیسک در لاراول، درایوری است که امکان دسترسی آسان به فایل‌سیستم‌های زیرین مانند دیسک محلی، کلود S3 آمازون و موارد مشابه را فراهم می‌سازد.

برای سادگی موضوع، فایل تصویر استاتیک را که از قبل در فضای ذخیره‌سازی محلی پیش‌فرض لاراول موجود و مسیر آن به صورت storage/app/test.jpg است را انتقال می‌دهیم. به عنوان نخستین گام محتوای فایل منبع را انتخاب می‌کنیم.

زمانی که همه چیز مطابق انتظار راه‌اندازی شد، می‌توانید فایل‌ها را با استفاده از متد زیر با S3 آمازون همگام‌سازی کنید.

در صورتی که موردی به درستی کار نکرد، باید مطمئن شوید که متغیرهای محیطی AWS به درستی تنظیم شده‌اند.

و آخرین کاری که باید انجام داد این است که یک فایل view را فراخوانی کنید تا تصویر همگام‌سازی شده و پیام مناسبی را نمایش دهد.

البته ما هنوز این فایل view را ایجاد نکرده‌ایم و این همان کاری است که دقیقاً در بخش بعدی قرار است اجرا کنیم.

View

در این بخش یک فایل ویو در مسیر packages/envato/aws/src/views/upload.blade.php و با محتوای زیر می‌سازیم:

این یک فایل ویوی کاملاً استاندارد است که تصویر آپلود شده را به محض آپلود موفق نمایش می‌دهد همچنین در صورتی که آپلود عکس، موفق باشد، پیام خطای مناسبی نمایش خواهد داد.

ارائه‌دهنده سرویس

ما کار خود را با پکیج تقریباً به پایان برده‌ایم، چون همه فایل‌های لازم را با موفقیت ایجاد کرده‌ایم. گام بعدی این است که یک ارائه‌دهنده سرویس بسازیم به طوری که بتوانیم مسیرها و ویوهای پکیج خود را بسازیم. در ادامه یک فایل ارائه‌دهنده سرویس در مسیر packages/envato/aws/src/Providers/AwsServiceProvider.php و با محتوای زیر ایجاد می‌کنیم:

بدیهی است که می‌توانستیم فایل ارائه‌دهنده سرویس را با استفاده از دستور آرتیزان نیز بسازیم. اما این کار نیازمند گام‌های اضافی انتقال فایل از app/Providers به پکیج بود.

در هر حال در ادامه به بررسی فایل ارائه‌دهنده سرویس که ایجاد کردیم، می‌پردازیم. در ابتدا مسیرها و ویوهای مرتبط با پکیج را بارگذاری می‌کنیم.

سپس پشتیبانی از انتشار ویوهای پکیج را ارائه می‌کنیم به طوری که توسعه‌دهندگانی که می‌خواهند ویوها را override کنند بتوانند این کار را انجام دهند. دفعه بعد که دستور php artisan vendor:publish اجرا شود، لاراول ویوها را از packages/envato/aws/src/views/ به resources/views/vendor/aws کپی می‌کند.

اکنون توسعه‌دهندگان دیگر می‌توانند ویوها را زیر دایرکتوری resources/views/vendor/aws تغییر دهند و این فایل‌ها به جای ویوهای زیر دایرکتوری packages/envato/aws/src/views/ به صورت خودکار از سوی لاراول انتخاب می‌شوند. در واقع، این روش صحیح ایجاد تغییر در ویوهای پکیج شخص ثالث به جای تغییر دادن مستقیم ویوهای پکیج محسوب می‌شود.

بدین ترتیب کار ما با فایل ارائه‌دهنده سرویس به پایان می‌رسد. چنان که انتظار دارید باید مدخل ارائه‌دهنده سرویس را در config/app.php اضافه کنیم. مدخل زیر را در آرایه providers وارد کنید.

بدین ترتیب کار ما به پایان می‌رسد. اینک همه چیز نظم خود را یافته است و از این رو می‌توانیم در ادامه به تست پکیج خود بپردازیم.

در ادامه URL به صورت http://your-laravel-application/aws/s3/upload را در مرورگر خود وارد کنید. اگر همه چیز به درستی پیش برود باید تصویری را که از کلود S3 آمازون بارگذاری می‌شود ببینید. بدین ترتیب راهنمای ما نیز به پایان می‌رسد.

سخن پایانی

در این مقاله به بررسی یکی از مهم‌ترین قابلیت‌های فریمورک لاراول یعنی مدیریت پکیج پرداختیم. در فرایند راه‌اندازی پکیج سفارشی لاراول یک مثال عملی را بررسی کردیم که روش آپلود تصویر روی کلود S3 آمازون را نمایش می‌داد.

مدیریت پکیج قابلیت زیبایی در لاراول است که به وسیله آن می‌توان مجموعه‌ای از کارکردها را به صورت مجموع و کنار هم توزیع کرد. در واقع آن را می‌توان به عنوان یک گزینه برای رویکرد توسعه ماژول سفارشی در لاراول نگریست.

اگر این مطلب برای شما مفید بوده است، آموزش‌های زیر نیز به شما پیشنهاد می‌شوند:

==

 

«میثم لطفی» دانش‌آموخته ریاضیات و شیفته فناوری به خصوص در حوزه رایانه است. وی در حال حاضر علاوه بر پیگیری علاقه‌مندی‌هایش در رشته‌های برنامه‌نویسی، کپی‌رایتینگ و محتوای چندرسانه‌ای، در زمینه نگارش مقالاتی با محوریت نرم‌افزار نیز با مجله فرادرس همکاری دارد.

آیا این مطلب برای شما مفید بود؟

نظر شما چیست؟

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *