Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prismicio/php-laravel-starter
Php Laravel Starter for prismic.io
https://github.com/prismicio/php-laravel-starter
Last synced: 2 months ago
JSON representation
Php Laravel Starter for prismic.io
- Host: GitHub
- URL: https://github.com/prismicio/php-laravel-starter
- Owner: prismicio
- Created: 2017-02-15T10:58:58.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-01-07T00:25:57.000Z (about 3 years ago)
- Last Synced: 2024-04-08T16:54:35.394Z (9 months ago)
- Language: PHP
- Size: 8.73 MB
- Stars: 24
- Watchers: 19
- Forks: 51
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Laravel starter
This is a blank [Laravel](https://laravel.com) project that will connect to any prismic.io repository. It uses the prismic.io PHP development kit, and provides a few helpers to integrate with a Laravel website.
## Getting started
### Launch the starter project
_(Assuming you've [installed Laravel](https://laravel.com/docs/5.5/installation))_
Fork this repository, then clone your fork, and run this in your newly created directory:
```bash
composer install
```
Next you need to make a copy of the `.env.example` file and rename it to `.env` inside your project root.
Run the following command to generate your app key:
```
php artisan key:generate
```
Then start your server:
```
php artisan serve
```
Your Laravel starter project is now up and running!
### Configure the starter project
Edit the `config/prismic.php` prismic configuration file to get the application connected to the correct repository:
```
'url' => 'https://your-repo-name.prismic.io/api/v2',
```
You may have to restart your server.
### Create your routes and pages
When the project is first launched and viewed, it will by default display a help page. Here you will find some documentation to help you get started with your Laravel project.
It includes an example that shows how to create a route and query a document of the custom type "page". It then shows how to integrate the content into the Laravel templates.
Check it out to get a better understanding of how you would create your own routes and templates for your project. You can also explore our documentation to learn more about how to [query the API](./docs/02-query-the-api/01-how-to-query-the-api.md) and how to integrate content fields like [Rich Text](./docs/03-templating/14-rich-text-and-title.md), [Images](./docs/03-templating/09-images.md), and more.
## Deploying your Laravel application
Once you've created your website, an easy way to deploy your Laravel application is to use [Heroku](http://www.heroku.com). Just follow these few simple steps once you have successfully [signed up](https://id.heroku.com/signup/www-header) and [installed the Heroku toolbelt](https://toolbelt.heroku.com/):
Create a new Heroku application
```
$ heroku create
```
Initialize a new Git repository:
```
$ git init
$ heroku git:remote -a your-heroku-app-name
```
Commit your code to the Git repository if you haven't already:
```
$ git add .
$ git commit -am "make it better"
```
Set a Laravel encryption key:
```
$ heroku config:set APP_KEY=$(php artisan --no-ansi key:generate --show)
```
Push to Heroku:
```
$ git push heroku master
```
You can now browse your application online:
```
$ heroku open
```
You can read more about launching your project with Heroku here in their [Laravel & Heroku guide](https://devcenter.heroku.com/articles/getting-started-with-laravel).
## Learn more about prismic.io
If you are looking for more resources to learn more about prismic.io, you can find out [how to get started with prismic.io](https://prismic.io/docs) and learn more by exploring [our full documentation](./docs).
### Understand the PHP development kit
You'll find more information about how to use the development kit included in this starter project, by reading its README file and exploring its project files on GitHub [prismic/php-kit](https://github.com/prismicio/php-kit).
## Licence
This software is licensed under the Apache 2 license, quoted below.
Copyright 2018 Prismic.io (https://prismic.io).
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.