> For the complete documentation index, see [llms.txt](https://devsb.gitbook.io/laranotes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devsb.gitbook.io/laranotes/usefull-packages/squire.md).

# Squire

[![Package banner](https://user-images.githubusercontent.com/41773797/104140339-f54ce300-53a8-11eb-8049-8d0994a6cd36.png)](https://user-images.githubusercontent.com/41773797/104140339-f54ce300-53a8-11eb-8049-8d0994a6cd36.png)

[![Tests passing](https://camo.githubusercontent.com/345268aa913e8c633bd0321b5a6466ecfefe6d54adfe9d02efa24a2a36097ebe/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54657374732d70617373696e672d677265656e3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562)](https://github.com/squirephp/squire/actions) [![Laravel v8.x](https://camo.githubusercontent.com/de57a464138924af1f2f4ad64c6197efacc1c7bf5673becf2ab8837fe100a0bd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d76382e782d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c)](https://laravel.com/) [![PHP 8](https://camo.githubusercontent.com/3171871efd43a2f178a89e4075594162627ded99437d86af077a3f7e3354b811/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870)](https://php.net/)

Squire is a library of static Eloquent models for fixture data that is commonly needed in web applications, such as countries, currencies and airports. It's based on the concepts of [Caleb Porzio's Sushi package](https://github.com/calebporzio/sushi).

Common use cases for Squire include:

* Populating dropdown options, such as a country selector on an address form.
* Attaching extra data to other models in your app, such as airport information to a `Flight` model. See the section on [model relationships](https://github.com/squirephp/squire#model-relationships).
* [Validating user input.](https://github.com/squirephp/squire#validation)

## Learn More

{% embed url="<https://github.com/squirephp/squire#squiremodelsairline>" %}
