Adressermittlung.de

Installation

Systemvoraussetzungen

• PHP >= 7.0
• ext-soap
• ext-json
• eine existierende (leere) Datenbank.

Ordnerstruktur

├── bin/
└── www/

Die Ordner sind im Prinzip beliebig benennbar. Im Verzeichnis www wird das Projekt ausgechecked und in bin liegen benötigte binaries. Es muss deshalb darauf geachtet werden, dass bin im pfad liegt:

echo "export PATH=\$PATH:~/bin" >> ~/.bashrc

composer

composer installieren via

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
mv composer.phar ~/bin/composer

wkhtmltopdf

• Wird benötigt, um aus html-Ansichten PDFs zu generieren.
• Download unter: https://wkhtmltopdf.org/downloads.html
• Da unser System ein Debian 9 64Bit System ist, benötigen wir diese Variante: https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox_0.12.5-1.stretch_amd64.deb

Installationsanleitung für Debian-System:

cd ~
wget https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox_0.12.5-1.stretch_amd64.deb
dpkg -x wkhtmltox_0.12.5-1.stretch_amd64.deb .
cp usr/local/bin/* bin/
rm -r usr
rm wkhtmltox_0.12.5-1.stretch_amd64.deb

Installation des Projekts

Ins Projektverzeichnis wechseln und Repository auschecken:

cd ~/www
git clone git@bitbucket.org:adressermittlung/adressermittlung.git .

Abhängigkeiten installieren:

composer install
composer update

Die Ordnerstruktur sollte nun wie folgt aussehen:

├── bin/
│   ├── composer
│   ├── wkhtmltoimage
│   └── wkhtmltopdf
└── www/
    ├── bin/
    ├── config/
    ├── public/
    ├── src/
    ├── templates/
    ├── vendor/
    ├── composer.json
    ├── composer.lock
    ├── .env.dist
    ├── .gitignore
    ├── README.md
    └── symfony.lock

Konfiguration

Alle wesentlichen Konfigurationsparameter stehen in .env.dist, jedoch sind diese leer, bzw. mit Beispieldaten belegt. Denn, Regel Nr. 1: Niemals nie keine Passwörter ins Repository!!!1elf

Es muss im nächsten Schritt eine neue Konfigurationsdatei aus der Vorlage erstellt werden:

cd ~/www
cp .env.dist .env

Die Konfiguration sollte vollständig und gewissenhaft befüllt werden, mit besonderem Augenmerk auf APP_ENV, welches dev oder prod sein kann und damit auf eine Entwicklungs- oder Liveumgebung hindeutet. Alle anderen Konfigurationsparameter sollten dann entsprechend Test- oder Livedaten sein.

Datenbank

Konfiguration der Datenbank und -verbindung:

# ~/www/.env
...
DATABASE_URL=mysql://db_user:db_password@db_host:db_port/db_name
...

Erstellung der Tabellen:

cd ~/www
bin/console doctrine:schema:update --force

E-Mail-Versand via smtp

Zugangsdaten im Projectfacts

# ~/www/.env
...
MAILER_URL=smtp://mail.webfox01.net:587?encryption=tls&auth_mode=login&username={username}&password={passwort}
...

Es muss darauf geachtet werden, dass username und passwort url-enkodiert sein müssen, falls sie Sonderzeichen enthalten.

PayPal

• Zugangsdaten im Projectfacts (Hauptaccount)
• Einloggen auf https://developer.paypal.com/
• Auf https://developer.paypal.com/developer/applications/ unten unter REST API apps die entsprechende App auswählen (Adressermittlung)
• Dort findet man oben einen Schalter für Sandbox und Live und die entsprechenden Zugangsdaten (Client ID und Secret)

Stripe

• Zugangsdaten im Projectfacts
• Einloggen auf https://dashboard.stripe.com/login
• API-Zugangsdaten unter https://dashboard.stripe.com/account/apikeys
• Test-API-Zugangsdaten bekommt man auf der gleichen Seite wenn man unten links im Menü den Schalter View test data aktiviert
• STRIPE_PUBLIC_KEY in unserer Config entspricht dem Publishable key
• STRIPE_API_KEY in unserer Config entspricht dem Secret key

• Webhook

  • wechsel zu https://dashboard.stripe.com/account/webhooks
  • Auch hier zwischen live und dev unterscheiden: unten links View test data an oder aus
  • Falls noch nicht geschehen, Webhook einrichten:
    • + Add endpoint
    • URL to be called: /stripe/webhook
      • Beispiel dev: http://wf10501.webfox01.de/stripe/webhook
      • Beispiel live: https://adressermittlung.de/stripe/webhook
      • Ändert sich die URL der Seite, dann unbedingt anpassen!
    • Filter event: Select types to send
      • Folgendes auswählen: charge.failed, charge.succeeded, source.canceled, source.chargeable, source.failed
  • Klick auf (existenten oder neu erstellten) Webhook
  • Unten bei Signing secret auf Click to reveal klicken
  • Der Code wird in unserer Config bei STRIPE_WEBHOOK_SIGNATURE eingetragen

RISER ID

• Zugansdaten im Projectfacts
• RISER_EMPLOYEE muss mit Kennung befüllt werden
• Für dev: RISER_CLIENT_NAME muss leer bleiben
• Für live: RISER_CLIENT_NAME muss mit Name Auftraggeber (siehe projectfacts) befüllt werden

SMS-Versand (Massenversand.de)

Siehe Projectfacts Zugang Massenversand.de > API

Sonstiges

Die anderen Felder sollten selbsterklärend sein. INQUIRY_PRICE und TAX werden als float angegeben,TAX muss dabei das Format 0.19 haben, wenn die Steuer 19% beträgt.

WEBSITE_HOST und WEBSITE_SCHEME sind für die Cronjobs notwendig, da die nicht über den Webserver laufen und deswegen auch nicht die Seiten-URL kennen. Die wird aber für Rechnungserstellung und E-Mail-Versand benötigt. Beipsile für live:

WEBSITE_HOST=adressermittlung.de
WEBSITE_SCHEME=https