Editando Manual d'usuari de Gestió Monedes (sección)

== 16. Dependències i resolució de problemes ==

=== Dependències principals ===

Totes les dependències es gestionen amb el gestor de paquets del sistema operatiu. No hi ha cap biblioteca externa de PHP ni cap gestor de paquets addicional.

* <code>apache2</code> o <code>nginx</code> — servidor web
* <code>php</code> + <code>libapache2-mod-php</code> — motor d'aplicació (8.0+)
* <code>php-mysql</code> — extensió PDO per a MariaDB
* <code>php-mbstring</code> — codificació de caràcters multibyte
* <code>php-xml</code> — processament XML per a importació i exportació
* <code>php-fileinfo</code> — validació del tipus MIME d'imatges
* <code>mariadb-server</code> — sistema de gestió de base de dades
Per verificar que totes les extensions estan actives:

<pre>
php -m | grep -E &quot;pdo_mysql|mbstring|simplexml|fileinfo&quot;
</pre>

=== Resolució de problemes habituals ===

Si hi ha un error de connexió a la base de dades, comprova les credencials i l'estat del servei:

<pre>
sudo systemctl status mariadb
</pre>

Si una imatge no es pot desar, revisa els permisos del directori d'uploads:

<pre>
chmod 755 /var/www/html/gestio_monedes/uploads/
chown www-data:www-data /var/www/html/gestio_monedes/uploads/
</pre>

Si la pàgina apareix en blanc, activa temporalment el mode de depuració i revisa els registres:

<pre>
export GESTIO_MONEDES_APP_DEBUG=1
tail -f /var/log/apache2/error.log
</pre>

Si les imatges pujades pesen massa i donen error 413, augmenta els límits a <code>php.ini</code>:

<pre>
upload_max_filesize = 10M
post_max_size = 12M
</pre>

I reinicia el servidor web:

<pre>
sudo systemctl restart apache2
</pre>