Reproduce the problem
Record the URL, request method, input conditions, and steps that trigger the failure. Check whether the issue occurs in CLI, web requests, or both.
Check PHP syntax
php -l path/to/file.php
For a larger project, run linting across all PHP files as part of continuous integration or deployment.
Read the error log
Look for the first relevant fatal error or exception, including the file and line number. A later error may be only a consequence of the original failure.
Use error_log() for targeted diagnostics:
error_log('Article lookup failed for ID: ' . $articleId);
Avoid logging passwords, session tokens, authorization headers, or other sensitive data.
Inspect values safely
Use a debugger or temporary structured logging to inspect types and control flow. Remove temporary output before deployment; var_dump() can corrupt JSON responses or send private data to visitors.
Use a debugger when needed
Xdebug can provide step debugging, stack traces, and code coverage. Configure it carefully and avoid exposing debugger endpoints on public production servers.
Fix the cause, then add a regression test
After correcting the bug, add a test that would have caught it. This helps prevent the same failure from returning during future changes.