# آموزش کانفیگ لاراول بر روی سی‌ پنل

- پیوند: https://negarnovin.com/laravel-deploy-on-cpanel/
- منتشرشده: 2024-09-02T03:52:28+00:00
- نویسنده: نگارنوین

# آموزش کانفیگ 󠀁[لاراول](https://negarnovin.com/deploy-laravel-to-cpanel/)󠁿 بر روی سی پنل

در این مقاله قصد داریم شما را با نحوه کانفیگ لاراول بر روی سی پنل آشنا کنیم. یکی
از مواردی که توسعه دهندگان وب همواره با آن مواجه هستند، نحوه استقرار (Deploy) پروژه
های لاراول به صورت ساده و بهینه بر روی هاست اشتراکی است. سی پنل یکی از محبوب ترین
پنل های مدیریت هاست اشتراکی است که به دلیل رابط کاربری گرافیکی کارآمد، کاربران بسیاری
را به خود جذب کرده است.

## پیش نیازها

 1. **هاست سی پنل**: شما به یک هاست سی پنل نیاز دارید که از PHP و MySQL پشتیبانی کند.
 2. **دسترسی به خط فرمان**: داشتن دسترسی به SSH می تواند فرآیند کانفیگ را آسان تر کند،
    البته همه موارد نیز از طریق رابط گرافیکی سی پنل قابل انجام است.
 3. **آخرین نسخه لاراول**: پروژه لاراول خود را باید روی لوکال خود آماده داشته باشید.

## مراحل کانفیگ لاراول بر روی سی پنل

### ۱. انتقال فایل ها به سرور

اولین قدم در راه اندازی پروژه لاراول، انتقال فایل های پروژه از روی سیستم محلی (local)
به سرور است. برای این کار می توانید از FTP یا File Manager سی پنل استفاده کنید.

 1. **Compressed ورژن پروژه خود را ایجاد کنید**: تمامی فایل های پروژه را در یک فایل
    zip یا tar.gz فشرده کنید.
 2. **ورود به سی پنل**: وارد سی پنل شوید و به `File Manager` بروید.
 3. **آپلود فایل فشرده**: فایل فشرده را در مسیر `public_html` یا مسیر زیرمجموعه آن 
    آپلود کنید.
 4. **فایل فشرده را اکسترکت کنید**: پس از آپلود، بر روی فایل کلیک کرده و گزینه Extract
    را انتخاب کنید.

### ۲. تنظیمات محیطی (Environment)

پس از انتقال فایل ها به سرور، باید فایل `.env` را تنظیم کنیم تا بتواند با تنظیمات
سرور سازگار شود.

 1. **ویرایش فایل .env**: فایل `.env` را در مسیر اصلی پروژه پیدا کرده و ویرایش کنید.
 2. **تنظیمات دیتابیس**: اطلاعات دیتابیس را وارد کنید.
 3.     ```language-plaintext
        DB_CONNECTION=mysql
        DB_HOST=your_database_host
        DB_PORT=3306
        DB_DATABASE=your_database_name
        DB_USERNAME=your_database_username
        DB_PASSWORD=your_database_password
        ```
    

### ۳. تنظیم پوشه های قابل دسترسی

برای امنیت بیشتر، بهتر است تنها پوشه `public` پروژه شما دسترسی عمومی داشته باشد.
برای این کار می توانید روت سایت را بر روی پوشه `public` تنظیم کنید.

 1. **ویرایش تنظیمات ورودی سایت**: در سی پنل به بخش `Domains` یا `Addon Domains` بروید
    و مسیر دایرکتوری روت را به مسیر `public` تنظیم کنید.

### ۴. تنظیمات Composer و نصب وابستگی ها

برای راه اندازی پروژه لاراول، نیاز به نصب وابستگی هایی که در فایل `composer.json`
تعریف شده اند، دارید.

 1. **دسترسی به SSH**: اگر امکان دسترسی به SSH را دارید، به سرور خود متصل شوید.
 2. **نصب Composer**: اگر Composer روی سرور نصب نیست، می توانید با استفاده از دستورات
    زیر آن را نصب کنید.
 3.     ```language-sh
        curl -sS https://getcomposer.org/installer | php
        mv composer.phar /usr/local/bin/composer
        ```
    
 4. **اجرای Composer**: به مسیر پروژه رفته و Composer را اجرا کنید.
 5.     ```language-sh
        cd /home/your_username/public_html/your_project
        composer install
        ```
    

