Як налаштувати Laravel на macOS М1-М4: покроковий гайд

Laravel сьогодні — це стандарт у світі PHP-розробки. Але власники Mac з процесорами M1/M2/M3/M4 стикаються з додатковими питаннями: як правильно поставити PHP, щоб не конфліктував із системною, як працює Docker на ARM та чи потрібно встановлювати Rosetta? У цій статті я покажу реальний шлях налаштування Laravel на macOS, з прикладами коду, підводними каменями та порадами.

Забігаючи на перед можу також сказати що існує Herd який дозволяє працювати з Laravel на macOS. Це готова коробка з усіма потрібними пакетами, але оскільки безкоштовна версія має ряд обмежень вважаємо доцільним написати цю статтю.

Чому варто обрати macOS для Laravel?

macOS вже багато років вважається зручною системою для веб-розробки. Вона має вбудований UNIX-термінал, що спрощує роботу з PHP, MySQL, Git та іншими інструментами. На Apple Silicon це ще й швидкість — PHP-компіляції, робота Composer та Docker-контейнерів займає помітно менше часу.

З іншого боку, мінус у тому, що не всі бібліотеки та Docker-образи оптимізовані під ARM. Іноді доведеться шукати мультиплатформені збірки або запускати Rosetta для сумісності.

Крок 1. Встановлюємо Homebrew

Homebrew — це менеджер пакетів, без якого складно уявити сучасну розробку на Mac. Він дозволяє швидко ставити PHP, Composer, MySQL, Node.js та інші інструменти. Встановлюється однією командою:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Code language: JavaScript (javascript)

Після інсталяції важливо додати Homebrew у PATH для M1/M2:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"Code language: PHP (php)

Тепер можна перевірити роботу:

brew doctor

Крок 2. PHP та Composer

Laravel офіційно підтримує PHP 8.2 та 8.3. Тому ставимо останню стабільну версію разом з Composer:

brew install php composer

Перевірка версій:

php -v
composer -V

⚠️ На Mac із M1/M2 часто виникає ситуація, коли системний PHP конфліктує з Homebrew-версією. Завжди використовуйте шлях /opt/homebrew/bin/php.

Крок 3. Створюємо новий Laravel-проєкт

Коли PHP та Composer встановлені, можна створювати проект Laravel на macOS:

composer create-project laravel/laravel myapp
cd myapp
php artisan serve

Після запуску відкриваємо у браузері http://127.0.0.1:8000 і бачимо вітальну сторінку Laravel. Це означає, що базове середовище вже готове.

Крок 4. Встановлюємо Node.js та npm

Laravel Mix і Vite працюють через Node.js. Без нього не збереш фронтенд:

brew install node
node -v
npm -v

Крок 5. Налаштування бази даних

Laravel підтримує MySQL, PostgreSQL, SQLite та інші СУБД. Найчастіше на Mac ставлять MySQL або PostgreSQL через Homebrew.

MySQL

brew install mysql
brew services start mysql
mysql_secure_installation

PostgreSQL

brew install postgresql
brew services start postgresql

Потім відкрийте файл .env у проекті Laravel і пропишіть параметри:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myapp
DB_USERNAME=root
DB_PASSWORD=

Тепер можна запускати міграції:

php artisan migrate

Крок 6. Використання Docker та Laravel Sail

Багато команд сьогодні працюють через Docker. На M1/M2 він працює добре, хоча інколи доводиться підбирати образи. Зручний спосіб — це Laravel Sail, який автоматизує підйом контейнерів.

brew install --cask docker
composer require laravel/sail --dev
php artisan sail:install
./vendor/bin/sail upCode language: JavaScript (javascript)

Плюси Docker на M1/M2: ізольованість середовища, легке перемикання між проектами. Мінуси: більший розхід пам’яті та проблеми із сумісністю ARM-образів.

Крок 7. Типові проблеми на M1/M2

1. ARM-образи в Docker. Не всі бази даних мають збірки для ARM. Використовуйте мультиплатформні образи, наприклад mysql/mysql-server:8.0.

2. Rosetta 2. Якщо інструмент не підтримує ARM, встановіть Rosetta:

softwareupdate --install-rosetta

3. Розширення PHP. Деякі пакети (redis, imagick) доводиться ставити через pecl:

pecl install redis

Крок 8. Оптимізація середовища

Щоб працювати комфортніше, раджу налаштувати:

• IDE: PHPStorm (платно) або VS Code з плагінами для Laravel.
• Кешування: php artisan config:cache, php artisan route:cache.
• Makefile для швидкого запуску команд.

up:
    php artisan serve

migrate:
    php artisan migrate

watch:
    npm run dev

Такий Makefile дозволяє запускати команди через make up чи make migrate замість довгих artisan-записів. У щоденній роботі це реально економить час.

Висновок

Laravel на macOS з M1/M2/М3/М4 працює чудово. Основні інструменти (PHP, Composer, MySQL, Docker) вже стабільні під ARM. Так, іноді доводиться шукати мультиплатформні образи або ставити Rosetta, але це дрібниці. У підсумку ви отримуєте швидке та зручне середовище для розробки.

Рекомендуємо оглянути наступні статті

• PHP vs Laravel: що обрати у 2025?
• Laravel tips & tricks: 20 прийомів, які піднімуть твій рівень
• Top-5 безкоштовних IDE для PHP