├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE.md
├── README.md
├── composer.json
└── src
    ├── Container
        ├── Attributes
        │   └── Config.php
        ├── BoundMethod.php
        ├── Container.php
        ├── ContextualBindingBuilder.php
        ├── EntryNotFoundException.php
        └── RewindableGenerator.php
    ├── Contracts
        ├── Container
        │   ├── BindingResolutionException.php
        │   ├── CircularDependencyException.php
        │   ├── Container.php
        │   ├── ContextualAttribute.php
        │   └── ContextualBindingBuilder.php
        └── Core
        │   ├── Application.php
        │   ├── CachesConfiguration.php
        │   └── DeferrableProvider.php
    ├── Core
        ├── AliasLoader.php
        ├── Application.php
        ├── Bootstrap
        │   ├── BootProviders.php
        │   ├── GenerateStorageStructures.php
        │   ├── HandleExceptions.php
        │   ├── LoadConfiguration.php
        │   ├── LoadEnvironmentVariables.php
        │   ├── RegisterFacades.php
        │   └── RegisterProviders.php
        ├── Configuration
        │   ├── ApplicationBuilder.php
        │   └── Exceptions.php
        ├── DefaultProviders.php
        ├── EnvironmentDetector.php
        ├── Facades
        │   ├── App.php
        │   └── Facade.php
        ├── Mix.php
        ├── MixManifestNotFoundException.php
        ├── PackageManifest.php
        ├── ProviderRepository.php
        ├── Providers
        │   ├── AggregateServiceProvider.php
        │   └── CoreServiceProvider.php
        └── ServiceProvider.php
    ├── Util.php
    └── functions-helpers.php


/CHANGELOG.md:
--------------------------------------------------------------------------------
  1 | # Change Log
  2 | 
  3 | You can see the changes made via the [commit log](https://github.com/themehybrid/hybrid-core/commits/master) for the latest release.
  4 | 
  5 | ## [7.0.4] - 2024-08-01
  6 | 
  7 | ### Changed
  8 | 
  9 | - sync with https://github.com/illuminate/support/releases/tag/v11.18.1
 10 | - sync with https://github.com/illuminate/contracts/releases/tag/v11.18.1
 11 | - sync with https://github.com/illuminate/container/releases/tag/v11.18.1
 12 | - sync with https://github.com/laravel/framework/releases/tag/v11.18.1
 13 | - Add composer sort-packages configuration
 14 | - Update copyright date
 15 | 
 16 | ## [7.0.3] - 2024-06-11
 17 | 
 18 | ### Changed
 19 | 
 20 | - add check for .env file existence to prevent warning
 21 | 
 22 | ## [7.0.2] - 2024-03-23
 23 | 
 24 | ### Changed
 25 | 
 26 | - composer.json
 27 |   - Add "symfony/console": "^5.0 || ^6.0" to require
 28 | - src\Core\DefaultProviders.php
 29 |   - Add missing import statement
 30 | 
 31 | ## [7.0.1] - 2023-11-06
 32 | 
 33 | ### Changed
 34 | 
 35 | - sync with https://github.com/illuminate/contracts/releases/tag/v10.25.1
 36 | - sync with https://github.com/illuminate/container/releases/tag/v10.25.2
 37 | - sync with https://github.com/laravel/framework/releases/tag/v10.25.2
 38 | - add missing use import for `Hybrid\Tools\with` helper function
 39 | - sync with https://github.com/illuminate/container/commit/78cbe88cdc7300efd4cf90244abec2e3c42219bb
 40 |   - downgrade to PHP 8.0 using DowngradeFirstClassCallableSyntaxRector (https://wiki.php.net/rfc/first_class_callable_syntax)
 41 |   - https://github.com/laravel/framework/pull/46611#issuecomment-1495263975
 42 | - for prefixed support, enable configuration changes for resources and public paths.
 43 | - to prevent conflicts with other global constants, prefix constants with `HYBRID_CORE_` instead of `APP_`.
 44 | - make the generation of directory structures dynamic to ensure it respects custom paths.
 45 | 
 46 | ## [7.0.0] - 2023-08-23
 47 | 
 48 | ## [7.0.0-beta.1] - 2023-08-05
 49 | 
 50 | ### Changed
 51 | 
 52 | - lint php files & cleanup
 53 | - update copyright date & author
 54 | - downgrade php req from 8.1 to 8.0+
 55 | - replace http to https
 56 | 
 57 | ## [7.0.0-alpha.3] - 2023-06-07
 58 | 
 59 | ### Changed
 60 | 
 61 | - Bumped `hybrid-filesystem, hybrid-events, hybrid-contracts & hybrid-tools`
 62 | 
 63 | ## [7.0.0.alpha.2] - 2023-02-20
 64 | 
 65 | ### Added
 66 | 
 67 | - `Core\AliasLoader`
 68 | - `Core\Bootstrap\BootProviders`
 69 | - `Core\Bootstrap\GenerateStorageStructures`
 70 | - `Core\Bootstrap\LoadConfiguration`
 71 | - `Core\Bootstrap\LoadEnvironmentVariables`
 72 | - `Core\Bootstrap\RegisterFacades`
 73 | - `Core\Bootstrap\RegisterProviders`
 74 | - `Core\EnvironmentDetector`
 75 | - `Core\EnvironmentDetector`
 76 | - `Core\Mix`
 77 | - `Core\PackageManifest`
 78 | - `Core\ProviderRepository`
 79 | 
 80 | ### Changed
 81 | 
 82 | - Proxies are replaced with Facade's
 83 | 
 84 | ## [6.0.0] - 2021-08-01
 85 | 
 86 | ### Changed
 87 | 
 88 | - Version 6.0.0 represents a complete overhaul of the framework. It is essentially stripped down to the Application and Container layers.  Other modules now exist as separate repositories.
 89 | 
 90 | ### Removed
 91 | 
 92 | - `Hybrid\Attr` moved to [Hybrid Attr](https://github.com/themehybrid/hybrid-attr).
 93 | - `Hybrid\Lang` moved to [Hybrid Lang](https://github.com/themehybrid/hybrid-lang).
 94 | - `Hybrid\Media` split to:
 95 | 	- [Hybrid Media Grabber](https://github.com/themehybrid/hybrid-media-grabber).
 96 | 	- [Hybrid Media Meta](https://github.com/themehybrid/hybrid-media-meta)
 97 | - `Hybrid\Pagination` moved to [Hybrid Pagination](https://github.com/themehybrid/hybrid-pagination).
 98 | - `Hybrid\Template` split to:
 99 | 	- [Hybrid Template](https://github.com/themehybrid/hybrid-template).
100 | 	- [Hybrid Template Hierarchy](https://github.com/themehybrid/hybrid-template-hierarchy).
101 | 	- [Hybrid Template Manager](https://github.com/themehybrid/hybrid-template-manager).
102 | - `Hybrid\Tools` moved to [Hybrid Tools](https://github.com/themehybrid/hybrid-tools).
103 | - `Hybrid\View` moved to [Hybrid View](https://github.com/themehybrid/hybrid-view)
104 | - `Hybrid\Comment`, `Hybrid\Menu`, `Hybrid\Post`, `Hybrid\Sidebar`, `Hybrid\Site`, `Hybrid\Theme`, and `Hybrid\Util` moved to [Hybrid Theme](https://github.com/themehybrid/hybrid-theme).
105 | 
106 | ## [5.2.0] - 2019-09-03
107 | 
108 | ### Added
109 | 
110 | - New `Hybrid\Attr\Attr\with()` method for passing data into the attributes system.
111 | - Above `with()` method will auto-handle a `'post'` parameter of `WP_Post` for post attributes.
112 | - New `Hybrid\Comment\render_author_link()` and `display_author_link()` function.
113 | 
114 | ### Changed
115 | 
116 | - `.sticky` class renamed to `.is-sticky`.
117 | 
118 | ## [5.1.0] - 2019-07-16
119 | 
120 | ### Added
121 | 
122 | - New `Hybrid\View\Engine` wrapper class for the view system, which gets passed to view templates as the `$engine` variable.
123 | - The `View` instances gets passed to view templates as the `$view` variable.
124 | 
125 | ## [5.0.3] - 2019-06-16
126 | 
127 | ### Changed
128 | 
129 | - The `Template` class should not have a defined `$subtype` by default. Any templates registered should work with all subtypes (post types in most cases) unless otherwise specified.
130 | 
131 | ## [5.0.2] - 2019-04-04
132 | 
133 | ### Added
134 | 
135 | - New `link` argument to enable/disable the link for `Hybrid\Post\render_author()`.
136 | 
137 | ### Fixed
138 | 
139 | - Corrected misspelling of `archive` in the `hybrid/archive/title` hook.
140 | - Use `get_comments_number_text()` instead of `get_comments_number()` to get appropriate comments text.
141 | - Added the missing `.wp-embed-responsive` body class if supported.
142 | - Make sure to show `$before` and `$after` args for the comment reply link if there's a link.
143 | 
144 | ## [5.0.1] - 2018-12-11
145 | 
146 | ### Fixed
147 | 
148 | - Corrected inline doc `@return` value for `Hybrid\View\View::locate()`.
149 | - Runs the template hierarchy through `array_unique()` to avoid duplicates when other plugins hook into core WP's template hierarchy.
150 | - Adds missing `datetime` attributes to `<time>` elements.
151 | - Correctly show `.menu__item--ancestor` class when viewing single posts of a given post type when that post type archive is the menu item.  This fixes the issue with the class incorrectly appearing on normal pages.
152 | 
153 | ## [5.0.0] - 2018-09-13
154 | 
155 | Version 5.0.0 represents a complete break from earlier versions. The framework was essentially rewritten from the ground up to utilize more modern PHP practices. The notes below will be a bit more broad than focusing on the minute details because nearly every line of code in the project has changed.
156 | 
157 | ### Added
158 | 
159 | - An application class was added to have a formal method of booting the framework from the theme. This solved a lot of problems like auto-loading code that wasn't needed and providing a point of contact between the theme and the framework to work together. This allows theme authors to create service providers and bind things to the container.
160 | - The framework now has a container for managing class dependencies and dependency injection. For the purposes of theme development, this will allow theme authors to write better classes, avoid globals and singletons, and create shared instances of objects/data.
161 | - Contracts (interfaces) now play an integral role in how the framework functions. Nearly every class implements one of the available contracts. When used in conjunction with the container, this allows theme authors to plug in custom implementations for features they want to change. Contracts are self-documenting by providing an overview of how any given class works by exposing its public methods.
162 | - A collection class was created for storing key/value pairs. This class allows you to interact with the collection of data as an object or array, depending on your needs.
163 | - A pagination class was added for consistent handling of pagination for posts, comments, and multi-page single views.
164 | - The view system overhauls how template parts are handled. It allows theme authors to utilize sub-folders for housing files, creating a hierarchy, and passing data to templates.
165 | - Created filters for many front-end features of WordPress to utilize a BEM-style HTML class naming scheme.
166 | 
167 | ### Changed
168 | 
169 | - A minimum of WordPress 4.9.6 is now required.
170 | - A minimum of PHP 5.6+ is now required for all themes built from the framework. PHP 7.0+ is strongly recommended, and theme authors are encouraged to bump their own minimums up if possible.
171 | - Using PHP namespaces is perhaps the biggest change of all. Everything within the framework now falls under the `Hybrid` namespace.  Nearly every class and function beyond that is properly categorized in a sub-namespace based on the feature.
172 | - Composer is required for including the framework with the theme. While it's possible to download and drop the framework into a theme folder and build a custom autoloader, that method is no longer officially supported and will likely be tough to do in the future if dependencies are added.
173 | - Classes and folder names now follow the [PSR-4 autloading standard](https://www.php-fig.org/psr/psr-4/).  This means that the files and folders are named literally based on the class name and sub-namespace, respectively. We no longer prefix class files with `class-`.
174 | - Classes are now loaded via the PSR-4 autoloader included with Composer.
175 | - Hooks are namespaced and closely follow our PHP namespaces (for the most part). Hooks are in the form of `hybrid/{$subnamespace}/{$hook}`.
176 | - The framework no longer auto-loads translations for themes.  Both parent and child themes should handle this on their own.
177 | - We no longer auto-enqueue the comment reply script and are leaving this for theme authors to decide what to do on their own.
178 | 
179 | ### Removed
180 | 
181 | - The Breadcrumb Trail extension is now a separate package named [Hybrid Breadcrumbs](https://github.com/themehybrid/hybrid-breadcrumbs).
182 | - The Get the Image extension is now a separate packaged named [Hybrid Carbon](https://github.com/themehybrid/hybrid-carbon).
183 | - The customizer controls, settings, and related code were ported to the [Hybrid Customize](https://github.com/themehybrid/hybrid-customize) project.
184 | - The Google font system was ported to the [Hybrid Font](https://github.com/themehybrid/hybrid-font) project.
185 | - Theme Layouts was removed but will likely return as a separate, add-on repository.
186 | - Cleaner Gallery was likewise removed. Whether it becomes a new project will depend on feedback.
187 | - `HYBRID_URI` constant. The framework no longer ships any assets. Therefore, this is unnecessary.
188 | - Automatic post format support by filtering `the_content`. It seems that core WP is never going to address the shortcomings of post formats, so we've just been fighting a losing battle that most theme authors aren't even participating in.
189 | 
190 | ## [4.0.0] - 2017-07-31
191 | 
192 | ### Added
193 | 
194 | * `.wp-custom-logo` body class.
195 | * Allow the shortcode, autoembeds, embedded, and attached methods of the media grabber to be enabled/disabled.
196 | * New Fonts API.  This allows developers to register, enqueue, etc. fonts just like scripts and styles.  The API natively supports font stylesheets bundled with the theme or the Google Fonts API.
197 | * Introduces the `hybrid_get_theme_mod()` wrapper function, which provides a `hybrid_theme_mod_{$name}_default` filter hook for filtering the default theme mod.
198 | * Adds a the `hybrid_is_layout()` conditional tag for checking if the current page has a specific layout.
199 | * Adds a `hybrid_is_script_debug()` conditional function for checking if `WP_SCRIPT_DEBUG` is set.
200 | * Adds the `hybrid_sprintf_theme_dir()` and `hybrid_sprintf_theme_uri()` functions. These functions replace `%1$s` with the template and `%2$s` with the stylesheet directory path and URI, respectively.
201 | * Introduces `hybrid_get_embed_template()` and an embed template part system.  This allows theme authors to create embed templates based on the post type, format, etc.
202 | * Full admin support for taxonomy term layouts.
203 | * Added the `hybrid()` wrapper function for returning the instance of the `Hybrid` object.
204 | * Adds the `hybrid_widget_exists()` conditional function for checking if a widget (by class name) exists.
205 | * Introduces the `hybrid_comment_parent_link()` and `hybrid_get_comment_parent_link()` functions for displaying or getting the comment parent link of a child comment.
206 | * Creates a new `hybrid_get_template_part()` function, which is a more robust version of the core WP `get_template_part()` function.
207 | * Introduces `hybrid_verify_nonce_post()` and `hybrid_verify_nonce_request()` for easier nonce checking in the admin.
208 | * Adds the `hybrid_get_content_hierarchy()` helper function for content and embed templates.  It retrieves the hierarchy based on post type, format, etc.
209 | * New `.menu-item-parent-archive` nav menu item class when viewing a post and the post type archive item is in the menu.
210 | * New template registration system.  This is post templates on steroids while being completely compatible with core WP's post template system.  Term and user templates are supported but no UI is yet implemented.
211 | * New filter on `document_title_parts`.  This is actually a replacement for the old filter on `wp_title`.  This brings us up to date with new doc title hooks and uses less code.
212 | * Adds the `hybrid_post_media()` and `hybrid_get_post_media()` wrapper functions for displaying and getting post media.  These are wrappers for the media grabber.
213 | * New registry system for registering and storing collections of data on the page.  This replaces some of the old factory/registry methods from before and combines the functionality into a single class.
214 | * Added the `hybrid_attr` hook for a more global filter on attributes.
215 | * Added the `hybrid_attr_{$slug}_class` hook for theme authors to filter just the `class` attribute.
216 | 
217 | ### Changed
218 | 
219 | * Split the archive description filter into two distinct functions:  one for filtering changing the text output and a later function for formatting.
220 | * Registers Hybrid's styles on the front end, embeds, login page, and admin for use.
221 | * Attribute system now allows for `0` or `'0'` as valid attribute values.  `false` is for explicit empty values.
222 | * Overhauled the attributes (`hybrid_attr()`) system.  The framework no longer defines Schema.org as a default.  It leaves this up to theme authors.  Additionally, it only sets defaults for the body, post, and comment attributes.  The framework is just providing the foundation for theme authors to build what they want without getting in their way.
223 | * The `Hybrid` class is now a singleton class.  Theme authors should no longer call `new Hybrid()`.  The framework will launch itself.
224 | * User-selected page templates now overrule the theme author's choice if the theme author included a `front-page.php`.
225 | * Adds the Hybrid Core version to its own stylesheets when registering.
226 | * The template hierarchy system now uses the `*_template_hierarchy` filter hooks as opposed to the `*_template` filter hooks. This means that our code runs before looking up templates, which speeds things up.
227 | * Updated the meta registration calls to be in line with the new WP method of registration.
228 | 
229 | ### Removed
230 | 
231 | * All deprecated functions have been completely removed or added to the "removed" section.  Version 4.0.0 is a major release and not concerned with back-compat.
232 | * Remove old post template admin and functionality since core WP now supports this.  It only took WP 7 years to catch up to the awesomeness that Hybrid users have long been enjoying.
233 | * Mobile toggle script was removed in favor of just letting theme authors handle it.
234 | * The global `$hybrid` variable is now dead.  Good riddance.
235 | * Add the `render_content()` method for JS-based customizer controls to make sure we overwrite the `WP_Customize_Control` method.
236 | * The Post Styles feature is now gone.  It was rarely used and just added bloat.
237 | * Old filter on `wp_title`.
238 | * Media meta, template, and layout hybrid factory-registry classes.
239 | 
240 | ### Fixed
241 | 
242 | * Logic bug with post layout check.
243 | * Post format body class error check.
244 | * Make sure filters on `hybrid_content_template` work correctly.
245 | * Remove 100% max width default for embeds, which caused the WP visual editor to infinitely grow in height when embedding an audio/video file.
246 | * Make sure we have a nav menu object before attempting to get its name in `hybrid_get_menu_name()`.
247 | * Missing `href` attribute for the `hybrid_get_image_size_links()` function.
248 | * Make sure a layout exists before attempting to use it as the layout.
249 | * Fixed incorrect call when unregistering a theme layout.
250 | * Load the minified admin CSS file.
251 | * Use `https` for the WordPress.org link.
252 | * Adds the missing `.page-template-default` body class when no custom template is in use.
253 | * Change the search results title to `Search results for: %s`. This avoids double quotation marks.
254 | 
255 | ### Security
256 | 
257 | * Run `wp_kses_post()` over the content when splitting media from it in the media grabber.
258 | 
259 | ## [3.0.0] - 2015-08-17
260 | 
261 | ### Added
262 | 
263 | * Media grabber now supports the `[gallery]` shortcode.
264 | * Custom attributes can now be passed into `hybrid_attr()`.
265 | * Fix for core WP issues that doesn't allow users to edit the posts page content.
266 | * Separated One Five style into `one-five.css` and `one-five-rtl.css`.
267 | * Added color palette customizer control.
268 | * Added multiple checkbox customizer control.
269 | * Added dropdown terms customizer control.
270 | * Added layout customizer control.
271 | * Added radio image customizer control.
272 | * Added select customizer control that supports `<optgroup>`.
273 | * Added multiple select customizer control.
274 | * Added array map customizer setting.
275 | * Added image data customizer setting.
276 | * Complete overhaul of theme layouts with a new Layouts API and many UI and other improvements.
277 | * The post class now has the `.has-pages` class when it's a paged post.
278 | * New `Hybrid_Chat` class that better handles chat posts.
279 | * New `hybrid_is_plural()` function to go along with core WP's `is_singular()`.
280 | * New `hybrid_get_attachment_type()` and `hybrid_get_attachment_subtype()` functions for getting attachment mime types.
281 | * WordPress.org and theme URLs now use the translated URLs if available so that translators can link to language-specific pages/sites.
282 | * Language-specific PHP files are now loaded from the child theme (first) and parent theme.
283 | * New media metadata class and functions.  This makes it easy to get media file metadata for attachments (limited to audio, video, and images).
284 | * Adds context-based classes to sidebars and menus.
285 | * Post stylesheets extension now built into the framework.  Added extra functions.
286 | * Added extra functions for working with post templates.
287 | * Adds support for WP's `title-tag` feature.
288 | 
289 | ### Changed
290 | 
291 | * `Hybrid` class now loads a few things at different priorities for more flexibility.
292 | * Files and folders were renamed and restructured to make a bit more sense.
293 | * Only load extensions if both the theme supports them and if the file exists.
294 | * Overhauled the constants.
295 | * Coding style updates.  PHPDoc blocks stay the same.  Single-line comments within functions now use `//` and single-line comments within the file use `#`.
296 | * The theme-specific "template" `<meta>` tag is now a "generator" `<meta>` tag.
297 | * All framework constants have a trailing slash.
298 | 
299 | ### Deprecated
300 | 
301 | * `hybrid_loop_title()` in favor of WP's `the_archive_title()`.
302 | * `hybrid_loop_description()` in favor of WP's `the_achive_description()`.
303 | * `loop_pagination()` in favor of WP's `the_posts_pagination()`.
304 | * `hybrid_get_attachment_id_from_url()` in favor of WP's `attachment_url_to_postid()`.
305 | 
306 | ### Removed
307 | 
308 | * Dropped the `hybrid_is_textdomain_loaded()` functionality (wasn't used since 2.0.0).
309 | * `reset.css` stylesheet.
310 | * `hybrid-core-styles` and `hybrid-core-scripts`.  The specific styles/scripts are now registered, leaving the enqueue to theme authors.
311 | * Filter on image size names.
312 | * Filter on id3 keys.
313 | * Several text strings in an effort to make the framework have as few text strings as possible.
314 | * `hybrid_admin_setup()`, which was not really needed.
315 | * Title attributes for most everything for better accessibility.
316 | * bbPress theme support filter removal.
317 | * Atomic hooks functionality.
318 | * Random Custom Background extension.
319 | * Featured Header extension.
320 | * Cleaner Caption extension.
321 | * Custom background customizer control.
322 | * Textarea customizer control.
323 | * Old, unused wrapper for admin theme settings page. Use the customizer!
324 | * Admin widgets screen CSS file.
325 | 
326 | ### Fixed
327 | 
328 | * Schema.org comment microdata brought up to date.
329 | * Schema.org body/content/post errors.
330 | * Media grabber fix when WP auto-embed returns a shortcode.
331 | * Fixed invalid `itemprop` attribute for comment reply link with no space.
332 | 
333 | ### Security
334 | 
335 | * Many text strings are now escaped on output to harden security.
336 | * Better escaping over URLs to harden security.
337 | 
338 | ## Past change logs
339 | 
340 | Versions prior to 3.0.0 do not have change logs. However, you can view the commit logs for each version.
341 | 
342 | * [2.0.4](https://github.com/themehybrid/hybrid-core/tree/2.0.4)
343 | * [2.0.3](https://github.com/themehybrid/hybrid-core/tree/2.0.3)
344 | * [2.0.2](https://github.com/themehybrid/hybrid-core/tree/2.0.2)
345 | * [2.0.1](https://github.com/themehybrid/hybrid-core/tree/2.0.1)
346 | * [2.0.0](https://github.com/themehybrid/hybrid-core/commits/2.0)
347 | * [1.6.2](https://github.com/themehybrid/hybrid-core/tree/1.6.2)
348 | * [1.6.1](https://github.com/themehybrid/hybrid-core/tree/1.6.1)
349 | * [1.6.0](https://github.com/themehybrid/hybrid-core/tree/1.6.0)
350 | * [1.5.5](https://github.com/themehybrid/hybrid-core/tree/1.5.5)
351 | * [1.5.4](https://github.com/themehybrid/hybrid-core/tree/1.5.4)
352 | * [1.5.3](https://github.com/themehybrid/hybrid-core/tree/1.5.3)
353 | * [1.5.2](https://github.com/themehybrid/hybrid-core/tree/1.5.2)
354 | * [1.5.1](https://github.com/themehybrid/hybrid-core/tree/1.5.1)
355 | * [1.5.0](https://github.com/themehybrid/hybrid-core/tree/1.5)
356 | * [1.4.3](https://github.com/themehybrid/hybrid-core/tree/1.4.3)
357 | * [1.4.2](https://github.com/themehybrid/hybrid-core/tree/1.4.2)
358 | * [1.4.1](https://github.com/themehybrid/hybrid-core/tree/1.4.1)
359 | * [1.4.0](https://github.com/themehybrid/hybrid-core/tree/1.4)
360 | * [1.3.1](https://github.com/themehybrid/hybrid-core/tree/1.3.1)
361 | * [1.3.0](https://github.com/themehybrid/hybrid-core/tree/1.3)
362 | * [1.2.1](https://github.com/themehybrid/hybrid-core/tree/1.2.1)
363 | * [1.2.0](https://github.com/themehybrid/hybrid-core/tree/1.2)
364 | * [1.1.1](https://github.com/themehybrid/hybrid-core/tree/1.1.1)
365 | * [1.1.0](https://github.com/themehybrid/hybrid-core/tree/1.1)
366 | 


--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
 1 | # Contributing
 2 | 
 3 | The code for the framework is handled via its [GitHub Repository](https://github.com/themehybrid/hybrid-core).  You can open tickets, create patches, and send pull requests there.
 4 | 
 5 | ## Pull requests
 6 | 
 7 | Problem first.  Solution second.
 8 | 
 9 | Pull requests should have a ticket open for discussion first.  I rarely accept pull requests that aren't for a specific issue for various reasons.  It's far better to post an issue and let me or the community provide feedback prior to creating a pull request.
10 | 
11 | Please don't make pull requests against the `master` branch.  This is the latest, stable code.  You can make a pull request against one of the point branches.
12 | 
13 | ## Theme review guidelines
14 | 
15 | Hybrid Core is developed with the WordPress.org [theme review guidelines](https://make.wordpress.org/themes/handbook/review) in mind.  While the framework is not a theme in and of itself, many theme authors use it within their themes on the official theme repository.  These guidelines should sufficiently cover any other marketplace or theme shop rules for submission.  All new features and code changes must abide by these guidelines to make it into the project.
16 | 
17 | ## Coding standards
18 | 
19 | Hybrid Core follows a mixture of the following standards.
20 | 
21 | - [PSR-1: Basic Coding Standard](https://www.php-fig.org/psr/psr-1)
22 | - [PSR-2: Coding Style](https://www.php-fig.org/psr/psr-2/)
23 | - [PSR-4: Autoloading Standard](https://www.php-fig.org/psr/psr-4)
24 | - [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards)
25 | 
26 | There are instances where I opt for personal choices of my own.  In terms of contributing, stick to the standard you're most familiar with or fall back to the WordPress coding standards.  I'll make any adjustments later if the need arises.
27 | 
28 | ## Language
29 | 
30 | All text strings follow U.S. English by default.  While such guides are generally unneeded, in cases where style considerations are necessary, these will typically follow conventions laid out in *Elements of Style* or the *AP Stylebook*.
31 | 
32 | ## Licensing
33 | 
34 | Any code contributed to Hybrid Core via patches, pull requests, or other means will be licensed under the [GPL version 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) or later.  By contributing code to the project, you provide consent to use such code under this license.  The exception to this rule is when bringing in third-party code with an alternate open source license.
35 | 
36 | ## Versioning
37 | 
38 | Hybrid Core uses [semantic versioning](https://semver.org).  Version numbers will look like `3.2.1` where `3` is the "major" release, `2` is the minor release, and `1` is the patch release.
39 | 


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
  1 | 		    GNU GENERAL PUBLIC LICENSE
  2 | 		       Version 2, June 1991
  3 | 
  4 |  Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
  5 |  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  6 |  Everyone is permitted to copy and distribute verbatim copies
  7 |  of this license document, but changing it is not allowed.
  8 | 
  9 | 			    Preamble
 10 | 
 11 |   The licenses for most software are designed to take away your
 12 | freedom to share and change it.  By contrast, the GNU General Public
 13 | License is intended to guarantee your freedom to share and change free
 14 | software--to make sure the software is free for all its users.  This
 15 | General Public License applies to most of the Free Software
 16 | Foundation's software and to any other program whose authors commit to
 17 | using it.  (Some other Free Software Foundation software is covered by
 18 | the GNU Lesser General Public License instead.)  You can apply it to
 19 | your programs, too.
 20 | 
 21 |   When we speak of free software, we are referring to freedom, not
 22 | price.  Our General Public Licenses are designed to make sure that you
 23 | have the freedom to distribute copies of free software (and charge for
 24 | this service if you wish), that you receive source code or can get it
 25 | if you want it, that you can change the software or use pieces of it
 26 | in new free programs; and that you know you can do these things.
 27 | 
 28 |   To protect your rights, we need to make restrictions that forbid
 29 | anyone to deny you these rights or to ask you to surrender the rights.
 30 | These restrictions translate to certain responsibilities for you if you
 31 | distribute copies of the software, or if you modify it.
 32 | 
 33 |   For example, if you distribute copies of such a program, whether
 34 | gratis or for a fee, you must give the recipients all the rights that
 35 | you have.  You must make sure that they, too, receive or can get the
 36 | source code.  And you must show them these terms so they know their
 37 | rights.
 38 | 
 39 |   We protect your rights with two steps: (1) copyright the software, and
 40 | (2) offer you this license which gives you legal permission to copy,
 41 | distribute and/or modify the software.
 42 | 
 43 |   Also, for each author's protection and ours, we want to make certain
 44 | that everyone understands that there is no warranty for this free
 45 | software.  If the software is modified by someone else and passed on, we
 46 | want its recipients to know that what they have is not the original, so
 47 | that any problems introduced by others will not reflect on the original
 48 | authors' reputations.
 49 | 
 50 |   Finally, any free program is threatened constantly by software
 51 | patents.  We wish to avoid the danger that redistributors of a free
 52 | program will individually obtain patent licenses, in effect making the
 53 | program proprietary.  To prevent this, we have made it clear that any
 54 | patent must be licensed for everyone's free use or not licensed at all.
 55 | 
 56 |   The precise terms and conditions for copying, distribution and
 57 | modification follow.
 58 | 
 59 | 		    GNU GENERAL PUBLIC LICENSE
 60 |    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
 61 | 
 62 |   0. This License applies to any program or other work which contains
 63 | a notice placed by the copyright holder saying it may be distributed
 64 | under the terms of this General Public License.  The "Program", below,
 65 | refers to any such program or work, and a "work based on the Program"
 66 | means either the Program or any derivative work under copyright law:
 67 | that is to say, a work containing the Program or a portion of it,
 68 | either verbatim or with modifications and/or translated into another
 69 | language.  (Hereinafter, translation is included without limitation in
 70 | the term "modification".)  Each licensee is addressed as "you".
 71 | 
 72 | Activities other than copying, distribution and modification are not
 73 | covered by this License; they are outside its scope.  The act of
 74 | running the Program is not restricted, and the output from the Program
 75 | is covered only if its contents constitute a work based on the
 76 | Program (independent of having been made by running the Program).
 77 | Whether that is true depends on what the Program does.
 78 | 
 79 |   1. You may copy and distribute verbatim copies of the Program's
 80 | source code as you receive it, in any medium, provided that you
 81 | conspicuously and appropriately publish on each copy an appropriate
 82 | copyright notice and disclaimer of warranty; keep intact all the
 83 | notices that refer to this License and to the absence of any warranty;
 84 | and give any other recipients of the Program a copy of this License
 85 | along with the Program.
 86 | 
 87 | You may charge a fee for the physical act of transferring a copy, and
 88 | you may at your option offer warranty protection in exchange for a fee.
 89 | 
 90 |   2. You may modify your copy or copies of the Program or any portion
 91 | of it, thus forming a work based on the Program, and copy and
 92 | distribute such modifications or work under the terms of Section 1
 93 | above, provided that you also meet all of these conditions:
 94 | 
 95 |     a) You must cause the modified files to carry prominent notices
 96 |     stating that you changed the files and the date of any change.
 97 | 
 98 |     b) You must cause any work that you distribute or publish, that in
 99 |     whole or in part contains or is derived from the Program or any
100 |     part thereof, to be licensed as a whole at no charge to all third
101 |     parties under the terms of this License.
102 | 
103 |     c) If the modified program normally reads commands interactively
104 |     when run, you must cause it, when started running for such
105 |     interactive use in the most ordinary way, to print or display an
106 |     announcement including an appropriate copyright notice and a
107 |     notice that there is no warranty (or else, saying that you provide
108 |     a warranty) and that users may redistribute the program under
109 |     these conditions, and telling the user how to view a copy of this
110 |     License.  (Exception: if the Program itself is interactive but
111 |     does not normally print such an announcement, your work based on
112 |     the Program is not required to print an announcement.)
113 | 
114 | These requirements apply to the modified work as a whole.  If
115 | identifiable sections of that work are not derived from the Program,
116 | and can be reasonably considered independent and separate works in
117 | themselves, then this License, and its terms, do not apply to those
118 | sections when you distribute them as separate works.  But when you
119 | distribute the same sections as part of a whole which is a work based
120 | on the Program, the distribution of the whole must be on the terms of
121 | this License, whose permissions for other licensees extend to the
122 | entire whole, and thus to each and every part regardless of who wrote it.
123 | 
124 | Thus, it is not the intent of this section to claim rights or contest
125 | your rights to work written entirely by you; rather, the intent is to
126 | exercise the right to control the distribution of derivative or
127 | collective works based on the Program.
128 | 
129 | In addition, mere aggregation of another work not based on the Program
130 | with the Program (or with a work based on the Program) on a volume of
131 | a storage or distribution medium does not bring the other work under
132 | the scope of this License.
133 | 
134 |   3. You may copy and distribute the Program (or a work based on it,
135 | under Section 2) in object code or executable form under the terms of
136 | Sections 1 and 2 above provided that you also do one of the following:
137 | 
138 |     a) Accompany it with the complete corresponding machine-readable
139 |     source code, which must be distributed under the terms of Sections
140 |     1 and 2 above on a medium customarily used for software interchange; or,
141 | 
142 |     b) Accompany it with a written offer, valid for at least three
143 |     years, to give any third party, for a charge no more than your
144 |     cost of physically performing source distribution, a complete
145 |     machine-readable copy of the corresponding source code, to be
146 |     distributed under the terms of Sections 1 and 2 above on a medium
147 |     customarily used for software interchange; or,
148 | 
149 |     c) Accompany it with the information you received as to the offer
150 |     to distribute corresponding source code.  (This alternative is
151 |     allowed only for noncommercial distribution and only if you
152 |     received the program in object code or executable form with such
153 |     an offer, in accord with Subsection b above.)
154 | 
155 | The source code for a work means the preferred form of the work for
156 | making modifications to it.  For an executable work, complete source
157 | code means all the source code for all modules it contains, plus any
158 | associated interface definition files, plus the scripts used to
159 | control compilation and installation of the executable.  However, as a
160 | special exception, the source code distributed need not include
161 | anything that is normally distributed (in either source or binary
162 | form) with the major components (compiler, kernel, and so on) of the
163 | operating system on which the executable runs, unless that component
164 | itself accompanies the executable.
165 | 
166 | If distribution of executable or object code is made by offering
167 | access to copy from a designated place, then offering equivalent
168 | access to copy the source code from the same place counts as
169 | distribution of the source code, even though third parties are not
170 | compelled to copy the source along with the object code.
171 | 
172 |   4. You may not copy, modify, sublicense, or distribute the Program
173 | except as expressly provided under this License.  Any attempt
174 | otherwise to copy, modify, sublicense or distribute the Program is
175 | void, and will automatically terminate your rights under this License.
176 | However, parties who have received copies, or rights, from you under
177 | this License will not have their licenses terminated so long as such
178 | parties remain in full compliance.
179 | 
180 |   5. You are not required to accept this License, since you have not
181 | signed it.  However, nothing else grants you permission to modify or
182 | distribute the Program or its derivative works.  These actions are
183 | prohibited by law if you do not accept this License.  Therefore, by
184 | modifying or distributing the Program (or any work based on the
185 | Program), you indicate your acceptance of this License to do so, and
186 | all its terms and conditions for copying, distributing or modifying
187 | the Program or works based on it.
188 | 
189 |   6. Each time you redistribute the Program (or any work based on the
190 | Program), the recipient automatically receives a license from the
191 | original licensor to copy, distribute or modify the Program subject to
192 | these terms and conditions.  You may not impose any further
193 | restrictions on the recipients' exercise of the rights granted herein.
194 | You are not responsible for enforcing compliance by third parties to
195 | this License.
196 | 
197 |   7. If, as a consequence of a court judgment or allegation of patent
198 | infringement or for any other reason (not limited to patent issues),
199 | conditions are imposed on you (whether by court order, agreement or
200 | otherwise) that contradict the conditions of this License, they do not
201 | excuse you from the conditions of this License.  If you cannot
202 | distribute so as to satisfy simultaneously your obligations under this
203 | License and any other pertinent obligations, then as a consequence you
204 | may not distribute the Program at all.  For example, if a patent
205 | license would not permit royalty-free redistribution of the Program by
206 | all those who receive copies directly or indirectly through you, then
207 | the only way you could satisfy both it and this License would be to
208 | refrain entirely from distribution of the Program.
209 | 
210 | If any portion of this section is held invalid or unenforceable under
211 | any particular circumstance, the balance of the section is intended to
212 | apply and the section as a whole is intended to apply in other
213 | circumstances.
214 | 
215 | It is not the purpose of this section to induce you to infringe any
216 | patents or other property right claims or to contest validity of any
217 | such claims; this section has the sole purpose of protecting the
218 | integrity of the free software distribution system, which is
219 | implemented by public license practices.  Many people have made
220 | generous contributions to the wide range of software distributed
221 | through that system in reliance on consistent application of that
222 | system; it is up to the author/donor to decide if he or she is willing
223 | to distribute software through any other system and a licensee cannot
224 | impose that choice.
225 | 
226 | This section is intended to make thoroughly clear what is believed to
227 | be a consequence of the rest of this License.
228 | 
229 |   8. If the distribution and/or use of the Program is restricted in
230 | certain countries either by patents or by copyrighted interfaces, the
231 | original copyright holder who places the Program under this License
232 | may add an explicit geographical distribution limitation excluding
233 | those countries, so that distribution is permitted only in or among
234 | countries not thus excluded.  In such case, this License incorporates
235 | the limitation as if written in the body of this License.
236 | 
237 |   9. The Free Software Foundation may publish revised and/or new versions
238 | of the General Public License from time to time.  Such new versions will
239 | be similar in spirit to the present version, but may differ in detail to
240 | address new problems or concerns.
241 | 
242 | Each version is given a distinguishing version number.  If the Program
243 | specifies a version number of this License which applies to it and "any
244 | later version", you have the option of following the terms and conditions
245 | either of that version or of any later version published by the Free
246 | Software Foundation.  If the Program does not specify a version number of
247 | this License, you may choose any version ever published by the Free Software
248 | Foundation.
249 | 
250 |   10. If you wish to incorporate parts of the Program into other free
251 | programs whose distribution conditions are different, write to the author
252 | to ask for permission.  For software which is copyrighted by the Free
253 | Software Foundation, write to the Free Software Foundation; we sometimes
254 | make exceptions for this.  Our decision will be guided by the two goals
255 | of preserving the free status of all derivatives of our free software and
256 | of promoting the sharing and reuse of software generally.
257 | 
258 | 			    NO WARRANTY
259 | 
260 |   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
261 | FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
262 | OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
263 | PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
264 | OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
265 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
266 | TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
267 | PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
268 | REPAIR OR CORRECTION.
269 | 
270 |   12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
271 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
272 | REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
273 | INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
274 | OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
275 | TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
276 | YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
277 | PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
278 | POSSIBILITY OF SUCH DAMAGES.
279 | 
280 | 		     END OF TERMS AND CONDITIONS
281 | 
282 | 	    How to Apply These Terms to Your New Programs
283 | 
284 |   If you develop a new program, and you want it to be of the greatest
285 | possible use to the public, the best way to achieve this is to make it
286 | free software which everyone can redistribute and change under these terms.
287 | 
288 |   To do so, attach the following notices to the program.  It is safest
289 | to attach them to the start of each source file to most effectively
290 | convey the exclusion of warranty; and each file should have at least
291 | the "copyright" line and a pointer to where the full notice is found.
292 | 
293 |     <one line to give the program's name and a brief idea of what it does.>
294 |     Copyright (C) <year>  <name of author>
295 | 
296 |     This program is free software; you can redistribute it and/or modify
297 |     it under the terms of the GNU General Public License as published by
298 |     the Free Software Foundation; either version 2 of the License, or
299 |     (at your option) any later version.
300 | 
301 |     This program is distributed in the hope that it will be useful,
302 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
303 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
304 |     GNU General Public License for more details.
305 | 
306 |     You should have received a copy of the GNU General Public License along
307 |     with this program; if not, write to the Free Software Foundation, Inc.,
308 |     51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
309 | 
310 | Also add information on how to contact you by electronic and paper mail.
311 | 
312 | If the program is interactive, make it output a short notice like this
313 | when it starts in an interactive mode:
314 | 
315 |     Gnomovision version 69, Copyright (C) year name of author
316 |     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
317 |     This is free software, and you are welcome to redistribute it
318 |     under certain conditions; type `show c' for details.
319 | 
320 | The hypothetical commands `show w' and `show c' should show the appropriate
321 | parts of the General Public License.  Of course, the commands you use may
322 | be called something other than `show w' and `show c'; they could even be
323 | mouse-clicks or menu items--whatever suits your program.
324 | 
325 | You should also get your employer (if you work as a programmer) or your
326 | school, if any, to sign a "copyright disclaimer" for the program, if
327 | necessary.  Here is a sample; alter the names:
328 | 
329 |   Yoyodyne, Inc., hereby disclaims all copyright interest in the program
330 |   `Gnomovision' (which makes passes at compilers) written by James Hacker.
331 | 
332 |   <signature of Ty Coon>, 1 April 1989
333 |   Ty Coon, President of Vice
334 | 
335 | This General Public License does not permit incorporating your program into
336 | proprietary programs.  If your program is a subroutine library, you may
337 | consider it more useful to permit linking proprietary applications with the
338 | library.  If this is what you want to do, use the GNU Lesser General
339 | Public License instead of this License.
340 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Hybrid Core: WordPress Framework
 2 | 
 3 | Hybrid Core is a framework for developing WordPress plugins and themes.
 4 | 
 5 | The core package is the application layer that primarily consists of a service container.  It can be used alone or alongside any of the available [Hybrid packages](https://github.com/themehybrid/).
 6 | 
 7 | The framework simplifies many of the complexities of WordPress development and helps you write more modern PHP code.  Its goal is to provide elegant functions, classes, and interfaces for writing code without the need to rebuild everything from scratch with each project.
 8 | 
 9 | ## Requirements
10 | 
11 | * WordPress 6.1+
12 | * PHP 8.0+
13 | * Composer 2.0+
14 | 
15 | ## Donations
16 | 
17 | Hybrid Core is free.  However, [donations to the project](https://themehybrid.com/donate) are also welcome.
18 | 
19 | ## Documentation
20 | 
21 | The documentation is handled via Hybrid Core's [wiki](https://github.com/themehybrid/hybrid-core/wiki).  This is community-contributed documentation that I hope you will add to if you use the framework.
22 | 
23 | ### Installation
24 | 
25 | Use the following command from your preferred command line utility to install the package.
26 | 
27 | ```bash
28 | composer require themehybrid/hybrid-core
29 | ```
30 | 
31 | If bundling this directly in your plugin, add the following code.
32 | 
33 | **For plugins:**
34 | 
35 | ```php
36 | if ( file_exists( 'vendor/autoload.php' ) ) {
37 |         require_once 'vendor/autoload.php';
38 | }
39 | ```
40 | 
41 | **For themes:**
42 | 
43 | ```php
44 | if ( file_exists( get_parent_theme_file_path( 'vendor/autoload.php' ) ) ) {
45 | 	require_once( get_parent_theme_file_path( 'vendor/autoload.php' ) );
46 | }
47 | ```
48 | 
49 | ### Bootstrapping Hybrid Core
50 | 
51 | Hybrid Core isn't launched until an instance of its `Hybrid\Core\Application` class is created and its `boot()` method has been called.
52 | 
53 | Because the `Application` class can be called multiple times via both plugins and themes, developers need to check the `Hybrid\booted()` function before attempting to create a new app.  If one exists, they should use the existing instance via the `Hybrid\app()` helper function.
54 | 
55 | ```php
56 | // Create a new application.
57 | $slug = \Hybrid\booted() ? \Hybrid\app() : new \Hybrid\Core\Application();
58 | 
59 | // Add service providers.
60 | $slug->provider( \YourProject\Provider::class );
61 | 
62 | // Bootstrap the application.
63 | $slug->boot();
64 | ```
65 | 
66 | ## Resources
67 | 
68 | [Join Slack Community](https://join.slack.com/t/themehybrid/shared_invite/zt-26e8ju9mu-iBgtE4WeaA3RvyysFvWiBw)
69 | 
70 | ## Copyright and License
71 | 
72 | This project is licensed under the [GNU GPL](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html), version 2 or later.
73 | 
74 | Hybrid Core uses code from Laravel Framework.
75 | The Laravel framework is open-sourced software licensed under the MIT license.
76 | License: MIT - https://opensource.org/licenses/MIT
77 | 
78 | 2008&thinsp;&ndash;&thinsp;2024 &copy; [Theme Hybrid](https://themehybrid.com).
79 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 | 	"name": "themehybrid/hybrid-core",
 3 | 	"description": "Hybrid Core: A framework for developing modern WordPress plugins and themes.",
 4 | 	"license": "GPL-2.0-or-later",
 5 | 	"keywords": [
 6 | 		"wordpress"
 7 | 	],
 8 | 	"authors": [
 9 | 		{
10 | 			"name": "Theme Hybrid",
11 | 			"email": "themehybrid@gmail.com",
12 | 			"homepage": "https://themehybrid.com",
13 | 			"role": "Developer"
14 | 		}
15 | 	],
16 | 	"homepage": "https://github.com/themehybrid/hybrid-core",
17 | 	"support": {
18 | 		"issues": "https://github.com/themehybrid/hybrid-core/issues",
19 | 		"forum": "https://themehybrid.com/board/forums/hybrid-core"
20 | 	},
21 | 	"require": {
22 | 		"php": ">=8.0",
23 | 		"psr/container": "1.0.0",
24 | 		"symfony/console": "^5.0 || ^6.0 || ^7.0",
25 | 		"symfony/polyfill-php80": "^1.25.0",
26 | 		"themehybrid/hybrid-contracts": "^2.0",
27 | 		"themehybrid/hybrid-events": "^1.0",
28 | 		"themehybrid/hybrid-filesystem": "^1.0",
29 | 		"themehybrid/hybrid-tools": "^2.0"
30 | 	},
31 | 	"provide": {
32 | 		"psr/container-implementation": "1.1"
33 | 	},
34 | 	"minimum-stability": "dev",
35 | 	"prefer-stable": true,
36 | 	"autoload": {
37 | 		"psr-4": {
38 | 			"Hybrid\\": "src/"
39 | 		},
40 | 		"files": [
41 | 			"src/functions-helpers.php"
42 | 		]
43 | 	},
44 | 	"config": {
45 | 		"sort-packages": true
46 | 	}
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Container/Attributes/Config.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Container\Attributes;
 4 | 
 5 | use Attribute;
 6 | use Hybrid\Contracts\Container\Container;
 7 | use Hybrid\Contracts\Container\ContextualAttribute;
 8 | 
 9 | #[Attribute( Attribute::TARGET_PARAMETER )]
10 | class Config implements ContextualAttribute {
11 | 
12 |     /**
13 |      * Create a new class instance.
14 |      */
15 |     public function __construct( public string $key, public mixed $default = null ) {}
16 | 
17 |     /**
18 |      * Resolve the configuration value.
19 |      *
20 |      * @return mixed
21 |      */
22 |     public static function resolve( self $attribute, Container $container ) {
23 |         return $container->make( 'config' )->get( $attribute->key, $attribute->default );
24 |     }
25 | 
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Container/BoundMethod.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * @license https://opensource.org/licenses/MIT
  4 |  */
  5 | 
  6 | namespace Hybrid\Container;
  7 | 
  8 | use Closure;
  9 | use Hybrid\Util;
 10 | use ReflectionFunction;
 11 | use ReflectionMethod;
 12 | 
 13 | class BoundMethod {
 14 | 
 15 |     /**
 16 |      * Call the given Closure / class@method and inject its dependencies.
 17 |      *
 18 |      * @param \Hybrid\Container\Container $container
 19 |      * @param callable|string             $callback
 20 |      * @param array                       $parameters
 21 |      * @param string|null                 $defaultMethod
 22 |      * @return mixed
 23 |      * @throws \ReflectionException
 24 |      * @throws \InvalidArgumentException
 25 |      */
 26 |     public static function call( $container, $callback, array $parameters = [], $defaultMethod = null ) {
 27 |         if ( is_string( $callback ) && ! $defaultMethod && method_exists( $callback, '__invoke' ) ) {
 28 |             $defaultMethod = '__invoke';
 29 |         }
 30 | 
 31 |         if ( static::isCallableWithAtSign( $callback ) || $defaultMethod ) {
 32 |             return static::callClass( $container, $callback, $parameters, $defaultMethod );
 33 |         }
 34 | 
 35 |         return static::callBoundMethod( $container, $callback, static fn() => $callback( ...array_values( static::getMethodDependencies( $container, $callback, $parameters ) ) ) );
 36 |     }
 37 | 
 38 |     /**
 39 |      * Call a string reference to a class using Class@method syntax.
 40 |      *
 41 |      * @param \Hybrid\Container\Container $container
 42 |      * @param string                      $target
 43 |      * @param array                       $parameters
 44 |      * @param string|null                 $defaultMethod
 45 |      * @return mixed
 46 |      * @throws \InvalidArgumentException
 47 |      */
 48 |     protected static function callClass( $container, $target, array $parameters = [], $defaultMethod = null ) {
 49 |         $segments = explode( '@', $target );
 50 | 
 51 |         // We will assume an @ sign is used to delimit the class name from the method
 52 |         // name. We will split on this @ sign and then build a callable array that
 53 |         // we can pass right back into the "call" method for dependency binding.
 54 |         $method = count( $segments ) === 2
 55 |             ? $segments[1] : $defaultMethod;
 56 | 
 57 |         if ( is_null( $method ) ) {
 58 |             throw new \InvalidArgumentException( 'Method not provided.' );
 59 |         }
 60 | 
 61 |         return static::call(
 62 |             $container, [ $container->make( $segments[0] ), $method ], $parameters
 63 |         );
 64 |     }
 65 | 
 66 |     /**
 67 |      * Call a method that has been bound to the container.
 68 |      *
 69 |      * @param \Hybrid\Container\Container $container
 70 |      * @param callable                    $callback
 71 |      * @param mixed                       $default
 72 |      * @return mixed
 73 |      */
 74 |     protected static function callBoundMethod( $container, $callback, $default ) {
 75 |         if ( ! is_array( $callback ) ) {
 76 |             return Util::unwrapIfClosure( $default );
 77 |         }
 78 | 
 79 |         // Here we need to turn the array callable into a Class@method string we can use to
 80 |         // examine the container and see if there are any method bindings for this given
 81 |         // method. If there are, we can call this method binding callback immediately.
 82 |         $method = static::normalizeMethod( $callback );
 83 | 
 84 |         if ( $container->hasMethodBinding( $method ) ) {
 85 |             return $container->callMethodBinding( $method, $callback[0] );
 86 |         }
 87 | 
 88 |         return Util::unwrapIfClosure( $default );
 89 |     }
 90 | 
 91 |     /**
 92 |      * Normalize the given callback into a Class@method string.
 93 |      *
 94 |      * @param callable $callback
 95 |      * @return string
 96 |      */
 97 |     protected static function normalizeMethod( $callback ) {
 98 |         $class = is_string( $callback[0] ) ? $callback[0] : get_class( $callback[0] );
 99 | 
100 |         return "{$class}@{$callback[1]}";
101 |     }
102 | 
103 |     /**
104 |      * Get all dependencies for a given method.
105 |      *
106 |      * @param \Hybrid\Container\Container $container
107 |      * @param callable|string             $callback
108 |      * @param array                       $parameters
109 |      * @return array
110 |      * @throws \ReflectionException
111 |      */
112 |     protected static function getMethodDependencies( $container, $callback, array $parameters = [] ) {
113 |         $dependencies = [];
114 | 
115 |         foreach ( static::getCallReflector( $callback )->getParameters() as $parameter ) {
116 |             static::addDependencyForCallParameter( $container, $parameter, $parameters, $dependencies );
117 |         }
118 | 
119 |         return array_merge( $dependencies, array_values( $parameters ) );
120 |     }
121 | 
122 |     /**
123 |      * Get the proper reflection instance for the given callback.
124 |      *
125 |      * @param callable|string $callback
126 |      * @return \ReflectionFunctionAbstract
127 |      * @throws \ReflectionException
128 |      */
129 |     protected static function getCallReflector( $callback ) {
130 |         if ( is_string( $callback ) && str_contains( $callback, '::' ) ) {
131 |             $callback = explode( '::', $callback );
132 |         } elseif ( is_object( $callback ) && ! $callback instanceof Closure ) {
133 |             $callback = [ $callback, '__invoke' ];
134 |         }
135 | 
136 |         return is_array( $callback )
137 |             ? new ReflectionMethod( $callback[0], $callback[1] )
138 |             : new ReflectionFunction( $callback );
139 |     }
140 | 
141 |     /**
142 |      * Get the dependency for the given call parameter.
143 |      *
144 |      * @param \Hybrid\Container\Container $container
145 |      * @param \ReflectionParameter        $parameter
146 |      * @param array                       $parameters
147 |      * @param array                       $dependencies
148 |      * @return void
149 |      * @throws \Hybrid\Contracts\Container\BindingResolutionException
150 |      */
151 |     protected static function addDependencyForCallParameter( $container, $parameter, array &$parameters, &$dependencies ) {
152 |         if ( array_key_exists( $paramName = $parameter->getName(), $parameters ) ) {
153 |             $dependencies[] = $parameters[ $paramName ];
154 | 
155 |             unset( $parameters[ $paramName ] );
156 |         } elseif ( ! is_null( $className = Util::getParameterClassName( $parameter ) ) ) {
157 |             if ( array_key_exists( $className, $parameters ) ) {
158 |                 $dependencies[] = $parameters[ $className ];
159 | 
160 |                 unset( $parameters[ $className ] );
161 |             } elseif ( $parameter->isVariadic() ) {
162 |                 $variadicDependencies = $container->make( $className );
163 | 
164 |                 $dependencies = array_merge( $dependencies, is_array( $variadicDependencies )
165 |                     ? $variadicDependencies
166 |                 : [ $variadicDependencies ] );
167 |             } else {
168 |                 $dependencies[] = $container->make( $className );
169 |             }
170 |         } elseif ( $parameter->isDefaultValueAvailable() ) {
171 |             $dependencies[] = $parameter->getDefaultValue();
172 |         } elseif ( ! $parameter->isOptional() && ! array_key_exists( $paramName, $parameters ) ) {
173 |             $message = "Unable to resolve dependency [{$parameter}] in class {$parameter->getDeclaringClass()->getName()}";
174 | 
175 |             throw new \Hybrid\Contracts\Container\BindingResolutionException( $message );
176 |         }
177 |     }
178 | 
179 |     /**
180 |      * Determine if the given string is in Class@method syntax.
181 |      *
182 |      * @param mixed $callback
183 |      * @return bool
184 |      */
185 |     protected static function isCallableWithAtSign( $callback ) {
186 |         return is_string( $callback ) && str_contains( $callback, '@' );
187 |     }
188 | 
189 | }
190 | 


--------------------------------------------------------------------------------
/src/Container/ContextualBindingBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @license https://opensource.org/licenses/MIT
 4 |  */
 5 | 
 6 | namespace Hybrid\Container;
 7 | 
 8 | use Hybrid\Contracts\Container\Container;
 9 | use Hybrid\Contracts\Container\ContextualBindingBuilder as ContextualBindingBuilderContract;
10 | use Hybrid\Util;
11 | 
12 | class ContextualBindingBuilder implements ContextualBindingBuilderContract {
13 | 
14 |     /**
15 |      * The underlying container instance.
16 |      *
17 |      * @var \Hybrid\Contracts\Container\Container
18 |      */
19 |     protected $container;
20 | 
21 |     /**
22 |      * The concrete instance.
23 |      *
24 |      * @var string|array
25 |      */
26 |     protected $concrete;
27 | 
28 |     /**
29 |      * The abstract target.
30 |      *
31 |      * @var string
32 |      */
33 |     protected $needs;
34 | 
35 |     /**
36 |      * Create a new contextual binding builder.
37 |      *
38 |      * @param string|array $concrete
39 |      */
40 |     public function __construct( Container $container, $concrete ) {
41 |         $this->concrete  = $concrete;
42 |         $this->container = $container;
43 |     }
44 | 
45 |     /**
46 |      * Define the abstract target that depends on the context.
47 |      *
48 |      * @param string $abstract
49 |      * @return $this
50 |      */
51 |     public function needs( $abstract ) {
52 |         $this->needs = $abstract;
53 | 
54 |         return $this;
55 |     }
56 | 
57 |     /**
58 |      * Define the implementation for the contextual binding.
59 |      *
60 |      * @param \Closure|string|array $implementation
61 |      * @return void
62 |      */
63 |     public function give( $implementation ) {
64 |         foreach ( Util::arrayWrap( $this->concrete ) as $concrete ) {
65 |             $this->container->addContextualBinding( $concrete, $this->needs, $implementation );
66 |         }
67 |     }
68 | 
69 |     /**
70 |      * Define tagged services to be used as the implementation for the contextual binding.
71 |      *
72 |      * @param string $tag
73 |      * @return void
74 |      */
75 |     public function giveTagged( $tag ) {
76 |         $this->give( static function ( $container ) use ( $tag ) {
77 |             $taggedServices = $container->tagged( $tag );
78 | 
79 |             return is_array( $taggedServices ) ? $taggedServices : iterator_to_array( $taggedServices );
80 |         } );
81 |     }
82 | 
83 |     /**
84 |      * Specify the configuration item to bind as a primitive.
85 |      *
86 |      * @param string $key
87 |      * @param mixed  $default
88 |      * @return void
89 |      */
90 |     public function giveConfig( $key, $default = null ) {
91 |         $this->give( static fn( $container ) => $container->get( 'config' )->get( $key, $default ) );
92 |     }
93 | 
94 | }
95 | 


--------------------------------------------------------------------------------
/src/Container/EntryNotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @license https://opensource.org/licenses/MIT
 4 |  */
 5 | 
 6 | namespace Hybrid\Container;
 7 | 
 8 | use Psr\Container\NotFoundExceptionInterface;
 9 | 
10 | class EntryNotFoundException extends \Exception implements NotFoundExceptionInterface {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Container/RewindableGenerator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @license https://opensource.org/licenses/MIT
 4 |  */
 5 | 
 6 | namespace Hybrid\Container;
 7 | 
 8 | use Countable;
 9 | use IteratorAggregate;
10 | use Traversable;
11 | 
12 | class RewindableGenerator implements Countable, IteratorAggregate {
13 | 
14 |     /**
15 |      * The generator callback.
16 |      *
17 |      * @var callable
18 |      */
19 |     protected $generator;
20 | 
21 |     /**
22 |      * The number of tagged services.
23 |      *
24 |      * @var callable|int
25 |      */
26 |     protected $count;
27 | 
28 |     /**
29 |      * Create a new generator instance.
30 |      *
31 |      * @param callable|int $count
32 |      * @return void
33 |      */
34 |     public function __construct( callable $generator, $count ) {
35 |         $this->count     = $count;
36 |         $this->generator = $generator;
37 |     }
38 | 
39 |     /**
40 |      * Get an iterator from the generator.
41 |      */
42 |     public function getIterator(): Traversable {
43 |         return ( $this->generator )();
44 |     }
45 | 
46 |     /**
47 |      * Get the total number of tagged services.
48 |      */
49 |     public function count(): int {
50 |         if ( is_callable( $count = $this->count ) ) {
51 |             $this->count = $count();
52 |         }
53 | 
54 |         return $this->count;
55 |     }
56 | 
57 | }
58 | 


--------------------------------------------------------------------------------
/src/Contracts/Container/BindingResolutionException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * Container Exception class.
 4 |  *
 5 |  * @package   HybridCore
 6 |  * @link      https://github.com/themehybrid/hybrid-core
 7 |  *
 8 |  * @author    Theme Hybrid
 9 |  * @copyright Copyright (c) 2008 - 2024, Theme Hybrid
10 |  * @license   https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
11 |  */
12 | 
13 | namespace Hybrid\Contracts\Container;
14 | 
15 | use Psr\Container\ContainerExceptionInterface;
16 | 
17 | class BindingResolutionException extends \Exception implements ContainerExceptionInterface {
18 | 
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Contracts/Container/CircularDependencyException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @license https://opensource.org/licenses/MIT
 4 |  */
 5 | 
 6 | namespace Hybrid\Contracts\Container;
 7 | 
 8 | use Psr\Container\ContainerExceptionInterface;
 9 | 
10 | class CircularDependencyException extends \Exception implements ContainerExceptionInterface {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Contracts/Container/Container.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Container contract.
  4 |  *
  5 |  * Container classes should be used for storing, retrieving, and resolving
  6 |  * classes/objects passed into them.
  7 |  *
  8 |  * @package   HybridCore
  9 |  * @link      https://github.com/themehybrid/hybrid-core
 10 |  *
 11 |  * @author    Theme Hybrid
 12 |  * @copyright Copyright (c) 2008 - 2024, Theme Hybrid
 13 |  * @license   https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 14 |  */
 15 | 
 16 | namespace Hybrid\Contracts\Container;
 17 | 
 18 | use Closure;
 19 | use Psr\Container\ContainerInterface;
 20 | 
 21 | /**
 22 |  * Container interface.
 23 |  */
 24 | interface Container extends ContainerInterface {
 25 | 
 26 |     /**
 27 |      * Determine if the given abstract type has been bound.
 28 |      *
 29 |      * @param string $abstract
 30 |      * @return bool
 31 |      */
 32 |     public function bound( $abstract );
 33 | 
 34 |     /**
 35 |      * Register a binding with the container.
 36 |      *
 37 |      * @param string               $abstract
 38 |      * @param \Closure|string|null $concrete
 39 |      * @param bool                 $shared
 40 |      * @return void
 41 |      */
 42 |     public function bind( $abstract, $concrete = null, $shared = false );
 43 | 
 44 |     /**
 45 |      * Bind a callback to resolve with Container::call.
 46 |      *
 47 |      * @param array|string $method
 48 |      * @param \Closure     $callback
 49 |      * @return void
 50 |      */
 51 |     public function bindMethod( $method, $callback );
 52 | 
 53 |     /**
 54 |      * Register a binding if it hasn't already been registered.
 55 |      *
 56 |      * @param string               $abstract
 57 |      * @param \Closure|string|null $concrete
 58 |      * @param bool                 $shared
 59 |      * @return void
 60 |      */
 61 |     public function bindIf( $abstract, $concrete = null, $shared = false );
 62 | 
 63 |     /**
 64 |      * Alias for `bind()`.
 65 |      *
 66 |      * @param string $abstract
 67 |      * @param mixed  $concrete
 68 |      * @param bool   $shared
 69 |      * @return void
 70 |      * @deprecated Use bind() instead.
 71 |      */
 72 |     public function add( $abstract, $concrete = null, $shared = false );
 73 | 
 74 |     /**
 75 |      * Remove a binding.
 76 |      *
 77 |      * @param string $abstract
 78 |      * @return void
 79 |      */
 80 |     public function remove( $abstract );
 81 | 
 82 |     /**
 83 |      * Resolve and return the binding.
 84 |      *
 85 |      * @param string $abstract
 86 |      * @param array  $parameters
 87 |      * @return mixed
 88 |      */
 89 |     public function resolve( $abstract, array $parameters = [] );
 90 | 
 91 |     /**
 92 |      * Resolve the given type from the container.
 93 |      *
 94 |      * @param string $abstract
 95 |      * @param array  $parameters
 96 |      * @return mixed
 97 |      * @throws \Hybrid\Contracts\Container\BindingResolutionException
 98 |      */
 99 |     public function make( $abstract, array $parameters = [] );
100 | 
101 |     /**
102 |      * Register a shared binding in the container.
103 |      *
104 |      * @param string               $abstract
105 |      * @param \Closure|string|null $concrete
106 |      * @return void
107 |      */
108 |     public function singleton( $abstract, $concrete = null );
109 | 
110 |     /**
111 |      * Register a shared binding if it hasn't already been registered.
112 |      *
113 |      * @param string               $abstract
114 |      * @param \Closure|string|null $concrete
115 |      * @return void
116 |      */
117 |     public function singletonIf( $abstract, $concrete = null );
118 | 
119 |     /**
120 |      * Register a scoped binding in the container.
121 |      *
122 |      * @param string               $abstract
123 |      * @param \Closure|string|null $concrete
124 |      * @return void
125 |      */
126 |     public function scoped( $abstract, $concrete = null );
127 | 
128 |     /**
129 |      * Register a scoped binding if it hasn't already been registered.
130 |      *
131 |      * @param string               $abstract
132 |      * @param \Closure|string|null $concrete
133 |      * @return void
134 |      */
135 |     public function scopedIf( $abstract, $concrete = null );
136 | 
137 |     /**
138 |      * Register an existing instance as shared in the container.
139 |      *
140 |      * @param string $abstract
141 |      * @param mixed  $instance
142 |      * @return mixed
143 |      */
144 |     public function instance( $abstract, $instance );
145 | 
146 |     /**
147 |      * "Extend" an abstract type in the container.
148 |      *
149 |      * @param string $abstract
150 |      * @return void
151 |      * @throws \InvalidArgumentException
152 |      */
153 |     public function extend( $abstract, Closure $closure );
154 | 
155 |     /**
156 |      * Alias a type to a different name.
157 |      *
158 |      * @param string $abstract
159 |      * @param string $alias
160 |      * @return void
161 |      * @throws \LogicException
162 |      */
163 |     public function alias( $abstract, $alias );
164 | 
165 |     /**
166 |      * Assign a set of tags to a given binding.
167 |      *
168 |      * @param array|string $abstracts
169 |      * @param array|mixed  ...$tags
170 |      * @return void
171 |      */
172 |     public function tag( $abstracts, $tags );
173 | 
174 |     /**
175 |      * Resolve all of the bindings for a given tag.
176 |      *
177 |      * @param string $tag
178 |      * @return iterable
179 |      */
180 |     public function tagged( $tag );
181 | 
182 |     /**
183 |      * Add a contextual binding to the container.
184 |      *
185 |      * @param string          $concrete
186 |      * @param string          $abstract
187 |      * @param \Closure|string $implementation
188 |      * @return void
189 |      */
190 |     public function addContextualBinding( $concrete, $abstract, $implementation );
191 | 
192 |     /**
193 |      * Define a contextual binding.
194 |      *
195 |      * @param string|array $concrete
196 |      * @return \Hybrid\Contracts\Container\ContextualBindingBuilder
197 |      */
198 |     public function when( $concrete );
199 | 
200 |     /**
201 |      * Get a closure to resolve the given type from the container.
202 |      *
203 |      * @param string $abstract
204 |      * @return \Closure
205 |      */
206 |     public function factory( $abstract );
207 | 
208 |     /**
209 |      * Flush the container of all bindings and resolved instances.
210 |      *
211 |      * @return void
212 |      */
213 |     public function flush();
214 | 
215 |     /**
216 |      * Call the given Closure / class@method and inject its dependencies.
217 |      *
218 |      * @param callable|string $callback
219 |      * @param array           $parameters
220 |      * @param string|null     $defaultMethod
221 |      * @return mixed
222 |      */
223 |     public function call( $callback, array $parameters = [], $defaultMethod = null );
224 | 
225 |     /**
226 |      * Determine if the given abstract type has been resolved.
227 |      *
228 |      * @param string $abstract
229 |      * @return bool
230 |      */
231 |     public function resolved( $abstract );
232 | 
233 |     /**
234 |      * Register a new before resolving callback.
235 |      *
236 |      * @param \Closure|string $abstract
237 |      * @return void
238 |      */
239 |     public function beforeResolving( $abstract, ?Closure $callback = null );
240 | 
241 |     /**
242 |      * Register a new resolving callback.
243 |      *
244 |      * @param \Closure|string $abstract
245 |      * @return void
246 |      */
247 |     public function resolving( $abstract, ?Closure $callback = null );
248 | 
249 |     /**
250 |      * Register a new after resolving callback.
251 |      *
252 |      * @param \Closure|string $abstract
253 |      * @return void
254 |      */
255 |     public function afterResolving( $abstract, ?Closure $callback = null );
256 | 
257 | }
258 | 


--------------------------------------------------------------------------------
/src/Contracts/Container/ContextualAttribute.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Hybrid\Contracts\Container;
4 | 
5 | interface ContextualAttribute {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/src/Contracts/Container/ContextualBindingBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @license https://opensource.org/licenses/MIT
 4 |  */
 5 | 
 6 | namespace Hybrid\Contracts\Container;
 7 | 
 8 | interface ContextualBindingBuilder {
 9 | 
10 |     /**
11 |      * Define the abstract target that depends on the context.
12 |      *
13 |      * @param string $abstract
14 |      * @return $this
15 |      */
16 |     public function needs( $abstract );
17 | 
18 |     /**
19 |      * Define the implementation for the contextual binding.
20 |      *
21 |      * @param \Closure|string|array $implementation
22 |      * @return void
23 |      */
24 |     public function give( $implementation );
25 | 
26 |     /**
27 |      * Define tagged services to be used as the implementation for the contextual binding.
28 |      *
29 |      * @param string $tag
30 |      * @return void
31 |      */
32 |     public function giveTagged( $tag );
33 | 
34 |     /**
35 |      * Specify the configuration item to bind as a primitive.
36 |      *
37 |      * @param string $key
38 |      * @param mixed  $default
39 |      * @return void
40 |      */
41 |     public function giveConfig( $key, $default = null );
42 | 
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Contracts/Core/Application.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Application contract.
  4 |  *
  5 |  * The Application class should be the be the primary class for working with and
  6 |  * launching the app. It extends the `Container` contract.
  7 |  *
  8 |  * @package   HybridCore
  9 |  * @link      https://github.com/themehybrid/hybrid-core
 10 |  *
 11 |  * @author    Theme Hybrid
 12 |  * @copyright Copyright (c) 2008 - 2024, Theme Hybrid
 13 |  * @license   https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 14 |  */
 15 | 
 16 | namespace Hybrid\Contracts\Core;
 17 | 
 18 | use Hybrid\Contracts\Container\Container;
 19 | 
 20 | /**
 21 |  * Application interface.
 22 |  *
 23 |  * @since  5.0.0
 24 |  */
 25 | interface Application extends Container {
 26 | 
 27 |     /**
 28 |      * Get the version number of the application.
 29 |      *
 30 |      * @return string
 31 |      */
 32 |     public function version();
 33 | 
 34 |     /**
 35 |      * Get the base path of the Hybrid installation.
 36 |      *
 37 |      * @param string $path
 38 |      * @return string
 39 |      */
 40 |     public function basePath( $path = '' );
 41 | 
 42 |     /**
 43 |      * Get the path to the bootstrap directory.
 44 |      *
 45 |      * @param string $path
 46 |      * @return string
 47 |      */
 48 |     public function bootstrapPath( $path = '' );
 49 | 
 50 |     /**
 51 |      * Get the path to the application configuration files.
 52 |      *
 53 |      * @param string $path
 54 |      * @return string
 55 |      */
 56 |     public function configPath( $path = '' );
 57 | 
 58 |     /**
 59 |      * Get the path to the resources directory.
 60 |      *
 61 |      * @param string $path
 62 |      * @return string
 63 |      */
 64 |     public function resourcePath( $path = '' );
 65 | 
 66 |     /**
 67 |      * Get or check the current application environment.
 68 |      *
 69 |      * @param string|array ...$environments
 70 |      * @return string|bool
 71 |      */
 72 |     public function environment( ...$environments );
 73 | 
 74 |     /**
 75 |      * Determine if the application is running in the console.
 76 |      *
 77 |      * @return bool
 78 |      */
 79 |     public function runningInConsole();
 80 | 
 81 |     /**
 82 |      * Determine if the application is running unit tests.
 83 |      *
 84 |      * @return bool
 85 |      */
 86 |     public function runningUnitTests();
 87 | 
 88 |     /**
 89 |      * Register all of the configured providers.
 90 |      *
 91 |      * @return void
 92 |      */
 93 |     public function registerConfiguredProviders();
 94 | 
 95 |     /**
 96 |      * Register a service provider with the application.
 97 |      *
 98 |      * @param \Hybrid\Core\ServiceProvider|string $provider
 99 |      * @param bool                                $force
100 |      * @return \Hybrid\Core\ServiceProvider
101 |      */
102 |     public function register( $provider, $force = false );
103 | 
104 |     /**
105 |      * Register a deferred provider and service.
106 |      *
107 |      * @param string      $provider
108 |      * @param string|null $service
109 |      * @return void
110 |      */
111 |     public function registerDeferredProvider( $provider, $service = null );
112 | 
113 |     /**
114 |      * Resolve a service provider instance from the class name.
115 |      *
116 |      * @param string $provider
117 |      * @return \Hybrid\Core\ServiceProvider
118 |      */
119 |     public function resolveProvider( $provider );
120 | 
121 |     /**
122 |      * Boot the application's service providers.
123 |      *
124 |      * @return void
125 |      */
126 |     public function boot();
127 | 
128 |     /**
129 |      * Register a new boot listener.
130 |      *
131 |      * @param callable $callback
132 |      * @return void
133 |      */
134 |     public function booting( $callback );
135 | 
136 |     /**
137 |      * Register a new "booted" listener.
138 |      *
139 |      * @param callable $callback
140 |      * @return void
141 |      */
142 |     public function booted( $callback );
143 | 
144 |     /**
145 |      * Run the given array of bootstrap classes.
146 |      *
147 |      * @param array $bootstrappers
148 |      * @return void
149 |      */
150 |     public function bootstrapWith( array $bootstrappers );
151 | 
152 |     /**
153 |      * Get the application namespace.
154 |      *
155 |      * @return string
156 |      * @throws \RuntimeException
157 |      */
158 |     public function getNamespace();
159 | 
160 |     /**
161 |      * Get the registered service provider instances if any exist.
162 |      *
163 |      * @param \Hybrid\Core\ServiceProvider|string $provider
164 |      * @return array
165 |      */
166 |     public function getProviders( $provider );
167 | 
168 |     /**
169 |      * Determine if the application has been bootstrapped before.
170 |      *
171 |      * @return bool
172 |      */
173 |     public function hasBeenBootstrapped();
174 | 
175 |     /**
176 |      * Load and boot all of the remaining deferred providers.
177 |      *
178 |      * @return void
179 |      */
180 |     public function loadDeferredProviders();
181 | 
182 |     /**
183 |      * Register a terminating callback with the application.
184 |      *
185 |      * @param callable|string $callback
186 |      * @return \Hybrid\Contracts\Core\Application
187 |      */
188 |     public function terminating( $callback );
189 | 
190 |     /**
191 |      * Terminate the application.
192 |      *
193 |      * @return void
194 |      */
195 |     public function terminate();
196 | 
197 | }
198 | 


--------------------------------------------------------------------------------
/src/Contracts/Core/CachesConfiguration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Contracts\Core;
 4 | 
 5 | interface CachesConfiguration {
 6 | 
 7 |     /**
 8 |      * Determine if the application configuration is cached.
 9 |      *
10 |      * @return bool
11 |      */
12 |     public function configurationIsCached();
13 | 
14 |     /**
15 |      * Get the path to the configuration cache file.
16 |      *
17 |      * @return string
18 |      */
19 |     public function getCachedConfigPath();
20 | 
21 |     /**
22 |      * Get the path to the cached services.php file.
23 |      *
24 |      * @return string
25 |      */
26 |     public function getCachedServicesPath();
27 | 
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Contracts/Core/DeferrableProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Contracts\Core;
 4 | 
 5 | interface DeferrableProvider {
 6 | 
 7 |     /**
 8 |      * Get the services provided by the provider.
 9 |      *
10 |      * @return array
11 |      */
12 |     public function provides();
13 | 
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Core/AliasLoader.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core;
  4 | 
  5 | class AliasLoader {
  6 | 
  7 |     /**
  8 |      * The array of class aliases.
  9 |      *
 10 |      * @var array
 11 |      */
 12 |     protected $aliases;
 13 | 
 14 |     /**
 15 |      * Indicates if a loader has been registered.
 16 |      *
 17 |      * @var bool
 18 |      */
 19 |     protected $registered = false;
 20 | 
 21 |     /**
 22 |      * The namespace for all real-time facades.
 23 |      *
 24 |      * @var string
 25 |      */
 26 |     protected static $facadeNamespace = 'Facades\\';
 27 | 
 28 |     /**
 29 |      * The singleton instance of the loader.
 30 |      *
 31 |      * @var \Hybrid\Core\AliasLoader
 32 |      */
 33 |     protected static $instance;
 34 | 
 35 |     /**
 36 |      * Create a new AliasLoader instance.
 37 |      *
 38 |      * @param array $aliases
 39 |      * @return void
 40 |      */
 41 |     private function __construct( $aliases ) {
 42 |         $this->aliases = $aliases;
 43 |     }
 44 | 
 45 |     /**
 46 |      * Get or create the singleton alias loader instance.
 47 |      *
 48 |      * @param array $aliases
 49 |      * @return \Hybrid\Core\AliasLoader
 50 |      */
 51 |     public static function getInstance( array $aliases = [] ) {
 52 |         if ( is_null( static::$instance ) ) {
 53 |             return static::$instance = new static( $aliases );
 54 |         }
 55 | 
 56 |         $aliases = array_merge( static::$instance->getAliases(), $aliases );
 57 | 
 58 |         static::$instance->setAliases( $aliases );
 59 | 
 60 |         return static::$instance;
 61 |     }
 62 | 
 63 |     /**
 64 |      * Load a class alias if it is registered.
 65 |      *
 66 |      * @param string $alias
 67 |      * @return bool|null
 68 |      */
 69 |     public function load( $alias ) {
 70 |         if ( static::$facadeNamespace && str_starts_with( $alias, static::$facadeNamespace ) ) {
 71 |             $this->loadFacade( $alias );
 72 | 
 73 |             return true;
 74 |         }
 75 | 
 76 |         if ( isset( $this->aliases[ $alias ] ) ) {
 77 |             return class_alias( $this->aliases[ $alias ], $alias );
 78 |         }
 79 |     }
 80 | 
 81 |     /**
 82 |      * Load a real-time facade for the given alias.
 83 |      *
 84 |      * @param string $alias
 85 |      * @return void
 86 |      */
 87 |     protected function loadFacade( $alias ) {
 88 |         require $this->ensureFacadeExists( $alias );
 89 |     }
 90 | 
 91 |     /**
 92 |      * Ensure that the given alias has an existing real-time facade class.
 93 |      *
 94 |      * @param string $alias
 95 |      * @return string
 96 |      */
 97 |     protected function ensureFacadeExists( $alias ) {
 98 |         if ( is_file( $path = storage_path( 'framework/cache/facade-' . sha1( $alias ) . '.php' ) ) ) {
 99 |             return $path;
100 |         }
101 | 
102 |         file_put_contents( $path, $this->formatFacadeStub(
103 |             $alias, file_get_contents( __DIR__ . '/stubs/facade.stub' )
104 |         ) );
105 | 
106 |         return $path;
107 |     }
108 | 
109 |     /**
110 |      * Format the facade stub with the proper namespace and class.
111 |      *
112 |      * @param string $alias
113 |      * @param string $stub
114 |      * @return string
115 |      */
116 |     protected function formatFacadeStub( $alias, $stub ) {
117 |         $replacements = [
118 |             str_replace( '/', '\\', dirname( str_replace( '\\', '/', $alias ) ) ),
119 |             class_basename( $alias ),
120 |             substr( $alias, strlen( static::$facadeNamespace ) ),
121 |         ];
122 | 
123 |         return str_replace(
124 |             [ 'DummyNamespace', 'DummyClass', 'DummyTarget' ], $replacements, $stub
125 |         );
126 |     }
127 | 
128 |     /**
129 |      * Add an alias to the loader.
130 |      *
131 |      * @param string $alias
132 |      * @param string $class
133 |      * @return void
134 |      */
135 |     public function alias( $alias, $class ) {
136 |         $this->aliases[ $alias ] = $class;
137 |     }
138 | 
139 |     /**
140 |      * Register the loader on the auto-loader stack.
141 |      *
142 |      * @return void
143 |      */
144 |     public function register() {
145 |         if ( ! $this->registered ) {
146 |             $this->prependToLoaderStack();
147 | 
148 |             $this->registered = true;
149 |         }
150 |     }
151 | 
152 |     /**
153 |      * Prepend the load method to the auto-loader stack.
154 |      *
155 |      * @return void
156 |      */
157 |     protected function prependToLoaderStack() {
158 |         spl_autoload_register( [ $this, 'load' ], true, true );
159 |     }
160 | 
161 |     /**
162 |      * Get the registered aliases.
163 |      *
164 |      * @return array
165 |      */
166 |     public function getAliases() {
167 |         return $this->aliases;
168 |     }
169 | 
170 |     /**
171 |      * Set the registered aliases.
172 |      *
173 |      * @param array $aliases
174 |      * @return void
175 |      */
176 |     public function setAliases( array $aliases ) {
177 |         $this->aliases = $aliases;
178 |     }
179 | 
180 |     /**
181 |      * Indicates if the loader has been registered.
182 |      *
183 |      * @return bool
184 |      */
185 |     public function isRegistered() {
186 |         return $this->registered;
187 |     }
188 | 
189 |     /**
190 |      * Set the "registered" state of the loader.
191 |      *
192 |      * @param bool $value
193 |      * @return void
194 |      */
195 |     public function setRegistered( $value ) {
196 |         $this->registered = $value;
197 |     }
198 | 
199 |     /**
200 |      * Set the real-time facade namespace.
201 |      *
202 |      * @param string $namespace
203 |      * @return void
204 |      */
205 |     public static function setFacadeNamespace( $namespace ) {
206 |         static::$facadeNamespace = rtrim( $namespace, '\\' ) . '\\';
207 |     }
208 | 
209 |     /**
210 |      * Set the value of the singleton alias loader.
211 |      *
212 |      * @param \Hybrid\Core\AliasLoader $loader
213 |      * @return void
214 |      */
215 |     public static function setInstance( $loader ) {
216 |         static::$instance = $loader;
217 |     }
218 | 
219 |     /**
220 |      * Clone method.
221 |      *
222 |      * @return void
223 |      */
224 |     private function __clone() {}
225 | 
226 | }
227 | 


--------------------------------------------------------------------------------
/src/Core/Application.php:
--------------------------------------------------------------------------------
   1 | <?php
   2 | /**
   3 |  * Application class.
   4 |  *
   5 |  * This class is essentially a wrapper around the `Container` class that's
   6 |  * specific to the framework. This class is meant to be used as the single,
   7 |  * one-true instance of the framework. It's used to load up service providers
   8 |  * that interact with the container.
   9 |  *
  10 |  * @package   HybridCore
  11 |  * @link      https://github.com/themehybrid/hybrid-core
  12 |  *
  13 |  * @author    Theme Hybrid
  14 |  * @copyright Copyright (c) 2008 - 2024, Theme Hybrid
  15 |  * @license   https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
  16 |  */
  17 | 
  18 | namespace Hybrid\Core;
  19 | 
  20 | use Closure;
  21 | use Composer\Autoload\ClassLoader;
  22 | use Hybrid\Container\Container;
  23 | use Hybrid\Contracts\Bootable;
  24 | use Hybrid\Contracts\Core\Application as ApplicationContract;
  25 | use Hybrid\Contracts\Core\CachesConfiguration;
  26 | use Hybrid\Contracts\Filesystem\Factory;
  27 | use Hybrid\Core\Bootstrap\BootProviders;
  28 | use Hybrid\Core\Bootstrap\GenerateStorageStructures;
  29 | use Hybrid\Core\Bootstrap\LoadConfiguration;
  30 | use Hybrid\Core\Bootstrap\LoadEnvironmentVariables;
  31 | use Hybrid\Core\Bootstrap\RegisterFacades;
  32 | use Hybrid\Core\Bootstrap\RegisterProviders;
  33 | use Hybrid\Core\Providers\CoreServiceProvider;
  34 | use Hybrid\Events\Dispatcher;
  35 | use Hybrid\Events\Provider as EventServiceProvider;
  36 | use Hybrid\Filesystem\Filesystem;
  37 | use Hybrid\Filesystem\FilesystemManager;
  38 | use Hybrid\Filesystem\FilesystemServiceProvider;
  39 | use Hybrid\Tools\Arr;
  40 | use Hybrid\Tools\Collection;
  41 | use Hybrid\Tools\Config\Repository;
  42 | use Hybrid\Tools\Env;
  43 | use Hybrid\Tools\Str;
  44 | use Hybrid\Tools\Traits\Macroable;
  45 | use Psr\Container\ContainerInterface;
  46 | use function Hybrid\Filesystem\join_paths;
  47 | use function Hybrid\Tools\value;
  48 | 
  49 | /**
  50 |  * Application class.
  51 |  */
  52 | class Application extends Container implements ApplicationContract, Bootable, CachesConfiguration {
  53 | 
  54 |     use Macroable;
  55 | 
  56 |     /**
  57 |      * The Hybrid Core framework version.
  58 |      */
  59 |     const VERSION = '7.0.0-alpha.3';
  60 | 
  61 |     /**
  62 |      * The base path for the Hybrid Core installation.
  63 |      *
  64 |      * @var string
  65 |      */
  66 |     protected $basePath;
  67 | 
  68 |     /**
  69 |      * The array of registered callbacks.
  70 |      *
  71 |      * @var array<callable>
  72 |      */
  73 |     protected $registeredCallbacks = [];
  74 | 
  75 |     /**
  76 |      * Indicates if the application has been bootstrapped before.
  77 |      *
  78 |      * @var bool
  79 |      */
  80 |     protected $hasBeenBootstrapped = false;
  81 | 
  82 |     /**
  83 |      * Indicates if the application has "booted".
  84 |      *
  85 |      * @var bool
  86 |      */
  87 |     protected $booted = false;
  88 | 
  89 |     /**
  90 |      * The array of booting callbacks.
  91 |      *
  92 |      * @var array<callable>
  93 |      */
  94 |     protected $bootingCallbacks = [];
  95 | 
  96 |     /**
  97 |      * The array of booted callbacks.
  98 |      *
  99 |      * @var array<callable>
 100 |      */
 101 |     protected $bootedCallbacks = [];
 102 | 
 103 |     /**
 104 |      * The array of terminating callbacks.
 105 |      *
 106 |      * @var array<callable>
 107 |      */
 108 |     protected $terminatingCallbacks = [];
 109 | 
 110 |     /**
 111 |      * All of the registered service providers.
 112 |      *
 113 |      * @var array<string, \Hybrid\Core\ServiceProvider>
 114 |      */
 115 |     protected $serviceProviders = [];
 116 | 
 117 |     /**
 118 |      * The names of the loaded service providers.
 119 |      *
 120 |      * @var array
 121 |      */
 122 |     protected $loadedProviders = [];
 123 | 
 124 |     /**
 125 |      * The deferred services and their providers.
 126 |      *
 127 |      * @var array
 128 |      */
 129 |     protected $deferredServices = [];
 130 | 
 131 |     /**
 132 |      * The custom bootstrap path defined by the developer.
 133 |      *
 134 |      * @var string
 135 |      */
 136 |     protected $bootstrapPath;
 137 | 
 138 |     /**
 139 |      * The custom application path defined by the developer.
 140 |      *
 141 |      * @var string
 142 |      */
 143 |     protected $appPath;
 144 | 
 145 |     /**
 146 |      * The custom configuration path defined by the developer.
 147 |      *
 148 |      * @var string
 149 |      */
 150 |     protected $configPath;
 151 | 
 152 |     /**
 153 |      * The custom public / web path defined by the developer.
 154 |      *
 155 |      * @var string
 156 |      */
 157 |     protected $publicPath;
 158 | 
 159 |     /**
 160 |      * The custom storage path defined by the developer.
 161 |      *
 162 |      * @var string
 163 |      */
 164 |     protected $storagePath;
 165 | 
 166 |     /**
 167 |      * The custom resources path defined by the developer.
 168 |      *
 169 |      * @var string
 170 |      */
 171 |     protected $resourcesPath;
 172 | 
 173 |     /**
 174 |      * The custom environment path defined by the developer.
 175 |      *
 176 |      * @var string
 177 |      */
 178 |     protected $environmentPath;
 179 | 
 180 |     /**
 181 |      * The environment file to load during bootstrapping.
 182 |      *
 183 |      * @var string
 184 |      */
 185 |     protected $environmentFile = '.env';
 186 | 
 187 |     /**
 188 |      * Indicates if the application is running in the console.
 189 |      *
 190 |      * @var bool|null
 191 |      */
 192 |     protected $isRunningInConsole;
 193 | 
 194 |     /**
 195 |      * The application namespace.
 196 |      *
 197 |      * @var string
 198 |      */
 199 |     protected $namespace;
 200 | 
 201 |     /**
 202 |      * Indicates if the framework's base configuration should be merged.
 203 |      *
 204 |      * @var bool
 205 |      */
 206 |     protected $mergeFrameworkConfiguration = true;
 207 | 
 208 |     /**
 209 |      * The prefixes of absolute cache paths for use during normalization.
 210 |      *
 211 |      * @var array<string>
 212 |      */
 213 |     protected $absoluteCachePathPrefixes = [ '/', '\\' ];
 214 | 
 215 |     /**
 216 |      * The bootstrap classes for the application.
 217 |      *
 218 |      * @var array<string>
 219 |      */
 220 |     protected $bootstrappers = [
 221 |         LoadEnvironmentVariables::class,
 222 |         LoadConfiguration::class,
 223 |         GenerateStorageStructures::class,
 224 |         // HandleExceptions::class,
 225 |         RegisterFacades::class,
 226 |         RegisterProviders::class,
 227 |         BootProviders::class,
 228 |     ];
 229 | 
 230 |     /**
 231 |      * Create a new Hybrid Core application instance.
 232 |      *
 233 |      * @param string|null $basePath
 234 |      * @return void
 235 |      */
 236 |     public function __construct( $basePath = null, $bootstrap = true ) {
 237 |         if ( ! $basePath && defined( 'WP_CONTENT_DIR' ) ) {
 238 |             $basePath = WP_CONTENT_DIR . '/hybrid-core';
 239 |         }
 240 | 
 241 |         if ( $basePath ) {
 242 |             $this->setBasePath( $basePath );
 243 |         }
 244 | 
 245 |         $this->registerBaseBindings();
 246 |         $this->registerBaseServiceProviders();
 247 |         $this->registerCoreContainerAliases();
 248 | 
 249 |         /*
 250 |          * These bootstrappers load configuration, detect the application environment,
 251 |          * and perform other tasks that need to be done before the boot().
 252 |          * Typically, these classes handle internal Hybrid Core configuration that you do not need to worry about.
 253 |          */
 254 |         if ( $bootstrap ) {
 255 |             $this->bootstrap();
 256 |         }
 257 |     }
 258 | 
 259 |     /**
 260 |      * Begin configuring a new Hybrid Core application instance.
 261 |      *
 262 |      * @param string|null $basePath
 263 |      * @return \Hybrid\Core\Configuration\ApplicationBuilder
 264 |      */
 265 |     public static function configure( ?string $basePath = null ) {
 266 |         $basePath = match ( true ) {
 267 |             is_string( $basePath ) => $basePath,
 268 |             default => static::inferBasePath(),
 269 |         };
 270 | 
 271 |         return ( new Configuration\ApplicationBuilder( new static( $basePath ) ) )
 272 |             ->withEvents()
 273 |             ->withProviders();
 274 |     }
 275 | 
 276 |     /**
 277 |      * Infer the application's base directory from the environment.
 278 |      *
 279 |      * @return string
 280 |      */
 281 |     public static function inferBasePath() {
 282 |         return match ( true ) {
 283 |             isset( $_ENV['HYBRID_CORE_BASE_PATH'] ) => $_ENV['HYBRID_CORE_BASE_PATH'],
 284 |             default => dirname( array_keys( ClassLoader::getRegisteredLoaders() )[0] ),
 285 |         };
 286 |     }
 287 | 
 288 |     /**
 289 |      * Get the version number of the application.
 290 |      *
 291 |      * @return string
 292 |      */
 293 |     public function version() {
 294 |         return self::VERSION;
 295 |     }
 296 | 
 297 |     /**
 298 |      * Register the basic bindings into the container.
 299 |      *
 300 |      * @return void
 301 |      */
 302 |     protected function registerBaseBindings() {
 303 |         static::setInstance( $this );
 304 | 
 305 |         $this->instance( 'app', $this );
 306 | 
 307 |         $this->instance( Container::class, $this );
 308 |         $this->singleton( Mix::class );
 309 | 
 310 |         $this->singleton( PackageManifest::class, fn() => new PackageManifest(
 311 |             new Filesystem(), $this->basePath(), $this->getCachedPackagesPath()
 312 |         ) );
 313 |     }
 314 | 
 315 |     /**
 316 |      * Register all of the base service providers.
 317 |      *
 318 |      * @return void
 319 |      */
 320 |     protected function registerBaseServiceProviders() {
 321 |         $this->register( new CoreServiceProvider( $this ) );
 322 |         $this->register( new EventServiceProvider( $this ) );
 323 |         $this->register( new FilesystemServiceProvider( $this ) );
 324 |         // $this->register( new ContextServiceProvider( $this ) );
 325 |     }
 326 | 
 327 |     /**
 328 |      * Run the given array of bootstrap classes.
 329 |      *
 330 |      * @param array<string> $bootstrappers
 331 |      * @return void
 332 |      */
 333 |     public function bootstrapWith( array $bootstrappers ) {
 334 |         $this->hasBeenBootstrapped = true;
 335 | 
 336 |         foreach ( $bootstrappers as $bootstrapper ) {
 337 |             $this['events']->dispatch( 'bootstrapping: ' . $bootstrapper, [ $this ] );
 338 | 
 339 |             $this->make( $bootstrapper )->bootstrap( $this );
 340 | 
 341 |             $this['events']->dispatch( 'bootstrapped: ' . $bootstrapper, [ $this ] );
 342 |         }
 343 |     }
 344 | 
 345 |     /**
 346 |      * Register a callback to run after loading the environment.
 347 |      *
 348 |      * @param \Closure $callback
 349 |      * @return void
 350 |      */
 351 |     public function afterLoadingEnvironment( Closure $callback ) {
 352 |         $this->afterBootstrapping( LoadEnvironmentVariables::class, $callback );
 353 |     }
 354 | 
 355 |     /**
 356 |      * Register a callback to run before a bootstrapper.
 357 |      *
 358 |      * @param string   $bootstrapper
 359 |      * @param \Closure $callback
 360 |      * @return void
 361 |      */
 362 |     public function beforeBootstrapping( $bootstrapper, Closure $callback ) {
 363 |         $this['events']->listen( 'bootstrapping: ' . $bootstrapper, $callback );
 364 |     }
 365 | 
 366 |     /**
 367 |      * Register a callback to run after a bootstrapper.
 368 |      *
 369 |      * @param string   $bootstrapper
 370 |      * @param \Closure $callback
 371 |      * @return void
 372 |      */
 373 |     public function afterBootstrapping( $bootstrapper, Closure $callback ) {
 374 |         $this['events']->listen( 'bootstrapped: ' . $bootstrapper, $callback );
 375 |     }
 376 | 
 377 |     /**
 378 |      * Determine if the application has been bootstrapped before.
 379 |      *
 380 |      * @return bool
 381 |      */
 382 |     public function hasBeenBootstrapped() {
 383 |         return $this->hasBeenBootstrapped;
 384 |     }
 385 | 
 386 |     /**
 387 |      * Set the base path for the application.
 388 |      *
 389 |      * @param string $basePath
 390 |      * @return $this
 391 |      */
 392 |     public function setBasePath( $basePath ) {
 393 |         $this->basePath = rtrim( $basePath, '\/' );
 394 | 
 395 |         $this->bindPathsInContainer();
 396 | 
 397 |         return $this;
 398 |     }
 399 | 
 400 |     /**
 401 |      * Bind all of the application paths in the container.
 402 |      *
 403 |      * @return void
 404 |      */
 405 |     protected function bindPathsInContainer() {
 406 |         $this->instance( 'path', $this->path() );
 407 |         $this->instance( 'path.base', $this->basePath() );
 408 |         $this->instance( 'path.config', $this->configPath() );
 409 |         $this->instance( 'path.public', $this->publicPath() );
 410 |         $this->instance( 'path.resources', $this->resourcePath() );
 411 |         $this->instance( 'path.storage', $this->storagePath() );
 412 | 
 413 |         $this->useBootstrapPath( value( fn() => is_dir( $directory = $this->basePath( '.hybrid-core' ) )
 414 |                 ? $directory
 415 |                 : $this->basePath( 'bootstrap' ) ) );
 416 |     }
 417 | 
 418 |     /**
 419 |      * Get the path to the application "app" directory.
 420 |      *
 421 |      * @param string $path
 422 |      * @return string
 423 |      */
 424 |     public function path( $path = '' ) {
 425 |         return $this->joinPaths( $this->appPath ?: $this->basePath( 'app' ), $path );
 426 |     }
 427 | 
 428 |     /**
 429 |      * Set the application directory.
 430 |      *
 431 |      * @param string $path
 432 |      * @return $this
 433 |      */
 434 |     public function useAppPath( $path ) {
 435 |         $this->appPath = $path;
 436 | 
 437 |         $this->instance( 'path', $path );
 438 | 
 439 |         return $this;
 440 |     }
 441 | 
 442 |     /**
 443 |      * Get the base path of the Hybrid Core installation.
 444 |      *
 445 |      * @param string $path
 446 |      * @return string
 447 |      */
 448 |     public function basePath( $path = '' ) {
 449 |         return $this->joinPaths( $this->basePath, $path );
 450 |     }
 451 | 
 452 |     /**
 453 |      * Get the path to the bootstrap directory.
 454 |      *
 455 |      * @param string $path
 456 |      * @return string
 457 |      */
 458 |     public function bootstrapPath( $path = '' ) {
 459 |         return $this->joinPaths( $this->bootstrapPath, $path );
 460 |     }
 461 | 
 462 |     /**
 463 |      * Get the path to the service provider list in the bootstrap directory.
 464 |      *
 465 |      * @return string
 466 |      */
 467 |     public function getBootstrapProvidersPath() {
 468 |         return $this->bootstrapPath( 'providers.php' );
 469 |     }
 470 | 
 471 |     /**
 472 |      * Set the bootstrap file directory.
 473 |      *
 474 |      * @param string $path
 475 |      * @return $this
 476 |      */
 477 |     public function useBootstrapPath( $path ) {
 478 |         $this->bootstrapPath = $path;
 479 | 
 480 |         $this->instance( 'path.bootstrap', $path );
 481 | 
 482 |         return $this;
 483 |     }
 484 | 
 485 |     /**
 486 |      * Get the path to the application configuration files.
 487 |      *
 488 |      * @param string $path
 489 |      * @return string
 490 |      */
 491 |     public function configPath( $path = '' ) {
 492 |         return $this->joinPaths( $this->configPath ?: $this->basePath( 'config' ), $path );
 493 |     }
 494 | 
 495 |     /**
 496 |      * Set the configuration directory.
 497 |      *
 498 |      * @param string $path
 499 |      * @return $this
 500 |      */
 501 |     public function useConfigPath( $path ) {
 502 |         $this->configPath = $path;
 503 | 
 504 |         $this->instance( 'path.config', $path );
 505 | 
 506 |         return $this;
 507 |     }
 508 | 
 509 |     /**
 510 |      * Get the path to the public / web directory.
 511 |      *
 512 |      * @param string $path
 513 |      * @return string
 514 |      */
 515 |     public function publicPath( $path = '' ) {
 516 |         return $this->joinPaths( $this->publicPath ?: $this->basePath( 'public' ), $path );
 517 |     }
 518 | 
 519 |     /**
 520 |      * Set the public / web directory.
 521 |      *
 522 |      * @param string $path
 523 |      * @return $this
 524 |      */
 525 |     public function usePublicPath( $path ) {
 526 |         $this->publicPath = $path;
 527 | 
 528 |         $this->instance( 'path.public', $path );
 529 | 
 530 |         return $this;
 531 |     }
 532 | 
 533 |     /**
 534 |      * Get the path to the storage directory.
 535 |      *
 536 |      * @param string $path
 537 |      * @return string
 538 |      */
 539 |     public function storagePath( $path = '' ) {
 540 |         if ( isset( $_ENV['HYBRID_CORE_STORAGE_PATH'] ) ) {
 541 |             return $this->joinPaths( $this->storagePath ?: $_ENV['HYBRID_CORE_STORAGE_PATH'], $path );
 542 |         }
 543 | 
 544 |         if ( isset( $_SERVER['HYBRID_CORE_STORAGE_PATH'] ) ) {
 545 |             return $this->joinPaths( $this->storagePath ?: $_SERVER['HYBRID_CORE_STORAGE_PATH'], $path );
 546 |         }
 547 | 
 548 |         return $this->joinPaths( $this->storagePath ?: $this->basePath( 'storage' ), $path );
 549 |     }
 550 | 
 551 |     /**
 552 |      * Set the storage directory.
 553 |      *
 554 |      * @param string $path
 555 |      * @return $this
 556 |      */
 557 |     public function useStoragePath( $path ) {
 558 |         $this->storagePath = $path;
 559 | 
 560 |         $this->instance( 'path.storage', $path );
 561 | 
 562 |         return $this;
 563 |     }
 564 | 
 565 |     /**
 566 |      * Get the path to the resources directory.
 567 |      *
 568 |      * @param string $path
 569 |      * @return string
 570 |      */
 571 |     public function resourcePath( $path = '' ) {
 572 |         return $this->joinPaths( $this->resourcesPath ?: $this->basePath( 'resources' ), $path );
 573 |     }
 574 | 
 575 |     /**
 576 |      * Set the resources directory.
 577 |      *
 578 |      * @param string $path
 579 |      * @return $this
 580 |      */
 581 |     public function useResourcePath( $path ) {
 582 |         $this->resourcesPath = $path;
 583 | 
 584 |         $this->instance( 'path.resources', $path );
 585 | 
 586 |         return $this;
 587 |     }
 588 | 
 589 |     /**
 590 |      * Get the path to the views directory.
 591 |      *
 592 |      * This method returns the first configured path in the array of view paths.
 593 |      *
 594 |      * @param string $path
 595 |      * @return string
 596 |      */
 597 |     public function viewPath( $path = '' ) {
 598 |         if ( ! $this['config']->has( 'view.paths' ) ) {
 599 |             return '';
 600 |         }
 601 | 
 602 |         $viewPath = rtrim( $this['config']->get( 'view.paths' )[0], DIRECTORY_SEPARATOR );
 603 | 
 604 |         return $this->joinPaths( $viewPath, $path );
 605 |     }
 606 | 
 607 |     /**
 608 |      * Join the given paths together.
 609 |      *
 610 |      * @param string $basePath
 611 |      * @param string $path
 612 |      * @return string
 613 |      */
 614 |     public function joinPaths( $basePath, $path = '' ) {
 615 |         return join_paths( $basePath, $path );
 616 |     }
 617 | 
 618 |     /**
 619 |      * Get the path to the environment file directory.
 620 |      *
 621 |      * @return string
 622 |      */
 623 |     public function environmentPath() {
 624 |         return $this->environmentPath ?: $this->basePath;
 625 |     }
 626 | 
 627 |     /**
 628 |      * Set the directory for the environment file.
 629 |      *
 630 |      * @param string $path
 631 |      * @return $this
 632 |      */
 633 |     public function useEnvironmentPath( $path ) {
 634 |         $this->environmentPath = $path;
 635 | 
 636 |         return $this;
 637 |     }
 638 | 
 639 |     /**
 640 |      * Set the environment file to be loaded during bootstrapping.
 641 |      *
 642 |      * @param string $file
 643 |      * @return $this
 644 |      */
 645 |     public function loadEnvironmentFrom( $file ) {
 646 |         $this->environmentFile = $file;
 647 | 
 648 |         return $this;
 649 |     }
 650 | 
 651 |     /**
 652 |      * Get the environment file the application is using.
 653 |      *
 654 |      * @return string
 655 |      */
 656 |     public function environmentFile() {
 657 |         return $this->environmentFile ?: '.env';
 658 |     }
 659 | 
 660 |     /**
 661 |      * Get the fully qualified path to the environment file.
 662 |      *
 663 |      * @return string
 664 |      */
 665 |     public function environmentFilePath() {
 666 |         return $this->environmentPath() . DIRECTORY_SEPARATOR . $this->environmentFile();
 667 |     }
 668 | 
 669 |     /**
 670 |      * Get or check the current application environment.
 671 |      *
 672 |      * @param string|array ...$environments
 673 |      * @return string|bool
 674 |      */
 675 |     public function environment( ...$environments ) {
 676 |         if ( count( $environments ) > 0 ) {
 677 |             $patterns = is_array( $environments[0] ) ? $environments[0] : $environments;
 678 | 
 679 |             return Str::is( $patterns, $this['env'] );
 680 |         }
 681 | 
 682 |         return $this['env'];
 683 |     }
 684 | 
 685 |     /**
 686 |      * Determine if the application is in the local environment.
 687 |      *
 688 |      * @return bool
 689 |      */
 690 |     public function isLocal() {
 691 |         return 'local' === $this['env'];
 692 |     }
 693 | 
 694 |     /**
 695 |      * Determine if the application is in the production environment.
 696 |      *
 697 |      * @return bool
 698 |      */
 699 |     public function isProduction() {
 700 |         return 'production' === $this['env'];
 701 |     }
 702 | 
 703 |     /**
 704 |      * Detect the application's current environment.
 705 |      *
 706 |      * @return string
 707 |      */
 708 |     public function detectEnvironment( Closure $callback ) {
 709 |         $args = $_SERVER['argv'] ?? null;
 710 | 
 711 |         return $this['env'] = ( new EnvironmentDetector() )->detect( $callback, $args );
 712 |     }
 713 | 
 714 |     /**
 715 |      * Determine if the application is running in the console.
 716 |      *
 717 |      * @return bool
 718 |      */
 719 |     public function runningInConsole() {
 720 |         if ( null === $this->isRunningInConsole ) {
 721 |             $this->isRunningInConsole = Env::get( 'HYBRID_CORE_RUNNING_IN_CONSOLE' ) ?? ( \PHP_SAPI === 'cli' || \PHP_SAPI === 'phpdbg' );
 722 |         }
 723 | 
 724 |         return $this->isRunningInConsole;
 725 |     }
 726 | 
 727 |     /**
 728 |      * Determine if the application is running any of the given console commands.
 729 |      *
 730 |      * @param string|array ...$commands
 731 |      * @return bool
 732 |      */
 733 |     public function runningConsoleCommand( ...$commands ) {
 734 |         if ( ! $this->runningInConsole() ) {
 735 |             return false;
 736 |         }
 737 | 
 738 |         return in_array(
 739 |             $_SERVER['argv'][1] ?? null,
 740 |             is_array( $commands[0] ) ? $commands[0] : $commands
 741 |         );
 742 |     }
 743 | 
 744 |     /**
 745 |      * Determine if the application is running unit tests.
 746 |      *
 747 |      * @return bool
 748 |      */
 749 |     public function runningUnitTests() {
 750 |         return $this->bound( 'env' ) && 'testing' === $this['env'];
 751 |     }
 752 | 
 753 |     /**
 754 |      * Determine if the application is running with debug mode enabled.
 755 |      *
 756 |      * @return bool
 757 |      */
 758 |     public function hasDebugModeEnabled() {
 759 |         return (bool) $this['config']->get( 'app.debug' );
 760 |     }
 761 | 
 762 |     /**
 763 |      * Register a new registered listener.
 764 |      *
 765 |      * @param callable $callback
 766 |      * @return void
 767 |      */
 768 |     public function registered( $callback ) {
 769 |         $this->registeredCallbacks[] = $callback;
 770 |     }
 771 | 
 772 |     /**
 773 |      * Register all of the configured providers.
 774 |      *
 775 |      * @return void
 776 |      */
 777 |     public function registerConfiguredProviders() {
 778 |         $providers = Collection::make( $this->make( 'config' )->get( 'app.providers' ) )
 779 |             ->partition( static fn( $provider ) => str_starts_with( $provider, 'Hybrid\\' ) );
 780 | 
 781 |         $providers->splice( 1, 0, [ $this->make( PackageManifest::class )->providers() ] );
 782 | 
 783 |         ( new ProviderRepository( $this, new Filesystem(), $this->getCachedServicesPath() ) )
 784 |             ->load( $providers->collapse()->toArray() );
 785 | 
 786 |         $this->fireAppCallbacks( $this->registeredCallbacks );
 787 |     }
 788 | 
 789 |     /**
 790 |      * Adds a service provider.
 791 |      *
 792 |      * @param string|object $provider
 793 |      * @return void
 794 |      * @deprecated Use register() instead.
 795 |      */
 796 |     public function provider( $provider ) {
 797 |         @trigger_error( __METHOD__ . '() is deprecated, use Application::register().', E_USER_DEPRECATED );
 798 | 
 799 |         $this->register( $provider );
 800 |     }
 801 | 
 802 |     /**
 803 |      * Register a service provider with the application.
 804 |      *
 805 |      * @param \Hybrid\Core\ServiceProvider|string $provider
 806 |      * @param bool                                $force
 807 |      * @return \Hybrid\Core\ServiceProvider
 808 |      */
 809 |     public function register( $provider, $force = false ) {
 810 |         if ( ( $registered = $this->getProvider( $provider ) ) && ! $force ) {
 811 |             return $registered;
 812 |         }
 813 | 
 814 |         // If the given "provider" is a string, we will resolve it, passing in the
 815 |         // application instance automatically for the developer. This is simply
 816 |         // a more convenient way of specifying your service provider classes.
 817 |         if ( is_string( $provider ) ) {
 818 |             $provider = $this->resolveProvider( $provider );
 819 |         }
 820 | 
 821 |         $provider->register();
 822 | 
 823 |         // If there are bindings / singletons set as properties on the provider we
 824 |         // will spin through them and register them with the application, which
 825 |         // serves as a convenience layer while registering a lot of bindings.
 826 |         if ( property_exists( $provider, 'bindings' ) ) {
 827 |             foreach ( $provider->bindings as $key => $value ) {
 828 |                 $this->bind( $key, $value );
 829 |             }
 830 |         }
 831 | 
 832 |         if ( property_exists( $provider, 'singletons' ) ) {
 833 |             foreach ( $provider->singletons as $key => $value ) {
 834 |                 $key = is_int( $key ) ? $value : $key;
 835 | 
 836 |                 $this->singleton( $key, $value );
 837 |             }
 838 |         }
 839 | 
 840 |         $this->markAsRegistered( $provider );
 841 | 
 842 |         // If the application has already booted, we will call this boot method on
 843 |         // the provider class so it has an opportunity to do its boot logic and
 844 |         // will be ready for any usage by this developer's application logic.
 845 |         if ( $this->isBooted() ) {
 846 |             $this->bootProvider( $provider );
 847 |         }
 848 | 
 849 |         return $provider;
 850 |     }
 851 | 
 852 |     /**
 853 |      * Get the registered service provider instance if it exists.
 854 |      *
 855 |      * @param \Hybrid\Core\ServiceProvider|string $provider
 856 |      * @return \Hybrid\Core\ServiceProvider|null
 857 |      */
 858 |     public function getProvider( $provider ) {
 859 |         $name = is_string( $provider ) ? $provider : get_class( $provider );
 860 | 
 861 |         return $this->serviceProviders[ $name ] ?? null;
 862 |     }
 863 | 
 864 |     /**
 865 |      * Get the registered service provider instances if any exist.
 866 |      *
 867 |      * @param \Hybrid\Core\ServiceProvider|string $provider
 868 |      * @return array
 869 |      */
 870 |     public function getProviders( $provider ) {
 871 |         $name = is_string( $provider ) ? $provider : get_class( $provider );
 872 | 
 873 |         return Arr::where( $this->serviceProviders, static fn( $value ) => $value instanceof $name );
 874 |     }
 875 | 
 876 |     /**
 877 |      * Resolve a service provider instance from the class name.
 878 |      *
 879 |      * @param string $provider
 880 |      * @return \Hybrid\Core\ServiceProvider
 881 |      */
 882 |     public function resolveProvider( $provider ) {
 883 |         return new $provider( $this );
 884 |     }
 885 | 
 886 |     /**
 887 |      * Mark the given provider as registered.
 888 |      *
 889 |      * @param \Hybrid\Core\ServiceProvider $provider
 890 |      * @return void
 891 |      */
 892 |     protected function markAsRegistered( $provider ) {
 893 |         $class = get_class( $provider );
 894 | 
 895 |         $this->serviceProviders[ $class ] = $provider;
 896 | 
 897 |         $this->loadedProviders[ $class ] = true;
 898 |     }
 899 | 
 900 |     /**
 901 |      * Load and boot all of the remaining deferred providers.
 902 |      *
 903 |      * @return void
 904 |      */
 905 |     public function loadDeferredProviders() {
 906 |         // We will simply spin through each of the deferred providers and register each
 907 |         // one and boot them if the application has booted. This should make each of
 908 |         // the remaining services available to this application for immediate use.
 909 |         foreach ( $this->deferredServices as $service => $provider ) {
 910 |             $this->loadDeferredProvider( $service );
 911 |         }
 912 | 
 913 |         $this->deferredServices = [];
 914 |     }
 915 | 
 916 |     /**
 917 |      * Load the provider for a deferred service.
 918 |      *
 919 |      * @param string $service
 920 |      * @return void
 921 |      */
 922 |     public function loadDeferredProvider( $service ) {
 923 |         if ( ! $this->isDeferredService( $service ) ) {
 924 |             return;
 925 |         }
 926 | 
 927 |         $provider = $this->deferredServices[ $service ];
 928 | 
 929 |         // If the service provider has not already been loaded and registered we can
 930 |         // register it with the application and remove the service from this list
 931 |         // of deferred services, since it will already be loaded on subsequent.
 932 |         if ( ! isset( $this->loadedProviders[ $provider ] ) ) {
 933 |             $this->registerDeferredProvider( $provider, $service );
 934 |         }
 935 |     }
 936 | 
 937 |     /**
 938 |      * Register a deferred provider and service.
 939 |      *
 940 |      * @param string      $provider
 941 |      * @param string|null $service
 942 |      * @return void
 943 |      */
 944 |     public function registerDeferredProvider( $provider, $service = null ) {
 945 |         // Once the provider that provides the deferred service has been registered we
 946 |         // will remove it from our local list of the deferred services with related
 947 |         // providers so that this container does not try to resolve it out again.
 948 |         if ( $service ) {
 949 |             unset( $this->deferredServices[ $service ] );
 950 |         }
 951 | 
 952 |         $this->register( $instance = new $provider( $this ) );
 953 | 
 954 |         if ( ! $this->isBooted() ) {
 955 |             $this->booting( function () use ( $instance ) {
 956 |                 $this->bootProvider( $instance );
 957 |             } );
 958 |         }
 959 |     }
 960 | 
 961 |     /**
 962 |      * Resolve the given type from the container.
 963 |      *
 964 |      * @param string $abstract
 965 |      * @param array  $parameters
 966 |      * @return mixed
 967 |      * @throws \Hybrid\Contracts\Container\BindingResolutionException
 968 |      */
 969 |     public function make( $abstract, array $parameters = [] ) {
 970 |         $this->loadDeferredProviderIfNeeded( $abstract = $this->getAlias( $abstract ) );
 971 | 
 972 |         return parent::make( $abstract, $parameters );
 973 |     }
 974 | 
 975 |     /**
 976 |      * Resolve the given type from the container.
 977 |      *
 978 |      * @param string $abstract
 979 |      * @param array  $parameters
 980 |      * @param bool   $raiseEvents
 981 |      * @return mixed
 982 |      * @throws \Hybrid\Contracts\Container\BindingResolutionException
 983 |      * @throws \Hybrid\Contracts\Container\CircularDependencyException
 984 |      */
 985 |     public function resolve( $abstract, $parameters = [], $raiseEvents = true ) {
 986 |         $this->loadDeferredProviderIfNeeded( $abstract = $this->getAlias( $abstract ) );
 987 | 
 988 |         return parent::resolve( $abstract, $parameters, $raiseEvents );
 989 |     }
 990 | 
 991 |     /**
 992 |      * Load the deferred provider if the given type is a deferred service and the instance has not been loaded.
 993 |      *
 994 |      * @param string $abstract
 995 |      * @return void
 996 |      */
 997 |     protected function loadDeferredProviderIfNeeded( $abstract ) {
 998 |         if ( $this->isDeferredService( $abstract ) && ! isset( $this->instances[ $abstract ] ) ) {
 999 |             $this->loadDeferredProvider( $abstract );
1000 |         }
1001 |     }
1002 | 
1003 |     /**
1004 |      * Determine if the given abstract type has been bound.
1005 |      *
1006 |      * @param string $abstract
1007 |      * @return bool
1008 |      */
1009 |     public function bound( $abstract ) {
1010 |         return $this->isDeferredService( $abstract ) || parent::bound( $abstract );
1011 |     }
1012 | 
1013 |     /**
1014 |      * Determine if the application has booted.
1015 |      *
1016 |      * @return bool
1017 |      */
1018 |     public function isBooted() {
1019 |         return $this->booted;
1020 |     }
1021 | 
1022 |     /**
1023 |      * Boot the application's service providers.
1024 |      *
1025 |      * @return void
1026 |      */
1027 |     public function boot() {
1028 | 
1029 |         if ( $this->isBooted() ) {
1030 |             return;
1031 |         }
1032 | 
1033 |         // Once the application has booted we will also fire some "booted" callbacks
1034 |         // for any listeners that need to do work after this initial booting gets
1035 |         // finished. This is useful when ordering the boot-up processes we run.
1036 |         $this->fireAppCallbacks( $this->bootingCallbacks );
1037 | 
1038 |         array_walk( $this->serviceProviders, function ( $p ) {
1039 |             $this->bootProvider( $p );
1040 |         } );
1041 | 
1042 |         $this->booted = true;
1043 | 
1044 |         if ( ! defined( 'HYBRID_CORE_BOOTED' ) ) {
1045 |             define( 'HYBRID_CORE_BOOTED', true );
1046 |         }
1047 | 
1048 |         $this->fireAppCallbacks( $this->bootedCallbacks );
1049 |     }
1050 | 
1051 |     /**
1052 |      * Boot the given service provider.
1053 |      *
1054 |      * @return void
1055 |      */
1056 |     protected function bootProvider( ServiceProvider $provider ) {
1057 | 
1058 |         $provider->callBootingCallbacks();
1059 | 
1060 |         if ( method_exists( $provider, 'boot' ) ) {
1061 |             $this->call( [ $provider, 'boot' ] );
1062 |         }
1063 | 
1064 |         $provider->callBootedCallbacks();
1065 |     }
1066 | 
1067 |     /**
1068 |      * Bootstrap the application bootstrap classes.
1069 |      *
1070 |      * @return void
1071 |      */
1072 |     public function bootstrap() {
1073 |         if ( ! $this->hasBeenBootstrapped() ) {
1074 |             $this->bootstrapWith( $this->bootstrappers() );
1075 |         }
1076 |     }
1077 | 
1078 |     /**
1079 |      * Get the bootstrap classes for the application.
1080 |      *
1081 |      * @return array
1082 |      */
1083 |     protected function bootstrappers() {
1084 |         return $this->bootstrappers;
1085 |     }
1086 | 
1087 |     /**
1088 |      * Register a new boot listener.
1089 |      *
1090 |      * @param callable $callback
1091 |      * @return void
1092 |      */
1093 |     public function booting( $callback ) {
1094 |         $this->bootingCallbacks[] = $callback;
1095 |     }
1096 | 
1097 |     /**
1098 |      * Register a new "booted" listener.
1099 |      *
1100 |      * @param callable $callback
1101 |      * @return void
1102 |      */
1103 |     public function booted( $callback ) {
1104 |         $this->bootedCallbacks[] = $callback;
1105 | 
1106 |         if ( $this->isBooted() ) {
1107 |             $callback( $this );
1108 |         }
1109 |     }
1110 | 
1111 |     /**
1112 |      * Call the booting callbacks for the application.
1113 |      *
1114 |      * @param array<callable> $callbacks
1115 |      * @return void
1116 |      */
1117 |     protected function fireAppCallbacks( array &$callbacks ) {
1118 |         $index = 0;
1119 | 
1120 |         while ( count( $callbacks ) > $index ) {
1121 |             $callbacks[ $index ]( $this );
1122 | 
1123 |             ++$index;
1124 |         }
1125 |     }
1126 | 
1127 |     /**
1128 |      * Determine if the framework's base configuration should be merged.
1129 |      *
1130 |      * @return bool
1131 |      */
1132 |     public function shouldMergeFrameworkConfiguration() {
1133 |         return $this->mergeFrameworkConfiguration;
1134 |     }
1135 | 
1136 |     /**
1137 |      * Indicate that the framework's base configuration should not be merged.
1138 |      *
1139 |      * @return $this
1140 |      */
1141 |     public function dontMergeFrameworkConfiguration() {
1142 |         $this->mergeFrameworkConfiguration = false;
1143 | 
1144 |         return $this;
1145 |     }
1146 | 
1147 |     /**
1148 |      * Get the path to the cached services.php file.
1149 |      *
1150 |      * @return string
1151 |      */
1152 |     public function getCachedServicesPath() {
1153 |         return $this->normalizeCachePath( 'HYBRID_CORE_SERVICES_CACHE', 'cache/services.php' );
1154 |     }
1155 | 
1156 |     /**
1157 |      * Get the path to the cached packages.php file.
1158 |      *
1159 |      * @return string
1160 |      */
1161 |     public function getCachedPackagesPath() {
1162 |         return $this->normalizeCachePath( 'HYBRID_CORE_PACKAGES_CACHE', 'cache/packages.php' );
1163 |     }
1164 | 
1165 |     /**
1166 |      * Determine if the application configuration is cached.
1167 |      *
1168 |      * @return bool
1169 |      */
1170 |     public function configurationIsCached() {
1171 |         return is_file( $this->getCachedConfigPath() );
1172 |     }
1173 | 
1174 |     /**
1175 |      * Get the path to the configuration cache file.
1176 |      *
1177 |      * @return string
1178 |      */
1179 |     public function getCachedConfigPath() {
1180 |         return $this->normalizeCachePath( 'HYBRID_CORE_CONFIG_CACHE', 'cache/config.php' );
1181 |     }
1182 | 
1183 |     /**
1184 |      * Determine if the application events are cached.
1185 |      *
1186 |      * @return bool
1187 |      */
1188 |     public function eventsAreCached() {
1189 |         return $this['files']->exists( $this->getCachedEventsPath() );
1190 |     }
1191 | 
1192 |     /**
1193 |      * Get the path to the events cache file.
1194 |      *
1195 |      * @return string
1196 |      */
1197 |     public function getCachedEventsPath() {
1198 |         return $this->normalizeCachePath( 'HYBRID_CORE_EVENTS_CACHE', 'cache/events.php' );
1199 |     }
1200 | 
1201 |     /**
1202 |      * Normalize a relative or absolute path to a cache file.
1203 |      *
1204 |      * @param string $key
1205 |      * @param string $default
1206 |      * @return string
1207 |      */
1208 |     protected function normalizeCachePath( $key, $default ) {
1209 |         if ( is_null( $env = Env::get( $key ) ) ) {
1210 |             return $this->bootstrapPath( $default );
1211 |         }
1212 | 
1213 |         return Str::startsWith( $env, $this->absoluteCachePathPrefixes )
1214 |             ? $env
1215 |             : $this->basePath( $env );
1216 |     }
1217 | 
1218 |     /**
1219 |      * Add new prefix to list of absolute path prefixes.
1220 |      *
1221 |      * @param string $prefix
1222 |      * @return $this
1223 |      */
1224 |     public function addAbsoluteCachePathPrefix( $prefix ) {
1225 |         $this->absoluteCachePathPrefixes[] = $prefix;
1226 | 
1227 |         return $this;
1228 |     }
1229 | 
1230 |     /**
1231 |      * Register a terminating callback with the application.
1232 |      *
1233 |      * @param callable|string $callback
1234 |      * @return $this
1235 |      */
1236 |     public function terminating( $callback ) {
1237 |         $this->terminatingCallbacks[] = $callback;
1238 | 
1239 |         return $this;
1240 |     }
1241 | 
1242 |     /**
1243 |      * Terminate the application.
1244 |      *
1245 |      * @return void
1246 |      */
1247 |     public function terminate() {
1248 |         $index = 0;
1249 | 
1250 |         while ( count( $this->terminatingCallbacks ) > $index ) {
1251 |             $this->call( $this->terminatingCallbacks[ $index ] );
1252 | 
1253 |             ++$index;
1254 |         }
1255 |     }
1256 | 
1257 |     /**
1258 |      * Get the service providers that have been loaded.
1259 |      *
1260 |      * @return array<string, bool>
1261 |      */
1262 |     public function getLoadedProviders() {
1263 |         return $this->loadedProviders;
1264 |     }
1265 | 
1266 |     /**
1267 |      * Determine if the given service provider is loaded.
1268 |      *
1269 |      * @param string $provider
1270 |      * @return bool
1271 |      */
1272 |     public function providerIsLoaded( string $provider ) {
1273 |         return isset( $this->loadedProviders[ $provider ] );
1274 |     }
1275 | 
1276 |     /**
1277 |      * Get the application's deferred services.
1278 |      *
1279 |      * @return array
1280 |      */
1281 |     public function getDeferredServices() {
1282 |         return $this->deferredServices;
1283 |     }
1284 | 
1285 |     /**
1286 |      * Set the application's deferred services.
1287 |      *
1288 |      * @param array $services
1289 |      * @return void
1290 |      */
1291 |     public function setDeferredServices( array $services ) {
1292 |         $this->deferredServices = $services;
1293 |     }
1294 | 
1295 |     /**
1296 |      * Add an array of services to the application's deferred services.
1297 |      *
1298 |      * @param array $services
1299 |      * @return void
1300 |      */
1301 |     public function addDeferredServices( array $services ) {
1302 |         $this->deferredServices = array_merge( $this->deferredServices, $services );
1303 |     }
1304 | 
1305 |     /**
1306 |      * Determine if the given service is a deferred service.
1307 |      *
1308 |      * @param string $service
1309 |      * @return bool
1310 |      */
1311 |     public function isDeferredService( $service ) {
1312 |         return isset( $this->deferredServices[ $service ] );
1313 |     }
1314 | 
1315 |     /**
1316 |      * Configure the real-time facade namespace.
1317 |      *
1318 |      * @param string $namespace
1319 |      * @return void
1320 |      */
1321 |     public function provideFacades( $namespace ) {
1322 |         AliasLoader::setFacadeNamespace( $namespace );
1323 |     }
1324 | 
1325 |     /**
1326 |      * Register the core class aliases in the container.
1327 |      *
1328 |      * @return void
1329 |      */
1330 |     public function registerCoreContainerAliases() {
1331 |         // Register the core class aliases in the container.
1332 |         foreach ( [
1333 |             'app'        => [ self::class, \Hybrid\Contracts\Container\Container::class, \Hybrid\Contracts\Core\Application::class, ContainerInterface::class ],
1334 |             'config'     => [ Repository::class, \Hybrid\Contracts\Config\Repository::class ],
1335 |             'events'     => [ Dispatcher::class, \Hybrid\Contracts\Events\Dispatcher::class ],
1336 |             'files'      => [ Filesystem::class ],
1337 |             'filesystem' => [ FilesystemManager::class, Factory::class ],
1338 |         ] as $key => $aliases ) {
1339 |             foreach ( $aliases as $alias ) {
1340 |                 $this->alias( $key, $alias );
1341 |             }
1342 |         }
1343 |     }
1344 | 
1345 |     /**
1346 |      * Flush the container of all bindings and resolved instances.
1347 |      *
1348 |      * @return void
1349 |      */
1350 |     public function flush() {
1351 |         parent::flush();
1352 | 
1353 |         $this->buildStack                     = [];
1354 |         $this->loadedProviders                = [];
1355 |         $this->bootedCallbacks                = [];
1356 |         $this->bootingCallbacks               = [];
1357 |         $this->deferredServices               = [];
1358 |         $this->reboundCallbacks               = [];
1359 |         $this->serviceProviders               = [];
1360 |         $this->resolvingCallbacks             = [];
1361 |         $this->terminatingCallbacks           = [];
1362 |         $this->beforeResolvingCallbacks       = [];
1363 |         $this->afterResolvingCallbacks        = [];
1364 |         $this->globalBeforeResolvingCallbacks = [];
1365 |         $this->globalResolvingCallbacks       = [];
1366 |         $this->globalAfterResolvingCallbacks  = [];
1367 |     }
1368 | 
1369 |     /**
1370 |      * Get the application namespace.
1371 |      *
1372 |      * @return string
1373 |      * @throws \RuntimeException
1374 |      */
1375 |     public function getNamespace() {
1376 |         if ( ! is_null( $this->namespace ) ) {
1377 |             return $this->namespace;
1378 |         }
1379 | 
1380 |         $composer = json_decode( file_get_contents( $this->basePath( 'composer.json' ) ), true );
1381 | 
1382 |         foreach ( (array) data_get( $composer, 'autoload.psr-4' ) as $namespace => $path ) {
1383 |             foreach ( (array) $path as $pathChoice ) {
1384 |                 if ( realpath( $this->path() ) === realpath( $this->basePath( $pathChoice ) ) ) {
1385 |                     return $this->namespace = $namespace;
1386 |                 }
1387 |             }
1388 |         }
1389 | 
1390 |         throw new \RuntimeException( 'Unable to detect application namespace.' );
1391 |     }
1392 | 
1393 | }
1394 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/BootProviders.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core\Bootstrap;
 4 | 
 5 | use Hybrid\Contracts\Core\Application;
 6 | 
 7 | class BootProviders {
 8 | 
 9 |     /**
10 |      * Bootstrap the given application.
11 |      *
12 |      * @return void
13 |      */
14 |     public function bootstrap( Application $app ) {
15 |         $app->boot();
16 |     }
17 | 
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/GenerateStorageStructures.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core\Bootstrap;
 4 | 
 5 | use Hybrid\Contracts\Core\Application;
 6 | use Hybrid\Filesystem\Filesystem;
 7 | 
 8 | class GenerateStorageStructures {
 9 | 
10 |     /**
11 |      * Bootstrap the given application.
12 |      *
13 |      * @return void
14 |      */
15 |     public function bootstrap( Application $app ) {
16 |         $directories = [
17 |             $app->storagePath(),
18 |             $app->getCachedServicesPath(),
19 |             $app->getCachedPackagesPath(),
20 |             $app->getCachedConfigPath(),
21 |             $app->getCachedEventsPath(),
22 |         ];
23 | 
24 |         foreach ( $directories as $directory ) {
25 |             $directory = dirname( $directory );
26 | 
27 |             if ( ( new Filesystem() )->exists( $directory ) ) {
28 |                 continue;
29 |             }
30 | 
31 |             ( new Filesystem() )->ensureDirectoryExists( $directory );
32 |         }
33 |     }
34 | 
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/HandleExceptions.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Bootstrap;
  4 | 
  5 | use Hybrid\Contracts\Core\Application;
  6 | use Hybrid\Contracts\Debug\ExceptionHandler;
  7 | use Hybrid\Tools\Log\LogManager;
  8 | use Monolog\Handler\NullHandler;
  9 | use Symfony\Component\Console\Output\ConsoleOutput;
 10 | use Symfony\Component\ErrorHandler\Error\FatalError;
 11 | use function Hybrid\Tools\with;
 12 | 
 13 | class HandleExceptions {
 14 | 
 15 |     /**
 16 |      * Reserved memory so that errors can be displayed properly on memory exhaustion.
 17 |      *
 18 |      * @var string
 19 |      */
 20 |     public static $reservedMemory;
 21 | 
 22 |     /**
 23 |      * The application instance.
 24 |      *
 25 |      * @var \Hybrid\Contracts\Core\Application
 26 |      */
 27 |     protected static $app;
 28 | 
 29 |     /**
 30 |      * Bootstrap the given application.
 31 |      *
 32 |      * @return void
 33 |      */
 34 |     public function bootstrap( Application $app ) {
 35 |         self::$reservedMemory = str_repeat( 'x', 32768 );
 36 | 
 37 |         static::$app = $app;
 38 | 
 39 |         error_reporting( -1 );
 40 | 
 41 |         set_error_handler( $this->forwardsTo( 'handleError' ) );
 42 | 
 43 |         set_exception_handler( $this->forwardsTo( 'handleException' ) );
 44 | 
 45 |         register_shutdown_function( $this->forwardsTo( 'handleShutdown' ) );
 46 | 
 47 |         if ( ! $app->environment( 'testing' ) ) {
 48 |             ini_set( 'display_errors', 'Off' );
 49 |         }
 50 |     }
 51 | 
 52 |     /**
 53 |      * Report PHP deprecations, or convert PHP errors to ErrorException instances.
 54 |      *
 55 |      * @param int    $level
 56 |      * @param string $message
 57 |      * @param string $file
 58 |      * @param int    $line
 59 |      * @param array  $context
 60 |      * @return void
 61 |      * @throws \ErrorException
 62 |      */
 63 |     public function handleError( $level, $message, $file = '', $line = 0, $context = [] ) {
 64 |         if ( $this->isDeprecation( $level ) ) {
 65 |             return $this->handleDeprecationError( $message, $file, $line, $level );
 66 |         }
 67 | 
 68 |         if ( error_reporting() & $level ) {
 69 |             throw new \ErrorException( $message, 0, $level, $file, $line );
 70 |         }
 71 |     }
 72 | 
 73 |     /**
 74 |      * Reports a deprecation to the "deprecations" logger.
 75 |      *
 76 |      * @param string $message
 77 |      * @param string $file
 78 |      * @param int    $line
 79 |      * @return void
 80 |      * @deprecated Use handleDeprecationError instead.
 81 |      */
 82 |     public function handleDeprecation( $message, $file, $line ) {
 83 |         $this->handleDeprecationError( $message, $file, $line );
 84 |     }
 85 | 
 86 |     /**
 87 |      * Reports a deprecation to the "deprecations" logger.
 88 |      *
 89 |      * @param string $message
 90 |      * @param string $file
 91 |      * @param int    $line
 92 |      * @param int    $level
 93 |      * @return void
 94 |      */
 95 |     public function handleDeprecationError( $message, $file, $line, $level = E_DEPRECATED ) {
 96 |         if ( ! class_exists( LogManager::class )
 97 |             || ! static::$app->hasBeenBootstrapped()
 98 |             || static::$app->runningUnitTests()
 99 |         ) {
100 |             return;
101 |         }
102 | 
103 |         try {
104 |             $logger = static::$app->make( LogManager::class );
105 |         } catch ( \Throwable ) {
106 |             return;
107 |         }
108 | 
109 |         $this->ensureDeprecationLoggerIsConfigured();
110 | 
111 |         $options = static::$app['config']->get( 'logging.deprecations' ) ?? [];
112 | 
113 |         with( $logger->channel( 'deprecations' ), static function ( $log ) use ( $message, $file, $line, $level, $options ) {
114 |             if ( $options['trace'] ?? false ) {
115 |                 $log->warning( (string) new \ErrorException( $message, 0, $level, $file, $line ) );
116 |             } else {
117 |                 $log->warning( sprintf( '%s in %s on line %s',
118 |                     $message, $file, $line
119 |                 ) );
120 |             }
121 |         } );
122 |     }
123 | 
124 |     /**
125 |      * Ensure the "deprecations" logger is configured.
126 |      *
127 |      * @return void
128 |      */
129 |     protected function ensureDeprecationLoggerIsConfigured() {
130 |         with( static::$app['config'], function ( $config ) {
131 |             if ( $config->get( 'logging.channels.deprecations' ) ) {
132 |                 return;
133 |             }
134 | 
135 |             $this->ensureNullLogDriverIsConfigured();
136 | 
137 |             $options = $config->get( 'logging.deprecations' );
138 | 
139 |             $driver = is_array( $options ) ? $options['channel'] : ( $options ?? 'null' );
140 | 
141 |             $config->set( 'logging.channels.deprecations', $config->get( "logging.channels.{$driver}" ) );
142 |         } );
143 |     }
144 | 
145 |     /**
146 |      * Ensure the "null" log driver is configured.
147 |      *
148 |      * @return void
149 |      */
150 |     protected function ensureNullLogDriverIsConfigured() {
151 |         with( static::$app['config'], static function ( $config ) {
152 |             if ( $config->get( 'logging.channels.null' ) ) {
153 |                 return;
154 |             }
155 | 
156 |             $config->set( 'logging.channels.null', [
157 |                 'driver'  => 'monolog',
158 |                 'handler' => NullHandler::class,
159 |             ] );
160 |         } );
161 |     }
162 | 
163 |     /**
164 |      * Handle an uncaught exception from the application.
165 |      *
166 |      * Note: Most exceptions can be handled via the try / catch block in
167 |      * the HTTP and Console kernels. But, fatal error exceptions must
168 |      * be handled differently since they are not normal exceptions.
169 |      *
170 |      * @return void
171 |      */
172 |     public function handleException( \Throwable $e ) {
173 |         self::$reservedMemory = null;
174 | 
175 |         try {
176 |             $this->getExceptionHandler()->report( $e );
177 |         } catch ( \Throwable $e ) {
178 |         }
179 | 
180 |         if ( static::$app->runningInConsole() ) {
181 |             $this->renderForConsole( $e );
182 |         } else {
183 |             $this->renderHttpResponse( $e );
184 |         }
185 |     }
186 | 
187 |     /**
188 |      * Render an exception to the console.
189 |      *
190 |      * @return void
191 |      */
192 |     protected function renderForConsole( \Throwable $e ) {
193 |         $this->getExceptionHandler()->renderForConsole( new ConsoleOutput(), $e );
194 |     }
195 | 
196 |     /**
197 |      * Render an exception as an HTTP response and send it.
198 |      *
199 |      * @return void
200 |      */
201 |     protected function renderHttpResponse( \Throwable $e ) {
202 |         $this->getExceptionHandler()->render( static::$app['request'], $e )->send();
203 |     }
204 | 
205 |     /**
206 |      * Handle the PHP shutdown event.
207 |      *
208 |      * @return void
209 |      */
210 |     public function handleShutdown() {
211 |         self::$reservedMemory = null;
212 | 
213 |         if ( ! is_null( $error = error_get_last() ) && $this->isFatal( $error['type'] ) ) {
214 |             $this->handleException( $this->fatalErrorFromPhpError( $error, 0 ) );
215 |         }
216 |     }
217 | 
218 |     /**
219 |      * Create a new fatal error instance from an error array.
220 |      *
221 |      * @param array    $error
222 |      * @param int|null $traceOffset
223 |      * @return \Symfony\Component\ErrorHandler\Error\FatalError
224 |      */
225 |     protected function fatalErrorFromPhpError( array $error, $traceOffset = null ) {
226 |         return new FatalError( $error['message'], 0, $error, $traceOffset );
227 |     }
228 | 
229 |     /**
230 |      * Forward a method call to the given method if an application instance exists.
231 |      *
232 |      * @return callable
233 |      */
234 |     protected function forwardsTo( $method ) {
235 |         return fn( ...$arguments ) => static::$app
236 |             ? $this->{$method}( ...$arguments )
237 |             : false;
238 |     }
239 | 
240 |     /**
241 |      * Determine if the error level is a deprecation.
242 |      *
243 |      * @param int $level
244 |      * @return bool
245 |      */
246 |     protected function isDeprecation( $level ) {
247 |         return in_array( $level, [ E_DEPRECATED, E_USER_DEPRECATED ] );
248 |     }
249 | 
250 |     /**
251 |      * Determine if the error type is fatal.
252 |      *
253 |      * @param int $type
254 |      * @return bool
255 |      */
256 |     protected function isFatal( $type ) {
257 |         return in_array( $type, [ E_COMPILE_ERROR, E_CORE_ERROR, E_ERROR, E_PARSE ] );
258 |     }
259 | 
260 |     /**
261 |      * Get an instance of the exception handler.
262 |      *
263 |      * @return \Hybrid\Contracts\Debug\ExceptionHandler
264 |      */
265 |     protected function getExceptionHandler() {
266 |         return static::$app->make( ExceptionHandler::class );
267 |     }
268 | 
269 |     /**
270 |      * Clear the local application instance from memory.
271 |      *
272 |      * @return void
273 |      */
274 |     public static function forgetApp() {
275 |         static::$app = null;
276 |     }
277 | 
278 | }
279 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/LoadConfiguration.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Bootstrap;
  4 | 
  5 | use Hybrid\Contracts\Config\Repository as RepositoryContract;
  6 | use Hybrid\Contracts\Core\Application;
  7 | use Hybrid\Tools\Config\Repository;
  8 | use SplFileInfo;
  9 | use Symfony\Component\Finder\Finder;
 10 | 
 11 | class LoadConfiguration {
 12 | 
 13 |     /**
 14 |      * Bootstrap the given application.
 15 |      *
 16 |      * @param \Hybrid\Contracts\Core\Application $app
 17 |      * @return void
 18 |      */
 19 |     public function bootstrap( Application $app ) {
 20 |         $items = [];
 21 | 
 22 |         // First we will see if we have a cache configuration file. If we do, we'll load
 23 |         // the configuration items from that file so that it is very quick. Otherwise
 24 |         // we will need to spin through every configuration file and load them all.
 25 |         if ( file_exists( $cached = $app->getCachedConfigPath() ) ) {
 26 |             $items = require $cached;
 27 | 
 28 |             $app->instance( 'config_loaded_from_cache', $loadedFromCache = true );
 29 |         }
 30 | 
 31 |         // Next we will spin through all of the configuration files in the configuration
 32 |         // directory and load each one into the repository. This will make all of the
 33 |         // options available to the developer for use in various parts of this app.
 34 |         $app->instance( 'config', $config = new Repository( $items ) );
 35 | 
 36 |         if ( ! isset( $loadedFromCache ) ) {
 37 |             $this->loadConfigurationFiles( $app, $config );
 38 |         }
 39 | 
 40 |         // Finally, we will set the application's environment based on the configuration
 41 |         // values that were loaded. We will pass a callback which will be used to get
 42 |         // the environment in a web context where an "--env" switch is not present.
 43 |         $app->detectEnvironment( static fn() => $config->get( 'app.env', 'production' ) );
 44 |     }
 45 | 
 46 |     /**
 47 |      * Load the configuration items from all of the files.
 48 |      *
 49 |      * @param \Hybrid\Contracts\Core\Application  $app
 50 |      * @param \Hybrid\Contracts\Config\Repository $repository
 51 |      * @return void
 52 |      * @throws \Exception
 53 |      */
 54 |     protected function loadConfigurationFiles( Application $app, RepositoryContract $repository ) {
 55 |         $files = $this->getConfigurationFiles( $app );
 56 | 
 57 |         $shouldMerge = method_exists( $app, 'shouldMergeFrameworkConfiguration' )
 58 |             ? $app->shouldMergeFrameworkConfiguration()
 59 |             : true;
 60 | 
 61 |         $base = $shouldMerge
 62 |             ? $this->getBaseConfiguration()
 63 |             : [];
 64 | 
 65 |         foreach ( array_diff( array_keys( $base ), array_keys( $files ) ) as $name => $config ) {
 66 |             $repository->set( $name, $config );
 67 |         }
 68 | 
 69 |         foreach ( $files as $name => $path ) {
 70 |             $base = $this->loadConfigurationFile( $repository, $name, $path, $base );
 71 |         }
 72 | 
 73 |         foreach ( $base as $name => $config ) {
 74 |             $repository->set( $name, $config );
 75 |         }
 76 |     }
 77 | 
 78 |     /**
 79 |      * Load the given configuration file.
 80 |      *
 81 |      * @param \Hybrid\Contracts\Config\Repository $repository
 82 |      * @param string                              $name
 83 |      * @param string                              $path
 84 |      * @param array                               $base
 85 |      * @return array
 86 |      */
 87 |     protected function loadConfigurationFile( RepositoryContract $repository, $name, $path, array $base ) {
 88 |         $config = require $path;
 89 | 
 90 |         if ( isset( $base[ $name ] ) ) {
 91 |             $config = array_merge( $base[ $name ], $config );
 92 | 
 93 |             foreach ( $this->mergeableOptions( $name ) as $option ) {
 94 |                 if ( isset( $config[ $option ] ) ) {
 95 |                     $config[ $option ] = array_merge( $base[ $name ][ $option ], $config[ $option ] );
 96 |                 }
 97 |             }
 98 | 
 99 |             unset( $base[ $name ] );
100 |         }
101 | 
102 |         $repository->set( $name, $config );
103 | 
104 |         return $base;
105 |     }
106 | 
107 |     /**
108 |      * Get the options within the configuration file that should be merged again.
109 |      *
110 |      * @param string $name
111 |      * @return array
112 |      */
113 |     protected function mergeableOptions( $name ) {
114 |         return [
115 |             'logging' => [ 'channels' ],
116 |         ][ $name ] ?? [];
117 |     }
118 | 
119 |     /**
120 |      * Get all of the configuration files for the application.
121 |      *
122 |      * @param \Hybrid\Contracts\Core\Application $app
123 |      * @return array
124 |      */
125 |     protected function getConfigurationFiles( Application $app ) {
126 |         $files = [];
127 | 
128 |         $configPath = realpath( $app->configPath() );
129 | 
130 |         if ( ! $configPath ) {
131 |             return [];
132 |         }
133 | 
134 |         foreach ( Finder::create()->files()->name( '*.php' )->in( $configPath ) as $file ) {
135 |             $directory = $this->getNestedDirectory( $file, $configPath );
136 | 
137 |             $files[ $directory . basename( $file->getRealPath(), '.php' ) ] = $file->getRealPath();
138 |         }
139 | 
140 |         ksort( $files, SORT_NATURAL );
141 | 
142 |         return $files;
143 |     }
144 | 
145 |     /**
146 |      * Get the configuration file nesting path.
147 |      *
148 |      * @param \SplFileInfo $file
149 |      * @param string       $configPath
150 |      * @return string
151 |      */
152 |     protected function getNestedDirectory( SplFileInfo $file, $configPath ) {
153 |         $directory = $file->getPath();
154 | 
155 |         if ( $nested = trim( str_replace( $configPath, '', $directory ), DIRECTORY_SEPARATOR ) ) {
156 |             $nested = str_replace( DIRECTORY_SEPARATOR, '.', $nested ) . '.';
157 |         }
158 | 
159 |         return $nested;
160 |     }
161 | 
162 |     /**
163 |      * Get the base configuration files.
164 |      *
165 |      * @return array
166 |      */
167 |     protected function getBaseConfiguration() {
168 |         $config = [];
169 | 
170 |         $configPath = __DIR__ . '/../../../../config';
171 | 
172 |         // Check if the configuration directory exists.
173 |         // In Hybrid Core, the base configuration is optional and depends on the application's setup.
174 |         // Return an empty configuration array if the directory does not exist.
175 |         if ( ! is_dir( $configPath ) ) {
176 |             return $config;
177 |         }
178 | 
179 |         foreach ( Finder::create()->files()->name( '*.php' )->in( $configPath ) as $file ) {
180 |             $config[ basename( $file->getRealPath(), '.php' ) ] = require $file->getRealPath();
181 |         }
182 | 
183 |         return $config;
184 |     }
185 | 
186 | }
187 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/LoadEnvironmentVariables.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Bootstrap;
  4 | 
  5 | use Dotenv\Dotenv;
  6 | use Hybrid\Contracts\Core\Application;
  7 | use Hybrid\Tools\Env;
  8 | use Symfony\Component\Console\Input\ArgvInput;
  9 | use Symfony\Component\Console\Output\ConsoleOutput;
 10 | 
 11 | class LoadEnvironmentVariables {
 12 | 
 13 |     /**
 14 |      * Bootstrap the given application.
 15 |      *
 16 |      * @param \Hybrid\Contracts\Core\Application $app
 17 |      * @return void
 18 |      */
 19 |     public function bootstrap( Application $app ) {
 20 |         if ( $app->configurationIsCached() ) {
 21 |             return;
 22 |         }
 23 | 
 24 |         $this->checkForSpecificEnvironmentFile( $app );
 25 | 
 26 |         // Check if the .env file exists before proceeding further.
 27 |         // In Hybrid Core, the presence of a .env file is optional. The application
 28 |         // can function without it, depending on the specific configuration and setup.
 29 |         // If the .env file does not exist, simply return to avoid unnecessary processing.
 30 |         if ( ! file_exists( $app->environmentFilePath() ) ) {
 31 |             return;
 32 |         }
 33 | 
 34 |         try {
 35 |             $this->createDotenv( $app )->safeLoad();
 36 |         } catch ( \Dotenv\Exception\InvalidFileException $e ) {
 37 |             $this->writeErrorAndDie( $e );
 38 |         }
 39 |     }
 40 | 
 41 |     /**
 42 |      * Detect if a custom environment file matching the HYBRID_CORE_ENV exists.
 43 |      *
 44 |      * @param \Hybrid\Contracts\Core\Application $app
 45 |      * @return void
 46 |      */
 47 |     protected function checkForSpecificEnvironmentFile( $app ) {
 48 |         if ( $app->runningInConsole() &&
 49 |             ( $input = new ArgvInput() )->hasParameterOption( '--env' ) &&
 50 |             $this->setEnvironmentFilePath( $app, $app->environmentFile() . '.' . $input->getParameterOption( '--env' ) )
 51 |         ) {
 52 |             return;
 53 |         }
 54 | 
 55 |         $environment = Env::get( 'HYBRID_CORE_ENV' );
 56 | 
 57 |         if ( ! $environment ) {
 58 |             return;
 59 |         }
 60 | 
 61 |         $this->setEnvironmentFilePath(
 62 |             $app, $app->environmentFile() . '.' . $environment
 63 |         );
 64 |     }
 65 | 
 66 |     /**
 67 |      * Load a custom environment file.
 68 |      *
 69 |      * @param \Hybrid\Contracts\Core\Application $app
 70 |      * @param string                             $file
 71 |      * @return bool
 72 |      */
 73 |     protected function setEnvironmentFilePath( $app, $file ) {
 74 |         if ( is_file( $app->environmentPath() . '/' . $file ) ) {
 75 |             $app->loadEnvironmentFrom( $file );
 76 | 
 77 |             return true;
 78 |         }
 79 | 
 80 |         return false;
 81 |     }
 82 | 
 83 |     /**
 84 |      * Create a Dotenv instance.
 85 |      *
 86 |      * @param \Hybrid\Contracts\Core\Application $app
 87 |      * @return \Dotenv\Dotenv
 88 |      */
 89 |     protected function createDotenv( $app ) {
 90 |         return Dotenv::create(
 91 |             Env::getRepository(),
 92 |             $app->environmentPath(),
 93 |             $app->environmentFile()
 94 |         );
 95 |     }
 96 | 
 97 |     /**
 98 |      * Write the error information to the screen and exit.
 99 |      *
100 |      * @param \Dotenv\Exception\InvalidFileException $e
101 |      * @return never
102 |      */
103 |     protected function writeErrorAndDie( \Dotenv\Exception\InvalidFileException $e ) {
104 |         $output = ( new ConsoleOutput() )->getErrorOutput();
105 | 
106 |         $output->writeln( 'The environment file is invalid!' );
107 |         $output->writeln( $e->getMessage() );
108 | 
109 |         exit( 1 );
110 |     }
111 | 
112 | }
113 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/RegisterFacades.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core\Bootstrap;
 4 | 
 5 | use Hybrid\Contracts\Core\Application;
 6 | use Hybrid\Core\AliasLoader;
 7 | use Hybrid\Core\Facades\Facade;
 8 | use Hybrid\Core\PackageManifest;
 9 | 
10 | class RegisterFacades {
11 | 
12 |     /**
13 |      * Bootstrap the given application.
14 |      *
15 |      * @param \Hybrid\Contracts\Core\Application $app
16 |      * @return void
17 |      */
18 |     public function bootstrap( Application $app ) {
19 |         Facade::clearResolvedInstances();
20 | 
21 |         Facade::setFacadeApplication( $app );
22 | 
23 |         $aliases = $app->make( 'config' )->get( 'app.aliases', [] );
24 | 
25 |         // If the application configuration does not define any 'aliases' in `app.php`,
26 |         // Hybrid Core will be unable to use its default aliases.
27 |         // Therefore, we need to initialize the default aliases here.
28 |         if ( count( $aliases ) === 0 ) {
29 |             $aliases = Facade::defaultAliases()->merge( [] )->toArray();
30 |         }
31 | 
32 |         $aliases = array_merge(
33 |             $aliases,
34 |             $app->make( PackageManifest::class )->aliases()
35 |         );
36 | 
37 |         AliasLoader::getInstance( $aliases )->register();
38 |     }
39 | 
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Core/Bootstrap/RegisterProviders.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core\Bootstrap;
 4 | 
 5 | use Hybrid\Contracts\Core\Application;
 6 | use Hybrid\Core\ServiceProvider;
 7 | 
 8 | class RegisterProviders {
 9 | 
10 |     /**
11 |      * The service providers that should be merged before registration.
12 |      *
13 |      * @var array
14 |      */
15 |     protected static $merge = [];
16 | 
17 |     /**
18 |      * The path to the bootstrap provider configuration file.
19 |      *
20 |      * @var string|null
21 |      */
22 |     protected static $bootstrapProviderPath;
23 | 
24 |     /**
25 |      * Bootstrap the given application.
26 |      *
27 |      * @param \Hybrid\Contracts\Core\Application $app
28 |      * @return void
29 |      */
30 |     public function bootstrap( Application $app ) {
31 |         if ( ! $app->bound( 'config_loaded_from_cache' ) || $app->make( 'config_loaded_from_cache' ) === false ) {
32 |             $this->mergeAdditionalProviders( $app );
33 |         }
34 | 
35 |         $app->registerConfiguredProviders();
36 |     }
37 | 
38 |     /**
39 |      * Merge the additional configured providers into the configuration.
40 |      *
41 |      * @param \Hybrid\Contracts\Core\Application $app
42 |      */
43 |     protected function mergeAdditionalProviders( Application $app ) {
44 |         if ( static::$bootstrapProviderPath && file_exists( static::$bootstrapProviderPath ) ) {
45 |             $packageProviders = require static::$bootstrapProviderPath;
46 | 
47 |             foreach ( $packageProviders as $index => $provider ) {
48 |                 if ( ! class_exists( $provider ) ) {
49 |                     unset( $packageProviders[ $index ] );
50 |                 }
51 |             }
52 |         }
53 | 
54 |         $app->make( 'config' )->set(
55 |             'app.providers',
56 |             array_merge(
57 |                 $app->make( 'config' )->get( 'app.providers' ) ?? ServiceProvider::defaultProviders()->toArray(),
58 |                 static::$merge,
59 |                 array_values( $packageProviders ?? [] )
60 |             )
61 |         );
62 |     }
63 | 
64 |     /**
65 |      * Merge the given providers into the provider configuration before registration.
66 |      *
67 |      * @param array       $providers
68 |      * @param string|null $bootstrapProviderPath
69 |      * @return void
70 |      */
71 |     public static function merge( array $providers, ?string $bootstrapProviderPath = null ) {
72 |         static::$bootstrapProviderPath = $bootstrapProviderPath;
73 | 
74 |         static::$merge = array_values( array_filter( array_unique(
75 |             array_merge( static::$merge, $providers )
76 |         ) ) );
77 |     }
78 | 
79 |     /**
80 |      * Flush the bootstrapper's global state.
81 |      *
82 |      * @return void
83 |      */
84 |     public static function flushState() {
85 |         static::$bootstrapProviderPath = null;
86 | 
87 |         static::$merge = [];
88 |     }
89 | 
90 | }
91 | 


--------------------------------------------------------------------------------
/src/Core/Configuration/ApplicationBuilder.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Configuration;
  4 | 
  5 | use Hybrid\Core\Application;
  6 | use Hybrid\Core\Bootstrap\RegisterProviders;
  7 | use Hybrid\Events\Provider as AppEventServiceProvider;
  8 | 
  9 | class ApplicationBuilder {
 10 | 
 11 |     /**
 12 |      * The service provider that are marked for registration.
 13 |      */
 14 |     protected array $pendingProviders = [];
 15 | 
 16 |     /**
 17 |      * The Folio / page middleware that have been defined by the user.
 18 |      */
 19 |     protected array $pageMiddleware = [];
 20 | 
 21 |     /**
 22 |      * Create a new application builder instance.
 23 |      */
 24 |     public function __construct( protected Application $app ) {}
 25 | 
 26 |     /**
 27 |      * Register additional service providers.
 28 |      *
 29 |      * @param array $providers
 30 |      * @param bool  $withBootstrapProviders
 31 |      * @return $this
 32 |      */
 33 |     public function withProviders( array $providers = [], bool $withBootstrapProviders = true ) {
 34 |         RegisterProviders::merge(
 35 |             $providers,
 36 |             $withBootstrapProviders
 37 |                 ? $this->app->getBootstrapProvidersPath()
 38 |                 : null
 39 |         );
 40 | 
 41 |         return $this;
 42 |     }
 43 | 
 44 |     /**
 45 |      * Register the core event service provider for the application.
 46 |      *
 47 |      * @param array|bool $discover
 48 |      * @return $this
 49 |      */
 50 |     public function withEvents( array|bool $discover = [] ) {
 51 |         if ( is_array( $discover ) && count( $discover ) > 0 ) {
 52 |             AppEventServiceProvider::setEventDiscoveryPaths( $discover );
 53 |         }
 54 | 
 55 |         if ( false === $discover ) {
 56 |             AppEventServiceProvider::disableEventDiscovery();
 57 |         }
 58 | 
 59 |         if ( ! isset( $this->pendingProviders[ AppEventServiceProvider::class ] ) ) {
 60 |             $this->app->booting( function () {
 61 |                 $this->app->register( AppEventServiceProvider::class );
 62 |             } );
 63 |         }
 64 | 
 65 |         $this->pendingProviders[ AppEventServiceProvider::class ] = true;
 66 | 
 67 |         return $this;
 68 |     }
 69 | 
 70 |     /**
 71 |      * Register and configure the application's exception handler.
 72 |      *
 73 |      * @param callable|null $using
 74 |      * @return $this
 75 |      */
 76 |     public function withExceptions( ?callable $using = null ) {
 77 |         $this->app->singleton( \Hybrid\Contracts\Debug\ExceptionHandler::class, \Hybrid\Core\Exceptions\Handler::class );
 78 | 
 79 |         $using ??= static fn() => true;
 80 | 
 81 |         $this->app->afterResolving(
 82 |             \Hybrid\Core\Exceptions\Handler::class,
 83 |             static fn( $handler ) => $using( new Exceptions( $handler ) )
 84 |         );
 85 | 
 86 |         return $this;
 87 |     }
 88 | 
 89 |     /**
 90 |      * Register an array of container bindings to be bound when the application is booting.
 91 |      *
 92 |      * @param array $bindings
 93 |      * @return $this
 94 |      */
 95 |     public function withBindings( array $bindings ) {
 96 |         return $this->registered( static function ( $app ) use ( $bindings ) {
 97 |             foreach ( $bindings as $abstract => $concrete ) {
 98 |                 $app->bind( $abstract, $concrete );
 99 |             }
100 |         } );
101 |     }
102 | 
103 |     /**
104 |      * Register an array of singleton container bindings to be bound when the application is booting.
105 |      *
106 |      * @param array $singletons
107 |      * @return $this
108 |      */
109 |     public function withSingletons( array $singletons ) {
110 |         return $this->registered( static function ( $app ) use ( $singletons ) {
111 |             foreach ( $singletons as $abstract => $concrete ) {
112 |                 if ( is_string( $abstract ) ) {
113 |                     $app->singleton( $abstract, $concrete );
114 |                 } else {
115 |                     $app->singleton( $concrete );
116 |                 }
117 |             }
118 |         } );
119 |     }
120 | 
121 |     /**
122 |      * Register a callback to be invoked when the application's service providers are registered.
123 |      *
124 |      * @param callable $callback
125 |      * @return $this
126 |      */
127 |     public function registered( callable $callback ) {
128 |         $this->app->registered( $callback );
129 | 
130 |         return $this;
131 |     }
132 | 
133 |     /**
134 |      * Register a callback to be invoked when the application is "booting".
135 |      *
136 |      * @param callable $callback
137 |      * @return $this
138 |      */
139 |     public function booting( callable $callback ) {
140 |         $this->app->booting( $callback );
141 | 
142 |         return $this;
143 |     }
144 | 
145 |     /**
146 |      * Register a callback to be invoked when the application is "booted".
147 |      *
148 |      * @param callable $callback
149 |      * @return $this
150 |      */
151 |     public function booted( callable $callback ) {
152 |         $this->app->booted( $callback );
153 | 
154 |         return $this;
155 |     }
156 | 
157 |     /**
158 |      * Get the application instance.
159 |      *
160 |      * @return \Hybrid\Core\Application
161 |      */
162 |     public function create() {
163 |         return $this->app;
164 |     }
165 | 
166 | }
167 | 


--------------------------------------------------------------------------------
/src/Core/Configuration/Exceptions.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Configuration;
  4 | 
  5 | use Closure;
  6 | use Hybrid\Core\Exceptions\Handler;
  7 | use Hybrid\Tools\Arr;
  8 | 
  9 | class Exceptions {
 10 | 
 11 |     /**
 12 |      * Create a new exception handling configuration instance.
 13 |      *
 14 |      * @param \Hybrid\Core\Exceptions\Handler $handler
 15 |      * @return void
 16 |      */
 17 |     public function __construct( public Handler $handler ) {}
 18 | 
 19 |     /**
 20 |      * Register a reportable callback.
 21 |      *
 22 |      * @param callable $using
 23 |      * @return \Hybrid\Core\Exceptions\ReportableHandler
 24 |      */
 25 |     public function report( callable $using ) {
 26 |         return $this->handler->reportable( $using );
 27 |     }
 28 | 
 29 |     /**
 30 |      * Register a reportable callback.
 31 |      *
 32 |      * @param callable $reportUsing
 33 |      * @return \Hybrid\Core\Exceptions\ReportableHandler
 34 |      */
 35 |     public function reportable( callable $reportUsing ) {
 36 |         return $this->handler->reportable( $reportUsing );
 37 |     }
 38 | 
 39 |     /**
 40 |      * Register a renderable callback.
 41 |      *
 42 |      * @param callable $using
 43 |      * @return $this
 44 |      */
 45 |     public function render( callable $using ) {
 46 |         $this->handler->renderable( $using );
 47 | 
 48 |         return $this;
 49 |     }
 50 | 
 51 |     /**
 52 |      * Register a renderable callback.
 53 |      *
 54 |      * @param callable $renderUsing
 55 |      * @return $this
 56 |      */
 57 |     public function renderable( callable $renderUsing ) {
 58 |         $this->handler->renderable( $renderUsing );
 59 | 
 60 |         return $this;
 61 |     }
 62 | 
 63 |     /**
 64 |      * Register a callback to prepare the final, rendered exception response.
 65 |      *
 66 |      * @param callable $using
 67 |      * @return $this
 68 |      */
 69 |     public function respond( callable $using ) {
 70 |         $this->handler->respondUsing( $using );
 71 | 
 72 |         return $this;
 73 |     }
 74 | 
 75 |     /**
 76 |      * Specify the callback that should be used to throttle reportable exceptions.
 77 |      *
 78 |      * @param callable $throttleUsing
 79 |      * @return $this
 80 |      */
 81 |     public function throttle( callable $throttleUsing ) {
 82 |         $this->handler->throttleUsing( $throttleUsing );
 83 | 
 84 |         return $this;
 85 |     }
 86 | 
 87 |     /**
 88 |      * Register a new exception mapping.
 89 |      *
 90 |      * @param \Closure|string      $from
 91 |      * @param \Closure|string|null $to
 92 |      * @return $this
 93 |      * @throws \InvalidArgumentException
 94 |      */
 95 |     public function map( $from, $to = null ) {
 96 |         $this->handler->map( $from, $to );
 97 | 
 98 |         return $this;
 99 |     }
100 | 
101 |     /**
102 |      * Set the log level for the given exception type.
103 |      *
104 |      * @param class-string<\Throwable> $type
105 |      * @param \Psr\Log\LogLevel::*     $level
106 |      * @return $this
107 |      */
108 |     public function level( string $type, string $level ) {
109 |         $this->handler->level( $type, $level );
110 | 
111 |         return $this;
112 |     }
113 | 
114 |     /**
115 |      * Register a closure that should be used to build exception context data.
116 |      *
117 |      * @param \Closure $contextCallback
118 |      * @return $this
119 |      */
120 |     public function context( Closure $contextCallback ) {
121 |         $this->handler->buildContextUsing( $contextCallback );
122 | 
123 |         return $this;
124 |     }
125 | 
126 |     /**
127 |      * Indicate that the given exception type should not be reported.
128 |      *
129 |      * @param array|string $class
130 |      * @return $this
131 |      */
132 |     public function dontReport( array|string $class ) {
133 |         foreach ( Arr::wrap( $class ) as $exceptionClass ) {
134 |             $this->handler->dontReport( $exceptionClass );
135 |         }
136 | 
137 |         return $this;
138 |     }
139 | 
140 |     /**
141 |      * Do not report duplicate exceptions.
142 |      *
143 |      * @return $this
144 |      */
145 |     public function dontReportDuplicates() {
146 |         $this->handler->dontReportDuplicates();
147 | 
148 |         return $this;
149 |     }
150 | 
151 |     /**
152 |      * Indicate that the given attributes should never be flashed to the session on validation errors.
153 |      *
154 |      * @param array|string $attributes
155 |      * @return $this
156 |      */
157 |     public function dontFlash( array|string $attributes ) {
158 |         $this->handler->dontFlash( $attributes );
159 | 
160 |         return $this;
161 |     }
162 | 
163 |     /**
164 |      * Register the callable that determines if the exception handler response should be JSON.
165 |      *
166 |      * @param callable(\Hybrid\Http\Request $request, \Throwable): bool $callback
167 |      * @return $this
168 |      */
169 |     public function shouldRenderJsonWhen( callable $callback ) {
170 |         $this->handler->shouldRenderJsonWhen( $callback );
171 | 
172 |         return $this;
173 |     }
174 | 
175 |     /**
176 |      * Indicate that the given exception class should not be ignored.
177 |      *
178 |      * @param array<int, class-string<\Throwable>>|class-string<\Throwable> $class
179 |      * @return $this
180 |      */
181 |     public function stopIgnoring( array|string $class ) {
182 |         $this->handler->stopIgnoring( $class );
183 | 
184 |         return $this;
185 |     }
186 | 
187 | }
188 | 


--------------------------------------------------------------------------------
/src/Core/DefaultProviders.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core;
 4 | 
 5 | use function Hybrid\Tools\collect;
 6 | 
 7 | class DefaultProviders {
 8 | 
 9 |     /**
10 |      * The current providers.
11 |      *
12 |      * @var array
13 |      */
14 |     protected $providers;
15 | 
16 |     /**
17 |      * Create a new default provider collection.
18 |      *
19 |      * @return void
20 |      */
21 |     public function __construct( ?array $providers = null ) {
22 |         $this->providers = $providers ?: [
23 |             // \Hybrid\Filesystem\FilesystemServiceProvider::class,
24 |             // \Hybrid\Core\Providers\CoreServiceProvider::class,
25 |             // \Hybrid\View\Provider::class,
26 |         ];
27 |     }
28 | 
29 |     /**
30 |      * Merge the given providers into the provider collection.
31 |      *
32 |      * @return static
33 |      */
34 |     public function merge( array $providers ) {
35 |         $this->providers = array_merge( $this->providers, $providers );
36 | 
37 |         return new static( $this->providers );
38 |     }
39 | 
40 |     /**
41 |      * Replace the given providers with other providers.
42 |      *
43 |      * @param array $replacements
44 |      * @return static
45 |      */
46 |     public function replace( array $replacements ) {
47 |         $current = collect( $this->providers );
48 | 
49 |         foreach ( $replacements as $from => $to ) {
50 |             $key = $current->search( $from );
51 | 
52 |             $current = is_int( $key ) ? $current->replace( [ $key => $to ] ) : $current;
53 |         }
54 | 
55 |         return new static( $current->values()->toArray() );
56 |     }
57 | 
58 |     /**
59 |      * Disable the given providers.
60 |      *
61 |      * @return static
62 |      */
63 |     public function except( array $providers ) {
64 |         return new static( collect( $this->providers )
65 |             ->reject( static fn( $p ) => in_array( $p, $providers ) )
66 |             ->values()
67 |             ->toArray() );
68 |     }
69 | 
70 |     /**
71 |      * Convert the provider collection to an array.
72 |      *
73 |      * @return array
74 |      */
75 |     public function toArray() {
76 |         return $this->providers;
77 |     }
78 | 
79 | }
80 | 


--------------------------------------------------------------------------------
/src/Core/EnvironmentDetector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core;
 4 | 
 5 | use Closure;
 6 | 
 7 | class EnvironmentDetector {
 8 | 
 9 |     /**
10 |      * Detect the application's current environment.
11 |      *
12 |      * @param \Closure   $callback
13 |      * @param array|null $consoleArgs
14 |      * @return string
15 |      */
16 |     public function detect( Closure $callback, $consoleArgs = null ) {
17 |         if ( $consoleArgs ) {
18 |             return $this->detectConsoleEnvironment( $callback, $consoleArgs );
19 |         }
20 | 
21 |         return $this->detectWebEnvironment( $callback );
22 |     }
23 | 
24 |     /**
25 |      * Set the application environment for a web request.
26 |      *
27 |      * @param \Closure $callback
28 |      * @return string
29 |      */
30 |     protected function detectWebEnvironment( Closure $callback ) {
31 |         return $callback();
32 |     }
33 | 
34 |     /**
35 |      * Set the application environment from command-line arguments.
36 |      *
37 |      * @param array $args
38 |      * @return string
39 |      */
40 |     protected function detectConsoleEnvironment( Closure $callback, array $args ) {
41 |         // First we will check if an environment argument was passed via console arguments
42 |         // and if it was that automatically overrides as the environment. Otherwise, we
43 |         // will check the environment as a "web" request like a typical HTTP request.
44 |         if ( ! is_null( $value = $this->getEnvironmentArgument( $args ) ) ) {
45 |             return $value;
46 |         }
47 | 
48 |         return $this->detectWebEnvironment( $callback );
49 |     }
50 | 
51 |     /**
52 |      * Get the environment argument from the console.
53 |      *
54 |      * @param array $args
55 |      * @return string|null
56 |      */
57 |     protected function getEnvironmentArgument( array $args ) {
58 |         foreach ( $args as $i => $value ) {
59 |             if ( '--env' === $value ) {
60 |                 return $args[ $i + 1 ] ?? null;
61 |             }
62 | 
63 |             if ( str_starts_with( $value, '--env' ) ) {
64 |                 return head( array_slice( explode( '=', $value ), 1 ) );
65 |             }
66 |         }
67 |     }
68 | 
69 | }
70 | 


--------------------------------------------------------------------------------
/src/Core/Facades/App.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Facades;
  4 | 
  5 | /**
  6 |  * @see \Hybrid\Contracts\Core\Application
  7 |  * @phpcsSuppress SlevomatCodingStandard.TypeHints.DisallowMixedTypeHint.DisallowedMixedTypeHint
  8 |  *
  9 |  * @method static \Hybrid\Core\Configuration\ApplicationBuilder configure(string|null $basePath = null)
 10 |  * @method static string inferBasePath()
 11 |  * @method static \Hybrid\Core\Application loadEnvironmentFrom(string $file)
 12 |  * @method static \Hybrid\Core\ServiceProvider register(\Hybrid\Core\ServiceProvider|string $provider, bool $force = false)
 13 |  * @method static \Hybrid\Core\ServiceProvider|null getProvider(\Hybrid\Core\ServiceProvider|string $provider)
 14 |  * @method static \Hybrid\Core\ServiceProvider resolveProvider(string $provider)
 15 |  * @method static array getProviders(\Hybrid\Core\ServiceProvider|string $provider)
 16 |  * @method static mixed make($abstract, array $parameters = [])
 17 |  * @method static bool bound(string $abstract)
 18 |  * @method static mixed makeWith(string|callable $abstract, array $parameters = [])
 19 |  * @method static mixed get(string $id)
 20 |  * @method static mixed build(\Closure|string $concrete)
 21 |  * @method static void resolving(\Closure|string $abstract, \Closure|null $callback = null)
 22 |  * @method static void beforeResolving(\Closure|string $abstract, \Closure|null $callback = null)
 23 |  * @method static void afterResolving(\Closure|string $abstract, \Closure|null $callback = null)
 24 |  * @method static void afterResolvingAttribute(string $attribute, \Closure $callback)
 25 |  * @method static array getBindings()
 26 |  * @method static string getAlias(string $abstract)
 27 |  * @method static void forgetExtenders(string $abstract)
 28 |  * @method static bool configurationIsCached()
 29 |  * @method static void afterLoadingEnvironment(\Closure $callback)
 30 |  * @method static void beforeBootstrapping(string $bootstrapper, \Closure $callback)
 31 |  * @method static void afterBootstrapping(string $bootstrapper, \Closure $callback)
 32 |  * @method static bool hasBeenBootstrapped()
 33 |  * @method static \Hybrid\Core\Application setBasePath(string $basePath)
 34 |  * @method static string path(string $path = '')
 35 |  * @method static \Hybrid\Core\Application useAppPath(string $path)
 36 |  * @method static bool isLocal()
 37 |  * @method static bool isProduction()
 38 |  * @method static string basePath(string $path = '')
 39 |  * @method static string bootstrapPath(string $path = '')
 40 |  * @method static string getBootstrapProvidersPath()
 41 |  * @method static \Hybrid\Core\Application useBootstrapPath(string $path)
 42 |  * @method static string configPath(string $path = '')
 43 |  * @method static \Hybrid\Core\Application useConfigPath(string $path)
 44 |  * @method static \Hybrid\Core\Application usePublicPath(string $path)
 45 |  * @method static string detectEnvironment(\Closure $callback)
 46 |  * @method static bool runningInConsole()
 47 |  * @method static bool runningConsoleCommand(string|array ...$commands)
 48 |  * @method static bool runningUnitTests()
 49 |  * @method static bool hasDebugModeEnabled()
 50 |  * @method static void registered(callable $callback)
 51 |  * @method static string environmentFile()
 52 |  * @method static string environmentFilePath()
 53 |  * @method static string environmentPath()
 54 |  * @method static \Hybrid\Core\Application useEnvironmentPath(string $path)
 55 |  * @method static void forgetInstance(string $abstract)
 56 |  * @method static void forgetInstances()
 57 |  * @method static void forgetScopedInstances()
 58 |  * @method static \Hybrid\Core\Application getInstance()
 59 |  * @method static \Hybrid\Contracts\Container\Container|\Hybrid\Core\Application setInstance(\Hybrid\Contracts\Container\Container|null $container = null)
 60 |  * @method static string getCachedConfigPath()
 61 |  * @method static string getCachedPackagesPath()
 62 |  * @method static string getCachedRoutesPath()
 63 |  * @method static string getCachedServicesPath()
 64 |  * @method static bool eventsAreCached()
 65 |  * @method static string getCachedEventsPath()
 66 |  * @method static \Hybrid\Core\Application addAbsoluteCachePathPrefix(string $prefix)
 67 |  * @method static \Hybrid\Core\Application terminating(callable|string $callback)
 68 |  * @method static void terminate()
 69 |  * @method static array getLoadedProviders()
 70 |  * @method static bool providerIsLoaded(string $provider)
 71 |  * @method static void setDeferredServices(array $services)
 72 |  * @method static void addDeferredServices(array $services)
 73 |  * @method static bool isDeferredService(string $service)
 74 |  * @method static void provideFacades(string $namespace)
 75 |  * @method static void registerCoreContainerAliases()
 76 |  * @method static array getDeferredServices()
 77 |  * @method static void flush()
 78 |  * @method static string getNamespace()
 79 |  * @method static \Hybrid\Contracts\Container\ContextualBindingBuilder when(array|string $concrete)
 80 |  * @method static bool has(string $id)
 81 |  * @method static void whenHasAttribute(string $attribute, \Closure $handler)
 82 |  * @method static bool isShared(string $abstract)
 83 |  * @method static bool isAlias(string $name)
 84 |  * @method static void bind(string $abstract, \Closure|string|null $concrete = null, bool $shared = false)
 85 |  * @method static bool hasMethodBinding(string $method)
 86 |  * @method static void bindMethod(array|string $method, \Closure $callback)
 87 |  * @method static mixed callMethodBinding(string $method, mixed $instance)
 88 |  * @method static void addContextualBinding(string $concrete, string $abstract, \Closure|string $implementation)
 89 |  * @method static void bindIf(string $abstract, \Closure|string|null $concrete = null, bool $shared = false)
 90 |  * @method static void singleton(string $abstract, \Closure|string|null $concrete = null)
 91 |  * @method static void singletonIf(string $abstract, \Closure|string|null $concrete = null)
 92 |  * @method static void scoped(string $abstract, \Closure|string|null $concrete = null)
 93 |  * @method static void scopedIf(string $abstract, \Closure|string|null $concrete = null)
 94 |  * @method static void extend(string $abstract, \Closure $closure)
 95 |  * @method static mixed instance(string $abstract, mixed $instance)
 96 |  * @method static void tag(array|string $abstracts, array|mixed $tags)
 97 |  * @method static iterable tagged(string $tag)
 98 |  * @method static void alias(string $abstract, string $alias)
 99 |  * @method static mixed rebinding(string $abstract, \Closure $callback)
100 |  * @method static mixed refresh(string $abstract, mixed $target, string $method)
101 |  * @method static \Closure wrap(\Closure $callback, array $parameters = [])
102 |  * @method static mixed call(callable|string $callback, array $parameters = [], string|null $defaultMethod = null)
103 |  * @method static \Closure factory(string $abstract)
104 |  * @method static string resourcePath(string $path = '')
105 |  * @method static string storagePath(string $path = '')
106 |  * @method static \Hybrid\Core\Application useStoragePath(string $path)
107 |  * @method static \Hybrid\Core\Application useResourcePath(string $path)
108 |  * @method static string viewPath(string $path = '')
109 |  * @method static string joinPaths(string $basePath, string $path = '')
110 |  * @method static string version()
111 |  * @method static string|bool environment(string|array ...$environments)
112 |  * @method static bool isBooted()
113 |  * @method static void boot()
114 |  * @method static void booted(callable $callback)
115 |  * @method static void booting(callable $callback)
116 |  * @method static void bootstrapWith(array<string> $bootstrappers)
117 |  * @method static void loadDeferredProviders()
118 |  * @method static void loadDeferredProvider(string $service)
119 |  * @method static void registerConfiguredProviders()
120 |  * @method static void registerDeferredProvider(string $provider, string $service = null)
121 |  * @method static void macro(string $name, object|callable $macro, object|callable $macro = null)
122 |  * @method static void mixin(object $mixin, bool $replace = true)
123 |  * @method static bool hasMacro(string $name)
124 |  * @method static void flushMacros()
125 |  * @method static int handleCommand(\Symfony\Component\Console\Input\InputInterface $input)
126 |  * @method static bool shouldMergeFrameworkConfiguration()
127 |  * @method static \Hybrid\Core\Application dontMergeFrameworkConfiguration()
128 |  */
129 | class App extends Facade {
130 | 
131 |     /**
132 |      * Get the registered name of the component.
133 |      *
134 |      * @return string
135 |      */
136 |     protected static function getFacadeAccessor() {
137 |         return 'app';
138 |     }
139 | 
140 | }
141 | 


--------------------------------------------------------------------------------
/src/Core/Facades/Facade.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core\Facades;
  4 | 
  5 | use Closure;
  6 | use function Hybrid\Tools\collect;
  7 | 
  8 | abstract class Facade {
  9 | 
 10 |     /**
 11 |      * The application instance being facaded.
 12 |      *
 13 |      * @var \Hybrid\Contracts\Core\Application|null
 14 |      */
 15 |     protected static $app;
 16 | 
 17 |     /**
 18 |      * The resolved object instances.
 19 |      *
 20 |      * @var array
 21 |      */
 22 |     protected static $resolvedInstance;
 23 | 
 24 |     /**
 25 |      * Indicates if the resolved instance should be cached.
 26 |      *
 27 |      * @var bool
 28 |      */
 29 |     protected static $cached = true;
 30 | 
 31 |     /**
 32 |      * Run a Closure when the facade has been resolved.
 33 |      *
 34 |      * @return void
 35 |      */
 36 |     public static function resolved( Closure $callback ) {
 37 |         $accessor = static::getFacadeAccessor();
 38 | 
 39 |         if ( true === static::$app->resolved( $accessor ) ) {
 40 |             $callback( static::getFacadeRoot(), static::$app );
 41 |         }
 42 | 
 43 |         static::$app->afterResolving( $accessor, static function ( $service, $app ) use ( $callback ) {
 44 |             $callback( $service, $app );
 45 |         } );
 46 |     }
 47 | 
 48 |     /**
 49 |      * Hotswap the underlying instance behind the facade.
 50 |      *
 51 |      * @param mixed $instance
 52 |      * @return void
 53 |      */
 54 |     public static function swap( $instance ) {
 55 |         static::$resolvedInstance[ static::getFacadeAccessor() ] = $instance;
 56 | 
 57 |         if ( isset( static::$app ) ) {
 58 |             static::$app->instance( static::getFacadeAccessor(), $instance );
 59 |         }
 60 |     }
 61 | 
 62 |     /**
 63 |      * Get the root object behind the facade.
 64 |      *
 65 |      * @return mixed
 66 |      */
 67 |     public static function getFacadeRoot() {
 68 |         return static::resolveFacadeInstance( static::getFacadeAccessor() );
 69 |     }
 70 | 
 71 |     /**
 72 |      * Get the registered name of the component.
 73 |      *
 74 |      * @return string
 75 |      * @throws \RuntimeException
 76 |      */
 77 |     protected static function getFacadeAccessor() {
 78 |         throw new \RuntimeException( 'Facade does not implement getFacadeAccessor method.' );
 79 |     }
 80 | 
 81 |     /**
 82 |      * Resolve the facade root instance from the container.
 83 |      *
 84 |      * @param string $name
 85 |      * @return mixed
 86 |      */
 87 |     protected static function resolveFacadeInstance( $name ) {
 88 |         if ( isset( static::$resolvedInstance[ $name ] ) ) {
 89 |             return static::$resolvedInstance[ $name ];
 90 |         }
 91 | 
 92 |         if ( static::$app ) {
 93 |             if ( static::$cached ) {
 94 |                 return static::$resolvedInstance[ $name ] = static::$app[ $name ];
 95 |             }
 96 | 
 97 |             return static::$app[ $name ];
 98 |         }
 99 |     }
100 | 
101 |     /**
102 |      * Clear a resolved facade instance.
103 |      *
104 |      * @param string $name
105 |      * @return void
106 |      */
107 |     public static function clearResolvedInstance( $name ) {
108 |         unset( static::$resolvedInstance[ $name ] );
109 |     }
110 | 
111 |     /**
112 |      * Clear all of the resolved instances.
113 |      *
114 |      * @return void
115 |      */
116 |     public static function clearResolvedInstances() {
117 |         static::$resolvedInstance = [];
118 |     }
119 | 
120 |     /**
121 |      * Get the application default aliases.
122 |      *
123 |      * @return \Hybrid\Tools\Collection
124 |      */
125 |     public static function defaultAliases() {
126 |         return collect( [
127 |             'Hybrid\App' => App::class,
128 |         ] );
129 |     }
130 | 
131 |     /**
132 |      * Get the application instance behind the facade.
133 |      *
134 |      * @return \Hybrid\Contracts\Core\Application|null
135 |      */
136 |     public static function getFacadeApplication() {
137 |         return static::$app;
138 |     }
139 | 
140 |     /**
141 |      * Set the application instance.
142 |      *
143 |      * @param \Hybrid\Contracts\Core\Application|null $app
144 |      * @return void
145 |      */
146 |     public static function setFacadeApplication( $app ) {
147 |         static::$app = $app;
148 |     }
149 | 
150 |     /**
151 |      * Handle dynamic, static calls to the object.
152 |      *
153 |      * @param string $method
154 |      * @param array  $args
155 |      * @return mixed
156 |      * @throws \RuntimeException
157 |      */
158 |     public static function __callStatic( $method, $args ) {
159 |         $instance = static::getFacadeRoot();
160 | 
161 |         if ( ! $instance ) {
162 |             throw new \RuntimeException( 'A facade root has not been set.' );
163 |         }
164 | 
165 |         return $instance->$method( ...$args );
166 |     }
167 | 
168 | }
169 | 


--------------------------------------------------------------------------------
/src/Core/Mix.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core;
 4 | 
 5 | use Hybrid\Tools\HtmlString;
 6 | use Hybrid\Tools\Str;
 7 | use function Hybrid\app;
 8 | use function Hybrid\public_path;
 9 | 
10 | class Mix {
11 | 
12 |     /**
13 |      * Get the path to a versioned Mix file.
14 |      *
15 |      * @param string $path
16 |      * @param string $manifestDirectory
17 |      * @return \Hybrid\Tools\HtmlString|string
18 |      * @throws \Hybrid\Core\MixManifestNotFoundException
19 |      */
20 |     public function __invoke( $path, $manifestDirectory = '' ) {
21 |         static $manifests = [];
22 | 
23 |         if ( ! str_starts_with( $path, '/' ) ) {
24 |             $path = "/{$path}";
25 |         }
26 | 
27 |         if ( $manifestDirectory && ! str_starts_with( $manifestDirectory, '/' ) ) {
28 |             $manifestDirectory = "/{$manifestDirectory}";
29 |         }
30 | 
31 |         if ( is_file( public_path( $manifestDirectory . '/hot' ) ) ) {
32 |             $url = rtrim( file_get_contents( public_path( $manifestDirectory . '/hot' ) ) );
33 | 
34 |             $customUrl = app( 'config' )->get( 'app.mix_hot_proxy_url' );
35 | 
36 |             if ( ! empty( $customUrl ) ) {
37 |                 return new HtmlString( "{$customUrl}{$path}" );
38 |             }
39 | 
40 |             if ( Str::startsWith( $url, [ 'http://', 'https://' ] ) ) {
41 |                 return new HtmlString( Str::after( $url, ':' ) . $path );
42 |             }
43 | 
44 |             return new HtmlString( "//localhost:8080{$path}" );
45 |         }
46 | 
47 |         $manifestPath = public_path( $manifestDirectory . '/mix-manifest.json' );
48 | 
49 |         if ( ! isset( $manifests[ $manifestPath ] ) ) {
50 |             if ( ! is_file( $manifestPath ) ) {
51 |                 throw new \Hybrid\Core\MixManifestNotFoundException( "Mix manifest not found at: {$manifestPath}" );
52 |             }
53 | 
54 |             $manifests[ $manifestPath ] = json_decode( file_get_contents( $manifestPath ), true );
55 |         }
56 | 
57 |         $manifest = $manifests[ $manifestPath ];
58 | 
59 |         if ( ! isset( $manifest[ $path ] ) ) {
60 |             $exception = new \Exception( "Unable to locate Mix file: {$path}." );
61 | 
62 |             if ( ! app( 'config' )->get( 'app.debug' ) ) {
63 |                 report( $exception );
64 | 
65 |                 return $path;
66 |             }
67 | 
68 |             throw $exception;
69 |         }
70 | 
71 |         return new HtmlString( app( 'config' )->get( 'app.mix_url' ) . $manifestDirectory . $manifest[ $path ] );
72 |     }
73 | 
74 | }
75 | 


--------------------------------------------------------------------------------
/src/Core/MixManifestNotFoundException.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Hybrid\Core;
4 | 
5 | class MixManifestNotFoundException extends \Exception {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/src/Core/PackageManifest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core;
  4 | 
  5 | use Hybrid\Filesystem\Filesystem;
  6 | use Hybrid\Tools\Env;
  7 | use function Hybrid\Tools\collect;
  8 | 
  9 | class PackageManifest {
 10 | 
 11 |     /**
 12 |      * The filesystem instance.
 13 |      *
 14 |      * @var \Hybrid\Filesystem\Filesystem
 15 |      */
 16 |     public $files;
 17 | 
 18 |     /**
 19 |      * The base path.
 20 |      *
 21 |      * @var string
 22 |      */
 23 |     public $basePath;
 24 | 
 25 |     /**
 26 |      * The vendor path.
 27 |      *
 28 |      * @var string
 29 |      */
 30 |     public $vendorPath;
 31 | 
 32 |     /**
 33 |      * The manifest path.
 34 |      *
 35 |      * @var string|null
 36 |      */
 37 |     public $manifestPath;
 38 | 
 39 |     /**
 40 |      * The loaded manifest array.
 41 |      *
 42 |      * @var array
 43 |      */
 44 |     public $manifest;
 45 | 
 46 |     /**
 47 |      * Create a new package manifest instance.
 48 |      *
 49 |      * @param \Hybrid\Filesystem\Filesystem $files
 50 |      * @param string                        $basePath
 51 |      * @param string                        $manifestPath
 52 |      * @return void
 53 |      */
 54 |     public function __construct( Filesystem $files, $basePath, $manifestPath ) {
 55 |         $this->files        = $files;
 56 |         $this->basePath     = $basePath;
 57 |         $this->manifestPath = $manifestPath;
 58 |         $this->vendorPath   = Env::get( 'COMPOSER_VENDOR_DIR' ) ?: $basePath . '/vendor';
 59 |     }
 60 | 
 61 |     /**
 62 |      * Get all of the service provider class names for all packages.
 63 |      *
 64 |      * @return array
 65 |      */
 66 |     public function providers() {
 67 |         return $this->config( 'providers' );
 68 |     }
 69 | 
 70 |     /**
 71 |      * Get all of the aliases for all packages.
 72 |      *
 73 |      * @return array
 74 |      */
 75 |     public function aliases() {
 76 |         return $this->config( 'aliases' );
 77 |     }
 78 | 
 79 |     /**
 80 |      * Get all of the values for all packages for the given configuration name.
 81 |      *
 82 |      * @param string $key
 83 |      * @return array
 84 |      */
 85 |     public function config( $key ) {
 86 |         return collect( $this->getManifest() )->flatMap( static fn( $configuration ) => (array) ( $configuration[ $key ] ?? [] ) )->filter()->all();
 87 |     }
 88 | 
 89 |     /**
 90 |      * Get the current package manifest.
 91 |      *
 92 |      * @return array
 93 |      */
 94 |     protected function getManifest() {
 95 |         if ( ! is_null( $this->manifest ) ) {
 96 |             return $this->manifest;
 97 |         }
 98 | 
 99 |         if ( ! is_file( $this->manifestPath ) ) {
100 |             $this->build();
101 |         }
102 | 
103 |         return $this->manifest = is_file( $this->manifestPath )
104 |             ? $this->files->getRequire( $this->manifestPath )
105 |             : [];
106 |     }
107 | 
108 |     /**
109 |      * Build the manifest and write it to disk.
110 |      *
111 |      * @return void
112 |      */
113 |     public function build() {
114 |         $packages = [];
115 | 
116 |         if ( $this->files->exists( $path = $this->vendorPath . '/composer/installed.json' ) ) {
117 |             $installed = json_decode( $this->files->get( $path ), true );
118 | 
119 |             $packages = $installed['packages'] ?? $installed;
120 |         }
121 | 
122 |         $ignoreAll = in_array( '*', $ignore = $this->packagesToIgnore() );
123 | 
124 |         $this->write( collect( $packages )->mapWithKeys( fn( $package ) => [ $this->format( $package['name'] ) => $package['extra']['hybrid-core'] ?? [] ] )->each( static function ( $configuration ) use ( &$ignore ) {
125 |             $ignore = array_merge( $ignore, $configuration['dont-discover'] ?? [] );
126 |         } )->reject( static fn( $configuration, $package ) => $ignoreAll || in_array( $package, $ignore ) )->filter()->all() );
127 |     }
128 | 
129 |     /**
130 |      * Format the given package name.
131 |      *
132 |      * @param string $package
133 |      * @return string
134 |      */
135 |     protected function format( $package ) {
136 |         return str_replace( $this->vendorPath . '/', '', $package );
137 |     }
138 | 
139 |     /**
140 |      * Get all of the package names that should be ignored.
141 |      *
142 |      * @return array
143 |      */
144 |     protected function packagesToIgnore() {
145 |         if ( ! is_file( $this->basePath . '/composer.json' ) ) {
146 |             return [];
147 |         }
148 | 
149 |         return json_decode( file_get_contents(
150 |             $this->basePath . '/composer.json'
151 |         ), true )['extra']['hybrid-core']['dont-discover'] ?? [];
152 |     }
153 | 
154 |     /**
155 |      * Write the given manifest array to disk.
156 |      *
157 |      * @param array $manifest
158 |      * @return void
159 |      * @throws \Exception
160 |      */
161 |     protected function write( array $manifest ) {
162 |         if ( ! is_writable( $dirname = dirname( $this->manifestPath ) ) ) {
163 |             throw new \Exception( "The {$dirname} directory must be present and writable." );
164 |         }
165 | 
166 |         $this->files->replace(
167 |             $this->manifestPath, '<?php return ' . var_export( $manifest, true ) . ';'
168 |         );
169 |     }
170 | 
171 | }
172 | 


--------------------------------------------------------------------------------
/src/Core/ProviderRepository.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Hybrid\Core;
  4 | 
  5 | use Hybrid\Contracts\Core\Application as ApplicationContract;
  6 | use Hybrid\Filesystem\Filesystem;
  7 | 
  8 | class ProviderRepository {
  9 | 
 10 |     /**
 11 |      * The application implementation.
 12 |      *
 13 |      * @var \Hybrid\Contracts\Core\Application
 14 |      */
 15 |     protected $app;
 16 | 
 17 |     /**
 18 |      * The filesystem instance.
 19 |      *
 20 |      * @var \Hybrid\Filesystem\Filesystem
 21 |      */
 22 |     protected $files;
 23 | 
 24 |     /**
 25 |      * The path to the manifest file.
 26 |      *
 27 |      * @var string
 28 |      */
 29 |     protected $manifestPath;
 30 | 
 31 |     /**
 32 |      * Create a new service repository instance.
 33 |      *
 34 |      * @param \Hybrid\Contracts\Core\Application $app
 35 |      * @param \Hybrid\Filesystem\Filesystem      $files
 36 |      * @param string                             $manifestPath
 37 |      * @return void
 38 |      */
 39 |     public function __construct( ApplicationContract $app, Filesystem $files, $manifestPath ) {
 40 |         $this->app          = $app;
 41 |         $this->files        = $files;
 42 |         $this->manifestPath = $manifestPath;
 43 |     }
 44 | 
 45 |     /**
 46 |      * Register the application service providers.
 47 |      *
 48 |      * @param array $providers
 49 |      * @return void
 50 |      */
 51 |     public function load( array $providers ) {
 52 |         $manifest = $this->loadManifest();
 53 | 
 54 |         // First we will load the service manifest, which contains information on all
 55 |         // service providers registered with the application and which services it
 56 |         // provides. This is used to know which services are "deferred" loaders.
 57 |         if ( $this->shouldRecompile( $manifest, $providers ) ) {
 58 |             $manifest = $this->compileManifest( $providers );
 59 |         }
 60 | 
 61 |         // Next, we will register events to load the providers for each of the events
 62 |         // that it has requested. This allows the service provider to defer itself
 63 |         // while still getting automatically loaded when a certain event occurs.
 64 |         foreach ( $manifest['when'] as $provider => $events ) {
 65 |             $this->registerLoadEvents( $provider, $events );
 66 |         }
 67 | 
 68 |         // We will go ahead and register all of the eagerly loaded providers with the
 69 |         // application so their services can be registered with the application as
 70 |         // a provided service. Then we will set the deferred service list on it.
 71 |         foreach ( $manifest['eager'] as $provider ) {
 72 |             $this->app->register( $provider );
 73 |         }
 74 | 
 75 |         $this->app->addDeferredServices( $manifest['deferred'] );
 76 |     }
 77 | 
 78 |     /**
 79 |      * Load the service provider manifest JSON file.
 80 |      *
 81 |      * @return array|null
 82 |      */
 83 |     public function loadManifest() {
 84 |         // The service manifest is a file containing a JSON representation of every
 85 |         // service provided by the application and whether its provider is using
 86 |         // deferred loading or should be eagerly loaded on each request to us.
 87 |         if ( $this->files->exists( $this->manifestPath ) ) {
 88 |             $manifest = $this->files->getRequire( $this->manifestPath );
 89 | 
 90 |             if ( $manifest ) {
 91 |                 return array_merge( [ 'when' => [] ], $manifest );
 92 |             }
 93 |         }
 94 |     }
 95 | 
 96 |     /**
 97 |      * Determine if the manifest should be compiled.
 98 |      *
 99 |      * @param array $manifest
100 |      * @param array $providers
101 |      * @return bool
102 |      */
103 |     public function shouldRecompile( $manifest, $providers ) {
104 |         return is_null( $manifest ) || $manifest['providers'] != $providers;
105 |     }
106 | 
107 |     /**
108 |      * Register the load events for the given provider.
109 |      *
110 |      * @param string $provider
111 |      * @param array  $events
112 |      * @return void
113 |      */
114 |     protected function registerLoadEvents( $provider, array $events ) {
115 |         if ( count( $events ) < 1 ) {
116 |             return;
117 |         }
118 | 
119 |         $this->app->make( 'events' )->listen( $events, function () use ( $provider ) {
120 |             $this->app->register( $provider );
121 |         } );
122 |     }
123 | 
124 |     /**
125 |      * Compile the application service manifest file.
126 |      *
127 |      * @param array $providers
128 |      * @return array
129 |      */
130 |     protected function compileManifest( $providers ) {
131 |         // The service manifest should contain a list of all of the providers for
132 |         // the application so we can compare it on each request to the service
133 |         // and determine if the manifest should be recompiled or is current.
134 |         $manifest = $this->freshManifest( $providers );
135 | 
136 |         foreach ( $providers as $provider ) {
137 |             $instance = $this->createProvider( $provider );
138 | 
139 |             // When recompiling the service manifest, we will spin through each of the
140 |             // providers and check if it's a deferred provider or not. If so we'll
141 |             // add it's provided services to the manifest and note the provider.
142 |             if ( $instance->isDeferred() ) {
143 |                 foreach ( $instance->provides() as $service ) {
144 |                     $manifest['deferred'][ $service ] = $provider;
145 |                 }
146 | 
147 |                 $manifest['when'][ $provider ] = $instance->when();
148 |             }
149 | 
150 |             // If the service providers are not deferred, we will simply add it to an
151 |             // array of eagerly loaded providers that will get registered on every
152 |             // request to this application instead of "lazy" loading every time.
153 |             else {
154 |                 $manifest['eager'][] = $provider;
155 |             }
156 |         }
157 | 
158 |         return $this->writeManifest( $manifest );
159 |     }
160 | 
161 |     /**
162 |      * Create a fresh service manifest data structure.
163 |      *
164 |      * @param array $providers
165 |      * @return array
166 |      */
167 |     protected function freshManifest( array $providers ) {
168 |         return [
169 |             'deferred'  => [],
170 |             'eager'     => [],
171 |             'providers' => $providers,
172 |         ];
173 |     }
174 | 
175 |     /**
176 |      * Write the service manifest file to disk.
177 |      *
178 |      * @param array $manifest
179 |      * @return array
180 |      * @throws \Exception
181 |      */
182 |     public function writeManifest( $manifest ) {
183 |         if ( ! is_writable( $dirname = dirname( $this->manifestPath ) ) ) {
184 |             throw new \Exception( "The {$dirname} directory must be present and writable." );
185 |         }
186 | 
187 |         $this->files->replace(
188 |             $this->manifestPath, '<?php return ' . var_export( $manifest, true ) . ';'
189 |         );
190 | 
191 |         return array_merge( [ 'when' => [] ], $manifest );
192 |     }
193 | 
194 |     /**
195 |      * Create a new provider instance.
196 |      *
197 |      * @param string $provider
198 |      * @return \Hybrid\Core\ServiceProvider
199 |      */
200 |     public function createProvider( $provider ) {
201 |         return new $provider( $this->app );
202 |     }
203 | 
204 | }
205 | 


--------------------------------------------------------------------------------
/src/Core/Providers/AggregateServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core\Providers;
 4 | 
 5 | use Hybrid\Core\ServiceProvider;
 6 | 
 7 | class AggregateServiceProvider extends ServiceProvider {
 8 | 
 9 |     /**
10 |      * The provider class names.
11 |      *
12 |      * @var array
13 |      */
14 |     protected $providers = [];
15 | 
16 |     /**
17 |      * An array of the service provider instances.
18 |      *
19 |      * @var array
20 |      */
21 |     protected $instances = [];
22 | 
23 |     /**
24 |      * Register the service provider.
25 |      *
26 |      * @return void
27 |      */
28 |     public function register() {
29 |         $this->instances = [];
30 | 
31 |         foreach ( $this->providers as $provider ) {
32 |             $this->instances[] = $this->app->register( $provider );
33 |         }
34 |     }
35 | 
36 |     /**
37 |      * Get the services provided by the provider.
38 |      *
39 |      * @return array
40 |      */
41 |     public function provides() {
42 |         $provides = [];
43 | 
44 |         foreach ( $this->providers as $provider ) {
45 |             $instance = $this->app->resolveProvider( $provider );
46 | 
47 |             $provides = array_merge( $provides, $instance->provides() );
48 |         }
49 | 
50 |         return $provides;
51 |     }
52 | 
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Core/Providers/CoreServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid\Core\Providers;
 4 | 
 5 | class CoreServiceProvider extends AggregateServiceProvider {
 6 | 
 7 |     /**
 8 |      * The provider class names.
 9 |      *
10 |      * @var array<string>
11 |      */
12 |     protected $providers = [];
13 | 
14 |     /**
15 |      * The singletons to register into the container.
16 |      *
17 |      * @var array
18 |      */
19 |     public $singletons = [];
20 | 
21 |     /**
22 |      * Register any application services.
23 |      *
24 |      * @return void
25 |      */
26 |     public function register() {
27 |         parent::register();
28 |     }
29 | 
30 |     /**
31 |      * Bootstrap any application services.
32 |      *
33 |      * @return void
34 |      */
35 |     public function boot() {}
36 | 
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Core/ServiceProvider.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Base service provider.
  4 |  *
  5 |  * This is the base service provider class. This is an abstract class that must
  6 |  * be extended to create new service providers for the application.
  7 |  *
  8 |  * @package   HybridCore
  9 |  * @link      https://github.com/themehybrid/hybrid-core
 10 |  *
 11 |  * @author    Theme Hybrid
 12 |  * @copyright Copyright (c) 2008 - 2024, Theme Hybrid
 13 |  * @license   https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 14 |  */
 15 | 
 16 | namespace Hybrid\Core;
 17 | 
 18 | use Hybrid\Contracts\Core\Application;
 19 | use Hybrid\Contracts\Core\CachesConfiguration;
 20 | use Hybrid\Contracts\Core\DeferrableProvider;
 21 | 
 22 | /**
 23 |  * Service provider class.
 24 |  */
 25 | abstract class ServiceProvider {
 26 | 
 27 |     /**
 28 |      * The application instance.
 29 |      *
 30 |      * @var \Hybrid\Contracts\Core\Application
 31 |      */
 32 |     protected $app;
 33 | 
 34 |     /**
 35 |      * All of the registered booting callbacks.
 36 |      *
 37 |      * @var array
 38 |      */
 39 |     protected $bootingCallbacks = [];
 40 | 
 41 |     /**
 42 |      * All of the registered booted callbacks.
 43 |      *
 44 |      * @var array
 45 |      */
 46 |     protected $bootedCallbacks = [];
 47 | 
 48 |     /**
 49 |      * Create a new service provider instance.
 50 |      *
 51 |      * @param \Hybrid\Contracts\Core\Application $app
 52 |      * @return void
 53 |      */
 54 |     public function __construct( Application $app ) {
 55 |         $this->app = $app;
 56 |     }
 57 | 
 58 |     /**
 59 |      * Register any application services.
 60 |      *
 61 |      * @return void
 62 |      */
 63 |     public function register() {}
 64 | 
 65 |     /**
 66 |      * Register a booting callback to be run before the "boot" method is called.
 67 |      *
 68 |      * @param \Closure $callback
 69 |      * @return void
 70 |      */
 71 |     public function booting( Closure $callback ) {
 72 |         $this->bootingCallbacks[] = $callback;
 73 |     }
 74 | 
 75 |     /**
 76 |      * Register a booted callback to be run after the "boot" method is called.
 77 |      *
 78 |      * @param \Closure $callback
 79 |      * @return void
 80 |      */
 81 |     public function booted( Closure $callback ) {
 82 |         $this->bootedCallbacks[] = $callback;
 83 |     }
 84 | 
 85 |     /**
 86 |      * Call the registered booting callbacks.
 87 |      *
 88 |      * @return void
 89 |      */
 90 |     public function callBootingCallbacks() {
 91 |         $index = 0;
 92 | 
 93 |         while ( count( $this->bootingCallbacks ) > $index ) {
 94 |             $this->app->call( $this->bootingCallbacks[ $index ] );
 95 | 
 96 |             ++$index;
 97 |         }
 98 |     }
 99 | 
100 |     /**
101 |      * Call the registered booted callbacks.
102 |      *
103 |      * @return void
104 |      */
105 |     public function callBootedCallbacks() {
106 |         $index = 0;
107 | 
108 |         while ( count( $this->bootedCallbacks ) > $index ) {
109 |             $this->app->call( $this->bootedCallbacks[ $index ] );
110 | 
111 |             ++$index;
112 |         }
113 |     }
114 | 
115 |     /**
116 |      * Merge the given configuration with the existing configuration.
117 |      *
118 |      * @param string $path
119 |      * @param string $key
120 |      * @return void
121 |      */
122 |     protected function mergeConfigFrom( $path, $key ) {
123 |         if ( ! ( $this->app instanceof CachesConfiguration && $this->app->configurationIsCached() ) ) {
124 |             $config = $this->app->make( 'config' );
125 | 
126 |             $config->set( $key, array_merge(
127 |                 require $path, $config->get( $key, [] )
128 |             ) );
129 |         }
130 |     }
131 | 
132 |     /**
133 |      * Replace the given configuration with the existing configuration recursively.
134 |      *
135 |      * @param string $path
136 |      * @param string $key
137 |      * @return void
138 |      */
139 |     protected function replaceConfigRecursivelyFrom( $path, $key ) {
140 |         if ( ! ( $this->app instanceof CachesConfiguration && $this->app->configurationIsCached() ) ) {
141 |             $config = $this->app->make( 'config' );
142 | 
143 |             $config->set( $key, array_replace_recursive(
144 |                 require $path, $config->get( $key, [] )
145 |             ) );
146 |         }
147 |     }
148 | 
149 |     /**
150 |      * Register a view file namespace.
151 |      *
152 |      * @param string|array $path
153 |      * @param string       $namespace
154 |      * @return void
155 |      */
156 |     protected function loadViewsFrom( $path, $namespace ) {
157 |         $this->callAfterResolving( 'view', function ( $view ) use ( $path, $namespace ) {
158 |             if ( isset( $this->app->config['view']['paths'] ) && is_array( $this->app->config['view']['paths'] ) ) {
159 |                 foreach ( $this->app->config['view']['paths'] as $viewPath ) {
160 |                     if ( is_dir( $appPath = $viewPath . '/vendor/' . $namespace ) ) {
161 |                         $view->addNamespace( $namespace, $appPath );
162 |                     }
163 |                 }
164 |             }
165 | 
166 |             $view->addNamespace( $namespace, $path );
167 |         } );
168 |     }
169 | 
170 |     /**
171 |      * Setup an after resolving listener, or fire immediately if already resolved.
172 |      *
173 |      * @param string   $name
174 |      * @param callable $callback
175 |      * @return void
176 |      */
177 |     protected function callAfterResolving( $name, $callback ) {
178 |         $this->app->afterResolving( $name, $callback );
179 | 
180 |         if ( $this->app->resolved( $name ) ) {
181 |             $callback( $this->app->make( $name ), $this->app );
182 |         }
183 |     }
184 | 
185 |     /**
186 |      * Get the services provided by the provider.
187 |      *
188 |      * @return array
189 |      */
190 |     public function provides() {
191 |         return [];
192 |     }
193 | 
194 |     /**
195 |      * Get the events that trigger this service provider to register.
196 |      *
197 |      * @return array
198 |      */
199 |     public function when() {
200 |         return [];
201 |     }
202 | 
203 |     /**
204 |      * Determine if the provider is deferred.
205 |      *
206 |      * @return bool
207 |      */
208 |     public function isDeferred() {
209 |         return $this instanceof DeferrableProvider;
210 |     }
211 | 
212 |     /**
213 |      * Get the default providers for a Laravel application.
214 |      *
215 |      * @return \Hybrid\Core\DefaultProviders
216 |      */
217 |     public static function defaultProviders() {
218 |         return new DefaultProviders();
219 |     }
220 | 
221 |     /**
222 |      * Add the given provider to the application's provider bootstrap file.
223 |      *
224 |      * @param string $provider
225 |      * @param string $path
226 |      * @return bool
227 |      */
228 |     public static function addProviderToBootstrapFile( string $provider, ?string $path = null ) {
229 |         $path ??= app()->getBootstrapProvidersPath();
230 | 
231 |         if ( ! file_exists( $path ) ) {
232 |             return false;
233 |         }
234 | 
235 |         if ( function_exists( 'opcache_invalidate' ) ) {
236 |             opcache_invalidate( $path, true );
237 |         }
238 | 
239 |         $providers = collect( require $path )
240 |             ->merge( [ $provider ] )
241 |             ->unique()
242 |             ->sort()
243 |             ->values()
244 |             ->map( static fn( $p ) => '    ' . $p . '::class,' )
245 |             ->implode( PHP_EOL );
246 | 
247 |         $content = '<?php
248 | 
249 | return [
250 | ' . $providers . '
251 | ];';
252 | 
253 |         file_put_contents( $path, $content . PHP_EOL );
254 | 
255 |         return true;
256 |     }
257 | 
258 | }
259 | 


--------------------------------------------------------------------------------
/src/Util.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Hybrid;
 4 | 
 5 | use Closure;
 6 | use ReflectionNamedType;
 7 | 
 8 | /**
 9 |  * @internal
10 |  */
11 | class Util {
12 | 
13 |     /**
14 |      * If the given value is not an array and not null, wrap it in one.
15 |      *
16 |      * @param mixed $value
17 |      * @return array
18 |      */
19 |     public static function arrayWrap( $value ) {
20 |         if ( is_null( $value ) ) {
21 |             return [];
22 |         }
23 | 
24 |         return is_array( $value ) ? $value : [ $value ];
25 |     }
26 | 
27 |     /**
28 |      * Return the default value of the given value.
29 |      *
30 |      * @param mixed $value
31 |      * @param mixed ...$args
32 |      * @return mixed
33 |      */
34 |     public static function unwrapIfClosure( $value, ...$args ) {
35 |         return $value instanceof Closure ? $value( ...$args ) : $value;
36 |     }
37 | 
38 |     /**
39 |      * Get the class name of the given parameter's type, if possible.
40 |      *
41 |      * @param \ReflectionParameter $parameter
42 |      * @return string|null
43 |      */
44 |     public static function getParameterClassName( $parameter ) {
45 |         $type = $parameter->getType();
46 | 
47 |         if ( ! $type instanceof ReflectionNamedType || $type->isBuiltin() ) {
48 |             return null;
49 |         }
50 | 
51 |         $name = $type->getName();
52 | 
53 |         if ( ! is_null( $class = $parameter->getDeclaringClass() ) ) {
54 |             if ( 'self' === $name ) {
55 |                 return $class->getName();
56 |             }
57 | 
58 |             if ( 'parent' === $name && $parent = $class->getParentClass() ) {
59 |                 return $parent->getName();
60 |             }
61 |         }
62 | 
63 |         return $name;
64 |     }
65 | 
66 | }
67 | 


--------------------------------------------------------------------------------
/src/functions-helpers.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Helper functions.
  4 |  *
  5 |  * Helpers are functions designed for quickly accessing data from the container
  6 |  * that we need throughout the framework.
  7 |  *
  8 |  * @package   HybridCore
  9 |  * @link      https://github.com/themehybrid/hybrid-core
 10 |  *
 11 |  * @author    Theme Hybrid
 12 |  * @copyright Copyright (c) 2008 - 2024, Theme Hybrid
 13 |  * @license   https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 14 |  */
 15 | 
 16 | namespace Hybrid;
 17 | 
 18 | use Hybrid\Container\Container;
 19 | use Hybrid\Core\Mix;
 20 | 
 21 | if ( ! function_exists( __NAMESPACE__ . '\\app' ) ) {
 22 |     /**
 23 |      * Get the available container instance.
 24 |      *
 25 |      * @param string|class-string<TClass>|null $abstract
 26 |      * @param array                            $parameters
 27 |      * @return ($abstract is class-string<TClass> ? TClass : ($abstract is null ? \Hybrid\Core\Application : mixed))
 28 |      *
 29 |      * @template TClass
 30 |      */
 31 |     function app( $abstract = null, array $parameters = [] ) {
 32 |         if ( is_null( $abstract ) ) {
 33 |             return Container::getInstance();
 34 |         }
 35 | 
 36 |         return Container::getInstance()->make( $abstract, $parameters );
 37 |     }
 38 | }
 39 | 
 40 | if ( ! function_exists( __NAMESPACE__ . '\\app_path' ) ) {
 41 |     /**
 42 |      * Get the path to the application folder.
 43 |      *
 44 |      * @param string $path
 45 |      * @return string
 46 |      */
 47 |     function app_path( $path = '' ) {
 48 |         return app()->path( $path );
 49 |     }
 50 | }
 51 | 
 52 | if ( ! function_exists( __NAMESPACE__ . '\\booted' ) ) {
 53 |     /**
 54 |      * Conditional function for checking whether the application has been
 55 |      * booted. Use before launching a new application. If booted, reference
 56 |      * the `app()` instance directly.
 57 |      *
 58 |      * @return bool
 59 |      */
 60 |     function booted() {
 61 |         return defined( 'HYBRID_CORE_BOOTED' ) && true === HYBRID_CORE_BOOTED;
 62 |     }
 63 | }
 64 | 
 65 | if ( ! function_exists( __NAMESPACE__ . '\\path' ) ) {
 66 |     /**
 67 |      * Returns the directory path of the framework. If a file is passed in,
 68 |      * it'll be appended to the end of the path.
 69 |      *
 70 |      * @param string $file
 71 |      * @return string
 72 |      */
 73 |     function path( $file = '' ) {
 74 |         $file = ltrim( $file, '/' );
 75 | 
 76 |         return $file
 77 |                 ? App::resolve( 'path' ) . "/{$file}"
 78 |                 : App::resolve( 'path' );
 79 |     }
 80 | }
 81 | 
 82 | if ( ! function_exists( __NAMESPACE__ . '\\version' ) ) {
 83 |     /**
 84 |      * Returns the framework version.
 85 |      *
 86 |      * @return string
 87 |      */
 88 |     function version() {
 89 |         return App::resolve( 'version' );
 90 |     }
 91 | }
 92 | 
 93 | if ( ! function_exists( 'event' ) ) {
 94 |     /**
 95 |      * Dispatch an event and call the listeners.
 96 |      *
 97 |      * @param string|object $event
 98 |      * @param mixed         $payload
 99 |      * @param bool          $halt
100 |      * @return array|null
101 |      */
102 |     function event( ...$args ) {
103 |         return app( 'events' )->dispatch( ...$args );
104 |     }
105 | }
106 | 
107 | if ( ! function_exists( __NAMESPACE__ . '\\base_path' ) ) {
108 |     /**
109 |      * Get the path to the base of the install.
110 |      *
111 |      * @param string $path
112 |      * @return string
113 |      */
114 |     function base_path( $path = '' ) {
115 |         return app()->basePath( $path );
116 |     }
117 | }
118 | 
119 | if ( ! function_exists( __NAMESPACE__ . '\\config' ) ) {
120 |     /**
121 |      * Get / set the specified configuration value.
122 |      *
123 |      * If an array is passed as the key, we will assume you want to set an array of values.
124 |      *
125 |      * @param array<string, mixed>|string|null $key
126 |      * @param mixed                            $default
127 |      * @return ($key is null ? \Hybrid\Tools\Config\Repository : ($key is string ? mixed : null))
128 |      */
129 |     function config( $key = null, $default = null ) {
130 |         if ( is_null( $key ) ) {
131 |             return app( 'config' );
132 |         }
133 | 
134 |         if ( is_array( $key ) ) {
135 |             return app( 'config' )->set( $key );
136 |         }
137 | 
138 |         return app( 'config' )->get( $key, $default );
139 |     }
140 | }
141 | 
142 | if ( ! function_exists( __NAMESPACE__ . '\\config_path' ) ) {
143 |     /**
144 |      * Get the configuration path.
145 |      *
146 |      * @param string $path
147 |      * @return string
148 |      */
149 |     function config_path( $path = '' ) {
150 |         return app()->configPath( $path );
151 |     }
152 | }
153 | 
154 | if ( ! function_exists( __NAMESPACE__ . '\\mix' ) ) {
155 |     /**
156 |      * Get the path to a versioned Mix file.
157 |      *
158 |      * @param string $path
159 |      * @param string $manifestDirectory
160 |      * @return \Hybrid\Tools\HtmlString|string
161 |      * @throws \Exception
162 |      */
163 |     function mix( $path, $manifestDirectory = '' ) {
164 |         return app( Mix::class )( ...func_get_args() );
165 |     }
166 | }
167 | 
168 | if ( ! function_exists( __NAMESPACE__ . '\\public_path' ) ) {
169 |     /**
170 |      * Get the path to the public folder.
171 |      *
172 |      * @param string $path
173 |      * @return string
174 |      */
175 |     function public_path( $path = '' ) {
176 |         return app()->publicPath( $path );
177 |     }
178 | }
179 | 
180 | if ( ! function_exists( __NAMESPACE__ . '\\resolve' ) ) {
181 | 
182 |     /**
183 |      * Resolve a service from the container.
184 |      *
185 |      * @param string|class-string<TClass> $name
186 |      * @param array                       $parameters
187 |      * @return ($name is class-string<TClass> ? TClass : mixed)
188 |      *
189 |      * @template TClass
190 |      */
191 |     function resolve( $name, array $parameters = [] ) {
192 |         return app( $name, $parameters );
193 |     }
194 | }
195 | 
196 | if ( ! function_exists( __NAMESPACE__ . '\\resource_path' ) ) {
197 |     /**
198 |      * Get the path to the resources folder.
199 |      *
200 |      * @param string $path
201 |      * @return string
202 |      */
203 |     function resource_path( $path = '' ) {
204 |         return app()->resourcePath( $path );
205 |     }
206 | }
207 | 
208 | if ( ! function_exists( __NAMESPACE__ . '\\storage_path' ) ) {
209 |     /**
210 |      * Get the path to the storage folder.
211 |      *
212 |      * @param string $path
213 |      * @return string
214 |      */
215 |     function storage_path( $path = '' ) {
216 |         return app()->storagePath( $path );
217 |     }
218 | }
219 | 


--------------------------------------------------------------------------------