0.6.0-rc

Author: cdosoftei

.travis.yml

@@ -0,0 +1,20 @@
+language: php
+
+addons:
+  apt:
+    packages:
+      - libpcap-dev
+
+php:
+  - 7.4
+  - 8.0
+
+env:
+  - REPORT_EXIT_STATUS=1 NO_INTERACTION=1
+
+# Compile
+before_script:
+  - phpize && ./configure && make
+
+# Run PHPs run-tests.php
+script: TEST_PHP_ARGS="-q --show-out" make test

CREDITS

@@ -0,0 +1,2 @@
+pcap
+Ciprian Dosoftei

Dockerfile

@@ -0,0 +1,20 @@
+FROM php:7.4-cli-alpine
+
+RUN apk add $PHPIZE_DEPS && \
+  cd /usr/src && \
+  tar -xf php.tar.xz && \
+  cd php-* && \
+  apk add libpcap libpcap-dev
+
+COPY . /usr/src/php-pcap-ext
+
+WORKDIR /usr/src/php-pcap-ext
+
+RUN phpize && \
+  ./configure && \
+  make && \
+  (TEST_PHP_ARGS="-q --show-out" make test || exit 0) && \
+  make install && \
+  echo "extension=pcap.so" > /usr/local/etc/php/conf.d/pcap.ini
+
+CMD ["php", "-i"]

Makefile

@@ -0,0 +1,11 @@
+# This file is intended solely to facilitate development specific processes
+REPOSITORY=rtckit/php-pcap-ext-dev
+
+image:
+	docker build -t ${REPOSITORY} .
+
+local-image:
+	docker build -v `pwd`:/usr/src/php-pcap-ext:rw -t ${REPOSITORY} .
+
+run: image
+	docker run --rm -t ${REPOSITORY}

README.md

@@ -1,2 +1,43 @@
-# php-pcap-ext
-PHP packet capture extension
+# PHP Packet Capture
+
+Stream driven PHP packet capture extension.
+
+[![Build Status](https://travis-ci.org/rtckit/php-pcap-ext.svg?branch=master)](https://travis-ci.org/rtckit/php-pcap-ext) ![Version](https://img.shields.io/badge/version-v0.6.0-green) ![License](https://img.shields.io/badge/license-MIT-blue)
+
+## Usage
+
+The `pcap` extension has been developed against PHP 7.4+ and regularly tested against the upcoming PHP 8.
+
+The extension provides bindings for [libpcap](https://github.com/the-tcpdump-group/libpcap) and exposes its functionality via PHP streams; the packet formatting is consistent with the `pcap` file format (learn more [here](https://wiki.wireshark.org/Development/LibpcapFileFormat) and [here](https://formats.kaitai.io/pcap/index.html)).
+
+It's also worth familiarizing yourself with [libpcap and tcpdump](https://www.tcpdump.org/index.html).
+
+## Build
+
+In order to build the extension from source, make sure the environment supports the typical C/C++ build essentials for your platform (`build-essential`), the PHP development files (`php-dev`) as well as the libpcap library and its respective development files (`libpcap-dev`).
+
+```sh
+phpize
+./configure
+make
+```
+
+## Tests
+
+Before running the test suite, make sure the user has the ability to capture network packets (root or CAP_RAW).
+
+```sh
+make test
+```
+
+## License
+
+MIT, see [LICENSE file](LICENSE).
+
+### Acknowledgments
+
+* [libpcap](https://github.com/the-tcpdump-group/libpcap)
+
+### Contributing
+
+Bug reports (and small patches) can be submitted via the [issue tracker](https://github.com/rtckit/php-pcap-ext/issues). Forking the repository and submitting a Pull Request is preferred for substantial patches.

config.m4

@@ -0,0 +1,55 @@
+PHP_ARG_ENABLE([pcap],
+  [whether to enable pcap support],
+  [AS_HELP_STRING([--enable-pcap],
+    [Enable pcap support])],
+  [no])
+
+if test "$PHP_PCAP" != "no"; then
+  PHP_NEW_EXTENSION(pcap, pcap.c, $ext_shared)
+
+  AC_PATH_PROG(PKG_CONFIG, pkg-config, no)
+
+  AC_MSG_CHECKING(for libpcap)
+
+  if test $PHP_PCAP == "yes" && test -x "$PKG_CONFIG" && $PKG_CONFIG --exists libpcap; then
+    if $PKG_CONFIG libpcap --atleast-version 1.8.0; then
+      LIBPCAP_INCLINE=`$PKG_CONFIG libpcap --cflags`
+      LIBPCAP_LIBLINE=`$PKG_CONFIG libpcap --libs`
+      LIBPCAP_VERSION=`$PKG_CONFIG libpcap --modversion`
+      AC_MSG_RESULT(from pkgconfig: found version $LIBPCAP_VERSION)
+      AC_DEFINE(HAVE_PCAPLIB,1,[ ])
+    else
+      AC_MSG_ERROR(system libpcap must be upgraded to version >= 1.8.0)
+    fi
+    PHP_EVAL_LIBLINE($LIBPCAP_LIBLINE, PCAP_SHARED_LIBADD)
+    PHP_EVAL_INCLINE($LIBPCAP_INCLINE)
+
+  else
+    SEARCH_PATH="/usr/local /usr"
+    SEARCH_FOR="/include/pcap.h"
+    if test -r $PHP_PCAP/$SEARCH_FOR; then # path given as parameter
+      PCAP_DIR=$PHP_PCAP
+      AC_MSG_RESULT(from option: found in $PCAP_DIR)
+    else # search default path list
+      for i in $SEARCH_PATH ; do
+        if test -r $i/$SEARCH_FOR; then
+          PCAP_DIR=$i
+          AC_MSG_RESULT(from default path: found in $i)
+        fi
+      done
+    fi
+    PHP_ADD_INCLUDE($PCAP_DIR/include)
+    PHP_CHECK_LIBRARY(pcap, pcap_version,
+    [
+      PHP_ADD_LIBRARY_WITH_PATH(pcap, $PCAP_DIR/$PHP_LIBDIR, PCAP_SHARED_LIBADD)
+      AC_DEFINE(HAVE_PCAPLIB,1,[ ])
+    ],[
+      AC_MSG_ERROR([wrong pcap library version or library not found])
+    ],[
+      -L$PCAP_DIR/$PHP_LIBDIR -lm
+    ])
+  fi
+
+  PHP_SUBST([CFLAGS])
+    PHP_SUBST(PCAP_SHARED_LIBADD)
+fi