برنامه‌های Laravel

(Laravel Apps)

🎯 توضیحات و نکات تکمیلی

فهرست عناوین:

• لینک‌کردن پوشه‌ی storage به پوشه‌ی public
• بهینه کردن لاراول برای استقرار
• تنظیمات اختصاصی php.ini
• تنظیمات TrustedProxies (برای مشاهده IP واقعی کاربران)
• فایل‌های CSS و JS به صورت خودکار build می‌شوند
• کار با Queue ها
• مدیریت لاگ‌ها در Laravel
• انتخاب نسخه‌ی PHP
• تنظیم منطقه‌ی زمانی (TimeZone)
• فعال‌سازی Caching
• رفع خطای CORS
• استفاده از پکیج‌های Ignition و Faker
• لیست اکستنشن‌های نصب شده

لینک‌کردن پوشه‌ی storage به پوشه‌ی public

برای دسترسی به فایل‌های پوشه‌هایstorage، طبق مستندات لاراول باید این پوشه به پوشه‌ی public لینک شود. لیارا به‌صورت خودکار، در زمان استقرار، دستورphp artisan storage:linkرا اجرا می‌کند و نیازی نیست که اقدام خاصی انجام دهید.

بهینه کردن لاراول برای استقرار

Laravel برای دیپلوی در محیط‌های production با اجرای چند دستور ساده می‌تواند عملکرد بهتری داشته باشد. دستور اولphp artisan config:cache است که وظیفه کش کردن کانفیگ‌فایل‌ها را به عهده دارد و دستور دوم php artisan route:cache است که وظیفه کش کردن فایل‌های route را به عهده دارد. برای این که این دستورات به صورت خودکار توسط لیارا در هر استقرار اجرا شود کافیست که در فایل liara.json این فیلد‌ها را اضافه کنیم:

{
  "platform": "laravel",
  "app": "laravel-starter",
  "laravel": {
    "configCache": true,
    "routeCache": true
  }
}

تنظیمات اختصاصی php.ini

از طریق ایجاد یک فایل با نامliara_php.iniداخل ریشه‌ی برنامه‌ی‌تان می‌توانید تنظیمات PHP را شخصی‌سازی کنید. برای مثال، ممکن است بخواهید که حداکثر حجم مجاز برای آپلود فایل در سایت لاراولی‌تان را شخصی‌سازی کنید. پس لازم است که فایلliara_php.iniرا به برنامه‌ی‌تان اضافه کرده و محتویات آن را برابر تکه‌کد قرار دهید:

file_uploads = On
memory_limit = 128M
upload_max_filesize = 64M
post_max_size = 128M
max_execution_time = 600

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

تنظیمات TrustedProxies (برای مشاهده IP واقعی کاربران)

تمامی درخواست‌ها به سمت برنامه‌ی شما توسط Reverse proxy های لیارا هدایت می‌شوند. برای این که در برنامه‌ی‌تان بتوانید به آی‌پی واقعی کاربر دسترسی داشته باشید و یا این که از قابلیت Signed URL های Laravel استفاده کنید، لازم است که تغییراتی را در فایلapp/Http/Middleware/TrustProxies.phpاعمال کنید.

در این فایل، یک متغیر با نام$proxiesوجود دارد. فقط کافیست که مقدار آن را به*تغییر دهید.

<?php
namespace AppHttpMiddleware;
use IlluminateHttpRequest;
use FideloperProxyTrustProxies as Middleware;
class TrustProxies extends Middleware
{
    /**
     * The trusted proxies for this application.
     *
     * @var array|string
     */
    protected $proxies = '*';
    /**
     * The headers that should be used to detect proxies.
     *
     * @var int
     */
    protected $headers = Request::HEADER_X_FORWARDED_ALL;
}

فایل‌های CSS و JS به صورت خودکار build می‌شوند

همان‌طور که اطلاع دارید، در برنامه‌های لاراولی با اجرای دستورnpm run productionفایل‌های SASS به CSS تبدیل می‌شوند و همین‌طور کدهای جاوا اسکریپت ES6 به بالا به ES5 تبدیل شده و یک‌پارچه می‌شوند.
هر زمان که برنامه‌ی‌تان را روی لیارا مستقر می‌کنید، ما این دستور را برای‌تان اجرا می‌کنیم تا مطمئن شویم که فایل‌های CSS و JS شما به صورت صحیح در اختیار کاربران‌تان قرار گیرند.

