Composer Installation on Windows – Help Center


Here are some common errors you might encounter when installing Smart Report Maker via Composer on Windows OS. These issues often stem from environment configurations, missing dependencies, or permissions settings unique to Windows. This guide will help you identify and troubleshoot frequent installation problems to ensure a smooth setup of Smart Report Maker.

1- Command not recognized issue

The symptoms of this error include receiving the following error message when executing the installation script: ” .\install.ps1 not recognized as an internal or external command, operable program or batch file”

Possible Reasons

  • You are using Command prompt not PowerShell
  • Make sure you’re in the correct Path
  • PowerShell is not allowed to run scripts

Potential Solutions

  • Make sure you are using PowerShell
  • Make sure you’re in the correct directory, or use the full path to the script
  • Make sure PowerShell is allowed to run scripts by running the following command
Set-ExecutionPolicy Unrestricted

2- Execution of scripts is disabled

The symptoms of this error include receiving one of the following error messages when executing the installation script:

1 – “.\install.ps1 cannot be loaded because the execution of scripts is disabled on this system.”

2- “.\install.ps1 file is not digitally signed. You cannot run this script on the current system. For more information about running scripts and setting execution policy, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170”

Potential Solution

Make sure PowerShell is allowed to run scripts by running the following command

Set-ExecutionPolicy Unrestricted

3- PHP can not be found

The symptoms of this error include receiving the following error message when executing the installation script:

“The setup halted at the Checking PHP Availability step. The issue encountered was + {{ More error details }}“

Possible Reasons

1- PHP is not installed: The system couldn’t locate a PHP installation on your Windows OS.

2- Incorrect PHP Path in Installation Script: If you’ve manually provided a path to PHP in the installation script, it may be incorrect. Ensure that the path points directly to the PHP executable file. An example path might look like:
C:\php\php.exe

Potential Solution

1- Ensure that Apache, PHP, and MySQL are installed on your Windows OS. Alternatively, you can install XAMPP, which includes Apache, PHP, and MySQL in one package.

2- Make sure the PHP path you provide to the install script when prompted is correct. The path should end with php.exe and look similar to C:\php\php.exe

4- An Issue with Git Installation

The symptoms of this error include receiving the following error message when executing the installation script:

“The setup halted at the Checking and Installing Git step. The issue encountered was + + {{ More error details }}”

Possible Reasons:

  1. The system is unable to download Git, which is required to proceed with the installation process.
  2. The system downloaded Git but encountered an issue during the installation.

Potential Solution:

  1. Manually download and install Git on your Windows OS from this link. Once Git is installed, try running the installation script again in PowerShell by running the following command once again:
powershell -ExecutionPolicy Bypass -File .\install.ps1