From febaa5ca3c3a89b04a3a42f4466bdf248a7c4144 Mon Sep 17 00:00:00 2001 From: Thomas Zilio Date: Thu, 4 Jan 2018 12:46:14 +0100 Subject: [PATCH] Miglioramento della documentazione --- README.md | 6 ++--- docs/Installazione.md | 52 +++++++++++++++++++++++++------------------ 2 files changed, 33 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index 281971a32..f1a9e3f75 100644 --- a/README.md +++ b/README.md @@ -54,7 +54,7 @@ La documentazione ufficiale è disponibile all'indirizzo = 5.4 +- PHP >= 5.6 - MySQL >= 5.0 Per ulteriori informazioni sui pacchetti che forniscono questi elementi di default, visitare la sezione [Installazione](https://devcode-it.github.io/openstamanager/installazione.html) della documentazione. @@ -64,7 +64,7 @@ Per ulteriori informazioni sui pacchetti che forniscono questi elementi di defau Per procedere all'installazione è necessario seguire i seguenti punti: 1. [Scaricare una release ufficiale del progetto](https://github.com/devcode-it/openstamanager/releases). -2. Creare una cartella (ad esempio `openstamanager`) nella root del sever web installato ed estrarvi il contenuto della release scaricata. Il percorso della cartella root del server varia in base al software in utilizzo: +2. Creare una cartella (ad esempio `openstamanager`) nella root del server web installato ed estrarvi il contenuto della release scaricata. Il percorso della cartella root del server varia in base al software in utilizzo: - LAMP (`/var/www/html`) - XAMPP (`C:/xampp/htdocs` per Windows, `/opt/lampp/htdocs/` per Linux, `/Applications/XAMPP/htdocs/` per MAC) @@ -88,7 +88,7 @@ Se siete inoltre interessati a supporto e assistenza professionali, li potete ri ### Github -Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di Github, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite [Composer](https://getcomposer.org)) e gli assets (tramite [Yarn](https://yarnpkg.com)) del progetto. +Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di Github, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite [Composer](https://getcomposer.org)) e gli assets (tramite [Yarn](https://yarnpkg.com)) del progetto. ```bash php composer.phar install diff --git a/docs/Installazione.md b/docs/Installazione.md index bff7981a1..9c5cfb187 100644 --- a/docs/Installazione.md +++ b/docs/Installazione.md @@ -4,27 +4,23 @@ currentMenu: installazione # Installazione - - - [Requisiti](#requisiti) - [Installazione](#installazione) - - [Versioni](#versioni) - - [Github](#github) + - [Versioni](#versioni) + - [Github](#github) - [Strumenti utili](#strumenti-utili) - - [Windows](#windows) - - [Linux](#linux) - - [MAC](#mac) + - [Windows](#windows) + - [Linux](#linux) + - [MAC](#mac) - [Problemi comuni](#problemi-comuni) - - [Schermata bianca iniziale](#schermata-bianca-iniziale) - - [Blocco dell'installazione allo 0%](#blocco-dellinstallazione-allo-0%25) - - + - [Schermata bianca](#schermata-bianca) + - [Blocco dell'installazione (0%)](#blocco-dellinstallazione-0) ## Requisiti L'installazione del gestionale richiede la presenza di un server web con abilitato il [DBMS MySQL](https://www.mysql.com) e il linguaggio di programmazione [PHP](http://php.net). -- PHP >= 5.4 +- PHP >= 5.6 - MySQL >= 5.0 Per ulteriori informazioni sui pacchetti che forniscono questi elementi di default, visitare la sezione [Installazione](https://devcode-it.github.io/openstamanager/installazione.html) della documentazione. @@ -34,7 +30,7 @@ Per ulteriori informazioni sui pacchetti che forniscono questi elementi di defau Per procedere all'installazione è necessario seguire i seguenti punti: 1. [Scaricare una release ufficiale del progetto](https://github.com/devcode-it/openstamanager/releases). -2. Creare una cartella (ad esempio `openstamanager`) nella root del sever web installato ed estrarvi il contenuto della release scaricata. Il percorso della cartella root del server varia in base al software in utilizzo: +2. Creare una cartella (ad esempio `openstamanager`) nella root del server web installato ed estrarvi il contenuto della release scaricata. Il percorso della cartella root del server varia in base al software in utilizzo: - LAMP (`/var/www/html`) - XAMPP (`C:/xampp/htdocs` per Windows, `/opt/lampp/htdocs/` per Linux, `/Applications/XAMPP/htdocs/` per MAC) @@ -58,7 +54,7 @@ Se siete inoltre interessati a supporto e assistenza professionali, li potete ri ### Github -Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di Github, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite [Composer](https://getcomposer.org)) e gli assets (tramite [Yarn](https://yarnpkg.com)) del progetto. +Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di Github, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite [Composer](https://getcomposer.org)) e gli assets (tramite [Yarn](https://yarnpkg.com)) del progetto. ```bash php composer.phar install @@ -115,18 +111,21 @@ Il gestionale è stato testato con successo su Mac OS X con [MAMP](http://www.ma ## Problemi comuni -### Schermata bianca iniziale +### Schermata bianca -**Attenzione**: a partire dalla versione 2.3 questa problema non è più presente. +**Attenzione**: a partire dalla versione 2.3 questo problema non è più presente. Nel caso si verifichi il problema di schermata bianca iniziale è necessario controllare i valori delle variabili `$rootdir` e `$docroot` nelle prime righe di _core.php_. Una possibile soluzione, implementata dalla versione 2.3, potrebbe essere: ```php $docroot = __DIR__; -$rootdir = substr($_SERVER['SCRIPT_NAME'], 0, strrpos($_SERVER['SCRIPT_NAME'], '/')); +$rootdir = substr($_SERVER['SCRIPT_NAME'], 0, strrpos($_SERVER['SCRIPT_NAME'], '/')).'/'; if (strrpos($rootdir, '/'.basename($docroot).'/') !== false) { $rootdir = substr($rootdir, 0, strrpos($rootdir, '/'.basename($docroot).'/')).'/'.basename($docroot); +} else { + $rootdir = '/'; } +$rootdir = rtrim($rootdir, '/'); $rootdir = str_replace('%2F', '/', rawurlencode($rootdir)); ``` @@ -135,20 +134,29 @@ Si ricorda comunque che: - `$docroot` deve corrispondere al percorso reale nel file system per raggiungere la cartella principale del gestionale. - `$rootdir` deve corrispondere al percorso URL del browser per raggiungere il gestionale nel server web. -### Blocco dell'installazione allo 0% +### Blocco dell'installazione (0%) -**Attenzione**: a partire dalla versione 2.3 questa problema non è più presente. +**Attenzione**: a partire dalla versione 2.3 questo problema non è più presente. -Nel caso l'installazione iniziale del database si blocchi allo 0% è probabilmente necessario effettuare una modifica nel file di impostazione del DBMS (`my.ini` nel caso di MySQL). +Nel caso l'installazione iniziale del database si blocchi allo 0% è necessario effettuare la seguente modifica nelle righe 15, 16 e 17 del file `lib\dbo.class.php` (https://www.openstamanager.com/forum/viewtopic.php?f=4&t=88353#p93976): + +```php +if(@mysql_select_db($db_name, $conn)) { + @mysql_query("SET sql_mode = ''"); + return "ok"; +} else +``` + +Eventualmente, se questo primo passaggio si rivelasse non funzionante, si può procedere alla modifica delle impostazioni del DBMS (file `my.ini` di MySQL). ```ini #sql-mode="STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION" sql-mode="NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION" ``` -La riga preceduta da `#` è quella originale, mentre quella seguente è l'opzione che permette il corretto funzionamento dell'installazione. +La riga iniziante da `#` è quella originale, mentre quella seguente è l'opzione che permette il corretto funzionamento dell'installazione. -Discussioni originale: +Discussioni originali: - [\[RISOLTO\] Tabelle Mancanti](http://www.openstamanager.com/forum/viewtopic.php?f=2&t=86981) - [MySQL running in Strict Mode and giving me problems. How to fix this?](http://stackoverflow.com/questions/21667601/mysql-running-in-strict-mode-and-giving-me-problems-how-to-fix-this)