Acquia Developer (D10) key terms
Acquia Developer (D10) · Get comfortable with the vocabulary.
- Render array
- Related: Cacheability metadata, Twig template, Hook
A structured PHP array that describes output to be rendered by Drupal's render system, using keys like #theme, #markup, and #cache. It is lazy, cacheable, and alterable before being converted to HTML.
- Cacheability metadata
- Related: Cache tag, Cache context, Dynamic Page Cache
The set of cache tags, cache contexts, and max-age values attached to render arrays and responses that tell Drupal how output varies and when it must be invalidated. Correct metadata is essential for safe caching.
- Cache tag
- Related: Cacheability metadata, Cache context
A string identifier attached to cached data that names the underlying content or configuration it depends on, such as node:5. When that dependency changes, Drupal invalidates every cache entry carrying the tag.
- Cache context
- Related: Cacheability metadata, Dynamic Page Cache
A declared variation axis, such as user.roles or url.query_args, that causes Drupal to store separate cached copies per value. Missing contexts leak personalized content; excess contexts fragment the cache.
- Dynamic Page Cache
- Related: Cacheability metadata, BigPipe, Reverse proxy
A core caching layer that stores fully assembled pages with placeholders for uncacheable parts, then substitutes those parts per request. It lets anonymous and authenticated pages be reused while keeping personalized fragments correct.
- BigPipe
- Related: Dynamic Page Cache, Render array
A core performance technique that sends a cached page shell first and streams placeholder replacements for uncacheable content later over the same response. Perceived load time improves because the main layout arrives immediately.
- Twig template
- Related: Theme hook suggestion, Render array, Preprocess function
A file using the Twig syntax that produces themed markup in Drupal's theme layer, with autoescaping and a restricted set of allowed functions, filters, and tags. Templates are discovered by naming convention and can be overridden per theme.
- Preprocess function
- Related: Twig template, Hook, Theme hook suggestion
A theme or module function named for a theme hook, such as mytheme_preprocess_node, that runs before a Twig template renders and adds or alters variables available to that template.
- Theme hook suggestion
- Related: Twig template, Preprocess function
An additional, more specific theme hook name offered as an alternative template, such as node__article or block__footer. Suggestions let themes target narrow cases without duplicating broad templates.
- Hook
- Related: Hook implementation registry, Event subscriber, Preprocess function
A named extension point, conventionally prefixed with the module name, that Drupal invokes so modules can react to or alter core behavior. Implementations are discovered by function naming or attributes and cached in the registry.
- Service container
- Related: Dependency injection, Plugin, Event subscriber
Drupal's dependency injection registry that maps service names to class definitions and instantiates them as shared objects. Services are declared in a module's services.yml file and requested through the container or injected into controllers and plugins.
- Dependency injection
- Related: Service container, Plugin
A design pattern where an object receives its collaborators from outside instead of constructing them, expressed in Drupal through create() methods and container injection. It improves testability and lets services be swapped.
- Plugin
- Related: Plugin manager, Service container, Annotation-based discovery
A swappable, annotated or attributed class managed by a plugin manager, used for blocks, field types, formatters, and many other extensible components. Plugins are discovered by scanning declared namespaces and configured per instance.
- Plugin manager
- Related: Plugin, Service container
The service responsible for discovering, instantiating, and caching plugin definitions for one plugin type. Developers usually obtain it from the container and call createInstance() with a specific plugin ID.
- Entity type
- Related: Bundle, Base field, Entity API
A definition of a kind of data object in Drupal, such as node or taxonomy_term, including its bundles, base fields, storage, and handlers. Entity types are declared in code and managed by the entity type manager.
- Bundle
- Related: Entity type, Field storage, Configuration entity
A named subtype of a content entity type, such as an Article content type under node, that carries its own fields and display settings. Bundles let one entity type serve multiple content models.
- Base field
- Related: Entity type, Field storage, Configurable field
A field defined in code as part of an entity type or bundle rather than through the UI, so it exists on every installation and cannot be deleted. Base fields are declared with a BaseFieldDefinition in the entity class.
- Configurable field
- Related: Base field, Bundle, Configuration management
A field created through the user interface or configuration import, stored as configuration and attached to a bundle. It can be exported, edited, and deleted without code changes.
- Configuration management
- Related: Configuration entity, Config split, Update hook
Drupal's system for exporting site configuration to YAML files and importing it into another environment. It supports reviewable, repeatable deployments of settings that are not content.
- Configuration entity
- Related: Configuration management, Bundle
An entity type whose instances are stored as configuration rather than content, such as views, roles, or content types. Config entities are exported with configuration management and are not fieldable in the usual content sense.
- Update hook
- Related: Configuration management, Deployment pipeline
A numbered function in a module's .install file, such as mymodule_update_9001, that runs once during database updates to migrate data or schema. Update hooks carry changes that configuration import cannot express.
- Deployment pipeline
- Related: Acquia Cloud Platform, Code Studio, Update hook
The ordered set of automated stages, typically build, test, artifact creation, and deploy, that moves code and configuration from a repository to an environment. Acquia pipelines run these stages from a Git branch.
- Acquia Cloud Platform
- Related: Deployment pipeline, Cloud IDE, Reverse proxy
Acquia's hosted Drupal environment offering per-environment infrastructure, Git-based code deployment, and tooling for databases, files, and logs. Environments are typically separated into development, staging, and production tiers.
- Acquia Code Studio
- Related: Deployment pipeline, Acquia Cloud Platform
Acquia's continuous integration and delivery service built on GitLab, providing automated testing, artifact builds, and deployment to Acquia environments. It is configured through a pipeline definition in the repository.
- Cloud IDE
- Related: Acquia Cloud Platform, Deployment pipeline
A browser-based development environment provided by Acquia that runs against a cloud application's branch, with the codebase and tooling preconfigured. It avoids local setup drift but is not a substitute for production configuration.
- Reverse proxy
- Related: Cacheability metadata, Dynamic Page Cache, Acquia Cloud Platform
An intermediary server, such as Acquia's Varnish layer, that caches HTTP responses in front of the Drupal application and serves repeated anonymous requests without invoking PHP. Correct cache headers determine what it can store.
- Access result
- Related: Cacheability metadata, Hook, CSRF token
An object returned by permission checks that records allowed, forbidden, or neutral plus cacheability metadata and the reason. Access results are combined across hooks so modules can grant or deny without overwriting each other.
- CSRF token
- Related: Access result, Form API
A per-session value embedded in state-changing forms and links so the server can verify the request originated from the site. Drupal generates and validates these tokens through its form and routing APIs.
- Form API
- Related: Render array, CSRF token
Drupal's structured system for building, validating, and processing forms as render arrays, with automatic token checking, submission handlers, and reusable element types. Forms are classes or functions returning an array with a form ID.
- Entity query
- Related: Entity type, Database abstraction layer
A programmatic query builder for finding entity IDs by field conditions, used instead of raw SQL so storage and access behavior stay consistent. Results are typically loaded afterward through the entity type manager.
- Database abstraction layer
- Related: Entity query, Hook
Drupal's wrapper over PDO that provides a query builder, tagged queries other modules can alter, and support for multiple database drivers. It discourages raw SQL and encourages parameterized conditions.
- Annotation-based discovery
- Related: Plugin, Plugin manager
The older Drupal mechanism where plugin classes carry docblock annotations read by the plugin manager to build definitions. Drupal 10.2 and later also support PHP attributes as the preferred alternative.
- Event subscriber
- Related: Service container, Hook
A service class registered in services.yml that listens for Symfony events, such as kernel request or response, and runs code when they fire. Subscribers replace several procedural hooks for request-lifecycle work.
- Hook implementation registry
- Related: Hook, Drush
A cached index of which modules implement which hooks, built by scanning code. It must be rebuilt after adding a hook implementation, which is why clearing caches is required during development.
- Drush
- Related: Update hook, Configuration management, Hook implementation registry
The command-line interface for Drupal used to clear caches, run database updates, import configuration, and generate boilerplate code. Acquia environments expose it for remote commands against a specific environment.
- Config split
- Related: Configuration management, Deployment pipeline
A contributed module pattern for keeping some configuration active only in certain environments, such as development modules or API keys. It complements configuration management by dividing config into environment-specific sets.
- Theme hook
- Related: Twig template, Theme hook suggestion, Preprocess function
A named rendering unit, such as item_list or table, that maps to a Twig template or theme function and accepts a defined set of variables. Modules declare theme hooks so other code can render consistent output.