Shop Project - Documentation
Developer Quickstart
Key first steps for new developers for local analysis and debugging.
Prerequisites
Ensure PHP 8.x and MySQL/MariaDB are running.
Set up local environment
Since the project is currently synchronized locally via Seafile and there is no public repository, I have developed a special "environment logic" to facilitate your entry. You can flexibly place this script in the root directory or in any parent folder where you manage multiple projects.\n Simply place your project folders as direct subfolders next to these environment files. The system automatically searches for entry points (like index.php, index.html, or public/index.php) and lists all found projects neatly and clearly in your browser.
Choose your operating system for specific installation instructions:
Windows (XAMPP)
- Install XAMPP with Xdebug if not already installed.
- Place the environment files (index.php, favicon, language switcher, etc.) in a folder of your choice, e.g., C:/xampp/htdocs/.
- Copy the project folder into the same directory.
- Open the XAMPP Control Panel and start Apache and MySQL.
- To ensure cross-platform compatibility with Linux, set the MySQL password for the "root" user to "dev" using:
mysqladmin -u root password dev.
Linux (LAMP)
- Move the project to /var/www/html/ and fix permissions:
sudo chown -R $USER:$USER /var/www/html/. - Enable password login for MariaDB root:
ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('dev');. - If using DBeaver as a Flatpak, enable network access with:
flatpak override --user --share=network io.dbeaver.DBeaverCommunity.