# PHP ar an líne ordaithe (CLI)

> PHP CLI mínithe: difríochtaí ón leagan gréasáin, roghanna -l, -m agus --ini, cronjobs, freastalaí gréasáin comhtháite agus cén fáth a dtugann php -v dallamullóg.

Foinse: https://phpsos.de/ga/php/php-cli/  
Staid: 25/10/2026  
Soláthraí: PHP SOS, Cabhair éigeandála PHP agus slándáil freastalaí. Cabhair láithreach trí WhatsApp: https://wa.me/491736494914?text=Dia%20duit%2C%20a%20PHP%20SOS%2C%20t%C3%A1%20cabhair%20de%20dh%C3%ADth%20orainn%20len%C3%A1r%20bhfreastala%C3%AD%20PHP.%20Cuideachta%3A%20%E2%80%A6%20Su%C3%ADomh%20gr%C3%A9as%C3%A1in%3A%20%E2%80%A6

**Go achomair:** Is é PHP CLI (Command Line Interface) an leagan de PHP don líne ordaithe. Ritheann sé scripteanna gan freastalaí gréasáin, mar shampla do chronjobs, Composer nó tascanna cothabhála. Tá réamhshocruithe dá chuid féin aige, php.ini dá chuid féin go minic agus uaireanta fiú leagan eile ná an suíomh gréasáin. Dá bhrí sin ní cruthúnas iontaofa é `php -v` go bhfuil an suíomh gréasáin paistithe tar éis PHP2Shell.

## Cad is PHP CLI ann?

Luann lámhleabhar PHP dhá phríomhréimse úsáide de PHP: scripteanna do shuíomhanna gréasáin agus scripteanna ar an líne ordaithe. Don dara ceann tá SAPI ar leith ann dar ainm `cli`. Níl freastalaí gréasáin ná brabhsálaí de dhíth air, ach an t-ateangaire PHP amháin. De réir an lámhleabhair, tá sé oiriúnach go háirithe do thascanna a ritheann go rialta trí Cron faoi Linux nó trí phleanálaí na dtascanna faoi Windows.

Samplaí tipiciúla i saol laethúil cuideachta: allmhairí san oíche sa siopa, seoladh nuachtlitreacha, taisceanna a ghlanadh, nuashonruithe trí Composer nó uirlisí líne ordaithe de chuid CMS ar nós WP-CLI nó consól Symfony. Faoi Windows is `php.exe` an comhad, agus `php-cgi.exe` an leagan CGI.

Murab ionann agus PHP-FPM, ní seirbhís é an CLI. Tosaíonn gach glao próiseas nua, léann sé an chumraíocht as an nua de réir an lámhleabhair agus críochnaíonn sé nuair a bhíonn an script réidh. Dá bhrí sin níl gá le hatosú tar éis nuashonraithe. Is eisceachtaí iad próisis fhada a thosaítear trí CLI, mar shampla oibrithe scuaine de chuid fráma-oibreacha nó deamhain faoi systemd nó Supervisor. Ritheann siad ar feadh laethanta leis an ateangaire a luchtaíodh uair amháin agus ní mór iad a atosú tar éis nuashonraithe PHP díreach mar a atosaítear oibrithe gréasáin.

Do bhainistíocht agus do cheannaireacht tionscadail ciallaíonn sé seo: ba cheart tascanna sa chúlra a bheith sa fhardal agus i ngach plean nuashonraithe freisin.

## Conas a bhfuil an CLI difriúil ón leagan gréasáin?

Forscríobhann an CLI roinnt socruithe go seasta de réir an lámhleabhair. Ní féidir iad a athrú trí php.ini, ach amháin le linn an ama rite le `ini_set()`:

| Treoir | Luach sa CLI | Cúis de réir an lámhleabhair |
|---|---|---|
| `html_errors` | as | cuireann clibeanna HTML isteach ar an teirminéal |
| `implicit_flush` | air | ba cheart go dtaispeánfaí aschuir láithreach |
| `max_execution_time` | 0 (gan teorainn) | ritheann scripteanna líne ordaithe go fada go minic |
| `register_argc_argv` | air | faigheann scripteanna `$argc` agus `$argv` i gcónaí |
| `output_buffering` | as | gaolta go docht, fanann feidhmeanna maolánaithe in úsáid |
| `max_input_time` | as | níl aon GET, POST ná uaslódálacha ag an CLI |

