
ممکن است گاهی بنا به دلایلی از جمله خواست مشتری یا پرداخت هزینه کمتر مجبور به استفاده از هاست های اشتراکی باشید ؛ کسانی که برای اولین بار قصد دارند پروژه لاراولی خود را در هاست اشتراکی نصب و اجرا کنند به احتمال زیاد دچار مشکلاتی خواهند شد که ممکن است آنها را به شدت کلافه و عصبی کند . در این آموزش قصد دارم به شما نحوه نصب پروژه لاراولی خود در هاست های اشتراکی را به صورت گام به گام آموزش دهم و همچنین شما را با مشکلاتی که ممکن است با آن مواجه شوید و راه حل آنها آشنا کنم .
هر نسخه از لاراول برای اجرا به حداقل نسخه ای از PHP و همچنین extention های Tokenizer ، Mbstring ، PDO ، OpenSSL و XML نیاز دارد پس در هنگام خرید هاست به این موارد دقت کنید .
به پنل مدیریتی هاست خود رفته و سپس File Manager هاست خود را باز کنید ؛ اگر شما در حال مشاهده Root هاست خود باشید پس باید پوشه ها و فایل هایی همانند زیر در آن ببینید :
/.php /backups /domains /imap /Maildir /public_html .bash_logout .bash_profile . . .
توجه : ممکن است ساختار پوشه بندی هاست شما کمی متفاوت باشد .
درصورتی که از طریق FTP به هاست خود متصل شده اید ، به Root هاست خود رفته و گام به گام همه مراحل را طی کنید .
حال یک پوشه با نام دلخواه به طور مثال LaravelApp در مسیر domain/YourDomain.ir/. همانند زیر بسازید :
/.php /backups /domains /YourDomain.ir /.htpasswd /logs /private_html /public_html /stats /LaravelApp /imap . . .
حال در پوشه LaravelApp که تازه آن را ایجاد کرده اید پروژه لاراول خود را به طور کامل آپلود کنید :
/.php /backups /domains /YourDomain.ir /.htpasswd /logs /private_html /public_html /stats /LaravelApp /app /bootstrap /config /database . . . /imap . . .
بعد از آپلود پروژه ، باید تمام محتویات پوشه public پروژه خود را به پوشه public_html هاست انتقال دهید :
/.php /backups /domains /YourDomain.ir /.htpasswd /logs /private_html /public_html /css /js .htaccess index.php . . . /stats /LaravelApp /app /bootstrap /config /database . . . /imap . . .
بعد از انجام این مراحل ما باید آدرس های موجود در فایل index.php را با توجه به ساختار و پوشه بندی جدید تغییر دهیم ؛ برای اینکار به پوشه public_html هاست خود رفته و فایل index.php را باز کنید و سپس دو خط زیر را در آن بیابید :
require __DIR__.'/../bootstrap/autoload.php'; $app = require_once __DIR__.'/../bootstrap/app.php';
حال این آدرس ها را با توجه به نام پوشه ای که ایجاد کردید یعنی LaravelApp به صورت زیر تغییر دهید :
require __DIR__.'/../LaravelApp/bootstrap/autoload.php'; $app = require_once __DIR__.'/../LaravelApp/bootstrap/app.php';
حال باید پروژه لاراولی شما بدون خطا و به درستی اجرا شود .
توجه : اکثر هاست های اشتراکی اجازه ی استفاده از فایل env. را به شما نمیدهند و با وجود بودن آن هم شاهد اجرای آن نخواهید بود و پروژه لاراولی شما اجرا نخواهد شد و به مشکل برخواهید خورد .
برای حل عدم اجازه استفاده از فایل env. در هاست های اشتراکی میتوانید به راحتی تمام مقادیر درون این فایل را مستقیما در فایل های config پروژه خود وارد کنید .
فایل های مربوط به config پروژه خود را میتوانید در مسیر domain/YourDomain.ir/LaravelApp/config/. در هاست خود بیابید .
به طور مثال برای وارد کردن تنظیمات مربوط به دیتابیس پروژه خود کافی است به پوشه config پروژه خود که در بالا آدرس آن گفته شد مراجعه کنید و فایل database.php باز کنید :
<?phpreturn [ 'default' => env('DB_CONNECTION', 'mysql'), 'connections' => [ 'sqlite' => [ 'driver' => 'sqlite', 'database' => env('DB_DATABASE', database_path('database.sqlite')), 'prefix' => '', ], 'mysql' => [ 'driver' => 'mysql', 'host' => env('DB_HOST', '127.0.0.1'), 'port' => env('DB_PORT', '3306'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'unix_socket' => env('DB_SOCKET', ''), 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '', 'strict' => true, 'engine' => null, ], 'pgsql' => [ 'driver' => 'pgsql', 'host' => env('DB_HOST', '127.0.0.1'), 'port' => env('DB_PORT', '5432'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'charset' => 'utf8', 'prefix' => '', 'schema' => 'public', 'sslmode' => 'prefer', ], 'sqlsrv' => [ 'driver' => 'sqlsrv', 'host' => env('DB_HOST', 'localhost'), 'port' => env('DB_PORT', '1433'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'charset' => 'utf8', 'prefix' => '', ], ], 'migrations' => 'migrations', 'redis' => [ 'client' => 'predis', 'default' => [ 'host' => env('REDIS_HOST', '127.0.0.1'), 'password' => env('REDIS_PASSWORD', null), 'port' => env('REDIS_PORT', 6379), 'database' => 0, ], ], ];
حال با توجه به نوع دیتابیسی که استفاده میکنید اطلاعات مربوط به آن را به صورت دستی وارد کنید ؛ یعنی به طور مثال اگر از دیتابیس mysql استفاده میکنید باید فایل فوق را همانند زیر با توجه به اطلاعات دیتابیس خود تغییر دهید :
<?phpreturn [ 'default' => 'mysql', 'connections' => [ 'sqlite' => [ 'driver' => 'sqlite', 'database' => env('DB_DATABASE', database_path('database.sqlite')), 'prefix' => '', ], 'mysql' => [ 'driver' => 'mysql', 'host' => 'Database_Address', 'port' => '3306', 'database' => 'Database_Name', 'username' => 'Database_UserName', 'password' => 'Database_Password', 'unix_socket' => '', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '', 'strict' => true, 'engine' => null, ], 'pgsql' => [ 'driver' => 'pgsql', 'host' => env('DB_HOST', '127.0.0.1'), 'port' => env('DB_PORT', '5432'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'charset' => 'utf8', 'prefix' => '', 'schema' => 'public', 'sslmode' => 'prefer', ], 'sqlsrv' => [ 'driver' => 'sqlsrv', 'host' => env('DB_HOST', 'localhost'), 'port' => env('DB_PORT', '1433'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'charset' => 'utf8', 'prefix' => '', ], ], 'migrations' => 'migrations', 'redis' => [ 'client' => 'predis', 'default' => [ 'host' => env('REDIS_HOST', '127.0.0.1'), 'password' => env('REDIS_PASSWORD', null), 'port' => env('REDIS_PORT', 6379), 'database' => 0, ], ], ];
توجه : باید به جای مقادیر Database_Address و Database_Name و Database_UserName و Database_Password اطلاعات مربوط به دیتابیس mysql خود را وارد کنید .
حال همانند فوق تمامی مقادیر درون فایل env. پروژه خود را درون فایل مربوط به خود در پوشه config پروژه وارد نمایید ؛ بعد از اتمام اینکار درصورت انجام درست تمامی مراحل فوق باید پروژه لاراولی شما بدون هیچ مشکلی اجرا شود .
اگر با مشکل ذخیره فایل و یا session ها مواجه شدید مسیر های زیر را در فایل
bootstrap/config/cache.php
اصلاح کنید :
Project Path :
/domains/domain_name.com/{project_name}
Storage Path:
array ( 'default' => 'local', 'cloud' => 's3', 'disks' => array ( 'local' => array ( 'driver' => 'local', 'root' => './../../public_html/api', 'visibility' => 'public', ), 'public' => array ( 'driver' => 'local', 'root' => '/../../{project_name}/storage/app/public', 'visibility' => 'public', ), 's3' => array ( 'driver' => 's3', 'key' => 'your-key', 'secret' => 'your-secret', 'region' => 'your-region', 'bucket' => 'your-bucket', ), ), ),