Библиотека захвата пакетов PHP с потоковым управлением, использующая libpcap через FFI.
По возможности (или при использовании более старой версии PHP) вам следует использовать собственное PHP-расширение pcap. Эта библиотека предоставляется в качестве альтернативы для случаев выбора/границы. В остальном библиотека захвата пакетов на основе FFI полностью совместима с расширением pcap
. В результате здесь также отражаются все изменения, примененные к расширению, и версия библиотеки всегда будет соответствовать аналогу расширения.
Эта библиотека использует функции, представленные в PHP 7.4, она не будет работать с устаревшими версиями. Разумеется, расширение PHP FFI должно быть установлено и включено.
Библиотека libpcap должна быть установлена в целевой среде; некоторые дистрибутивы Linux вмешиваются в протоколы именования библиотек, и это может запутать процесс инициализации FFI. В этом случае можно установить для переменной среды LIBPCAP_NAME
фактическое имя библиотеки или даже абсолютный путь к файлу .so библиотеки для пользовательских сборок или нестандартных макетов каталогов.
Например, для Debian Buster можно установить для LIBPCAP_NAME
значение libpcap.so.1.8.1
.
Рекомендуемый способ установки этой библиотеки — через Composer. Впервые в Composer?
Это установит последнюю поддерживаемую версию:
composer require rtckit/pcap-ffi:^0.6.5
Перед запуском набора тестов убедитесь, что у пользователя есть возможность перехватывать сетевые пакеты (корневые или CAP_NET_RAW
).
make test
MIT, см. файл ЛИЦЕНЗИИ.
Отчеты об ошибках (и небольшие исправления) можно отправлять через систему отслеживания ошибок. Формирование репозитория и отправка запроса на извлечение предпочтительнее для существенных исправлений.