drmaterac.pl/.paul/codebase/stack.md

Technology Stack

Analysis Date: 2026-05-10

Languages

Primary:

• PHP 7.4 / 8.2.x runtime — All application code (PrestaShop targets PHP 7.4; current server reports 8.2.12)
• JavaScript (ES5/ES6 transpiled) — Theme assets and module front-end behavior

Secondary:

• Smarty templates (.tpl) — Front-end rendering layer
• Twig templates — Symfony admin layer
• Sass/SCSS — Theme styling (themes/leo_gstore/config.rb Compass config)
• HTML5/CSS3 — Presentation
• SQL (MySQL) — Data layer

Runtime

Environment:

• PHP (declared 7.4 in PrestaShop core; current PHP-CLI 8.2.12) — app/AppKernel.php
• Apache web server with mod_rewrite — .htaccess (429 lines of rewrite rules)
• MySQL with InnoDB — app/config/parameters.php

Package Manager:

• Composer (PHP) — composer.lock present at root
• npm (JS, theme-only) — themes/package-lock.json

Frameworks

Core:

• PrestaShop 1.7.8.11 — app/AppKernel.php line 35
• Symfony (FrameworkBundle, SecurityBundle, TwigBundle, MonologBundle, SwiftmailerBundle, DoctrineBundle) — app/AppKernel.php
• Doctrine ORM — used for admin/back-office Symfony layer
• Smarty — front-office template engine — config/smarty.config.inc.php, config/smartyfront.config.inc.php

Testing:

• PHPUnit (~5.7) — present only in select PrestaShop modules (modules/ps_facetedsearch/, modules/gamification/)
• Mockery — modules/ps_facetedsearch/tests/php/
• PHPStan via prestashop/php-dev-tools — modules/*/tests/phpstan/phpstan.neon (40+ modules)
• No root-level test setup; custom modules have no tests

Build/Dev:

• Babel 7.0.0-rc.1 — themes/package-lock.json
• Compass/Sass — themes/leo_gstore/config.rb
• Pre-built theme bundles — themes/leo_gstore/assets/cache/*.js, themes/leo_gstore/assets/cache/*.css

Key Dependencies

Critical (PHP):

• Guzzle HTTP client (v6/v7) — used by paynow, empikmarketplace, smartsupp
• Symfony components (Cache, DI, YAML, FileSystem) — core + modules
• PSR-7/PSR-11/PSR-15 interfaces — HTTP messaging
• pay-now-php-sdk — payment integration in modules/paynow/
• br33f/php-ga4-mp — GA4 Measurement Protocol — modules/pdgoogleanalytycs4pro/
• libphonenumber-for-php — phone validation (GA4 enhanced conversions)
• google/recaptcha — modules/eicaptcha/vendor/google/recaptcha/

Critical (JS):

• jQuery — bundled in theme (themes/leo_gstore/assets/cache/bottom-*.js)
• Slick carousel — themes/leo_gstore/assets/js/custom.js
• Moment.js — js/date.js
• CodeMirror — modules/advancedpopupcreator/

Configuration

Environment:

• Database/secrets in app/config/parameters.php (plain PHP — secrets currently committed, see concerns.md)
• Symfony YAML — app/config/config.yml, app/config/parameters.yml
• Constants: config/defines.inc.php (paths, _PS_ADMIN_DIR_ etc.)
• Bootstrap: config/bootstrap.php, config/config.inc.php
• Locale: pl-PL — app/config/parameters.php
• DB prefix: materac_ (schema admin_drmaterac)

Build:

• Theme assets: pre-bundled to themes/leo_gstore/assets/cache/
• No root composer.json build pipeline; modules ship pre-built

Platform Requirements

Development:

• Apache + PHP 7.4+ + MySQL stack
• Composer for PHP dependencies
• Node/npm only required for theme rebuild

Production:

• Shared/dedicated hosting with Apache + mod_rewrite
• SMTP transport configured to 127.0.0.1:25 — app/config/parameters.php
• Memcached configured but disabled (ps_caching: CacheMemcached, ps_cache_enable: false)
• WebP image delivery via .htaccess content negotiation + modules/x13webp/
• Multi-domain: serves both drmaterac.pl and lulandia.pl from same install — .htaccess

---

Stack analysis: 2026-05-10 Update after major dependency changes