From 0e34a79bcd4a3e75ebd96ac5dd45d45e57f06e70 Mon Sep 17 00:00:00 2001 From: Jonathan Carter Date: Wed, 1 May 2019 07:52:46 -0700 Subject: [PATCH] Initial commit --- README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 46 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 29f7ebd..8093efa 100644 --- a/README.md +++ b/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 ctrl+shift+\` 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 F5 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 F1 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 F1 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.
+Licensed under the MIT License. See LICENSE in the project root for license information. \ No newline at end of file