Plugin Commands

Complete plugin management system with dependency resolution, security scanning, health checks, and cron task support.

List Plugins

The pteroca:plugin:list command displays all registered plugins with their current state and detailed information.

• Command: pteroca:plugin:list

• Alias: plugin:list (deprecated, removed in v1.0.0)

Options

• --state, -s[=STATE]: Filter by state (enabled, disabled, faulted)

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:list

# Filter by enabled plugins
docker exec pteroca_web_dev php bin/console pteroca:plugin:list --state=enabled

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:list

Enable Plugin

The pteroca:plugin:enable command enables a plugin with optional dependency resolution and circular dependency detection.

• Command: pteroca:plugin:enable

• Alias: plugin:enable (deprecated, removed in v1.0.0)

Arguments

• plugin (required): Plugin name to enable

Options

• --with-dependencies, -d: Automatically enable required dependencies

• --force, -f: Force enable without dependency checks (DANGEROUS)

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:enable my-plugin

# Enable with dependencies
docker exec pteroca_web_dev php bin/console pteroca:plugin:enable my-plugin --with-dependencies

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:enable my-plugin

Features

• Dependency resolution with semantic versioning support

• Circular dependency detection

• Automatic dependency enabling with --with-dependencies flag

• Safety checks to prevent invalid plugin states

Disable Plugin

The pteroca:plugin:disable command disables a plugin with optional cascade disable of dependents.

• Command: pteroca:plugin:disable

• Alias: plugin:disable (deprecated, removed in v1.0.0)

Arguments

• plugin (required): Plugin name to disable

Options

• --cascade, -c: Also disable all plugins that depend on this plugin

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:disable my-plugin

# Disable with cascade (disable dependents too)
docker exec pteroca_web_dev php bin/console pteroca:plugin:disable my-plugin --cascade

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:disable my-plugin

Scan for Plugins

The pteroca:plugin:scan command scans the plugins directory for new or updated plugins and displays discovered plugin manifests.

• Command: pteroca:plugin:scan

• Alias: plugin:scan (deprecated, removed in v1.0.0)

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:scan

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:scan

What It Does

• Scans the plugins directory for valid plugin.json manifests

• Reports discovered plugins with version and status

• Identifies invalid manifests

• Does not automatically enable plugins

Show Plugin Dependencies

The pteroca:plugin:deps command analyzes and displays plugin dependencies, detects circular dependencies, and shows topological load order.

• Command: pteroca:plugin:deps

• Alias: plugin:deps (deprecated, removed in v1.0.0)

Arguments

• plugin (optional): Plugin name (shows all plugins if omitted)

Options

• --tree, -t: Show full dependency tree

• --dependents, -d: Show plugins that depend on this plugin

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:deps

# Show dependencies for specific plugin
docker exec pteroca_web_dev php bin/console pteroca:plugin:deps my-plugin

# Show full dependency tree
docker exec pteroca_web_dev php bin/console pteroca:plugin:deps my-plugin --tree

# Show dependents (reverse dependencies)
docker exec pteroca_web_dev php bin/console pteroca:plugin:deps my-plugin --dependents

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:deps my-plugin

Features

• Dependency tree visualization

• Circular dependency detection

• Topological load order display

• Reverse dependency tracking (what depends on this plugin)

Install Plugin Dependencies

The pteroca:plugin:install-deps command installs Composer dependencies for plugins with production flags.

• Command: pteroca:plugin:install-deps

• Alias: plugin:install-deps (deprecated, removed in v1.0.0)

Arguments

• plugin (optional): Plugin name to install dependencies for (omit for --all)

Options

• --all, -a: Install dependencies for all plugins with composer.json

• --clean, -c: Remove vendor/ directory before installation

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:install-deps my-plugin

# Install for all plugins
docker exec pteroca_web_dev php bin/console pteroca:plugin:install-deps --all

# Clean install
docker exec pteroca_web_dev php bin/console pteroca:plugin:install-deps my-plugin --clean

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:install-deps my-plugin

Composer Flags Used

• --no-dev: Production dependencies only

• --no-plugins: Disable Composer plugins

• --no-scripts: Don't run scripts

Validates

• composer.json file existence

• composer.json syntax

Publish Plugin Assets

The pteroca:plugin:assets:publish command publishes assets (CSS, JS, images) from plugin directories to the public folder.

• Command: pteroca:plugin:assets:publish

• Alias: plugin:assets:publish (deprecated, removed in v1.0.0)

Options

