acc-docker-troubleshooting-knowledge
Docker Troubleshooting Knowledge Base
Quick reference for debugging Docker containers in PHP projects.
Common Build Errors
| Error | Cause | Solution |
|---|---|---|
failed to compute cache key |
File not in build context | Check .dockerignore, verify file path |
returned a non-zero code: 137 |
OOM during build | Increase Docker memory or reduce parallel ops |
Could not find package |
Composer can't resolve deps | Check composer.lock, mount auth secrets |
E: Unable to locate package |
Missing apt repository | Add required repo or use correct base image |
configure: error: ... not found |
Missing dev library | Install -dev package before ext install |
Permission denied |
Wrong user/permissions | Fix chown/chmod or adjust USER directive |
COPY failed: file not found |
File not in context | Check path relative to Dockerfile, check .dockerignore |
max depth exceeded |
Too many layers | Combine RUN commands, use multi-stage build |
Common Runtime Errors
More from dykyi-roman/awesome-claude-code
psr-overview-knowledge
PHP Standards Recommendations (PSR) overview knowledge base. Provides comprehensive reference for all accepted PSRs including PSR-1,3,4,6,7,11,12,13,14,15,16,17,18,20. Use for PSR selection decisions and compliance audits.
23detect-code-smells
Detects code smells in PHP codebases. Identifies God Class, Feature Envy, Data Clumps, Long Parameter List, Long Method, Primitive Obsession, Message Chains, Inappropriate Intimacy. Generates actionable reports with refactoring recommendations.
16clean-arch-knowledge
Clean Architecture knowledge base. Provides patterns, antipatterns, and PHP-specific guidelines for Clean Architecture and Hexagonal Architecture audits.
16bug-root-cause-finder
Root cause analysis methods for PHP bugs. Provides 5 Whys technique, fault tree analysis, git bisect guidance, and stack trace parsing.
15ddd-knowledge
DDD architecture knowledge base. Provides patterns, antipatterns, and PHP-specific guidelines for Domain-Driven Design audits.
15testing-knowledge
Testing knowledge base for PHP 8.4 projects. Provides testing pyramid, AAA pattern, naming conventions, isolation principles, DDD testing guidelines, and PHPUnit patterns.
13