Get defined functions: примеры (PHP)

<?php
// Объявим пользовательскую функцию для наглядности
function customHelper() {}

$allFunctions = get_defined_functions();
echo "Встроенных функций: " . count($allFunctions['internal']) . "\n";
echo "Пользовательских функций: " . count($allFunctions['user']) . "\n";

// Вывод первых 5 встроенных функций
print_r(array_slice($allFunctions['internal'], 0, 5));
?>

Встроенных функций: 1592
Пользовательских функций: 1
Array
(
    [0] => zend_version
    [1] => func_num_args
    [2] => func_get_arg
    [3] => func_get_args
    [4] => strlen
)

<?php
// Предположим, что функция shell_exec отключена в php.ini
// disable_functions = shell_exec

$excluded = get_defined_functions(true);
$included = get_defined_functions(false);

$diff = array_diff($included['internal'], $excluded['internal']);
echo "Функции, исключаемые при exclude_disabled=true:\n";
print_r($diff);
?>

Функции, исключаемые при exclude_disabled=true:
Array
(
    [0] => shell_exec
)

Для анализа среды выполнения и метапрограммирования в PHP существуют и другие функции.

Проверяет существование конкретной функции. Более эффективна для точечной проверки, так как не требует построения полного списка.

if (function_exists('array_filter')) {
    echo 'Функция доступна';
}

Возвращает все определенные переменные в текущей области видимости. Похожа по концепции, но работает с переменными.

Возвращает массив с именами объявленных классов. Аналог для объектно-ориентированной структуры.

Функцию get_defined_functions предпочтительнее использовать, когда необходим полный перечень функций для анализа, генерации документации или создания динамических маршрутов. Для единичных проверок лучше подходят function_exists или is_callable.

Ожидание, что функция вернет простой список, а не многомерный массив.

<?php
$funcs = get_defined_functions();
// Ошибка: попытка применить count() напрямую
$count = count($funcs); // Вернет 2 (ключи 'internal' и 'user')
?>

Получение имени из списка не гарантирует, что функция может быть безопасно вызвана в текущем контексте.

<?php
$funcs = get_defined_functions();
$randomFunc = $funcs['internal'][array_rand($funcs['internal'])];
// Опасный вызов без проверки
// $randomFunc(); // Может привести к неожиданным последствиям
?>

При установке параметра $exclude_disabled в false в список могут попасть функции, вызов которых приведет к фатальной ошибке.

<?php
$funcs = get_defined_functions(false);
if (in_array('shell_exec', $funcs['internal'])) {
    // shell_exec может быть отключена, вызов вызовет ошибку
    // shell_exec('ls');
}
?>

В PHP 7.0.1 был добавлен параметр $exclude_disabled. До этой версии функция не принимала аргументов, а отключенные встроенные функции всегда исключались из результата.

Начиная с PHP 8.0, функция возвращает массив, где ключи internal и user гарантированно присутствуют, даже если соответствующие списки пусты. В более ранних версиях поведение могло отличаться.

В PHP 8.1 и 8.2 значительных изменений в работе функции не произошло, но продолжается рост количества встроенных функций, поэтому размер возвращаемого массива увеличивается с каждым релизом.

<?php
function calculateTotal() {}
function validateEmail() {}
function sendNotification() {}

$defined = get_defined_functions();
// Поиск пользовательских функций, содержащих 'validate'
$validateFuncs = array_filter($defined['user'], 
    fn($name) => stripos($name, 'validate') !== false);
print_r($validateFuncs);
?>

Array
(
    [1] => validateEmail
)

<?php
$before = get_defined_functions()['internal'];
// Предполагаем, что расширение будет загружено динамически
// dl('some_extension.so'); // Загрузка расширения (недоступно в CLI)
$after = get_defined_functions()['internal'];
$newFuncs = array_diff($after, $before);
echo "Новые функции после загрузки расширения:\n";
print_r($newFuncs);
?>

<?php
$functions = get_defined_functions();
$internal = $functions['internal'];
$grouped = [];
foreach ($internal as $func) {
    $prefix = explode('_', $func)[0];
    $grouped[$prefix][] = $func;
}
// Вывод групп с количеством функций
foreach ($grouped as $prefix => $list) {
    if (count($list) > 5) {
        echo "$prefix: " . count($list) . " функций\n";
    }
}
?>

array: 83 функций
str: 32 функций
file: 28 функций
stream: 27 функций
... (вывод сокращен)

<?php
function array_filter() { // Опасное переопределение
    echo 'Пользовательская версия';
}

$defined = get_defined_functions();
$conflicts = array_intersect($defined['user'], $defined['internal']);
if ($conflicts) {
    echo "Конфликт имен: " . implode(', ', $conflicts);
}
?>

Конфликт имен: array_filter

Get defined functions в Python

В Python нет прямой аналогии, но можно использовать модуль dir() для инспекции объектов и пространств имен или globals() для получения словаря текущих глобальных символов.

import builtins
# Получение встроенных функций
builtin_funcs = [name for name in dir(builtins) 
                 if callable(getattr(builtins, name))]
print(builtin_funcs[:5])

['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException', 'BlockingIOError']

В глобальной области видимости браузера или Node.js можно получить список глобальных объектов, но строгого разделения на встроенные и пользовательские функции нет.

// Получение глобальных свойств в Node.js
const globalProps = Object.getOwnPropertyNames(global);
const functions = globalProps.filter(prop => 
    typeof global[prop] === 'function');
console.log(functions.slice(0, 5));

[ 'Object', 'Function', 'Array', 'Number', 'parseFloat' ]

Get defined functions в MySQL

В SQL подобная функциональность отсутствует, так как язык не является императивным. Однако можно запрашивать информацию о доступных хранимых процедурах через системные таблицы, например INFORMATION_SCHEMA.ROUTINES.