Difríocht eile: ní athraíonn an CLI go dtí eolaire an script. Má ghlaonn tú `php -f ordner/skript.php` ó `/tmp`, leanann tú ag obair in `/tmp`. Is foinse earráide choitianta iad cosáin choibhneasta i gcronjobs dá bhrí sin.

Script beag nár cheart a rith ach ar an líne ordaithe:

```php
<?php
if (PHP_SAPI !== 'cli') {
    http_response_code(403);
    exit('Nur für die Kommandozeile.');
}
$tage = (int) ($argv[1] ?? 30);
$grenze = time() - $tage * 86400;
$alt = 0;
foreach (glob(__DIR__ . '/cache/*.tmp') ?: [] as $datei) {
    if (filemtime($datei) < $grenze) { $alt++; }
}
fwrite(STDOUT, "Dateien älter als $tage Tage: $alt\n");
```

Cuireann an seiceáil ar `PHP_SAPI` cosc ar script cothabhála a spreagadh tríd an mbrabhsálaí, má tá sé san eolaire gréasáin de thaisme. Molann an lámhleabhar go sainráite an SAPI a sheiceáil ar an mbealach seo seachas brath ar `$argv` a bheith ann.

## Na roghanna is tábhachtaí de PHP CLI

Tagann na roghanna seo ón bhforbhreathnú roghanna de lámhleabhar PHP agus tá siad úsáideach go háirithe do riarthóirí:

1. **`php -v`** taispeánann sé uimhir leagain an CLI.
2. **`php --ini`** taispeánann sé cé na comhaid cumraíochta atá luchtaithe.
3. **`php -m`** liostaíonn sé na modúil tiomsaithe agus luchtaithe.
4. **`php -i`** glaonn sé `phpinfo()` agus aschuireann sé an toradh mar théacs.
5. **`php -l datei.php`** ní sheiceálann sé ach an chomhréir (lint). Ó PHP 8.3 do roinnt comhad ag an am céanna freisin.
6. **`php -r 'code'`** ritheann sé cód go díreach, gan `<?php`.
7. **`php -d name=wert`** leagann sé socrú INI síos don ghlao seo.
8. **`php -n`** déanann sé neamhaird iomlán ar php.ini.
9. **`php --ri name`** taispeánann sé cumraíocht eisínteachta.

```bash
php --ini
php -m | grep -i -E "opcache|sodium|pdo"
php --ri session | grep upload_progress
php -l src/Controller.php src/Model.php
```

## An freastalaí gréasáin comhtháite: le haghaidh forbartha amháin

Le `php -S localhost:8000` tosaíonn an CLI freastalaí gréasáin beag. Luann aschur samplach an lámhleabhair PHP 5.4.0 mar thúsphointe. Tá an lámhleabhar soiléir: tá an freastalaí le haghaidh forbartha, ní freastalaí gréasáin iomlán é, níor cheart é a rith i líonraí poiblí ná i dtáirgeadh. Má ritheann sé go buan ar fhreastalaí agus go bhfuil sé inrochtana ón taobh amuigh, is toradh é a chaithfidh tú a réiteach.

## CLI, Cron agus slándáil tar éis PHP2Shell

Luann na tuarascálacha aitheanta faoi PHP2Shell PHP-FPM, mod_php, php-cgi, FrankenPHP agus LiteSpeed mar mhodhanna oibriúcháin a ndéantar difear dóibh. Ní phróiseálann an CLI iarratais ón líonra. Fós féin, tá sé tábhachtach don tslándáil ar thrí bhealach:

