Download the PHP package telkins/laravel-inquiry without Composer
On this page you can find all versions of the php package telkins/laravel-inquiry. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download telkins/laravel-inquiry
More information about telkins/laravel-inquiry
Files in telkins/laravel-inquiry
Package laravel-inquiry
Short Description A (somewhat opinionated) Laravel package to help make asking questions and getting answers a little easier and more uniform.
License MIT
Homepage https://github.com/telkins/laravel-inquiry
Informations about the package laravel-inquiry
A (somewhat opinionated) Laravel package to help make asking questions and getting answers a little easier and more uniform.
From time to time you may need to make inquiries of your application or different parts of your code. You may need to know whether or not something was done or you may need to build a collection of key value pairs. Sometimes this iss provided easily via model attributes or database queries. Sometimes, however, getting this information isn't quite as tidy as you might like it.
The goal of this package is to provide a (somewhat opinionated) way to make inquiries. You can create Inquiry
classes. When you want to make a specific inquiry, then you "ask" that class: $myInquiry = MyInquiry::ask();
. You get back a "details" object, which you define, that allows you to provide the details of your inquiry. Then, you ask for the answer. Here's a simple example:
Installation
You can install the package via composer:
Usage
For now, one must manually create Inquiry
and Details
classes.
Create an Inquiry
To create an inquiry class, simply extend Inquiry
like so:
Create Inquiry Details
To create an inquiry detail classs, simply extend Details
like so:
"Ask" Your Question, Get an Answer
Once you have built your inquiry and inquiry details classes, then you can begin to use them. There are three main steps to asking your question and getting an answer:
- Call the static
ask()
method on yourInquiry
class. This returns the inquiry's details object. - Using the details object, provide the details of the inquiry.
- Finally, request the answer by calling the
answer()
method on the details object.
Here is an example of asking and getting an answer all at once:
Here is an example of using the details object to provide different details to get different answers for different scenarios:
Conventions
By default, each Inquiry
class will look for a "details" class that has the same FQCN with Details
appended. So, for our example CanChildPlayPS4
class, it will look for CanChildPlayPS4Details
.
To override this behavior, you can specify the "details" class name in your Inquiry
class like so:
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please use the issue tracker.
Credits
- Travis Elkins
- All Contributors
License
The MIT License (MIT). Please see License File for more information.