README

For all those things you.... probably shouldn't have been doing anyway.... but surely do! Supports PHP7.2-8.1! (function/method manipulation is recommended only for unit testing, but all other functionality works.)

Function/method manipulation crashes in PHP 7.4+ when opcache is enabled (e.g. opcache.enable_cli) (Issue #217)

Disabling opcache is the recommended workaround.
This has been tested with php 8.2.0beta1

Building and installing fnbind in unix

Building and installing fnbind in Windows

This extension's documentation is available at https://www.php.net/fnbind.

Compatibility: PHP7.2 to PHP 8.1

See fnbind-api.php for the implemented functionality and method signatures. New functionality was added to support usage with PHP7.

This adds the ability to set return types (including nullable return types) on added/redefined functions.
This adds the ability to set declare(strict_types=1) on added/redefined functions.

Class and function manipulation is recommended only for unit tests.

Manipulating user-defined (i.e. not builtin or part of extensions) functions and methods via fnbind_method_* and fnbind_function_* generally works, but is recommended only in unit tests (unlikely to crash, but will cause memory leaks)

The following contributions are welcome:

Fixes and documentation.

Implemented APIs for PHP7

NOTE: Most fnbind_*() functions have aliases of fnbind_*().

fnbind_function_*: Most tests are passing. There are some memory leaks when renaming internal functions.

FURTHER WORK

See https://github.com/fnbind/fnbind/issues

Contributing

See CONTRIBUTING.md for guidelines on issues and pull requests, as well as links to resources that are useful for php7 module and fnbind development.

UPSTREAM DOCUMENTATION

fnbind is derived https://github.com/https://github.com/zenovich/runkit/fnbind, but with most of the functionality stripped out apart from binding closure to a function name.

Features

It allows you to bind a Closure to be called as a function.

Example:

class Bar {
	function quux() {
		echo "Hello world!\n";
	}
}

$bar = new Bar(); $bar->quux(...);

fnbind_add_closure('foo', $bar->quux(...));

foo(); // Output is "Hello world!"

Because sometimes, dependency injection is overkill, but you still want to be able to configure how a function behaves.

Installation

BUILDING AND INSTALLING FNBIND IN UNIX

pecl install fnbind can be used to install fnbind releases published on PECL.

Tarballs can be downloaded from PECL or GitHub.

An example of how to build the latest master branch from source is below:

git clone https://github.com/fnbind/fnbind.git
cd fnbind
phpize
# The sandbox related code and flags have been removed, no need to disable them.
# (--enable-fnbind-modify (on by default) controls function, method, class, manipulation, and will control property manipulation)
# (--enable-fnbind-super (on by default) allows you to add custom superglobals)
# ./configure --help lists available configuration options.
./configure
make
make test
sudo make install

BUILDING AND INSTALLING FNBIND IN WINDOWS

Setting up php build environment

Read https://wiki.php.net/internals/windows/stepbystepbuild_sdk_2 and https://wiki.php.net/internals/windows/stepbystepbuild_sdk_2#building_pecl_extensions first. This is just a special case of these instructions.

For PHP7.2+, you need to install "Visual Studio 2017 Community Edition" (or other 2017 edition). For PHP8.0+, you need to install "Visual Studio 2019 Community Edition" (or other 2019 edition). Make sure that C++ is installed with Visual Studio. The command prompt to use is "VS2017 x86 Native Tools Command Prompt" on 32-bit, "VS2017 x64 Native Tools Command Prompt" on 64-bit.

Note that different visual studio versions are needed for different PHP versions. For PHP 8.0+, use Visual Studio 2019 and vs16 instead.

For 64-bit installations of php7, use "x64" instead of "x86" for the below commands/folders.

After completing setup steps mentioned, including for C:\php-sdk\phpdev\vc14

extract download of php-7.4.11-src (or any version of php 7) to C:\php-sdk\phpdev\vc15\x86\php-7.4.11-src

Installing fnbind on windows

There are currently no sources providing DLLs of this fork. Runkit7 and other extensions used must be built from source.

Create subdirectory C:\php-sdk\phpdev\vc14\x86\pecl, adjacent to php source directory)

extract download of fnbind to C:\php-sdk\phpdev\vc14\x86\pecl\fnbind (all of the c files and h files should be within fnbind)

Then, execute the following (Add --enable-fnbind to the configure flags you were already using)

cd C:\php-sdk
C:\php-sdk\bin\phpsdk_setvars.bat
cd phpdev\vc15\x86\php-7.4.11\src
buildconf
configure --enable-fnbind
nmake

Then, optionally test it (Most of the tests should pass, be skipped, or be known failures.):

nmake test TESTS="C:\php-sdk\vc14\x86\pecl\fnbind\tests

danack / fnbind

Maintainers

Details