اما اگر از Laravel فقط برای ساخت یک API استفاده کرده‌اید و یا به طور کلی نیازی به این ندارید که لیارا پکیج‌های npm را برای‌تان نصب و فایل‌های CSS و JavaScript تان را build کند، می‌توانید در فایل liara.json برنامه، یک فیلد با نام laravel و داخل آن یک فیلد با نامbuildAssetsبسازید و این قابلیت را غیر فعال کنید.

{
  "laravel": {
    "buildAssets": false
  }
}

با این تغییر، هر بار که دیپلوی کنید، لیارا از اجرای دستورات npm خودداری می‌کند.

کار با Queue ها

یکی از امکانات مهم Laravel، قابلیت تعریف صف (Queue) است. در پلتفرم لاراول، Supervisor نصب شده و شما با ایجاد یک فایل به نام supervisor.conf در ریشه‌ی برنامه‌، می‌توانید تنظیمات صف‌های مختلف‌تان را در آن وارد کنید. و در نهایت با یک‌بار دیپلوی‌کردن، صف‌های شما شروع به کار خواهند کرد.

Supervisor برنامه‌ی بسیار مفیدی است که سعی می‌کند صف‌های شما را همیشه در حال اجرا نگه‌دارد. اگر به هر دلیلی صف‌های‌تان به خطا بخورند و خاموش شوند، Supervisor آن‌ها را دوباره ایجاد و فعال می‌کند.

از بخش خط فرمان (کنسول) برنامه‌ی‌تان هم می‌توانید با supervisorctl کار کنید و وضعیت صف‌های‌تان را مشاهده کنید.

$ supervisorctl status

یک نمونه کانفیگ ساده برای یک صف با نام sms که وظیفه‌ی ارسال پیامک به کاربران را به عهده دارد:

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan queue:work
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
numprocs=1
user=www-data
redirect_stderr=true
stdout_logfile=/tmp/laravel-worker.log

برای اطلاعات بیشتر می‌توانید به لینک‌های زیر مراجعه کنید:

• مستندات Supervisor
• مستندات لاراول درباره‌ی Supervisor

مدیریت لاگ‌ها در Laravel

لاگ‌ها وظیفه دارند اتفاقات رخ داده در نرم‌افزار مثل error ها یا exception ها و حتی اطلاعاتی که خود برنامه‌نویس به دلخواه خود در بخش‌های مختلف نرم‌افزار درنظرگرفته را، ثبت کنند. Laravel روش‌های مختلفی برای لاگ‌ کردن دارد که اصطلاحا به آن‌ها Channel Drivers میگوید. برای آشنایی بیشتر به مستندات لاراول درباره‌ی Logs مراجعه کنید.

برای نمونه اگر قصد دارید Log ها را روی Console بریزید، تا در پنل لاگ‌های داشبورد لیارا قابل مشاهده باشد می‌توانید از درایورerrorlogاستفاده کنید. اگر قصد دارید Log ها را داخل یک فایل نگه‌دارید از درایور single استفاده کنید. اگر قصد دارید Log ها را بر اساس روز در فایل‌های مجزایی نگه‌داری کنید تا حجم هر فایل برای بررسی زیاد نشود می‌توانید از درایور daily استفاده کنید. تصمیم نحوه‌ نگه‌داری Log ها با شماست و در صورتی که قصد تغییر آن را دارید به راحتی از طریق بخش تنظیمات برنامه می‌توانید نام درایور موردنظر خودتون رو به env ها اضافه کنید:

LOG_CHANNEL=daily

یا

LOG_CHANNEL=errorlog

انتخاب نسخه‌ی PHP

به‌صورت پیش‌فرض، برنامه‌ی شما در نسخه‌ی PHP 7.4 اجرا می‌شود. در صورتی که قصد دارید نسخه دیگری را برای اجرای برنامه‌ی‌تان استفاده کنید می‌توانید داخل فایل liara.json بخش زیر را اضافه کنید: (فایل زیر برای یک برنامه تستی در نظر گرفته شده است.)

{
  "platform": "laravel",
  "app": "laravel-starter",
  "laravel": {
    "phpVersion": "8.0"
  }
}

در حال حاضر، از نسخه‌های زیر پشتیبانی می‌کنیم:

• 7.2
• 7.3
• 7.4 (پیش‌فرض)
• 8.0 (آزمایشی)

تنظیم منطقه‌ی زمانی (TimeZone)

