# shell_exec

(PHP 4, PHP 5, PHP 7, PHP 8)

shell_exec — Ejecutar un comando mediante el intérprete de comandos y devolver la salida completa como una cadena

### Descripción

shell_exec(string `$cmd`): string

Esta función es idéntica al operador de comillas invertidas.

### Parámetros

`cmd`

  El comando que será ejecutado.

### Valores devueltos

La salida del comando ejecutado o `null` si ocurre un error o el comando no produce ninguna salida.

> Nota:

> Esta función puede devolver `null` cuando ocurre un error o cuando el programa no produce ninguna salida. No es posible detectar los fallos de ejecución usando esta función. exec() debería usarse cuando sea necesario el acceso al código de salida del programa.

### Ejemplos

Ejemplo #1 Un ejemplo de shell_exec()

`<?php
$salida = shell_exec('ls -lart');
echo "<pre>$salida</pre>";
?>`

### Ver también

- exec() - Ejecutar un programa externo
- escapeshellcmd() - Escapar meta-caracteres del intérprete de comandos