文件列表:

.php_cs.php (195, 2023-09-01)
CODE_OF_CONDUCT.md (5226, 2023-09-01)
LICENSE (1073, 2023-09-01)
SECURITY.md (632, 2023-09-01)
composer.json (1752, 2023-09-01)
composer.lock (396064, 2023-09-01)
index.php (535, 2023-09-01)
manual-flow-starter.php (461, 2023-09-01)
phpunit.xml (1025, 2023-09-01)
psalm.xml (930, 2023-09-01)
rector.php (685, 2023-09-01)
rough sketch.txt (561, 2023-09-01)
src (0, 2023-09-01)
src\Adapters (0, 2023-09-01)
src\Adapters\Cache (0, 2023-09-01)
src\Adapters\Cache\InMemoryCache.php (1193, 2023-09-01)
src\Adapters\Cache\PredisAdapter.php (1834, 2023-09-01)
src\Adapters\Console (0, 2023-09-01)
src\Adapters\Console\SymfonyCli.php (420, 2023-09-01)
src\Adapters\Exception (0, 2023-09-01)
src\Adapters\Exception\Bugsnag.php (648, 2023-09-01)
src\Adapters\Image (0, 2023-09-01)
src\Adapters\Image\Optimizers (0, 2023-09-01)
src\Adapters\Image\Optimizers\ImagineClient.php (841, 2023-09-01)
src\Adapters\Image\Optimizers\NativeReducerClient.php (1893, 2023-09-01)
src\Adapters\Mailers (0, 2023-09-01)
... ...

Suphle Framework ========================== ## Introduction This is the dev-facing project intended for contribution to Suphle itself. Its complete documentation is live at [Suphle.com](https://suphle.com). High-level details about what Suphle's capabilities are and why it was built have been migrated [here](https://dev.to/mmayboy_/introducing-suphle-the-tale-of-a-modern-php-framework-54i9) and [here](https://nmeri.hashnode.dev/a-synopsis-of-the-suphle-framework). ## Testing Typically, from your system's web folder: ```bash composer create-project nmeri/suphle AwesomeProject cd AwesomeProject composer test -- "/path/to/AwesomeProject/tests" ``` The tests interact with the database, and would thus expect to find an active MySQL connection such as that gotten from running a WAMP equivalent. The server can be configured to use anything else, but for the purpose of this demo, we simply use MySQL. Each of the modules contain an `.env` with the following entries: ``` DATABASE_NAME = suphle DATABASE_USER = root DATABASE_PASS = DATABASE_HOST = localhost ``` The database name is not important. All the command needs is for the credentials to match your local MySQL server, for migrations to be run. When executed as is, the tests will leave behind seeded data. For the database to self-destruct after it's done executing, we have to supply the configuration schema. ```bash composer test -- "/path/to/AwesomeProject/tests" -c=/path/to/AwesomeProject/phpunit.xml ``` ### Parallel testing The commands shown earlier will execute the tests synchronously, which may not be the most optimized for your machine. Those using systems with multiple cores can take advantage of concurrent testing and instead execute tests in parallel. ```bash composer parallel-test -- "/path/to/AwesomeProject/tests" --processes=5 ``` Above, we're enforcing 5 processes; however, when left blank, the runner will determine the optimum number of processes to use based on amount of cores available. Hence, this would equally work: ```bash composer parallel-test -- "/path/to/AwesomeProject/tests" ``` As with using this runner in development, note that it swallows all PHPUnit output. Thus, if the test invocation fails before completion, you may require a synchronous run to understand what went wrong. ### Browser access All interaction with the Framework should be conducted through tests and by extension, the command line. Those unaccustomed to reading the source code/tests or running tests, or those who are impatient and would prefer seeing something on the browser, should fire up the Roadrunner server: ```bash php suphle_cli server:start Modules --insane --ignore_static_correct ``` Then, visit any of the routes available at: - http://localhost:8080/ - http://localhost:8080/segment - http://localhost:8080/module-three/{any_integer} They don't require any database connection and only demonstrate the relatively basic ability to route incoming requests to an attached action handler, taking higher-level constraints like modules and prefixing into account. If you're window shopping, a *sort of* example application resides in the `tests/Mocks` folder. Emphasis is laid on "sort of" since `ModuleOne` there, is for testing majority of the framework's feature set and doesn't necessarily reflect what you'd expect from a real life Suphle module. ## Contributing to the Starter project The [Starter project](https://github.com/nmeri17/suphle-starter) is the user-facing arm intended for bootstrapping fresh Suphle projects. If you have cause to contribute to it, it's much more convenient to install both side by side, such that over the course of development, your updates to this core project will reflect on your Starter installation. This project must be installed, first. ```bash composer create-project nmeri/suphle git clone https://github.com/nmeri17/suphle-starter.git ``` Afterwards, the Starter is to derive its parent project from your local installation. Navigate to the `composer.json` of the Starter project and add the following entry: ```json "repositories": [ { "type": "path", "url": "../suphle" } ], "minimum-stability": "dev" ``` Now, instruct Composer to interpret the local installation as parent, using the install command: ```bash cd suphle-starter composer install ``` Now, all is set! Checkout a new branch to implement your amazing feature. If you need to interact with the Roadrunner server as well, fetch its binary like so: ```bash cd vendor/bin rr get-binary ``` ## Where to start contributing The recommended place to render assistance is the existing issues with the [`help-wanted`](https://github.com/nmeri17/suphle/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label, which would facilitate us reaching our initial goals. As I do value your time, it's advisable for new additions outside that list to first be discussed on a new issue, and commissioned for implementation. Please see the Contribution guide for more details. ## Security [Security Policy](SECURITY.md)

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：