phpman.config.php.example

<?php
// phpMan site configuration — copy to phpman.config.php and adjust.
// Created automatically by `make deploy` / `make release` if not present.
// Leave values empty/uncommented to use defaults in phpMan.php.

// --- PHPMAN_HOME ---
// Base directory for all phpMan local data (cache DB, logs, backups).
// Default: PHPMAN_HOME env var, then $HOME/.phpman
// Use ~/.phpman_test for staging to avoid sharing DB/logs/backups with production.
// define('PHPMAN_HOME', getenv('HOME') . '/.phpman');
// define('PHPMAN_HOME', getenv('HOME') . '/.phpman_test');
// Or override individual paths below:
// define('PHPMAN_CACHE_DIR', '/path/to/custom/cache');
// define('PHPMAN_LOG_DIR', '/path/to/custom/logs');
// define('PHPMAN_BACKUP_DIR', '/path/to/custom/backups');

// --- Base URL (v4.3.3) ---
// Public web URL of this phpMan instance. Used by CLI scripts (batch_enhance,
// build-index, enhance) to generate correct links when running offline.
// Default: PHPMAN_BASE_URL env var, then 'http://localhost:8080/phpMan.php'
// define('PHPMAN_BASE_URL', 'https://www.chedong.com/phpMan.php');

// --- LLM Enhancement (v4.0) ---
// define('LLM_API_KEY', '');
// define('LLM_API_URL', '');
// define('LLM_MODEL', '');
// define('LLM_MAX_TOKENS', 4096);
// define('PHPMAN_ENHANCE_MAX_CHARS', 32000);  // max chars for LLM-enhanced output

// --- Fallback LLM (v4.2.2) ---
// Optional: multiple fallback endpoints tried in order when primary fails
// with 5xx/429/timeout. Each entry must have url, key, model.
// Leave empty array or comment out to skip fallback entirely.
// define('LLM_FALLBACKS', [
//     [
//         'url'   => 'https://api.openai.com/v1/chat/completions',
//         'key'   => 'sk-xxx',
//         'model' => 'gpt-4o-mini',
//     ],
//     [
//         'url'   => 'https://api.anthropic.com/v1/messages',
//         'key'   => 'sk-yyy',
//         'model' => 'claude-haiku-4-5',
//     ],
// ]);

// --- MCP Authentication (#97) ---
// Set a secret key to require X-API-Key header on all MCP requests.
// Leave empty to allow unauthenticated access (default, for local/trusted networks).
// define('MCP_API_KEY', 'your-secret-key-here');

// --- Debug ---
// Set true for development/troubleshooting; false for production.
// define('PHPMAN_DEBUG', false);