Graphviz.php 5.37 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
<?php
/*
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * This software consists of voluntary contributions made by many individuals
Benjamin Eberlei's avatar
Benjamin Eberlei committed
16
 * and is licensed under the MIT license. For more information, see
17 18 19 20 21
 * <http://www.doctrine-project.org>.
 */

namespace Doctrine\DBAL\Schema\Visitor;

Benjamin Morel's avatar
Benjamin Morel committed
22 23 24
use Doctrine\DBAL\Schema\Table;
use Doctrine\DBAL\Schema\Schema;
use Doctrine\DBAL\Schema\ForeignKeyConstraint;
25 26 27 28 29 30
use function current;
use function file_put_contents;
use function in_array;
use function mt_rand;
use function sha1;
use function strtolower;
31 32 33 34 35

/**
 * Create a Graphviz output of a Schema.
 */
class Graphviz extends AbstractVisitor
36
{
37 38 39
    /**
     * @var string
     */
40 41
    private $output = '';

Benjamin Morel's avatar
Benjamin Morel committed
42 43 44
    /**
     * {@inheritdoc}
     */
45 46 47
    public function acceptForeignKey(Table $localTable, ForeignKeyConstraint $fkConstraint)
    {
        $this->output .= $this->createNodeRelation(
48 49
            $fkConstraint->getLocalTableName() . ":col" . current($fkConstraint->getLocalColumns()).":se",
            $fkConstraint->getForeignTableName() . ":col" . current($fkConstraint->getForeignColumns()).":se",
50
            [
51 52 53
                'dir'       => 'back',
                'arrowtail' => 'dot',
                'arrowhead' => 'normal',
54
            ]
55 56 57
        );
    }

Benjamin Morel's avatar
Benjamin Morel committed
58 59 60
    /**
     * {@inheritdoc}
     */
61 62
    public function acceptSchema(Schema $schema)
    {
Steve Müller's avatar
Steve Müller committed
63
        $this->output  = 'digraph "' . sha1(mt_rand()) . '" {' . "\n";
64 65
        $this->output .= 'splines = true;' . "\n";
        $this->output .= 'overlap = false;' . "\n";
66
        $this->output .= 'outputorder=edgesfirst;'."\n";
67 68 69 70
        $this->output .= 'mindist = 0.6;' . "\n";
        $this->output .= 'sep = .2;' . "\n";
    }

Benjamin Morel's avatar
Benjamin Morel committed
71 72 73
    /**
     * {@inheritdoc}
     */
74 75 76 77
    public function acceptTable(Table $table)
    {
        $this->output .= $this->createNode(
            $table->getName(),
78
            [
Steve Müller's avatar
Steve Müller committed
79
                'label' => $this->createTableLabel($table),
80
                'shape' => 'plaintext',
81
            ]
82 83 84
        );
    }

Benjamin Morel's avatar
Benjamin Morel committed
85 86 87 88 89 90
    /**
     * @param \Doctrine\DBAL\Schema\Table $table
     *
     * @return string
     */
    private function createTableLabel(Table $table)
91 92
    {
        // Start the table
93
        $label = '<<TABLE CELLSPACING="0" BORDER="1" ALIGN="LEFT">';
94 95

        // The title
96
        $label .= '<TR><TD BORDER="1" COLSPAN="3" ALIGN="CENTER" BGCOLOR="#fcaf3e"><FONT COLOR="#2e3436" FACE="Helvetica" POINT-SIZE="12">' . $table->getName() . '</FONT></TD></TR>';
97 98

        // The attributes block
Steve Müller's avatar
Steve Müller committed
99
        foreach ($table->getColumns() as $column) {
100 101 102 103 104 105 106
            $columnLabel = $column->getName();

            $label .= '<TR>';
            $label .= '<TD BORDER="0" ALIGN="LEFT" BGCOLOR="#eeeeec">';
            $label .= '<FONT COLOR="#2e3436" FACE="Helvetica" POINT-SIZE="12">' . $columnLabel . '</FONT>';
            $label .= '</TD><TD BORDER="0" ALIGN="LEFT" BGCOLOR="#eeeeec"><FONT COLOR="#2e3436" FACE="Helvetica" POINT-SIZE="10">' . strtolower($column->getType()) . '</FONT></TD>';
            $label .= '<TD BORDER="0" ALIGN="RIGHT" BGCOLOR="#eeeeec" PORT="col'.$column->getName().'">';
107
            if ($table->hasPrimaryKey() && in_array($column->getName(), $table->getPrimaryKey()->getColumns())) {
108 109 110
                $label .= "\xe2\x9c\xb7";
            }
            $label .= '</TD></TR>';
111 112 113 114 115 116 117 118
        }

        // End the table
        $label .= '</TABLE>>';

        return $label;
    }

Benjamin Morel's avatar
Benjamin Morel committed
119 120 121 122 123 124 125
    /**
     * @param string $name
     * @param array  $options
     *
     * @return string
     */
    private function createNode($name, $options)
126 127
    {
        $node = $name . " [";
Steve Müller's avatar
Steve Müller committed
128
        foreach ($options as $key => $value) {
129 130 131
            $node .= $key . '=' . $value . ' ';
        }
        $node .= "]\n";
Benjamin Morel's avatar
Benjamin Morel committed
132

133 134 135
        return $node;
    }

Benjamin Morel's avatar
Benjamin Morel committed
136 137 138 139 140 141 142 143
    /**
     * @param string $node1
     * @param string $node2
     * @param array  $options
     *
     * @return string
     */
    private function createNodeRelation($node1, $node2, $options)
144 145
    {
        $relation = $node1 . ' -> ' . $node2 . ' [';
Steve Müller's avatar
Steve Müller committed
146
        foreach ($options as $key => $value) {
147 148 149
            $relation .= $key . '=' . $value . ' ';
        }
        $relation .= "]\n";
Benjamin Morel's avatar
Benjamin Morel committed
150

151 152 153
        return $relation;
    }

154 155 156 157 158 159 160 161 162 163
    /**
     * Get Graphviz Output
     *
     * @return string
     */
    public function getOutput()
    {
        return $this->output . "}";
    }

164
    /**
Benjamin Morel's avatar
Benjamin Morel committed
165
     * Writes dot language output to a file. This should usually be a *.dot file.
166 167 168 169
     *
     * You have to convert the output into a viewable format. For example use "neato" on linux systems
     * and execute:
     *
170
     *  neato -Tpng -o er.png er.dot
171 172
     *
     * @param string $filename
Benjamin Morel's avatar
Benjamin Morel committed
173
     *
174 175 176 177
     * @return void
     */
    public function write($filename)
    {
178
        file_put_contents($filename, $this->getOutput());
179
    }
Benjamin Eberlei's avatar
Benjamin Eberlei committed
180
}