|
6 жил өмнө | |
---|---|---|
compose | 6 жил өмнө | |
images | 6 жил өмнө | |
lib | 6 жил өмнө | |
CHANGELOG.md | 6 жил өмнө | |
LICENSE.md | 8 жил өмнө | |
README.md | 6 жил өмнө |
View Dockerfiles:
This configuration is intended to be used as a Docker-based development environment for both Magento 1 and Magento 2.
Folders:
images
: Docker images for nginx and phpcompose
: sample setups with Docker ComposeNginx assumes you are running Magento 2, however you can easily run it with Magento 1 using the provided configuration file. Here is an example of this setup with Docker Compose.
The PHP images are fairly agnostic to which version of Magento you are running. The PHP 5 images do assume you are running Magento 1, and the PHP 7 images do assume you are running Magento 2, however the main difference is cronjob setup, and they can be easily modified for inverse usage.
This setup assumes you are running Docker on a computer with at least 4GB of allocated RAM, a dual-core, and an SSD hard drive. Download & Install Docker Community Edition.
This configuration has been tested on Mac, Linux and Windows.
Magento 2, OS X & Linux Only
Run this automated one-liner from the directory you want to install your project to:
curl -s https://raw.githubusercontent.com/markoshust/docker-magento/master/lib/onelinesetup|bash -s -- magento2.test 2.3.0
The magento2.test
above defines the hostname to use, and the 2.3.0
defines the Magento version to install. Note that since we need a write to /etc/hosts
for DNS resolution, you will be prompted for your system password during setup.
After the one-liner above completes running, you should be able to access your site at http://magento2.test
.
Same result as the one-liner above. Just replace magento2.test
references with the hostname that you wish to setup.
# Quick setup for a new instance of Magento 2:
curl -s https://raw.githubusercontent.com/markoshust/docker-magento/master/lib/template|bash -s -- magento-2
bin/download 2.3.0
# or if you'd rather install with Composer, run:
#
# OPEN SOURCE:
#
# rm -rf src
# composer create-project --repository=https://repo.magento.com/ --ignore-platform-reqs magento/project-community-edition=2.3.0 src
#
# COMMERCE:
#
# rm -rf src
# composer create-project --repository=https://repo.magento.com/ --ignore-platform-reqs magento/project-enterprise-edition=2.3.0 src
echo "127.0.0.1 magento2.test" | sudo tee -a /etc/hosts
bin/start
bin/setup magento2.test
open http://magento2.test
Just replace magento2.test
references with the hostname that you wish to use.
# Quick setup for an existing instance of Magento 2
curl -s https://raw.githubusercontent.com/markoshust/docker-magento/master/lib/template|bash -s -- magento-2
# Replace the contents of /src with the source code of your existing Magento instance
echo "127.0.0.1 magento2.test" | sudo tee -a /etc/hosts
bin/start
bin/composer install
open http://magento2.test
Create the project template by going to the place you want the new project (ex. cd ~/Sites/magento2), then run
curl -s https://raw.githubusercontent.com/markoshust/docker-magento/master/lib/template|bash -s -- magento-2
Extract the contents of your current Magento site to the src
folder, or download a fresh copy of the Magento source code for starting a new project with:
bin/download 2.3.0
Add an entry to your local hosts file with your custom domain. Assuming the domain you want to setup is magento2.test
, enter the below. Be sure to use a .test
tld, as .localhost
and .dev
will present issues with domain resolution.
echo "127.0.0.1 magento2.test" | sudo tee -a /etc/hosts
Start your Docker containers with the provided helper script:
bin/start
For new projects: run Magento's setup install process with the below helper script. Feel free to edit this file to your liking; at the very least you will probably need to update the base-url
value to the domain you setup in step 3. Also, be sure to setup Composer Authentication before initiating the setup script.
bin/setup magento2.test
You may now access your site! Check out whatever domain you setup from within a web browser.
open http://magento2.test
The following scripts are meant to run with Powershell. Note that the execution policy for scripts needs to be set accordingly Execution policy.
Create the project template by going to the place you want the new project (ex. cd ~/Sites/magento2), then run
curl -s https://raw.githubusercontent.com/markoshust/docker-magento/master/lib/template|bash -s -- magento-2-windows
Extract the contents of your current Magento site to the src
folder, or download a fresh copy of the Magento source code for starting a new project with the following line. Note that the default untar command is quite slow. If you want to speed that up install 7-Zip and add it to your PATH. The script will automatically use 7-Zip if it is available:
bin/download 2.3.0
Copy magento into the docker container with bin/copymagento
. This is needed because of permission restrictions of shared data in Windows (see Troubleshooting Docker). The app
folder will however be shared with Windows for ease of development. For this folder the default permission 755 works just fine.
Add an entry to C:\Windows\System32\drivers\etc\hosts
with your custom domain: 127.0.0.1 magento2.test
(assuming the domain you want to setup is magento2.test
). Be sure to use a .test
tld, as .localhost
and .dev
will present issues with domain resolution.
Start your Docker containers with the provided helper script:
bin/start
For new projects: run Magento's setup install process with the below helper script. Feel free to edit this file to your liking; at the very least you will probably need to update the base-url
value to the domain you setup in step 4. Also, be sure to setup Composer Authentication before initiating the setup script.
bin/setup magento2.test
You may now access your site! Check out whatever domain you setup from within a web browser.
open http://magento2.test
bin/bash
: Drop into the bash prompt of your Docker container. The phpfpm
container should be mainly used to access the filesystem within Docker.bin/dev-urn-catalog-generate
: Generate URN's for PHPStorm and remap paths to local host. Restart PHPStorm after running this command.bin/cli
: Run any CLI command without going into the bash prompt. Ex. bin/cli ls
bin/composer
: Run the composer binary. Ex. bin/composer install
bin/copydir
: Copy a directory from the container to the host. Ex. bin/copydir vendor
bin/copydirall
: Copy all Magento directories from the container to the host. Ex. bin/copydirall
bin/download
: Download a version of Magento to the src
directory. Ex. bin/download 2.3.0
bin/fixperms
: This will fix filesystem ownerships and permissions within Docker.bin/grunt
: Run the grunt binary. Note that this runs the version from the node_modules directory for project version parity. Ex. bin/grunt exec
bin/magento
: Run the Magento CLI. Ex: bin/magento cache:flush
bin/node
: Run the node binary. Ex. bin/node --version
bin/npm
: Run the npm binary. Ex. bin/npm install
bin/remove
: Remove all containers. Ex. bin/remove
bin/restart
: Stop and then start all containers. Ex. bin/restart
bin/root
: Run any CLI command as root without going into the bash prompt. Ex bin/root apt-get install nano
bin/setup
: Run the Magento setup process to install Magento from the source code, with optional domain name. Defaults to magento2.test
. Ex. bin/setup magento2.test
bin/start
: Start all containers. This includes helper for bi-directional file sync, so be sure to use this instead of docker-compose up -d
. Ex. bin/start
bin/stop
: Stop all containers. Ex. bin/stop
bin/xdebug
: Disable or enable Xdebug. Ex. bin/xdebug enable
docker-compose.yml
file. So for example, MySQL's hostname is db
(not localhost
) when accessing it from within a Docker container. Elasticsearch's hostname is elasticsearch
.First setup Magento Marketplace authentication (details in the DevDocs).
After doing so, copy the auth sample file to:
cp src/auth.json.sample src/auth.json
Then update the username and password values with your Magento public and private keys, respectively.
Install and enable the PHP Debug extension from the Visual Studio Marketplace.
Otherwise, this project now automatically sets up Xdebug support with VS Code. If you wish to set this up manually, please see the .vscode/launch.json
file.
First, install the Chrome Xdebug helper. After installed, right click on the Chrome icon for it and go to Options. Under IDE Key, select PHPStorm from the list and click Save.
Next, enable Xdebug in the PHP-FPM container by running: bin/xdebug enable
, the restart the docker containers (CTRL+C then bin/start
).
Then, open PHPStorm > Preferences > Languages & Frameworks > PHP
and configure:
CLI Interpreter
:
From Docker
, and name it markoshust/magento-php:7-2-fpm
.Docker
, then select the markoshust/magento-php:7-2-fpm
image name, and set the PHP Executable
to php
.Path mappings
:
Docker container
step will automatically setup a path mapping from /var/www/html
to ./src
.Docker container
:
/var/www/html
mapped to the Host path of ./src
.Open PHPStorm > Preferences > Languages & Frameworks > PHP > Debug
and set Debug Port to 9001
.
Open PHPStorm > Preferences > Languages & Frameworks > PHP > DBGp Proxy
and set Port to 9001
.
Open PHPStorm > Preferences > Languages & Frameworks > PHP > Servers
and create a new server:
magento2.test
)8000
src
to the absolute path of /var/www/html
Go to Run > Edit Configurations
and create a new PHP Remote Debug
configuration by clicking the plus sign and selecting it. Set the Name to your domain (ex. magento2.test
). Check the Filter debug connection by IDE key
checkbox, select the server you just setup, and under IDE Key enter PHPSTORM
. This IDE Key should match the IDE Key set by the Chrome Xdebug Helper. Then click OK to finish setting up the remote debugger in PHPStorm.
Open up src/pub/index.php
, and set a breakpoint near the end of the file. Go to Run > Debug 'magento2.test'
, and open up a web browser. Ensure the Chrome Xdebug helper is enabled by clicking on it > Debug. Navigate to your Magento store URL, and Xdebug within PHPStorm should now trigger the debugger and pause at the toggled breakpoint.