how to configure the official php app template?

Shopify Apps

Topic summary

A developer new to Shopify is encountering a 500 Server Error while trying to set up an app using the official PHP template from GitHub.

Configuration attempted:

  • Added CLIENT_ID and CLIENT_SECRET to the web/.env file
  • Followed README instructions without success
  • Believes database settings and migration are configured correctly

Environment details:

  • Windows, Yarn, Chrome (also tested Firefox and Edge with same results)

Current status:
The developer is unsure what additional configuration might be missing and is seeking guidance on troubleshooting the setup. The discussion remains open with no resolution yet.

Summarized with AI on November 5. AI used: claude-sonnet-4-5-20250929.
1

Hi, Im new to shopify and trying to delelop an shopify app with the php template https://github.com/Shopify/shopify-app-template-php. but the operations in readme didnt help me get things running.

I just put my

CLIENT_ID

and

CLIENT_SECRET

in web/.env. i keep getting 500 Server Error.

Webstollen_0-1727448658602.png
Webstollen_0-1727448658602.png1918×268 18 KB

i believe the database settings and migration to be ok.

Am i missing other things? i have no idea what can i do to make it right.

i use windows, yarn, chrome(also tried firefox, edge, none of them worked)

I would really appreciate any advice, thanks in advance.