PHPLIB-1208: Split example namespaces

[alcaeus]

PHPLIB-1208

The appstract/laravel-opcache package looks compiles all php files using opcache_compile_file. This creates some duplicate function declarations in our example files. Since we want to ship the examples for users' benefit, these files need to be excluded by another measure. Luckily, the package excludes files containing a shebang, so adding that and making the examples executable not only fixes the opcache issues, but also makes them a little easier to run.

The above solution does not work on all PHP versions, as our tests require the files and the addition of the shebang makes the declare and namespace declarations no longer the first statements in the file. To work around the conflicts observed when compiling for opcache, the examples now use separate namespaces.

[GromNaN]

If nothing else, it's not bad.

IMO, the laravel package should have used the autoload paths from the composer config of each package.

I submitted appstract/laravel-opcache#143 to exclude "examples" directory, that would benefit for all libraries that provide such examples.

[jmikola]

Are we going to have the same problem with the CSFLE examples? Or perhaps not because those don't define any functions?

[alcaeus]

Potentially, yes. In this particular case we won't, however I consider this an upstream issue, as blindly compiling every PHP file regardless of whether it's even available to be autoloader is an error. The PR @GromNaN created in the library excludes all files in examples folders from compilation, which fixes the issue for good. This is just a temporary workaround to resolve the immediate issue until it can be fixed upstream.