OS X High Sierra默认Apache环境下Laravel开发配置问题求助

Hey there! I’ve helped lots of folks make the switch from XAMPP/MAMP to OS X’s built-in Apache with Laravel, so let’s break down the most common fixes for the issues you’re facing—even without the full problem details, these steps cover 90% of the typical roadblocks.

1. Fix Directory Permissions First #

OS X’s Apache runs as the _www user, which often clashes with Laravel’s storage and cache directory permissions. These folders need write access for the app to work properly:

• First, check who owns your Laravel project folder with ls -la
• Run these commands to set the right permissions (replace /path/to/your/laravel/project with your actual project path):

  sudo chown -R _www:_www /path/to/your/laravel/project/storage
  sudo chown -R _www:_www /path/to/your/laravel/project/bootstrap/cache
  sudo chmod -R 775 /path/to/your/laravel/project/storage
  sudo chmod -R 775 /path/to/your/laravel/project/bootstrap/cache
  

• If you prefer a more flexible approach (so your user account still has access), use ACLs instead:

  sudo chmod -R g+w /path/to/your/laravel/project/storage
  sudo chmod -R g+w /path/to/your/laravel/project/bootstrap/cache
  

2. Configure a Proper Virtual Host for Laravel #

Running Laravel directly from localhost can cause routing issues. Setting up a virtual host fixes this:

1. Enable Apache’s virtual hosts config:
   • Open /etc/apache2/httpd.conf in your favorite text editor (you’ll need sudo for this)
   • Find the line #Include /private/etc/apache2/extra/httpd-vhosts.conf and remove the # to uncomment it
2. Add your Laravel virtual host:
   • Edit /etc/apache2/extra/httpd-vhosts.conf and paste this (update paths and server name to match your project):

     <VirtualHost *:80>
         DocumentRoot "/path/to/your/laravel/project/public"
         ServerName your-laravel-app.local
         <Directory "/path/to/your/laravel/project/public">
             AllowOverride All
             Require all granted
             Options Indexes FollowSymLinks
         </Directory>
         ErrorLog "/private/var/log/apache2/your-laravel-app-error_log"
         CustomLog "/private/var/log/apache2/your-laravel-app-access_log" common
     </VirtualHost>
     

3. Map the server name to your local machine:
   • Edit /etc/hosts and add this line: 127.0.0.1 your-laravel-app.local
4. Restart Apache to apply changes: sudo apachectl restart

3. Make Sure PHP Version is Compatible with Laravel #

OS X High Sierra ships with PHP 7.1 by default, but newer Laravel versions require higher PHP versions (e.g., Laravel 8+ needs PHP 7.3 or later):

• Check your current PHP version with php -v
• If your version is too old, install a compatible PHP version via Homebrew:

  brew install php@7.4 # Adjust version based on your Laravel requirements
  

• Then configure Apache to use this new PHP version:
  • Open /etc/apache2/httpd.conf again
  • Comment out the default PHP module line (looks like # LoadModule php7_module libexec/apache2/libphp7.so)
  • Add this line (replace 7.4 with your installed PHP version):

    LoadModule php7_module /usr/local/opt/php@7.4/lib/httpd/modules/libphp7.4.so
    

• Restart Apache: sudo apachectl restart

4. Verify Environment Setup and Composer #

A misconfigured .env file or missing Composer paths can break Laravel:

• Ensure Composer is in your system PATH:
  • Run composer -V—if it throws an error, add Composer to your profile:

    echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bash_profile
    source ~/.bash_profile
    

• Set up your Laravel environment file:
  • Copy the example file: cp .env.example .env
  • Generate a new app key: php artisan key:generate
  • Update APP_URL in .env to match your virtual host, e.g., APP_URL=http://your-laravel-app.local

5. Clear Laravel Cache to Fix Odd Behavior #

Sometimes cached config or routes can cause unexpected issues, even after fixing other settings. Run these commands to clear everything:

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

If you’re still hitting issues after trying these steps, feel free to share the specific error messages you’re seeing—I can help dig deeper!

内容的提问来源于stack exchange，提问作者Dan