Skip to content

Hello World tutorial

Jump to bottom Edit New page
Greg Bowler edited this page Mar 7, 2019 · 34 revisions

Outputting "Hello, World!" from WebEngine is as simple as writing the message in the page/index.html file and serving it. Even though this task seems very simplistic, it serves a purpose in acting as a more in-depth guide in setting up the environment for running WebEngine apps, and acts as a basis for the future follow-on tutorials.

Before we jump into setting up the environment, here's a spoiler:

page/index.html

<!doctype html>
<h1>Hello, World!</h1>

Then run gt run from the project root and visit http://localhost:8080 to see your glorious program in action.

Installing WebEngine

Other installation methods are documented in Installation, but if you are able to use the automated installer, you can use Composer to create new WebEngine applications very quickly.

If you have not got PHP or Composer installed, you will need to do that first -- check the PHP environment setup section for a guide on how to do this.

Once you have Composer set up, and can type composer from the terminal, run the command composer --global require phpgt/installer. This installs the Installer repository for you globally, making the gt command available in your terminal. After running the command and gt is still not available, double check you have added the Composer's bin directory to your PATH environment variable, as described in [[Adding gt to your PATH]]

// TODO: CLI installation process.

Starting a new project

// TODO: gt create hello-world

// TODO: Explain how project can be created manually: mkdir hello-world && cd hello-world && composer require phpgt/webengine

Editing index.html

// TODO: Write the "Hello, World!" message.

// TODO: File structure that makes up WebEngine projects is described in Project layout.

Serving the application

// TODO: Run gt run and explain what it does.

// TODO: More details on setting up servers is documented in Running your application.

Accessing the application in a web browser

// TODO: http://localhost:8080

Next step: Adding dynamic content

// TODO: Link on to next tutorial.

Website | Packagist | Github

Introduction

Tutorials

User guide

Further reading

Setup guides

Clone this wiki locally