Adds Docker support for TravianZ

Introduces Docker Compose configuration for simplified deployment.

Includes a Dockerfile to build the application image and necessary configurations for running TravianZ in a containerized environment.

Provides documentation for setup and usage in `DOCKER_README.md`.

DOCKER_README.md

@@ -0,0 +1,314 @@
+# TravianZ Docker Setup
+
+This guide will help you set up TravianZ using Docker and Docker Compose for easy deployment.
+
+## Prerequisites
+
+- Docker Engine 20.10 or higher
+- Docker Compose 1.29 or higher
+- At least 2GB of free RAM
+- At least 5GB of free disk space
+
+## Quick Start
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/Shadowss/TravianZ.git
+cd TravianZ
+```
+
+### 2. Configure Environment Variables
+
+Copy the example environment file and customize it if needed:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` file to set your database credentials:
+
+```env
+MYSQL_ROOT_PASSWORD=yourStrongRootPassword
+MYSQL_DATABASE=travian
+MYSQL_USER=travianz
+MYSQL_PASSWORD=yourStrongPassword
+```
+
+### 3. Start the Containers
+
+```bash
+docker-compose up -d
+```
+
+This command will:
+- Build the TravianZ web application container
+- Start a MySQL 5.7 database container
+- Start a phpMyAdmin container for database management
+- Set up a network for all containers to communicate
+
+### 4. Access the Installation Wizard
+
+Once the containers are running, open your browser and navigate to:
+
+```
+http://localhost:8080/install
+```
+
+### 5. Complete the Installation
+
+During the installation wizard, use these database settings:
+
+- **SQL Hostname:** `db` (this is the Docker container name)
+- **Port:** `3306`
+- **Username:** `travianz` (or the value from your `.env` file)
+- **Password:** `travianzpass` (or the value from your `.env` file)
+- **DB name:** `travian` (or the value from your `.env` file)
+- **Prefix:** `s1_` (or customize as needed)
+- **Type:** `MYSQLi`
+
+Complete the rest of the installation wizard with your preferred server settings.
+
+## Services and Ports
+
+After starting the containers, the following services will be available:
+
+- **TravianZ Web Application:** http://localhost:8080
+- **phpMyAdmin:** http://localhost:8081
+- **MySQL Database:** localhost:3306 (for external connections)
+
+## Container Management
+
+### View Running Containers
+
+```bash
+docker-compose ps
+```
+
+### View Logs
+
+```bash
+# All containers
+docker-compose logs
+
+# Specific container
+docker-compose logs web
+docker-compose logs db
+docker-compose logs phpmyadmin
+
+# Follow logs in real-time
+docker-compose logs -f web
+```
+
+### Stop Containers
+
+```bash
+docker-compose down
+```
+
+### Stop and Remove All Data
+
+**WARNING:** This will delete all database data!
+
+```bash
+docker-compose down -v
+```
+
+### Restart Containers
+
+```bash
+docker-compose restart
+```
+
+### Rebuild Containers
+
+If you make changes to the Dockerfile or application code:
+
+```bash
+docker-compose down
+docker-compose up -d --build
+```
+
+## Accessing the Containers
+
+### Access Web Container Shell
+
+```bash
+docker exec -it travianz-web bash
+```
+
+### Access MySQL Container
+
+```bash
+docker exec -it travianz-db mysql -u root -p
+```
+
+Enter the root password from your `.env` file.
+
+## Troubleshooting
+
+### Installation Files Not Writable
+
+If you get permission errors during installation:
+
+```bash
+docker exec -it travianz-web chown -R www-data:www-data /var/www/html
+docker exec -it travianz-web chmod -R 777 /var/www/html/var
+```
+
+### Database Connection Failed
+
+1. Make sure the database container is running:
+   ```bash
+   docker-compose ps
+   ```
+
+2. Check database logs:
+   ```bash
+   docker-compose logs db
+   ```
+
+3. Verify the hostname is set to `db` (not `localhost` or `127.0.0.1`)
+
+### Reset Installation
+
+If you need to start the installation over:
+
+1. Stop containers:
+   ```bash
+   docker-compose down -v
+   ```
+
+2. Remove the installed flag:
+   ```bash
+   rm -f var/installed
+   rm -f GameEngine/config.php
+   ```
+
+3. Start containers again:
+   ```bash
+   docker-compose up -d
+   ```
+
+4. Access the installation wizard again at http://localhost:8080/install
+
+### Port Already in Use
+
+If port 8080 or 8081 is already in use, edit `docker-compose.yml` and change the ports:
+
+```yaml
+services:
+  web:
+    ports:
+      - "9080:80"  # Change 8080 to any available port
+  phpmyadmin:
+    ports:
+      - "9081:80"  # Change 8081 to any available port
+```
+
+## Backup and Restore
+
+### Backup Database
+
+```bash
+docker exec travianz-db mysqldump -u root -p travian > backup_$(date +%Y%m%d).sql
+```
+
+### Restore Database
+
+```bash
+docker exec -i travianz-db mysql -u root -p travian < backup_20231125.sql
+```
+
+### Backup Application Files
+
+```bash
+tar -czf travianz_backup_$(date +%Y%m%d).tar.gz \
+  --exclude='./var/db' \
+  --exclude='./.git' \
+  .
+```
+
+## Production Deployment
+
+For production environments, consider the following:
+
+1. **Use Strong Passwords:** Change all default passwords in `.env`
+
+2. **Use SSL/TLS:** Set up a reverse proxy (nginx/traefik) with Let's Encrypt
+
+3. **Limit Database Access:** Remove the database port exposure in `docker-compose.yml`
+
+4. **Regular Backups:** Set up automated backup scripts
+
+5. **Resource Limits:** Add resource constraints to containers:
+
+```yaml
+services:
+  web:
+    deploy:
+      resources:
+        limits:
+          cpus: '1.0'
+          memory: 1G
+```
+
+6. **Monitoring:** Consider adding monitoring tools like Prometheus and Grafana
+
+## Performance Optimization
+
+### MySQL Tuning
+
+Edit `docker-compose.yml` to add MySQL configuration:
+
+```yaml
+services:
+  db:
+    command: >
+      --default-authentication-plugin=mysql_native_password
+      --sql_mode=""
+      --max_connections=200
+      --innodb_buffer_pool_size=512M
+      --query_cache_size=32M
+      --query_cache_limit=2M
+```
+
+### PHP Tuning
+
+Create a custom PHP configuration file `php-custom.ini`:
+
+```ini
+memory_limit = 256M
+upload_max_filesize = 20M
+post_max_size = 20M
+max_execution_time = 300
+```
+
+Then mount it in `docker-compose.yml`:
+
+```yaml
+services:
+  web:
+    volumes:
+      - ./php-custom.ini:/usr/local/etc/php/conf.d/custom.ini
+```
+
+## Updates
+
+To update TravianZ to the latest version:
+
+```bash
+git pull origin main
+docker-compose down
+docker-compose up -d --build
+```
+
+## Support
+
+For issues and questions:
+- GitHub Issues: https://github.com/Shadowss/TravianZ/issues
+- Gitter Chat: https://gitter.im/TravianZ-V8/Lobby
+
+## License
+
+TravianZ Project - See LICENSE file for details