Hello Phoenix

Code examples and demonstration apps built in Phoenix 1.3 while reading through the Phoenix Guides.

A Cheat-Sheet of Sorts

This is not a tutorial. :) I made these code examples in order to have a direct link between content in the guides and code in a working and deployed Phoenix app.

Note that while Phoenix apps are very responsive, these demo apps are deployed to free Heroku dynos which go to sleep after 30 minutes of inactivity. When you click on a demo link, there will be a delay while the dyno activates.

Contact: @smeade.

Guides

• Up and Running
  • mix.phx new guide | code | demo
  • Deploying to Heroku guide
• Adding Pages
  • A purely static page
    • Overview guide | demo
    • A New Route guide | code
    • A New Controller and Index Action guide | code
    • A New View guide | code
    • A New Template: index.html.eex guide | code | demo
  • Another New Page: Sending Parameters
    • Overview guide | demo
    • Another New Route guide | code
    • A New Action: show guide | code
    • Another New Template: show.html.eex guide | code | demo
• Routing
  • Resources guide | code | demo
  • Forward guide | code | demo | demo
  • Path Helpers guide | code | demo
  • Nested Resources guide | code | demo
  • Scoped Routes guide | code | demo
  • Pipelines guide
    • The :browser and :api Pipelines code
    • Creating New Pipelines code: pipeline | code: plug | demo
  • Channel Routes guide
• Plug
  • Function Plugs guide | code: function | code: plug | demo
  • Module Plugs guide | code: module | code: plug
• Endpoint
  • Phoenix.Endpoint docs
  • Endpoint Contents guide | code
  • Using SSL guide | code
• Controllers
  • Actions guide | code | demo
  • Flash Messages guide | code | demo
  • Rendering guide | code | demo
  • Sending responses directly guide ]
  • Assigning Layouts guide | code | code | demo
  • Overriding Rendering Formats guide | code | code | code | demo
  • Setting the HTTP Status guide | code
• Views
  • Rendering Templates
    • Overview guide
    • View Functions code | demo
    • Templates are function definitions code | demo
  • A Word About Layouts guide | code
  • The ErrorView guide | code | demo
  • Rendering JSON guide | code | demo
• Templates
  • hello_web.ex guide code
  • Displaying Lists code | demo
  • Render templates within templates code | demo
  • Shared Templates Across Views code | code | code | demo
• Channels
  • App demo
  • JavaScript client doc
  • Socket Handlers guide | code
  • Channel Routes guide | code
  • Channels guide | code
  • PubSub guide
  • Messages guide | doc
  • Topics guide | code | code | code
  • Transports guide | code
  • Transport Adapters guide | code
  • Client Libraries guide | code
• Channels Sample application
  • Overview guide | code | demo
  • Uncomment the “room:” channel definition code
  • Define a HelloWeb.RoomChannel module code
  • Joining Channels guide
    • authorize clients to join topic code
    • set our room name to “room:lobby” code
    • join channel code
    • import assets/js/socket.js code
    • add containers to hold our chat messages code - [x] push an event over the channel with the message body code
      • listen for new messages and append them to our messages container code
    • Handle Incoming Events guide | code
• Ecto
  • Overview Phoenix guide | Ecto Guide
  • Postgres configuration code
  • Generate an Ecto schema code: schema | code: migration
  • Changesets and Validations guide | ecto guide | code: cast | code: validate
  • Data Persistence guide | ecto guide
• Contexts
  • Overview guide
  • Adding an Accounts Context With Generators guide | code:controller | code:context | code:schema | demo
  • In-context Relationships: e.g. Credential belongs_to User
    • Overview guide
    • mix phx.gen.context Accounts Credential... code
    • has_one/belongs_to code:belongs_to | code:has_one
    • load association data code
    • add association changeset code - [x] add association to user edit/create form code
      • add user.credential.email association to user show code | demo
  • Adding Account Functions: e.g. Sessions
    • Overview guide | demo
    • Add authenticate_by_email_password function to accounts code
    • Create session controller code | code
    • Add sessions to router code
    • Add an authentication plug to the router code
    • Create session view and template code | code
  • Cross-context dependencies: e.g. CMS.Author <-> Accounts.User
    • Overview guide
    • New CMS context
      • Generate CMS context, Page schema and web modules code
      • Add to router code
      • Generate an Author schema code
      • Add an author_id field to the pages table code
  • Cross-context data: e.g. CMS.Author <-> Accounts.User
    • Overview guide | demo
    • Tie pages to authors and author to users
      • page belongs_to author code
      • author has_many pages code
      • author belongs_to user code
    • Require an author on pages
      • preload author on page fetch code
      • persist author data code
      • ensure author exists code
      • add require_existing_author plug to CMS.PageController code | code
      • make use of current_author in the connection assigns from require_existing_author plug code
      • display author when showing a page code | code | demo
  • Adding CMS functions: e.g. page views
    • Overview guide | demo
    • add an inc_page_views function code
    • use the inc_page_views function in the controllers code
    • see page views increment with each refresh! demo
• Mix Tasks
  • Overview guide
  • Creating Our Own Mix Tasks guide | code
• Custom Errors
  • Overview guide

Testing

• Introduction to Testing
  • Overview guide
  • Running Tests Using Tags guide | code:moduletag | code:tag
  • Randomization guide
• Testing Schemas
  • Test Driving a Changeset guide
  • add tests code
  • make them pass code
• Testing Controllers
  • Overview guide
  • user_controller_text.exs code
• Testing Channels
  • Overview guide
  • Generate a channel and tests code
    • Add a channel router code
    • The Channel Test Helpers Module code
    • The Setup Block code
  • Testing a Synchronous Reply code:test | code:channel
  • Testing a Broadcast code:test | code:channel
  • Testing an Asynchronous Push from the Server code:test | code:channel

Deployment

• Deploying on Heroku guide | code | demo

Deploying each branch to its own Heroku app

We'll create a demo app for each branch of this repo. To do so, we need to:

1. Tell Phoenix of the updated Heroku URL
2. Create the Heroku application and add buildpacks
3. Create environment variables in the new app in Heroku
4. Add a git remote and deploy

Tell Phoenix of the updated Heroku URL

Update the host in prod.exs.

url: [scheme: "https", host: "phx-010-ecto.herokuapp.com", port: 443],

Create the Heroku application and add buildpacks

$ heroku create phx-010-ecto --buildpack "https://github.com/HashNuke/heroku-buildpack-elixir.git"
$ heroku buildpacks:add https://github.com/gjaldon/heroku-buildpack-phoenix-static.git -a phx-010-ecto

Create environment variables in Heroku

$ heroku addons:create heroku-postgresql:hobby-dev -a phx-010-ecto
$ heroku config:set POOL_SIZE=18 -a phx-010-ecto
$ mix phx.gen.secret
$ heroku config:set  -a phx-010-ecto SECRET_KEY_BASE="insertkeyhere"

Add a git remote and deploy

$ git remote add phx-010-ecto https://git.heroku.com/phx-010-ecto.git
$ git push phx-010-ecto phx-010-ecto:master
$ heroku open -a phx-010-ecto

Migrate database as required

heroku run "POOL_SIZE=2 mix ecto.migrate" -a phx-011-contexts

Learn more

• Official website: http://www.phoenixframework.org/
• Guides: http://phoenixframework.org/docs/overview
• Docs: https://hexdocs.pm/phoenix
• Mailing list: http://groups.google.com/group/phoenix-talk
• Source: https://github.com/phoenixframework/phoenix