• --plugin, -p[=PLUGIN]: Publish assets for specific plugin (publishes all enabled plugins if omitted)

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:assets:publish

# Publish for specific plugin
docker exec pteroca_web_dev php bin/console pteroca:plugin:assets:publish --plugin=my-plugin

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:assets:publish

Rebuild Plugin Cache

The plugin:rebuild-cache command rebuilds the enabled plugins cache to ensure the system has the latest plugin state information.

• Command: plugin:rebuild-cache

Examples

docker exec pteroca_web_dev php bin/console plugin:rebuild-cache

When to Use

Use this command when:

• Plugins are not being detected after enabling/disabling

• Plugin state seems inconsistent

• After manually modifying plugin files

• After database changes affecting plugin records

• As part of troubleshooting plugin issues

What It Does

• Clears the current enabled plugins cache

• Rebuilds the cache from the database

• Updates the plugin registry with current state

• Ensures all enabled plugins are properly indexed

This command is automatically run when enabling or disabling plugins, but can be useful for troubleshooting or after manual changes.

Check Plugin Health

The pteroca:plugin:health:check command runs health checks on plugins and reports overall health percentage.

• Command: pteroca:plugin:health:check

• Alias: plugin:health:check (deprecated, removed in v1.0.0)

Arguments

• plugin-name (optional): Plugin name to check (checks all enabled plugins if omitted)

Options

• --all, -a: Check all plugins including disabled ones

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:health:check

# Check specific plugin
docker exec pteroca_web_dev php bin/console pteroca:plugin:health:check my-plugin

# Check all plugins including disabled
docker exec pteroca_web_dev php bin/console pteroca:plugin:health:check --all

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:health:check

Security Scan

The pteroca:plugin:security:scan command scans plugins for security vulnerabilities and reports findings by severity level.

• Command: pteroca:plugin:security:scan

• Alias: plugin:security:scan (deprecated, removed in v1.0.0)

Arguments

• plugin-name (optional): Plugin name to scan (scans all enabled plugins if omitted)

Options

• --severity, -s[=LEVEL]: Filter by severity level (critical, high, medium, low)

• --all, -a: Scan all plugins including disabled ones

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:security:scan

# Scan specific plugin
docker exec pteroca_web_dev php bin/console pteroca:plugin:security:scan my-plugin

# Filter by critical issues only
docker exec pteroca_web_dev php bin/console pteroca:plugin:security:scan --severity=critical

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:security:scan

Security Checks

What it scans for:

• Dangerous code patterns

• SQL injection risks

• Path traversal vulnerabilities

• Insecure file operations

• Command injection risks

List Cron Tasks

The pteroca:plugin:cron:list command displays all registered plugin cron tasks with status, schedule, and next run time.

• Command: pteroca:plugin:cron:list

• Alias: plugin:cron:list (deprecated, removed in v1.0.0)

Options

• --enabled-only: Show only enabled tasks

• --plugin, -p[=PLUGIN]: Filter by plugin name

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:list

# Show only enabled tasks
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:list --enabled-only

# Filter by plugin
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:list --plugin=my-plugin

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:cron:list

Run Cron Tasks

The pteroca:plugin:cron:run command executes due cron tasks or a specific task, with execution reporting.

• Command: pteroca:plugin:cron:run

• Alias: plugin:cron:run (deprecated, removed in v1.0.0)

Arguments

• task (optional): Specific task name to run (format: plugin-name:task-name)

Options

• --force, -f: Force run even if task is not due

• --dry-run: Show what would run without executing

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:run

# Run specific task
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:run my-plugin:cleanup

# Force run specific task
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:run my-plugin:cleanup --force

# Dry run to see what would execute
docker exec pteroca_web_dev php bin/console pteroca:plugin:cron:run --dry-run

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:cron:run

Reset Plugin

The pteroca:plugin:reset command resets a faulted plugin back to registered state to allow re-enabling after issues are fixed.

• Command: pteroca:plugin:reset

• Alias: plugin:reset (deprecated, removed in v1.0.0)

Arguments

• plugin (required): Plugin name to reset

Examples

# Recommended (v0.6+)
docker exec pteroca_web_dev php bin/console pteroca:plugin:reset my-plugin

# Deprecated (still works until v1.0.0)
docker exec pteroca_web_dev php bin/console plugin:reset my-plugin

Related Guides

• CLI Commands Overview - Command reference home

• Plugin Development - Create plugins

• Cron Scheduler - Automated plugin cron tasks