The mainline purpose of this project is to build the PHP extension pdo_sqlrelay for various PHP versions and various operating systems, and to perform continuous integration and testing, utilizing the available containers already built and maintained by other teams, and the SQLRelay maintainers' prebuild binaries.
We do not intend on maintaining a fork of the pdo_sqlrelay.cpp source file, but only to mirror a suitable release or patch from the upstream maintainer, and to support an orchestration, using github actions, that ensure the usability of this extension in the latest versions of PHP and operating system releases, database releases, etc as prudent software lifecycle management practices indicate.
This project may not ever have releases or provide anything other than artifacts of testing.
| Directory | Filename | Provenance | Description |
|---|---|---|---|
| / | config.m4 | Wayfair | The input to the phpize command |
| / | * | Wayfair | README etc |
| /src | * | Firstworks | from SQLRelay src/api/phppdo |
| /tests | * | Wayfair | phpt files containing sql |
| /.github | * | Wayfair | Workflows and templates |
| /bin | * | Wayfair | Scripts to help build and test |
In a suitable PHP development environment, with prequisite software installed, the pdo_sqlrelay.so can be built by:
phpize --clean; phpize; ./configure; make clean; make;The make test will fail until the generated Makefile is edited to include the loading of the extension=pdo.so or until we figure out what to change in the config.m4 to get this to happen automatically. The github actions will have calls to sed to do this editing.
These all refer to prebuild binaries, e.g. RPM, APT, from customary sources.
- php-devel possibly from blog.remirepo.net or provided by your OS distro.
- rudiments-devel from firstworks.com/opensource
- sqlrelay-c++-devel as above.
- php-debuginfo (strongly suggested)
- sqlrelay-debuginfo (strongly suggested)
- gcc-c++, valgrind, gdb, strace, ltrace, binutils (obviously).
phpize --clean; phpize; ./configure; make clean; make;See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. For detailed contributing guidelines, please see CONTRIBUTING.md
Wayfair provided files distributed under the MIT License.
See LICENSE for more information. other files as indicated by the upstream sources.
Project Link: https://github.com/wayfair-incubator/pdo_sqlrelay_builder
This template was adapted from https://github.com/othneildrew/Best-README-Template.