### ۵. تنظیمات کلیدی لاراول

از دستورات `artisan` برای تولید کلید و سایر تنظیمات استفاده کنید.

 1. **تولید کلید APP_KEY**:
 2.     ```language-sh
        php artisan key:generate
        ```
    

### ۶. تنظیمات Cache و Optimization

برای بهبود عملکرد، توصیه می شود که کش گذاری و بهینه سازی های لاراول را انجام دهید.

 1. **انتشار منابع (assets)**:
 2.     ```language-sh
        php artisan config:cache
        php artisan route:cache
        php artisan view:cache
        ```
    

### ۷. تغییر مجوزها (Permissions)

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

 1. **تنظیم مجوزها**:
 2.     ```language-sh
        chmod -R 755 storage
        chmod -R 755 bootstrap/cache
        ```
    

### ۸. تست کردن سایت

در این مرحله، باید سایت خود را تست کنید تا از صحیح بودن تنظیمات اطمینان حاصل کنید.
به آدرس دامنه خود بروید و مطمئن شوید که سایت به درستی لود می شود.

در صورتی که خطایی مشاهده کردید، لاگ های لاراول را بررسی کنید تا منشا مشکل را پیدا
کنید. لاگ های لاراول در مسیر `storage/logs/laravel.log` قرار دارند.

### ۹. تنظیمات نهایی (Optional)

برای بهبود کارایی و امنیت، ممکن است نیاز به انجام تنظیمات اضافی داشته باشید:

 1. **فعال سازی HTTPS**: توصیه می شود برای امنیت بیشتر از گواهینامه SSL استفاده کنید.
    می توانید از طریق سی پنل گواهینامه SSL نصب کنید.
 2. **محدود کردن دسترسی**: تنظیمات امنیتی لازم برای جلوگیری از دسترسی های غیرمجاز را
    اعمال کنید.
 3. **تنظیم کرون جاب ها**: اگر پروژه شما به کرون جاب نیاز دارد، آن ها را از طریق سی
    پنل تنظیم کنید.

## نتیجه گیری

تنظیم و کانفیگ لاراول بر روی سی پنل ممکن است در ابتدا پیچیده به نظر برسد، اما با
رعایت دقیق مراحل فوق می توانید به سادگی پروژه های لاراول خود را روی هاست اشتراکی
راه اندازی کنید. امیدواریم این مقاله برای شما مفید واقع شود و بتوانید پروژه های 
خود را به سادگی و بهینه بر روی سرورهای سی پنل مستقر کنید.

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

### 📌 خلاصه

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

## 🔗 مطالب مرتبط

 * [آموزش حل مشکل Add Domain در سی پنل](https://negarnovin.com/%d8%a2%d9%85%d9%88%d8%b2%d8%b4-%d8%ad%d9%84-%d9%85%d8%b4%da%a9%d9%84-add-domain-%d8%af%d8%b1-%d8%b3%db%8c-%d9%be%d9%86%d9%84/)
 * [آموزش انتقال سایت از دایرکت ادمین به سی پنل](https://negarnovin.com/%d8%a2%d9%85%d9%88%d8%b2%d8%b4-%d8%a7%d9%86%d8%aa%d9%82%d8%a7%d9%84-%d8%b3%d8%a7%db%8c%d8%aa-%d8%a7%d8%b2-%d8%af%d8%a7%db%8c%d8%b1%da%a9%d8%aa-%d8%a7%d8%af%d9%85%db%8c%d9%86-%d8%a8%d9%87-%d8%b3%db%8c/)
 * [آموزش ورود به سی پنل](https://negarnovin.com/%d8%a2%d9%85%d9%88%d8%b2%d8%b4-%d9%88%d8%b1%d9%88%d8%af-%d8%a8%d9%87-%d8%b3%db%8c-%d9%be%d9%86%d9%84/)