Initial commit

README.md

@@ -1,7 +1,46 @@
+# Try Out Development Containers: PHP
 
-# Contributing
+This is a sample project to go along with the "Try a dev container" quick start for the **[VS Code Remote - Containers](https://aka.ms/vscode-remote/containers)** extension.
 
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+**If you are not yet in a development container, [see below](#setting-up-the-development-container).**
+
+## Things to try
+
+Once you have this sample opened in a container, you'll be able to work with it like you would locally.
+
+Some things to try:
+
+1. **Edit:**
+   - Open `index.php`
+   - Try adding some code and check out the language features.
+1. **Terminal:** Press <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>\`</kbd> and type `uname` and other Linux commands from the terminal window.
+1. **Build, Run, and Debug:**
+   - Open `index.php`
+   - Add a breakpoint (e.g. on line 4).
+   - Press <kbd>F5</kbd> to launch the app in the container.
+   - Once the breakpoint is hit, try hovering over variables, examining locals, and more.
+1. **Running a server:**
+   - From the terminal, run `php -S localhost:8000`
+   - Press <kbd>F1</kbd> and run the **Remote-Containers: Forward Port from Container...** command.
+   - Select port `8000`.
+   - Click "Open Browser" in the notification that appears to access the web app on this new port.
+   - Look back at the terminal, and you should see the output from your site navigations
+   - Edit the text on line 16 in `index.php` and refresh the page to see the changes immediately take affect
+   
+## Setting up the development container
+
+Follow these steps to open this sample in a container:
+
+1. If this is your first time using a development container, please follow the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started) to get set up.
+
+2. If you're not yet in a development container:
+   - Clone this repository.
+   - Press <kbd>F1</kbd> and select the **Remote-Container: Open Folder in Container...** command.
+   - Select the cloned copy of this folder, wait for the container to start, and try things out!
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
 the rights to use your contribution. For details, visit https://cla.microsoft.com.
 
@@ -12,3 +51,8 @@ provided by the bot. You will only need to do this once across all repos using o
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## License
+
+Copyright © Microsoft Corporation All rights reserved.<br />
+Licensed under the MIT License. See LICENSE in the project root for license information.