CakePHP 2.9项目本地部署出现Internal 500 Server Error求助

Let’s work through the most common fixes for that frustrating 500 error you’re hitting with your government hospital ERP setup. I’ve debugged tons of CakePHP 2.x deployments, so here’s what to check step by step:

1. Fix Folder Permissions First #

CakePHP needs write access to the tmp and logs folders to store cache and error logs—this is the #1 culprit for 500 errors out of the box. Run these commands from your terminal:

# Set correct write permissions
chmod -R 775 /var/www/html/esic/tmp
chmod -R 775 /var/www/html/esic/logs

# Make sure Apache owns these folders (adjust user/group if your server uses something else like apache:apache)
chown -R www-data:www-data /var/www/html/esic/tmp /var/www/html/esic/logs

2. Enable Debug Mode for Detailed Errors #

Stop guessing—let CakePHP tell you exactly what’s wrong. Open /var/www/html/esic/app/Config/core.php and find this line:

Configure::write('debug', 0);

Change it to:

Configure::write('debug', 2);

Now refresh localhost/esic/—you’ll get a detailed error message instead of the generic 500 error, which will point you straight to the problem (like a missing PHP extension or bad database credentials).

3. Check Apache’s Error Logs #

If debug mode doesn’t give you enough info, Apache’s error log will have the full story. Run this command to tail the log in real time:

tail -f /var/log/apache2/error.log

Then refresh your browser. You’ll see lines like PHP Fatal error: Call to undefined function mb_strlen() or Access denied for user 'root'@'localhost'—these are your clues.

4. Verify Database Connection #

Even if you edited database.php, typos happen. Create a quick test script to confirm your database credentials work:
Create a file called test_db.php in /var/www/html/esic/ with this code:

<?php
$db = new mysqli('localhost', 'YOUR_DB_USER', 'YOUR_DB_PASSWORD', 'esic');
if ($db->connect_error) {
    die("Connection failed: " . $db->connect_error);
}
echo "Database connected successfully!";
$db->close();
?>

Replace the placeholders with your actual credentials, then visit localhost/esic/test_db.php. If it fails, fix your database.php settings.

5. Confirm PHP Version & Required Extensions #

CakePHP 2.9 only works with PHP 5.4.16 to 7.2.x. Check your PHP version first:

php -v

Then make sure these critical extensions are installed:

• mbstring
• intl
• pdo_mysql

List installed extensions with:

php -m

If any are missing, install them (example for Ubuntu/Debian):

sudo apt-get install php-mbstring php-intl php-mysql

Restart Apache after installing:

sudo systemctl restart apache2

6. Check .htaccess Files & mod_rewrite #

CakePHP relies on mod_rewrite and proper .htaccess files to route requests. First, enable mod_rewrite if it’s not already:

sudo a2enmod rewrite
sudo systemctl restart apache2

Then make sure these three .htaccess files exist and have the correct content:

Root directory (/var/www/html/esic/.htaccess) #

<IfModule mod_rewrite.c>
   RewriteEngine on
   RewriteRule    ^$ app/webroot/    [L]
   RewriteRule    (.*) app/webroot/$1 [L]
</IfModule>

App directory (/var/www/html/esic/app/.htaccess) #

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteRule    ^$    webroot/    [L]
    RewriteRule    (.*) webroot/$1    [L]
</IfModule>

Webroot directory (/var/www/html/esic/app/webroot/.htaccess) #

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]
</IfModule>

If any are missing, grab them from the official CakePHP 2.9 release package.

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