Biblioteca de captura de pacotes PHP orientada por fluxo, aproveitando libpcap via FFI.
Sempre que possível (ou se estiver usando uma versão mais antiga do PHP), você deve usar a extensão nativa pcap PHP, esta biblioteca é fornecida como uma alternativa para casos de seleção/limite. Caso contrário, a biblioteca de captura de pacotes baseada em FFI é totalmente compatível com a extensão pcap
. Como resultado, todas as alterações aplicadas à extensão também são refletidas aqui, e a versão da biblioteca sempre corresponderá à versão da extensão.
Esta biblioteca faz uso de recursos introduzidos a partir do PHP 7.4, não funcionará com versões obsoletas. Claro, a extensão PHP FFI deve estar instalada e habilitada.
A biblioteca libpcap deve estar instalada no ambiente de destino; algumas distribuições Linux interferem nos protocolos de nomenclatura da biblioteca e isso pode confundir o processo de inicialização do FFI. Se for esse o caso, pode-se definir a variável de ambiente LIBPCAP_NAME
para o nome real da biblioteca ou até mesmo o caminho absoluto para o arquivo .so da biblioteca para compilações personalizadas ou layouts de diretório não padrão.
Por exemplo, para o Debian Buster, seria definido LIBPCAP_NAME
como libpcap.so.1.8.1
.
A forma recomendada de instalar esta biblioteca é através do Composer. Novo no Compositor?
Isso instalará a versão mais recente suportada:
composer require rtckit/pcap-ffi:^0.6.5
Antes de executar o conjunto de testes, certifique-se de que o usuário tenha capacidade de capturar pacotes de rede (root ou CAP_NET_RAW
).
make test
MIT, consulte o arquivo LICENSE.
Relatórios de bugs (e pequenos patches) podem ser enviados por meio do rastreador de problemas. Bifurcar o repositório e enviar uma solicitação pull é preferível para patches substanciais.