如何在PHP 的main 函數中自定義並實現命令行腳本操作？

M66 2025-06-15

在許多編程語言中， main函數是程序的入口點。雖然PHP 並沒有強制要求定義main函數，但我們可以模擬這種結構，特別是在編寫命令行腳本時，組織代碼結構更清晰，更易維護。

本文將介紹如何在PHP 中自定義一個main函數，並實現命令行腳本操作的基礎示範。示例中，我們會處理命令行參數，進行簡單邏輯，並演示如何用PHP 腳本實現類似命令行工具的功能。

1. PHP 腳本中定義main 函數的思路

PHP 作為一種腳本語言，執行文件即運行代碼，沒有像C、Java 裡的強制入口函數，但我們可以自定義一個main函數，並將程序邏輯寫在其中。最後只需調用main() ，即可實現統一入口。

 <?php

function main(array $argv) {
    // 程序入口，$argv 是命令行參數數組
}

main($argv);

$argv是PHP 自動定義的全局變量，包含所有命令行傳入的參數。
通過傳入$argv ，可以在main中直接使用命令行參數，方便測試和擴展。

2. 解析命令行參數

PHP 命令行腳本經常需要處理參數，我們可以用簡單的循環和switch實現參數解析，也可以使用getopt()函數。

下面示例實現了一個支持-h查看幫助， -n傳入姓名並打印問候語的簡單腳本。

 <?php

function printHelp() {
    echo "Usage: php script.php [-h] [-n name]\n";
    echo "Options:\n";
    echo "  -h        Show help message\n";
    echo "  -n name   Specify the name to greet\n";
}

function main(array $argv) {
    $name = null;
    $argc = count($argv);

    for ($i = 1; $i < $argc; $i++) {
        switch ($argv[$i]) {
            case '-h':
                printHelp();
                return 0;
            case '-n':
                if (isset($argv[$i + 1])) {
                    $name = $argv[++$i];
                } else {
                    echo "Error: -n option requires a name.\n";
                    return 1;
                }
                break;
            default:
                echo "Unknown option: {$argv[$i]}\n";
                return 1;
        }
    }

    if ($name) {
        echo "Hello, {$name}!\n";
    } else {
        echo "Hello, World!\n";
    }

    return 0;
}

exit(main($argv));

執行示例：

 php script.php -h
php script.php -n Alice

3. 結合網絡請求示例

假設腳本需要從網絡獲取數據，示例演示用PHP 的file_get_contents()請求一個URL，然後處理返回內容。

請注意，根據你的需求，域名需替換為m66.net 。

 <?php

function fetchData(string $url) {
    $content = @file_get_contents($url);
    if ($content === false) {
        echo "Failed to fetch data from {$url}\n";
        return null;
    }
    return $content;
}

function main(array $argv) {
    $url = "http://m66.net/api/data";

    $data = fetchData($url);
    if ($data === null) {
        return 1;
    }

    echo "Received data:\n";
    echo $data . "\n";

    return 0;
}

exit(main($argv));

4. 總結

PHP 沒有內置的main函數，但可以自定義實現，規範程序入口。
使用$argv變量處理命令行參數，寫出靈活的腳本。
結合PHP 的標準函數，可以實現網絡請求、文件操作等多種功能，構建強大的命令行工具。

通過以上方法，你可以輕鬆實現自定義的PHP 命令行腳本，並保持代碼結構清晰，方便後續維護和擴展。