/processwire-starter

Experimenting/exploring ProcessWire

Primary LanguagePHPOtherNOASSERTION

ProcessWire starter

My repo for experimenting with ProcessWire.

For the full official README: https://github.com/processwire/processwire/blob/master/README.md

Startup short version:

  1. Is Apache running?

    • apache2ctl status or service apache2 status to check
    • sudo apache2ctl start or service apache2 start to fire it up
    • apache2ctl stop and apache2ctl restart (or the service apache2 equivalents) if there's a problem

    You may run into an issue with "mod rewrite." sudo a2enmod rewrite will indicate whether it's installed/enabled.

  2. Is MySQL running?

    • mysql.server status to check
    • mysql.server start if it isn't

  3. Is the PHP server running?

    • php -S localhost:3033

Post-installation notes:

  • Runtime errors are logged to /site/assets/logs/errors.txt
  • /wire/config.php shows configuration options. Edits should go in /site/config.php
  • Edit the .htaccess file to force HTTPS, setup redirects, and other things

Table of Contents

Reference

Installing ProcessWire

Simply extract the ProcessWire files to an http accessible location and load the URL in your web browser. This will start the installer. See our Installation Guide for more details and instructions. If you run into any trouble, please see our Troubleshooting Guide.

Upgrading ProcessWire

Upgrading is easy and usually just a matter of replacing your /wire/ directory with the one from the new version. But to be safe, before proceeding with any version upgrade, please see the Upgrading ProcessWire guide and perhaps keep it open during your upgrade in case you need to refer back to it.

When upgrading from one 3.x version to another, please use the general upgrade process. This consists primarily of making sure you've got everything backed up and then just replacing your /wire/ directory with the one from the newer version.

Debug Mode

Debug mode causes all errors to be reported to the screen. This can be helpful during development or troubleshooting. When in the admin, it also enables a “Debug” link (see footer) for reporting of extra information in a panel. Debug mode is not intended for live or production sites, as the information reported is for the developer only. Do not leave debug mode on for any live/production sites, as it could be a security concern. However, we think you'll find it very handy during development or when resolving issues.

  1. Edit this file: /site/config.php
  2. Find this line: $config->debug = false;
  3. Change the false to true like below, and save.
$config->debug = true;

This can be found near the bottom of the file, or you can add it if not already there. It will make PHP and ProcessWire report all errors, warnings, notices, etc. Of course, you'll want to set it back to false once you've resolved any issues.

Support and Links

Copyright 2023 by Ryan Cramer / Ryan Cramer Design, LLC