We need some clear composer update instructions

I went from Mautic 4.4.4 to 4.4.6 and it was a total nightmare.

First I tried to follow this page.
Installing Mautic with Composer

No matter what I did Mautic wouldn’t update.

composer outdated showed the new packages to update. I delete composer.lock run the composer update again, still nothing.

I had to resort to manually updating the composer.json file with the new version number with a find replace. Then ran the command composer update and it worked. However, in the process of doing that, it turfed my local.php settings, which luck I was able to replace from backup. After doing that, everything came backup showing the latest version.

Please update that page with proper upgrade instructions with step-by-step commands. Composer for many is added complexity that just presents another path to blowing up their installation if not handled right.

Also, I made a little script to clean up permissions. Save it in a fix_mautic_permissions.sh file and execute it if you want to make sure everything is proper.

!#bin/bash

echo "Let's secure Mautic!"

echo 'Fixing file permisisons'
find . -type f -not -perm 644 -exec chmod 644 {} +
chmod +x fix_mautic_permissions.sh
echo 'Files corrected'

echo 'Fixing folder permissions'
find . -type d -not -perm 755 -exec chmod 755 {} +
chmod -R g+w docroot/var/cache/ docroot/app/config/
chmod -R g+w docroot/media/files/ docroot/media/images/ docroot/translations/
echo 'Folders corrected'

echo 'Dumping cache'
rm -rf docroot/var/cache/*
echo 'Cache cleared'
3 Likes