Skip to content

Instantly share code, notes, and snippets.

@beryllium
Last active April 9, 2018 03:49
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save beryllium/f6a19d19af41065cba40893ad4884729 to your computer and use it in GitHub Desktop.
Save beryllium/f6a19d19af41065cba40893ad4884729 to your computer and use it in GitHub Desktop.

Sculpin on Windows

Pre-Requisites

You'll need to have:

  • PHP 7.2 installed and configured in your path (so you can run php just by typing "php").
    • You'll probably need a few extensions enabled, like curl and openssl and maybe mbstring and a few others.
  • Git installed and configured in your path (so composer can use it).
  • Composer installed and (ideally) configured with a DOSKEY alias (so it's most useful for you! :) )

Jeff Geerling has written some handy instructions for installing PHP 7 and Composer on Windows 10. His post covers a step that I've missed here, which is to install the Visual C++ Redistributable for Visual Studio 2015. (The VM I was testing on evidently had that included. Oops.)

Get the Skeleton

Clone the Sculpin 3.x skeleton from git:

$ git clone -b 3.x https://github.com/sculpin/sculpin-blog-skeleton myblog

Install the dependencies:

$ doskey composer=php c:\path\to\composer.phar $*
$ cd myblog
$ composer install

Run the generate command with --watch and --server:

vendor\bin\sculpin generate --watch --server

Make It So

Technically, this is not your own project yet - it's still a clone of the sculpin skeleton.

You'll want to remove the .git folder and do a fresh git init to give it your own version control history.

$ rmdir /s .git
$ git init

Before you git add everything, you'll probably want to add "vendor" to the .gitignore.

If paths are an issue ...

It might be annoying to adjust your PATH variable. If that's the case, the "doskey" trick above can be helpful, but you'll still need git to be in your path for Composer to work.

Also, if php is not in your path, you'll have to manually modify vendor\bin\sculpin.bat to use c:\php\php.exe (or the equivalent on your system) for Sculpin commands to work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment