Download the PHP package shipsaas/never-throw without Composer
On this page you can find all versions of the php package shipsaas/never-throw. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download shipsaas/never-throw
More information about shipsaas/never-throw
Files in shipsaas/never-throw
Package never-throw
Short Description Response-first over Throw. PHP NeverThrow library sample implementation
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package never-throw
ShipSaaS NeverThrow for PHP
Provide a strictly typed way to deal with Success & Error Outcomes for your PHP applications.
Inspired by NeverThrow so here we are with a simple implementation of NeverThrow from PHP.
Throwing and catching is very similar to using goto statements - in other words; it makes reasoning about your programs harder. Secondly, by using throw you make the assumption that the caller of your function is implementing catch. This is a known source of errors. Example: One dev throws and another dev uses the function without prior knowledge that the function will throw. Thus, and edge case has been left unhandled and now you have unhappy users, bosses, cats, etc.
With all that said, there are definitely good use cases for throwing in your program. But much less than you might think.
TL;DR: no throw = happier life & application. Fewer errors on production & increase the DRY & reusable things in your PHP apps.
Supports
PHP 8.2+ since v2.0.0
Installation
Top-Level API
NeverThrow\\Result class and ready to be extended anytime.
Non-static
isOk()isError()getOkResult()getErrorResult()
Usage
Create your response classes
We'll create two new classes: Success & Error. And feel free to put any of your data
Create your dedicated Result class
Last step before using NeverThrow. Creating a dedicated Result class helps us to:
- Define types for the error & success result class
- => IDE-friendly
- => Happier reader/caller
- A centralized place that reference to the Success & Error result classes.
First way
Returns the Result in your business logic
Check the Response
Conclusion
As you can see with the above code, there are:
- no try/catch, 0 try/catch abuse
- no exception, never
- explicit return types & information.
It would bring the development truly awesome and no pain.
With strictly typed return types, developers can know what is going on with other services/libraries. Thus makes the reusable better. And we don't have to wrap the try/catch and uglify our code.
Don't abuse Exceptions, they should be only used for the unexpected situations (and Errors !== Exceptions, fact).
Additional
Most of this function is actually about the things that can go wrong, but our types only inform us of the successful path. That means 4/5ths of the function's output is untyped!
The above "exceptions" or "errors" aren't really exceptions or errors at all. They are outcomes. They are predictable, reasonable parts of our system. My heuristic is, if they are something a good product manager would care about, they are not exceptions and you shouldn't throw them!
Exceptions are unpredictable things we cannot reasonably plan for, that the system should not attempt recovery from, and we should not route to the user.
License
MIT License
