Upgrade to Laravel 6 #1318

New Issue

OVERLORD · 2026-02-05T00:35:31+03:00

OVERLORD commented

2026-02-05 00:35:31 +03:00

Originally created by @ssddanbrown on GitHub (Aug 27, 2019).

Originally assigned to: @ssddanbrown on GitHub.

Laravel 6 is releasing soon. Would be good to align BookStack to a later release. Should be a fairly straightforward upgrade code-wise. The bigger concern will be the change in PHP version requirements (php7 to php7.2). Laravel 6 looks to be an LTS release which will be ideal since staying on Laravel 5.5 has kept things steady for the last two years.

Considerations

Install scripts will need to be updated to install php7.2 by default (Perhaps skip to latest stable version at time of changes).
PHP upgrade guide would be ideal for those that have already installed with official install scripts.
We'll need to warn popular BookStack service/container maintainers of the change in order to ensure a quick and stable upgrade for their users.
PHP dependencies will need to be reviewed to ensure compatibility with Laravel 6.

Originally created by @ssddanbrown on GitHub (Aug 27, 2019). Originally assigned to: @ssddanbrown on GitHub. Laravel 6 is releasing soon. Would be good to align BookStack to a later release. Should be a fairly straightforward upgrade code-wise. The bigger concern will be the change in PHP version requirements (php7 to php7.2). Laravel 6 looks to be an LTS release which will be ideal since staying on Laravel 5.5 has kept things steady for the last two years. ### Considerations * Install scripts will need to be updated to install php7.2 by default (Perhaps skip to latest stable version at time of changes). * PHP upgrade guide would be ideal for those that have already installed with official install scripts. * We'll need to warn popular BookStack service/container maintainers of the change in order to ensure a quick and stable upgrade for their users. * PHP dependencies will need to be reviewed to ensure compatibility with Laravel 6.

OVERLORD added the 🔧 Maintenance 📖 Docs Update :octocat: Admin/Meta 🏭 Back-End labels 2026-02-05 00:35:31 +03:00

OVERLORD closed this issue

2026-02-05 00:35:34 +03:00

OVERLORD commented

2026-02-05 00:35:42 +03:00

@JtheBAB commented on GitHub (Aug 27, 2019):

The good thing is that even debian is with the latest version at php 7.3.

@JtheBAB commented on GitHub (Aug 27, 2019): The good thing is that even debian is with the latest version at php 7.3.

OVERLORD commented

2026-02-05 00:35:47 +03:00

@ssddanbrown commented on GitHub (Aug 27, 2019):

Ah, That's good news. Think the mains ones will be debian stretch, Ubuntu 16.04 & Centos 7. If we provide some instructions for those then we should be covered. Potentially debian Jessie also? But that is nearing EOL.

@ssddanbrown commented on GitHub (Aug 27, 2019): Ah, That's good news. Think the mains ones will be debian stretch, Ubuntu 16.04 & Centos 7. If we provide some instructions for those then we should be covered. Potentially debian Jessie also? But that is nearing EOL.

OVERLORD commented

2026-02-05 00:35:49 +03:00

@JtheBAB commented on GitHub (Aug 27, 2019):

Debian stable is Buster (php 7.3)
Debian old stable is Stretch (php 7.0)
Ubuntu is 18.04 prefered but 16.04 is still supported. But both have php 7.3

@JtheBAB commented on GitHub (Aug 27, 2019): Debian stable is Buster (php 7.3) Debian old stable is Stretch (php 7.0) Ubuntu is 18.04 prefered but 16.04 is still supported. But both have php 7.3

OVERLORD commented

2026-02-05 00:35:54 +03:00

@timoschwarzer commented on GitHub (Oct 14, 2019):

This is only missing a docs update for Debian stretch (how to get PHP 7.3 running) and updating system requirement lists eventually, right?

@timoschwarzer commented on GitHub (Oct 14, 2019): This is only missing a docs update for Debian stretch (how to get PHP 7.3 running) and updating system requirement lists eventually, right?

