Files
Phraseanet/UPGRADE-3.8.md
2013-05-24 16:29:30 +02:00

66 lines
2.0 KiB
Markdown

# UPGRADE FROM 3.7 TO 3.8
Here are some release notes about upgrading from Phraseanet 3.7 and Phraseanet 3.8.
Phraseanet 3.8 is a new step in moving Phraseanet to a more decoupled design. We did
a lot of cleanup and now delegate some behavior to dedicated components. this brings
some new features, robustness and stability.
These enhancements are described in the CHANGELOG file. The purpose of this document
is to provide a list a BC breaks / Changes.
## Nginx
If you are using Nginx as Phraseanet web-server, you must update you virtual-host
configuration as follow :
```
server {
listen 80;
server_name yourdomain.tld;
root /var/www/Phraseanet/www;
index index.php;
location /api {
rewrite ^(.*)$ /api.php/$1 last;
}
location / {
# try to serve file directly, fallback to rewrite
try_files $uri $uri/ @rewriteapp;
}
location @rewriteapp {
rewrite ^(.*)$ /index.php/$1 last;
}
# PHP scripts -> PHP-FPM server listening on 127.0.0.1:9000
location ~ ^/(index|index_dev|api)\.php(/|$) {
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
```
## Console
Phraseanet 3.8 comes with a new command-line utility : `bin/setup`. This utility
brings commands that can be run when Phraseanet is not installed.
It introduces 3 BC breaks :
- `bin/console system:upgrade` is replaced by `bin/setup system:upgrade`
- `bin/console check:system` is replaced by `bin/setup check:system`
- `bin/console check:config` has been dropped
The idea of `bin/setup` is to provide an commandline tool that is not aware of
Phraseanet Installation, whereas `bin/console` requires an up-to-date Phraseanet
install.
## Customization
If you were using custom homepage or LDAP connection, they might not work.
Please disable it before upgrading.