Troubleshooting

Common issues and solutions for WPZylos CLI Devtool.

Installation Issues

Command not found

Problem: vendor/bin/wpzylos: command not found

Cause: Package not installed or PATH not configured.

Fix:

# Verify installation
composer show KYNetCode/wpzylos-cli-devtool

# If not installed
composer require --dev KYNetCode/wpzylos-cli-devtool

# For Windows, use full path
vendor\bin\wpzylos

Autoloader not found

Problem: Autoloader not found. Run: composer install

Cause: Dependencies not installed.

Fix:

composer install

Command Issues

File already exists

Problem: Error: File already exists: app/Http/Controllers/ProductController.php

Cause: You're trying to create a file that already exists.

Fix: Delete the existing file first, or use a different name.

Invalid class name

Problem: Error: Invalid controller name

Cause: Name contains invalid characters.

Fix: Use valid PHP class name characters:

# Good: Valid
vendor/bin/wpzylos make:controller ProductController
vendor/bin/wpzylos make:controller Product_Controller

# Bad: Invalid
vendor/bin/wpzylos make:controller Product-Controller  # hyphens
vendor/bin/wpzylos make:controller 123Controller       # starts with number

Wrong output directory

Problem: Files generated in wrong location.

Cause: Running command from wrong directory.

Fix: Run commands from your plugin root:

cd /path/to/my-plugin
vendor/bin/wpzylos make:controller ProductController

Migration Issues

Timestamp conflict

Problem: Migration file with same timestamp exists.

Cause: Multiple migrations created in same second.

Fix: Wait a second between migrations, or rename manually.

Table name issues

Problem: Generated migration has wrong table name.

Cause: Using --create or --table incorrectly.

Fix:

# Create new table
vendor/bin/wpzylos make:migration create_products_table --create=products

# Modify existing table
vendor/bin/wpzylos make:migration add_sku_to_products --table=products

Windows-Specific Issues

Permission denied

Problem: Cannot create files or directories.

Cause: Windows file permissions.

Fix: Run terminal as Administrator or check folder permissions.

Path separator issues

Problem: Paths displayed with wrong separators.

Cause: Windows uses backslashes.

Fix: This is cosmetic only; files are created correctly.

Getting Help

# Get help for any command
vendor/bin/wpzylos make:controller --help
vendor/bin/wpzylos make:migration --help

# List all commands
vendor/bin/wpzylos list
Previous page
Security Notes
Next page
WPZylos Config