Instrucțiuni de instalare
Docker
Urmați aceste instrucțiuni pentru instalarea cu Docker.
Linux
Presupuneri
- Rulați Arch Linux + MariaDB + Apache.
- Codul-sursă va fi instalat în /srv/http/dexonline.
- Codul-sursă va fi accesat la http://localhost/dexonline/www/.
- MariaDB folosește utilizator=root, parolă=<vidă>, host=localhost, database=dexonline.
Pentru orice deviere de la aceste presupuneri, va trebui să adaptați instrucțiunile de mai jos.
Instalați pachetele necesare
sudo pacman -S apache mariadb php php-apache git gettext
Pachete opționale
Anumite scripturi (neesențiale pentru funcționarea clonei) folosesc funcții din pachete suplimentare:
sudo pacman -S php-curl php-xml
Clonați și inițializați repo-ul dexonline
cd /srv/http/
sudo git clone https://github.com/dexonline/dexonline
sudo chown -R utilizator.utilizator dexonline
cd dexonline
tools/setup.sh
Editați Config.php
Probabil va trebui să modificați doar valorile pentru
- URL_HOST și URL_PREFIX dacă accesați instalarea la altă adresă;
- DATABASE dacă folosiți alte valori pentru conexiune.
Creați fișierul descris în LOG_FILE și dați-i drept de scriere universal:
sudo touch /var/log/dexonline.log
sudo chmod 666 /var/log/dexonline.log
Descărcați baza de date
Importarea poate dura 5-10 minute. Nu avem o bază de date minimală, o folosim pe cea publică. Puteți citi documentația schemei bazei de date.
mysql -u root -e "create database dexonline charset utf8mb4 collate utf8mb4_romanian_ci"
wget -O /tmp/dex-database.sql.gz https://dexonline.ro/static/download/dex-database.sql.gz
zcat /tmp/dex-database.sql.gz | mysql -u root dexonline
php tools/migration.php
Dacă spațiul pe disc este o problemă, puteți economisi circa 1,7 GB prin Minimizarea bazei de date.
Modificați /etc/httpd/conf/httpd.conf (ca root)
Activați modulul rewrite: asigurați-vă că următoarea linie nu este comentată:
LoadModule rewrite_module modules/mod_rewrite.so
Configurați php-apache conform instrucțiunilor (secțiunea Using libphp).
Permiteți fișiere .htaccess:
<Directory "/srv/http">
...
AllowOverride All
....
</Directory>
(Re)porniți serviciile
sudo systemctl restart mariadb
sudo apachectl restart
Testați
Acum http://localhost/dexonline/www/ ar trebui să meargă.
OS X
Urmați aceste instrucțiuni de instalare pentru OS X cu MAMP
Ținerea la zi
Actualizați codul:
git pull
Git vă va anunța dacă au apărut modificări:
- în baza de date: rulați php tools/migration.php;
- în fișierul de configurare: preluați noutățile din Config.php.sample în Config.php;
- în fișierul de configurare Apache: preluați noutățile din www/.htaccess.sample în www/.htaccess.
Convenții de codare
Folosim stilul Google pentru Java. În principiu, dacă urmați stilul existent în cod, va fi cum trebuie.
În plus, referitor la limba română, veți avea nevoie să:
- vedeți corect diacriticele ĂÂÎȘȚ și alte câteva simboluri Unicode;
- tastați corect diacriticele românești; în particular, Ș și Ț cu virgulă, nu Ş și Ţ cu sedilă;
- folosiți diacritice în orice mesaje afișate către utilizator.
Localizare
Vedeți Localization.