- **Cruthúnas bréagach:** Taispeánann `php -v` leagan an CLI. Féadfaidh an suíomh gréasáin leagan eile a úsáid, agus ní athraíonn backports dáilte an uimhir a thaispeántar go minic. Conas an staid a chruthú i gceart, tá sé ag [Leagan PHP agus staid paistithe a sheiceáil](https://phpsos.de/ga/php2shell/php-version-pruefen/) agus san alt [Cén fáth a dtaispeánann php -v an uimhir chéanna](https://phpsos.de/ga/blog/php-v-zeigt-alte-nummer/).
- **Buanseasmhacht trí Cron:** Is maith le hionsaitheoirí tar éis briseadh isteach cronjobs a thosaíonn script PHP go rialta. Tugann [Cronjobs i bhfolach a aithint mar chúldoras](https://phpsos.de/ga/blog/cronjobs-als-hintertuer/) leideanna maidir leis an gcuardach.
- **An pacáiste céanna:** De ghnáth tagann an CLI ón bhfoinse phacáiste chéanna le PHP-FPM agus baineann sé leis an nuashonrú.

## Conas a chabhraíonn PHP SOS go praiticiúil?

- **Leaganacha a chur i gcomparáid:** Cuirimid staid CLI agus staid ghréasáin i gcomparáid agus cruthaímid cén leagan a sheachadann do shuíomh gréasáin i ndáiríre.
- **Cronjobs a sheiceáil:** Liostaímid gach tasc PHP pleanáilte de gach úsáideoir agus cuirimid i gcomhthéacs a bhfeidhmchláir iad.
- **Cothabháil a chosaint:** Bogaimid scripteanna cothabhála amach as an eolaire gréasáin agus leagaimid seiceálacha SAPI síos.
- **Cúram buan:** Sa [chonradh cothabhála slándála](https://phpsos.de/ga/leistungen/security-wartungsvertrag/) coinnímid CLI, SAPI gréasáin agus cronjobs cothrom le dáta le chéile.


## Ceisteanna coitianta

**An dtaispeánann php -v leagan mo shuímh gréasáin?**  
Ní gá. Taispeánann php -v leagan an leagain líne ordaithe. Féadfaidh an suíomh gréasáin rith trí leagan eile de PHP-FPM nó trí mhodúl Apache. Do shuíomh gréasáin is tábhachtach staid an SAPI gréasáin, a bhfaighidh tú amach tríd an tseirbhís nó trí chomhad seiceála sealadach.

**Cén fáth a ritheann scripteanna CLI gan teorainn ama?**  
De réir lámhleabhar PHP, socraíonn an CLI max_execution_time go seasta ar 0, is é sin gan teorainn, mar go ndéanann scripteanna ar an líne ordaithe tascanna fada go minic. Is féidir an t-am rite a theorannú tríd an script féin nó trí uirlisí ar nós timeout.

**An bhfuil cead agam an freastalaí gréasáin comhtháite php -S a úsáid i dtáirgeadh?**  
Níl. Déanann an lámhleabhar cur síos air mar chabhair le haghaidh forbartha, ní mar fhreastalaí gréasáin iomlán, agus comhairlíonn sé gan é a úsáid i líonraí poiblí ná i dtáirgeadh. Do chórais bheo, bíonn Apache, Nginx nó LiteSpeed le PHP-FPM os a chomhair.

**An bhfuil OPcache gníomhach ar an líne ordaithe?**  
Níl de réir réamhshocraithe. Tá opcache.enable_cli ar 0 de réir an lámhleabhair. I gcás scripteanna gearra, is beag an tairbhe a bhaineann leis an taisce ar aon nós, mar is próiseas nua é gach glao.

## Foinsí

- [Lámhleabhar PHP: PHP ar an líne ordaithe](https://www.php.net/manual/en/features.commandline.php)
- [Lámhleabhar PHP: Difríochtaí an SAPI CLI](https://www.php.net/manual/en/features.commandline.differences.php)
- [Lámhleabhar PHP: Roghanna CLI](https://www.php.net/manual/en/features.commandline.options.php)
- [Lámhleabhar PHP: Freastalaí gréasáin comhtháite](https://www.php.net/manual/en/features.commandline.webserver.php)