Как установить Laravel на VPS с Ubuntu
Laravel 13 работает на PHP 8.3 и новее — эта версия и ставится из пакетов Ubuntu 24.04. На сервер нужно поставить PHP с модулями, Composer и nginx, загрузить проект, заполнить файл .env и дать сайту права на запись в две папки. Ниже все шаги по порядку, с командами.
Содержание 13
- Что сделать прямо сейчас
- Что нужно Laravel
- 1. Поставьте PHP и модули
- 2. Поставьте Composer и nginx
- 3. Загрузите проект
- 4. Установите зависимости
- 5. Заполните .env
- 6. Создайте ключ и таблицы
- 7. Дайте права на storage и bootstrap/cache
- 8. Настройте nginx и проверьте
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Поставьте PHP с модулями, Composer и nginx — шаги 1 и 2.
- Загрузите проект в папку
/var/www/example.com— шаг 3. - Установите зависимости, заполните .env, создайте ключ — шаги 4–6.
- Дайте права на папки — шаг 7.
- Настройте nginx — nginx для Laravel.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Работайте от своего пользователя с правами sudo, не от root. Вместо example.com везде подставьте свой домен.
Что нужно Laravel
| Что нужно | Чем поставить |
|---|---|
| PHP 8.3 или новее | в Ubuntu 24.04 — пакет php-fpm, он ставит PHP 8.3 |
| модули Ctype, Fileinfo, PDO, Tokenizer | входят в пакет php8.3-common, ставятся вместе с PHP |
| модули Filter, Hash, OpenSSL, PCRE, Session | встроены в сам PHP |
| модуль cURL | пакет php-curl |
| модули DOM и XML | пакет php-xml |
| модуль Mbstring | пакет php-mbstring |
| Composer — ставит библиотеки проекта | пакет composer |
| веб-сервер | пакет nginx |
Список модулей взят из документации Laravel 13, состав пакетов — с сайта пакетов Ubuntu.
1. Поставьте PHP и модули
sudo apt update
sudo apt install php-fpm php-cli php-mbstring php-xml php-curl php-zip php-mysql php-sqlite3 unzipЕсли система спросит пароль, введите пароль своего пользователя — символы при вводе не видны. На вопрос Do you want to continue? [Y/n] нажмите Enter.
| Пакет | Зачем |
|---|---|
php-fpm | PHP для сайта — через него nginx запускает Laravel |
php-cli | PHP для команд в терминале: php artisan, composer |
php-zip и unzip | Composer распаковывает ими пакеты |
php-mysql | подключение к MySQL и MariaDB; для PostgreSQL — php-pgsql |
php-sqlite3 | база SQLite — её новый проект Laravel использует с самого начала |
Пакеты с именем php-… ставят модули для той версии PHP, которая есть в вашей Ubuntu: в 24.04 это php8.3-….
Проверьте:
php -v
php -m | grep -iE 'curl|dom|mbstring|pdo'Первая строка ответа php -v начинается с PHP 8.3. Вторая команда покажет модули curl, dom, mbstring и PDO с драйверами. Подробнее — в статье Установка PHP.
2. Поставьте Composer и nginx
sudo apt install composer nginx
composer --versionВ Ubuntu 24.04 из пакетов ставится Composer 2.7.1. Laravel 13 требует Composer 2.2 или новее — этой версии хватает. Подробнее — Установка Composer и Установка nginx.
3. Загрузите проект
Создайте папку сайта и сделайте себя её владельцем:
sudo mkdir -p /var/www/example.com
sudo chown $USER:$USER /var/www/example.com| Откуда проект | Команда |
|---|---|
| из Git-репозитория | git clone https://github.com/имя/проект.git /var/www/example.com |
| новый пустой проект | composer create-project laravel/laravel /var/www/example.com |
| с компьютера | загрузите папку целиком, без vendor и node_modules — они ставятся на сервере |
Как работает клонирование — в статье git clone. Загрузить папку с компьютера поможет rsync.
Команда composer create-project сама выполняет шаги 4–6: ставит зависимости, создаёт .env и ключ, создаёт базу SQLite и таблицы. После неё переходите к шагу 7, а в .env поправьте строки из шага 5.
4. Установите зависимости
cd /var/www/example.com
composer install --no-dev --optimize-autoloader| Ключ | Что делает |
|---|---|
--no-dev | не ставит пакеты для разработки — тесты и отладку |
--optimize-autoloader | составляет полный список классов, чтобы PHP быстрее их находил |
Composer запускайте от своего пользователя, не через sudo — почему.
Если в папке проекта есть файл package.json, соберите стили и скрипты — для этого нужен Node.js:
npm install
npm run buildБез сборки Laravel пишет ошибку Vite manifest not found.
5. Заполните .env
cp .env.example .env
nano .envПоменяйте строки:
APP_NAME="Мой сайт"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.comВ образце стоят APP_ENV=local и APP_DEBUG=true — так оставлять нельзя: при ошибке посетитель увидит пути к файлам и настройки.
База в образце — SQLite (DB_CONNECTION=sqlite). Для MySQL уберите знак # в начале строк DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD и впишите свои значения, а в DB_CONNECTION — mysql.
Сохраните файл: Ctrl+O, Enter, выход — Ctrl+X (как работать в nano). Все строки .env по порядку — в статье .env на рабочем сайте.
6. Создайте ключ и таблицы
php artisan key:generate
php artisan migrate --forceПервая команда записывает в строку APP_KEY файла .env случайный ключ — им Laravel шифрует cookie и другие данные. Вторая создаёт таблицы в базе. Ключ --force нужен на рабочем сайте: без него Laravel с APP_ENV=production переспросит, точно ли выполнять. Подробнее — Миграции на рабочем сайте.
7. Дайте права на storage и bootstrap/cache
Laravel пишет в две папки: storage — журнал, кеш, загруженные файлы — и bootstrap/cache. Сайт работает от пользователя www-data, поэтому отдайте папки ему:
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache
sudo usermod -aG www-data $USERТретья команда добавляет вас в группу www-data — тогда Composer сможет записывать в bootstrap/cache при обновлениях. Группа начнёт действовать после нового входа: отключитесь и подключитесь по SSH заново.
Соберите кеш настроек от пользователя сайта:
cd /var/www/example.com
sudo -u www-data php artisan optimizeЧто делает команда — в статье php artisan optimize.
8. Настройте nginx и проверьте
Настройки сайта для nginx — в статье nginx для Laravel. После неё проверьте:
curl -I http://example.com/upВ первой строке ответа должен быть код 200. Адрес /up есть в каждом новом проекте Laravel: он отвечает 200, если Laravel запустился без ошибок. Подробнее — Как проверить проект Laravel.
Затем подключите HTTPS — бесплатный SSL-сертификат.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Composer пишет, что нужен php ^8.3 | на сервере PHP старше 8.3 | Разбор |
Composer пишет ext-… is missing from your system | не поставлен модуль PHP | Разбор |
| Composer просит zip или unzip | нет php-zip или unzip | Разбор |
could not find driver | нет модуля PHP для базы | Разбор |
No application encryption key has been specified. | не выполнен key:generate | Разбор |
Please provide a valid cache path. | нет папок или прав в storage | Разбор |
Vite manifest not found | не собраны стили и скрипты | Разбор |
страница 500 Server Error | ошибка записана в журнал | Разбор |
502 Bad Gateway | nginx не достучался до PHP-FPM | Разбор |
Все ошибки Laravel по тексту сообщения — на странице Ошибки Laravel.
Источники
- Документация Laravel: Deployment — на английском: версия PHP, список модулей и права на storage и bootstrap/cache.
- Документация Laravel: Configuration — на английском: файл .env и APP_DEBUG.
- Файл composer.json нового проекта Laravel — на английском: требование php ^8.3 и что делает create-project.
- Пакет php-fpm для Ubuntu 24.04 — на английском: PHP 8.3 в Ubuntu 24.04.
- Документация Composer: create-project и install — на английском: ключи --no-dev и --optimize-autoloader.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- nginx для Laravelнастройки сайта для nginx.
- Ошибки Laravelчто значит сообщение и как его исправить.