به صورت پیش‌فرض، منطقه‌ی زمانی بر روی Asia/Tehran تنظیم شده است. برای تغییر مقدار پیش‌فرض، می‌توانید از پارامترtimezoneدر فایل liara.jsonاستفاده کنید. برای نمونه:

{
  "platform": "laravel",
  "app": "laravel-starter",
  "laravel": {
    "timezone": "America/Los_Angeles"
  }
}

فعال‌سازی Caching

برای فعال‌سازی Caching در برنامه‌های Laravel باید تنظیمات مربوطه را در فایل public/.htaccess برنامه وارد کنید:

<IfModule mod_deflate.c>
 AddOutputFilterByType DEFLATE text/plain
 AddOutputFilterByType DEFLATE text/html
 AddOutputFilterByType DEFLATE text/xml
 AddOutputFilterByType DEFLATE text/css
 AddOutputFilterByType DEFLATE text/javascript
 AddOutputFilterByType DEFLATE application/xml
 AddOutputFilterByType DEFLATE application/xhtml+xml
 AddOutputFilterByType DEFLATE application/rss+xml
 AddOutputFilterByType DEFLATE application/atom_xml
 AddOutputFilterByType DEFLATE application/javascript
 AddOutputFilterByType DEFLATE application/x-javascript
 AddOutputFilterByType DEFLATE application/x-shockwave-flash
</IfModule>


<IfModule mod_expires.c>
 ExpiresActive On
 ExpiresByType text/css "access plus 1 month"
 ExpiresByType text/javascript "access plus 1 month"
 ExpiresByType text/html "access plus 1 month"
 ExpiresByType application/javascript "access plus 1 month"
 ExpiresByType image/gif "access plus 1 month"
 ExpiresByType image/jpeg "access plus 1 month"
 ExpiresByType image/png "access plus 1 month"
 ExpiresByType image/x-icon "access plus 1 month"
</IfModule>
<ifmodule mod_headers.c>
 <filesmatch "\.(ico|jpe?g|png|gif|swf)$">
  Header set Cache-Control "max-age=2592000, public"
 </filesmatch>
 <filesmatch "\.(css)$">
  Header set Cache-Control "max-age=604800, public"
 </filesmatch>
 <filesmatch "\.(js)$">
  Header set Cache-Control "max-age=216000, private"
 </filesmatch>
</ifmodule>

در قدم بعد باید قطعه کد زیر را به فایل webpack.mix.js اضافه کنید:

if (mix.inProduction()) {
    mix.version();
}

درنهایت باید فایل‌های Asset را مانند مثال زیر در برنامه‌ی خود فراخوانی کنید:

<script src="{{ mix('js/app.js') }}"></script>

رفع خطای CORS

برای رفع خطای CORS در برنامه‌های Laravel، دو راه حل مختلف پیش روی شما قرار دارد. در راه حل اول می‌توانید پکیج laravel-cors را با اجرای دستور زیر در پروژه‌ی خود نصب کرده و طبق مستندات، CORS را در پروژه‌ی خود فعال کنید.

composer require fruitcake/laravel-cors

در راه حل دوم می‌توانید تنظیمات مربوط به CORS را در فایل public/.htaccess پروژه‌ی خود اضافه کنید:

Header set Access-Control-Allow-Origin "*"

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # Handle Authorization Header
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # Redirect Trailing Slashes If Not A Folder...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # Send Requests To Front Controller...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

استفاده از پکیج‌های Ignition و Faker

شما برای استفاده از پکیج‌های Ignition و Faker در لیارا باید ابتدا این پکیج‌ها را از بخش require-dev فایل composer.json به بخش require انتقال دهید:

"require": {
        ...
        "facade/ignition": "^2.5",
        "fakerphp/faker": "^1.9.1",
},

سپس برای اعمال این تغییرات، دستور زیر را در لوکال خود اجرا کنید:

حال با اجرای دستور liara deploy، فرایند استقرار آغاز خواهد شد.

لیست اکستنشن‌های نصب شده

در پلتفرم لاراول، اکستنشن‌های PHP زیر نصب شده‌اند:

[PHP Modules]
amqp
apcu
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gd
gettext
gmp
gnupg
hash
iconv
igbinary
imagick
imap
intl
json
libxml
mbstring
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_dblib
pdo_mysql
pdo_pgsql
pdo_sqlite
pgsql
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
sysvmsg
sysvsem
sysvshm
tokenizer
xml
xmlreader
xmlwriter
xsl
yaml
Zend OPcache
zip
zlib

[Zend Modules]
Zend OPcache