How craftcms/cms works
Craft is a self-hosted PHP CMS for managing modeled content and delivering custom digital experiences. The principal workflow is a user creating or administering content in the control panel, with elements queried and persisted in a relational database, then rendered through Twig or exposed through GraphQL. The graph also preserves asset handling, authentication, plugins, and console administration. README statements support the product capabilities; where sampled source does not establish internal wiring, relationships are omitted or marked unverified.
Main entry points: ElementsController.php Control Panel · Element.php Content Elements · Connection.php Database Connection · ElementQuery.php Element Queries
Components 28
User Experience
- Control Panel
src/controllers/ElementsController.php - Web Controller
src/web/Controller.php
Content Modeling
- Content Elements
src/base/Element.php - Element Contract
src/base/ElementInterface.php - User Elements
src/elements/User.php - Element Collections
src/elements/ElementCollection.php - Element Queries
src/elements/db/ElementQuery.php - Query Contract
src/elements/db/ElementQueryInterface.php - Field Layouts
src/models/FieldLayout.php
Data and Storage
- Database Queries
src/db/Query.php - Database Connection
src/db/Connection.php - Relational Database
Content Delivery
- Twig Templates
src/web/twig/variables/Routes.php - GraphQL API
src/gql/types/Query.php - HTTP Responses
src/web/Response.php - Asset Previews
src/base/AssetPreviewHandler.php
Platform Services
- Authentication
src/auth/methods/TOTP.php - Single Sign-On
src/auth/sso/BaseProvider.php - Plugin Framework
src/base/Plugin.php - Console Administration
src/console/Controller.php - Application Helpers
src/helpers/App.php - Array Utilities
src/helpers/ArrayHelper.php - Database Utilities
src/helpers/Db.php - Element Utilities
src/helpers/ElementHelper.php - File Utilities
src/helpers/FileHelper.php - String Utilities
src/helpers/StringHelper.php - URL Utilities
src/helpers/UrlHelper.php
Other components
- CMS User
Connections 22
- CMS User → Control Panel: administers content
- CMS User → Twig Templates: views experience
- Control Panel → Content Elements: manages content
src/base/Element.php - Content Elements → Element Contract: implements contract
- User Elements → Element Contract: implements contract
src/elements/User.php - Element Queries → Query Contract: implements contract
src/elements/db/ElementQuery.php - Element Queries → Database Queries: queries through
src/elements/db/ElementQuery.php - Database Queries → Database Connection: executes through
src/db/Query.php - Database Connection → Relational Database: connects to
- Content Elements → Element Collections: returns collections
src/base/Element.php - Field Layouts → Content Elements: models fields for
- Control Panel → Web Controller: handles requests
- Web Controller → HTTP Responses: sends responses
src/web/Controller.php - CMS User → GraphQL API: queries content
- GraphQL API → Element Queries: queries elements
- CMS User → Asset Previews: manages assets
- CMS User → Authentication: authenticates
- Authentication → Single Sign-On: supports providers
- Plugin Framework → Control Panel: extends capabilities
- CMS User → Console Administration: administers by CLI
- Application Helpers → Database Connection: configures database
src/helpers/App.php - Database Utilities → Database Connection: executes database operations
src/helpers/Db.php