OVERLORD commented

2026-02-05 00:36:03 +03:00

@ssddanbrown commented on GitHub (Oct 14, 2019):

@timoschwarzer Yeah, Docs and install script updates for Debian Stretch, Ubuntu 16.04 & Centos 7. Leaving this issue open as a reminder for that.

And also need to check the docker images and warn if they are on a lower PHP version. Might be alright there though.

@ssddanbrown commented on GitHub (Oct 14, 2019): @timoschwarzer Yeah, Docs and install script updates for Debian Stretch, Ubuntu 16.04 & Centos 7. Leaving this issue open as a reminder for that. And also need to check the docker images and warn if they are on a lower PHP version. Might be alright there though.

OVERLORD commented

2026-02-05 00:36:07 +03:00

@timoschwarzer commented on GitHub (Oct 15, 2019):

Some notes primarily for myself updating the docs now:

OS/PHP compatibility/availability

The linuxserver/bookstack image uses Alpine 3.10 as base image, which has PHP
7.3.10-r0 in its repos.
The solidnerd image uses php:7.2-apache-stretch

Ubuntu 16.04 needs a PPA for PHP 7.2

sudo add-apt-repository -y ppa:ondrej/php

Debian Stretch needs a 3rdparty repository

sudo apt install ca-certificates apt-transport-https 
wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add -
echo "deb https://packages.sury.org/php/ stretch main" | sudo tee 
/etc/apt/sources.list.d/php.list

On CentOS 7.X you need to enable EPEL repositories and use a 3rdparty repository that provides newer versions of PHP (note: this is already done in the CentOS 7 install script)
```
yum install epel-release
yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum-config-manager --enable remi-php73
yum install php
```
The development Docker images have php7.3-apache as its base image

@timoschwarzer commented on GitHub (Oct 15, 2019): Some notes primarily for myself updating the docs now: <details> <summary>OS/PHP compatibility/availability</summary> - The linuxserver/bookstack image uses Alpine 3.10 as base image, which has PHP 7.3.10-r0 in its repos. - The solidnerd image uses php:7.2-apache-stretch - Ubuntu 16.04 needs a PPA for PHP 7.2 ``` sudo add-apt-repository -y ppa:ondrej/php ``` - Debian Stretch needs a 3rdparty repository ``` sudo apt install ca-certificates apt-transport-https wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add - echo "deb https://packages.sury.org/php/ stretch main" | sudo tee /etc/apt/sources.list.d/php.list ``` - On CentOS 7.X you need to enable EPEL repositories and use a 3rdparty repository that provides newer versions of PHP (note: this is already done in the CentOS 7 install script) ``` yum install epel-release yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm yum-config-manager --enable remi-php73 yum install php ``` - The development Docker images have `php7.3-apache` as its base image </details>

OVERLORD commented

2026-02-05 00:36:10 +03:00

@timoschwarzer commented on GitHub (Oct 15, 2019):

Docs update is ready @ https://github.com/BookStackApp/website/pull/49
~~Now updating the install scripts.~~
Scripts updated: https://github.com/BookStackApp/devops/pull/22

@timoschwarzer commented on GitHub (Oct 15, 2019): Docs update is ready @ https://github.com/BookStackApp/website/pull/49 ~~Now updating the install scripts.~~ Scripts updated: https://github.com/BookStackApp/devops/pull/22

OVERLORD commented

2026-02-05 00:36:13 +03:00

@ssddanbrown commented on GitHub (Jan 19, 2020):

Thank you so much for digging into this @timoschwarzer, Was very helpful. And also thanks @JtheBAB for providing details for systems.

Since only further docs updates and deployment now need to occur I'll close this off.

@ssddanbrown commented on GitHub (Jan 19, 2020): Thank you so much for digging into this @timoschwarzer, Was very helpful. And also thanks @JtheBAB for providing details for systems. Since only further docs updates and deployment now need to occur I'll close this off.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#1318